- name
- hxd-deploy
- description
- 部署霍小钉服务到服务器。自动上传 JAR 文件、备份旧版本、重启服务。
霍小钉服务部署工具
自动化部署霍小钉 Spring Boot 服务到远程服务器。
触发条件
当用户提到以下关键词时自动触发：
- "部署霍小钉"
- "部署 hxd"
- "部署服务"
- "更新霍小钉"
- "发布霍小钉"
- "hxd 部署"
- "霍小钉上线"
部署配置
服务器信息
- IP: 203.170.59.16
- 用户: root
- SSH 私钥:
~/.ssh/id_ed25519
文件路径
- 本地 JAR:
D:\springboot\hxd\ arget\hxd-0.0.1-SNAPSHOT.jar - 远程目录:
/hjxz/hxd-api/lib - 远程脚本:
/hjxz/hxd-api/bin/hxd-api - 日志文件:
/hjxz/hxd-api/logs/wrapper.log
部署步骤
1. Maven 打包（新增）
在上传 JAR 之前，先执行 Maven 打包命令：
cd "D:\springboot\hxd"
mvn clean package -Pprod -DskipTests打包完成后检查生成的 JAR 文件是否存在。
2. 检查本地 JAR 文件
Test-Path "D:\springboot\hxd\ arget\hxd-0.0.1-SNAPSHOT.jar"如果文件不存在，检查 Maven 打包是否成功。
3. SSH 连接测试
ssh -i "$env:USERPROFILE\.ssh\id_ed25519" -o StrictHostKeyChecking=no root@203.170.59.16 "echo 'SSH connection successful'"4. 上传 JAR 文件
$timestamp = Get-Date -Format "yyyy-MM-dd-HH-mm"
scp -i "$env:USERPROFILE\.ssh\id_ed25519" -o StrictHostKeyChecking=no "D:\springboot\hxd\ arget\hxd-0.0.1-SNAPSHOT.jar" "root@203.170.59.16:/hjxz/hxd-api/lib/hxd-0.0.1-SNAPSHOT.jar"5. 备份旧版本并替换
ssh -i "$env:USERPROFILE\.ssh\id_ed25519" -o StrictHostKeyChecking=no root@203.170.59.16 @"
cd /hjxz/hxd-api/lib
mv hxd.jar hxd.jar.bak$timestamp
mv hxd-0.0.1-SNAPSHOT.jar hxd.jar
"@6. 重启服务
ssh -i "$env:USERPROFILE\.ssh\id_ed25519" -o StrictHostKeyChecking=no root@203.170.59.16 "/hjxz/hxd-api/bin/hxd-api restart"7. 验证服务状态
# 检查服务状态
ssh -i "$env:USERPROFILE\.ssh\id_ed25519" -o StrictHostKeyChecking=no root@203.170.59.16 "cat /hjxz/hxd-api/bin/hxd-api.status"
# 检查日志（最近 30 行）
ssh -i "$env:USERPROFILE\.ssh\id_ed25519" -o StrictHostKeyChecking=no root@203.170.59.16 "tail -30 /hjxz/hxd-api/logs/wrapper.log"输出要求
部署完成后报告：
- ✅ JAR 文件上传状态
- ✅ 备份文件名称（带时间戳）
- ✅ 服务重启状态（PID、状态）
- ✅ 服务运行状态（从日志确认）
- ⚠️ 任何警告或错误信息
错误处理
常见问题
- SSH 连接失败
- 检查私钥文件是否存在 - 检查服务器是否可达 - 提示用户检查网络或 SSH 配置
- JAR 文件不存在
- 提示用户先执行 Maven 构建：mvn clean package - 检查构建路径是否正确
- 服务启动失败
- 查看完整日志：tail -100 /hjxz/hxd-api/logs/wrapper.log - 检查端口占用：netstat -tlnp | grep 9999 - 检查磁盘空间：df -h
- 备份失败
- 检查文件权限 - 检查磁盘空间
示例对话
用户: 部署一下霍小钉服务
助手: 好的，开始部署霍小钉服务...
- ✅ JAR 文件已上传
- ✅ 旧版本备份为 hxd.jar.bak2026-03-25-16-56
- ✅ 服务已重启，PID: 21499，状态：STARTED
- ✅ 服务正常运行，端口 9999
部署完成！🫘
注意事项
- 部署时间: 避免在业务高峰期部署（工作日 9:00-18:00）
- 备份保留: 保留最近 2-3 个备份版本，避免磁盘占满
- 日志检查: 每次部署后必须检查日志确认服务正常
- 回滚方案: 如需回滚，将备份文件改名为 hxd.jar 后重启服务
快速回滚命令
# 回滚到上一个版本
ssh -i "$env:USERPROFILE\.ssh\id_ed25519" -o StrictHostKeyChecking=no root@203.170.59.16 @"
cd /hjxz/hxd-api/lib
ls -lt hxd.jar.bak* | head -1 | awk '{print \$NF}' | xargs -I {} cp {} hxd.jar
/hjxz/hxd-api/bin/hxd-api restart
"@