跳到主要内容

配置指南

适合谁需要新增测网、调整基线或排查配置问题的运维和工程人员。
你会理解rtkhub.list、单基线 RTKLIB 配置、输入输出流和目录变量。
使用建议修改配置前先备份 conf/，生产环境逐条基线验证后再批量启用。

RTKHUB 的配置分为两层：主配置 rtkhub.list 负责组织测网和基线，RTKLIB 配置文件负责定义每条基线的解算参数、输入流和输出流。

目录结构​

conf/
├─ rtkhub.list
├─ XANet/
│  ├─ DH04-DH06.conf
│  └─ DH05-DH07.conf
└─ strhub/
   └─ strhub.conf

建议按测网拆分目录。这样新增、停用或迁移基线时，不会把所有配置混在一个文件夹里。

主配置：rtkhub.list​

基本格式​

[测网名称]
dir=结果目录
netllh=纬度,经度,高程
配置文件路径,通道名称,流动站纬度,流动站经度,流动站高程,参考纬度,参考经度,参考高程

示例​

[XANet]
dir=./result/%Y/%n/
netllh=34.23247305,108.95249131,399.012
./conf/XANet/DH04-DH06.conf,DH04-DH06,34.23549980,108.90985758,384.387,34.235499796,108.909857575,384.3870
./conf/XANet/DH05-DH07.conf,DH05-DH07,34.24100000,108.91500000,386.100,34.241000000,108.915000000,386.1000

参数说明​

参数说明示例
dir结果文件保存目录./result/%Y/%n/
netllh测网中心点坐标，用于地图展示34.23,108.95,399
配置文件路径单条基线的 RTKLIB 配置./conf/XANet/DH04-DH06.conf
通道名称Web 页面和 API 中显示的基线名DH04-DH06
流动站坐标rover 近似坐标34.235,108.909,384
参考坐标base 坐标34.235,108.909,384

目录变量：

变量含义
%Y四位年份
%m月份
%d日期
%n测网名称
%r通道名称

基线配置文件​

最小可运行配置​

pos1-posmode    = kinematic
pos1-frequency  = l1+l2
pos1-navsys     = 5
pos1-elmask     = 15

ant2-postype    = llh
ant2-pos1       = 34.235499796
ant2-pos2       = 108.909857575
ant2-pos3       = 384.3870

inpstr1-type    = tcpcli
inpstr1-path    = 127.0.0.1:2101
inpstr1-format  = rtcm3
inpstr2-type    = tcpcli
inpstr2-path    = 127.0.0.1:2102
inpstr2-format  = rtcm3

outstr1-type    = file
outstr1-path    = ./result/%Y%m%d_%r.pos
outstr1-format  = llh

常用选项​

定位模式​

值说明适用场景
single单点定位数据源连通性测试
kinematic动态 RTK常规 rover/base 实时解算
static静态 RTK固定站稳定性分析
ppp-kinematic动态 PPP无本地基准站场景

卫星系统​

pos1-navsys 通常使用位掩码组合：

值系统
1GPS
4BDS
5GPS + BDS
9GPS + Galileo
13GPS + BDS + Galileo
15GPS + GLONASS + BDS + Galileo

数据源类型​

类型说明路径示例
serial串口接收机COM3:115200:8:n:1:off
tcpcliTCP 客户端192.168.1.100:2101
ntripcliNTRIP 客户端user:pass@caster.example.com:2101/MOUNT
file文件回放或离线测试./data/obs.rtcm3

典型配置片段​

NTRIP 数据源​

inpstr1-type    = ntripcli
inpstr1-path    = rover_user:rover_pass@caster.example.com:2101/ROVER
inpstr1-format  = rtcm3
inpstr2-type    = ntripcli
inpstr2-path    = base_user:base_pass@caster.example.com:2101/BASE
inpstr2-format  = rtcm3

串口接收机​

inpstr1-type    = serial
inpstr1-path    = COM3:115200:8:n:1:off
inpstr1-format  = rtcm3

输出 POS 文件和 NMEA​

outstr1-type    = file
outstr1-path    = ./result/%Y/%n/%r_%Y%m%d.pos
outstr1-format  = llh

outstr2-type    = tcpsvr
outstr2-path    = :2201
outstr2-format  = nmea

性能建议​

  • 小规模试运行可以先启用 1-5 条基线，确认数据源稳定后再批量增加。
  • 高频采样或多系统多频解算会增加 CPU 压力，建议逐步压测。
  • 生产环境不要长期打开过高等级 trace 日志。
  • result/ 和 logs/ 放在空间充足的磁盘，避免系统盘写满。
  • 关键测网建议固定机器、固定目录、固定启动参数，减少人为差异。

安全建议​

  • NTRIP 账号密码写在配置文件时，目录权限应仅开放给运维账号。
  • 提交问题或截图前先脱敏 username:password@host。
  • 修改配置前先备份 conf/。
  • Web 控制台只开放给可信网段，公网访问请使用 VPN 或反向代理。

配置验证​

启动前可以先检查文件路径、端口和数据源：

Test-Path conf\rtkhub.list
Test-NetConnection 192.168.1.100 -Port 2101

启动后在 Web 控制台确认：

  • 测网名称是否正确。
  • 基线数量是否与 rtkhub.list 一致。
  • 输入流速率是否持续更新。
  • Age、Ratio、卫星数是否在合理范围。
  • result/ 是否生成 POS 文件。

下一步​