Focalboard 看板管理器部署教程

Focalboard 是由 Mattermost 团队开发的开源项目管理工具，提供类似 Notion 数据库和 Trello 看板的功能。它支持看板、表格、日历和画廊等多种视图，可以作为独立服务运行，也可以集成到 Mattermost 中使用。本教程将在搬瓦工 VPS 上通过 Docker 部署独立版 Focalboard。

一、Focalboard 核心特性

多视图模式：看板视图、表格视图、日历视图和画廊视图，同一数据多种展现方式。
自定义属性：为卡片添加自定义属性字段，包括文本、数字、日期、选择、人员和 URL 等类型。
分组与过滤：支持按任意属性分组展示，以及多条件组合过滤。
模板系统：内置多种项目模板（会议笔记、路线图、内容日历等），也可自建模板。
卡片详情：卡片支持富文本描述、评论和属性编辑，类似 Notion 的页面体验。
轻量高效：Go 语言编写，内存占用低，支持 SQLite 和 PostgreSQL 存储。

二、环境准备

操作系统：Ubuntu 20.04+（推荐 Ubuntu 22.04）。
内存：至少 512MB RAM，推荐 1GB。
磁盘：至少 5GB 可用空间。
Docker：已安装 Docker 和 Docker Compose（参考 Docker 安装教程）。

购买搬瓦工 VPS 请参考全部方案，使用优惠码 NODESEEK2026 可享受 6.77% 折扣。

三、Docker Compose 部署

3.1 创建项目目录

mkdir -p /opt/focalboard && cd /opt/focalboard

3.2 使用 PostgreSQL 后端部署

cat > docker-compose.yml <<'EOF'
version: '3.8'

services:
  focalboard:
    image: mattermost/focalboard:latest
    container_name: focalboard
    restart: always
    ports:
      - "8000:8000"
    environment:
      FOCALBOARD_DB_TYPE: postgres
      FOCALBOARD_DB_CONFIG: "postgres://focalboard:your_db_password@db:5432/focalboard?sslmode=disable"
    volumes:
      - focalboard_data:/opt/focalboard/data
    depends_on:
      - db

  db:
    image: postgres:15-alpine
    container_name: focalboard-db
    restart: always
    environment:
      POSTGRES_USER: focalboard
      POSTGRES_PASSWORD: your_db_password
      POSTGRES_DB: focalboard
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  focalboard_data:
  postgres_data:
EOF

3.3 轻量版部署（SQLite）

如果只是个人使用，可以使用更简单的 SQLite 配置：

docker run -d \
  --name focalboard \
  --restart always \
  -p 8000:8000 \
  -v /opt/focalboard/data:/opt/focalboard/data \
  mattermost/focalboard:latest

3.4 启动服务

docker compose up -d
docker compose logs -f focalboard

访问 http://你的服务器IP:8000 注册账户即可开始使用。

四、Nginx 反向代理

cat > /etc/nginx/sites-available/focalboard <<'EOF'
server {
    listen 80;
    server_name board.example.com;

    location / {
        proxy_pass http://127.0.0.1:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}
EOF

ln -s /etc/nginx/sites-available/focalboard /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx
certbot --nginx -d board.example.com

五、Focalboard 使用指南

5.1 创建看板

登录后进入工作区，点击"+ Add board"创建新看板。可以从空白开始或选择内置模板（项目任务、会议笔记、内容日历、个人目标等）。每个看板可以包含多个视图，不同视图展示同一份数据。

5.2 管理卡片

在看板视图中点击"+ New"添加卡片。打开卡片后可以编辑标题、添加描述（支持 Markdown）、设置属性值和添加评论。卡片支持自定义属性字段，例如状态、优先级、负责人、截止日期等。通过拖拽可以在不同列之间移动卡片。

5.3 视图切换

在看板顶部可以添加和切换不同视图。表格视图以电子表格形式展示所有卡片和属性。日历视图将卡片按日期展示在日历上。画廊视图以卡片缩略图形式展示。每个视图可以独立设置分组、排序和过滤条件。

5.4 过滤与分组

通过过滤功能精确筛选需要关注的卡片。支持多条件组合过滤，例如"优先级为高 AND 状态为进行中"。分组功能可以按选择类型的属性值对卡片进行归类展示。

六、备份与升级

# 备份 PostgreSQL
docker exec focalboard-db pg_dump -U focalboard focalboard > /opt/focalboard/backup_$(date +%Y%m%d).sql

# 备份数据目录
docker cp focalboard:/opt/focalboard/data /opt/focalboard/data_backup_$(date +%Y%m%d)

# 升级
cd /opt/focalboard
docker compose pull
docker compose down
docker compose up -d

总结

Focalboard 是一款轻量且功能丰富的看板管理工具，Go 语言编写带来了出色的性能表现。适合个人和小团队使用。同类工具还有 WeKan，功能更全面的项目管理可以选择 Plane。购买搬瓦工 VPS 请参考全部方案，使用优惠码 NODESEEK2026 可享受折扣。