万联云组网命令行速查

命令行速查

本页用于 Linux FlowMesh 客户端。读取普通状态通常不需要 root;修改设置需要 root 或已授权的 operator。OpenWrt 持久设置优先通过 LuCI / UCI 管理。

查看状态

命令用途
flowmesh status查看本机与对端状态,仅 Running 时退出码为 0
flowmesh status --json查看机器可读状态、BackendState 与 Health
flowmesh ip查看本机组网地址
flowmesh ping --until-direct=false -c 3 100.64.0.2探测示例对端,接受直连或中继响应
flowmesh whois 100.64.0.2查看示例地址对应的节点信息
flowmesh netcheck检测当前中继列表与 NAT 特征
flowmesh dns status查看生效的 DNS 配置
flowmesh exit-node list列出可用出口节点
flowmesh serve status查看后台服务共享配置
flowmesh metrics print输出 Prometheus 格式的指标
flowmesh bugreport生成本地诊断文件,不自动上传

将示例 IP 替换为实际设备地址。Running 表示引擎运行,不代表每个对端和业务端口都可达。

连接与设置

命令用途
sudo flowmesh down暂停连接,保留登录和设置
sudo flowmesh up尝试重新连接;存在非默认设置时须按提示完整提供参数
sudo flowmesh logout联系控制服务器注销节点,并恢复默认设置
sudo flowmesh set --hostname=office-server修改设备名称
sudo flowmesh set --accept-routes=true接受已批准的子网路由
sudo flowmesh set --accept-dns=false停止自动接管系统 DNS
sudo flowmesh set --exit-node=取消使用出口节点
sudo flowmesh set --shields-up=true拒绝入站连接,保留本机发起连接的响应

首次接入需要控制服务器地址和有效凭证,完整示例见 Linux 安装指南。

set 只修改给出的选项。up 要求明确保留所有已有非默认选项;up --reset 会将未给出的选项恢复为默认值。不要把三者当成等价操作。

进一步诊断

flowmesh debug prefs
sudo flowmesh debug paths

debug prefs 用于核对当前设置,debug paths 用于查看对端路径与选择原因。调试输出可能包含设备地址等信息,分享前检查内容。

命令成功与业务成功

  • flowmesh ping 默认以建立直连为目标,仅有中继响应时可能返回非零退出码。
  • flowmesh dns query 应检查响应正文,不能只凭退出码判断解析成功。
  • logout 在控制服务器不可达时可能失败,此时不能认为服务端已撤销设备身份。
  • set --advertise-routes 成功表示提交了本地通告设置,仍需管理员批准及访问端接受路由。

更完整的操作步骤见子网路由、出口节点与故障排查。