Nexus Edge OS 在线部署指南

本指南适用于可以连接互联网的边缘设备（如树莓派、工控机、云服务器）。

1. 准备工作

确保目标设备已安装 Docker 和 Docker Compose。

# 检查版本
docker --version
docker compose version

2. 部署步骤

第一步：创建部署目录

在设备上创建一个目录（例如 /opt/nexus 或 ~/nexus），并进入该目录。

mkdir nexus-edge-os
cd nexus-edge-os

第二步：获取配置文件

你需要以下两个核心文件。你可以通过 git clone 获取整个项目，或者手动复制以下文件到部署目录：

1. apps/edge-os/docker-compose.yml
2. apps/edge-os/mosquitto/config/mosquitto.conf (及其目录结构)

目录结构示例:

nexus-edge-os/
├── docker-compose.yml
└── mosquitto/
    └── config/
        └── mosquitto.conf

提示：建议直接从仓库 apps/edge-os/ 目录复制（生产/部署用 compose）。开发环境请使用 docker-compose.dev.yml。

第三步：启动服务

在部署目录下运行：

docker compose up -d

Docker 会自动从 Docker Hub 拉取最新镜像 (justinzhq/nexus-edge-os:latest) 并启动所有服务。

3. 验证安装

1. 查看服务状态:

   docker compose ps

   确保所有服务状态为 Up (或 healthy)。

2. 访问管理界面:

   打开浏览器访问：http://<设备IP>:8080

3. 验证 MQTT:

   使用 MQTT 客户端（如 MQTTX）连接 tcp://<设备IP>:1883。

4. 自动更新 (OTA)

系统已内置 Watchtower 服务。

• 它每隔 5 分钟 会自动检查 Docker Hub 上是否有新版本的镜像。
• 一旦发现新版本，它会自动拉取并重启 nexus-edge-os 容器。
• 无需人工干预即可保持最新。

5. 常用运维命令

# 查看日志
docker compose logs -f nexus-edge-os
 
# 停止服务
docker compose down
 
# 手动强制更新 (如果你不想等 Watchtower)
docker compose pull
docker compose up -d