Chibisafe：开源自托管文件上传与分享服务部署使用指南

一、项目官方信息

Chibisafe 是一个用 TypeScript 写的文件上传服务，开箱即用、易部署、免费开源。它接受文件、照片、文档等任意内容，返回可分享的链接发给别人。

特点：

• 支持公共模式、用户账号模式、邀请模式；
• 大文件自动分片上传，减少网络失败；
• 用户可创建 API Key 程序化调用；
• 自带 Dashboard，几乎所有配置（站点名、速率限制、最大文件、允许扩展名、SEO 描述等）都能在 Web 面板改，无需手改配置文件；
• S3 存储支持、相册/文件夹、代码片段、URL 短链、ShareX 即装即用、浏览器扩展；
• 无广告、无追踪（仅记录请求 IP）。

二、官方图片

上图为 Chibisafe 官方 Logo。

三、环境要求

• 推荐使用 Docker（官方强烈建议）；
• 或手动运行（Node.js / Bun 环境）；
• 反向代理（Caddy/Nginx）用于 HTTPS；
• 磁盘用于存放上传文件（uploads/）与数据库（database/）。

四、部署步骤

1. 用 Docker 运行（推荐）

按官方文档运行 chibisafe（提供 Docker 配置）：https://chibisafe.app/docs/installation/running-with-docker

v6 版本默认对外暴露 24424 端口（用官方 docker 配置时为单端口，便于反向代理）。

2. 手动运行（备选）

参考官方文档 https://chibisafe.app/docs/installation/running-manually，用 Bun/Node 安装依赖后启动。

3. 首次登录

安装过程会自动创建一个名为 admin 的账号，初始密码相同。首次登录后请立即修改密码。

4. 反向代理 + HTTPS

把域名指向 24424 端口，用 Caddy/Nginx 反代并配置 SSL 证书。

五、使用方法

• 上传文件：Web 端拖入文件即传，完成后得到直链；大文件自动分片。
• Dashboard：在面板里改站点名、限速、最大文件、允许扩展名、meta 描述等。
• 分享：单个文件直链、相册/文件夹分享、代码片段。
• API：用户创建 API Key，程序化上传，配合脚本/ShareX。
• ShareX：开箱即用，配置后可直接上传桌面截图/录屏。
• S3 存储：可接入 S3 兼容存储作为后端（见 docs/s3.md）。
• 安全头：官方 Caddyfile 对上传文件响应加 CSP sandbox 等隔离头，防止上传内容带脚本。

六、常见问题 FAQ

1. 初始账号密码是什么？ 安装自动创建 admin 账号、初始密码同账号名，首次登录务必修改。

2. v6 默认端口是多少？ 24424（用官方 docker 配置时为单端口）。

3. 推荐用什么方式部署？ 官方强烈推荐 Docker；手动运行见 running-manually 文档。

4. 大文件怎么传？ 自动分片上传，降低网络波动导致的失败。

5. 支持 S3 存储吗？ 支持，见 docs/s3.md，可把上传文件存到 S3 兼容存储。

6. 从旧版本升级？ v5 → v6 复制 uploads/ 和 database/ 两个目录到新实例，启动后自动迁移；更早版本不能直接升 v6，建议新建实例。

七、跳转链接

• GitHub 仓库：https://github.com/chibisafe/chibisafe
• 官方文档：https://chibisafe.app
• Docker 部署：https://chibisafe.app/docs/installation/running-with-docker