在 Linux、Windows 和 macOS 上安装 Hermes Agent 的完整教程

Hermes Agent 是一款轻量级的数据采集与监控代理工具，广泛应用于服务器运维和日志管理场景。无论你的操作系统是 Linux、Windows 还是 macOS，都能通过简洁的步骤快速完成安装。本文将分别介绍三个平台的安装方法，并提供一键安装命令与分步指南。

一、Linux 服务器安装 Hermes Agent

对于大多数 Linux 发行版，可使用以下命令快速安装：

curl -fsSL https://get.hermes-agent.io | sudo bash

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# 使用ghfast.top加速（可选）
curl -fsSL https://ghfast.top/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

或使用 wget：

wget -qO- https://get.hermes-agent.io | sudo bash

更新系统包（推荐）

sudo apt update && sudo apt upgrade -y   # Ubuntu/Debian
sudo yum update -y                        # CentOS/RHEL

执行一键脚本
运行上述 curl 命令后，脚本会自动检测系统架构并下载对应二进制文件。
安装过程中会提示你选择什么？
- 数据存储路径：默认 /var/lib/hermes，可自定义。
- 监听端口：默认 9090，如需修改请输入其他端口号。
- 是否启用自动启动：建议选择 yes，以确保开机自启。
- API Token：若使用云管理平台，需输入从后端获取的 Token。

启动服务并验证

sudo systemctl start hermes-agent
sudo systemctl enable hermes-agent
sudo systemctl status hermes-agent

看到 active (running) 即表示安装成功。

在 PowerShell（管理员模式）中执行：

[System.Net.WebClient]::new().DownloadString('https://get.hermes-agent.io/win.ps1') | iex

右键点击开始菜单，选择“Windows PowerShell（管理员）”。
粘贴并运行一键命令。脚本会自动下载 MSI 安装包并启动安装向导。
安装过程中会提示你选择什么？
- 安装路径：默认 C:Program FilesHermesAgent，可浏览修改。
- 服务账户：建议使用 Local System（本地系统账户）以避免权限问题。
- 防火墙规则：选择“允许应用通过防火墙”，以确保远程连接。
- 是否安装开机启动项：勾选后 agent 随系统启动。
完成安装后验证
打开“服务”管理器（services.msc），找到 Hermes Agent，状态应显示“正在运行”。也可在命令行输入：
```
sc query HermesAgent
```
输出应包含 STATE : 4 RUNNING。

brew install hermes-community/hermes-agent/hermes-agent

此命令会自动处理依赖与权限配置。

安装 Homebrew（如未安装）

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

执行 Homebrew 安装命令。
安装过程中会提示你选择什么？
- 安装位置：Homebrew 默认安装到 /usr/local/Cellar，无需手动选择。
- plist 文件生成：安装后系统会提示是否允许 hermes-agent 作为后台服务，选择“允许”。
- 环境变量配置：Homebrew 自动添加路径，无需额外操作。
启动并验证
```
brew services start hermes-agent
brew services list | grep hermes
```
如输出中显示 started 即成功。也可通过图形界面“活动监视器”查看进程。

权限不足：Linux 和 macOS 必须使用 sudo，Windows 必须以管理员运行 PowerShell。
防火墙端口：确保安装时选择的端口（默认 9090）未被其他服务占用。
卸载方法：
- Linux：sudo apt remove hermes-agent 或 sudo yum remove hermes-agent
- Windows：控制面板“程序和功能”中卸载
- macOS：brew uninstall hermes-agent
日志查看：若安装后 agent 未启动，可查看日志：
- Linux：/var/log/hermes/agent.log
- Windows：事件查看器 → Windows 日志 → 应用程序
- macOS：/usr/local/var/log/hermes-agent.log