yeomaiyelove/pichost repository overview

⁠自托管图片、视频与文件管理平台

⁠图片管理

• 支持拖拽、文件选择和 Ctrl+V 粘贴上传，可配置格式、大小、批量数量和频率限制。
• 服务端使用 Sharp 压缩为 WebP，也可保留原图；支持可选的浏览器端 WebP 压缩。
• 图库支持搜索、分页、存储后端/上传来源/标签筛选，以及网格和列表视图。
• 支持查看详情、复制多种链接格式、批量打标和批量删除，并提供媒体数量与来源统计。
• 支持 Referer 防盗链和来源域名白名单。

⁠视频库与 HLS

• 独立的视频上传、搜索和管理页面，支持 MP4、M4V、WebM、MOV、MKV、AVI、FLV、WMV、MPG、MPEG 等格式。
• 上传后自动生成视频缩略图，并可根据设置异步转码为 HLS。
• 支持 copy、veryfast、medium、slow、compress 等转码档位，可限制并发数、CPU 核心数和目标码率。
• 管理转码进度与失败原因，支持删除时同步清理原视频、缩略图、播放列表和 HLS 分片。
• 支持复制原视频、缩略图和 HLS 地址，并可将 HLS 视频重新封装下载为 MP4。

⁠文件床

• 独立管理普通文件，提供上传、搜索、分页、标签、批量删除和直链/下载链接。
• 文件床访问策略可在后台配置，文件、图片和视频可分别使用独立域名。

⁠多用户与权限

• 管理员与普通用户账号体系，普通用户只能查看和管理自己的媒体。
• 支持滑块、Cloudflare Turnstile 和 Cap 人机验证，可选择开放注册。
• 支持修改资料、修改密码、管理员清空密码和迁移到账号密码登录。
• 每个用户拥有独立标签和自动删除策略，可设置媒体保存天数。
• 提供登录与上传频率限制、全局/个人 API Token 和操作日志。

⁠存储与迁移

• 支持本地磁盘、S3 兼容对象存储和 Telegram 频道/群组。
• S3 兼容 R2、COS、OSS、AWS S3 等服务，支持 proxy 和 public 两种访问方式。
• 可配置多个存储后端、默认后端、启用状态和容量配额。
• 支持在已配置后端之间迁移图片、视频、文件和索引，迁移后可将目标后端设为默认。

⁠备份与站点同步

• 创建和恢复完整 .phost.tar.gz 站点备份，包含数据库、图片、视频、文件、缩略图、HLS 内容和标签。
• 备份恢复前可预检文件数量、媒体大小、新增与冲突情况，并选择跳过或覆盖冲突。
• 支持大体积备份流式上传，无需将整个压缩包读入内存。
• 未初始化时可在首次设置页直接恢复备份；云存储密钥不会写入备份，恢复后需重新填写。
• 支持两站点双向同步，可推送或拉取全部媒体，也可只同步图片、视频或文件。
• 站点同步支持断点继续、冲突策略和任务进度；目标站点需要预先存在同名用户。

⁠API 与兼容性

• 提供图片、视频、文件、标签、搜索、批量操作、备份和系统接口。
• 支持全局 Token 和个人 Token，可通过请求头或表单上传。
• 兼容 Twikoo / EasyImage 的 POST /api/index.php 上传接口。
• 前端内置 API 文档和调试界面，支持直接生成并复制 curl 示例。

⁠说明

• 本项目源代码地址：https://github.com/yeomaiyelove/PicHost.git⁠
• 项目衍生自：https://github.com/O96u/PicHost.git⁠
• 本项目做了大量修改，已经与衍生源项目数据不兼容，请注意