meshcli/README.md

meshcli — Meshtastic MQTT 纯 CLI 聊天客户端

纯命令行 Meshtastic MQTT 客户端：连接 MQTT broker，订阅频道流量，解码 Meshtastic 数据包（含 AES-CTR 频道加密），实现频道聊天。

协议实现参考 meshtastic_mqtt_server（MIT License）： ServiceEnvelope / MeshPacket / Data 均为 protobuf wire 格式手写解析（google.golang.org/protobuf/encoding/protowire），加密包用频道 PSK + AES-CTR 解密。

构建

需要 Go 1.25+：

go build -o meshcli .

用法

# 交互式聊天（默认连 mesh.lmve.net，meshdev/large4cats）
./meshcli

# 完整参数
./meshcli \
  -server mesh.lmve.net -port 1883 \
  -user meshdev -pass large4cats \
  -psk AQ== \
  -prefix msh/CN -channel LongFast \
  -node-id !1234abcd -name "CLI 聊天" -short CLIC \
  -announce

# 单发模式：发一条消息后退出
./meshcli -send "大家好"

# 私聊（PSK 频道直发，需对方同频道）
./meshcli -to !501492cf -send "你好"

# 显示全部数据包（位置/遥测/节点信息等）
./meshcli -verbose

参数

参数	默认值	说明
-server	mesh.lmve.net	MQTT broker 地址
-port	1883	MQTT 端口
-user / -pass	meshdev / large4cats	MQTT 连接认证
-psk	AQ==	频道 PSK（Base64；AQ== 为 Meshtastic 默认密钥索引 1）
-prefix	msh/CN	MQTT topic 前缀
-channel	LongFast	频道名
-node-id	随机生成	本机节点 ID（!xxxxxxxx）
-name / -short	MeshCLI / MCLI	节点 Long/Short Name
-announce	true	连接后广播一次节点信息（NODEINFO_APP）
-to	广播	私聊目标节点 ID
-send	空	发送一条消息后退出
-verbose	false	显示位置/遥测/节点信息等全部数据包

交互命令

命令	说明
/help	显示帮助
/who	列出已见到的节点
/name <名字>	修改本机名字并重新广播
/to !xxxxxxxx	设置私聊目标（PSK 频道直发）
/to 广播	恢复频道广播
/quit	退出

实现要点

• 订阅：<prefix>/2/e/#（如 msh/CN/2/e/#），覆盖全部频道与节点
• 发送：发布到 <prefix>/2/e/<channel>/!<本机节点>，包体为加密的 ServiceEnvelope { MeshPacket { Data { portnum=TEXT_MESSAGE_APP } } }
• 加密：AES-CTR，nonce = little-endian(packetID 8B) + little-endian(from 4B) + 4B 零； MeshPacket.channel = xor(频道名) ^ xor(PSK)
• 解码：文本消息、节点信息（用于显示名字）、位置（-verbose）；其他类型摘要显示
• 私聊说明：-to 走 PSK 频道加密直发（非 PKI 端到端加密），仅对同一频道的节点可见

测试记录

实测连接 mesh.lmve.net（meshdev/large4cats）：

• 订阅 msh/CN/2/e/# 成功；
• 发送 meshcli命令行客户端连接测试 后经 broker 中转正确解密回显（!6fa5b924）；
• broker 侧 text_message 正常入库（id 1274598），NODEINFO 广播也正常入库。