Leantime 介绍与选型指南

目标：建立对 Leantime 的完整认知——它是什么、解决什么问题、架构如何组织、能力边界在哪里，并与 OpenProject、Redmine、Plane、Taiga 四款同类开源自托管项目管理产品做量化对比，给出可落地的选型建议。本文为认知篇，全部版本、星标、许可、发布节奏数据均于 2026-10-28 联网核实官方源（GitHub Releases、shields.io 徽章、各项目官网），不含本地部署实测。

一、环境信息

认知篇的「环境」指数据来源与核实基线。文中所有数字均可通过文末参考链接复核。

• 数据核实日期：2026-10-28
• Leantime 最新稳定版：v3.12.0（GitHub Releases Leantime/leantime 的 latest 标记，发布于 2026-10-15，shields.io github/v/release 徽章同日返回 v3.12.0）
• 对比对象及当日最新版本：OpenProject v17.9.4、Redmine 7.0.2（2026-09-30 发布，6.0.x 分支同日仍有 6.0.11 维护版）、Plane v1.4.2、Taiga 6.10.2（2026-07 发布）
• 星标取证渠道：shields.io github/stars 徽章（2026-10-28），数值为约数（徽章按 k 取整）
• 目标读者：正在为团队选型自托管项目管理系统的技术负责人、运维与实施工程师
• 本系列已交付的部署实测篇：《Ubuntu 22.04 安装 Leantime 3.12.0 指南》（源码包 + Nginx + MariaDB 全流程实测）

二、软件概述

Leantime 是一套开源的项目与目标管理系统，官方定位是「为不会用项目管理工具的人设计的项目管理系统」（project management for non-project managers），宣传语为「简单如 Trello、功能丰富如 Jira」。与多数同类产品的差异点在于：它在设计上有意降低信息密度，并针对 ADHD（注意力缺陷）、阅读障碍与自闭症人群做了可用性优化，把「今天该做什么」放在第一屏。

核心事实清单（2026-10-28 核实）：

• 开源许可：AGPL-3.0-only（GitHub 仓库 LICENSE 声明），允许自托管与二次开发；通过网络对外提供服务时需开放修改后的源码
• 维护方：Leantime 官方团队（作者 Marcel Folaron），官网 leantime.io，官方同时售卖托管云与插件市场的付费插件，自托管开源核心不受限
• 技术栈：PHP 8.2+ / Laravel 11 / MySQL 8.0+ 或 MariaDB 10.6+，服务端渲染为主
• 社区规模：GitHub 星标约 12k、fork 约 1.1k，支持 20 多种界面语言（含简体中文）
• 发布节奏：3.10.0（2026-09-24）→ 3.10.1~3.10.4（一周内密集补丁）→ 3.11.0（2026-10-09）→ 3.12.0（2026-10-15），呈「月度功能版 + 周级补丁版」节奏
• 部署形态：官方发布包（LEMP/LAMP 源码部署）与官方镜像两种，均以 public/ 为 Web 文档根

一句话概括：Leantime 把战略目标（Goals/指标）、项目规划（里程碑/冲刺/甘特）、任务执行（看板/工时/文档）装进一个单机可跑的 PHP 应用里，面向 5~50 人的中小团队。

三、核心架构

Leantime 采用经典的四层单体 Web 架构，没有微服务、没有消息中间件，这是它部署轻量的根本原因：

浏览器
  │  HTTP/HTTPS
  ▼
Nginx / Apache ──► public/index.php（唯一 Web 入口）
                        │
                        ▼
                  Laravel 11 内核
                   ├── 路由 / 中间件（认证、CSRF、会话、限流）
                   ├── 领域模块（项目/任务/目标/工时/Wiki/画布…）
                   ├── 插件机制（app/Plugins 目录挂载）
                   └── JSON-RPC API（/api/jsonrpc，API Key 或 Bearer 鉴权）
  │                        │
  ▼                        ▼
PHP-FPM 8.2+          MySQL 8.0 / MariaDB 10.6+
                        │
                  本地 userfiles/ 或 S3 兼容对象存储（附件）

