[其他] 基于Docker自托管开源项目管理工具Focalboard的实践指南

摆脱 Trello 的月费束缚，也不担心 Notion 的协作限制？开源自托管的项目与任务协作平台或许是你理想的选择。今天我们来实践部署 Focalboard，它将看板、日历、表格等多种视图集成于一身，帮你把整个项目管理流程搬回自己的服务器。

关于 Focalboard

Focalboard 是一个开源的、可自托管的项目与任务协作平台，可以作为 Trello、Notion 或 Asana 的本地化替代方案。

• 项目官网：www.focalboard.com
• 开源仓库：github.com/mattermost/focalboard

它的核心亮点包括：

• 多视图协作：在看板（Kanban）、日历、表格和单任务视图间一键切换。
• 实时协作：支持多人同时在线编辑、评论、@提醒和文件附件功能。
• 权限管理：内置角色与权限系统，适合团队或跨部门使用。
• 数据自主：所有数据本地存储，你拥有100%的控制权。它支持 SQLite 和 PostgreSQL 两种数据库后端，方便你根据需求选择。

部署前置条件

确保你的服务器或本地环境已安装 Docker 20.10 及以上版本以及 Docker Compose。同时，确认端口 8000（或你计划使用的其他端口）空闲可用。

部署方式一：快速启动单容器（适合体验）

如果你只是想快速体验 Focalboard，可以使用单条 Docker 命令在 60 秒内启动服务。

首先，创建一个用于存放数据的工作目录：

mkdir -p ~/focalboard && cd ~/focalboard

然后，拉取官方最新镜像并运行容器：

docker run -d --name focalboard \
  -p 8000:8000 \
  -v $PWD/data:/data \
  -e TZ=Asia/Shanghai \
  mattermost/focalboard:latest

这条命令的关键参数解释如下：

• -p 8000:8000: 将容器内部的 8000 端口映射到宿主机的 8000 端口。
• -v $PWD/data:/data: 将当前目录下的 data 文件夹挂载到容器内的 /data 路径，实现数据持久化。即使容器被删除，你的数据仍然安全地保留在本地 ./data 目录中。
• -e TZ=Asia/Shanghai: 设置容器的时区为亚洲/上海。

执行后，终端会显示一个类似 ebb8de151e579757d77ebf6bce851f540bfef5f69c14a9c174a258e9496ab7221 的容器ID，表示容器已在后台启动。

访问验证：
在浏览器中打开 http://你的服务器IP:8000 或 http://127.0.0.1:8000。
首次访问会进入登录页面，页面中央有“Log in”标题的登录框，包含用户名和密码输入栏以及一个蓝色的登录按钮。页面支持中英文切换，并有提示“or create an account if you don't have one”。
此时，点击注册创建的第一个账户将自动成为系统管理员。登录后，你便可以立即开始创建你的第一个看板。

部署方式二：使用 Docker Compose（推荐生产环境）

对于需要长期稳定运行的环境，使用 Docker Compose 进行管理是更佳选择。它能方便地定义服务配置、实现自动重启和简化升级流程。

在工作目录中创建 docker-compose.yml 文件：

cat > docker-compose.yml <<'EOF'
version: "3.8"
services:
  focalboard:
    image: mattermost/focalboard:latest
    container_name: focalboard
    restart: unless-stopped
    ports:
      - "8000:8000"
    volumes:
      - ./focalboard_data:/data
    environment:
      - TZ=Asia/Shanghai
      - FOCALBOARD_PORT=8000
EOF

这个配置文件定义了名为 focalboard 的服务，使用最新官方镜像，并设置了容器总是重启（除非手动停止）。数据被持久化到宿主机当前目录的 focalboard_data 文件夹。

使用以下命令一键启动服务：

docker compose up -d

执行此命令后，系统会开始拉取 mattermost/focalboard:latest 镜像，显示多个镜像层（如 751ef25978b2、93b9b91ae73f 等）的拉取完成状态，最终提示“Creating focalboard ... done”，表示服务已成功在后台运行。
你可以通过 docker compose ps 命令检查服务状态，如果显示 Up 则表示运行正常。

后续升级：
当有新版本发布时，只需在项目目录下执行以下命令即可完成平滑升级：

docker compose pull && docker compose up -d
docker image prune -f  # 可选：清理无用的旧镜像以释放磁盘空间

功能速览：三分钟创建一个产品迭代看板

登录 Focalboard 后，点击左侧导航栏的 “+ Add board” 按钮，然后选择 “Create new template”。系统提供了丰富的预制模板，如会议议程、销售管道、个人任务和项目任务等。

我们选择 “Project Tasks”（项目任务）模板并点击 “Use this template”。该模板预设了 “Not Started”（未开始）、“In Progress”（进行中）、“Blocked”（受阻）和“Completed”（已完成）四个任务状态列，非常适合管理产品迭代。

现在，你可以开始填充你的看板：

1. 在 “Not Started” 列，新建一张卡片，标题为 “用户头像上传功能”，并为其设置高优先级（HIGH）。
2. 在 “In Progress” 列，新建卡片 “暗黑模式适配”，设置为中等优先级（MEDIUM）。
3. 在 “Done” 列，新建卡片 “支付通道（如PayPal）对接”。

创建完成后，你的看板会清晰展示各项任务及其状态。你可以通过拖拽卡片（例如将“暗黑模式适配”从“进行中”拖到“已完成”）来实时更新任务进度，所有变更会自动保存。

Focalboard 的强大之处在于多视图。点击看板右上角的 “Calendar” 按钮，即可切换到日历视图，所有带有截止日期的任务会按时间线排列，形成直观的甘特图。你还可以切换到“表格”视图，以列表形式查看所有任务的详细信息，包括名称、状态、优先级、创建日期、截止日期和负责人等字段。

团队协作：进入看板的 “Settings” -> “Add Members”，你可以生成邀请链接发送给同事。他们注册并加入后，便能与你实时协作，共同拖动卡片、更新状态和添加评论。

常见问题与配置

• 端口冲突：如果宿主机 8000 端口已被占用，只需修改 docker-compose.yml 文件中 ports 的映射配置，例如改为 - “9090:8000”，然后重启服务即可通过新端口访问。
• 数据备份与迁移：所有数据（包括数据库和上传文件）都存放在你指定的持久化目录中（如 ./focalboard_data）。定期对这个目录进行压缩备份（如使用 tar 命令），或使用 pg_dump 工具备份 PostgreSQL 数据库，即可轻松实现数据迁移或恢复。
• 外网安全访问：若需从公网访问，强烈建议通过 Nginx 或 Caddy 等反向代理服务器将流量代理到 http://localhost:8000，并配置 HTTPS 证书。这不仅能提升安全性，还能确保 Focalboard 的实时 WebSocket 通信功能正常工作。

至此，你的专属“自托管项目管理中枢”已经部署上线。无论是管理个人待办事项，还是协调团队的敏捷冲刺（Sprint），Focalboard 都能提供强大而灵活的支持。现在，就把你的第一个任务卡片拖到“完成”列，享受零月费、零流量限制的自主管理体验吧。

参考资料

[1] 5 分钟自建“多视图项目管理神器”——Focalboard Docker 一键部署教程, 微信公众号：mp.weixin.qq.com/s/_hw174nEtGzm1fGv4MyNVA

版权声明：本文由 云栈社区 整理发布，版权归原作者所有。