Wekan 12.64 介绍与选型指南

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

一、环境信息

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

• 调研（查询）日期：2026-10-25
• 软件名称：Wekan（2016 年前原名 LibreBoard）
• 官方网址：https://wekan.github.io
• 官方文档：https://github.com/wekan/wekan/wiki（Wiki 形式，含安装、API、LDAP/OIDC 等专题）
• 源码仓库：https://github.com/wekan/wekan
• 查询当日最新稳定版：v12.64（发布于 2026-10-24，来源：GitHub Releases 页，2026-10-25 查询）
• 开源许可：MIT（来源：仓库 LICENSE 文件与 README 许可徽章，2026-10-25 实查）
• 维护方：Lauri Ojansivu（xet7）与社区贡献者（来源：仓库 README 与提交记录，2026-10-25 查询）
• 信息溯源方式：GitHub 仓库 README、Releases 发布页、Wiki 文档、官方 docker-compose.yml 注释、官方 Helm Chart 仓库（github.com/wekan/charts）、shields.io 徽章数据

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

二、软件概述

Wekan 的官方定位是「The open-source kanban」（来源：GitHub 仓库 README 标题，2026-10-25 查询），即一个开源的、可完全自托管的看板式项目管理与协作平台，是最知名的 Trello 开源自托管替代品之一。它以「看板（Board）→ 泳道（Swimlane）→ 列表（List）→ 卡片（Card）」的层次结构组织工作内容，支持多用户实时协同——所有成员的浏览器通过长连接实时收到变更推送，无需刷新页面。

项目历史简述：Wekan 起源于 2015 年的 LibreBoard，2016 年更名为 Wekan 并持续维护至今，GitHub Star 数已达 21k（shields.io，2026-10-25 查询），长期处于自托管看板类项目的第一梯队。

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

• 服务端：Node.js 单进程应用，基于 Meteor 3 全栈框架（v12.64 的发行清单标注 METEOR@3.6-rc.0、要求 Node.js 26.10.0；来源：Release 资产包内 star.json，2026-10-25 实查）；
• 数据库：MongoDB（需要副本集形态以支撑实时变更推送），也支持以 FerretDB（MongoDB 协议兼容层，后端可为 SQLite/PostgreSQL/MySQL 等）替代——官方默认编排文件即是 FerretDB + SQLite 的零外部数据库形态（来源：官方 docker-compose.yml 头部注释，2026-10-25 实查）；
• 客户端：浏览器单页应用，由服务端直接托管，部署后只需暴露一个 HTTP 端口（默认 8080）；
• API：内置完整 REST API（默认关闭，需 WITH_API=true 显式开启），同时提供 Webhook 外发能力，便于与外部系统集成。

版本节奏方面（来源：GitHub Releases，2026-10-25 查询）：Wekan 采取高频滚动发版策略，12.x 系列持续以修复缺陷、更新依赖、完善 OIDC/LDAP 等登录集成为主，属于「长期维护、持续小步迭代」的成熟项目。

三、核心架构

以下架构信息均实查自 v12.64 发行物与官方编排/Chart 文件（2026-10-25），与官方 Wiki 互相印证：

💡 技术拓展：Wekan 数据库后端的「MongoDB vs FerretDB」是部署前第一个选型点。MongoDB 线协议兼容层 FerretDB 让 Wekan 可以跑在 SQLite/PostgreSQL/MySQL 之上，对比——

后端	特点	适用场景
MongoDB 7 副本集	原生支持，change streams 实时性最好，功能验证最充分	生产环境、多人协同、已有 MongoDB 运维能力
FerretDB + SQLite	零外部数据库、单容器自包含，Wekan 侧只能走 polling 轮询	个人/小团队、快速试用、边缘节点
FerretDB + PostgreSQL/MySQL	复用现有关系库运维体系	组织内无 MongoDB 运维能力但有 PG/MySQL

