三亩地 三亩地SAN MU DI · CODE DIARY
交流投稿
ARTICLE DETAIL

日记详情

真实记录编程学习的某一天，欢迎挑你感兴趣的翻一翻。

首页/学习日记/日记详情

阿里云服务器搭建Git私有仓库：从零到一实现代码自动化部署

发布时间：2026/8/16 5:52:54 三亩地 编程学习日记
阿里云服务器搭建Git私有仓库：从零到一实现代码自动化部署

1. 项目概述与核心价值

最近在帮几个刚入行的朋友搭建开发环境，发现一个挺普遍的现象：很多人本地代码写得挺溜，但一到要把项目部署到服务器上，或者想和团队协作，就卡在了第一步——怎么在服务器上建个代码仓库，再把本地代码传上去。他们要么去搜各种零散的教程，要么干脆用FTP手动传文件，版本管理一塌糊涂。这让我想起自己刚接触服务器和Git的时候，也走过不少弯路。所以，今天我就以最常用的阿里云服务器为例，手把手带你走一遍从零开始，在服务器上创建Git仓库并完成代码上传的完整流程。这不仅仅是几个命令的堆砌，我会把每一步背后的逻辑、可能遇到的坑以及我积累的一些实用技巧都揉碎了讲清楚。无论你是前端、后端还是运维新手，只要跟着这篇“保姆级”图文教程操作一遍，就能彻底掌握这个开发者必备的核心技能，让你在服务器上管理代码像在本地一样自如。

这个过程的核心价值在于实现代码的集中化、版本化管理与自动化部署的基石。想象一下，你不再需要手动对比服务器和本地的文件差异，也不用担心误删了某行关键代码无法找回。通过在服务器上建立一个“源”仓库，你本地每次git push上去的，都是一个完整的、带历史记录的项目快照。这对于个人项目的备份、团队协作开发，乃至后续衔接Jenkins、Docker等自动化部署流程，都是必不可少的第一步。很多人觉得在服务器上操作Git很“高级”或“复杂”，其实它的核心逻辑和你本地使用Git并无二致，只是换了个“场地”而已。接下来，我们就从最基础的准备环节开始。

2. 前期准备与环境检查

在开始敲命令之前，充分的准备工作能避免你做到一半发现缺这少那，白白浪费时间。这个阶段的目标是确保你的“舞台”（阿里云服务器）和“工具”（本地环境）都就位。

2.1 阿里云服务器基础配置确认

首先，你得有一台已经购买并启动的阿里云服务器（ECS或轻量应用服务器均可）。登录到阿里云控制台，找到你的服务器实例，我们需要确认几个关键信息：

  1. 服务器公网IP地址：这是你连接服务器的“门牌号”。在实例详情页可以找到。
  2. 操作系统：确认是Linux发行版（如CentOS、Ubuntu、Alibaba Cloud Linux）还是Windows。本教程将以最普及的CentOS 7.x或Ubuntu 20.04为例进行讲解，因为绝大多数生产环境都使用Linux。如果你用的是Windows Server，思路相通，但部分命令和路径会不同。
  3. 登录方式：确保你知道如何远程登录。通常使用SSH密钥对或密码。我强烈推荐使用SSH密钥对登录，它比密码更安全，且配置好后无需每次输入密码。在控制台你可以创建或绑定已有的密钥对。

注意：新购买的服务器，防火墙（如firewalld或iptables）和安全组（阿里云网络层面的防火墙）可能会默认阻止外部访问。为了后续Git服务能正常通信，你需要确保服务器安全组的入方向规则放行了SSH（22端口）以及我们将要使用的Git协议端口（默认9418，但通常我们走SSH或HTTP，所以22或80/443端口需开放）。如果你只是测试，可以暂时放行所有端口（0.0.0.0/0），但生产环境务必按需配置。

2.2 本地Git客户端安装与基础配置

你的个人电脑是本次操作的“控制中心”。你需要安装Git并做简单配置。

  • Windows用户：直接到 Git 官网 下载安装程序，一路“Next”即可。安装完成后，你会在开始菜单找到“Git Bash”，这是一个模拟Linux命令行的工具，我们后续的命令都在这里面执行。
  • macOS用户：通常系统已预装，打开“终端”（Terminal），输入git --version检查。如果没有，安装Xcode Command Line Tools（xcode-select --install）或使用Homebrew（brew install git）安装。
  • Linux用户：使用包管理器安装，例如Ubuntu/Debian系：sudo apt-get update && sudo apt-get install git -y；CentOS/RHEL系：sudo yum install git -y。

安装完成后，打开你的命令行工具（Windows用Git Bash，macOS/Linux用终端），进行全局身份配置，这信息会记录在你每次的提交记录里：

