需在aws或gcp云服务器上部署hermes agent,步骤包括:一、创建满足要求的linux实例并开放8080/9090端口;二、安装openssl等运行时依赖并设utc时区;三、下载二进制文件并sha256校验;四、通过toml配置服务参数。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您希望在云服务器上运行Hermes Agent以实现自动化任务调度或消息路由,需根据云平台特性完成环境配置、依赖安装与服务注册。以下是针对AWS和GCP两种主流云平台的部署步骤:
一、准备云服务器实例
在AWS或GCP中创建具备基础计算能力与网络连通性的Linux虚拟机,确保系统满足Hermes Agent最低运行要求(如glibc 2.28+、OpenSSL 1.1.1+)。该步骤为后续所有操作提供运行载体。
1、登录AWS EC2控制台,选择“启动实例”,选用Amazon Linux 2023或Ubuntu 22.04 LTS AMI。
2、在GCP Compute Engine中点击“创建实例”,操作系统选择Ubuntu 22.04 LTS,机器类型设为e2-medium及以上规格。
3、为实例分配静态外部IP,并在安全组/防火墙规则中开放TCP端口8080和9090(Hermes Agent默认HTTP管理端口与内部通信端口)。
二、安装运行时依赖
Hermes Agent基于Rust构建,但预编译二进制包依赖标准C运行时及TLS库,需显式安装底层系统组件。
1、连接至实例后执行:sudo apt update && sudo apt install -y curl wget libssl1.1 libcurl4 tzdata(Ubuntu)或sudo dnf install -y curl wget openssl-libs libcurl glibc-langpack-en(Amazon Linux)。
2、验证OpenSSL版本:openssl version,输出必须为OpenSSL 1.1.1f或更高版本。
3、设置系统时区为UTC:sudo timedatectl set-timezone UTC,避免日志时间戳错乱。
三、下载并验证Hermes Agent二进制文件
从官方GitHub Releases获取对应架构的静态链接可执行文件,并通过SHA256校验确保完整性,防止中间劫持或损坏。
1、执行:curl -L -o hermes-agent.tar.gz https://github.com/hermes-org/agent/releases/download/v0.8.3/hermes-agent-x86_64-unknown-linux-gnu.tar.gz。
2、下载校验文件:curl -L -o SHA256SUMS https://github.com/hermes-org/agent/releases/download/v0.8.3/SHA256SUMS。
3、校验命令:sha256sum -c SHA256SUMS --ignore-missing | grep "OK",输出含hermes-agent且状态为OK即表示通过。
四、配置Hermes Agent服务参数
通过TOML格式配置文件定义Agent身份、后端连接地址、心跳间隔等核心行为,避免硬编码参数导致部署不可复现。
1、创建配置目录:sudo mkdir -p /etc/hermes-agent。
2、生成配置文件:sudo tee /etc/hermes-agent/config.toml 。
3、写入内容(替换YOUR_CLOUD_PROVIDER为aws或gcp,YOUR_BACKEND_URL为实际控制平面地址):
[agent]<br>id = "prod-${YOUR_CLOUD_PROVIDER}-$(hostname -s)"<br>backend_url = "https://YOUR_BACKEND_URL"<br>heartbeat_interval_secs = 30<br><br>[tls]<br>insecure_skip_verify = true。
五、注册为系统服务(Systemd方式)
将Hermes Agent进程交由systemd统一管理,实现开机自启、崩溃自动重启及日志归集,符合云环境运维规范。
1、创建服务单元文件:sudo tee /etc/systemd/system/hermes-agent.service 。
2、填入服务定义:
[Unit]<br>Description=Hermes Agent Service<br>After=network.target<br><br>[Service]<br>Type=simple<br>User=root<br>WorkingDirectory=/opt/hermes-agent<br>ExecStart=/opt/hermes-agent/hermes-agent --config /etc/hermes-agent/config.toml<br>Restart=always<br>RestartSec=10<br>StandardOutput=journal<br>StandardError=journal<br><br>[Install]<br>WantedBy=multi-user.target。
3、启用服务:sudo systemctl daemon-reload && sudo systemctl enable hermes-agent && sudo systemctl start hermes-agent。
六、验证服务运行状态
确认进程已启动、端口监听正常且能向后端上报心跳,是部署完成的关键判定依据。
1、检查服务状态:sudo systemctl is-active hermes-agent,返回active表示运行中。
2、查看监听端口:sudo ss -tlnp | grep ':8080\|:9090',应显示LISTEN状态及hermes-agent进程ID。
3、抓取最近日志:sudo journalctl -u hermes-agent -n 20 --no-pager,日志末尾应出现"registered with backend"或"sent heartbeat"字样。











