跳到主要内容

快速开始

适合谁首次试用 RTKHUB，准备完成本机启动和登录验证的用户。
你会完成下载、创建最小配置、启动服务、打开 Web 控制台并检查结果文件。
预计耗时约 5-10 分钟。需要一组可访问的 rover/base 数据源。

本指南帮助你完成一次最小试运行。生产部署前请继续阅读 配置指南、安全与权限 和 运维手册。

推荐环境

首次试用建议在本机运行，使用 Chrome 或 Edge 浏览器访问 Web 控制台。

准备工作​

  • Windows 10/11 或 Linux（Ubuntu 20.04+）。
  • 2GB 以上可用内存。
  • Chrome、Edge 或 Firefox。
  • 一组可访问的 rover/base RTCM 数据源，或用于测试的 TCP/NTRIP 数据源。

1. 下载​

访问 下载页面，下载最新 Windows x64 版本。

建议解压到固定目录：

D:\rtkhub\

2. 创建主配置​

在配置目录下创建 rtkhub.list：

路径：D:\rtkhub\conf\rtkhub.list

内容如下：

[TestNet]
dir=./result/%Y/%n/
netllh=34.23247305,108.95249131,399.012
./conf/test.conf,TEST01,34.235,108.909,384,34.235,108.909,384
配置字段说明
  • [TestNet]：测网名称
  • dir：结果文件目录（支持 %Y 年、%n 测网名宏）
  • netllh：测网中心点坐标（纬度,经度,高度）
  • 最后一行：基线配置文件、通道名称、流动站坐标和参考站坐标

3. 创建基线配置​

在配置目录下创建 test.conf：

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

ant2-postype    = llh
ant2-pos1       = 34.235
ant2-pos2       = 108.909
ant2-pos3       = 384.0

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/test_%Y%m%d.pos
outstr1-format  = llh
替换数据源

请把 inpstr1-path 和 inpstr2-path 替换为你的真实数据源地址。如果使用 NTRIP，可参考 配置指南。

4. 启动 RTKHUB​

在 PowerShell 中运行：

cd D:\rtkhub
.\rtkhub.exe -s -k conf\rtkhub.list
首次启动

首次启动会生成管理员密码，请记录并在登录后立即修改。详见 安全与权限。

5. 打开 Web 控制台​

浏览器访问：

http://127.0.0.1:5426

登录后检查：

  • 测网 TestNet 是否出现
  • 通道 TEST01 是否出现
  • 基线是否可以启动
  • 日志是否有数据源连接信息
  • result/ 目录是否生成结果文件

6. 常见问题​

页面打不开

检查进程和端口：

Get-Process rtkhub
netstat -ano | findstr 5426
数据源连接失败

检查 TCP/NTRIP 地址、端口、账号密码和防火墙：

Test-NetConnection 127.0.0.1 -Port 2101
长时间没有 FIX

先确认：

  • rover/base 数据都在持续输入
  • Age 没有持续增大
  • 卫星数足够
  • pos1-navsys、pos1-frequency、pos1-elmask 配置合理
  • 基线长度和环境条件适合 RTK

更多步骤见 故障排查。

其他工具快速启动​

STRHUB 快速启动​

信息

STRHUB 是基于 RTKLIB 流服务的轻量级多任务流转发工具，适合接入外部 NTRIP/TCP/串口源并转发给 RTKHUB 或其他消费者。

.\strhub\x64\Debug\strhub.exe -k conf\strhub_conf\strhub.conf

启动后访问 STRHUB 管理页面：http://127.0.0.1:5427/

EPHUB 快速启动​

信息

EPHUB 是广播星历实时汇集、质量控制、缓存重播与故障转发工具，支持从多个 NTRIP/RTCM3 输入流抽取广播星历，经去重和质量控制后分发。

.\ephub\x64\Debug\ephub.exe -k conf\ephub_conf\ephub.conf -x 3

EPHUB 提供 Web 管理界面，默认监听 5428 端口：

配置文件建议放在 conf\ephub_conf\ephub.conf，该目录默认不进入 Git，适合保存私有 NTRIP 凭证。

RNX2RTKP 快速启动​

信息

RNX2RTKP 是支持灵活频率选择的 RINEX 后处理工具，可批量处理 RINEX 数据进行 RTK 解算。

.\rnx2rtkp\x64\Debug\rnx2rtkp.exe -k rover.conf -o solution.pos rover.obs base.obs brdc.nav

RNX2RTCM 快速启动​

信息

RNX2RTCM 是 RINEX 转 RTCM3 消息流转换工具，支持时间窗口转换和多种 RTCM 消息类型。

.\rnx2rtcm\x64\Debug\rnx2rtcm.exe -ts 2026/05/31 00:00:00 -out test.rtcm -typ 1074,1084,1124 obs.rnx nav.rnx

下一步​