git config --global user.name "你的名字" git config --global user.email "你的邮箱"

例如：git config --global user.name "John Doe"和git config --global user.email "john@example.com"。

2.3 服务器基础软件安装与用户规划

现在，通过SSH连接到你的阿里云服务器。假设你的服务器公网IP是123.123.123.123，登录用户是root（生产环境建议使用普通用户，此处为演示方便使用root）：

ssh root@123.123.123.123

输入密码或使用密钥对登录。

登录成功后，第一件事是更新系统软件包列表并安装必要的软件。我们需要Git（服务器端也需要）和一个用于创建仓库的目录。

  • 对于CentOS/Alibaba Cloud Linux:

    yum update -y yum install -y git

  • 对于Ubuntu/Debian:

    apt-get update apt-get install -y git

安装完成后，验证一下：git --version。

接下来，规划一个目录用来存放所有的Git仓库。一个清晰的结构有助于后期管理。我习惯在/var下创建一个repos目录，并为每个项目创建子目录。

mkdir -p /var/repos

但是，直接使用root用户操作和存放仓库存在安全风险。最佳实践是创建一个专门的系统用户（例如叫git）来管理所有仓库，并设置合适的权限。

# 创建git用户，并指定其家目录为 /var/repos useradd -r -m -d /var/repos git # 切换到git用户 su - git

此时，你的命令行提示符应该从root@...变成了git@...，表示你现在在以git用户身份操作。后续的仓库创建操作，我们都将在这个用户下进行，这样更安全，权限也更清晰。

3. 服务器端Git仓库创建与配置详解

这是整个流程的核心环节。我们要在服务器上创建一个“裸仓库”（bare repository）。裸仓库没有工作区，它只保存Git的版本历史记录，专门用于接收推送（push）。你可以把它理解为一个中央存储库。

3.1 创建裸仓库并理解其结构

假设我们的项目叫my-awesome-project。在git用户的家目录（/var/repos）下执行：

# 确保当前在 /var/repos 目录下 cd ~ # 创建一个裸仓库，约定以 .git 结尾 git init --bare my-awesome-project.git

命令成功执行后，你会看到Initialized empty Git repository in /var/repos/my-awesome-project.git/的提示。

现在，查看一下这个目录的结构：

ls -la my-awesome-project.git/

你会看到类似这样的文件结构：

HEAD config description hooks/ info/ objects/ refs/

这就是一个裸仓库的标准结构。hooks/目录特别重要，里面可以放置一些钩子脚本，比如在有人push代码后自动触发部署（这是我们未来实现自动化部署的关键）。config文件存放了这个仓库的配置信息。

3.2 配置仓库权限与SSH密钥认证

为了让你的本地电脑能通过SSH推送代码，你需要将本地电脑的SSH公钥添加到服务器git用户的授权列表中。

  1. 在本地电脑生成SSH密钥对（如果还没有的话）： 在你的本地Git Bash或终端中执行：

    ssh-keygen -t rsa -b 4096 -C "你的邮箱"

    连续按回车，接受默认保存路径（~/.ssh/id_rsa）和空密码（为方便，也可设置密码提高安全性）。完成后，在~/.ssh/目录下会生成两个文件：id_rsa（私钥，绝不可泄露）和id_rsa.pub（公钥）。

  2. 查看并复制公钥：

    cat ~/.ssh/id_rsa.pub

    复制输出的全部内容，它看起来像这样：ssh-rsa AAAAB3NzaC1yc2E...xxx... your-email@example.com。

  3. 将公钥添加到服务器git用户的authorized_keys文件中： 回到服务器的SSH连接窗口（确保在以git用户操作），执行：

    # 如果 .ssh 目录不存在则创建 mkdir -p ~/.ssh # 将公钥内容写入 authorized_keys 文件 echo "你刚才复制的公钥内容" >> ~/.ssh/authorized_keys # 设置正确的权限，这一步非常重要！ chmod 700 ~/.ssh chmod 600 ~/.ssh/authorized_keys

    实操心得：权限设置错误是导致SSH密钥登录失败的最常见原因。.ssh目录权限必须是700，authorized_keys文件权限必须是600。很多教程会忽略这一步，导致你后面git push时一直提示权限被拒绝（Permission denied）。

  4. 测试SSH连接： 在本地电脑的终端里，测试是否能免密登录到服务器的git用户：

    ssh git@123.123.123.123

    如果配置正确，你应该能直接登录到服务器的git用户命令行，而无需输入密码。输入exit退出。

3.3 探索Git钩子（Hooks）的初步应用

虽然完整的自动化部署是更高级的话题，但我们可以先体验一下Git钩子的威力。比如，我们想在任何开发者向master分支推送代码时，在服务器上自动打印一条日志。

