部署步骤#

1
Add-WindowsCapability -Online -Name OpenSSH.Server~~~~0.0.1.0
2
Start-Service sshd
3
Set-Service -Name sshd -StartupType 'Automatic'

1
cd "C:\Program Files\OpenSSH"
2
.\install-sshd.ps1
3
Start-Service sshd
4
Set-Service -Name sshd -StartupType 'Automatic'

1
New-NetFirewallRule -Name "Raw-Port-22-Allow" -DisplayName "Absolute Allow Port 22" -Enabled True -Direction Inbound -Protocol TCP -Action Allow -LocalPort 22 -Profile Any

1
# 将 DefaultShell 指向 Git Bash 的完整路径
2
New-ItemProperty -Path "HKLM:\SOFTWARE\OpenSSH" -Name DefaultShell -Value "C:\Program Files\Git\bin\bash.exe" -PropertyType String -Force
3

4
# 重启服务生效
5
Restart-Service sshd

1
mkdir D:\GitRepos\my-project.git
2
cd D:\GitRepos\my-project.git
3
git init --bare

1
# 克隆仓库 (注意：Windows 盘符 D:/ 在 Bash 中表示为 /d/)
2
git clone user@192.168.9.100:/d/GitRepos/my-project.git
3

4
# 进入目录，提交代码并推送
5
cd my-project
6
git add .
7
git commit -m "Initial commit"
8
git push -u origin master

高阶安全配置（可选）：SSH 密钥免密登录#

为了安全与便捷，建议废弃密码登录，改用 Ed25519 密钥认证。

1. 客户端生成密钥并推送：

1
ssh-keygen -t ed25519 -C "Client-Device"
2
ssh-copy-id user@192.168.9.100

2. 服务端修复管理员组权限坑（关键）： 以管理员权限打开 C:\ProgramData\ssh\sshd_config，将文件最底部的这两行注释掉：

1
# Match Group administrators
2
#       AuthorizedKeysFile __PROGRAMDATA__/ssh/administrators_authorized_keys

3. 彻底关闭密码登录： 在同一个 sshd_config 文件中，找到并修改为：

1
PasswordAuthentication no

保存后，在管理员 PowerShell 中执行 Restart-Service sshd 重启服务。

日常推送：如何编写 git push 命令#

在本地完成代码的 commit 后，需要通过 push 命令同步到 Windows 服务器。

1. 绑定远程地址（首次配置）： 将服务器地址命名为 origin。

1
git remote add origin user@192.168.9.100:/d/GitRepos/my-project.git

2. 首次推送并绑定分支： 使用 -u 参数将本地的 master（或 main）与服务器分支建立永久关联。

1
git push -u origin master

3. 日常极简推送： 后续完成代码提交后，只需执行即可自动推送到默认关联的服务器：

1
git push

附加高频命令：

• 推送到指定分支：git push origin feature-dev
• 强制覆盖服务器（慎用）：git push -f origin master

多端托管：如何将代码同步提交到 GitHub#

将代码同时托管在私有 Windows 服务器和 GitHub 上，可实现双重本地与云端备份。

1. 在 GitHub 上创建一个完全为空的仓库（切勿勾选初始化 README 或 .gitignore）。
2. 方案 A：作为独立的辅助远程仓库（按需分别推送）

1
# 添加 GitHub 地址并命名为 github
2
git remote add github git@github.com:YourName/my-project.git
3

4
# 单独向 GitHub 推送代码
5
git push -u github master

3. 方案 B：配置“一键双推” (Dual Push)

修改 origin 的推送规则列表，实现一次 git push 命令同时将代码发往两个服务器：

1
# 显式添加原有的 Windows 服务器推送地址
2
git remote set-url --add --push origin user@192.168.9.100:/d/GitRepos/my-project.git
3

4
# 叠加添加 GitHub 的推送地址
5
git remote set-url --add --push origin git@github.com:YourName/my-project.git

权限管理：如何为新设备新增 SSH Key#

由于服务器已彻底关闭密码登录，新设备无法直接使用常规的 ssh-copy-id 命令。可通过以下两种方式授权新设备的公钥：

• 方法 1：在 Windows 服务器上直接修改（最直观防错）

