快速开始

部署前的准备

注意

仅支持部署在 Windows 系统和 Linux 系统，本章节不讲解 Mac 部署，Mac 部署请自行研究。

• 系统已经安装 Git，用于克隆项目

• 系统已经安装Docker Desktop，即 Docker 和 docker-compose 组件

• 系统已安装OpenSSL (Windows 系统可以选择安装Git，附带OpenSSL)，用于 https 证书签名

• 网络能拉取 Docker 镜像

快速部署

Windows 请在 PowerShell 中执行，Linux 请在终端中执行。下面的步骤请在同一个终端中依次完成。

1. 克隆项目并创建网络

# 克隆本项目
git clone https://github.com/hp0912/wechat-robot-client.git

# 进入部署目录，后续命令都在此目录下执行
cd ./wechat-robot-client/.deploy/local

# 如果以前没有创建过此 Docker 网络，先创建网络
docker network create wechat-robot

2. 生成并检查 HTTPS 证书

根据系统选择下面一种方式执行，将示例中的 192.168.1.10 替换为部署电脑的局域网 IP。

Windows（PowerShell）

# 生成证书
powershell -NoProfile -ExecutionPolicy Bypass -File .\gen-self-signed-cert.ps1 -IpAddresses 192.168.1.10

# 检查证书和私钥是否存在，以及文件大小
Get-Item .\secrets\nginx\tls.crt, .\secrets\nginx\tls.key -ErrorAction Stop |
  Select-Object Name, Length

Linux

# 生成证书
sh ./gen-self-signed-cert.sh --ip 192.168.1.10

# 检查证书和私钥是否存在，以及文件大小
ls -l ./secrets/nginx/tls.crt ./secrets/nginx/tls.key

检查结果必须同时包含 tls.crt 和 tls.key 两个文件，且文件大小都不为 0。

3. 启动容器

下面两个命令选择一个执行：

docker compose up -d

# 如果上面的命令不可用，使用这个命令
docker-compose up -d

温馨提示

如果拉镜像失败，请确认 docker 是否设置代理，并尝试逐个手动拉取镜像，个别镜像体积较大，批量拉容易失败

访问管理后台

浏览器访问https://127.0.0.1:8443，登录密钥12345678

创建机器人

• 点击右上角创建机器人按钮，新建一个机器人实例，创建时间可能会比较长，请耐心等待

• 创建完成后，机器人列表会出现机器人卡片，点击卡片右上角的扫码登录按钮，选择扫码登录方式

• 推荐使用 iPad 登录，登录不上再使用 Mac 登录，不要使用车载微信登录，拉 docker 镜像、克隆代码的时候如果开了梯子，扫码的时候记得把梯子关了，你会设置腾讯域名白名单，可以开着梯子，否则扫码登录后都不能开梯子。

• 扫码的时候，把同步最近消息取消勾选，因为机器人默认开启 AI 聊天，如果勾选同步历史消息，历史消息会触发 AI 聊天，导致刷屏。

• 登录成功后，即可点击下面一排按钮中的第一个，进入机器人详情界面，进行自定义配置

• 风控建议

  • 注册两年以上的小号，登录后挂机四小时
  • 注册半年以上的小号，挂机三天
  • 刚注册的小号，挂机一个月

特别注意

登录方式

目前只有iPad和Mac登录方式是稳定的，其他登录方式要么不可用要么容易封号。Mac登录方式如果需要过滑块，进交流群发送#过滑块密钥获取最新密钥，解决 401 的问题(密钥过期了)。

弱口令警告

默认配置包含很多弱口令，所以不要放在公网访问

后端接口文档

https://yj3pxd0t4m.apifox.cn