启动与网络问题排查
适用:自行部署者 · 公共版 0.57.0-public.2 · 使用指南
先定位环境、服务、页面还是访问链路。
开始前
准备自己的可写目录与终端。操作对象是自己的部署,不包含作者的运行环境或账号。
按步骤操作
01 · 检查Node、pnpm、依赖安装和构建日志
检查Node、pnpm、依赖安装和构建日志,确认命令在项目根目录执行。
02 · 检查服务终端和实际监听地址
检查服务终端和实际监听地址,确认端口未被其他实例占用。
03 · 本机能开但他人不能访问时
本机能开但他人不能访问时,再检查网卡、防火墙、反向代理、HTTPS和认证。
04 · 反馈时给出版本、系统、复现、脱敏错误与期望结果
反馈时给出版本、系统、复现、脱敏错误与期望结果,移除密码、邀请、真实房间与模型凭据。
完成后检查
- 已将故障定位到依赖、服务、页面或网络链路中的一层。
- 反馈材料含版本与最小复现,不含密码、邀请码或真实房间数据。
边界与常见错误
不要直接公开.local目录或完整日志。保持运行故障与规则玩法问题分开。
仍无法定位时从最小本机合成场景重现,再逐项恢复可选服务。