节点上线 · DEPLOYMENT & OPS

两种架构方案,
随需快捷部署。

提供标准 Docker 容器与 Linux 原生系统服务两种方案,开箱即用,一键快捷部署。

Android 手机客户端

设备画面、留证与控制,随身查看。

下载 AEGIS 1.1.13 APK Android 8.0 及以上 · 版本与校验值
APK 下载二维码 手机扫码下载

AEGIS Docker Compose 一键启动与删除

Compose v2

每个节点同时启动后端与独立 MQTT Broker,并创建隔离持久化数据卷。主服务器地址只用于节点协同。

Linux / macOS 终端 (一键安装启动)
curl -fsSL https://sg.link2you.top/static/install-docker.sh?v=20261115-eval100-v1 -o install-docker.sh && sh install-docker.sh --cpu
Windows PowerShell (一键安装启动)
Invoke-WebRequest https://sg.link2you.top/static/install-docker.ps1?v=20261115-eval100-v1 -OutFile install-docker.ps1; if ($?) { powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\install-docker.ps1 -Mode cpu }
🧠 选择推理镜像:纯 CPU 版安装 CPU ONNX Runtime 与 CPU PyTorch;NVIDIA GPU 版安装 CUDA ONNX Runtime 与 CUDA PyTorch,并申请 Docker GPU。两版共用持久卷,网页内仍可选择自动、CPU 或 GPU 推理。
Linux · NVIDIA GPU
curl -fsSL https://sg.link2you.top/static/install-docker.sh?v=20261115-eval100-v1 -o install-docker.sh && sh install-docker.sh --gpu
Windows PowerShell · NVIDIA GPU
Invoke-WebRequest https://sg.link2you.top/static/install-docker.ps1?v=20261115-eval100-v1 -OutFile install-docker.ps1; if ($?) { powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\install-docker.ps1 -Mode gpu }
一键停止与彻底清理 (删除命令 · 包含持久卷)
docker compose down --volumes
💡 默认超管凭据:控制后台 http://<服务器IP>:8500/login,账号输入 admin,默认密码 admin123。
🌐 节点协同与 MQTT:在编排文件同目录的 .env 中填写 AEGIS_HUB_URL=https://sg.link2you.top 接入主服务器,留空则独立运行。MQTT 1883 默认只绑定宿主机回环地址;可信局域网板端直连时另填 AEGIS_MQTT_BIND_IP=本机局域网IP,不要绑定公网。
📦 包含全量 AI 资产:镜像内已固化打包姿态检测模型 fallpose.onnx、YOLO 基模 yolo26n-pose.pt 与 100 张严格测试基准图集,无需连外网下载模型。
01 / ISOLATION

纯净沙箱环境

镜像基于 Python 3.12-slim 固化,预装 FFmpeg 多媒体内核、SIMD 加速的 libturbojpeg 与 ONNX Runtime,不污染宿主机系统环境。

02 / PERSISTENCE

持久卷自动保护

将核心 SQLite 数据库与告警取证快照独立挂载为 aegis-data 与 aegis-alerts 数据卷,容器版本迭代或重启不丢失历史留证。

03 / HEALTHCHECK

容器健康检查

Docker 每 30 秒请求 /api/v1/health。安装脚本等待后端通过探活,进程意外退出时由 restart: unless-stopped 重启。

1

标准编排配置 docker-compose.yml

后端默认映射到宿主机 8500 端口,容器内使用 5500 端口。Mosquitto 作为独立容器运行。