进入仓库的hooks目录，并创建一个post-receive钩子脚本（这个钩子在每次成功接收推送后执行）：

# 在服务器上操作，切换到仓库hooks目录 cd /var/repos/my-awesome-project.git/hooks # 创建 post-receive 脚本 cat > post-receive << 'EOF' #!/bin/bash echo "[$(date)] 代码已推送至仓库 $(pwd)" >> /var/repos/push.log EOF # 赋予脚本执行权限 chmod +x post-receive

现在，每次有推送发生时，时间戳和仓库路径都会被记录到/var/repos/push.log文件中。这是一个最简单的钩子应用，它为你打开了自动化的大门，你可以在这个脚本里做任何事，比如触发一个部署脚本、发送通知等。

4. 本地项目初始化与远程推送实战

服务器端的仓库准备好了，现在我们把视线转回本地。假设你已经在本地有一个项目目录，或者准备新建一个。

4.1 本地项目初始化与首次提交

打开你的本地终端，进入项目目录。如果是一个新项目：

mkdir my-awesome-project-local cd my-awesome-project-local # 初始化本地Git仓库 git init # 创建一个简单的文件，比如README echo "# My Awesome Project" > README.md # 将文件添加到暂存区 git add README.md # 提交到本地仓库 git commit -m "Initial commit with README"

至此，你的代码已经保存在了本地的Git版本库中。

4.2 关联远程仓库并理解远程地址

接下来，需要告诉本地仓库，它的“远程中心”在哪里。我们使用git remote add命令来添加一个远程仓库地址。

远程仓库的地址格式是：用户@服务器地址:仓库路径。 在我们的例子中：

  • 用户：git
  • 服务器地址：你的阿里云服务器公网IP，例如123.123.123.123
  • 仓库路径：git用户家目录下的仓库路径，即/var/repos/my-awesome-project.git。注意，由于我们是以git用户登录，所以家目录~就代表/var/repos，因此路径可以简写为my-awesome-project.git。

在本地项目目录下执行：

git remote add origin git@123.123.123.123:my-awesome-project.git

这里的origin是一个别名，你可以随意命名，但origin是约定俗成的默认远程仓库名。

你可以用git remote -v命令查看已配置的远程仓库信息，它会显示推送（push）和拉取（fetch）的地址。

4.3 执行推送与解决首次推送冲突

现在是激动人心的时刻——将本地代码推送到远程服务器。

git push -u origin master

解释一下参数：

  • push：推送命令。
  • -u或--set-upstream：将本地的master分支与远程的origin/master分支关联起来。设置过一次后，以后在这个分支上直接使用git push即可，无需再指定远程和分支名。
  • origin master：推送到名为origin的远程仓库的master分支。

如果一切顺利，你会看到类似下面的输出：

Enumerating objects: 3, done. Counting objects: 100% (3/3), done. Writing objects: 100% (3/3), 227 bytes | 227.00 KiB/s, done. Total 3 (delta 0), reused 0 (delta 0), pack-reused 0 To 123.123.123.123:my-awesome-project.git * [new branch] master -> master Branch 'master' set up to track remote branch 'master' from 'origin'.

同时，你可以回到服务器的SSH窗口，检查我们之前创建的钩子脚本是否生效：

cat /var/repos/push.log

你应该能看到一条最新的推送记录。

常见问题：非快进推送（non-fast-forward）如果你在本地仓库初始化后，又在服务器仓库里手动修改了文件（比如在裸仓库里直接操作，这是错误做法），或者远程仓库已有其他提交历史，那么首次推送可能会失败，提示! [rejected] master -> master (non-fast-forward)。

解决方法：使用git push -f origin master（强制推送，慎用，会覆盖远程历史）。但在我们当前这个从零开始的场景，远程仓库是全新的空仓库，所以不会遇到这个问题。强制推送通常用于修正错误或特定协作流程，在团队协作中滥用会导致他人历史丢失。

5. 进阶配置、问题排查与最佳实践

基础流程走通了，但要想用得顺手、用得安全，还需要了解一些进阶配置和常见问题的处理方法。

5.1 服务器仓库的访问控制与权限管理

我们目前是通过git用户的SSH密钥来认证的。如果有多个团队成员需要推送代码，只需要将他们的SSH公钥也添加到服务器git用户的~/.ssh/authorized_keys文件中即可。

但是，这种所有开发者共用同一个系统用户的方式，在审计上无法区分具体是谁做的操作（日志里都显示是git用户）。对于更精细的权限控制（例如只读、读写不同分支），就需要用到像GitLab、Gitea这样的专业Git服务器软件，它们提供了完善的Web界面、用户管理和权限系统。不过，对于小团队或个人项目，SSH密钥认证的方式简单高效，完全够用。

