运维手册
适合谁负责生产环境巡检、备份、升级和问题交接的运维人员。
你会完成建立每日巡检清单、启停流程、升级流程和诊断信息收集方式。
生产建议先备份配置、数据库、日志和结果文件，再执行升级或批量变更。
本页给出生产环境的日常巡检、升级、备份和问题交接流程。首次使用请先阅读 快速开始 和 配置指南。
每日巡检
异常项须立即处理
巡检中发现以下异常时应立即排查，避免问题扩大：
| 检查项 | 正常表现 | 异常处理 |
|---|---|---|
| 基线状态 | 关键基线处于 FIX 或稳定 FLOAT | 查看 Age、Ratio、卫星数和日志 |
| 数据源连接 | Rover/Base 持续有数据 | 检查 NTRIP/TCP/串口连接 |
| Age | 通常小于 5 秒 | 检查差分源和网络延迟 |
| Ratio | FIX 基线通常大于 3.0 | 检查环境、多路径、频点和卫星系统 |
| STRHUB 任务 | 流转发任务运行中，收发速率正常 | 检查 STRHUB Web 页面（端口 5427） |
| EPHUB 星历 | 输入流在线，缓存卫星数正常 | 检查 EPHUB Web 页面（端口 5428） |
| 磁盘空间 | 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.exe。升级前务必完成备份，否则升级失败将无法回滚。
升级最佳实践
- 记录当前版本号和运行参数。
- 停止所有基线和 RTKHUB 主程序。
- 备份
conf/、SQLite 数据库、logs/、result/。 - 解压新版本到独立目录，例如
D:\rtkhub-v1.2.0\。 - 复制配置和数据库到新目录。
- 启动新版本并验证 Web、API、关键基线和日志。
- 保留旧版本目录一段时间，确认稳定后再归档。
备份命令示例
$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 使用三个独立的 SQLite 数据库文件，位于 database/ 目录：
| 文件 | 用途 |
|---|---|
rtkhub_users.db | 用户账号、角色和权限管理 |
rtkhub_scr.db | SCRHUB 任务配置、执行日志和脚本文件缓存 |
rtkhub_audit.db | 用户操作审计日志 |
备注
SCRHUB 使用 RTKHUB 主界面的登录会话，不单独维护用户账号库。任务数据（scripts、script_logs、script_files 表）独立于用户数据库存储。
审计日志保留策略
审计日志默认保留最近 10000 条记录，防止长期运行后数据库无限增长。若需要完整保留所有审计记录，可在编译时定义 WEB_AUDIT_DISABLE_RETENTION 关闭自动保留策略；后续可通过数据管理功能按日期导出或手动清理。
登录会话机制
登录会话使用 rtkhub_session session cookie。后端以 8 小时无操作超时作为滑动过期窗口；每次有效认证请求都会刷新 last_seen_at 和 expires_at，退出登录会立即删除当前会话。
| 方法 | 端点 | 说明 |
|---|---|---|
| POST | /api/login | 登录并设置 rtkhub_session cookie |
| POST | /api/logout | 清除当前会话 |
| GET | /api/session | 返回当前会话状态与用户信息 |
| GET | /api/me | 返回当前用户与权限 |
问题交接模板
提交问题时建议包含：
问题时间：
RTKHUB 版本：
操作系统：
测网 / 基线：
数据源类型：
现象：
已尝试操作：
相关日志：
配置片段（已脱敏）：
更多诊断步骤见 故障排查。