运维手册
适合谁负责生产环境巡检、备份、升级和问题交接的运维人员。
你会完成建立每日巡检清单、启停流程、升级流程和诊断信息收集方式。
生产建议先备份配置、数据库、日志和结果文件，再执行升级或批量变更。
本页给出生产环境的日常巡检、升级、备份和问题交接流程。首次使用请先阅读 快速开始 和 配置指南。
每日巡检
| 检查项 | 正常表现 | 异常处理 |
|---|---|---|
| 基线状态 | 关键基线处于 FIX 或稳定 FLOAT | 查看 Age、Ratio、卫星数和日志 |
| 数据源连接 | Rover/Base 持续有数据 | 检查 NTRIP/TCP/串口连接 |
| Age | 通常小于 5 秒 | 检查差分源和网络延迟 |
| Ratio | FIX 基线通常大于 3.0 | 检查环境、多路径、频点和卫星系统 |
| 磁盘空间 | result/、logs/ 有足够空间 | 归档旧结果和日志 |
| 审计日志 | 用户操作可追踪 | 排查异常登录或误操作 |
启停流程
启动
cd D:\rtkhub
.\rtkhub.exe -s -k conf\rtkhub.list
启动后检查：
Get-Process rtkhub
netstat -ano | findstr 5426
浏览器访问：
http://127.0.0.1:5426
停止
优先通过 Web 控制台停止基线，再停止主程序。这样可以减少结果文件未写完或日志截断的概率。
重启
修改 conf/ 后建议重启主程序，并在 Web 控制台确认每条基线都加载了新配置。
升级流程
- 记录当前版本号和运行参数。
- 停止所有基线和 RTKHUB 主程序。
- 备份
conf/、SQLite 数据库、logs/、result/。 - 解压新版本到独立目录，例如
D:\rtkhub-v1.2.0\。 - 复制配置和数据库到新目录。
- 启动新版本并验证 Web、API、关键基线和日志。
- 保留旧版本目录一段时间，确认稳定后再归档。
不要直接覆盖正在运行的 rtkhub.exe。
备份命令示例
$date = Get-Date -Format "yyyyMMdd_HHmmss"
$backup = "backup\rtkhub_$date"
New-Item -ItemType Directory -Path $backup
Copy-Item conf $backup\conf -Recurse
Copy-Item logs $backup\logs -Recurse -ErrorAction SilentlyContinue
Copy-Item result $backup\result -Recurse -ErrorAction SilentlyContinue
Compress-Archive $backup "$backup.zip"
如果日志和结果文件很大，可以只备份最近日期或按项目目录归档。
发布前检查
用于新增测网、调整配置或版本升级后：
- Web 控制台可登录。
- 测网和基线列表完整。
- 关键基线可启动、停止、重启。
- ENU、卫星数、DOP、Ratio、Age 图表更新。
- 地图站点坐标正确。
- API
/api/status返回正常。 - 日志目录有新日志输出。
- 备份文件已生成并可解压。
问题交接模板
提交问题时建议包含：
问题时间：
RTKHUB 版本：
操作系统：
测网 / 基线：
数据源类型：
现象：
已尝试操作：
相关日志：
配置片段（已脱敏）：
更多诊断步骤见 故障排查。