Gitea 28.1 介绍与选型指南

Gitea 28.1 轻量级自托管代码托管平台介绍：单二进制架构与内置 Actions 执行模型、协作与制品包特性、官方二进制快速上手、版本号口径说明，以及与 Forgejo、GitLab CE、Gogs 的选型对比与建议。

GiteaGiteaGit 服务2026/10/18

Gitea 28.1 介绍与选型指南

一、信息基准

  • 查询日期：2026-10-18。
  • 本次介绍版本：Gitea v28.1.0，官方最新稳定版（官方下载服务器 dl.gitea.com 的 version.json 官方口径 {"latest":{"version":"28.1.0"}}，与官方仓库 releases.atom 一致，发布于 2026-10 上旬）；上一稳定版 v28.0.0 与维护线 v1.27.x（当前 v1.27.3）并行存在。
  • 版本号口径说明：官方在 1.27 系列之后将版本号方案转入两位主版本号（1.27 → 28），官方下载目录中 28.1.0、28.0.0 与 1.27.3 并列可查；本文标题按官方 latest 口径取 28.1。
  • 开源许可：MIT（官方仓库 LICENSE）。
  • GitHub 实查：58,548 stars（2026-10-18，GitHub 官方页面）。
  • 本地为纯官方资料溯源编写，未做本地安装实测。

官方来源清单：

来源地址用途
项目官网https://about.gitea.com/项目介绍与产品动态
官方文档站https://docs.gitea.com/安装、管理与用户文档
官方下载服务器https://dl.gitea.com/gitea/各版本二进制与 version.json
官方代码仓库https://github.com/go-gitea/gitea源码、版本发布与 issue 追踪
官方博客https://blog.gitea.com/版本发布公告
官方配置参考https://docs.gitea.com/administration/config-cheat-sheet全量配置项说明

二、软件概述

本次介绍的版本为 Gitea v28.1.0（2026-10 发布的官方 latest 稳定版）。

Gitea 是一款自托管的开源代码托管平台，2016 年从 Gogs 项目分叉而来（分叉动因是社区对原项目维护节奏与治理模式的分歧），以"从最小的树莓派到企业集群都能运行"为目标，使用 Go 语言编写并编译为单一二进制文件。经过十年演进，Gitea 已从轻量 Git 服务成长为覆盖代码托管、协作评审、持续集成、制品包管理的完整 DevOps 平台，同时保持了同类产品中最高的部署轻便度：单二进制 + SQLite 即可完整运行。

项目治理上，Gitea 由 Gitea 社区与 Gitea Limited（商业实体）共同维护，商业公司提供托管服务与支持，开源版以 MIT 许可发布——这一治理路径也正是 2022 年底 Forgejo 从其分叉的直接背景。功能层面，Gitea 自 1.19 起内置了语法兼容 GitHub Actions 的持续集成系统（Gitea Actions），并在后续版本持续扩展制品包、指数（explore）与联邦化能力。

三、核心架构

3.1 单二进制与模块组成

Gitea 将 HTTP 服务（Web UI + REST API）、Git 智能协议服务（HTTP/SSH）、后台任务队列与定时任务全部编译进单一二进制，由 app.ini 单文件配置驱动。内置模块包括：仓库模型层（基于 go-git 与原生 git 混合实现）、webhook 分发器、邮件通知器、进程管理器与日志系统，官方架构文档对其模块边界有完整描述。

3.2 数据与对象存储

  • 元数据：用户、仓库、议题、评审等存于 SQLite/PostgreSQL/MySQL/MariaDB（官方支持的四种数据库）；
  • Git 对象：裸仓库文件落盘，大文件经 Git LFS 单独管理；
  • 附件与制品：本地文件系统之外，官方支持 MinIO 等 S3 兼容对象存储作为存储后端（配置参考 storage 章节）；
  • 会话与缓存：内存、Redis 等多种实现可选。

3.3 Gitea Actions 执行模型

