SafeBucket完全指南:为什么这款免费的自托管文件共享平台值得立即部署
SafeBucket完全指南:为什么这款免费的自托管文件共享平台值得立即部署
SafeBucket 是一款免费开源的自托管文件共享平台,主打"文件绕过服务器"的直传直下架构。只需 Docker Compose 一条命令,就能在私有服务器或 NAS 上搭建出带细粒度权限、分享链接与审计日志的企业级文件共享服务——数据、账号、权限全部掌握在自己手里,不依赖任何商业云盘。
一、什么是 SafeBucket?30 秒认识它
SafeBucket 定位为"简单、快速、安全"的本地化文件共享方案:后端由 Go 编写,前端为 React 单页应用,界面分为个人空间(Home / Activity)、管理后台(Dashboard / Users / Buckets)与 Bucket 协作区。文件上传完成后可以直接在列表页管理、分享、下载,右侧还有实时的上传进度与通知面板。
相比"上传到商业网盘再分享"的模式,自托管文件共享的核心价值在于:
- 数据主权:文件只落在你自己的存储上,不经过第三方;
- 零费用:项目采用 Apache 2.0 协议,商用免费;
- 不占服务器带宽:传输走预签名直连,应用服务器只做"签发票"。
二、6 大核心亮点:为什么值得选择它
- 🚀 直传直下(Presigned URLs):上传/下载走对象存储直连,服务器带宽不随文件大小增长,大文件也不卡;
- 🔌 基础设施全可替换:存储支持 S3 兼容、Azure Blob、GCP、RustFS;数据库支持 PostgreSQL 与 SQLite;缓存、消息队列、邮件通知器均可按需更换;
- 🔐 企业级认证:本地账号 + 任意 OIDC 身份提供商(Okta、Google 等)+ LDAP,支持 TOTP 双因素认证(MFA);
- 🎯 双层 RBAC 权限:平台级与 Bucket 级角色分离,成员权限精确到每个共享桶;
- 🔗 快速分享:公开链接支持密码保护、最大下载次数、最大查看次数、自定义分享 ID 等选项(见 internal/services/bucket_share.go);
- 📊 审计与运营:实时活动追踪、管理后台全平台统计、文件过期策略、可配置保留期的回收站。
三、架构拆解:文件为什么能"绕过服务器"
架构非常清晰(图源 assets/hld.png):
- 用户发起请求 → SafeBucket API 校验权限后签发预签名 URL;
- 浏览器拿着 URL 直连对象存储完成上传/下载,应用服务器不搬运字节;
- 对象存储把"文件创建/删除"等事件发布到消息队列,后台 Worker 消费后触发邮件通知(Notifier)并写入活动审计库;
- 元数据、审计日志、缓存分别落在独立的 DB 组件中,互不拖累。
各云存储适配器分布在 internal/storage/ 目录下(如 internal/storage/s3.go),想换存储只改配置即可,无需改代码。
四、5 分钟部署:Docker Compose 一键启动
项目提供了开箱即用的轻量部署脚本 deployments/local/lite/docker-compose.yml,只含 3 个容器:SafeBucket 应用 + RustFS(S3 兼容对象存储)+ 自动初始化任务,数据库用 SQLite、缓存与队列走内存,零外部依赖。
git clone https://gitcode.com/gh_mirrors/sa/safebucket
cd safebucket/deployments/local/lite
docker compose up -d
启动后访问 http://localhost:8080,使用默认管理员账号登录:
- 账号:
admin@safebucket.io - 密码:
ChangeMePlease
外部机器访问?改这 4 个环境变量
如果你的服务器不是本机访问(例如 Proxmox 主机、局域网其他设备),需要编辑 deployments/local/lite/.env,把以下变量改成你的 IP 或域名:
STORAGE__RUSTFS__EXTERNAL_ENDPOINTAPP__ALLOWED_ORIGINSAPP__API_URLAPP__WEB_URL
改完 docker compose up -d 重启即可。
五、生产部署:从轻量到云端的 3 种规模
| 方案 | 路径 | 适用场景 |
|---|---|---|
| lite | deployments/local/lite/ | 单机体验、小团队试用 |
| full | deployments/local/full/docker-compose.yml | 正式内网环境:PostgreSQL + Valkey 缓存 + NATS 事件队列 + SMTP 邮件 + Loki 活动日志 |
| AWS | deployments/aws/terraform/ | 云上托管:ECS + RDS + ElastiCache + S3 + SQS 全套 Terraform |
需要水平扩展时,还可以利用运行档位(profile)把"API 节点"与"Worker 节点"拆分到不同容器——default / api / worker 三种模式定义在 internal/configuration/profiles.go 中。全部可配置项都有中文友好的模板参考:templates/config.yaml。
六、上手即用:分享、回收站与 MFA 日常操作
部署完成后,日常高频操作全部在 Web 界面完成:
- 分享:选中文件或文件夹 → 生成 Quick Share 链接,按需加密码、限次、限时;
- 回收站:删除不丢,保留天数由
APP__TRASH_RETENTION_DAYS控制(lite 默认 7 天); - MFA:个人设置中绑定 TOTP 动态口令,管理侧可强制全员启用;
- 活动页:每个 Bucket 都有实时操作时间线,配合邮件通知,谁下载过什么一目了然;
- 管理后台:用户、Bucket、全平台统计集中在 Dashboard。
七、为什么"值得立即部署"
- ✅ 免费且安全可验证:官方容器镜像均使用 cosign 无密钥签名,拉取后可自行验签,杜绝篡改;
- ✅ 资源占用低:Go 后端 + 静态资源内嵌,lite 模式一台 1 核 2G 的小机器即可承载;
- ✅ 没有厂商锁定:存储、数据库、队列、邮件全部可插拔,未来迁移成本极低;
- ✅ 功能完整:从个人网盘到团队 Bucket 协作、再到平台级审计,一个项目覆盖。
如果你受够了商业网盘的容量限制、限速与隐私顾虑,SafeBucket 提供了一个近乎"零门槛"的替代方案:docker compose up -d 之后,一个完全由你掌控的文件共享平台就跑起来了。🎉

