FAQ
FAQ
安装与运行
Q: 第一个用户为什么是管理员?
A: 空库引导:首个注册账号提升为管理员,便于单人快速开箱。公网请尽快收紧注册策略。
Q: 默认端口?
A: 8686。用 IMGLI_LISTEN 或 YAML listen 修改。
Q: 数据在哪?
A: 默认 ./data(Docker 多为 /data),含 SQLite 与本地对象。改 IMGLI_DATA_DIR。
Q: 必须 Postgres 吗?
A: 不必。默认 SQLite 即可;规模或运维习惯需要时再切 Postgres。
链接与反代
Q: 复制出来的链接域名不对?
A: 设置正确的 IMGLI_BASE_URL(用户浏览器访问的 https 源),重启服务。
Q: 限速 IP 全是反代地址?
A: 在可信反代后打开 IMGLI_TRUST_PROXY=true,并确保转发了客户端 IP 头。
上传与 API
Q: PicGo 一直 401?
A: 检查 Authorization: Bearer … 是否完整、Token 是否作废、是否复制了多余空格。先 curl 再配插件。
Q: 413 / 415?
A: 用户组单文件大小或扩展名限制;管理员改组策略。
Q: 429?
A: 触发限速;看 Retry-After,或调整用户组 / 换登录 Token。
存储与安全
Q: 上了 CDN 私有图还能被打开?
A: 立刻检查桶 ACL 与 CDN 源站是否匿名可读 private/*。跑 probe-private-object-anon.sh。应用 302 不会故意给 private 拼公开 CDN,但桶公开仍会出事。
Q: 可以只开对象存储、关掉应用门禁直链吗?
A: 不推荐。门禁承担鉴权、私有检查、(可选)流量计量;CDN 应是门禁之后的卸流量层。
许可
Q: 公司内网自用要付费吗?
A: 遵守 AGPL 的自托管通常不强制商业许可;若法务要求非 AGPL 或做闭源 SaaS,见 商业授权。
Q: v0.1.0 是 MIT?
A: 是,仅历史 tag v0.1.0 / v0.1.1;现行开发默认 AGPL-3.0-only。
文档与产品
Q: 文档站和 GitHub 不一致?
A: 以 GitHub 最新 README / CHANGELOG / Release 为准;文档站会滚动同步。
Q: 公共站额度在哪看?
A: 登录 img.li 后于个人中心 / 配额展示(以线上 UI 为准)。