ShineAcZ

1. 安装 git#

1
sudo apt update
2
sudo apt install git -y

2. 创建裸仓库和网站目录#

我们需要两个目录：一个用来存放 Git 的版本数据（裸仓库），另一个是你的项目文件实际存放的位置（工作目录）。

1
# 1. 创建用于存放裸仓库的目录
2
sudo mkdir -p /var/repo/my-project.git
3

4
# 2. 创建你的网站项目的工作目录
5
sudo mkdir -p /var/www/my-project

• /var/repo/my-project.git：这是裸仓库，我们约定俗成地以 .git 结尾。

• /var/www/my-project：这是你希望文件最终部署到的地方，比如 Nginx 或 Apache 的网站根目录。

3. 初始化裸仓库#

现在，将刚才创建的目录初始化成一个 Git 裸仓库。

1
sudo git init --bare /var/repo/my-project.git

--bare 参数表示创建一个没有工作副本的仓库。

4. 创建 Git 钩子#

这是实现自动部署的核心，创建一个在接收到 push 请求后自动执行的脚本。

1. 进入裸仓库的 hooks 目录：

1
cd /var/repo/my-project.git/hooks

2. 创建一个名为 post-receive 的文件：

1
sudo nano post-receive

3. 在 nano 编辑器中，粘贴以下脚本内容：

1
#!/bin/sh
2

3
# 核心命令：
4
# --work-tree 指向你的网站根目录
5
# --git-dir 指向你的裸仓库目录
6
# -f 参数是强制覆盖，避免冲突
7
# 覆盖后，执行build重新编译
8
git --work-tree=/var/www/my-project --git-dir=/var/repo/my-project.git checkout -f && (cd /www/wwwroot/my-project && pnpm build)

请确保上面的 /var/www/my-project 和 /var/repo/my-project.git 路径与你第二步创建的完全一致。

4. 保存并退出 nano 编辑器 (按 Ctrl + X，然后按 Y，最后按 Enter)。

5. 给这个钩子脚本添加可执行权限，否则 Git 无法运行它：

1
sudo chmod +x post-receive

5. 设置目录权限#

为了让你本地的 Git 能够通过 SSH 推送上来，你需要确保你登录的用户有权限读写这两个目录。假设你通过用户 shine 登录服务器：

1
# 将这两个目录的所有权赋予你的用户
2
sudo chown -R shine:shine /var/repo/my-project.git
3
sudo chown -R shine:shine /var/www/my-project

注意：请将 shine:shine 替换成你的 用户名:用户组。

服务器端的配置到此完成！

1. 初始化本地仓库#

如果你的项目还不是一个 Git 仓库，先进行初始化：

1
# 进入你的项目文件夹
2
cd /path/to/your-project
3

4
git init
5
git add .
6
git commit -m "Initial commit"

2. 添加远程仓库地址#

我们需要告诉本地 Git，服务器上的那个裸仓库是一个“远程目的地”。

执行以下命令：

1
git remote add production ssh://shine@your_server_ip/var/repo/my-project.git

命令中的参数：

• production：这是你给这个远程仓库起的名字，可以叫 live、server 或者任何你喜欢的名字。

• shine：登录服务器的用户名。

• your_server_ip：服务器的公网 IP 地址或域名。

• /var/repo/my-project.git：服务器上裸仓库的绝对路径。

3. 设置 SSH 密钥免密登录#

为了每次 push 时不用输入密码，你应该设置 SSH 密钥。如果已经设置过，可以跳过。

• 本地：执行 ssh-copy-id shine@your_server_ip，它会自动将你的公钥复制到服务器的 ~/.ssh/authorized_keys 文件中（windows 可以使用 git bash 或者可以用手动复制的方式写到authorized_keys文件中）。

• 如果没生成过密钥，先在本地执行 ssh-keygen -t rsa。