当前位置：首页 > news >正文

敏捷项目开发工具【Focalboard安装指南】

news 2025/7/1 10:01:56

方式一：个人桌面版（最简单，无需服务器）

这是最快、最便捷的体验方式，直接在您的 Windows、Mac 或 Linux 电脑上安装一个独立的应用程序。数据完全存储在您的本地电脑上。

适合人群：个人使用，或想在部署到服务器前快速体验功能的用户。

安装步骤：

访问下载页面：
打开 Focalboard 的官方 GitHub Releases 页面：
https://github.com/mattermost/focalboard/releases
选择对应版本：
在最新的版本下，找到 “Assets” 部分，根据您的操作系统下载对应的文件：
- Windows: 下载 .exe 或 .zip 文件 (例如 focalboard-win-x64.zip)。
- macOS (Intel): 下载 ...-mac-x64.dmg 文件。
- macOS (Apple Silicon M1/M2): 下载 ...-mac-arm64.dmg 文件。
- Linux: 下载 .tar.gz 文件。
安装并运行：
- Windows: 如果是 .exe，直接双击安装。如果是 .zip，解压后运行 focalboard.exe。
- macOS: 双击 .dmg 文件，将 Focalboard 图标拖拽到“应用程序”文件夹即可。
- Linux: 解压后，直接运行 focalboard-app 可执行文件。

安装完成后，你就有了一个功能齐全的本地看板工具了！

方式二：Docker 服务器版（推荐的团队协作方式）

使用 Docker 是在服务器上部署 Focalboard 最推荐、最流行的方式。它将应用和其依赖项打包在一起，隔离环境，安装和升级都非常方便。

适合人群：需要团队协作，有自己的服务器（可以是云服务器、公司内网服务器或 NAS）。

前提条件：

一台安装了 Linux 的服务器。
服务器上已经安装了 Docker 和 Docker Compose。

安装步骤：

创建安装目录：
通过 SSH 登录到您的服务器，然后创建一个专门的目录来存放 Focalboard 的数据和配置文件。
```
mkdir focalboard
cd focalboard
```
创建 docker-compose.yml 文件：
在这个目录里，创建一个名为 docker-compose.yml 的文件：
```
nano docker-compose.yml
```
然后，将下面的内容复制粘贴进去：
```
version: '3.8'
services:focalboard:image: mattermost/focalboard:latest # 使用官方最新镜像container_name: focalboardrestart: unless-stoppedports:- "8000:8000" # 将服务器的8000端口映射到容器的8000端口volumes:- ./focalboard_data:/data # 将数据持久化到当前目录下的 focalboard_data 文件夹environment:- TZ=Asia/Shanghai # 可选：设置时区为上海
```
配置说明：
- ports: "8000:8000": 左边的 8000 是您服务器的端口，可以改成其他未被占用的端口，比如 8099:8000。
- volumes: ./focalboard_data:/data: 这一行非常重要，它会将 Focalboard 的所有数据（看板、卡片等）保存在你服务器当前目录下的 focalboard_data 文件夹里，确保容器删除后数据不丢失。
启动 Focalboard 服务：
在 docker-compose.yml 文件所在的目录中，运行以下命令：
```
docker-compose up -d
```
- -d 参数表示在后台（detached mode）运行。
- Docker 会自动拉取最新的 Focalboard 镜像并启动容器。
访问 Focalboard：
现在，在您的浏览器中访问 http://<你的服务器IP>:8000 （如果你修改了端口，请使用你修改后的端口）。

首次访问时，它会引导您创建第一个用户，该用户将自动成为管理员。

如何更新？
升级非常简单，只需在 focalboard 目录下执行几条命令：

docker-compose pull       # 拉取最新镜像
docker-compose up -d      # 使用新镜像重启服务
docker image prune -f     # (可选)清理旧的无用镜像

方式三：Linux 二进制文件服务器版（不使用 Docker）

如果你不想或不能使用 Docker，也可以直接在 Linux 服务器上运行它的二进制文件。

适合人群：对 Linux 系统操作比较熟悉的用户。

安装步骤：

下载二进制包：
同样访问 GitHub Releases 页面：https://github.com/mattermost/focalboard/releases
找到最新的版本，下载对应的 Linux 版本，通常是 focalboard-server-linux-amd64.tar.gz。
在服务器上用 wget 命令下载：
```
# 注意替换成最新版本的链接
wget https://github.com/mattermost/focalboard/releases/download/v7.11.3/focalboard-server-linux-amd64.tar.gz
```
解压文件：
```
tar -xvzf focalboard-server-linux-amd64.tar.gz
```
解压后会得到一个名为 focalboard 的文件夹。
运行服务器：
进入解压后的目录并启动服务：
```
cd focalboard
./bin/focalboard-server
```
默认情况下，它也会在 8000 端口上运行。你可以通过浏览器访问 http://<你的服务器IP>:8000。
但这样关闭终端窗口，服务就会停止。

（推荐）配置为系统服务（Systemd）：
为了让 Focalboard 在后台持续运行并开机自启，最好将它配置成一个系统服务。
a. 创建服务文件：

sudo nano /etc/systemd/system/focalboard.service

b. 将以下内容粘贴进去，注意修改 User 和 ExecStart 中的路径为你自己的用户名和实际路径。

[Unit]
Description=Focalboard Server
After=network.target[Service]
Type=simple
User=your_username # 替换为你的Linux用户名
WorkingDirectory=/path/to/focalboard # 替换为你的focalboard解压路径
ExecStart=/path/to/focalboard/bin/focalboard-server # 替换为你的focalboard-server完整路径
Restart=always
RestartSec=10
LimitNOFILE=49152[Install]
WantedBy=multi-user.target

c. 启用并启动服务：

sudo systemctl daemon-reload      # 重新加载服务配置
sudo systemctl enable focalboard  # 设置开机自启
sudo systemctl start focalboard   # 立即启动服务
sudo systemctl status focalboard  # 查看服务状态，确保是 active (running)

总结与推荐

安装方式	优点	缺点	适合人群
个人桌面版	极其简单，无需任何技术背景，完全本地	无法团队协作	个人用户、快速体验者
Docker服务器版	安装/升级简单，环境隔离，数据安全	需要先安装Docker	所有希望自托管的团队（强烈推荐）
Linux二进制版	无需Docker，资源占用可能略低	安装和维护（如开机自启）相对繁琐	不想用Docker的Linux熟练用户