Hermes Dashboard 修改密码:配置热更新技巧

Fri, 07 Aug 2026 17:00:00 +0800

修改 Hermes Dashboard 的登录密码,不需要重启整个容器——改配置 + kill 进程即可,QQ 会话不断线。

背景

Hermes Agent 的 Dashboard(Web 管理界面)默认带 basic auth 登录。Dashboard 页面本身没有"改密码"功能,需要改配置文件。但很多人以为要重启容器才能生效——其实有更轻的方式。

方法

1. 改配置文件

编辑 Hermes 配置(config.yaml),找到 dashboard 的 basic_auth 配置:

dashboard:
 basic_auth:
 username: admin
 password_hash: "<scrypt 哈希>" # 或明文 password: "xxx"

两种密码写法:

password_hash:scrypt 哈希(推荐,不存明文)
password:明文密码(简单但安全性低)

生成 password_hash(交互式输入,避免密码出现在命令行历史里):

# 容器部署的,先进入容器内再执行:
docker exec -it <容器名> bash
# 然后在容器内:
python3 -c "
from plugins.dashboard_auth.basic import hash_password
import getpass
pw = getpass.getpass('输入新密码: ')
print(hash_password(pw))
"

用 getpass 交互输入——密码不会显示在终端、不会进 shell history。 (如果容器里找不到 plugins 模块,说明需要在 Hermes 的虚拟环境里执行:/opt/hermes/.venv/bin/python3)

Dashboard on TechLog 技术日志

Hermes Dashboard 修改密码:配置热更新技巧

背景

方法

1. 改配置文件