nicoulaj/focalboard

Focalboard Docker镜像

镜像概述和主要用途

Focalboard Docker镜像是适用于focalboard的跨平台容器化解决方案，旨在简化这款开源项目管理工具的部署流程。Focalboard提供看板、任务跟踪、项目协作等功能，该镜像通过容器化技术，使Focalboard可在多种操作系统环境中快速部署和运行。

镜像仓库地址：https://hub.docker.com/r/nicoulaj/focalboard
源码地址：https://github.com/nicoulaj/focalboard-docker

核心功能和特性

• 跨平台兼容性：支持在Linux、Windows、macOS等多种操作系统环境运行
• 简化部署流程：通过容器化减少环境依赖和配置复杂性
• 灵活配置：支持自定义配置文件，满足不同场景的部署需求
• 数据持久化：支持挂载卷存储数据库文件和用户数据，确保数据不丢失

使用场景和适用范围

适用于需要快速部署项目管理工具的个人用户、开发团队或小型组织，特别适合：

• 开发团队进行敏捷项目管理和任务跟踪
• 小型企业搭建内部协作平台
• 个人用户管理个人项目和待办事项

使用方法和配置说明

快速部署（Docker命令行）

通过以下命令直接启动Focalboard容器：

bash
docker run -p 8000:8000 nicoulaj/focalboard

启动后，通过 http://localhost:8000 访问Focalboard服务，默认使用SQLite数据库，数据存储在容器内部。

持久化部署（Docker Compose）

1. 创建配置文件

创建 config.json 配置文件，自定义服务参数：

json
{
    ["serverRoot": "http://focalboard.tld",]  // 可选：服务器根URL，用于外部访问
    "port": 8000,                            // 服务监听端口
    "dbtype": "sqlite3",                     // 数据库类型（支持sqlite3或postgres）
    "dbconfig": "/var/lib/focalboard/focalboard.db",  // SQLite数据库文件路径
    "postgres_dbconfig": "dbname=focalboard sslmode=disable",  // PostgreSQL连接配置（dbtype为postgres时使用）
    "useSSL": false,                         // 是否启用SSL
    "webpath": "./pack",                     // Web资源文件路径
    "filespath": "/var/lib/focalboard/files",  // 附件存储路径
    "telemetry": false,                      // 是否启用使用情况统计
    "session_expire_time": 2592000,          // 会话过期时间（秒，默认30天）
    "session_refresh_time": 18000,           // 会话刷新时间（秒，默认5小时）
    "localOnly": false,                      // 是否仅允许本地访问
    "enableLocalMode": true,                 // 是否启用本地模式
    "localModeSocketLocation": "/var/tmp/focalboard_local.socket"  // 本地模式套接字路径
}

2. 创建docker-compose.yml文件

yaml
services:
  focalboard:
    image: nicoulaj/focalboard
    volumes:
      - ./config.json:/opt/focalboard/config.json  # 挂载自定义配置文件
      - /var/lib/focalboard:/var/lib/focalboard    # 挂载数据卷，持久化存储数据库和文件
    ports:
      - "8000:8000"  # 端口映射，主机端口:容器端口
    restart: unless-stopped  # 服务异常时自动重启

3. 启动服务

在配置文件所在目录执行以下命令启动服务：

bash
docker-compose up -d

服务启动后，通过 http://localhost:8000 访问Focalboard，数据将持久化存储在主机的 /var/lib/focalboard 目录中。