通过 Basic Station 将 gwTool6/gwTool7 网关接入 ChirpStack
本文介绍如何将门思网关通过 LoRa Basics Station LNS 接入 ChirpStack。GD61/GD61x 使用 gwTool6；GDI51、GDO51、GDI52 使用 gwTool7。旧批次 GDI51/GDO51 的 WebServer 操作仍保留在 GW-AN08。
适用范围与准备工作
开始前准备：
- 网关 EUI、区域频段和信道计划；
- ChirpStack 中可创建网关的账号；
- ChirpStack Gateway Bridge 的 Basic Station LNS WebSocket 地址；
- 使用 TLS 时所需的 CA；使用双向 TLS 时还需网关客户端证书和私钥；
- 一条不会因修改 LoRaWAN 服务而中断的网关管理链路。
ChirpStack Gateway Bridge 的 Basic Station 后端实现的是 LNS。本文不把 CUPS 作为 ChirpStack 接入方式。
配置 ChirpStack Gateway Bridge
- 在 ChirpStack Gateway Bridge 配置中启用
basic_station后端并设置监听地址。 - 在同一配置中设置与网关硬件和区域一致的
router_config信道计划。 - 选择认证模式：
- 无认证：仅用于隔离测试网络；
- 服务器 TLS：配置服务端
tls_cert、tls_key，并把签发服务器证书的 CA 提供给网关； - 双向 TLS：除服务器 TLS 外，再配置用于验证网关客户端证书的
ca_cert。
- 使用双向 TLS 时，客户端证书的 Common Name（CN）必须是 64 位网关 ID 的十六进制字符串，例如
0102030405060708。 - 重启 Gateway Bridge，确认 WebSocket 监听端口已开放且日志无证书或信道计划错误。
参考：ChirpStack 官方 Basics Station 后端说明。
在 ChirpStack 注册网关
- 在 ChirpStack 租户下创建网关。
- 填写与设备标签一致的 Gateway ID/EUI。
- 选择与 Gateway Bridge
router_config和网关射频硬件一致的区域配置。 - 保存后保持网关详情页或网关事件页可见，供后续验证。
网关配置
先记录当前 LoRaWAN 上行配置。切换到 Basic Station 可能重启 LoRa 服务或整个网关，操作前确认没有 OTA、配置写入或关键下行业务。
gwTool6
适用型号：GD61/GD61x。
- 登录 gwTool6，打开“LNS 配置”。
- 将上行驱动切换为 Basic Station，选择 LNS 直连。
- 在
tc.uri填写完整地址：- 无 TLS：
ws://<Gateway-Bridge 地址>:<端口>； - TLS：
wss://<Gateway-Bridge 域名>:<端口>。
- 无 TLS：
- 使用 TLS 时上传签发服务端证书的 CA。
- 使用双向 TLS 时同时上传该网关自己的客户端证书和私钥；确认证书 CN 与 Gateway ID 一致。
- 只有部署在反向代理上额外要求 Token 时才填写 Authorization；不要把其他平台的 API Key 直接用于 ChirpStack。
- 保存并等待 LoRa 服务恢复，再重新打开页面核对当前配置。
gwTool7
适用型号：GDI51、GDO51、GDI52。
- 登录 gwTool7，进入“LORAWAN → LoRaWAN NS”。
- 在 NS1 将“服务器位置”设为“远端”，“供应商”选择 ChirpStack，“协议”选择 BasicStation LNS (basicstation_lns)。
- 在“服务器 URI”填写完整的
ws://或wss://Gateway Bridge 地址。截图中的wss://chirpstack.example.com:3001仅为格式示例。 - 使用 TLS 时在“CA 证书 (trust)”选择或上传签发服务端证书的 CA；双向 TLS 还需配置该网关自己的客户端证书和客户端私钥。
- 保存后等待相关服务恢复，重新读取页面，确认协议、地址和证书状态没有回退。
固件差异
gwTool7 不同交付固件显示的供应商、证书和备用 NS 控件可能不同。不能只凭控件可见判断配置生效，必须完成平台侧和报文侧验证。
验证连接
- 在 ChirpStack 网关页面确认“Last seen”或在线时间开始更新。
- 触发一个已知 LoRaWAN 终端上行。
- gwTool6 查看 LoRa 服务状态和日志；gwTool7 打开“LORAWAN → 报文监控”。
- 在 ChirpStack 网关事件中确认收到同一上行，并在允许时执行一次受控下行。
- 使用 TLS 时检查 Gateway Bridge 日志，确认没有 CA、证书 CN、有效期或系统时间错误。
故障排查
| 现象 | 检查项 |
|---|---|
| WebSocket 无法连接 | 地址、端口、防火墙、DNS，以及 ws/wss 是否与 Gateway Bridge 一致 |
| TLS 握手失败 | 网关时间、服务器证书域名、CA 链、证书有效期；双向 TLS 再检查客户端证书 CN |
| 网关在线但无上行 | Gateway EUI、区域频段、router_config、天线和终端信道计划 |
| 上行正常但无下行 | 下行窗口、Gateway Bridge/ChirpStack 日志、网络延迟和网关时间 |
| 保存后配置回退 | 固件是否支持所选控件、字段格式是否正确，以及服务重启后的实际配置 |