📦 站群版本控制，香港服务器Git搭建

站群开发往往涉及多个站点、多人协作，代码管理稍有不慎便陷入混乱：文件覆盖、功能冲突、上线回滚困难……版本控制正是破解这些难题的利器。而Git作为当今最流行的分布式版本控制系统，已成为开发团队的标配。当Git服务器部署在香港服务器上，更能发挥其低延迟、免备案的优势，为站群团队提供稳定高效的代码协作中心。本文将从版本控制基础讲起，手把手教你搭建基于Gitea的Git服务，并实现与站群自动化部署的联动。

🔧 一、站群为何需要版本控制？

站群项目与普通单站开发存在显著差异：

• 代码库庞大：数十甚至上百个站点可能共享同一套核心代码，但各自有定制配置。
• 多人协作频繁：前端、后端、SEO人员同时修改，易产生冲突。
• 上线节奏快：站群需快速迭代试错，回滚需求频繁。
• 环境一致性：开发、测试、生产环境需保持代码同步。

Git版本控制可以完美解决这些问题：

• 历史追溯：每一次提交都有记录，可随时回滚到任意版本。
• 分支管理：开发新功能时创建分支，完成后再合并，主分支始终保持稳定。
• 协同工作：多人并行开发，Git自动合并，冲突可手动解决。
• 代码审查：通过Pull Request/Merge Request进行代码评审，提升质量。
• 自动部署：结合Webhook，代码推送后自动同步到站群服务器。

🌐 二、为什么选择香港服务器搭建Git？

Git服务器对网络延迟和稳定性要求较高，尤其是团队分布在国内时：

• 低延迟：香港到大陆主要城市延迟30-50ms，clone/push操作体验流畅，避免跨境网络抖动。
• 免备案：无需ICP备案，服务器开通即可安装Git服务，快速启动。
• 国际带宽：若团队成员分布在海外，香港服务器的国际带宽可保障全球访问速度。
• 稳定可靠：香港数据中心普遍达到Tier III+标准，保障Git服务99.9%在线率。
• 与站群同区域：若站群本身部署在香港，Git服务器与生产环境同区域，拉取代码延迟极低，加速自动化部署。

📚 三、Git服务选型：Gitea vs GitLab vs Gogs

主流的自托管Git服务有GitLab、Gitea、Gogs等，三者的对比如下：

特性	GitLab	Gitea	Gogs
资源占用	较高（需4GB+内存）	极低（1GB足够）	极低
功能丰富度	最全面（CI/CD、Wiki等）	适中（满足大多数场景）	基础
安装难度	复杂（需配置多组件）	简单（单二进制文件）	简单
社区活跃度	高	高	较低

对于站群团队，推荐使用Gitea：它轻量、易维护，功能足够覆盖日常开发，且支持Webhook、分支保护、团队权限等核心功能。

⚙️ 四、香港服务器搭建Gitea实战

4.1 环境准备

选择一台香港服务器（建议1核2GB以上），操作系统为Ubuntu 20.04或CentOS 8。更新系统并安装必要依赖：

# Ubuntu
sudo apt update
sudo apt install -y git sqlite3 curl wget nginx

# CentOS
sudo dnf update
sudo dnf install -y git sqlite curl wget nginx
  

4.2 安装Gitea

从官网下载最新二进制文件并设置权限：

# 下载Gitea
wget -O /tmp/gitea https://dl.gitea.com/gitea/1.21.0/gitea-1.21.0-linux-amd64
chmod +x /tmp/gitea
sudo mv /tmp/gitea /usr/local/bin/gitea

# 创建运行用户
sudo adduser --system --group --disabled-password --shell /bin/bash --home /home/git git

# 创建目录结构
sudo mkdir -p /var/lib/gitea/{custom,data,log}
sudo chown -R git:git /var/lib/gitea/
sudo chmod -R 750 /var/lib/gitea/
sudo mkdir -p /etc/gitea
sudo chown root:git /etc/gitea
sudo chmod 770 /etc/gitea
  

4.3 创建Systemd服务

新建服务文件/etc/systemd/system/gitea.service：

