55 lines
2.7 KiB
Plaintext
55 lines
2.7 KiB
Plaintext
# =============================================================================
|
||
# Hermes 本地 Docker 配置（可见、可改）
|
||
# 用法：复制为 hermes-docker.env 后编辑；start-docker-cn.sh 会自动读取
|
||
# cp hermes-docker.env.example hermes-docker.env
|
||
# =============================================================================
|
||
|
||
# --- Hermes HTTP API（给 Open WebUI / curl 使用）---
|
||
API_PORT=8642
|
||
HERMES_API_KEY=change-me-local-dev
|
||
|
||
# --- LLM 推理（必填其一，否则对话报错：No inference provider configured）---
|
||
# start-docker-cn.sh 会把下面非空变量同步到 ~/.hermes/.env（必须：Hermes 启动时用该文件
|
||
# override Docker 注入的环境变量，只写在 hermes-docker.env 而不同步时会出现 401）
|
||
# OpenAI: https://platform.openai.com/api-keys
|
||
# OPENAI_API_KEY=sk-proj-...
|
||
# OpenRouter: https://openrouter.ai/keys
|
||
# OPENROUTER_API_KEY=sk-or-v1-...
|
||
# 其他见 hermes-agent/.env.example
|
||
|
||
# --- Open WebUI（浏览器聊天界面）---
|
||
WEBUI_PORT=3000
|
||
ENABLE_WEBUI=true
|
||
# macOS 启动脚本完成后是否自动打开浏览器（Linux 忽略）
|
||
OPEN_BROWSER=true
|
||
# 会话加密用，本地可保留；若暴露到公网请改成随机长字符串
|
||
WEBUI_SECRET_KEY=dev-change-me-in-production
|
||
|
||
# Open WebUI 镜像（国内拉不动时可换镜像代理前缀，见脚本注释）
|
||
OPEN_WEBUI_IMAGE=ghcr.io/open-webui/open-webui:main
|
||
|
||
# --- 数据目录（宿主机）---
|
||
# 留空则使用 ~/.hermes
|
||
HERMES_DATA_DIR=
|
||
|
||
# Open WebUI 持久化数据目录（留空则使用项目下 open-webui-data/）
|
||
OPEN_WEBUI_DATA_DIR=
|
||
|
||
# --- 构建镜像用（一般不用改）---
|
||
# BASE_IMAGE=docker.m.daocloud.io/library/debian:13.4
|
||
# APT_MIRROR_CANDIDATES=mirrors.aliyun.com,mirrors.ustc.edu.cn,mirrors.huaweicloud.com,mirrors.tuna.tsinghua.edu.cn
|
||
|
||
# =============================================================================
|
||
# 看不到 Web 界面时排查：
|
||
# 1) 地址必须是 http://127.0.0.1:与 WEBUI_PORT 一致（不要用 https://）
|
||
# 2) 首次启动等 1～3 分钟再刷新；日志: docker logs -f hermes-open-webui
|
||
# 3) 自检: curl -sS -o /dev/null -w "%{http_code}\n" http://127.0.0.1:3000/
|
||
# 返回 200 说明服务已好，多半是浏览器缓存或输错端口
|
||
# 4) 端口被占用可改 WEBUI_PORT，再执行 ./start-docker-cn.sh
|
||
#
|
||
# 浏览器控制台若出现：
|
||
# - Manifest / tiptap 警告：多为 Open WebUI 前端已知提示，可忽略
|
||
# - /ollama/api/version 500：已用 ENABLE_OLLAMA_API=false；若仍有，可清浏览器缓存或删 open-webui-data 后重建容器
|
||
# - Hermes 日志 401 Missing Authentication：在 ~/.hermes/.env 或本文件填写 OPENROUTER_API_KEY（勿留空行）
|
||
# =============================================================================
|