85 lines
3.1 KiB
Markdown
85 lines
3.1 KiB
Markdown
# meshcli — Meshtastic MQTT 纯 CLI 聊天客户端
|
||
|
||
纯命令行 Meshtastic MQTT 客户端：连接 MQTT broker，订阅频道流量，解码 Meshtastic 数据包（含 AES-CTR 频道加密），实现频道聊天。
|
||
|
||
协议实现参考 [meshtastic_mqtt_server](https://git.lmve.net/kevin/meshtastic_mqtt_server)（MIT License）：
|
||
ServiceEnvelope / MeshPacket / Data 均为 protobuf wire 格式手写解析（`google.golang.org/protobuf/encoding/protowire`），加密包用频道 PSK + AES-CTR 解密。
|
||
|
||
## 构建
|
||
|
||
需要 Go 1.25+：
|
||
|
||
```bash
|
||
go build -o meshcli .
|
||
```
|
||
|
||
## 用法
|
||
|
||
```bash
|
||
# 交互式聊天（默认连 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 广播也正常入库。
|