架构层面的四个关键事实：

1. 单库持久化：全部业务数据在一个 MySQL/MariaDB 库中，表以 zp_ 前缀组织（zp_projects、zp_tickets、zp_user、zp_timesheets 等约 40 张表）。备份只需要「一次数据库导出 + 附件目录 + 配置文件」。
2. 无状态应用进程：PHP-FPM 进程本身无状态，水平扩展依赖「多 PHP 节点 + 共享数据库 + 共享附件存储（S3）+ 共享会话（Redis，3.x 起支持 LEAN_USE_REDIS）」。
3. 双层权限模型：全局角色（readonly/commenter/editor/manager/admin/owner 六级，对应数值 5/10/20/30/40/50）叠加项目级成员关系，API 调用同样受该模型约束（editor 角色的 API Key 调用用户管理接口会被拒绝）。
4. 扩展走插件 + API：插件以目录形式放入 app/Plugins；对外自动化走 JSON-RPC 2.0 接口，方法命名约定 leantime.rpc.{域}.{方法}，约 29 个业务域对外暴露方法。

四、功能特性

Leantime 的功能可按「执行、规划、战略、知识、管理」五层理解。下表按官方 README 与文档站的功能清单整理（2026-10-28 核实）：

三个需要提前知道的能力边界：

• 不做代码托管：没有 Git 仓库与代码评审，需搭配 GitLab/Gitea，通过 API 或链接关联提交与任务。
• 无原生高可用：官方不提供集群编排，HA 需自行组合「共享库 + 共享附件 + 共享会话」。
• 跨项目报表较弱：报表以单项目仪表盘为主，跨项目组合分析、自定义 BI 需要借助 API 拉数自建。

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

本节按官方 README 与文档站描述给出最小可用路径，用于判断「是否值得进一步部署」。认知篇不做本地实测，以下流程的官方依据为 v3.12.0 发布页与 docs.leantime.io 安装文档（2026-10-28 查阅）；逐条命令与真实回显见本系列安装篇。

官方前置要求：

• PHP 8.2+，并启用 bcmath、curl、gd、mbstring、mysqli、pdo_mysql、zip、opcache 等扩展
• MySQL 8.0+ 或 MariaDB 10.6+，提前创建空库与专用账号
• Nginx 或 Apache，文档根必须指向发布包的 public/ 子目录

最小五步：

1. 从 GitHub Releases 下载 Leantime-v3.12.0.zip（约 60MB，vendor 依赖已内置，无需执行 composer install），解压到如 /opt/leantime。
2. 创建空库与账号：CREATE DATABASE leantime; CREATE USER 'leantime'@'%' IDENTIFIED BY '你的密码'; GRANT ALL ON leantime.* TO 'leantime'@'%';
3. 复制 config/sample.env 为 config/.env，至少填 LEAN_DB_HOST、LEAN_DB_DATABASE、LEAN_DB_USER、LEAN_DB_PASSWORD、LEAN_SESSION_PASSWORD 五项。
4. Web 服务器文档根指向 /opt/leantime/public，配置 PHP-FPM 转发与伪静态（try_files $uri /index.php?$query_string）。
5. 浏览器访问 /install，向导自动建表并创建首个管理员账号，完成后进入「My Work」首页。

预期结果（依据官方安装向导描述，非本机实测）：建表完成后 /api/jsonrpc 在未携带凭据时返回 {"error":"Unauthorized"}，说明路由与鉴权中间件已生效；登录后默认生成一个示例项目与一组引导任务。

⚠️ 注意：文档根若误指到发布包根目录，config/.env（含数据库密码）与 storage/ 会直接暴露在 Web 下，属于严重安全事故。生产部署务必确认文档根为 public/。

六、适用场景与限制

Leantime 的甜区是「10~50 人、以项目交付为主、希望一个工具覆盖目标—计划—执行—工时」的团队。

七、同类选型对比