内置 CI 采用与 GitHub Actions 兼容的工作流语法：工作流文件位于 .gitea/workflows/（亦读取 .github/workflows/），任务由独立的 act_runner 执行器拉取（官方基于 act 项目开发的开源组件），runner 与主服务通过内部 API 注册与通信，可跨主机部署多执行器并按标签路由；市场动作（actions）可经官方动作代理或自建代理拉取。

3.4 制品包与仓库托管能力

内置 packages 服务支持 OCI 格式制品、Maven、npm、PyPI、Go、NuGet、Conan、Debian、RPM、Alpine、Swift、Cargo 等格式的团队级制品库；仓库层提供分支保护、标签、子模块、LFS、交互式变基（rebase）等待办协作所需的全套 Git 能力。

3.5 认证与扩展机制

支持本地口令、LDAP、OAuth2（作为提供者与消费者）、OpenID Connect、SAML（官方文档标注）、双因素（TOTP/WebAuthn）与 GPG 签名校验；对外提供完整 REST API 与 webhook（含通用 JSON、Slack、Telegram 等格式），官方 CLI（gitea 命令）与 tea 命令行客户端基于同一 API 构建。

四、功能特性

4.1 代码托管与协作

组织与团队权限（细粒度到仓库单元）、议题（含看板项目）、合并请求（评审、必需批准、状态检查）、Wiki（内置与外部两种模式）、发布与附件、上游仓库定时同步的只读同步副本、行动跟踪等——官方用户文档按功能模块逐项覆盖。

4.2 Gitea Actions 内置持续集成

语法兼容 GitHub Actions（官方文档明确兼容性范围），支持矩阵策略、缓存与制品上传；执行器 act_runner 独立开源发版，官方文档提供注册、标签与部署形态（系统服务/一次性运行）指引，使 Gitea 成为"开箱即带 CI"的自托管平台。

4.3 制品包管理

十余种语言与格式的包仓库由同一实例承载，与仓库、用户权限体系统一管理，配合 webhook 可实现"打标签即发布"的自动化制品流（官方 packages 文档）。

4.4 运维与治理

官方提供从 SQLite 到 PostgreSQL/MySQL 的数据迁移工具、内置备份/恢复命令（gitea dump / gitea restore）、版本升级指引与完整的配置参考（config-cheat-sheet）；实例级支持自定义主题、页面与术语（官方 customizing 文档）。

4.5 v28.1 版本要点

v28.1.0 为官方 latest 口径的当前稳定版（2026-10 上旬发布），28.0 大版本延续官方博客公告的功能主线（协作体验、Actions 与包服务增强、性能与安全修复），v1.27.x 维护线继续接收补丁（v1.27.3）；具体变更清单以官方发布说明（blog.gitea.com 与 releases 页）为准。

五、快速上手

以下最小步骤引自官方文档二进制安装章节（https://docs.gitea.com/installation/install-from-binary），未做本地实测。

# 1. 下载二进制（以官方 latest 28.1.0 为例，架构按实际选择）
wget -O gitea "https://dl.gitea.com/gitea/28.1.0/gitea-28.1.0-linux-amd64"
chmod +x gitea
mv gitea /usr/local/bin/gitea

# 2. 准备运行用户与目录（官方文档"Installation from binary"章节要求）
adduser --system --shell /bin/bash --gecos 'Git Version Control' \
  --group --disabled-password --home /home/git git
mkdir -p /var/lib/gitea/{custom,data,log} && chown -R git:git /var/lib/gitea

# 3. 前台启动（首次启动进入 Web 安装向导，选择数据库并创建管理员）
su - git -c "gitea web --config /etc/gitea/app.ini"

官方安装文档还覆盖发行包（deb/rpm）、源码编译与官方配置清单（https://docs.gitea.com/administration/config-cheat-sheet）；CI 执行器的安装与注册见官方 act_runner 文档（https://docs.gitea.com/usage/act-runner）。首个仓库创建、议题与 Actions 启用的操作路径见官方用户文档（https://docs.gitea.com/usage/）。

