pallas_protocol（协议端管理）
字数
517 字
阅读时间
3 分钟
多账号 NapCat / SnowLuma 协议端：创建牛牛、启停实例、日志与 OneBot 反向 WebSocket 配置同步。与 Web 控制台共用浏览器登录（口令在 data/pallas_console/）。
入口
| 路径 | 说明 |
|---|---|
/protocol/console/ | 协议端管理页（维护者向，help_audience: maintainer） |
| Web 控制台 | 侧边栏可跳转协议端；分片部署时协议端由 hub 托管 |
无群内用户口令。
典型流程
- 浏览器登录控制台或协议端页（首次启动口令见 Bot 日志）。
- 创建实例：选择 NapCat 或 SnowLuma，填写 QQ 与反向 WS 地址（指向 Bot 的
PORT或分片 worker 端口）。 - 启动 / 停止：在实例列表操作；日志可在页内查看。
- 分片：各牛牛账号的
ws_url应指向所属 worker；run_sharded_bot.sh start会同步注册表与协议端配置。
Docker 下 NapCat 默认不在 Compose 网络内，反向 WS 主机勿盲目填 pallasbot 服务名；插件会按 PALLAS_PROTOCOL_DOCKER_ONEBOT_HOST 解析。详见 Docker 部署 与 FAQ。
命令权限
无。
配置
常用项（完整见 config.py，WebUI 插件 → pallas_protocol 或 data/pallas_config/webui.json）：
| 键 | 说明 |
|---|---|
pallas_protocol_enabled | 是否加载协议端插件 |
pallas_protocol_webui_enabled | 是否挂载协议端 Web |
pallas_protocol_instances_root | 实例根目录，默认 data/pallas_protocol/instances/ |
pallas_protocol_program_dir | NapCat 程序根目录（可配合自动下载） |
pallas_protocol_docker_onebot_host | Docker 下写入 OneBot 客户端的主机名/IP |
API 鉴权：X-Pallas-Protocol-Token 或 ?token=（与控制台会话体系配合）。
排障
| 现象 | 处理 |
|---|---|
| 账号无法启动 | 查实例日志、NapCat/SnowLuma 版本与 program_dir |
| Bot 不回复 | 确认反向 WS 已连上对应 hub/worker 端口 |
| 与控制台登不上 | 共用 data/pallas_console/ 口令；遗忘见 FAQ · 部署排障 |
| Docker WS 连不上 | 见 FAQ · 协议端反向 WebSocket |
