快速开始

目标：本机 5 分钟内打开上传页，得到第一张图的直链。

方式 A：安装脚本（Linux / macOS）

curl -fsSL https://raw.githubusercontent.com/yixian-huang/imgli/main/scripts/install.sh | sh
imgli serve
# 浏览器打开 http://localhost:8686
# 第一个注册用户即为管理员

固定版本：

curl -fsSL https://raw.githubusercontent.com/yixian-huang/imgli/main/scripts/install.sh | sh -s -- v0.9.17

自定义安装目录：

PREFIX=/usr/local/bin curl -fsSL https://raw.githubusercontent.com/yixian-huang/imgli/main/scripts/install.sh | sh

docker run --rm -p 8686:8686 -v imgli-data:/data \
  -e IMGLI_BASE_URL=http://localhost:8686 \
  ghcr.io/yixian-huang/imgli:latest

固定版本：ghcr.io/yixian-huang/imgli:v0.9.17（Docker 镜像默认含 libvips + HEIF 解码；以 Releases 为准）。

打开 http://localhost:8686（或你的 IMGLI_BASE_URL）。
注册第一个账号 → 自动成为管理员。
登录后上传一张 PNG/JPEG（Docker 新实例也可试 HEIC），复制 Markdown / URL。
打开 设置 → API Token，按 三步接入 创建 token 并复制 PicGo / CLI 片段（明文只显示一次）。
用 curl 或 imgli upload 验证 API（见上传 API）。
生产前运行 imgli doctor，或登录后台 系统 / 运维 查看健康报告与 base_url。存量站点若要收 iPhone HEIC，在用户组里加上 heic / heif。

项	为什么
`IMGLI_BASE_URL=https://你的域名`	复制链、邮件、预览、登录注册 CSRF Origin 都依赖它（与浏览器地址一致）
反代后 `IMGLI_TRUST_PROXY=true`	限速与审计 IP 才正确（仅可信反代）
持久化 `data_dir` / Docker volume	否则重启丢库丢图
管理后台关游客 / 配用户组	默认更利于公网安全

反代后若提示「跨站请求被拒绝」，见 FAQ。

最后更新: 2026-08-27