Files
FileHost/docs/README.md
T
O96u 469d3be735
ci / ci (22, ubuntu-latest) (push) Canceled after 0s
Publish Docker image / build (linux/amd64, ubuntu-latest, amd64) (push) Canceled after 0s
Publish Docker image / build (linux/arm64, ubuntu-24.04-arm, arm64) (push) Canceled after 0s
Publish Docker image / merge (push) Canceled after 0s
GitHub Release / release (push) Canceled after 0s
release: v1.2.0 — unified images/ storage and legacy migration
Consolidate local images under data/images/, add docker migrate CLI,
startup index sync with orphan cleanup, and remove upload folder UI/API.
2026-08-28 17:18:03 +08:00

2.7 KiB
Raw Blame History

PicHost 文档资源

本目录主要存放 README 引用的界面截图与分支说明。

分支

分支 说明
main(默认) v1.2.0(开发中)主线:统一 images/ 存储、多对象存储、/storage、迁移指南
cloudflare Cloudflare R2 专用线:面向「只用 R2」的部署场景,配置更聚焦 R2
  • 需要多种云存储或完整管理界面 → 使用 main
  • 图床只接 Cloudflare R2 → 可选用 cloudflare 分支

截图一览

以下为 main 界面截图。

文件 说明
screenshots/upload.png 首页上传区(顶栏含 API / 统计 / 存储 / 设置)
screenshots/storage.png 存储管理(/storage):多后端卡片、用量、设默认
screenshots/stats.png 统计与图库
screenshots/settings.png 系统设置(上传偏好 + 系统设置)
screenshots/preferences.png 首页上传卡片翻转后的上传偏好
screenshots/login.png 登录页
screenshots/lucky-site.png 飞牛 NAS Lucky:网站域名反代示例
screenshots/lucky-image.png 飞牛 NAS Lucky:图片域名反代示例

部署文档

文档 说明
migration-to-v1.2.md v1.2.0 本地磁盘迁移(CLI 搬文件 + 启动同步索引)
migration-to-v1.2.en.md v1.2.0 migration guide (English)
domain-separation.md 双域名分离推荐架构(Nginx / Lucky / 环境变量)
domain-separation.en.md Dual-domain deployment (English)

相关页面路由(main)

路由 权限 说明
/ 登录用户 上传与图库入口
/storage 管理员 存储后端管理
/settings 管理员 系统设置
/stats 登录用户 统计
/api 登录用户 API 文档与 Token

管理员顶栏:API · 统计 · 存储 · 设置。用户下拉菜单仅 修改密码、退出登录。

Cloudflare R2 配置对照

main:后台 存储 → 添加存储 → Cloudflare R2 预设。

cloudflare 分支(R2 专用):通常以环境变量为主:

配置项 值
STORAGE_BACKEND s3
S3_ENDPOINT https://<account_id>.r2.cloudflarestorage.com
S3_REGION auto
S3_BUCKET 桶名
S3_ACCESS_KEY / S3_SECRET_KEY R2 API Token
直链 默认 PicHost 代理;桶绑域名后可改公开 URL