使用教程

Web 控制台总览

访问 http://127.0.0.1:5426 后，主界面包含以下功能标签页：

监测总览 - 实时解算状态、ENU 曲线、卫星天空图、残差分析
运行总览 - 基线列表、状态过滤、批量控制
测网分布 - 站点地图、航线可视化、测距工具
Web 终端 - 浏览器内完整控制台
STRHUB - 流转发任务管理（admin）
EPHUB - 星历汇集监控（admin）
脚本管理 - SCRHUB 定时任务（admin）
系统设置 - 告警、刷新率、显示选项（admin）
用户管理 - 用户、角色、审计日志（admin）

监测总览

基线选择

顶部下拉框可切换当前查看的测网和基线。选定后所有图表同步更新。

实时图表

如何理解监测指标

ENU 位移曲线 - 东（E）、北（N）、天（U）三个方向的位移趋势，单位厘米。位移持续增大可能表示天线移动或数据质量问题，稳定在小范围内是正常状态。
卫星数/DOP - 实时卫星数量和 GDOP/PDOP/HDOP/VDOP 精度因子。DOP 值越小精度越好，GDOP < 3 为优秀，> 6 说明卫星几何分布较差。
Ratio/Age - 整周模糊度固定质量和差分数据龄期。Ratio > 3.0 表示固定解质量良好，Age < 5s 为正常范围。
数据速率 - 基准站和流动站数据接收速率（Bps）。速率突然归零表示数据流中断。

顶部状态胶囊显示当前解算状态（FIX/FLOAT/SINGLE 等）和关键指标数值。

卫星天空图（v1.2.0+）

极坐标图显示当前可见卫星：

空间分布 - 方位角（角度）和高度角（半径）
卫星轨迹 - 历史运动轨迹线
系统标记 - GPS/BDS/Galileo/GLONASS 等不同颜色区分
固定状态 - FIX（绿色）、FLOAT（黄色）、未使用（灰色）
交互 - 点击卫星可切换到该卫星的残差时间序列

残差分析（v1.2.0+）

两种查看模式：

当前历元 - 柱状图显示所有卫星当前时刻的伪距残差和载波残差
单星时间序列 - 选择某颗卫星后显示其残差随时间变化

载波残差自动转换为周（cycles），便于与伪距残差对比。

系统设置说明

以下设置控制 Web 控制台的显示行为和告警阈值，所有设置保存在浏览器 localStorage 中，支持一键恢复默认。

设置项	说明
位移告警阈值	E/N/U 超过此值触发告警（厘米）
Ratio 告警阈值	Ratio 低于此值触发告警
音频告警	启用后 ERROR 状态或位移超标时播放提示音
图表历史保留	30 分钟 / 1 小时 / 4 小时
全局刷新率	1 秒 / 3 秒 / 5 秒
后台刷新率	标签页隐藏时的刷新率（2/5/10/30 秒）
图表类型	折线图 / 散点图
平滑曲线	开启/关闭
ENU Y 轴限制	自定义纵轴范围
过滤 FLOAT 解	仅显示 FIX 解
隐藏空测网	不显示无通道的测网
隐藏已停止通道	不显示已停止的基线

运行总览

基线列表

按测网分组显示所有基线，每条基线显示：

站点名称、通道 ID
运行状态（运行中/已停止/错误）
解算模式、卫星数、Ratio、Age
输入数据速率、运行时长
当前坐标、配置文件路径

过滤与搜索

状态过滤 - ALL / RUNNING / ERROR / STOPPED
文本搜索 - 搜索测网名、通道 ID、站点名、配置文件名

批量操作

启动 / 停止 / 重启所有可见测网
批量设置日志级别（stat/trace）
批量保存配置

单基线控制

每条基线有独立的启动/停止/重启按钮。每个测网卡片可展开/折叠。

测网分布

地图功能

站点标记 - 不同颜色和动画表示运行状态，带涟漪波纹效果
航线连线 - 双层发光航线连接基准站和流动站
智能标注 - 自动防重叠的站点名称标签
图例系统 - 标注各状态颜色含义
站点弹窗 - 点击站点查看卫星系统、坐标等详情

坐标投影（v1.2.0+）

