产品文档
产品文档
imgli 是开源、可自托管的图床：单二进制 + 内嵌 React 前端，上传截图即可得到可分享链接。当前稳定发行 v0.9.17（AGPL-3.0-only；历史 v0.1.0/v0.1.1 仍为 MIT）。
v0.9.17 · HEIC 入库 + 更多 /t 宽度：iPhone HEIC/HEIF 在官方 Docker（libvips + libheif）上解码后存 JPEG（再走既有处理，含可选原图 WebP）；GitHub 纯 Go 二进制返回 415 heic_unsupported。新实例默认组/游客组允许 heic/heif，存量组不会自动加。/t?w= 白名单：120, 200, 240, 400, 480, 800, 960, 1600。见 上传 API · 分享与外链 · Release v0.9.17。
v0.9.12 · 私密相册隐私 + 源站缓存：私密相册内的图不进广场、匿名直链 401、分享页 404；口令图不进发现流；公开封面必须是公开图。公开 /t 与未 302 的 /i 可缓存在 {data_dir}/.serve-cache。见 分享与外链。
v0.9.6 · 自托管健壮性（SQLite/绑定挂载/低内存）+ v0.9.5 · 站点外观：暗色模式修复；后台 外观（强调色、整站背景图、遮罩、毛玻璃）。见 站点外观。
v0.9.4：回收站恢复、原图 WebP（Docker+vips）、用户表密度。
v0.9 · Group lifecycle：用户组有效期/访问次数、自动进回收站与强制最大存活、存量钳制。见 用户组 · 清理与 CDN。
v0.8 · Admin image ops：图片存储定位、彻底删除 vs 回收站、游客删除即硬清。
v0.7 · Ops Console：系统 / 运维健康台、反代 CSRF 提示、升级 preflight。
| 入口 | 地址 |
|---|---|
| 产品站 | https://imgli.com |
| 公共实例 | https://img.li |
| 源码与 Release | https://github.com/yixian-huang/imgli |
| 本站文档 | 你正在阅读的文档站点（路径前缀 docs-imgli/） |
本文档与 GitHub 的关系（SSOT）
本站（docs-imgli/） 面向站长与用户：安装、配置、功能说明与 FAQ。
GitHub 仓库 docs/ 面向贡献者与工程细节：S3/WebDAV/FTP 兼容矩阵、探测脚本、设计草案。产品页对长矩阵 只摘要并链到 GitHub，不在此维护第二份全文表。
| 你想… | 读这里 |
|---|---|
| 怎么装、怎么配 | 本站下列文章 |
| 某云/WebDAV 是否测过、怎么跑脚本 | S3 矩阵 · WebDAV 矩阵 · FTP |
| 版本与变更列表 | Releases / CHANGELOG |
若与 Release 冲突，以 GitHub 最新 Release 为准。维护约定见仓库 docs/documentation-ssot.md。
你是谁？读哪几篇
| 角色 | 推荐阅读顺序 |
|---|---|
| 自托管运维 | 快速开始 → 安装 → 配置 → 管理后台 → 站点外观 → 用户组生命周期 → 清理与 CDN → 升级 → 安全加固 |
| 终端用户 | 快速开始 → 上传 API → PicGo → 分享与外链 |
| 贡献者 | GitHub README / CHANGELOG / docs/ 矩阵 · 商业授权 |
文档目录
- 快速开始
- 安装
- 升级
- 配置
- 管理后台
- 站点外观（v0.9.5）
- 用户组：有效期与自动清理（v0.9）
- 管理后台：回收站与彻底删除（v0.8+ · 恢复 v0.9.4）
- 生命周期清理与 CDN
- 分享与外链
- OIDC SSO
- 出站 Webhook
- 存储与 CDN
- S3 兼容 — 摘要；完整矩阵在 GitHub
- WebDAV — 摘要；矩阵在 GitHub
- FTP 兼容
- 上传 API
- PicGo / 编辑器
- 安全加固
- 公共实例
- 许可与商业
- FAQ
工程补充（GitHub）：user-groups-lifecycle、site-customization-ia、ops-release、docs/integrations/、docs/documentation-ssot.md。
产品一句话
- 软件：AGPL-3.0-only 开源（现行主干 / v0.9.x）；历史标签 v0.1.0 / v0.1.1 仍为 MIT。
- v0.9.17：HEIC/HEIF 入库（Docker/vips+libheif）；
/t?w=白名单扩展；纯 Go 二进制不解 HEIC。 - v0.9.12：私密相册不再漏到广场 / 匿名直链 / 分享页；公开源站缓存（可关）。
- v0.9.6：SQLite/Docker 绑定挂载与低内存健壮性。
- v0.9.5：站点外观（强调色/背景/玻璃）、暗色 token 修复。
- v0.9.4：回收站恢复、处理 JPEG/WebP、Docker 默认 libvips。
- v0.9：用户组有效期/次数与自动清理、存量钳制、管理端批量硬删。
- 公共试用：https://img.li （限额演示，非无限 CDN；当前关闭游客上传；部署 v0.9.17）。
最近校对 2026-08-27 · v0.9.17。产品说明与 GitHub 工程文档分层见上文「SSOT」。冲突以 Releases 为准。
最后更新: 2026-08-27