# 服务器增量部署说明（update-server.bat）

本地 `go/` 目录改动后，只把**改动过的文件**推到服务器，不用再一个个找文件替换。

## 一、用法

在 `go/` 目录下双击 `update-server.bat`，或命令行执行：

```bat
update-server.bat            :: 比对 -> 确认 -> 上传 -> 询问是否重启服务
update-server.bat dry        :: 只比对不上传（先看清单用这个）
update-server.bat restart    :: 只重启服务器服务
```

bat 会在 `go/` 目录下自动编译部署工具 `bin/deploy.exe`，然后：

1. SSH 连上服务器，对 `go/` 目录和服务器目录**各算一遍文件 MD5**
2. 比对出「新增」和「内容变了」的文件并打印清单
3. 确认后把这些文件打包成 tar 通过 SSH 管道传到服务器解包（只传差异文件）
4. 回读服务器指纹复核，确认每个文件都传对了
5. 询问是否 `systemctl restart go-api.service` 让改动生效

## 二、配置

bat 顶部「CONFIG」区：

| 变量 | 说明 |
| --- | --- |
| `DEPLOY_HOST` | 服务器地址 |
| `DEPLOY_USER` | SSH 用户名 |
| `DEPLOY_DIR` | 服务器目录 |
| `DEPLOY_KEY` | 私钥路径（默认 `%~dp010.31.100.2_id_ed25519`） |
| `DEPLOY_PASS` | 密码（备用，服务器开了密码认证时才用） |
| `RESTART_CMD` | 重启命令，默认 `systemctl restart go-api.service` |

> **注意**：这台服务器 sshd 关闭了密码认证（只接受 publickey / gssapi），所以默认走**密钥登录**。
> 如果以后在服务器上开了密码认证，把 `DEPLOY_KEY` 置空、填上 `DEPLOY_PASS` 即可，工具会自动切换。

### 关于私钥

- 私钥放在 `go/10.31.100.2_id_ed25519`，**已被同步工具自动排除**，不会传到服务器。
- Windows 上私钥权限过宽会让 OpenSSH 客户端拒绝加载，已用下面的命令收紧过（只需做一次）：

```bat
icacls "10.31.100.2_id_ed25519" /inheritance:r /grant:r "%USERNAME%:(F)"
```

- `go/.deploy_known_hosts` 记录服务器主机密钥指纹，换服务器时会提示指纹变化（同样被排除，不会上传）。

## 三、不会同步的内容

工具默认跳过：`.git` / `node_modules` / `bin` / `dist` / `tmp`、`*.exe` / `*.log` / `*.bak`、
`nohup.out`、`output.log`、`go.log`、`test-output-*.txt`、`migrate_*.csv`、
无扩展名的 `server` 二进制、`*_id_ed25519` 私钥、`.deploy_known_hosts`。

服务器上存在、本地没有的文件**默认保留不删**（服务器上还有 `.git`、历史二进制等）。
确实要清理就在 bat 里加 `-delete`，但请先想清楚。

## 四、原理

```
本地 go/ ──MD5──┐
                 ├─ 比对 ──> 只传 新增/变更 的文件 ──> 服务器 /www/wwwroot/api.yunzer.cn
服务器   ──MD5──┘                        └── 传完回读远端指纹复核
```

- 服务器是 systemd 的 `go-api.service`，`ExecStart=/usr/local/btgo/bin/go run main.go`，
  **直接用目录里的源码编译运行**，所以传 `.go` 源码即可，重启服务就会重新编译生效。
- 传到服务器的文件属主会被改成目标目录的属主（`www:www`），权限规范成 0644（脚本 0755）。

## 五、常见问题

| 现象 | 处理 |
| --- | --- |
| `Permission denied (publickey,gssapi-...)` | 私钥没配好：检查 `DEPLOY_KEY` 路径，或用 icacls 收紧权限 |
| `本地目录不存在` | 别从别处调用 bat，bat 里用 `%~dp0` 定位自身目录 |
| 上传后服务没生效 | 需要重启：`update-server.bat restart`（或看 go.log 是否有编译错误） |
| 清单里出现奇怪的文件 | 用配置区的 `EXTRA_EXCLUDE` 排除，逗号分隔、支持 `*` |
| 远端提示 md5sum 不存在 | 极老系统没 md5sum，用 `cksum` 也能工作，可改工具里的命令 |

## 六、单独使用部署工具

bat 之外的进阶用法（在 `go/` 目录下）：

```bat
bin\deploy.exe -host 10.31.100.2 -user root -key 10.31.100.2_id_ed25519 ^
  -dir /www/wwwroot/api.yunzer.cn -local . -dry-run     :: 只看差异

bin\deploy.exe -host 10.31.100.2 -user root -key 10.31.100.2_id_ed25519 ^
  -exec "systemctl status go-api.service"                :: 执行远程命令
```

常用参数：`-dry-run` 只比对、`-yes` 跳过确认、`-delete` 同步删除远端多余文件、
`-restart "命令"` 上传后自动重启、`-exclude "a,b"` 额外排除。