从零开始搭建私有Git仓库的完整指南
如何在VPS服务器上部署Git服务？

部署方式	适用场景	主要工具	配置复杂度
基础Git部署	个人项目/小型团队	Git + SSH	简单
Git with Hooks	自动化部署	Git Hooks	中等
GitLab CE	企业级协作	GitLab	复杂
Gitea	轻量级自托管	Gitea	中等
Gogs	极简Git服务	Gogs	中等

如何在VPS上部署Git服务？

在VPS上部署Git服务可以让开发者拥有完全控制的私有代码仓库，无论是个人项目还是团队协作都能获得更好的灵活性和安全性。

主要部署步骤概览

步骤序号	操作内容	所需工具	预估时间
1	VPS环境准备	SSH客户端	10分钟
2	Git安装配置	包管理器	5分钟
3	用户权限设置	Linux用户管理	5分钟
4	仓库初始化	Git命令	5分钟
5	SSH密钥配置	SSH工具	10分钟
6	远程仓库测试	Git客户端	5分钟

详细操作流程

步骤1：VPS环境准备

操作说明：首先需要通过SSH连接到你的VPS服务器，确保系统是最新状态。 使用工具提示：使用PuTTY（Windows）或终端（Mac/Linux）进行SSH连接

# 连接到VPS服务器
ssh root@yourvpsip
更新系统包管理器
apt update && apt upgrade -y  # Ubuntu/Debian
或者
yum update -y  # CentOS/RHEL

步骤2：Git安装与配置

操作说明：在VPS上安装Git并进行基础配置 使用工具提示：使用系统包管理器安装Git

# Ubuntu/Debian系统
apt install git -y
CentOS/RHEL系统
yum install git -y
配置Git全局设置
git config --global user.name "Your Name"
git config --global user.email "youremail@example.com"

步骤3：创建Git专用用户

操作说明：为Git服务创建专用系统用户，提高安全性 使用工具提示：使用useradd命令创建用户

# 创建git用户
adduser git
切换到git用户
su - git
创建.ssh目录并设置权限
mkdir .ssh && chmod 700 .ssh
touch .ssh/authorizedkeys && chmod 600 .ssh/authorizedkeys

步骤4：初始化Git仓库

操作说明：在git用户目录下创建裸仓库（bare repository） 使用工具提示：使用git init命令创建裸仓库

# 创建项目仓库目录
mkdir /home/git/myproject.git
cd /home/git/myproject.git
初始化裸仓库
git init --bare

步骤5：配置SSH密钥认证

操作说明：将本地开发机的SSH公钥添加到VPS的git用户授权密钥中 使用工具提示：在本地机器生成SSH密钥对

# 在本地机器生成SSH密钥（如果还没有）
ssh-keygen -t rsa -b 4096 -C "youremail@example.com"
将公钥内容复制到VPS的authorizedkeys文件中
可以通过scp命令或手动复制粘贴

步骤6：测试远程仓库连接

操作说明：从本地机器测试连接到VPS上的Git仓库 使用工具提示：在本地使用git clone命令测试连接

# 从本地机器克隆远程仓库
git clone git@yourvpsip:/home/git/myproject.git
如果克隆成功，说明部署完成

常见问题与解决方案

问题	原因	解决方案
权限被拒绝（Permission denied）	SSH密钥未正确配置或权限设置错误	检查.ssh目录权限为700，authorized_keys文件权限为600，确保公钥内容完整
无法推送代码	仓库目录权限问题或git用户shell限制	确保仓库目录属于git用户，将git用户的shell改为git-shell：chsh git -s $(which git-shell)
连接超时	防火墙阻止SSH端口或网络配置问题	检查VPS防火墙设置，确保22端口开放，验证网络连接
仓库显示为空白	克隆了空仓库或未正确初始化	使用git init --bare初始化仓库，确保有初始提交
Git操作速度慢	网络延迟或VPS资源不足	优化VPS配置，考虑使用更近的数据中心，检查系统资源使用情况

通过以上步骤，你可以在VPS上成功部署Git服务，建立私有的代码托管环境。这种部署方式特别适合需要完全控制代码仓库、注重数据隐私或希望减少第三方服务依赖的开发场景。