imgLi 文档

快速开始

快速开始

目标:本机 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.1.1

自定义安装目录:

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

方式 B:Docker

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.1.1(以 Releases 为准)。

第一次使用检查清单

  1. 打开 http://localhost:8686(或你的 IMGLI_BASE_URL)。
  2. 注册第一个账号 → 自动成为管理员。
  3. 登录后上传一张 PNG/JPEG,复制 Markdown / URL。
  4. 打开 设置 → API Token,创建 uploadfull scope,立刻保存明文(只显示一次)。
  5. 用 curl 验证 API(见 上传 API)。

生产前必改

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

下一步:安装详解 · 配置 · 管理后台