Apache Allura 1.22 介绍与选型指南

目标：讲清 Apache Allura 是什么、解决什么问题、由哪些组件构成、如何按官方分步文档跑通一个自托管 forge，以及在 2026 年 10 月当前版本（1.22.0）下的同类开源 forge 方案选型对比。本文为 A1 认知篇：全部内容基于官网、官方文档、发行目录与 GitHub 仓库联网查证编写，关键论断随文标注来源与查询日期（统一为 2026-10-18），不含本地安装实测。

一、信息基准

项目	内容
查询日期	2026-10-18
版本依据	官网首页「Download v1.22.0（Oct 2026）」与新闻页《Apache Allura 1.22.0 released, with security fixes》；ASF 官方发行目录 `https://downloads.apache.org/allura/` 在架 `allura-1.22.0.tar.gz`；GitHub 标签 `rel/1.22.0` 提交于 2026-10-09，CHANGES 记为「Version 1.22.0 (October 2026)」
许可证	Apache License 2.0（GitHub `apache/allura` license 字段：Apache-2.0）
运行环境	Python 3.11~3.14（官方分步安装文档明示，下文引用）；MongoDB；Solr 搜索；Node.js 构建前端

官方来源清单：

项目主页：https://allura.apache.org/
官方文档（Getting Started）：https://forge-allura.apache.org/docs/
分步安装文档：https://forge-allura.apache.org/docs/getting_started/install_each_step.html
GitHub 仓库：https://github.com/apache/allura
ASF 发行目录：https://downloads.apache.org/allura/
1.22.0 发布公告：https://allura.apache.org/posts/2026-allura-1.22.0.html

二、软件概述

Apache Allura 是一个开源的**软件 forge（项目托管平台）**实现：一个为任意数量的独立项目管理源码仓库、缺陷报告、讨论、Wiki 页面、博客等内容的网站系统（来源：官网「What is Allura?」，查询日期 2026-10-18）。Allura 项目自身即运行在一套 Allura 实例上（forge-allura.apache.org 提供官方 Git 仓库、Wiki 与工单）。

与「单仓库代码托管」不同，Allura 的目标形态是多项目门户：项目按「社区（Neighborhood）」组织，每个项目可自由启用工具（Wiki、工单、Git/SVN/Hg 仓库、讨论区、博客等），并支持以扩展（Extensions）方式增加工具（来源：官网与官方扩展 Wiki）。2026 年的 1.19~1.22 系列以安全加固为主线（官方公告连续标注 with security fixes），1.22.0 的 CHANGES 包含：User 工具数据字段的字段级加密、HTML 净化修复、OAuth1 回调必须为 https 精确匹配、git 线程安全修复、ForgeChat 废弃预告等（来源：GitHub rel/1.22.0 标签 CHANGES 文件，查询日期 2026-10-18）。

本次介绍的版本：Apache Allura 1.22.0（2026 年 10 月发布）。

三、核心架构

3.1 组件构成（核心概念与工作方式）

Allura 是 Python Web 平台 + 一组配套服务的组合，核心组件及其职责如下（来源：官方分步安装文档《Step-by-Step Installation》，查询日期 2026-10-18）：

组件	职责	官方文档印证
Web 应用	forge 主体（项目/社区/工具页面），经 WSGI 服务器对外服务	`gunicorn --reload --paste development.ini -b :8080`
MongoDB	全部项目/工单/Wiki/用户数据存储（Ming ODM 访问）	分步安装要求安装 MongoDB；配置含 `ming.*` 加密键
Solr	全站搜索与索引	官方提供定制配置 `solr_config/allura/`，示例安装 Solr 5.3.1
taskd	后台任务服务：发邮件、建索引等异步作业	「Allura uses a background task service called taskd」`paster taskd development.ini`
收信服务	入站邮件转工单/讨论评论	`paster smtp_server development.ini`（默认端口 8825）
SCM 托管	Git/SVN/Hg 代码仓库目录与访问	默认仓库目录 `/srv/{git,svn,hg}`，另有 SCM Host Setup 文档
工具（Tools）	每项目可插拔的功能单元：ForgeWiki、Tickets、ForgeGit、Discussion、Blog 等	`./rebuild-all.bash` 批量安装全部工具扩展

3.2 组织模型

Neighborhood（社区）：项目分组与门户皮肤/治理单元，例如官网的 Projects 社区；站点管理员由「Projects」社区中 allura 项目的管理员担任（可经 site_admins_project 配置调整）。
项目（Project）：可注册在任意社区下，注册入口 /p/add_project；项目内按需启用工具。
认证与用户体系：可插拔认证，内置支持 LDAP（auth.method = ldap、user_prefs_storage.method = ldap 等配置项），支持 OAuth1/OAuth2 应用接入（1.22.0 起两者均支持编辑配置，OAuth1 强制 https 回调精确匹配）。

四、功能特性

