imgLi 文档imgLi 文档
GitHub

FTP 兼容存储

FTP 兼容存储

v0.4.0 起,imgli 可选 FTP/FTPS 作为存储驱动(兼容层)。生产默认仍推荐 本地盘S3 兼容;WebDAV 适合网盘与 OpenList 等代理。

优先:外置代理

若供应商只提供 FTP:

  1. OpenList(或同类)挂 FTP → 暴露 WebDAV → 在 imgli 配置 WebDAV 策略
  2. rclone 同步/挂载到本地或 S3 → imgli 用 local / s3
  3. 仅当拒绝多跑组件时,再用内置 FTP 驱动

内置 FTP 能力与限制

说明
能力上传 / 读图 / 删除;管理后台「测试连接」
对象预签名、可靠 CDN 302 卸带宽(与 S3 对等)
性能热读依赖远端 RTT/带宽;大图下载主要受吞吐限制(v0.4.1 已池化+流式改善 TTFB)
安全默认 FTPS;明文需显式 allow_insecure
配置深度工程 SSOT:https://github.com/yixian-huang/imgli/blob/main/docs/storage-ftp.md

存储能力提示(Caps)

管理后台「存储策略」展示驱动 tier 与功能限制(Caps)。兼容层启用前需确认风险;cdn_domain 在非推荐驱动上会给出警告。缩略图始终经应用,不走对象 CDN。

选型建议

相关:存储与 CDN · WebDAV · S3 · FAQ

工程深度(GitHub SSOT):https://github.com/yixian-huang/imgli/blob/main/docs/storage-ftp.md

校对:2026-07-30 · v0.4.1 · 文档分层见文档首页「SSOT」。

最后更新: 2026-08-06