name: aegis-cloude-node
services:
  aegis-mqtt:
    image: eclipse-mosquitto:2.0
    container_name: Aegis-MQTT-${AEGIS_NODE_NAME:-${COMPUTERNAME:-${HOSTNAME:-Server}}}
    restart: unless-stopped
    ports:
      # 默认只让宿主机访问匿名 1883;板端直连时显式填可信局域网 IP。
      - "${AEGIS_MQTT_BIND_IP:-127.0.0.1}:${MQTT_PORT:-1883}:1883"
    command: sh -c "echo -e 'listener 1883\nallow_anonymous true\n' > /tmp/mosquitto.conf && exec /usr/sbin/mosquitto -c /tmp/mosquitto.conf"
  aegis-server:
    image: aegis-cloud-server:cpu
    pull_policy: build
    depends_on:
      - aegis-mqtt
    build:
      context: .
      args:
        AEGIS_INSTALL_MODEL_EVAL: ${AEGIS_INSTALL_MODEL_EVAL:-1}
        AEGIS_ORT_GPU: ${AEGIS_ORT_GPU:-0}
      dockerfile_inline: |
        FROM python:3.12-slim
        RUN apt-get update && apt-get install -y --no-install-recommends ffmpeg curl ca-certificates libturbojpeg0 libgomp1 && rm -rf /var/lib/apt/lists/*
        WORKDIR /app
        # 2026-11-07: 确认下载包版本与 Compose 一致,避免缓存旧包。
        ARG RELEASE_VERSION=20261115-eval100-v1
        ARG AEGIS_INSTALL_MODEL_EVAL=1
        ARG AEGIS_ORT_GPU=0
        RUN curl -fsSL --retry 2 --connect-timeout 10 --max-time 180 "https://sg.link2you.top/static/release.tar.gz?v=$${RELEASE_VERSION}" -o /tmp/aegis-release.tar.gz \
            && tar -xOf /tmp/aegis-release.tar.gz release-manifest.json \
               | python -c 'import json, sys; sys.exit(0 if json.load(sys.stdin)["version"] == sys.argv[1] else "AEGIS release version mismatch")' "$$RELEASE_VERSION" \
            && tar -xzf /tmp/aegis-release.tar.gz --strip-components=1 -C /app cloud-server \
            && rm /tmp/aegis-release.tar.gz \
            && pip install --no-cache-dir -r requirements.txt \
            && if [ "$$AEGIS_INSTALL_MODEL_EVAL" = "1" ]; then pip install --no-cache-dir -r requirements-model-eval.txt; fi \
            && if [ "$$AEGIS_ORT_GPU" = "1" ]; then pip uninstall -y onnxruntime && pip install --no-cache-dir 'onnxruntime-gpu[cuda,cudnn]==1.31.1'; fi \
            && if [ "$$AEGIS_ORT_GPU" = "1" ] && [ "$$AEGIS_INSTALL_MODEL_EVAL" = "1" ]; then pip uninstall -y torch torchvision && pip install --no-cache-dir 'torch==2.14.1+cu130' 'torchvision==0.29.1+cu130' --index-url https://download.pytorch.org/whl/cu130; fi \
            && mkdir -p /app/data /app/static/alerts
        ENV PYTHONUNBUFFERED=1 \
            AEGIS_PUBLIC_DEPLOYMENT=1 \
            AEGIS_DEFER_CAMERA_ON_START=1 \
            AEGIS_BIND_HOST=0.0.0.0 \
            AEGIS_PORT=5500 \
            DATABASE_URL=sqlite:////app/data/aegis.db \
            AEGIS_MODEL_STATE_DIR=/app/data/aegis-models \
            AEGIS_SERVER_CONFIG_PATH=/app/data/server_config.json \
            AEGIS_EVIDENCE_KEY_DIR=/app/data \
            AEGIS_LOGIN_AUX_DB=/app/data/login_aux.db \
            AEGIS_MODEL_EVAL_DIR=/app/model-eval-cross-100 \
            AEGIS_BOOTSTRAP_PASSWORD=admin123 \
            MQTT_BROKER=aegis-mqtt:1883
        EXPOSE 5500
        HEALTHCHECK --interval=30s --timeout=5s --start-period=15s --retries=3 CMD curl -fs http://127.0.0.1:5500/api/v1/health || exit 1
        CMD ["sh", "-c", "ln -sfn /app /cloud-server 2>/dev/null || true; echo '========================================'; echo 'AEGIS 容器服务已启动'; echo '账号:admin'; echo '默认密码:admin123'; echo '========================================'; exec gunicorn --workers 1 --threads 8 --worker-class gthread --bind 0.0.0.0:5500 --timeout 90 --access-logfile - serve:app"]
    container_name: Aegis-Cloude-Node-${AEGIS_NODE_NAME:-${COMPUTERNAME:-${HOSTNAME:-Server}}}
    hostname: Aegis-Cloude-Node-${AEGIS_NODE_NAME:-${COMPUTERNAME:-${HOSTNAME:-Server}}}
    restart: unless-stopped
    ports:
      - "${AEGIS_PORT:-8500}:5500"
    environment:
      - AEGIS_SERVER_NAME=Aegis-Cloude-Node-${AEGIS_NODE_NAME:-${COMPUTERNAME:-${HOSTNAME:-Server}}}
      - AEGIS_HOST_PORT=${AEGIS_PORT:-8500}
      - MQTT_BROKER=aegis-mqtt:1883
      - AEGIS_HUB_URL=${AEGIS_HUB_URL:-}
      - AEGIS_IS_HUB=${AEGIS_IS_HUB:-0}
      - AEGIS_HUB_KEY=${AEGIS_HUB_KEY:-aegis-hub-mesh-v1}
      - AEGIS_IDENTITY_URL=${AEGIS_IDENTITY_URL:-}
      - AEGIS_PUBLIC_DEPLOYMENT=1
      - DATABASE_URL=sqlite:////app/data/aegis.db
      - AEGIS_MODEL_EVAL_DIR=/app/model-eval-cross-100
      - AEGIS_BOOTSTRAP_PASSWORD=${AEGIS_BOOTSTRAP_PASSWORD:-admin123}
      - AEGIS_DEFER_CAMERA_ON_START=1
    volumes:
      - aegis-data:/app/data
      - aegis-alerts:/app/static/alerts
volumes:
  aegis-data:
  aegis-alerts:
2

常用容器运维管理命令

使用标准 Docker 命令检查容器状态、滚动日志与重启服务:

# 滚动追踪容器日志
docker compose logs -f
# 检查当前容器状态与健康探针
docker compose ps
# 重启容器服务
docker compose restart
# 验证健康探针响应
curl -f http://127.0.0.1:8500/api/v1/health

AEGIS Linux 原生服务一键安装与彻底删除

v2.14 LTS

安装独立 Aegis 后端与 Mosquitto 系统服务,并注册开机自启;可在安装时填写主服务器地址,留空则独立运行。

Linux Shell (Ubuntu / Debian / RHEL / CentOS) · 一行极速安装
curl -fsSL https://sg.link2you.top/install.sh?v=20261115-eval100-v1 -o aegis-install.sh && sudo bash aegis-install.sh
备用命令 (Wget 管道安装)
wget -qO aegis-install.sh https://sg.link2you.top/install.sh?v=20261115-eval100-v1 && sudo bash aegis-install.sh
一键安全卸载与彻底清理 (删除命令 · 停止服务并移除程序文件)
curl -fsSL https://sg.link2you.top/uninstall.sh | sudo bash
💡 默认超管凭据:安装完成后自动启动服务,控制台地址 http://<服务器IP>:5500/login,账号输入 admin,默认密码 admin123。
📦 包含全量 AI 资产:安装包内已完整囊括 fallpose.onnx、yolo26n-pose.pt 与 100 张严格验证测试集,安装后直接可用,无需连外网下载模型。
🌐 独立 Broker 与主服务器:MQTT 1883 默认仅本机可访问。可信局域网板端需要接入时,可在安装命令前设置 AEGIS_MQTT_BIND_IP=本机局域网IP;不要绑定公网。首次运行会询问主服务器地址,留空则独立运行;也可用 AEGIS_HUB_URL 显式指定。
01 / PERFORMANCE

原生 CPU 推理

安装脚本使用 Python 虚拟环境部署 CPU 版 ONNX Runtime,并安装 FFmpeg 与 TurboJPEG。

02 / DAEMON

Systemd 守护运行

由 Linux Init 系统原生管理生命周期。支持开机秒级自启、异常退出 5 秒重试与标准 journalctl 生产日志集中审计。

03 / SECURITY

生产级安全沙箱

自动建立 aegis:www-data 专属系统账户降权运行,开启 NoNewPrivileges 与 PrivateTmp 限制。

Linux 服务日常运维常用命令

通过标准 systemctl 与 journalctl 工具链管理 AEGIS 服务:

运维操作执行命令说明
查看服务状态systemctl status aegis-node检查服务运行 PID、线程占用与最近日志
查看实时日志journalctl -u aegis-node -f实时滚动追踪推理、鉴权与网络上报输出
热重启服务systemctl restart aegis-node重载最新代码与模型配置
停止服务systemctl stop aegis-node安全平滑停止服务
手动彻底卸载sudo systemctl disable --now aegis-node && sudo rm -rf /opt/aegis-node清理服务与磁盘目录
健康探针自检curl http://127.0.0.1:5500/api/v1/health验证 HTTP 接口连通与探针返回 200 OK
READY TO GO

服务就绪,开启智能感知工作台。

部署完成后即可在浏览器访问并绑定边缘雷达与视觉设备。

进入首页登录 阅读系统使用说明