BrightBean Studio自托管生产部署完全指南Docker ComposeCaddy自动HTTPS月成本低至10欧元【免费下载链接】brightbean-studioOpen-source, self-hostable social media management platform. Schedule, publish, and manage content across 10 platforms from a single dashboard. Free alternative to Buffer, Sendible, and SocialPilot.项目地址: https://gitcode.com/gh_mirrors/br/brightbean-studioBrightBean Studio 是一款开源、可自托管的社交媒体管理平台让你在一个仪表盘中计划、定时发布并管理 Facebook、Instagram、LinkedIn、TikTok、YouTube 等 10 多个平台的内容是 Buffer、Sendible 的免费替代品。本文带你用Docker Compose Caddy 自动 HTTPS完成生产级部署整套月成本可低至 10 欧元。BrightBean Studio 自托管部署后的视觉日历与定时发布界面一、为什么选择自托管部署自托管的最大好处是数据完全归你所有且没有按席位、按渠道的付费限制一套配置跑起来Docker Compose 一键启动应用、后台任务、PostgreSQL 和 Caddy 反向代理自动 HTTPSCaddy 内置 Lets Encrypt 自动申请证书无需手动配置 Nginx成本极低一台 4 vCPU / 8GB 的 VPS 即可运行development_specs/architecture.md 中有完整成本表无中间商所有平台集成直连官方 API使用你自己的开发者凭证二、部署前准备一台 VPS 就够了推荐配置来自官方架构文档资源规格月成本VPSHetzner CX324 vCPU8GB RAM€7.59媒体存储本地 Docker 卷 或 Cloudflare R210GB 免费~€0邮件Resend每月 3000 封免费~€0合计约 €10最低要求为 2 vCPU / 4GB RAM。在 VPS 上安装 Docker 后即可开始部署BrightBean Studio 支持连接 10 多个社交媒体平台三、生产部署五步走Docker Compose Caddy第 1 步克隆仓库并初始化配置git clone https://gitcode.com/gh_mirrors/br/brightbean-studio cd brightbean-studio cp .env.example .env第 2 步编辑.env关键变量SECRET_KEY生成一个 50 字符的随机字符串 ENCRYPTION_KEY_SALT另一个随机字符串 DEBUGfalse ALLOWED_HOSTSyourdomain.com APP_URLhttps://yourdomain.com DATABASE_URLpostgres://postgres:强密码postgres:5432/brightbean 各变量含义均可在 .env.example 中找到详细注释SMTP 邮件、平台 API 凭证也都是可选的可后续通过管理后台按组织配置。第 3 步配置 Caddy 域名Caddyfile 第一行读取APP_DOMAIN环境变量默认值为localhost。将其加入.envAPP_DOMAINyourdomain.com然后把 DNS 的 A 记录指向 VPS 公网 IP。Caddy 会自动完成 HTTP→HTTPS 跳转并申请证书。第 4 步一条命令启动全部服务docker compose -f docker-compose.yml -f docker-compose.prod.yml up -d --build这一条命令会拉起5 个容器定义见 docker-compose.prod.yml容器作用migrate一次性容器自动执行数据库迁移成功后才放行其他服务appGunicorn4 workers × 2 threads运行 Django 生产配置worker后台任务进程负责定时发布、媒体处理postgresPostgreSQL 16 数据库带健康检查caddy反向代理 自动 HTTPS 直接托管/media/上传文件Caddy 直接从只读挂载的media_data卷提供/media/静态文件大图片和视频不占用 Gunicorn 线程还支持视频拖拽所需的字节范围请求。BrightBean Studio 内容编辑器支持逐平台覆盖与预览第 5 步创建管理员账号并访问docker compose exec app python manage.py createsuperuser打开https://yourdomain.com用超级用户登录即可创建组织和工作区。 首次构建会编译 Tailwind CSS耗时约 1-2 分钟之后启动都是秒级。四、日常运维更新与备份升级到新版本只需两条命令git pull docker compose -f docker-compose.yml -f docker-compose.prod.yml up -d --build数据库迁移会在每次启动时由migrate服务自动完成无需手动执行。备份官方推荐每日用pg_dump导出数据库到对象存储如 Cloudflare R2保留 30 天若媒体也使用 S3则天然高可用。五、媒体存储本地卷还是 S3通过一个环境变量切换详见 development_specs/architecture.mdSTORAGE_BACKENDlocal # 默认Docker 卷适合单 VPS STORAGE_BACKENDs3 # S3 兼容存储R2 等从local切换到s3时记得在.env中设置CADDY_MEDIA_ROOT/var/empty否则 Caddy 会继续对外提供旧卷里遗留的上传文件。六、常见问题快速排查postgres容器显示 unhealthy等待 10-15 秒健康检查通过用docker compose logs postgres查看日志发布卡在 Publishing检查worker是否运行docker compose logs workerOAuth 回调报 redirect URI mismatch确认各平台注册的回调地址与APP_URL完全一致格式为{APP_URL}/social-accounts/callback/{platform}/上传的图片 404确认MEDIA_ROOT/app/media未改动且卷已持久化BrightBean Studio 数据分析面板逐帖与渠道级 KPI 指标七、部署完成后做什么连接社交平台在 Social Accounts 页面连接 Facebook、Instagram、LinkedIn 等各平台的开发者凭证获取步骤见 README.md 的 Platform Credentials 章节创建团队通过邀请链接邀请成员配置工作区权限规划内容用 Kanban 灵感板 管理选题在日历中设置每周固定发布时段与队列查看数据统一的分析面板提供 7/30/90 天趋势、互动率、粉丝增长等指标BrightBean Studio 灵感看板管理你的内容选题总结用 Docker Compose Caddy 自托管 BrightBean Studio 的全部步骤可以浓缩为改.env→ 起容器 → 建超管三步即获得一个带自动 HTTPS 的私有社交媒体管理中台。相比每月 100-300 美元的商业 SaaS你只需约 10 欧元的 VPS 成本数据、账号、内容全部掌握在自己手中。【免费下载链接】brightbean-studioOpen-source, self-hostable social media management platform. Schedule, publish, and manage content across 10 platforms from a single dashboard. Free alternative to Buffer, Sendible, and SocialPilot.项目地址: https://gitcode.com/gh_mirrors/br/brightbean-studio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考