这两年但凡做技术管理、团队基建,或者纯粹想搭建个人代码仓库的人,多少都会被同一个问题反复折磨:代码到底放哪里?GitHub和GitLab当然好用,可数据合规、私有仓库数量限制、服务器成本、CI/CD配额,随便哪一条都能把人劝退。于是自托管成了越来越多人认真考虑的选项。
选来选去,Gitea 和 GitPuk 这两个名字会频繁出现在备选清单里。一个是把“轻量自托管”做到极致的 Go 单文件应用,社区生态成熟、文档丰富;另一个是主打极简操作和代码阅读体验的后来者,资料相对少,但关注度一直在涨。我把这两个代码管理工具放在同一台 Linux 服务器上各跑了一段时间,也翻了大量文档、Issues 和社区讨论,踩过不少坑。这篇就把两者从部署到日常管理、再到团队协作的完整对比拆开讲清楚。
不管你是个人开发者、三五人的小团队,还是需要给公司搭一套内部代码平台的运维,这篇选型指南应该能帮你少走很多弯路。
1. 先搞清楚:你的团队到底需要哪种代码管理工具
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
1.1 自托管代码仓库的三类典型诉求
很多人在选型阶段就犯了错,一上来就对比功能列表,比完更懵。我建议先把需求归类,市面上绝大多数的自托管诉求逃不出这三类:
第一类是“数据必须在自己手里”。典型场景是公司内部项目、软件外包交付、或者有合规要求的研发团队。代码放在第三方平台总是有隐患,万一平台调整政策、账号被封、甚至服务下线,焦虑感直接拉满。这类用户的核心诉求是“数据自主可控”,对部署、备份、迁移能力要求极高。
第二类是“成本敏感的个人或微型团队”。GitHub 私有仓库不收费了,但 Actions 的免费额度、大文件存储的限制仍然让人头疼。个人开发者做点小项目、写点博客、存点脚本,不想为基础设施花太多钱,但也不想把代码裸放在公网上。这种场景下,一台低配 VPS 就是全部预算,工具必须得省资源、好维护。
第三类是“想要 GitHub 式体验但不想被绑定”。程序员用惯了 GitHub 的 Pull Request、Issue、Actions 生态,换到别的工具总有点别扭。团队需要一套内部平台,但也不想自己造轮子,希望装完就有接近 GitHub 的体验,最好还支持 GitHub Actions 的语法习惯。
把需求定在这三类里,再去选型,思路就清晰多了。Gitea 和 GitPuk 都属于“轻量级自托管 Git 服务”这个大类,但它们对这个大类的理解、取舍,其实差别非常明显。
1.2 为什么把 Gitea 和 GitPuk 放在一起比较
市面上的对比文章大多是 Gitea 对 GitLab,但 GitLab 那个资源占用,光内存动不动就是几 GB,和轻量两个字根本不沾边。真正让选型陷入纠结的,恰恰是 Gitea 和 GitPuk 这种都标榜“轻量”“快速”“部署简单”的工具。
我第一次看到 GitPuk 的时候,直觉是“又一个 Gitea 换皮”?后来仔细看它的设计理念和实现方式,才发现它走的是另一条路。Gitea 选择的是“把功能做全,把重量做轻”,集成了 Issue、PR、Wiki、Actions、项目管理、包仓库,几乎是半个 GitLab。GitPuk 的做法更激进,它刻意做减法,把代码托管的核心链路做到极致,砍掉大量外围功能,换来的是更快的页面响应和更低的维护成本。
所以这两者的对比,本质上不是“谁功能多谁赢”,而是“功能全面”和“专注核心”两种产品哲学的对碰。这个对比背后,是团队对自己需求的真实认知。
2. Gitea:用 Go 单文件把“轻量自托管”做成标准答案
2.1 部署和资源占用:一台 1 核 1G 的服务器就够
Gitea 最打动人的地方,永远是部署体验。整个服务就是一个 Go 编译出来的二进制文件,不依赖 Java 运行时、不依赖 Node.js、不依赖一堆共享库。你把它放到服务器上,配一个数据库,跑起来就是一个完整的代码托管平台。
我自己实测过的最低配置是一台 1 核 1G 内存的轻量云服务器,系统是 Debian 11,装好 Gitea 之后跑了几个小团队的内网仓库,内存占用长期在 300M 左右徘徊,CPU 平时基本是空闲状态。这个资源占用水平,直接决定了你可以在多便宜的服务器上跑它,也决定了它能不能塞进 NAS、树莓派这类家用设备里。
数据库方面,Gitea 支持 SQLite、MySQL、PostgreSQL。个人使用或几个人的小团队,直接用 SQLite 就完事,少一个组件少一份运维负担。但要注意一点,如果团队超过十个人,并发访问明显上来,建议还是上 PostgreSQL 或 MySQL,SQLite 在并发写多的时候会出现锁等待,这个我实测过的,仓库大、操作频繁的时候会有点卡。
安装过程简单到什么程度?下载二进制、写一份 app.ini 配置文件、初始化数据库、用 systemd 托管进程,全程十五分钟能搞定。具体的操作步骤我在第五章会详细写,这里先不展开。
2.2 权限模型与 SSH 密钥管理:中小团队最在意的细节
代码托管工具的功能再多,权限和密钥管理做不好,团队根本不敢用。Gitea 的权限模型非常清晰,分四个层级:系统管理员、组织、团队、仓库。可以做到很细的粒度控制,比如某个团队只能读取某个仓库,另一个团队可以推送,还有人是仓库管理员可以管理合并请求。
SSH 密钥管理是自托管场景里必须重视的一环。Gitea 的每个用户都可以在“设置 → SSH 密钥”里添加自己的公钥,支持同时管理多把密钥,比如一台办公电脑、一台笔记本、一台服务器,各添加一把密钥,随时可以删掉任何一把。这个设计对个人用户和团队来说都足够灵活。
Gitea 的 SSH 认证实现方式也值得一提。它不直接接管系统的 SSH 服务,而是在系统 SSH 基础上做了个中间层。你在 app.ini 里配置好 SSH 端口,Gitea 会把用户的公钥写入到它内置的管理逻辑中,而不是直接写进 root 的 authorized_keys。这样做的好处是安全隔离,用户密钥被 Gitea 管理
