常见问题 FAQ
安装部署
Q: RTKHUB 需要安装吗？
A: 不需要。下载后直接运行即可，所有依赖已静态链接。
Q: 支持 Linux 吗？
A: 部分支持。需要使用 CMake 自行编译。
Q: 可以在云服务器上部署吗？
A: 可以。注意修改监听地址为 0.0.0.0，并配置防火墙。
功能使用
Q: 最多支持多少条基线？
A: 默认 500 条。可以修改源码中的 MAX_CHANNEL 重新编译。
Q: 支持哪些 GNSS 系统？
A: GPS、GLONASS、Galileo、BDS、QZSS、NavIC
Q: 可以导出定位结果吗？
A: 可以。结果保存在 result/ 目录，格式为 RTKLIB 标准 pos 文件。
Q: 支持多用户同时访问吗？
A: 支持。内置完整的用户认证和权限管理系统。
Q: 可以修改 Web 端口吗？
A: 可以。使用 -w 参数：
.\rtkhub.exe -s -k conf\rtkhub.list -w 8080
性能相关
Q: 单条基线占用多少资源？
A:
- 启动时：约 14MB 内存
- 稳定运行：约 5.6MB 内存
- CPU：单核心 < 5%（1Hz 采样率）
Q: 100 条基线需要什么配置？
A: 推荐配置：
- CPU：16 核 3.5GHz+
- 内存：16GB+
- 磁盘：5GB+
安全相关
Q: 如何修改管理员密码？
A:
- 登录 Web 控制台
- 点击右上角用户图标
- 选择"修改密码"
Q: 忘记密码怎么办？
A: 删除用户数据库，重启后会重新生成：
Remove-Item database\rtkhub_user.db
.\rtkhub.exe -s -k conf\rtkhub.list
注意
此操作会删除所有用户账号和审计日志！
Q: 如何禁用外网访问？
A: 默认只监听 127.0.0.1，外网无法访问。
定位问题
Q: 无法获取固定解（FIX）？
A: 可能原因：
- 基线过长 - RTK 有效距离通常 < 20km
- 差分数据延迟 - Age 应 < 5 秒
- 卫星数不足 - 需要 ≥ 5 颗卫星
- 环境遮挡 - 改善天线环境
- 配置问题 - 检查频率和导航系统设置
详见 故障排查
Q: Age 持续很大怎么办？
A:
- < 5s：正常
- 5-30s：可用但精度降低
- > 30s：数据过时，检查数据源
排查：检查基准站连接、网络延迟、NTRIP 账号
Q: Ratio 很低怎么办？
A: 改善方法：
- 增加观测时长
- 改善天线环境
- 使用多频多系统
- 检查周跳处理
开发集成
Q: 可以用 API 集成到自己的系统吗？
A: 可以。RTKHUB 提供完整的 RESTful API，详见 API 文档
Q: 前端可以定制吗？
A: 可以。修改 public/ 目录下的文件。
Q: 如何贡献代码？
A: Fork 仓库并提交 Pull Request。
故障排查
Q: 启动失败 - 端口被占用
错误：Cannot start web server on port 5426
解决：
1. 查看端口占用：netstat -ano | findstr 5426
2. 换端口：.\rtkhub.exe -w 8080
Q: 浏览器无法访问
检查清单：
- RTKHUB 是否运行
- 地址是否正确
- 防火墙是否阻止
- 是否使用 IE（不支持）
还有问题？
- 📚 故障排查
- 🐛 GitHub Issues