Gitea：轻量自托管 Git 服务

为什么要自托管 Git 服务？

虽然 GitHub、GitLab 等公共平台提供了强大的代码托管能力，但很多开发者都遇到过这些痛点：私有仓库有数量限制，企业代码无法完全掌控，访问速度受网络波动影响，甚至担心数据被审查或泄露。自托管 Git 服务可以把代码、Issue、CI 等都放在自己的服务器上，但传统方案往往太重——GitLab 动辄占用几个 GB 内存，配置和维护成本很高。

Gitea 正是为解决这个矛盾而生的。它由 Gogs 发展而来，社区活跃，用 Go 语言编写，单个二进制文件即可运行，对硬件要求极低。即使是只有 512MB 内存的小型 VPS，也能流畅运行 Gitea 和几个仓库的日常操作。

核心功能：轻而不简

Gitea 虽然体积小，但功能覆盖了日常开发所需的绝大部分场景，而且操作界面简洁，中文支持良好。

• 仓库管理：支持公开/私有仓库、分支保护、合并请求（PR）、代码审查、标签和里程碑，还提供了文件在线编辑和 Web 编辑器。
• 协作工具：内置 Issue 跟踪、项目看板（类似 GitHub Projects）、Wiki，以及评论和@提及功能，方便小团队沟通。
• 自动化集成：内置 Webhook 支持，可对接 Jenkins、Drone 等 CI/CD 工具；同时提供 Actions 功能（兼容 GitHub Actions），可直接使用社区现成的 workflow 文件。
• 扩展生态：通过插件可以增加 Maven、NPM、PyPI 等包管理器的私有仓库支持，让 Gitea 成为开发流程的统一入口。

这些功能在公共平台上可能要花钱或受限制，但 Gitea 全部免费且无用户数限制，非常适合中小团队内部使用。

安装与配置：三步搞定

Gitea 的安装方式非常灵活，这里以 Linux 服务器为例，介绍最常用的二进制安装和 Docker 安装两种方式。

方式一：二进制安装

安装依赖（Git、SQLite3 或 MySQL），然后到 Gitea 官网下载对应架构的二进制文件，并赋予执行权限。之后创建独立的运行用户（如 git），将二进制放到 /usr/local/bin/gitea，再创建数据目录 /var/lib/gitea。最后直接运行 gitea web 启动，首次访问 http://服务器IP:3000 会进入安装向导，只需填写数据库、站点名称和管理员账号即可完成初始配置。

# 以 Debian/Ubuntu 为例
sudo apt update && sudo apt install git sqlite3
wget -O gitea https://dl.gitea.com/gitea/1.22.0/gitea-1.22.0-linux-amd64
chmod +x gitea
sudo mv gitea /usr/local/bin/
sudo useradd -m git
sudo mkdir -p /var/lib/gitea
sudo chown git:git /var/lib/gitea
sudo -u git gitea web

方式二：Docker 安装

如果你已经使用 Docker，一条命令就能启动 Gitea 容器。使用 Docker Compose 可以同时管理 Gitea 和数据库，方便迁移和备份。

docker run -d --name=gitea \
  -p 3000:3000 -p 22:22 \
  -v gaitea-data:/data \
  -e USER_UID=1000 -e USER_GID=1000 \
  gitea/gitea:latest

安装完成后，建议通过 Nginx 配置 HTTPS 和域名反向代理，并设置 SSH 端口转发，让团队可以通过 SSH 协议推送代码。

注意事项：稳定运行的关键

• 备份与恢复：定期备份 Gitea 的数据目录（包含仓库数据库和文件），可以使用官方推出的备份命令 gitea dump，将备份文件妥善保存。
• 安全加固：默认管理后台路径和端口容易暴露，建议修改自定义安装路径，并开启两步验证（2FA）。同时关注 Gitea 官方安全公告，及时升级版本。
• 升级策略：Gitea 版本迭代较快，升级前先阅读官方升级指南，尤其是跨大版本升级需要先备份，避免数据损坏。
• 性能调优：如果仓库数量多或并发高，可以改用 MySQL 或 PostgreSQL 数据库，并配置 Redis 做缓存，进一步提升并发能力。

总的来说，Gitea 是一条成本极低但回报很高的自托管路径——只要有一台小服务器，你就能拥有完全可控的代码托管平台，不再受第三方服务的限制。