4ga Boards 3.3.13 介绍与选型指南

4ga Boards v3.3.13 介绍与选型：软件定位与 PLANKA 同源关系、React+Sails.js+PostgreSQL 技术架构、功能特性清单、适用场景与限制，以及与 PLANKA/Wekan/Kanboard 的量化选型对比（2026-10-22 官方渠道溯源）。

4ga Boards看板项目管理2026/10/23

4ga Boards 3.3.13 介绍与选型指南

目标：面向准备自托管看板式项目管理平台的团队与个人，介绍 4ga Boards v3.3.13 的软件定位、技术架构、功能特性、适用场景与限制，并给出与同类开源看板系统（PLANKA、Wekan、Kanboard）的量化选型对比。本文为认知与选型篇，全部信息经官方渠道联网溯源（来源与查询日期 2026-10-22 标注于正文各处），不含本地实测环节；逐步部署实操与真实命令回显见本专栏《Ubuntu 22.04 安装 4ga Boards 3.3.13 指南》与《4ga Boards 3.3.13 Docker Compose 部署指南》。

一、环境信息

本篇为 A1 认知篇，按规范仅做联网溯源、不做本地实测。为保证可复核性，先交代本次调研的取证环境：

  • 调研（查询）日期：2026-10-22
  • 软件名称：4ga Boards（官网品牌名，仓库与镜像名 4gaBoards / 4gaboards）
  • 官方网址：https://4gaboards.com
  • 官方文档：https://docs.4gaboards.com （提供英文与波兰语版本）
  • 源码仓库：https://github.com/RARgames/4gaBoards
  • 查询当日最新稳定版：v3.3.13（发布于 2026-07-15，来源：GitHub Releases 页与 shields.io release 徽章，2026-10-22 查询）
  • 开源许可：MIT（来源：仓库 README 许可徽章与 LICENSE 文件 Copyright (c) 2023-* RARgames，2026-10-22 实查）
  • 维护方：RARgames 团队（主要维护者 RARgames、wilkobyl，来源：仓库 README「Main Maintainers」栏目）
  • 信息溯源方式：官网页面、官方文档站、GitHub 仓库 README 与源码文件（Dockerfile、package.json、docker-compose.yml）、GitHub Releases Atom 订阅、shields.io 徽章数据、NVD 漏洞库

💡 说明：本文所有版本号、星数、许可信息均为 2026-10-22 当日实查值。开源项目迭代较快，读者阅读本文时建议按第八章参考链接复核最新版本。

二、软件概述

4ga Boards 的官方定位一句话是「Straightforward boards system for realtime project management」（来源：GitHub 仓库 README 项目描述，2026-10-22 查询），即一个面向实时协同项目管理的看板系统。它采用「项目（Project）→ 看板（Board）→ 列表（List）→ 卡片（Card）→ 任务（Task）」的五级层次结构组织工作内容，支持多用户实时协同——所有变更实时推送到其他成员的浏览器，无需刷新页面（来源：仓库 README「Web App Design」特性说明）。

从形态上看，4ga Boards 是一个典型的自托管 Web 业务系统：

  • 服务端：Node.js 单进程应用（源码 engines 字段要求 Node ^24.11，2026-10-22 实查仓库根 package.json），基于 Sails.js 框架与 Knex.js 数据库工具链，数据存于 PostgreSQL；
  • 客户端：React + Redux 单页应用，由服务端直接托管静态资源，部署后只需暴露一个 HTTP 端口（容器/应用默认监听 1337）；
  • 可选组件：Redis 用于上传限流的多实例共享存储（单机部署可用内存存储替代）。

