first commit

hermes-docker.env.example

@@ -0,0 +1,54 @@
+# =============================================================================
+# 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（勿留空行）
+# =============================================================================