# PicHost 文档

欢迎使用 PicHost 用户文档。本站为完整指南的单一事实来源；仓库 README 保留特性摘要与快速开始。

## 推荐阅读顺序

1. [快速开始](./getting-started.md) — Docker 部署与首次设置
2. [环境变量](./configuration.md) — 生产环境配置与后台设置对照
3. [更新日志](./changelog.md) — 版本变更与升级说明
4. [存储](./storage.md) — 多后端与直链模式
5. [API](./api.md) — REST 接口与 Token

## 截图预览

**main** 分支暂无公网演示，以下为当前产品界面（v1.4.0+）。

| 上传 | 批量打标 |
| :-: | :-: |
| ![上传](/screenshots/upload.png) | ![批量打标](/screenshots/tags-batch.png) |

| 上传结果（含标签） | API |
| :----------------: | :-: |
| ![上传结果](/screenshots/upload-tags.jpg) | ![API](/screenshots/api.png) |

| 图库（网格） | 图库（列表） |
| :----------: | :----------: |
| ![图库网格](/screenshots/gallery.png) | ![图库列表](/screenshots/gallery-list.png) |

| 图片详情 | 标签管理 |
| :------: | :------: |
| ![图片详情](/screenshots/gallery-detail.png) | ![标签管理](/screenshots/tags.png) |

| 存储管理 | 基础设置 |
| :------: | :------: |
| ![存储管理](/screenshots/storage.png) | ![基础设置](/screenshots/settings.png) |

| 首次设置 | 从备份恢复 |
| :------: | :--------: |
| ![首次设置](/screenshots/setup.png) | ![从备份恢复](/screenshots/setup-restore.png) |

| 操作日志 |
| :------: |
| ![操作日志](/screenshots/logs.png) |

## 分支说明

| 分支 | 说明 |
| ---- | ---- |
| [**main**](https://github.com/O96u/PicHost/tree/main) | 主线：多后端、双域名、统一 `images/` 存储；界面见上表 |
| [**cloudflare**](https://github.com/O96u/PicHost/tree/cloudflare) | 仅 Cloudflare R2；在线演示 [pic.roven.cc](https://pic.roven.cc) |

需要多种云存储或完整管理界面请用 **main**；图床只接 R2 可选用 **cloudflare** 分支。