关于它与知名看板项目 PLANKA 的关系：4ga Boards 与 PLANKA 同源——两者技术栈完全一致（Sails.js + Knex.js + React/Redux/Redux-Saga）、默认端口同为 1337、初始账号同为 demo/demo、容器内数据路径（/app/public/user-avatars、/app/private/attachments 等）完全相同（以上为本文对两仓库文件的对照实查，2026-10-22）；第三方自托管教程也将 4ga Boards 描述为「受已停运的 GitKraken Glo Boards 启发的看板系统」（来源：Marius Hosting《How to Install 4GABOARDS on Your Synology NAS》，2026-04-20，与 PLANKA 官方同源的定位描述）。重要的选型背景是：PLANKA 目前采用 fair-code 模式发行（PLANKA Community License + PLANKA Pro/Enterprise 商业许可，SSO、访客角色、模板等功能划入付费 Pro 版；来源：PLANKA 官方仓库 README License 章节，2026-10-22 查询），而 4ga Boards 全量功能以 MIT 许可开源发行，其商业模式仅为官方托管服务与 Pro/Enterprise 增值服务（自动更新、自动备份、VPN 接入等，不影响自托管功能，来源：4gaboards.com/features 页面标注，2026-10-22 查询）。

💡 技术拓展：「fair-code（公平代码）」不是 OSI 认证开源，指源码公开可见、可自托管，但许可对「商业托管转售/白标」等场景设限的发行模式，常见代表有 n8n、PLANKA Community License 等。看板工具选型时许可差异直接影响二次开发与内部商用边界：MIT 允许任意使用、修改、再分发（保留版权声明即可）；fair-code 许可需逐条核对许可文本。4ga Boards 为 MIT，PLANKA 社区版为 fair-code，是两者最关键的选型分界。

版本节奏方面（来源：GitHub Releases Atom 订阅，2026-10-22 查询）：v3.3.11 发布于 2026-07-02、v3.3.12 发布于 2026-07-03、v3.3.13 发布于 2026-07-15——两周内连续发布三个补丁版本，处于活跃维护状态，补丁以安全修复与细节改进为主（v3.3.13 的更新内容即包含一处后台组件不安全 URL 构造的安全修复）。

三、核心架构

以下架构信息均实查自 v3.3.13 源码仓库（2026-10-22），与官方 README「Tech Stack」章节互相印证：

层技术选型说明
前端React + Redux + Redux-Saga + Redux-ORM + floating-ui单页应用，构建产物由服务端托管（Dockerfile 中复制 client/build 至服务端 public 目录）
后端Node.js ^24.11 + Sails.js ^1.5.18REST API + WebSocket 实时推送（sails-hook-sockets）
数据访问Knex.js ^3.3 + sails-postgresql ^5.0.1迁移与查询构建，仅支持 PostgreSQL
数据库PostgreSQL唯一受支持的关系数据库；官方 compose 示例使用 postgres:18-alpine
可选中间件Redis 8（官方 compose 示例）用作上传限流计数器共享存储（UPLOAD_RATE_LIMIT_STORE=redis），单机可省略
图片处理sharp ^0.35头像/背景图/附件缩放（并发、缓存可配）
认证本地账密 + OAuth2/OIDC内置 Google/GitHub/Microsoft 与通用 OIDC 登录（passport 系列依赖）
可观测prom-client ^15.1.3 + winston ^3.19内置 Prometheus 指标客户端依赖与分级日志
运行形态单进程 HTTP 服务应用与官方镜像默认监听 1337，健康检查为 HTTP 探活（Dockerfile HEALTHCHECK，2026-10-22 实查）

几个对部署选型有直接影响的架构特征：

  1. 单进程、无内部分布式组件：除 PostgreSQL 必需、Redis 可选外，4ga Boards 自身就是一个进程，没有内部消息队列或搜索引擎依赖，资源占用与运维复杂度低；
  2. 实时通道与应用同端口：WebSocket/SockJS 与 HTTP API 复用 1337 端口，反代场景无需单独映射端口，但需要代理支持 WebSocket 升级；
  3. 前端构建产物随服务端发行：官方镜像与「手动安装」流程均把前端构建结果打入服务端发布物，部署时不存在「前后端分开发布」的问题；
  4. 持久化数据三类：数据库（全部业务数据）、附件目录（/app/private/attachments）、头像与项目背景图目录（/app/public/user-avatars、/app/public/project-background-images）——备份策略需同时覆盖这三类（来源：官方 docker-compose.yml 卷定义，2026-10-22 实查）。

