Ssh Vps Manage

# SSH VPS Manage

This skill focuses on **统一用 `~/.ssh/vps` 公钥连接**，并把连接信息写入 `~/.ssh/vps.config`（由 `~/.ssh/config` 通过 `Include ~/.ssh/vps.config` 引入）。
默认不走外部 ssh-agent（例如 1Password / Secretive 等 agent）。

## 标准流程与安全契约（重要）
新机初始化的安全顺序，**务必按此执行**：
1. `init-key`（首次，本地生成 `~/.ssh/vps`，已存在则跳过）
2. `add <alias> <host> --password '<pw>'`（存别名 + 下发公钥）
3. `<alias>` 或 `status <alias>`：**验证密钥能登**
4. 确认能登后才 `lock <alias>`（关闭密码登录）；如需改端口再 `port <alias> [newport]`

- `lock` / `port` 是**破坏性、修改远端 sshd 的操作**，执行前必须先确认密钥可登；脚本本身也会先验证，验证不过会拒绝执行、不会把人锁在门外。
- 命令成功以 `OK:` / `Done:` 前缀输出，失败以 `FAIL:` / `ERROR:` 或非零退出码表示——据此判断结果。
- `port` 改端口前请提醒用户：**检查服务商安全组/外部防火墙是否放行新端口**，否则本机配好也连不上（脚本会实测新端口、连不上自动回滚到旧端口）。

## 目录
- `scripts/ssh-vps.sh`：增删查改别名、同步 key、直连。

## 使用方式（主命令）
```bash
bash skills/ssh_vps_manage/scripts/ssh-vps.sh help
```

## 常用命令

### 生成本地密钥（首次）
```bash
bash skills/ssh_vps_manage/scripts/ssh-vps.sh init-key
```
非交互生成 `~/.ssh/vps`（ed25519），已存在则不覆盖。

### 列表
```bash
bash skills/ssh_vps_manage/scripts/ssh-vps.sh list
```

### 新增 / 更新别名（默认 key 连接）
```bash
bash skills/ssh_vps_manage/scripts/ssh-vps.sh add <alias> <host> --user root --port 22
```

### 新增别名并写入公钥（提供密码时）
```bash
bash skills/ssh_vps_manage/scripts/ssh-vps.sh add <alias> <host> --user root --port 22 --password '<password>'
```

### 删除别名
```bash
bash skills/ssh_vps_manage/scripts/ssh-vps.sh rm <alias>
```

### 同步公钥到远端（默认目标为 key + 端口）