npm run kernel:setup(npm 安装运行 yaoyao setup)准备 Python 3.11 依赖。在仓库执行 npm ci、npm run build,然后执行 npm start。Web 默认监听 127.0.0.1:15300。
模型供应商、默认模型和凭据在 Web 的“我的设置 → 管理 → 模型服务”中配置,保存在数据目录的 hermes/ 下。首次启动会只读导入原有 ~/.hermes。
首次打开 Web 时创建管理员账号和至少 8 位的密码。服务不会生成固定的默认账号或密码;iOS 使用 Web 账号或手机登录二维码。
局域网部署可设置 HERMES_YAOYAO_HOST=0.0.0.0 和 HERMES_YAOYAO_ALLOW_INSECURE_LAN=1,并在 HERMES_YAOYAO_ALLOWED_HOSTS 中列入访问地址。公网部署配置 TLS。
复制 docker.env.example 为 docker.env,按需填写发布地址(导入原有数据见 Docker 部署说明),然后执行:
docker compose --env-file docker.env config --quiet
docker compose --env-file docker.env up -d --build
Compose 将 Web 的 15300 端口发布到宿主机,使用 yaoyao-data 命名卷保存 /home/node/.yaoyao。宿主机连接、访问配置、备份及升级见 Docker 部署说明。
/healthz 检查 Web 自身;/readyz 检查 Hermes 上游。/api/app/capabilities 声明聊天功能。备份整个 HERMES_YAOYAO_HOME,包含 SQLite、上传与归档文件、用户凭据和密钥。运行中的 SQLite 使用数据库备份工具,或停止 Web 后复制整个目录。
macOS 本机服务可通过系统设置中的“更新与回滚”管理版本。其他源码部署更新代码后执行 npm ci、npm run build 并重启 Web。Docker 部署更新源码后重新构建镜像并重建容器,继续使用已有数据卷。配套客户端要求见对应发布说明。