网络与端口

本页说明当前已验证的 Alice、Minecraft Adapter、模型与 QQ 网络边界。

需求

• Alice 与 Java 或 Bedrock 执行端部署在同一台机器。
• 本机 27541 未被其他程序占用。
• Windows 防火墙允许所需本机通信，但不将服务直接暴露到公网。
• 云模型、Ollama 或高级外部 OneBot 的目标地址可从 Alice 所在主机访问。

架构

Java / Bedrock Adapter → 127.0.0.1:27541 → Alice TCP 服务
Alice → HTTPS/HTTP → 模型 Provider
Alice ↔ 本机 NapCat → QQ
Alice → ws/wss → 外部 OneBot（仅高级模式）

Alice 的 TCP 服务可以监听所有网卡，但当前 Java 与 Bedrock Adapter 的实际目标固定为 127.0.0.1:27541。监听地址不代表跨主机 Adapter 已受支持，也不应据此配置端口映射。

执行

1. 先启动 Alice，再启动 Minecraft 世界、Java 专服或 BDS。
2. 在 Windows PowerShell 检查端口：

Test-NetConnection -ComputerName 127.0.0.1 -Port 27541
Get-NetTCPConnection -LocalPort 27541 -ErrorAction SilentlyContinue

3. 测试失败时确认 Alice 正在运行，并识别占用端口的进程；不要随意结束不明系统进程。
4. 端口可达但实例不出现时，检查 Adapter 的握手、身份、认证与工具注册日志。
5. 模型失败时在 Alice UI 中核对 Base URL、模型名称与凭据，参见 模型问题。
6. QQ desktop 先检查本机 NapCat 进程；高级 external 再检查 WebSocket 协议、地址、端口和 Token。
7. 不开放公网 27541、NapCat WebUI 或 OneBot 端口；远程需求应使用受控内网或 VPN，并理解 Minecraft Adapter 跨主机仍未验证。

成功标志：本机端口可达、实例完成握手和工具注册、外部服务仅暴露在预期网络边界。进一步排查见 连接问题。