hmo
1b2b935832
- Platform-based architecture (Windows/Linux/Mac) - Agent instance registry (agents.yaml) - Management dashboard with cross-platform monitoring - xmpp_bot with HTTP bridge + health endpoints - wechat_agent with WeChat-Hermes bridging - Platform services: ProcessGuardian, HealthProbe, APIRouter, ChannelBridge - Deployment: systemd (Linux) + PowerShell (Windows) - Monitoring: SSH+ejabberdctl for cross-platform presence
125 lines
3.4 KiB
Markdown
125 lines
3.4 KiB
Markdown
# AgentsMeeting — 部署指南
|
||
|
||
> 版本: v2.0 | 日期: 2026-06-12
|
||
|
||
---
|
||
|
||
## 部署概览
|
||
|
||
| 组件 | 平台 | 守护 | 端口 |
|
||
|------|------|------|------|
|
||
| **Dashboard** | Linux (192.168.1.246) | systemd `agentsmeeting-dashboard` | 5803 |
|
||
| **xmpp_bot (xxm)** | Windows (192.168.1.16) | watchdog (30s) | 5802 |
|
||
| **wechat_agent** | Windows (192.168.1.16) | 内置看门狗 | 5801, 19088 |
|
||
| **api_proxy** | Windows (192.168.1.16) | watchdog | 8787 |
|
||
| **watchdog** | Windows (192.168.1.16) | 自身 | — |
|
||
| **health_check** | Windows (192.168.1.16) | Task Scheduler | — |
|
||
| **ejabberd** | Linux Docker (192.168.1.246) | Docker restart policy | 5222 |
|
||
| **hermes-gateway** | Linux (192.168.1.246) | systemd | 8642, 8643, 8645 |
|
||
| **mohe/xiaoguo/zhiwei bots** | Linux/Mac | systemd | — |
|
||
|
||
---
|
||
|
||
## 1. Linux 端 (192.168.1.246)
|
||
|
||
### 1.1 Dashboard
|
||
|
||
```bash
|
||
# 服务文件: /etc/systemd/system/agentsmeeting-dashboard.service
|
||
sudo systemctl status agentsmeeting-dashboard
|
||
sudo systemctl restart agentsmeeting-dashboard
|
||
|
||
# 日志
|
||
sudo journalctl -u agentsmeeting-dashboard -f
|
||
|
||
# 访问: http://192.168.1.246:5803
|
||
```
|
||
|
||
### 1.2 ejabberd
|
||
|
||
```bash
|
||
cd /opt/ejabberd
|
||
docker compose restart
|
||
docker exec ejabberd ejabberdctl connected_users
|
||
```
|
||
|
||
### 1.3 防火墙
|
||
|
||
```bash
|
||
sudo ufw status | grep -E '5803|5802'
|
||
# Dashboard: 5803
|
||
# xmpp_bot bridge: 5802 (from Windows)
|
||
```
|
||
|
||
---
|
||
|
||
## 2. Windows 端 (192.168.1.16)
|
||
|
||
### 2.1 前置条件
|
||
|
||
- Python 3.10: `C:\Users\hmo\AppData\Local\Programs\Python\Python310\python.exe`
|
||
- pip 包: `slixmpp`, `flask`, `pyyaml`, `requests`
|
||
|
||
### 2.2 一键部署
|
||
|
||
```powershell
|
||
cd D:\F\NewI\opencode\daily-workspace\projects\AgentsMeeting
|
||
powershell -File deploy\windows\start.ps1
|
||
```
|
||
|
||
自动完成：停止旧进程 → api_proxy → wechat_agent → xmpp_bot → watchdog → health_check 定时任务
|
||
|
||
### 2.3 验证
|
||
|
||
```powershell
|
||
powershell -File deploy\windows\check.ps1
|
||
```
|
||
|
||
预期输出：
|
||
|
||
```
|
||
xmpp_bot: RUNNING (PID xxxx)
|
||
http_bridge: OK (N msgs)
|
||
wechat_agent: RUNNING (PID xxxx)
|
||
watchdog: RUNNING (PID xxxx)
|
||
api_proxy: RUNNING (:8787)
|
||
dashboard: http://192.168.1.246:5803
|
||
```
|
||
|
||
---
|
||
|
||
## 3. 人类客户端
|
||
|
||
| 客户端 | 平台 | 配置 |
|
||
|--------|------|------|
|
||
| Gajim | Windows/Linux | 服务器 `xmpp.yoin.fun`，端口 `3021`，STARTTLS |
|
||
| Conversations | Android | 同上 |
|
||
| Monal | iOS | 同上 |
|
||
|
||
群聊：`coregroup@conference.yoin.fun`
|
||
|
||
---
|
||
|
||
## 4. 网络拓扑
|
||
|
||
```
|
||
Windows (192.168.1.16) Linux (192.168.1.246)
|
||
───────────────────────── ────────────────────────
|
||
xmpp_bot :5802 ──────────────► Dashboard :5803
|
||
wechat_agent :5801 ──health──► Docker ejabberd :5222
|
||
api_proxy :8787 hermes-gateway :8642
|
||
frpc tunnel ──► Alibaba Cloud (47.115.32.206)
|
||
└─ frps :3021 → XMPP traffic
|
||
```
|
||
|
||
---
|
||
|
||
## 5. 故障恢复
|
||
|
||
| 问题 | 命令 |
|
||
|------|------|
|
||
| Dashboard 挂了 | `ssh hmo@192.168.1.246 "sudo systemctl restart agentsmeeting-dashboard"` |
|
||
| xmpp_bot 挂了 | `powershell -File deploy\windows\start.ps1` （watchdog 30s 自动重启） |
|
||
| ejabberd 挂了 | `ssh hmo@192.168.1.246 "cd /opt/ejabberd && docker compose restart"` |
|
||
| 全部瘫了 | 先 Linux: `docker compose restart` + `systemctl restart agentsmeeting-dashboard`，再 Windows: `start.ps1` |
|