停止、备份、升级与恢复

日常检查

先查看 status，再按故障服务查看日志。保留故障时间、版本、设备标识和错误消息；提供支持时隐藏密码、token 和密钥。

./run.sh status
./run.sh logs chirpstack

Windows 使用 run.bat status 和 run.bat logs chirpstack。

停止和重启

./run.sh stop 停止本安装管理的服务并暂停故障检查；start 恢复运行。外置数据库、缓存和 MQTT 仍由其管理员管理。无参数运行入口会重启服务，查看状态时不要直接双击运行而误触重启。

备份（维护前建议）

1. 记录当前版本和安装目录。
2. 执行 ./run.sh backup，等命令完成。
3. 根据输出找到生成的备份文件，记录大小和生成时间。
4. 将备份安全复制到其他磁盘；备份内可能含密钥、证书和许可证。
5. 对外置数据库按其备份策略另行备份。

备份文件存在不等于一定可恢复。正式维护前在隔离实例进行恢复演练，验证资源数量、登录、授权和真实链路。

离线升级

1. 选择匹配平台和架构的新原生包，核对版本与来源。
2. 停止新增配置操作，并确认备份可用。
3. 从旧安装目录执行：

./run.sh upgrade /path/to/lorawan-server-平台.tar.gz

4. 等待程序退出并检查状态、版本和日志。
5. 重新登录，验证网关上线、终端上行、业务订阅和必要下行。

升级会替换程序并保留运行目录和实例配置；失败回滚的最终结果以日志和服务检查为准。不要手动覆盖正在运行的数据库目录。

网页在线更新（按需）

仅适用于已接入原生管理器和发布签名配置的安装。需要安装开机服务，并在 server.toml 启用 [updates]、设置 HTTPS 清单地址和独立发布公钥。

管理员点击侧栏底部版本号 → 检查更新 → 核对目标版本和说明 → 确认下载更新。下载和校验失败时先查状态，不要同时启动离线升级。页面断开后等待服务恢复，重新检查安装结果并刷新前端。

本机开发服务未接入原生管理器时出现“不支持在线更新”属于部署条件不满足，不是升级已完成。

恢复（会覆盖状态）

./run.sh restore runtime/data/backups/native-YYYYmmddHHMMSS.tar.gz

执行前确认目标安装目录和备份来源，另备份当前状态，安排停服。恢复后核对账号、授权、证书、应用/终端/网关数量，最后验证真实业务。跨版本恢复和外置服务按对应发行说明处理。