HermesAgent网关可通过四种方式停止：一、系统服务命令（如systemctl stop或Stop-Service）；二、进程ID强制终止（kill -9或taskkill）；三、HTTP管理端点POST请求触发优雅关闭；四、停止承载环境（Docker容器或虚拟机）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已成功启动HermesAgent网关服务，但当前需要终止其运行以进行配置调整、端口释放或故障排查，则需通过系统级命令或管理界面明确停止该服务进程。以下是多种可行的停止方法：
一、通过系统服务管理命令停止
该方法适用于以systemd（Linux）或Windows服务方式注册并运行的HermesAgent网关，可确保服务状态被正确标记为“stopped”，并触发相关清理逻辑。
1、在Linux系统中，确认服务名称是否为hermes-agent-gateway或类似命名，执行：sudo systemctl stop hermes-agent-gateway
2、验证服务状态：sudo systemctl is-active hermes-agent-gateway，返回inactive即表示已停止
3、若使用SysV init脚本，执行：sudo service hermes-agent-gateway stop
4、在Windows中，以管理员身份打开PowerShell，执行：Stop-Service -Name "HermesAgentGateway" -Force
二、通过进程ID强制终止
当网关未注册为系统服务，而是以独立进程（如Python脚本或Java应用）前台/后台运行时，需定位并终止其主进程。此方法直接有效，但不触发服务级生命周期钩子。
1、在Linux/macOS中，执行：lsof -i :8080 | grep LISTEN（假设监听8080端口），记录PID列数值
2、执行：kill -9 记录的PID
3、在Windows中，执行：netstat -ano | findstr :8080，获取对应PID
4、执行：taskkill /PID 记录的PID /F
三、通过HermesAgent内置HTTP管理端点停止
若网关启用了管理端点（默认路径为http://localhost:8080/actuator/shutdown，需application.yml中启用endpoints.shutdown.enabled=true），可通过HTTP请求触发优雅关闭流程，包括连接 draining 和内存清理。
1、确认management.endpoints.web.exposure.include=health,info,shutdown已在配置文件中启用
2、使用curl发送POST请求：curl -X POST http://localhost:8080/actuator/shutdown
3、若返回{"message":"Shutting down"}，表示关闭指令已接收
4、等待5–10秒后，检查端口监听状态：lsof -i :8080 或 netstat -ano | findstr :8080，应无输出
四、通过关闭承载环境容器或虚拟机
当HermesAgent网关部署于Docker容器或专用虚拟机中时，停止其运行环境等效于停止网关服务本身，且能彻底释放所有关联资源。
1、若运行于Docker中，执行：docker ps | grep hermes，获取CONTAINER ID
2、执行：docker stop CONTAINER ID
3、若部署于独立虚拟机（如WSL2实例），在宿主机中执行：wsl --terminate Ubuntu（替换为实际发行版名称）
4、若使用云平台网关实例（如AWS Storage Gateway），进入控制台，选择对应网关，点击Actions → Stop gateway