四、功能特性

以下特性清单整理自官方 README「Features」章节与官网 Features 页面（来源与查询日期均为 2026-10-22；标注「规划中」的条目为官方页面明确标记 Coming Soon / Planned Enhancements 的功能）：

特性域具体能力状态
看板核心项目/看板/列表/卡片/任务五级层次、拖拽操作、标签、清单（子任务）、截止日期与成员指派、卡片图片封面、卡片分享链接、文件附件可用
实时协同全员实时同步、无需刷新；多任务并行（编辑卡片的同时滚动、筛选、查看其他卡片，本地描述修改保留）可用
编辑体验增强型 Markdown 编辑器（支持彩色文本等扩展格式）、快捷键操作、宽屏极简布局可用
视图看板视图与列表视图切换、列表与侧栏折叠、暗色模式可用
导入导出看板数据导出/导入（CSV 格式，官方称无限制）、Trello 看板导入（新建看板时选择 Import）可用
身份认证本地注册登录 + Google/GitHub/Microsoft OAuth 与通用 OIDC SSO；私有/邀请制看板可用（自托管免费）
多语言17 种界面语言（CS、DA、DE、EN、ES、FR、IT、JA、KO、PL、PT、RU、SK、SV、UZ、ZH 等）可用
通知与集成GitHub 双向同步规划中（Coming Soon）
协作增强评论提及（Mentions）、站内通知（Notifications）、公共看板（Public Boards）规划中
管控细粒度权限系统（Permissions System）、自定义项目背景、卡片计时器规划中
商业版（Pro/Enterprise）自动更新、自动备份、VPN 接入、多语言客服支持官方托管/付费

选型解读：4ga Boards 的「可用」功能已覆盖看板管理的核心闭环（项目—看板—卡片—任务、附件、标签、截止日期、SSO、导入导出），而通知、提及、权限系统等「增强项」仍标记为规划中——这意味着把它用于需要细粒度权限管控或强通知依赖的场景前，应先确认这些功能在所选版本中是否已落地（官方 Features 页为唯一权威口径）。相对同类产品，它最突出的差异点是：MIT 许可下免费内置 OAuth/OIDC 单点登录，以及多任务并行编辑这类交互细节。

五、快速开始（官方最小可用示例）

本节引用官方 README 给出的 Docker Compose 快速启动路径（来源：GitHub 仓库 README「Deploy → Docker Compose (Recommended)」章节，2026-10-22 查询；本专栏《4ga Boards 3.3.13 Docker Compose 部署指南》已按此流程逐条实测并给出真实回显）。完整步骤为：

  1. 下载官方编排文件：
curl -L https://raw.githubusercontent.com/RARgames/4gaBoards/main/docker-compose.yml -o docker-compose.yml
  1. 编辑 docker-compose.yml 中的 environment 段：BASE_URL 改为实际访问域名或 IP；SECRET_KEY 用 openssl rand -hex 64 生成随机值；POSTGRES_PASSWORD 与 DATABASE_URL 中的数据库口令替换为同一随机值；
  2. 拉取镜像并启动：
docker compose up -d
  1. 浏览器访问 http://localhost:3000，使用初始账号 demo、密码 demo 登录。

官方编排栈共三个服务：postgres:18-alpine（数据库）、redis:8-alpine（上传限流存储，可选）、ghcr.io/rargames/4gaboards:latest（应用，内部端口 1337 映射到宿主机 3000）。若暂不引入 Redis，官方还提供 docker-compose-no-redis.yml 变体（来源：仓库根目录文件清单，2026-10-22 实查）。