通过 RDP 或直接在服务器上，使用记事本打开 C:\Users\<你的Windows用户名>\.ssh\authorized_keys。将新设备生成的 id_ed25519.pub 公钥内容另起一行粘贴并保存。

• 方法 2：通过已授权的老设备远程追加（命令行操作）

在已经拥有免密权限的旧设备终端中执行以下命令（利用管道流和追加重定向 >> 写入）：

1
echo 'ssh-ed25519 AAAAC3NzaC...你的新设备公钥... New-Device' | ssh user@192.168.9.100 "cat >> ~/.ssh/authorized_keys"

地址管理：如何替换当前设定的 remote 地址#

当 Windows 服务器的局域网 IP 发生变动，或者配置了内网穿透换用公网域名时，需要更新本地关联的远程地址。

1. 直接修改当前 URL：

1
git remote set-url origin user@new-domain.com:/d/GitRepos/my-project.git

2. 验证修改结果：

1
git remote -v

如果终端输出列表中 (fetch) 和 (push) 对应的地址已更新为你设置的新 URL，即代表替换成功。

自动化部署：在 Windows 服务器配置 Git Hooks#

在服务端的裸仓库中配置 post-receive 钩子，可以在代码 push 成功后自动执行代码解包、重启服务或运行特定脚本等 CI/CD 动作。由于之前已将 Windows OpenSSH 的默认 Shell 改为了 Git Bash，我们可以直接使用极其方便的 Linux Bash 语法来编写这个钩子。

1. 创建 Hook 脚本文件

进入 Windows 服务器上裸仓库的 hooks 目录（例如 D:\GitRepos\my-project.git\hooks）。 在该目录下新建一个无任何后缀名的文本文件，严格命名为 post-receive（切勿带 .txt 或 .sh 等后缀，否则 Git 无法识别）。

⚠️ Windows 核心踩坑预警： 在使用编辑器（如 VS Code 或 Notepad++）保存此文件时，必须确保：

• 换行符：强制设为 Linux 风格的 LF (\n)，绝不能用 Windows 默认的 CRLF (\r\n)。
• 编码格式：强制设为 UTF-8（不要带 BOM）。

2. 编写自动化部署脚本

打开 post-receive 文件，你可以使用以下经典模板。该脚本会在每次收到推送后，自动将纯数据裸仓库里的代码，提取（Checkout）到一个真实的运行目录中：

1
#!/bin/bash
2

3
# 1. 定义你的真实工作目录（代码解包后实际运行的地方，路径必须使用正斜杠 /）
4
TARGET_DIR="D:/Deployments/my-project"
5

6
# 2. 如果目标目录不存在，则自动创建
7
if [ ! -d "$TARGET_DIR" ]; then
8
  mkdir -p "$TARGET_DIR"
9
fi
10

11
echo "==============================================="
12
echo "🚀 收到最新代码，正在 Windows 服务器上自动部署..."
13

14
# 3. 核心命令：将裸仓库的代码强制检出（checkout）到真实工作目录
15
git --work-tree="$TARGET_DIR" --git-dir="D:/GitRepos/my-project.git" checkout -f master
16

17
echo "📦 代码解包完成！存放在: $TARGET_DIR"
18

19
# ---------------------------------------------------------
20
# 4. 在这里可以继续追加你需要自动执行的后续任务
21
# ---------------------------------------------------------
22
# cd "$TARGET_DIR"
23
# echo "🐍 正在执行 Python 脚本..."
24
# python main.py
25
# 或调用 Windows 系统命令重启服务：
26
# sc stop MyService && sc start MyService
27

28
echo "✅ 自动化部署流水线执行完毕！"
29
echo "==============================================="

3. 触发自动化流水线

保存文件后，不需要重启任何服务。 回到客户端机器上，修改任意代码并执行常规的推送命令：

1
git push origin master

效果验证： 推送进度条走完后，你的客户端终端会直接回显打印出脚本中的 echo 信息（带有 🚀 和 ✅ 的日志）。此时去 Windows 服务器的 D:\Deployments\my-project 目录下查看，你最新提交的代码文件已经自动解包并部署完毕。

常见问题与排查指南#