5.2 本地Git配置优化与别名设置

为了让本地Git用起来更顺手，可以做一些配置优化：

  1. 设置默认编辑器：如果你不喜欢Vim，可以改成VSCode或Nano。

    git config --global core.editor "code --wait" # VSCode # 或 git config --global core.editor "nano"

  2. 创建命令别名：将常用长命令缩短。

    git config --global alias.co checkout git config --global alias.br branch git config --global alias.ci commit git config --global alias.st status git config --global alias.unstage 'reset HEAD --' git config --global alias.last 'log -1 HEAD'

    配置后，你就可以用git st代替git status，用git co -b new-feature代替git checkout -b new-feature，效率提升显著。

  3. 优化推送行为：设置push.default为simple（Git 2.0后默认），这是一种更安全的推送模式。

    git config --global push.default simple

5.3 高频问题排查清单

在实际操作中，你可能会遇到以下问题，这里提供一个快速排查指南：

问题现象可能原因解决方案
ssh: connect to host 123.123.123.123 port 22: Connection timed out1. 服务器IP错误
2. 服务器未运行
3. 安全组/防火墙未开放22端口
4. 本地网络问题		1. 检查IP地址
2. 登录阿里云控制台查看实例状态
3. 检查安全组规则，添加入方向允许SSH(22)
4. 尝试ping服务器IP
Permission denied (publickey).1. 未将本地公钥添加到服务器authorized_keys
2.authorized_keys文件权限错误
3. 服务器sshd配置禁止密钥登录		1. 核对公钥内容是否完整添加
2. 确保~/.ssh权限700，authorized_keys权限600
3. 检查/etc/ssh/sshd_config中PubkeyAuthentication yes
fatal: '/var/repos/my-project.git' does not appear to be a git repository1. 远程仓库路径错误
2. 仓库目录不存在
3. 当前用户对仓库目录无读取权限		1. 仔细检查git remote add时的路径
2. 登录服务器确认仓库目录存在
3. 使用ls -la检查目录权限，确保git用户有权访问
error: failed to push some refs to ...1. 远程仓库有本地没有的新提交（非快进）
2. 分支被保护（如GitLab配置）		1. 先执行git pull origin master --rebase合并远程更改，再推送
2. 检查远程仓库的权限设置
git push每次仍需输入密码1. 未使用SSH密钥认证，走了HTTPS方式
2. SSH密钥对未加载或需要密码		1. 检查远程地址是git@server...(SSH)还是https://...
2. 使用ssh-add ~/.ssh/id_rsa添加密钥到代理（如果密钥有密码）

5.4 从服务器克隆现有仓库

现在，你的代码已经安全地存在于阿里云服务器上了。你可以在另一台电脑上，或者团队的新成员，通过一个简单的命令获取整个项目及其完整历史：

git clone git@123.123.123.123:my-awesome-project.git

这条命令会在当前目录下创建一个my-awesome-project的文件夹，里面包含了最新的代码和所有版本信息。这就是分布式版本控制的魅力所在，每个克隆都是一个完整的备份。

5.5 安全加固与维护建议

  1. 禁用git用户的Shell登录：为了安全，可以限制git用户只能用于Git操作，而不能获得一个完整的系统Shell。编辑/etc/passwd文件，找到git用户那一行，将其最后的/bin/bash改为/usr/bin/git-shell（需要确保git-shell已安装，通常随Git一起安装）。这样，尝试SSH到git用户时，会直接显示Git相关信息并断开连接，但git push/pull等操作不受影响。
  2. 定期备份仓库：服务器上的仓库目录（/var/repos）就是最重要的资产。你可以使用tar命令定期打包备份，或者使用rsync同步到另一台机器。
    # 简单备份示例 tar -czf /backup/git-repos-$(date +%Y%m%d).tar.gz /var/repos
  3. 保持系统更新：定期运行yum update或apt-get upgrade来更新系统和Git软件，修复安全漏洞。

走到这里，你已经成功地在阿里云服务器上搭建了一个私有的、可通过SSH访问的Git中央仓库，并完成了本地代码的推送和克隆的全流程。这套组合拳为你个人的代码管理、小团队的协作开发打下了坚实的基础。它轻量、简单、完全可控，不依赖于任何第三方平台。更重要的是，通过亲手走通这个过程，你理解了Git远程协作的基本模型，这对于你后续理解更复杂的Git工作流、集成CI/CD工具都有着直接的帮助。下次当你需要快速搭建一个临时的代码共享点，或者为一个小型项目建立版本控制时，不妨就试试这个方法。

编程学习 学习日记 实战经验
← 返回列表