💡 说明：demo/demo 是首个初始化账号的官方默认值，生产环境应通过 DEFAULT_ADMIN_USERNAME、DEFAULT_ADMIN_PASSWORD 等环境变量在首次启动前覆盖（详见本专栏《4ga Boards 3.3.13 配置参数详解》）。不用容器编排的读者可走源码手动安装路线，见《Ubuntu 22.04 安装 4ga Boards 3.3.13 指南》。

六、适用场景与限制

6.1 适用场景

  • 中小团队的敏捷/看板研发管理：实时协同 + 五级层次足够支撑常见的迭代看板、需求池、缺陷跟踪用法；
  • Trello 迁移与替代：官方内置 Trello 看板导入，MIT 许可下数据完全自持；
  • 内网/隔离环境的轻量项目管理：单进程 + PostgreSQL（可选 Redis）的最小依赖组合，适合离线内网部署；
  • 需要免费 SSO 的自托管场景：OAuth2/OIDC 内置且不设付费墙，适合已统一身份源（Google Workspace、GitHub、Microsoft Entra ID、Keycloak 等）的团队；
  • 个人任务与笔记式管理：多语言、暗色模式与快捷键对个人用户同样友好。

6.2 限制与风险

以下限制均有官方或权威来源，供选型前评估（查询日期 2026-10-22）：

  1. 功能仍在快速演进：通知、评论提及、细粒度权限系统、公共看板、计时器、GitHub 双向同步等在官方 Features 页均标记为「规划中/即将推出」，需要这些能力的团队应先实测确认当前版本支持度；
  2. 数据库只支持 PostgreSQL：无 MySQL/SQLite 后端，存量数据库运维体系不同的团队需要额外引入 PostgreSQL 运维能力；
  3. Node.js 版本要求较新：源码 engines 要求 Node ^24.11（2026-10-22 实查仓库根 package.json），老系统上手动安装需先升级 Node 运行时；
  4. 安全历史需保持更新：NVD 收录 CVE-2026-41419——3.3.5 之前的版本存在看板导入功能的路径穿越漏洞（拥有导入权限的认证用户可利用，来源：NVD 漏洞详情页，2026-10-22 查询）；所选版本应不低于 3.3.5，并建议保持最新补丁（本文成稿时最新为 v3.3.13）；
  5. 生态体量相对小：GitHub Star 数（730，shields.io 2026-10-22 查询）与汉化/教程生态远小于 Wekan、PLANKA 等前辈项目，遇到疑难问题的社区求助面有限，官方 Discord 为主要支持渠道。

七、同类选型对比（含量化对比表）

对比对象选择与 4ga Boards 定位最接近的三款自托管看板系统：PLANKA（其同源上游）、Wekan（Meteor 老牌看板）、Kanboard（极简 PHP 看板）。表中所有数字均为 2026-10-22 查询：GitHub Star 数取自 shields.io 仓库徽章接口（img.shields.io/github/stars/<owner>/<repo>.json），许可取自各官方仓库 README/LICENSE 或 shields.io 许可徽章，PLANKA Docker 拉取量取自其官方 README 徽章（8M+）。

7.1 量化对比表

维度4ga Boards 3.3.13PLANKA（Community）WekanKanboard
GitHub Stars（2026-10-22）73013k21k9.9k
许可MITFair Use License（fair-code，源码可见）+ Pro/Enterprise 商业版MITMIT
技术栈Node.js 24（Sails.js + Knex.js）+ ReactNode.js（同源技术栈）Node.js（Meteor）PHP
数据库仅 PostgreSQLPostgreSQLMongoDBSQLite / MySQL / PostgreSQL
实时协同内置（WebSocket）内置内置无（传统页面刷新）
SSO（OAuth/OIDC）免费内置（Google/GitHub/Microsoft/通用 OIDC）划入 Pro 版（社区版无 SSO/访客角色）社区插件插件（LDAP 等需扩展）
Trello 导入内置内置支持插件
官方 Docker 拉取量官方未公布8M+（官方 README 徽章）官方未公布（第三方渠道较大）官方未公布
版本节奏（近期）两周内 3 个补丁（2026-07）社区版 2.1.x/2.2.x 在维护长期滚动发版稳定低频发版
部署形态Compose（官方推荐）/K8s Helm/TrueNAS/手动源码Compose 等Compose/手动LAMP/Compose
资源画像单进程 Node + PG（+可选 Redis）单进程 Node + PGNode + MongoDB传统 PHP，最低

