Fizzy部署实战：从开发到生产的完整终极指南

Fizzy是一款由37signals开发的开源看板工具，专为项目管理和团队协作设计。本指南将带你从零开始，掌握Fizzy的多种部署方法，实现从开发环境到生产环境的平滑过渡。无论你是个人开发者还是企业团队，都能通过这篇教程快速上手。

🚀 快速入门：选择适合你的部署方式

Fizzy提供了两种主要的部署方案：

• Docker部署：适合不需要修改源码的用户，开箱即用
• Kamal部署：适合需要自定义功能和持续部署的场景

📦 Docker一键部署：最简单的启动方式

如果你只想快速体验Fizzy的功能，Docker部署是最佳选择。项目提供了预构建的Docker镜像，只需几个简单步骤即可运行。

环境准备与配置

首先，你需要一个运行Docker的服务器，并配置必要的环境变量：

核心配置项：

• SECRET_KEY_BASE：用于加密的安全密钥
• BASE_URL：你的Fizzy实例公开访问地址
• MAILER_FROM_ADDRESS：邮件发送地址
• SMTP_ADDRESS：SMTP服务器地址

存储配置最佳实践

为了确保数据持久化，建议使用挂载卷：

docker run --volume fizzy:/rails/storage ghcr.io/basecamp/fizzy:main

SSL证书自动配置

Fizzy支持自动SSL证书配置，只需设置TLS_DOMAIN环境变量即可启用HTTPS。

🔧 Kamal专业部署：完全控制你的Fizzy实例

如果你需要自定义功能或持续部署，Kamal是更好的选择。这也是37signals官方使用的部署工具。

初始化配置步骤

1. Fork仓库：创建项目副本以便自定义
2. 运行初始化：执行kamal init生成配置文件
3. 编辑配置：修改config/deploy.yml文件
4. 首次部署：运行kamal setup完成初始部署

关键配置文件详解

在config/deploy.yml中，你需要配置：

• 服务器地址和SSH连接信息
• SSL配置和域名设置
• 环境变量和密钥管理

⚙️ 生产环境优化配置

数据库配置策略

Fizzy支持多种数据库后端，生产环境建议：

• 使用MySQL或PostgreSQL获得更好的性能
• 配置适当的连接池大小
• 启用数据库连接健康检查

文件存储方案选择

默认使用本地磁盘存储，如需使用云存储：

• 设置ACTIVE_STORAGE_SERVICE=s3
• 配置S3相关参数
• 考虑备份和灾备策略

🛡️ 安全配置最佳实践

密钥管理

• 使用bin/rails secret生成安全的SECRET_KEY_BASE
• 配置VAPID密钥对用于推送通知
• 定期轮换敏感密钥

访问控制

• 配置多租户模式（可选）
• 设置用户权限和角色管理
• 实现API访问控制

🔍 监控与维护

健康检查

配置适当的健康检查端点，确保服务正常运行。

日志管理

设置集中式日志收集，便于问题排查和性能分析。

📋 部署清单总结

在完成Fizzy部署后，建议检查以下项目：

• ✅ 服务可正常访问
• ✅ SSL证书配置正确
• ✅ 邮件发送功能正常
• ✅ 文件上传功能正常
• ✅ 通知推送功能正常

通过本指南，你可以根据具体需求选择最适合的部署方式，快速搭建属于自己的看板协作平台。无论是简单的个人使用还是复杂的企业部署，Fizzy都能提供稳定可靠的服务。

官方文档：docs/development.md Docker部署指南：docs/docker-deployment.md Kamal部署指南：docs/kamal-deployment.md