投影	适用场景
WGS84	原始坐标，Google Maps / OpenStreetMap
GCJ-02	高德地图 / 腾讯地图
BD-09	百度地图

测距工具

右键点击地图添加测距路径点，支持多段距离测量。

Web 终端

浏览器内的完整 RTKHUB 控制台，支持命令历史（上下箭头）、语法高亮（FIX/FLOAT/ERROR 等关键字着色）和可配置行数限制（500/1000/3000 行）。

控制台层级

RTKHUB 控制台有三个层级：MAIN（主菜单）→ NET（测网）→ CH（通道）。进入子层级后命令集会变化。

MAIN 级命令

命令	说明
`list [run\|stop]`	列出所有/运行中/已停止的测网
`add <netName> [lat,lon,hgt]`	添加测网
`add list <file>`	从文件批量添加测网
`del <netName\|id>`	删除测网
`net <netName>`	进入指定测网
`start <netName\|all\|id>`	启动测网/所有/通道
`stop <netName\|all\|id>`	停止测网/所有/通道
`restart <netName\|all\|id>`	重启测网/所有/通道
`set <netName\|id> <lat,lon,hgt>`	设置测网坐标
`setlevel <netName\|all> <stat\|trace> <level>`	设置日志级别
`save [file]`	保存配置
`help`	显示帮助
`help path`	显示 stream path 格式说明
`exit`	退出（不影响后台运行）
`shutdown`	关闭整个系统（仅本地控制台）

NET 级命令（`net <name>` 进入后）

命令	说明
`list`	列出当前测网所有通道
`ch [id]`	进入指定通道
`add <conf>,<site>,<lat,lon,hgt>[,ref]`	添加通道
`del <id>`	删除通道
`start <id\|all>`	启动通道
`stop <id\|all>`	停止通道
`restart <id\|all>`	重启通道
`set <id> <lat,lon,hgt>`	设置通道坐标
`save`	保存配置
`main`	返回主菜单

CH 级命令（`ch [id]` 进入后）

命令	说明
`solution [cycle]`	显示解算结果（ENU、状态、Ratio）
`status [cycle]`	显示运行状态（数据率、卫星数、Age）
`satellite [-n] [cycle]`	显示卫星信息（方位角、高度角、信噪比）
`observ [-n] [cycle]`	显示观测数据
`navidata [cycle]`	显示导航数据
`stream [cycle]`	显示输入/输出流状态
`ssr [cycle]`	显示 SSR 数据
`error [cycle]`	显示错误计数
`option [opt]`	查看/设置 RTKLIB 选项
`set <opt> [val]`	设置选项值
`mark <name> [comment]`	在结果文件中标记事件
`mode ['g'\|'s'\|'f'\|n]`	设置解算模式（GPS/SINGLE/FLOAT/n-动态）
`load [file]`	加载配置文件
`log [file\|off]`	开始/停止日志记录
`start`	启动当前通道
`stop`	停止当前通道
`restart`	重启当前通道
`main`	返回主菜单

[cycle] 参数表示周期性输出，不指定则输出一次。

使用示例

# 查看所有运行中的测网
> list run

# 进入测网 XANet，查看通道 0 的解算结果
> net XANet
XANet> ch 0
XANet:0> solution

# 持续监控卫星信息（每 2 秒刷新）
XANet:0> satellite 2

# 返回主菜单，保存配置
XANet:0> main
> save

Stream Path 格式

数据流路径使用 scheme://参数 格式，可通过 help path 查看：

serial://port[:bit_rate[:byte[:parity(n|o|e)[:stopb[:fctr(off|on)[#port]]]]]]]
file://path[::T[::+offset][::xspeed]]
tcpsvr://:port
tcpcli://addr:port
ntripsvr://[passwd@]addr:port/mntpnt[:str]
ntrip://user:passwd@addr:port/mntpnt
ntripcli://user:passwd@addr:port/mntpnt
ntripcas://user:passwd@:[port]/mpoint[:srctbl]
udpsvr://:port
udpcli://addr:port

需要管理员权限

以下管理功能仅对 admin 角色可见，需要管理员权限才能操作。

STRHUB 管理

STRHUB 管理页嵌入 RTKHUB 主界面（admin 角色可见），连接独立运行的 STRHUB 实例（默认端口 5427）。

