chibisafe
一个快速、自托管的文件上传服务，具有漂亮的瀑布流相册、分片上传、URL 缩短和用户管理功能。
智能下载
前往项目主页
该项目暂未提供安装包，请直接访问源代码仓库
自己搭建的文件分享器，支持大文件分片、相册管理和链接缩短。
核心功能
- 漂亮的瀑布流媒体浏览界面
- 大文件分片上传，减少失败率
- 支持 S3 对象存储（兼容 AWS、MinIO 等）
- 相册/文件夹功能，可生成直接分享链接
- 内置 URL 缩短器
避坑指南
- •从 v5 以下版本无法直接迁移到 v6，建议全新安装。默认管理员密码极不安全，首次登录后必须更换。如果使用 Docker，确保映射 volume 持久化数据。
适用场景
- 个人或团队搭建私有文件分享平台
- 替代图床或临时文件传输工具（如 WeTransfer）
- 结合 ShareX 实现截图自动上传并生成短链接
详细介绍
Chibisafe 是一个现代文件上传服务，采用 TypeScript 编写。你可以上传文件、照片、文档等任何内容，并获得可分享的链接。支持公开模式、用户账户模式或仅限邀请模式。大文件自动分片上传，避免网络故障。你可以直接从后台界面编辑几乎所有配置，无需手动修改环境变量或配置文件。功能包括 S3 存储支持、相册/文件夹、文件标签、用户配额、URL 缩短、ShareX 集成、浏览器扩展和 iOS 快捷指令。完全开源（MIT 许可），可通过 Docker 或手动方式轻松部署。
常见问题与排障 (1)
故障排除如何修复在Docker部署后登录chibisafe时出现的"TypeError: r is undefined"错误？
此错误通常是由于您的docker-compose.yml中的自定义环境变量与chibisafe内部配置冲突所致。请使用chibisafe文档中的官方docker-compose.yml和Caddyfile，不做任何修改。不要手动设置BASE_API_URL或ADMIN_PASSWORD。确保Caddyfile与compose文件位于同一目录。如果前端日志中仍然显示"fetch failed"，请验证您的反向代理配置以及chibisafe和chibisafe_server容器之间的网络连通性。
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
推荐使用 Docker：下载 docker-compose.yml 并运行 docker-compose up -d
首次登录账号 admin，密码 admin（务必立即修改）
通过反向代理（如 Nginx）将 24424 端口暴露到公网
- 推荐使用 Docker：下载 docker-compose.yml 并运行 docker-compose up -d
- 首次登录账号 admin，密码 admin（务必立即修改）
- 通过反向代理（如 Nginx）将 24424 端口暴露到公网
暂未获取到校验码
该项目暂未在 GitHub Release 页面提供 SHA-256 校验码
SHA256 校验码
暂无校验码
建议从 GitHub Releases 页面直接下载，并自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
停止容器（docker-compose down）并删除映射的数据卷（uploads/ 和 database/ 文件夹）即可完全移除。
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
1 FAQ