把 GitHub 换成自托管的 Forgejo:得到了什么,又失去了什么

GitHub 用起来方便,但仓库放在哪里、由谁说了算,不少开发者心里其实有数。本文讲述如何用开源的 Forgejo 自建 Git 服务:仓库怎么迁移、CI 怎么接、运维要承担什么,以及个人项目与社区项目各适合怎么选,全部基于实际体验整理。

用 GitHub 用了很多年,大多数人都觉得它理所当然。但小编越来越想知道:代码、Issue 记录和发布版本到底放在哪里,又由谁说了算?于是小编把仓库迁到了 Forgejo,一个可以自己部署的开源 Git 平台。先说结论:个人项目换过去很划算,但社区项目要慎重。下面把迁移过程、好处和代价讲清楚。

那么,具体该怎么做?

把代码的主动权握在自己手里

先说清楚 Forgejo 是什么:它是一个您可以自己运行的 Git 托管平台(Git forge)。它的来历也解释了它为什么更偏向社区。2022 年 12 月,它作为 Gitea 的分支诞生。后来,一家营利性公司接管了 Gitea 的商标和运营,两边的代码在 2024 年初正式分叉,此后各自发展。如今 Forgejo 是独立项目,有自己的发布节奏、文档和优先级。

Forgejo 相对轻量。仓库、Pull Request、Issue、CI/CD,甚至包管理仓库都有,而且大约只占用 100MB 内存,所有数据都留在您自己的硬件上。

它用 Go 编写,发布为单个二进制文件,并提供官方容器镜像,所以从旧笔记本、迷你主机到单板电脑都能跑。用一个 Docker Compose 文件、一个服务和一个数据卷就能启动可用的实例。个人使用的话,内置的 SQLite 通常够用;如果多人同时使用,建议换成 PostgreSQL。

真正费功夫的是周边基础设施。如果要对公网开放,通常需要域名、HTTPS,以及安全的 Git 访问方式。Caddy 或 Nginx 这类反向代理可以负责 HTTPS,Git 操作也可以走 SSH。只在局域网里用会简单些,但安全措施仍然不能省。

迁移仓库是 Forgejo 最大的卖点。它的迁移工具可以导入 Git 仓库,以及 Issue、Pull Request、标签、里程碑和发布版本等项目数据。不过,并非 GitHub 的每个功能和元数据都能完美迁移,所以在删除原仓库之前,最好先核对导入的内容。私有仓库需要提供一个 GitHub 个人访问令牌,再选择要迁移的内容。如果暂时不想彻底切换,也可以把仓库设置为镜像:Forgejo 会定期从 GitHub 拉取更新。这种方式只单向同步 Git 内容,Issue、Pull Request 等项目数据不会双向同步,但适合两边并行过渡一段时间。

优点

掌控权、开放性,以及一个轻量、重社区的 Forge

最大的好处是对基础设施的掌控。代码、Issue 记录和发布记录都保存在一块您能看见、能备份、能随时迁移的硬盘上。您不必再依赖托管商可能变动的服务条款,也不必为了企业优先级去调整自己的使用习惯。

这种掌控感还延伸到项目本身。Forgejo 由德国非营利组织 Codeberg e.V. 管理,该组织持有域名和商标。更关键的是,从 9.0 版本开始,它从 MIT 许可改为 GPL v3+。没有所谓的“专业版”,贡献者也不需要转让版权。GPLv3 或更高版本的许可,加上非营利的治理结构,有助于保证发布的代码始终以开源条款提供。与一些把功能留给付费版的平台不同,Forgejo 目前专注于通过社区开发的代码库提供功能。

另外,Codeberg 本身就运行着基于 Forgejo 的公共 Forge,运营者也是这套软件的重度用户。这让项目的优先级更贴近实际,也更偏向社区。

日常使用上,Forgejo 很平淡,但这是好事。界面足够熟悉,浏览仓库和 Issue 几乎不需要适应。仓库、Pull Request、Issue、标签、里程碑、Wiki、发布页面和包仓库都在那里。实际的限制只取决于您的硬件:没有“扩容”菜单,也没有需要省着用的 CI 分钟数,因为 Runner 是您自己的。