摘要统计 - 运行中任务数、错误数、总收发速率
实时吞吐量图表 - ECharts 趋势图
任务列表 - 状态、收发速率、配置、操作按钮
添加任务 - 通过命令输入添加新的流转发任务
过滤搜索 - 按状态过滤、文本搜索

详见 STRHUB 文档。

EPHUB 管理

EPHUB 管理页嵌入 RTKHUB 主界面（admin 角色可见），连接独立运行的 EPHUB 实例（默认端口 5428）。

摘要 - 输入流在线数、输出流打开数、缓存卫星数、输出消息数、重播轮数
配置条 - 统计间隔、重播间隔、重连间隔、最大保留时间
完整性告警面板 - 实时星历完整性监控，视觉化指示器显示当前活跃告警（过期/缺失星历、源间偏差、参考偏差）
质量度量仪表盘 - 多源星历质量对比、候选源缓存状态、源质量诊断与排名
输入流表 - 挂载点、状态、星历接收数、重复/无效数、龄期
输出流表 - 目标、状态、输出字节数、速率、失败次数
SSR 参考流配置 - 实时 SSR APC/CoM 参考流状态监控与诊断
星历来源表 - 卫星、系统、类型、来源、IODE/IODC/TOE、健康状态
系统过滤 - GPS/BDS/GLO/GAL/QZS/SBS/IRN
卫星搜索 - 按卫星编号搜索
自动刷新 - 可配置 1 秒 / 2 秒 / 5 秒间隔

详见 EPHUB 文档。

SCRHUB 脚本管理

创建任务

点击"新建任务"
从 script/ 目录自动扫描结果中选择脚本
填写任务名称和描述
选择脚本类型（Shell / JavaScript / Python）
设置 Cron 表达式（可选，留空表示仅手动执行）
设置日志保留策略
保存

Cron 表达式预设

预设	表达式	说明
每小时	`0 * * * *`	整点执行
每 6 小时	`0 /6 * *`	0/6/12/18 点执行
每天凌晨 2 点	`0 2 * * *`	每日 02:00
每周一 9 点	`0 9 * * 1`	每周一 09:00
每 30 分钟	`/30 * * *`	半小时间隔

日志保留策略

7 天 / 14 天 / 30 天 / 从不清理 / 自定义天数

自带脚本

脚本	说明
`logs_archiving.sh`	日志文件归档
`pos_archiving.sh`	结果文件归档
`stat_archiving.sh`	统计文件归档
`trace_archiving.sh`	Trace 文件归档
`scrhub_smoke_test.sh`	SCRHUB 冒烟测试

用户管理（Admin）

创建用户

进入"用户管理"标签页
填写用户名、密码、角色
点击"创建用户"

角色权限

角色	权限
viewer	查看状态、统计、终端输出
operator	viewer + 启停基线、执行终端命令
admin	operator + 配置管理、用户管理、审计日志、文件上传

重置密码

点击用户列表中的"重置密码"，输入新密码并确认。支持显示/隐藏密码切换。

审计日志

按日期查看所有操作记录，支持按类别过滤：

全部 - 所有记录
成功操作 - 结果为 success 的记录
失败操作 - 结果为 fail 的记录
登录事件 - login/logout 相关
用户管理 - 用户增删改操作
控制操作 - 启停重启等操作

点击记录可展开查看详情。

下一步

API 文档 - 开发集成
EPHUB 文档 - 星历汇集工具
故障排查 - 问题诊断
FAQ - 常见问题

Web 控制台总览​

监测总览​

基线选择​

实时图表​

卫星天空图（v1.2.0+）​

残差分析（v1.2.0+）​

运行总览​

基线列表​

过滤与搜索​

批量操作​

单基线控制​

测网分布​

地图功能​

坐标投影（v1.2.0+）​

测距工具​

Web 终端​

控制台层级​

MAIN 级命令​

NET 级命令（net <name> 进入后）​

CH 级命令（ch [id] 进入后）​

使用示例​

Stream Path 格式​

STRHUB 管理​

EPHUB 管理​

SCRHUB 脚本管理​

创建任务​

Cron 表达式预设​

日志保留策略​

自带脚本​

用户管理（Admin）​

创建用户​

角色权限​

重置密码​

审计日志​

下一步​