很多站长都经历过这样的纠结:项目代码放在第三方托管平台上,免费额度受限、私有仓库要付费、偶尔还担心服务商跑路或数据被扫描。其实,只要手里有一台像样的云服务器,用 Docker 搭一套属于自己的私有 Git 仓库和代码管理平台,半小时就能跑起来,而且完全可控、可迁移、可备份。
笔者在几台生产服务器上长期运行自建 Git 服务,踩过不少坑,也总结出一套相对稳妥的实践路径。这篇文章不堆概念,直接从核心原理讲到生产环境加固,最后给出一份可复用的 SOP 清单。
一、核心原理:Docker 化 Git 服务到底在做什么
💡 推荐阅读:别再重启了!Linux 负载飙高排查指南:从指标拆解到调优实战,我踩过的坑都在这了
自建 Git 仓库的本质,是在服务器上运行一个 Git 服务端程序,它监听 HTTP 或 SSH 端口,接收客户端的 push / pull 请求,并把代码对象存储到磁盘上。传统做法是直接在宿主机安装 Git、配置用户权限、手动管理仓库目录,过程繁琐且容易污染系统环境。
Docker 的价值在于把运行时、依赖、配置、数据目录四者解耦。你只需要关心三件事:
- 镜像:选择成熟的开源 Git 服务端,如 Gitea、Gogs 或 GitLab CE。
- 数据卷:把仓库数据、数据库、配置文件挂载到宿主机,容器删了数据还在。
- 端口映射:把容器内的 Web 端口和 SSH 端口暴露出来,供客户端访问。
其中,Gitea 是笔者最推荐的个人/小团队方案:单二进制、资源占用低、自带 Web 界面、支持 SSH 和 HTTP 两种协议,配合 Docker 部署几乎零维护。GitLab 功能更全,但对内存要求高,个人服务器上容易吃紧。
二、生产环境架构规范:别把“能跑”当成“能用”
💡 延伸阅读:新手建站踩坑实录:轻量应用服务器和云服务器CVM到底怎么选?别等网站崩了才后悔
很多教程只教到 docker run 就结束了,结果线上跑几天就出问题。下面这套架构规范,是笔者在真实环境中验证过的底线配置。
2.1 目录规划:数据与配置分离
建议在宿主机上固定一个数据根目录,例如 /opt/gitea,内部再细分:
/opt/gitea/data:仓库数据、附件、LFS 对象。/opt/gitea/config:应用配置文件。/opt/gitea/db:如果使用内置 SQLite,数据库文件也放这里;若用外部 MySQL/PostgreSQL,则单独规划。
这样做的好处是:备份时直接打包整个目录,迁移时复制到新机器即可,容器本身可以随时重建。
2.2 网络与端口:只暴露必要的入口
Gitea 默认 Web 端口是 3000,SSH 端口是 22。生产环境建议:
- Web 端口映射为宿主机
127.0.0.1:3000,再由 Nginx 反向代理并配置 HTTPS,不要直接把 3000 暴露到公网。 - SSH 端口映射为宿主机的高位端口,例如
2222,避免与宿主机自身的 SSH 服务冲突。
如果你还没有云服务器,建议选择口碑稳定的正规厂商,优先考虑带独立公网 IP、支持快照备份的机型。域名也建议走正规注册商,后续配置 HTTPS 和 SSH 克隆地址时都会用到。
2.3 数据库选择:SQLite 够用,但要知道边界
个人使用或 5 人以下小团队,SQLite 完全够用,部署简单、备份方便。但如果仓库数量多、并发操作频繁,建议换成 MySQL 或 PostgreSQL,避免锁竞争导致 Web 界面卡顿。
三、性能与安全加固调优清单
💡 深度技术指南:别等服务器宕机才后悔:一次说透云服务器到期前,网站数据与数据库的无缝迁移实战心法
下面这份清单,建议在首次部署完成后逐项核对。
| 调优项 | 推荐做法 | 说明 |
|---|---|---|
| HTTPS | Nginx + Let’s Encrypt 证书 | 避免凭证明文传输,提升克隆地址安全性 |
| SSH 认证 | 禁用密码登录,仅允许公钥 | 在 Gitea 配置中关闭 DISABLE_SSH 并启用公钥管理 |
| 资源限制 | 为容器设置 --memory 和 --cpus |
防止单个服务拖垮整台服务器 |
| 备份策略 | 每日定时打包数据目录并异地存储 | 可用 cron + rsync 或对象存储同步 |
| 日志轮转 | 配置 Docker 日志驱动为 json-file 并限制大小 |
避免日志无限增长占满磁盘 |
| 防火墙 | 仅放行 80、443 和自定义 SSH 端口 | 使用云厂商安全组或 ufw/firewalld |
3.1 一份可用的 Docker Compose 配置
与其手写一长串 docker run,不如用 Compose 管理。以下配置经过笔者实际运行验证,可直接作为起点:
version: "3"
services:
gitea:
image: gitea/gitea:latest
container_name: gitea
restart: always
environment:
- USER_UID=1000
- USER_GID=1000
- GITEA__database__DB_TYPE=sqlite3
- GITEA__server__DOMAIN=git.example.com
- GITEA__server__SSH_DOMAIN=git.example.com
- GITEA__server__ROOT_URL=https://git.example.com/
- GITEA__server__SSH_PORT=2222
volumes:
- /opt/gitea/data:/data
- /etc/localtime:/etc/localtime:ro
ports:
- "127.0.0.1:3000:3000"
- "2222:22"
mem_limit: 512m
cpus: 1.0
启动命令:docker compose up -d。首次访问 Web 界面后,记得立即创建管理员账号,并在设置中关闭公开注册。
3.2 Nginx 反向代理要点
在 Nginx 中配置 proxy_pass http://127.0.0.1:3000,并确保传递 Host 和 X-Forwarded-Proto 头,否则 Gitea 生成的克隆地址可能仍是 HTTP。证书建议用 Certbot 自动续期,省心且不容易过期。
四、验证测试与 SOP 总结
部署完成后,不要只看 Web 界面能打开就以为万事大吉。按下面步骤做一轮完整验证:
- 创建一个测试仓库,用 HTTPS 方式克隆、提交、推送,确认凭据认证正常。
- 用 SSH 方式克隆同一仓库,确认公钥认证和自定义端口生效。
- 重启服务器,确认容器自动拉起,数据未丢失。
- 模拟备份:打包
/opt/gitea目录,在另一台机器上恢复并验证仓库可读。
最后,把日常操作固化成 SOP:
- 新增仓库:Web 界面创建,按团队规范设置可见性。
- 权限管理:用组织/团队功能分配读写权限,避免直接共享管理员账号。
- 定期维护:每月检查磁盘占用、更新镜像版本、验证备份可恢复。
自建私有 Git 平台并不是什么高深技术,关键在于把数据掌控权拿回自己手里。选一台靠谱的服务器,配好域名和 HTTPS,再按上面的规范跑起来,你就能拥有一个稳定、私密、完全属于自己的代码管理平台。