PORT | 8648 | Studio 服务监听端口。 |
BIND_HOST | 0.0.0.0 | Studio 服务绑定地址。如需 IPv6，可显式设置为 ::。 |
HERMES_LAN_ADVERTISE_URL | 未设置 | App 局域网二维码使用的可访问 Studio 地址。Docker 中若通过 localhost 打开，请设置为宿主机局域网 URL，例如 http://192.168.1.20:6060。 |
HERMES_APP_ENTITLEMENT_REQUIRED | true | App 局域网 Relay 必须携带有效的云端签名。仅在临时兼容排查时设置为 false。 |
HERMES_APP_ENTITLEMENT_PUBLIC_KEY | 内置 | 可选的 RS256 App 签名 PEM 公钥覆盖。签名 issuer 为 hermes-studio-server，audience 为 ekko-studio。 |
HERMES_WEB_UI_HOME | ~/.hermes-web-ui | Studio 数据目录，用于认证 Token、登录凭据、日志、数据库和默认上传目录。兼容支持 HERMES_WEBUI_STATE_DIR 作为别名。 |
HERMES_WEBUI_STATE_DIR | 未设置 | HERMES_WEB_UI_HOME 的兼容别名。 |
HERMES_WEB_UI_DISABLE_MCP_AUTOINJECT | 未设置 | 关闭启动时向 Hermes profile 配置自动注入托管的 hermes-studio MCP server。 |
HERMES_WEB_UI_ALLOW_TRANSIENT_MCP_AUTOINJECT | 未设置 | 当 HERMES_WEB_UI_HOME 位于临时目录（例如 Version Preview runtime）时，仍允许托管 MCP 自动注入。 |
UPLOAD_DIR | $HERMES_WEB_UI_HOME/upload | 覆盖上传根目录。文件会保存在按 Profile 隔离的子目录下。 |
CORS_ORIGINS | 仅同 host | HTTP、Socket.IO、WebSocket 跨源 allowlist，支持逗号或空格分隔。只有明确需要旧版 wildcard CORS 时才设置为 *。 |
AUTH_TOKEN | 自动生成 | 显式指定 Bearer Token。未设置时，Studio 会在 HERMES_WEB_UI_HOME 下自动生成。 |
AUTH_JWT_SECRET | AUTH_TOKEN | 用户名/密码会话的 JWT 签名密钥覆盖。 |
HERMES_WEB_UI_AUTH_JWT_EXPIRES_IN | 30d | 用户名/密码会话 JWT 有效期。支持秒数或 s/m/h/d 后缀，例如 12h 或 7d。 |
PROFILE | default | 启动/默认 Hermes profile。运行时请求使用前端当前选择且当前账号有权限访问的 Profile。 |
LOG_LEVEL | info | Server 日志级别。 |
BRIDGE_LOG_LEVEL | $LOG_LEVEL 或 info | Bridge 日志级别。 |
MAX_DOWNLOAD_SIZE | 200MB | 最大文件下载大小。 |
MAX_EDIT_SIZE | 10MB | 最大可编辑文件大小。 |
WORKSPACE_BASE | 当前用户 Home 目录 | Workspace 浏览根目录。 |
HERMES_HOME | ~/.hermes | Windows、macOS 和 Linux 上的 Hermes 数据目录。 |
HERMES_BIN | hermes | 自定义 Hermes CLI 二进制路径。 |
HERMES_AGENT_ROOT | 自动发现 | 包含 run_agent.py 的 Hermes Agent 源码目录。 |
HERMES_AGENT_BRIDGE_PYTHON | 自动发现 | 用于启动 agent bridge 的 Python 解释器。 |
HERMES_AGENT_BRIDGE_UV | 自动发现 | 可用时用于启动 agent bridge 的 uv 可执行文件。 |
UV | 自动发现 | uv 可执行文件 fallback。 |
PYTHON | 自动发现 | agent bridge 的 Python 可执行文件 fallback。 |
HERMES_AGENT_BRIDGE_ENDPOINT | 平台默认值 | Agent bridge broker endpoint。Windows 默认 tcp://127.0.0.1:18765；macOS/Linux 默认 ipc:///tmp/hermes-agent-bridge.sock。 |
HERMES_AGENT_BRIDGE_TIMEOUT_MS | 120000 | Node 请求 bridge broker 的响应超时。 |
HERMES_AGENT_BRIDGE_CONNECT_RETRY_MS | 5000 | 连接 bridge socket 失败时的短重试窗口。 |
HERMES_AGENT_BRIDGE_STARTUP_TIMEOUT_MS | 120000 | 等待 Python bridge ready 的超时。 |
HERMES_AGENT_BRIDGE_STOP_ON_SHUTDOWN | 开启 | Studio 关闭和重启时是否停止 Bridge Broker；设为 0、false、no 或 off 才会在重启时保留 Broker。 |
HERMES_AGENT_BRIDGE_AUTO_RESTART | 开启 | bridge broker 意外退出后是否自动重启；设为 0、false、no 或 off 可关闭。 |
HERMES_AGENT_BRIDGE_RESTART_DELAY_MS | 1000 | bridge 自动重启退避的基础延迟。 |
HERMES_AGENT_BRIDGE_PLATFORM | cli | 传给 Hermes Agent 的 platform 标识。 |
HERMES_AGENT_BRIDGE_WORKER_TRANSPORT | 平台默认值 | Profile worker transport。设为 tcp 使用 loopback TCP；设为 ipc/unix 使用 Unix domain socket；默认 Windows TCP、macOS/Linux IPC。 |
HERMES_AGENT_BRIDGE_WORKER_PORT_BASE | 18780 | TCP worker endpoint 起始端口。 |
HERMES_BRIDGE_PROVIDER | profile/默认值 | bridge 运行时的 provider 覆盖。 |
HERMES_BRIDGE_TOOLSETS | profile/默认值 | bridge 运行时的 toolset 覆盖。 |
HERMES_BRIDGE_MAX_TURNS | profile/默认值 | bridge 运行时的最大轮数覆盖。 |
HERMES_BRIDGE_SUPPRESS_PLATFORM_HINT | cli | 控制传给 Hermes Agent 的 bridge platform hint suppression。 |
HERMES_OPENROUTER_APP_REFERER | https://hermes-studio.ai | bridge 运行发送给 OpenRouter 的 attribution referer。 |
HERMES_OPENROUTER_APP_TITLE | Hermes Studio | Bridge 运行发送给 OpenRouter 的 Attribution Title。 |
HERMES_OPENROUTER_APP_CATEGORIES | cli-agent,personal-agent | bridge 运行发送给 OpenRouter 的 attribution categories。 |
HERMES_WEB_UI_MANAGED_GATEWAY | 默认开启 | 控制 Studio 托管 Hermes Gateway 进程；设为 0、false、no 或 off 时改用 hermes gateway start。 |
HERMES_WEB_UI_DISABLE_GATEWAY_AUTOSTART | 未设置 | 跳过启动时的 gateway 检查/自动启动；dashboard-only 部署中如果由其它服务管理 Hermes gateway，可设为 1、true、yes 或 on。 |
HERMES_WEB_UI_DISABLE_SKILL_INJECTION | 未设置 | 跳过启动时的内置 Skill 注入；如果内置 Skills 由 Studio 外部管理，可设为 1、true、yes 或 on。启用注入时，Studio 只更新自己此前安装的 Skills 或内容完全相同的既有内置副本；本地修改和用户拥有的同名 Skills 会跳过。 |
HERMES_WEB_UI_STOP_GATEWAYS_ON_SHUTDOWN | 默认开启 | Studio 关闭时仅停止由当前 Studio 进程启动并登记的 Gateway；设为 0 或 false 可让它们分离运行。外部探测到的 Gateway 不会被收编或关闭。 |
HERMES_WEB_UI_SHUTDOWN_FORCE_EXIT_MS | 10000 | Studio 的短暂资源清理窗口；超时后会强制结束自己持有的进程树再退出。 |
HERMES_DESKTOP_STOP_TIMEOUT_MS | 20000 | Desktop 宿主原有的整树强制结束期限，独立于 Web UI 的 10 秒清理预算。 |
GATEWAY_HOST | 127.0.0.1 | 旧 gateway 兼容配置中写入 profile 的默认 gateway host。 |
HERMES_WEB_UI_PREVIEW_REPO | package repository | Version Preview 使用的 GitHub 仓库。 |
HERMES_WEB_UI_PREVIEW_AGENT_BRIDGE_TRANSPORT | 平台默认值 | Version Preview broker transport。设为 tcp 可让预览环境在 macOS/Linux 上也使用 loopback TCP；未设置时会跟随 HERMES_AGENT_BRIDGE_WORKER_TRANSPORT=tcp。 |
HERMES_WEB_UI_PREVIEW_AGENT_BRIDGE_ENDPOINT | 隔离的预览 endpoint | 直接覆盖 Version Preview 的 broker endpoint。 |
HERMES_WEB_UI_BACKEND_PORT | 8648 | Vite dev proxy 使用的后端端口。 |
HERMES_WEB_UI_FRONTEND_PORT | 8649 | 前端 Vite dev server 端口。 |
