连接故障排查
从“客户端是否运行”开始,再检查节点路径、业务端口和 DNS。先记录现状,避免连续修改多个选项后无法判断原因。
下面的命令适用于 Linux FlowMesh;OpenWrt 的设置以 LuCI / UCI 为准。
1. 检查本机状态
flowmesh status
flowmesh status --json| 状态或现象 | 含义与处理 |
|---|---|
Running | 组网引擎已运行,继续检查对端与实际服务 |
NeedsLogin | 尚未完成接入,检查组网地址和有效密钥 |
Stopped | 已停止连接,保留的对端列表不表示仍然在线通信 |
| 无法连接本地 socket | 检查 flowmeshd 服务是否启动 |
Health 有内容 | 阅读具体提示,例如 DNS 未接管或出口节点离线 |
Linux systemd 系统查看服务与日志:
sudo systemctl status flowmeshd
sudo journalctl -u flowmeshd -n 100 --no-pagerOpenWrt 优先查看 LuCI 状态与日志,也可运行 logread -e flowmesh。
2. 接入失败
确认组网地址与控制台中组网「设置 → 网络配置 → 组网控制器」完全一致,包括协议、域名或 IP、端口。第一次接入必须给出 --login-server。
检查密钥是否有效、一次性密钥是否已使用、组网是否还能添加设备。网络超时则先检查本机能否访问控制服务器,不要通过反复生成密钥排查网络问题。
如果 up 提示遗漏非默认参数,按提示保留已有设置;只修改一个选项时用 set。--reset 会重置未指定的设置,不是通用修复命令。
3. 节点是否可达
将示例替换成对端实际地址:
flowmesh ping --until-direct=false -c 3 100.64.0.2no matching peer:检查对端是否在当前组网可见、地址是否正确,以及访问策略。peer's node key has expired:按管理员要求更新该设备的接入身份。no reply或超时:检查对端在线状态、两端网络和中继连通性。- 有中继
pong:路径可达;默认探测报告未建立直连,不等于中继不可用。
需要查看网络条件时运行 flowmesh netcheck,但它需要客户端已取得中继列表。
4. 能探测节点,但业务服务打不开
依次检查:
- 目标设备上的服务是否已经启动,端口是否正确。
- 服务是否仅监听
127.0.0.1。这种服务可以通过 Serve共享,或按业务需求调整监听地址。 - 主机防火墙和组网访问规则是否允许该协议与端口。
- 目标设备是否开启了
--shields-up。
节点路径探测不会验证应用服务是否启动,也不能替代访问规则测试。
5. 局域网设备或域名访问失败
| 现象 | 下一步 |
|---|---|
| 能访问网关,不能访问其局域网设备 | 检查转发、路由批准、接受路由与回程,见子网路由 |
| IP 正常,设备名称失败 | 检查系统实际 DNS 配置,见DNS |
| 选出口后不能上网 | 检查出口在线、路由批准、公网连通性;必要时取消选择,见出口节点 |
| Serve 返回 404 | 使用服务节点名称和正确路径访问 |
| Serve 返回 502 | 检查服务节点上实际运行的后端服务 |
6. 收集诊断信息
flowmesh bugreport命令在当前目录生成诊断 JSON 文件,不会自动上传。它包含状态、设置、系统网络配置和可读取的日志;某项信息无法读取时会记录该项失败。
工具会处理特定密钥字段,但报告仍可能包含设备名、地址、路由和日志等环境信息。分享前检查内容,按需要去除敏感信息;不要附上接入密钥或原始节点身份文件。
联系技术支持时,一起说明操作时间、受影响的两台设备、预期结果、实际错误,以及问题是否发生在更新或修改配置之后。