六、适用场景与限制

6.1 典型场景

  • 中小团队与企业的自托管代码托管：资源占用低、部署轻，一台小型服务器即可承载百人级团队；
  • 需要"代码托管 + CI + 制品库"三合一的私有化平台：内置 Actions 与 packages 减少外围组件；
  • 开发与教学环境：SQLite 模式零依赖启动，适合实验与课程；
  • 从 GitHub 迁移工作流资产：Actions 语法兼容降低迁移改造成本。

6.2 限制与注意事项

  • 版本号方案变更（1.27 → 28）：升级前需按官方公告核对升级路径与配置迁移说明；
  • 高级企业能力（深度代码扫描、合规审计流水线、内置安全测试套件）不在核心功能范围，需要外围工具补充；
  • Actions 兼容性存在边界：部分依赖 GitHub 托管特有运行环境的动作需替换或自建执行环境（官方文档有兼容性说明）；
  • 治理模式：开源版与商业实体并行演进，与 Forgejo 的社区治理路径是长期路线上的差异点。

七、同类选型对比

对比维度数据均于 2026-10-18 联网实查：开源许可来自各项目官方仓库 LICENSE；stars 来自 GitHub 官方页面（Forgejo 主仓在 Codeberg，官方未公布 GitHub stars）；版本来自各项目官方发布渠道。

项目开源许可GitHub stars 与最近发版版本节奏兼容矩阵
Gitea 28.1MIT58,548 stars；v28.1.0（2026-10）大版本约每季度一发，补丁频繁；1.27.x 维护线并行Linux/Windows/macOS，Go 单二进制；SQLite/PostgreSQL/MySQL/MariaDB
Forgejo 17.0GPL-3.0主仓在 Codeberg，官方未公布 GitHub stars；v17.0.0（2026-10）大版本约四个月一发，v15.0 为 LTS 线Linux/Windows/macOS（Windows 实验支持），Go 单二进制；四种数据库同 Gitea
GitLab CE 19.5MIT（CE 核心，企业功能闭源分层）24,551 stars；v19.5.0（2026）每月 22 日大版本Linux omnibus 包为主，官方建议 4 核 8G 起步；资源占用显著高于 Gitea
Gogs 0.14MIT47,883 stars；0.14.3（2026）0.x 版本线，发布频率低Linux/Windows/macOS，Go 单二进制；功能为三者中最小子集

横向简评：

  • Forgejo：与 Gitea 同源且功能相近，差异在治理（非营利社区主导 + GPL-3.0）与 LTS 策略；追求社区自治与长期支持线时优先；
  • GitLab CE：内置 CI/CD、安全扫描、看板等全家桶能力最深，但部署体量与资源成本高一个量级，适合需要一体化重型平台的组织；
  • Gogs：Gitea 的前身，极致轻量、功能极简，适合低配设备上的纯 Git 托管，无内置 CI 与制品库；
  • Gitea：在轻量部署与功能完整度之间平衡最好，MIT 许可对集成与二次分发最宽松，社区规模三者中最大。

选型建议：希望以最低运维成本获得"托管 + CI + 制品库"完整能力且偏好宽松许可，选 Gitea 28.1；重视社区治理与 LTS 长周期支持选 Forgejo；需要重型一体化 DevOps 平台与安全套件选 GitLab CE；仅需极简 Git 托管选 Gogs。

八、参考链接

  1. Gitea 官网：https://about.gitea.com/
  2. 官方文档站：https://docs.gitea.com/
  3. 二进制安装文档：https://docs.gitea.com/installation/install-from-binary
  4. 官方下载服务器：https://dl.gitea.com/gitea/
  5. 官方代码仓库：https://github.com/go-gitea/gitea
  6. 配置参考备忘：https://docs.gitea.com/administration/config-cheat-sheet
  7. Gitea Actions 与 act_runner 文档：https://docs.gitea.com/usage/act-runner
  8. 官方博客（版本发布公告）：https://blog.gitea.com/