分享与外链

面向 v0.3+：分享页、访问口令、Open Graph 预览、公开相册访客、受控缩略尺寸。v0.9 起，用户组可限制有效期与访问次数（上传/详情选项会裁剪）；访问次数用尽只挡访问、不释放存储。API 细节见上传 API。

公开分享页

公开且审核通过（normal）的图片有稳定分享页：

SPA：/s/{key}（或 vanity slug）
API：GET /api/v1/s/{key}

提供预览与复制 URL / Markdown / 分享链。私密、待审、拒绝、过期或次数用尽对访客通常 404。

v0.9.12：若图片所在父相册是私密，分享页与分享 OG 同样 404（即使该行仍标 public）。

访问口令

属主在图片详情设置访问口令（或上传表单 access_password）。
非属主访问 /i、/t 与分享页需解锁。
解锁：POST /api/v1/s/{key}/unlock + JSON password，或 Header X-Image-Password。

口令图不走公开 CDN 302；OG 不嵌入原图。

Open Graph（链接预览）

对 /s/{key} 与公开 /a/{id}，返回 HTML 时注入 og:title / og:image 等（爬虫可读）。

无需后台开关。
IMGLI_BASE_URL 必须正确。
自检：curl -sS 'https://your-host/s/<key>' | grep og:

公开相册访客

相册设为公开后：访客页 /a/{id}；API GET /api/v1/a/{id} 与 /images。列表仅 public + normal + 未过期 + 无口令的图。属主可在相册详情复制访客链接。

公开相册的封面必须是可公开展示的图（公开、无口令）；把私密或口令图设为公开相册封面会被拒绝。广场相册卡与 /a OG 也只用这类封面。

私密相册与广场（v0.9.12）

相册设为私密后，其中的图不再出现在广场与公开主页动态（还须相册本身公开，且 list_in_plaza 为真，图才会进广场）。上传进私密相册、把相册改为私密、或从公开相册移入，都会把图的可见性打成 private（匿名 /i 401）。仍挂在私密相册里时，不能用详情 / 批量把图改回公开。

带访问口令的图也不进广场与公开主页（否则缩略图 /t 会对访客 401）。

广场的相册列表仍可能列出未勾选「在广场展示」的公开相册（访客链仍可用）；这与「图是否进广场」是两套规则。

缩略尺寸

白名单宽度 120 / 200 / 240 / 400 / 480 / 800 / 960 / 1600（v0.9.17；原先的 200/400/800 仍可用）：

https://your-host/t/{key}.jpg?w=400

非法宽度返回 HTTP 400。

分享与外链