绿联 NAS 应用商店版 Hermes 配置 MiniMax 中国区模型失败的排查与修复

# 绿联 NAS 应用商店版 Hermes 配置 MiniMax 中国区模型失败的排查与修复## 问题现象我是在绿联 NAS 应用商店里直接安装的 Hermes，之后在 Docker / 容器里执行 `hermes setup` 配置 MiniMax 中国区模型。配置时看起来能填模型和 Key，但实际使用时一直报错，常见错误类似：```text401 authentication_errorlogin fail: Please carry the API secret key in the 'Authorization' field of the request header

[align=21, null, left]或者重启容器后，刚配置好的模型又失效。我的模型套餐

[align=21, null, left]我购买的是 MiniMax 中国区 Token Plan / Plus 极速版套餐，模型是：MiniMax-M2.7-highspeed

[align=21, null, left]官方文档里中国区 Token Plan 对应的接口是：https://api.minimaxi.com/anthropic

[align=21, null, left]注意：MiniMax 中国区也有 /v1 OpenAI-compatible 接口，但我这台 NAS 上的 Hermes 镜像里，minimax-cn provider 实际走的是 anthropic_messages transport，所以这里应使用 /anthropic。根因

[align=21, null, left]排查后发现，问题不只是 hermes setup 本身，而是绿联应用商店安装出来的 Docker Compose 里预置了错误的环境变量。[align=21, null, left]compose 文件路径大致是：/volume3/@appstore/com.ugreen.docker.hermes/docker-compose.yaml

[align=21, null, left]里面原来有类似配置：environment:  TZ: Asia/Shanghai  MODEL_NAME: MiniMax  PROVIDER_BASE_URL: http://127.0.0.1:19099  API_KEY: xxxxxxxxxxxxxxxx

[align=21, null, left]这里有几个问题：

• [backcolor=oklab(0.22559 -0.00131416 -0.00642684 / 0.0329412)]PROVIDER_BASE_URL 指向了本机 [backcolor=oklab(0.22559 -0.00131416 -0.00642684 / 0.0329412)]127.0.0.1:19099，不是 MiniMax 官方接口。
• [backcolor=oklab(0.22559 -0.00131416 -0.00642684 / 0.0329412)]API_KEY 被写成了 Hermes 内部 token，不是 MiniMax API Key。
• [backcolor=oklab(0.22559 -0.00131416 -0.00642684 / 0.0329412)]MODEL_NAME / PROVIDER_BASE_URL / API_KEY 这三个变量会在容器启动时触发 bootstrap，覆盖 [backcolor=oklab(0.22559 -0.00131416 -0.00642684 / 0.0329412)]config.yaml 里通过 [backcolor=oklab(0.22559 -0.00131416 -0.00642684 / 0.0329412)]hermes setup 写好的配置。
  

[align=21, null, left]所以即使手动执行 hermes setup 配好了，重启容器后也可能被这些环境变量覆盖回错误配置。修复方式

1. 修改 Hermes 配置

[align=21, null, left]/volume3/NAS_M2_1/Docker/hermes/config.yaml 里模型配置应类似：model:  default: MiniMax-M2.7-highspeed  provider: minimax-cn  base_url: https://api.minimaxi.com/anthropic  api_key: sk-cp-你的MiniMaxToken

2. 修改 compose 环境变量

[align=21, null, left]编辑：/volume3/@appstore/com.ugreen.docker.hermes/docker-compose.yaml

[align=21, null, left]建议删除这三项，避免每次启动覆盖配置：MODEL_NAME:PROVIDER_BASE_URL:API_KEY:

[align=21, null, left]然后增加 MiniMax / Anthropic-compatible 相关变量：environment:  TZ: Asia/Shanghai  ANTHROPIC_BASE_URL: https://api.minimaxi.com/anthropic  ANTHROPIC_API_KEY: "sk-cp-你的MiniMaxToken"  MINIMAX_CN_BASE_URL: https://api.minimaxi.com/anthropic  MINIMAX_CN_API_KEY: "sk-cp-你的MiniMaxToken"  GATEWAY_INTERNAL_PORT: 18643  GATEWAY_INTERNAL_TOKEN: 原来的内部token保持不变  API_SERVER_PORT: 18642

[align=21, null, left]注意：GATEWAY_INTERNAL_TOKEN 是 Hermes 内部通信 token，不要拿它当 MiniMax API Key。3. 重建容器

[align=21, null, left]进入 compose 目录后执行：cd /volume3/@appstore/com.ugreen.docker.hermesdocker compose up -d --force-recreate

[align=21, null, left]如果遇到容器名冲突，可以先停止并删除旧容器，数据目录不会删：docker stop hermes hermes-dashboarddocker rm hermes hermes-dashboarddocker compose up -d

验证方式

[align=21, null, left]进入容器后测试：docker exec hermes sh -lc 'HERMES_HOME=/opt/data /opt/hermes/.venv/bin/python /opt/hermes/cli.py --query "只回复 ok" --quiet --max-turns 2'

[align=21, null, left]正常会返回：ok

[align=21, null, left]也可以看容器状态：docker ps -a

[align=21, null, left]修复后我这里状态是：hermes             Uphermes-dashboard   Up (healthy)

额外问题：dashboard unhealthy

[align=21, null, left]我这里还发现 hermes-dashboard 一直 unhealthy。原因是 healthcheck 检查了错误端口：9119

[align=21, null, left]但 dashboard 实际启动端口是：19119

[align=21, null, left]把 compose 里的 healthcheck 改成：fetch('http://127.0.0.1:19119/api/auth/config')

[align=21, null, left]然后重建 dashboard 即可。总结

[align=21, null, left]绿联 NAS 应用商店版 Hermes 的问题主要是 Docker Compose 默认环境变量配置不合理，导致：

• [backcolor=oklab(0.22559 -0.00131416 -0.00642684 / 0.0329412)]hermes setup 写入的模型配置被覆盖
• MiniMax API Key 被内部 token 混淆
• base_url 指向错误
• dashboard healthcheck 端口错误
  

[align=21, null, left]修复重点是：

• 不要让 [backcolor=oklab(0.22559 -0.00131416 -0.00642684 / 0.0329412)]MODEL_NAME / PROVIDER_BASE_URL / API_KEY 继续覆盖 [backcolor=oklab(0.22559 -0.00131416 -0.00642684 / 0.0329412)]config.yaml
• 使用 MiniMax 中国区 Token Plan 正确接口：
  [backcolor=oklab(0.22559 -0.00131416 -0.00642684 / 0.0329412)]https://api.minimaxi.com/anthropic
• 使用真正的 MiniMax Token Plan API Key
• 重建容器使 compose 生效