[Unit]
Description=Gitea (Git with a cup of tea)
After=network.target

[Service]
User=git
Group=git
WorkingDirectory=/var/lib/gitea/
ExecStart=/usr/local/bin/gitea web --config /etc/gitea/app.ini
Restart=always
Environment=USER=git HOME=/home/git GITEA_WORK_DIR=/var/lib/gitea

[Install]
WantedBy=multi-user.target
  

启动Gitea并设置开机自启：

sudo systemctl daemon-reload
sudo systemctl enable --now gitea
  

4.4 Nginx反向代理与HTTPS

创建Nginx配置/etc/nginx/conf.d/gitea.conf：

server {
    listen 80;
    server_name git.your-domain.com;
    return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl http2;
    server_name git.your-domain.com;

    ssl_certificate /etc/letsencrypt/live/git.your-domain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/git.your-domain.com/privkey.pem;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}
  

使用Certbot申请SSL证书：

sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d git.your-domain.com
  

4.5 初始化配置

访问https://git.your-domain.com，进入安装页面。填写数据库（选择SQLite3即可）、管理员账户等信息。完成后即可开始使用。

4.6 安全加固

• 防火墙：限制SSH端口，仅允许公司IP访问。
• 定期备份：备份/var/lib/gitea/data和/etc/gitea/app.ini。
• 禁用注册：若仅内部使用，在配置文件中关闭注册功能。

🤝 五、站群团队协作与自动化部署

5.1 分支策略推荐

采用Git Flow或GitHub Flow：

• main：生产分支，始终保持可部署状态。
• develop：开发主干，功能分支从此拉取。
• feature/*：新功能开发，完成后合并到develop。
• release/*：版本发布前测试修复。
• hotfix/*：紧急修复生产问题。

5.2 权限管理

在Gitea中，可以按组织、团队分配权限：

• 读权限：普通开发人员可clone和pull。
• 写权限：核心开发者可push到特定分支。
• 管理员：管理仓库设置、成员权限。

建议对main分支开启分支保护：禁止直接push，必须通过合并请求，且需至少一名审查者批准。

5.3 Webhook自动部署

当代码推送到特定分支（如main）时，Gitea可以触发Webhook，通知站群服务器拉取最新代码并执行部署脚本。

部署脚本示例（在站群服务器上）：

#!/bin/bash
# deploy.sh
cd /var/www/站点目录
sudo -u www-data git pull origin main
# 若有编译步骤，可添加 composer install / npm run build 等
sudo systemctl reload php-fpm
  

在Gitea仓库设置中添加Webhook，指向站群服务器的接收地址（如http://your-server:8080/webhook），并配置Secret验证保证安全。

5.4 多站点的代码同步

若多个站点共享同一套代码，可以使用Git Submodule或Git Subtree管理。更现代的做法是为核心代码创建独立仓库，各站点仓库通过依赖管理（如Composer、NPM）引入。

“自从搭建了Gitea并引入Webhook自动部署，站群的上线时间从30分钟缩短到3分钟，且再未出现因人工误操作导致的代码冲突。”——某站群技术负责人

📊 六、监控与维护

Git服务器也需纳入监控体系：

• 磁盘空间：仓库日益增大，需监控/var/lib/gitea使用率，设置告警阈值。
• 服务状态：监控Gitea进程和端口，异常时自动重启。
• 备份策略：每日备份数据到异地存储（如OSS），保留最近30天。
• 版本升级：关注Gitea官方发布，定期升级以获取新功能和安全修复。

可使用Prometheus + Grafana对Git服务器进行可视化监控。

🎯 总结

站群版本控制不是可选项，而是现代开发流程的基石。通过在香港服务器上搭建Gitea，我们获得了：

• 集中化的代码仓库，所有站点代码统一管理，历史可追溯。
• 灵活的权限与分支策略，支持多人协作，保障主分支稳定。
• Webhook自动部署，实现代码推送即上线，提升效率。
• 香港服务器的低延迟，让团队协作流畅无阻。

这套方案轻量、高效、成本可控，完美匹配站群团队的开发需求。现在就开始你的Git之旅吧，让版本控制为站群业务保驾护航。