快速开始
用 Docker 跑起 ImgYoung,登录后台,上传第一张图并拿到 Markdown 链接。
需要一台装好 Docker 的机器(Linux、macOS、Windows 均可),并能用浏览器访问它的 8721 端口。不用 Docker 的安装方式见 安装。
启动服务
docker run -d --name imgyoung --restart unless-stopped \
-p 8721:8721 \
-v imgyoung-data:/data \
ghcr.io/x-haose/imgyoung:latest-v imgyoung-data:/data:数据库、内置 local 渠道里的图片与主密钥master.key都在这个卷里,删掉卷就是删掉全部数据。--restart unless-stopped:后台从快照恢复元数据库时,服务会主动退出、由 Docker 重新拉起后换入快照;没有重启策略,恢复后容器会停在已退出状态。
确认启动成功:
docker logs imgyoung看到 msg="ImgYoung 已启动" 一行即可(日志文案为中文)。首次启动还会有两条 level=WARN:已生成主密钥文件,请立即备份——丢失将导致渠道配置与加密渠道数据永久不可恢复 与 已初始化默认管理员密码,请登录后立即在后台修改,都是预期行为。
登录并修改密码
浏览器打开 http://<服务器地址>:8721/(本机就是 http://localhost:8721/),用出厂账号登录:
| 用户名 | 密码 |
|---|---|
admin | imgyoung123 |
出厂密码是公开的。首次登录后会直接进入「设置管理员密码」页;改掉之前,后台其他页面都打不开,服务端也会拒绝除退出、查看本人信息与改密之外的全部后台接口(返回 403)。新密码至少 8 位,点「保存并重新登录」后用新密码再登录一次。
上传第一张图
两种方式任选其一:在后台直接上传,或者签发一个上传 Token 用 curl 上传。
- 侧栏进入「图片」,点「上传图片」。
- 把图片拖进对话框,或按 Ctrl / ⌘ + V 粘贴剪贴板里的截图。支持 JPEG、PNG、GIF、WebP,单图出厂上限 50 MB。
- 上传完成后关闭对话框,点图片卡片打开「图片详情」,在「分享链接」的「复制为」里点 Markdown。
拿到的 Markdown 形如:
贴进博客或笔记即可显示。
链接里的域名从哪来
没有配置对外站点地址(base_url)时,链接按本次请求的地址生成:用 localhost 访问后台,复制出的就是 localhost 链接,别的机器打不开。
要发给别人看,请用对外的域名或 IP 访问后台,或在「设置 → 运行配置」里填写 base_url。详见 配置。
下一步
现在所有数据都在一块盘上
全新实例只有一个内置的 local 渠道,图片存在数据卷里的 blobs/ 目录;元数据库快照写到每个健康渠道,此刻也只有这一处。这块盘坏了,图片和快照一起丢失,后台「总览」也会提示「数据只存在这台主机上」。
尽快到侧栏「存储渠道」点「新建渠道」,加一个异地的对象存储或网盘渠道:已有图片会自动补齐副本过去,快照在下一轮定时备份或下次启动时写一份过去,想马上有一份就到「设置 → 备份与导出」点「立即备份」。新渠道健康后,总览上的提示随之消失。