博客类别

服务器
2025 年 10 月 25 日

Ubuntu 24.04 自托管 Focalboard 终极设置指南

自托管的 Focalboard Ubuntu 24.04 可让您完全掌控项目管理数据。与云解决方案（您的敏感信息存储在第三方服务器上）不同，自托管方法可确保数据主权并符合组织安全策略。.

本教程将指导您使用 PostgreSQL 数据库和 Nginx 反向代理部署 Focalboard，从而为您的团队协作需求创建一个安全且可扩展的环境。您将学习如何配置 SSL 证书以进行加密连接，如何设置 systemd 服务以实现自动启动，以及如何优化安装以供生产使用。.

Focalboard 是一款优秀的开源项目管理替代方案，它提供看板、任务列表、日历视图和协作工作区，所有这些都运行在您自己的基础架构上，无需定期订阅费用。无论您是管理小型团队还是扩展以满足企业需求，此设置都能提供您组织所需的灵活性和性能。.

自托管 Focalboard 的优势

特征	自托管焦点板	基于云的解决方案
数据所有权	完全控制您的服务器	存储在供应商服务器上
每月费用	免费（开源）	$10-25 每位用户每月
隐私	完整的数据主权	受供应商政策约束
定制	无限制访问	受限于平台功能
遵守	符合任何法规	取决于供应商
特征	看板、表格、日历、画廊	类似功能

欲了解更多信息，请访问 Focalboard 官方网站并检查 GitHub 存储库.

#1 服务器连接

通过 SSH 连接到您的 Ubuntu 24.04 服务器：

ssh root@192.168.xx

代替 192.168.xx 替换为您的实际服务器 IP 地址。Windows 用户可以使用 PuTTY 或 Windows 终端。.

#2 安装所需软件包

更新系统包：

apt 更新

安装 Web 服务器、SSL 工具和数据库：

apt 安装 wget 解压缩 curl gnupg nginx python3-certbot-nginx apt 安装 postgresql postgresql-contrib

#3 数据库配置

切换到 PostgreSQL 用户并访问数据库 shell：

su - postgres psql

创建数据库和用户：

创建数据库 focalboard；创建用户 focaluser，密码为'YourSecurePass'；授予 focaluser 对数据库 focalboard 的所有权限；\q

代替 您的安全通行证 使用您的安全密码。退出到 root 用户：

出口

#4 下载焦点板

创建安装目录并下载包：

mkdir -p /opt/focalboard cd /opt/focalboard wget https://sourceforge.net/projects/focalboard.mirror/files/v7.10.6/focalboard-server-linux-amd64.tar.gz/download -O focalboard-server-linux-amd64.tar.gz

提取和清理：

tar -xzf focalboard-server-linux-amd64.tar.gz rm focalboard-server-linux-amd64.tar.gz

#5 焦板配置

编辑配置文件：

nano /opt/focalboard/focalboard/config.json

使用您的数据库凭证进行更新：

{ "serverRoot"："http://localhost:8000"， "port"：8000， "dbtype"："postgres"， "dbconfig"："postgres://focaluser:YourSecurePass@localhost/focalboard?sslmode=disable&connect_timeout=10"， "useSSL"：false， "webpath"："./pack"， "filespath"："./files"， "telemetry"：true， "session_expire_time"：2592000， "session_refresh_time"：18000， "localOnly"：false， "enablePublicSharedBoards"：true， "featureFlags"：{} }

代替 您的安全通行证 使用您的实际密码。保存 CTRL+X, 是, 进入.

#6 设置系统服务

创建 systemd 服务文件：

纳米/etc/systemd/system/focalboard.service

添加此配置：

[单元] 描述=Focalboard 服务器 After=network.target [服务] 类型=简单 Restart=always RestartSec=5s ExecStart=/opt/focalboard/focalboard/bin/focalboard-server WorkingDirectory=/opt/focalboard/focalboard [安装] WantedBy=multi-user.target

启用并启动服务：

systemctl 守护进程重新加载 systemctl 启用 focalboard systemctl 启动 focalboard systemctl 状态 focalboard

#7 Nginx 配置

创建 Nginx 站点配置：

纳米/etc/nginx/sites-available/focalboard.conf

添加此配置（替换 example.com):

上游 focalboard { 服务器 127.0.0.1:8000; keepalive 32; } 服务器 { 监听 80; 服务器名称 example.com; 位置 / { proxy_pass http://focalboard; proxy_set_header 主机 $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; } 位置 ~ /ws/* { proxy_http_version 1.1; proxy_set_header 升级 $http_upgrade; proxy_set_header 连接"升级"; proxy_pass http://focalboard; } }

启用配置：

ln -s /etc/nginx/sites-available/focalboard.conf /etc/nginx/sites-enabled/ rm /etc/nginx/sites-enabled/default nginx -t systemctl 重新加载 nginx

#8 SSL 证书设置

使用 Let's Encrypt 安装 SSL 证书：

certbot --nginx -d example.com

代替 example.com 与您的域名。按照提示完成设置。.

#9 接入焦点板

在网络浏览器中导航到您的域名：

https://example.com

通过注册页面创建您的第一个帐户。初始注册始终允许，但其他用户需要邀请链接。.

在高性能基础设施上部署

正在为您的 Focalboard 安装寻找可靠的托管服务吗？ QUAPE VPS QUAPE 提供基于 AMD EPYC 处理器和超快 NVMe SSD 存储的强大基础架构。凭借 99.9% 正常运行时间保证、完全 root 访问权限以及全天候专家支持，QUAPE 以极具竞争力的价格为您的团队提供所需的性能。.

开始使用 QUAPE VPS主机并体验企业级硬件为您的自托管应用程序带来的不同。.