7.2 关键差异解读

  • 许可与付费墙是第一分界：4ga Boards 与 Wekan、Kanboard 为纯 MIT；PLANKA 社区版为 fair-code，且把 SSO、访客角色、模板、导出等高频企业功能划入付费 Pro（来源：PLANKA 官方 README Community/Pro 功能对照表，2026-10-22 查询）。需要免费 SSO 或对许可合规敏感时，4ga Boards 是 PLANKA 用户最直接的替代路线；
  • 数据库依赖是第二分界：Wekan 绑定 MongoDB、4ga Boards/PLANKA 绑定 PostgreSQL、Kanboard 最灵活（默认 SQLite）。按团队现有数据库运维栈反向选择可显著降低长期成本；
  • 社区体量与成熟度反向排序：Wekan（21k）> PLANKA（13k）> Kanboard（9.9k）> 4ga Boards（730）。4ga Boards 的星数基数小，但其版本节奏（两周三更）与官方文档完整度处于上升期，属于「新而活跃」的项目；
  • 功能取向：Kanboard 走极简路线（无实时协同）；Wekan 功能全但交互偏传统；PLANKA/4ga Boards 主打实时协同与现代交互，其中 4ga Boards 额外提供多任务并行编辑与免费 SSO。

7.3 「如果……则……」选型建议

  • 如果你要 完全开源许可 + 免费内置 SSO + 实时协同，且接受 PostgreSQL 单数据库栈 → 4ga Boards；
  • 如果你要 最大社区体量、丰富教程生态，并能接受 fair-code 许可与 Pro 付费墙 → PLANKA Community；
  • 如果团队已有 MongoDB 运维体系 或需要 Wekan 特有的看板布局灵活性 → Wekan；
  • 如果追求 极低资源占用、传统 PHP 环境、无实时需求 → Kanboard；
  • 如果需求超出看板范畴（甘特、需求管理、测试管理）→ 评估 Taiga、OpenProject、Leantime 等完整项目管理平台（与本文对比对象不在同一赛道，不展开量化对比）。

八、参考链接

  1. 4ga Boards 官网：https://4gaboards.com
  2. 4ga Boards 功能页（Pro/Enterprise 与规划中功能标注）：https://4gaboards.com/features
  3. 4ga Boards 官方文档：https://docs.4gaboards.com
  4. GitHub 仓库（README/LICENSE/源码）：https://github.com/RARgames/4gaBoards
  5. GitHub Releases（版本发布记录）：https://github.com/RARgames/4gaBoards/releases
  6. 官方 Docker Compose 变量说明：https://docs.4gaboards.com/docs/dev/install/docker-vars/
  7. 官方手动安装说明：https://docs.4gaboards.com/docs/dev/install/manual-install/
  8. NVD 漏洞详情（CVE-2026-41419）：https://nvd.nist.gov/vuln/detail/CVE-2026-41419
  9. PLANKA 官方仓库（许可与 Community/Pro 对照）：https://github.com/plankanban/planka
  10. Wekan 官方仓库：https://github.com/wekan/wekan
  11. Kanboard 官方仓库：https://github.com/kanboard/kanboard
  12. 本专栏实操篇：《Ubuntu 22.04 安装 4ga Boards 3.3.13 指南》、《4ga Boards 3.3.13 Docker Compose 部署指南》、《4ga Boards 3.3.13 配置参数详解》、《4ga Boards 3.3.13 常用 CLI 命令与工具详解》