进入项目文件夹
打开刚刚下载或 clone 下来的 Hermiss 项目目录，确认里面可以看到 `一键部署.bat`。
Deployment Guide
Hermiss 部署手册3步搞定
本页适用于 Hermiss 单用户轻量部署版。用户只需要获取 GitHub 项目、安装 Docker Desktop， 然后运行一键部署脚本即可。
- GitHub 轻量仓库
- 推荐一键部署
- 默认地址 127.0.0.1:8788
- 默认账号 hermiss
当前部署方案为本机部署，我们正在努力开发服务器版本，敬请期待！同时，如果您有什么好的建议或想法欢迎联系我们！
第一步
从 GitHub 获取 Hermiss 项目
项目仓库
先把完整项目文件下载到本机
可以直接打开 GitHub 仓库下载源码压缩包，也可以使用 `git clone` 拉取项目。 获取完成后，进入项目文件夹继续后面的部署步骤。
git clone https://github.com/LinMuMuPro/hermiss.git
cd hermiss第二步
下载并安装 Docker Desktop
Docker 官网
安装完成后保持 Docker Desktop 运行
Hermiss 通过 Docker 启动面板、主程序和 Milvus。安装 Docker Desktop 后，请先打开它， 等 Docker Engine 正常运行，再继续执行一键部署。
第三步
进入项目文件夹，双击一键部署即可
双击一键部署
Windows 用户直接双击 `一键部署.bat`。脚本会自动生成 `.env`、拉取镜像、构建并启动面板。
等待浏览器打开
脚本完成后会等待面板启动并自动打开浏览器。如果没有自动打开，可以手动访问默认地址。
运行一键部署后，会出现进度窗口
脚本会自动拉取镜像、构建面板并启动容器。看到 `Deploy completed` 后，说明部署已经完成。
#13 [8/8] WORKDIR /app/backend
#14 exporting to image
#14 naming to docker.io/library/hermiss_github-panel:latest done
#15 resolving provenance for metadata file
[+] up 4/4
✓ Image hermiss_github-panel Built
✓ Network hermiss_github_default Created
✓ Volume hermiss_github_hermiss-single-panel-data Created
✓ Container hermiss-single-panel Started
-- Waiting for panel
Deploy completed.
URL: http://127.0.0.1:8788
Username: hermiss
进度完成后会自动打开浏览器
浏览器打开 `http://127.0.0.1:8788`，使用默认账号密码登录：
登录
单用户版本，默认账号 hermiss / hermiss
首次配置
登录面板后，按这个顺序完成基础配置
配置模型
进入设置页，先填写模型服务商、模型名称、接口地址和 API Key。模型配置完成后，Hermiss 才能正常回复。
扫码绑定微信
进入微信绑定区域，按页面提示扫码。绑定完成后，Hermiss 才能通过微信收发消息。
确认或编辑人设
进入人设页，确认角色设定、说话方式和关系定位。也可以先使用默认人设，再慢慢调整。
配置表情包和记忆
按需上传表情包、开启记忆和主动回复。初次使用时可以先完成基本聊天，再逐步补充这些增强功能。
发送微信消息测试
完成以上配置后，向绑定的微信发送一条消息，确认 Hermiss 可以正常接收和回复。
其他系统
Linux、macOS 或 WSL 用户可以使用命令部署
拉取项目并启动
git clone https://github.com/LinMuMuPro/hermiss.git
cd hermiss
cp .env.example .env
docker compose up -d --build建议修改默认密码
如果部署在服务器，建议把 `.env` 中的 `PANEL_HOST` 改为 `0.0.0.0`，并修改默认密码和 `SECRET_KEY`。
手机访问需要开放监听
如果想让手机访问面板，将 `.env` 中的 `PANEL_HOST` 改为 `0.0.0.0`，然后重新启动服务。
常见问题
如果部署没有成功，先检查这几项
Docker Desktop 是否已经启动
如果 Docker Desktop 没有运行，一键部署脚本无法启动容器。先打开 Docker Desktop，等它显示正常运行后再重试。
镜像是否拉取失败
当前版本会从 GHCR 和 Docker Hub 拉取镜像。如果出现 `denied`、`unauthorized` 或 `permission_denied`，可以先检查网络或更换网络环境。
面板是否还在启动
首次启动需要构建面板并拉取镜像，可能需要等待一段时间。稍后再访问 `http://127.0.0.1:8788`。
端口是否被占用
如果 `8788` 端口被其他程序占用，可以修改 `.env` 中的 `PANEL_PORT`，然后重新运行一键部署。
如果你在部署过程中需要帮助，可以通过页面右下角联系我们。
邮箱