选型的关键是把「团队规模、流程偏好、运维人力、许可合规」四个约束摆到桌面上。下表五个维度均为 2026-10-28 实查数据。

7.1 量化对比表

7.2 对比解读与选型建议

四款产品代表了四条路线：

• OpenProject 是「重而全」的代表：甘特、预算、成本、BIM 等企业级能力最强，但 Rails + PostgreSQL 的部署与升级成本最高，且部分高级能力在企业版。适合 50 人以上、有专职运维、需要完整项目组合管理的组织。
• Redmine 是「老而稳」的代表：GPL-2.0 许可最宽松、插件生态最厚、缺陷跟踪久经考验；代价是界面与交互停留在上一个时代，目标管理、现代看板体验缺失。适合以缺陷/工单跟踪为核心、追求极致稳定的团队。
• Plane 是「新而快」的代表：62k 星标说明社区热度最高，前后端分离、API 优先，界面最现代；代价是多服务部署（web/api/worker/PG/Redis），且 1.x 版本的功能纵深（甘特、工时表、目标）尚不如老牌产品。适合 20 人以上、有平台工程能力、追求体验的研发团队。
• Taiga 曾是最优雅的开源 Scrum 工具，但 6.x 已进入维护模式（社区公告功能冻结，下一代产品独立为 Tenzu）。2026 年做新选型不建议把长期押注放在 Taiga 6 上，存量实例可继续使用。
• Leantime 的差异化在「目标—执行闭环 + 非 PM 友好 + 单机最轻」：它是五款中唯一把战略目标/指标做成一等公民的开源产品，也是唯一以「不会用项目管理工具的人」为目标用户设计的；代价是插件生态与大规模组织能力有限。

一句话选型：小团队要「目标 + 任务 + 工时」一个工具搞定、且没有专职运维 → Leantime；要企业级甘特/预算 → OpenProject；要稳定缺陷跟踪与插件生态 → Redmine；要现代体验与 API 优先 → Plane；纯 Scrum 仪式 → 存量 Taiga 继续用，新选型跳过。

💡 技术拓展：自托管项目管理产品的「许可差异」直接影响商用合规——

许可证	产品	关键约束
AGPL-3.0	Leantime、Plane	修改后通过网络提供服务也必须开源修改部分；内部自用无影响
GPL-3.0/2.0	OpenProject、Redmine	分发时需开放源码；纯内部 SaaS 化提供服务的约束弱于 AGPL
MPL-2.0	Taiga（后端）	文件级弱 copyleft，修改的文件需开源，聚合使用自由

自托管内部使用场景下三者差异不大；对外提供托管服务或二次分发时，AGPL 的传染性最强，需法务评估。

八、参考链接

• 官网：https://leantime.io
• 官方文档：https://docs.leantime.io
• GitHub 仓库：https://github.com/Leantime/leantime
• v3.12.0 发布页：https://github.com/Leantime/leantime/releases/tag/v3.12.0
• 星标取证（shields.io 徽章）：https://img.shields.io/github/stars/Leantime/leantime 、https://img.shields.io/github/stars/opf/openproject 、https://img.shields.io/github/stars/redmine/redmine 、https://img.shields.io/github/stars/makeplane/plane 、https://img.shields.io/github/stars/taigaio/taiga-back
• OpenProject：https://www.openproject.org
• Redmine 下载页（版本依据）：https://www.redmine.org/projects/redmine/wiki/Download
• Redmine 7.0 变更日志：https://www.redmine.org/projects/redmine/wiki/Changelog_7_0
• Plane：https://github.com/makeplane/plane
• Taiga 文档站（版本 6 依据）：https://docs.taiga.io
• Taiga 维护模式社区公告：https://community.taiga.io/t/taiga-6-10-1-you-can-now-archive-projects-and-issue-voting-is-back/8790
• 许可证全文：https://www.gnu.org/licenses/agpl-3.0.en.html
• 本系列安装篇：《Ubuntu 22.04 安装 Leantime 3.12.0 指南》
• 本系列全景导航：《Leantime 3.12.0 完整部署与实战指南》