命令行速查
本页用于 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 pathsdebug prefs 用于核对当前设置,debug paths 用于查看对端路径与选择原因。调试输出可能包含设备地址等信息,分享前检查内容。
命令成功与业务成功
flowmesh ping默认以建立直连为目标,仅有中继响应时可能返回非零退出码。flowmesh dns query应检查响应正文,不能只凭退出码判断解析成功。logout在控制服务器不可达时可能失败,此时不能认为服务端已撤销设备身份。set --advertise-routes成功表示提交了本地通告设置,仍需管理员批准及访问端接受路由。