快速开始

用 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/),用出厂账号登录:

用户名密码
adminimgyoung123

出厂密码是公开的。首次登录后会直接进入「设置管理员密码」页;改掉之前,后台其他页面都打不开,服务端也会拒绝除退出、查看本人信息与改密之外的全部后台接口(返回 403)。新密码至少 8 位,点「保存并重新登录」后用新密码再登录一次。

上传第一张图

两种方式任选其一:在后台直接上传,或者签发一个上传 Token 用 curl 上传。

  1. 侧栏进入「图片」,点「上传图片」。
  2. 把图片拖进对话框,或按 Ctrl / ⌘ + V 粘贴剪贴板里的截图。支持 JPEG、PNG、GIF、WebP,单图出厂上限 50 MB。
  3. 上传完成后关闭对话框,点图片卡片打开「图片详情」,在「分享链接」的「复制为」里点 Markdown。

拿到的 Markdown 形如:

![](http://localhost:8721/i/R0RjUyP1UW)

贴进博客或笔记即可显示。

链接里的域名从哪来

没有配置对外站点地址(base_url)时,链接按本次请求的地址生成:用 localhost 访问后台,复制出的就是 localhost 链接,别的机器打不开。 要发给别人看,请用对外的域名或 IP 访问后台,或在「设置 → 运行配置」里填写 base_url。详见 配置。

下一步

现在所有数据都在一块盘上

全新实例只有一个内置的 local 渠道,图片存在数据卷里的 blobs/ 目录;元数据库快照写到每个健康渠道,此刻也只有这一处。这块盘坏了,图片和快照一起丢失,后台「总览」也会提示「数据只存在这台主机上」。 尽快到侧栏「存储渠道」点「新建渠道」,加一个异地的对象存储或网盘渠道:已有图片会自动补齐副本过去,快照在下一轮定时备份或下次启动时写一份过去,想马上有一份就到「设置 → 备份与导出」点「立即备份」。新渠道健康后,总览上的提示随之消失。

  • 存储渠道:添加异地渠道,设置优先级与加密。
  • 备份与恢复:单独备份主密钥 master.key,它不在快照里;丢失后服务拒绝启动,渠道凭证与加密数据也无法恢复。
  • 反向代理:用域名与 HTTPS 对外提供服务。
  • 客户端接入:配置 PicGo、PicList、Typora 等客户端。
  • Docker 镜像:镜像标签、数据卷与环境变量的完整说明。

本页目录