fix: 停机先停接受并等待循环再断开 MQTT

2026-09-30 16:22:44 +08:00
parent 6a65ab8593
commit b40ef5c548
8 changed files with 345 additions and 20 deletions
@@ -122,6 +122,7 @@ curl -sS -H "Authorization: Bearer $NIXMSG_METRICS_TOKEN" http://127.0.0.1:7443/
 - 容器以 uid `65532` 运行：挂载数据目录须可写；命名卷首次可  
  `docker run --rm -v <卷名>:/data busybox chown -R 65532:65532 /data`。
 - 首次：`docker compose run --rm nixmsg admin init`，再 `up -d`。
+- Compose 示例已设 `stop_grace_period: 30s`。systemd 单元请设 `TimeoutStopSec=30`（或更长），以便进程先停接受、排空写队列并下发 MQTT DISCONNECT `0x8B`。第二次 Ctrl+C / SIGTERM 会按默认行为结束进程。
 - 构建/推送 Task 目标见根目录 README（`q:docker-build` / `q:docker-push` / `q:docker-buildx`）。正式仓库推送在阶段 3。

 ## 9. 验收与仍跳过的长时项