Hermes WebUI远程访问配置：安全地从外部网络连接

Hermes WebUI远程访问配置：安全地从外部网络连接

【免费下载链接】hermes-webuiHermes WebUI: The best way to use Hermes Agent from the web or from your phone!项目地址: https://gitcode.com/GitHub_Trending/he/hermes-webui

Hermes WebUI是一款功能强大的Web界面工具，允许用户通过Web或手机便捷地使用Hermes Agent。本文将详细介绍如何安全地配置Hermes WebUI以实现从外部网络的远程访问，包括基础配置修改、端口转发设置、HTTPS加密以及访问控制等关键步骤，帮助用户轻松实现安全高效的远程连接。

远程访问基础配置修改

要实现Hermes WebUI的远程访问，首先需要修改基础网络配置。在项目的配置文件api/config.py中，我们可以找到网络相关的设置参数。默认情况下，Hermes WebUI仅监听本地回环地址127.0.0.1，这意味着只能在本机访问。要允许外部网络连接，需要将监听地址修改为服务器的实际IP地址或0.0.0.0（表示监听所有可用网络接口）。

# api/config.py HOST = os.getenv("HERMES_WEBUI_HOST", "0.0.0.0") # 修改为0.0.0.0允许所有网络接口访问 PORT = int(os.getenv("HERMES_WEBUI_PORT", "8787")) # 端口号可根据需要修改

通过将HOST设置为0.0.0.0，Hermes WebUI将能够接受来自任何网络接口的连接请求。同时，PORT参数可以根据实际需求进行调整，选择一个未被占用的端口号。修改完成后，保存文件并重启Hermes WebUI服务，使配置生效。

路由器端口转发设置

完成服务器端的基础配置后，还需要在路由器上进行端口转发设置，以便将外部网络请求正确路由到Hermes WebUI所在的服务器。不同品牌和型号的路由器，其端口转发设置界面可能有所不同，但基本原理一致。

首先，登录路由器管理界面，找到“端口转发”或“虚拟服务器”设置选项。然后，添加一条新的端口转发规则，将外部端口（例如8787）映射到服务器的内部IP地址和对应的端口（例如192.168.1.100:8787）。确保协议选择为TCP，因为Hermes WebUI使用HTTP协议进行通信。

设置完成后，外部网络用户就可以通过路由器的公网IP地址和指定的端口号访问Hermes WebUI了。例如，如果路由器的公网IP为203.0.113.1，端口设置为8787，那么访问地址就是http://203.0.113.1:8787。

启用HTTPS加密保护

为了确保远程访问的安全性，强烈建议启用HTTPS加密。Hermes WebUI支持通过环境变量配置TLS证书，实现HTTPS访问。首先，需要获取有效的TLS证书，可以通过Let's Encrypt等免费证书颁发机构申请，也可以使用自签名证书（仅适用于内部测试环境）。

获取证书后，将证书文件（通常是cert.pem和key.pem）放置在安全的位置，然后通过环境变量指定证书路径：

export HERMES_WEBUI_TLS_CERT=/path/to/cert.pem export HERMES_WEBUI_TLS_KEY=/path/to/key.pem

配置完成后，重启Hermes WebUI服务。此时，服务将自动启用HTTPS，外部访问地址变为https://203.0.113.1:8787。通过HTTPS加密，可以有效防止数据在传输过程中被窃听或篡改，提高远程访问的安全性。

访问控制与安全加固

除了基础的网络配置和加密保护，还可以通过访问控制进一步增强Hermes WebUI的安全性。在api/config.py中，提供了密码保护功能，可以通过设置密码哈希来限制访问：

# api/config.py def save_settings(settings: dict) -> dict: # ... raw_pw = settings.pop("_set_password", None) if raw_pw and isinstance(raw_pw, str) and raw_pw.strip(): from api.auth import _hash_password current["password_hash"] = _hash_password(raw_pw.strip()) # ...

通过设置密码，只有知道密码的用户才能访问Hermes WebUI。此外，还可以结合防火墙设置，限制允许访问的IP地址范围，进一步缩小攻击面。例如，在服务器防火墙中只开放必要的端口，并只允许特定IP地址段的访问。

远程访问测试与故障排除

完成上述配置后，需要进行远程访问测试，确保一切正常工作。可以从外部网络的设备上尝试访问Hermes WebUI，如果无法连接，可以按照以下步骤进行故障排除：

1. 检查服务器监听状态：使用netstat或ss命令检查Hermes WebUI是否正在监听正确的地址和端口。

   netstat -tuln | grep 8787

   确保输出中显示0.0.0.0:8787或服务器的实际IP地址。

2. 验证端口转发设置：可以使用在线端口检测工具（如canyouseeme.org）检查路由器端口是否正确转发。

3. 查看服务日志：检查Hermes WebUI的运行日志，查找是否有错误信息。日志文件通常位于STATE_DIR目录下的logs文件夹中。

4. 检查防火墙设置：确保服务器防火墙和路由器防火墙都允许指定端口的入站连接。

如果遇到HTTPS相关问题，可以检查证书文件路径是否正确，以及证书是否有效。对于自签名证书，可能需要在客户端浏览器中添加例外才能正常访问。

Hermes WebUI界面预览

成功配置远程访问后，用户可以通过浏览器访问Hermes WebUI，享受便捷的操作体验。以下是Hermes WebUI的界面预览，展示了会话管理和工作区文件管理功能：

上图显示了Hermes WebUI的会话管理界面，左侧是会话列表，中间是聊天窗口，右侧是工作区文件浏览器。用户可以轻松管理多个会话，查看和发送消息，并浏览工作区中的文件。

上图展示了工作区文件管理功能，用户可以查看工作区中的文件列表，上传新文件，并与Hermes Agent交互处理文件内容。通过远程访问，用户可以随时随地管理和处理工作区文件，提高工作效率。

通过本文介绍的配置步骤，用户可以安全地从外部网络访问Hermes WebUI，享受便捷的远程操作体验。在配置过程中，务必注意安全性，启用HTTPS加密并设置访问控制，以保护敏感数据和系统安全。如果遇到问题，可以参考故障排除步骤或查阅项目文档获取更多帮助。

【免费下载链接】hermes-webuiHermes WebUI: The best way to use Hermes Agent from the web or from your phone!项目地址: https://gitcode.com/GitHub_Trending/he/hermes-webui