多项目管理：任意数量项目 + 社区门户组织，适合机构级私有 forge。
一体化工具集：Git/SVN/Hg 仓库、工单（含自定义字段与批量操作）、Wiki、讨论区、博客、代码浏览与统计，工具可按项目启停。
全文搜索：Solr 驱动的代码外内容全站检索。
邮件双向集成：每个工单有独立邮件地址，回信即评论；出站通知可对接外部 MTA（文档给出 postfix transport_maps 示例）。
企业身份集成：LDAP 认证与用户属性直连，自动注册存量用户。
安全持续加固：2026 年连续四个版本聚焦安全（官方新闻页标题均含 security fixes），1.22.0 新增 MongoDB 字段级加密（ming.*.encryption.kms_providers 配置）与会话密钥（beaker.session.jwt_secret_keys）分离管理。
生产级部署形态：文档给出 gunicorn（推荐）、uWSGI、mod_wsgi-express 三类应用服务器配置与 nginx 反代建议。

五、快速上手（引自官方分步安装文档，非本地实测）

以下步骤引自《Step-by-Step Installation》（来源：https://forge-allura.apache.org/docs/getting_started/install_each_step.html ，查询日期 2026-10-18；该文档以 Ubuntu 22.04 为例，Python 以 3.14 为例）：

系统包与代码（节选）：

~$ sudo apt-get install git-core python3.14 python3.14-dev gcc libmagic1 \
     libssl-dev libldap2-dev libsasl2-dev libjpeg8-dev zlib1g-dev libffi-dev
~$ python3.14 -m venv env-allura
~$ source env-allura/bin/activate
~/src$ git clone https://gitbox.apache.org/repos/asf/allura.git/
~/src/allura$ pip install -U pip
~/src/allura$ pip install -r requirements.txt
~/src/allura$ ./rebuild-all.bash        # 安装全部工具扩展

初始化配套服务：按文档安装 MongoDB；安装 Solr 5.3.1 并导入官方 solr_config/allura/ 配置后启动；创建仓库目录 /srv/{git,svn,hg}。
启动后台任务服务与应用：

~/src/allura/Allura$ nohup paster taskd development.ini > /var/log/allura/taskd.log 2>&1 &
~/src/allura/Allura$ paster setup-app development.ini          # 初始化数据库（开发数据）
~/src/allura/Allura$ gunicorn --reload --paste development.ini -b :8080

访问 http://localhost:8080，用示例账号登录（admin1 / test-user / root，密码 foo），在 /p/add_project 注册项目并启用工具（来源：官方《Post-setup instructions》）。

六、适用场景与限制

适用场景：机构/高校/企业内网的多项目私有 forge；需要工单+Wiki+代码仓库+讨论一体且允许自行维护的团队；需要 LDAP 统一认证与邮件驱动协作的传统研发协作体系。

限制：社区规模小（2026-10-18 实查 GitHub stars 151、无 Release API 制品），新特性与修复以源码为主线；技术栈偏老（MongoDB+Solr+Paste 体系），云原生与 K8s 化资料少；代码托管能力面向经典 forge 语义，没有内置 CI/CD，需要与外部系统集成。

七、同类选型对比

对比数据联网实查于 2026-10-18（GitHub API / Codeberg API / 官网）：

维度	Apache Allura 1.22.0	GitLab CE 19.5	Forgejo 17.0	Redmine 7.0
许可证	Apache-2.0	开源核心 CE 为 MIT（仓库 license 字段 NOASSERTION，功能分化见企业版）	MIT	GPLv2
社区活跃度（GitHub stars / 最近推送）	151 ★ / 2026-10-15	24 551 ★（gitlabhq 同步副本仓库）/ 2026-10-17	Codeberg 主仓（GitHub 为同步副本）	6 049 ★ / 2026-10-16
最近发版	1.22.0（2026-10，官方公告）	v19.5.0（GitHub tags 在列，月度发布列车）	v17.0.0（2026-10-15，Codeberg Release）	7.0.2（GitHub tags 在列）
版本节奏	一年内多版、当前逐月安全版	每月功能版	季度级大版本	年内 2~3 版
定位差异	多项目 forge：社区门户+可插拔工具	一体化 DevOps 平台（含内置 CI/CD）	轻量自托管代码协作（含 Actions）	项目管理为主、代码浏览为辅
兼容矩阵	Python 3.11-3.14；MongoDB；Solr	自打包 omnibus/K8s；PostgreSQL	单二进制；SQLite/PostgreSQL/MySQL	Ruby on Rails；MySQL/PostgreSQL

选型建议：要「多项目门户 + 工单/Wiki/讨论 + 轻代码托管」且接受自维护，选 Allura；要开箱即用的完整 DevOps（CI/CD、评审、制品管理）选 GitLab CE；追求轻量、单二进制、低运维选 Forgejo；只需要项目/工单管理而不重代码托管流程选 Redmine。

八、参考链接

项目主页：https://allura.apache.org/
官方文档：https://forge-allura.apache.org/docs/
分步安装：https://forge-allura.apache.org/docs/getting_started/install_each_step.html
1.22.0 发布公告：https://allura.apache.org/posts/2026-allura-1.22.0.html
GitHub 仓库：https://github.com/apache/allura
ASF 发行目录：https://downloads.apache.org/allura/
Forgejo 官网：https://forgejo.org/
Redmine 官网：https://www.redmine.org/