Forgejo Actions 比小编预想的好用。它采用 GitHub 的 YAML 语法;如果您没有专门的 .forgejo/workflows 目录,它会去找 .github/workflows,所以简单的构建和测试流水线不会因为迁移而失效。近期版本也持续投入这方面。例如,Forgejo v15.0 于 2026 年 4 月 16 日发布,也就是项目的第 100 个版本,新增了仓库级令牌、OIDC 支持和临时 Runner 等功能。

最后,升级节奏由您自己掌握。Forgejo 15.0 分支是 LTS 版本,支持到 2027 年 7 月 15 日。这意味着您可以长期使用一个稳定版本,等真正想升级时再升级,而不是等某个厂商决定推出大改版。

缺点(不少)

您要变成运维团队,也会失去人群

GitHub 上 open-webui-obsidian-search 仓库的 README 和项目文件页面。

自己运行 Forgejo,意味着您就是它全职的运维团队。只要您打算自托管任何服务,这一点本来就是默认的。项目迭代很快,大约每个季度就有一个大版本,而非 LTS 分支的生命周期很短。安全更新会不定期出现。Forgejo 会提前发出预警,但前提是您得真的关注。

备份也得自己负责。如果硬盘在您设置好备份之前坏了,没有客服可以找。“免费”也要打个问号:软件虽然不收费,硬件、电费和域名都要花钱。如果您使用外部主机托管,这笔开销也少不了。

Forgejo Actions 的语法看上去与 GitHub 相似,但实际要复杂一些。官方文档说得很清楚:它的设计目标是让 GitHub Actions 用户“感觉熟悉”,而不是完全兼容。迁移工作流时,要做好小改动的准备。另外,工作流不会在 Forgejo 实例本身运行,而是分派给独立的 Runner,所以您需要安装并维护 Forgejo Runner,构建也会占用自己 Runner 的资源。如果您的流水线依赖 GitHub 专属的 Action,或者托管的 macOS、Windows Runner,就要预计额外的配置或工作流改动。

最大的缺点其实是网络效应。根据 GitHub 的 Converse 2025 报告,它的开发者已超过 1.8 亿。访客无需账号就能浏览和克隆公开仓库,但要提交 Issue 或 Pull Request,通常需要登录。在个人的 Forgejo 实例上,习惯用 GitHub 账号的开发者会觉得麻烦。Forgejo 的联邦功能正在解决这个问题,但仍在开发中,无法替代大家本来就聚集的地方。

旧链接也会失效。Organic Maps 迁到 Forgejo 时,它的 GitHub 仓库变成了镜像,Issue 追踪和 Wiki 都被禁用。其他仓库、论坛和 OSM Wiki 上的旧链接因此失效,用户还得手动重新订阅关注的 Issue。另外,针对 Forgejo API 开发的第三方工具远少于 GitHub,集成生态也会小很多。

Forgejo 给了您所有权,但需要持续投入维护

迁到 Forgejo 之后,您对仓库、项目数据和托管基础设施有了更大的控制权,还拥有一个轻量、非营利、Copyleft 的代码平台,CI 也按自己的规则运行。但代价是,您成了自己的系统管理员,也离开了 GitHub 那个庞大的受众。对个人的副业项目来说,这笔交换非常划算;如果是社区项目,就得多想一想。

常见问题(FAQ)

Forgejo 需要很好的服务器吗?

不需要。它大约占用 100MB 内存,旧笔记本、迷你主机甚至单板电脑都能跑,个人使用时 SQLite 就够了。

能一键把 GitHub 仓库搬过去吗?

可以用迁移工具导入仓库、Issue、Pull Request、标签、里程碑和发布版本,但并非所有元数据都能完美迁移,删除原仓库前最好先核对。

切换之后,别人还能给我提 Issue 吗?

可以,但对方通常需要有账号。如果您的项目依赖大量外部贡献者,这一点要慎重考虑。

Forgejo 完全免费吗?

软件本身是开源的,许可为 GPLv3 或更高版本,没有付费版。但服务器、电费和域名仍需要自己承担。

没有时间折腾,该不该换?

如果只是个人小项目,又不介意定期维护,可以试试;如果主要需要稳定协作,保留 GitHub 会更省心。