本专栏部署篇两条路线均覆盖：裸机安装篇采用 MongoDB 7 副本集（《Ubuntu 22.04 安装 Wekan 12.64 指南》），Compose 篇采用 MongoDB 7 编排并附官方 FerretDB 变体说明（《Wekan 12.64 Docker Compose 部署指南》）。

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

1. 副本集是硬前提：即使单节点 MongoDB 也必须 rs.initiate() 初始化为单成员副本集，否则 Wekan 的实时感知无法工作（实测排障记录见《Wekan 12.64 Docker Compose 部署指南》）；
2. REST API 默认关闭：直接运行发行 bundle 时 WITH_API 缺省为关闭，调 /api/* 会返回「WeKan API is disabled」提示，需显式置 true（实测记录见《Ubuntu 22.04 安装 Wekan 12.64 指南》）；
3. ROOT_URL 影响一切外链：邀请邮件、Webhook 回调里的链接都基于它生成，反代/域名场景必须在启动前定好；
4. 持久化数据两类：数据库（全部业务数据）+ WRITABLE_PATH 目录（附件、头像）——备份策略需同时覆盖两者。

四、功能特性

以下特性清单整理自官方 README「Features」与 Wiki 功能页（来源与查询日期均为 2026-10-25）：

选型解读：Wekan 的「可用功能」覆盖面在自托管看板中最全——尤其是企业身份源集成（LDAP/OIDC/SAML/CAS 全栈）与规则自动化两项，是同赛道多数项目不具备或需付费的。代价是技术栈偏重（Meteor + MongoDB），资源占用与运维复杂度高于 PHP/Go 类轻量对手。

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

本节引用官方仓库给出的 Docker Compose 快速启动路径（来源：官方 docker-compose.yml 头部注释，2026-10-25 查询；本专栏《Wekan 12.64 Docker Compose 部署指南》已按 MongoDB 7 路线逐条实测并给出真实回显）。完整步骤为：

1. 下载官方编排文件（默认 FerretDB + SQLite，零外部数据库）：

curl -fsSLO https://raw.githubusercontent.com/wekan/wekan/main/docker-compose.yml

2. 按需编辑 docker-compose.yml：把 ROOT_URL 改为实际访问地址（如 http://192.168.1.100），默认把 80 端口映射到应用 8080；
3. 启动栈：

docker compose up -d

4. 浏览器访问 http://localhost，注册的第一个账号即成为管理员。

💡 说明：官方默认编排首次启动会自动下载 FerretDB 二进制（依赖外网）；内网或需要 MongoDB 副本集实时性的场景，请直接参考本专栏实测篇《Wekan 12.64 Docker Compose 部署指南》；不使用容器编排的读者可走发行 bundle 手动安装路线，见《Ubuntu 22.04 安装 Wekan 12.64 指南》。

六、适用场景与限制

6.1 适用场景

• Trello 自托管替代：功能模型与 Trello 高度同构（看板/列表/卡片 + 附件/标签/截止日期/清单），且内置 Trello 导入，迁移成本最低；
• 内网/隔离环境的项目管理：完全自托管、无外部依赖（可选 FerretDB + SQLite 单栈），支持离线部署；
• 有统一身份源的企业团队：LDAP/AD、OIDC（Keycloak/Authelia/Azure）、SAML 2.0、CAS 全覆盖，可接入既有 SSO 体系；
• 需要自动化集成的团队：完整 REST API + Outgoing Webhook + 规则引擎，可对接 CI/CD、IM 告警、工单系统；
• 数据自持与合规场景：MIT 许可、数据全部落在自己的 MongoDB/SQLite 与文件目录，无厂商锁定。

6.2 限制与风险

以下限制供选型前评估（查询日期 2026-10-25）：

1. 资源与技术栈偏重：Meteor + MongoDB 组合内存占用高于 PHP/Go 类轻量看板，小内存（<1GB）机器体验不佳；
2. MongoDB 副本集运维门槛：即使单节点也必须初始化为副本集（change streams 依赖），对无 MongoDB 经验的团队是第一道坎；用 FerretDB + SQLite 可绕过，但实时性降级为轮询；
3. 交互风格偏传统：Blaze 模板 UI 与新生代看板（如基于 React/Vue 的项目）相比交互细节较旧，移动端体验一般；
4. 无官方 CLI 工具：运维自动化只能走 REST API（功能覆盖完整，见《Wekan 12.64 API 使用详解》）或直接操作数据库；
5. 高频滚动发版：版本迭代快、偶有回归缺陷，生产环境建议锁定版本号升级、升级前备份数据库（备份与升级操作见《Ubuntu 22.04 安装 Wekan 12.64 指南》）。

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

对比对象选择四款定位相邻的工具：Kanboard（极简 PHP 看板）、Tasks.md（Markdown 文件驱动的轻量看板）、Vikunja（Go 编写的全能任务管理平台）、Trello（商业 SaaS 标杆，Wekan 的对标对象）。表中所有数字均为 2026-10-25 查询：GitHub Star 数与许可取自 shields.io 徽章接口，版本号取自各项目 GitHub Releases。

7.1 量化对比表

7.2 关键差异解读

• 许可是第一分界：Wekan、Kanboard、Tasks.md 为 MIT，商用与二次开发最自由；Vikunja 为 AGPL-3.0，对外提供修改版服务需开源衍生代码；Trello 完全闭源且不可自托管；
• 数据存储决定运维栈：Wekan 绑 MongoDB（或经 FerretDB 转 PG/MySQL/SQLite）；Kanboard/Vikunja 走传统关系库；Tasks.md 直接读写 Markdown 文件，可与 Obsidian 等笔记工具共用目录；
• 功能广度排序大致为 Wekan ≈ Trello > Vikunja > Kanboard > Tasks.md：Wekan 在自托管阵营里功能最全（SSO、规则、Webhook、Email-to-Card），Vikunja 超出看板范畴（甘特图、表格视图、CalDAV），Kanboard 走极简路线，Tasks.md 只保留看板最小集；
• 社区体量与生态：Wekan（21k）一家独大，教程、集成示例、Issue 解答的可获得性最好；Tasks.md（2.2k）属于「小而稳」的个人工具取向（其 README 明确声明「有意收窄功能范围以保证长期可维护」，2026-10-25 查询）。

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

• 如果你要 功能最全的自托管 Trello 替代 + 免费 SSO + REST API 自动化，且能接受 MongoDB 运维 → Wekan；
• 如果你要 极低资源占用、传统 PHP 环境、极简界面 → Kanboard；
• 如果你要 看板数据即 Markdown 文件、与笔记工具链打通、单人或小团队 → Tasks.md；
• 如果你要 超出看板的全能任务管理（甘特/表格/CalDAV/父子任务） 且接受 AGPL → Vikunja；
• 如果你要 零运维、生态插件市场、移动体验，且接受数据托管在厂商云端 → Trello（SaaS）。

八、参考链接

1. Wekan 官网：https://wekan.github.io
2. GitHub 仓库（README/LICENSE/源码）：https://github.com/wekan/wekan
3. GitHub Releases（版本发布记录）：https://github.com/wekan/wekan/releases
4. 官方 Wiki 文档：https://github.com/wekan/wekan/wiki
5. 官方 REST API 文档：https://github.com/wekan/wekan/blob/main/docs/API/REST-API.md
6. 官方 Helm Chart：https://github.com/wekan/charts
7. 容器镜像（Quay）：https://quay.io/repository/wekan/wekan
8. Kanboard 官方仓库：https://github.com/kanboard/kanboard
9. Tasks.md 官方仓库：https://github.com/BaldissaraMatheus/Tasks.md
10. Vikunja 官方站点：https://vikunja.io
11. Trello 官方站点：https://trello.com
12. 本专栏实操篇：《Ubuntu 22.04 安装 Wekan 12.64 指南》、《Wekan 12.64 Docker Compose 部署指南》、《Wekan 12.64 配置参数详解》、《Wekan 12.64 API 使用详解》