纯净沙箱环境
镜像基于 Python 3.12-slim 固化,预装 FFmpeg 多媒体内核、SIMD 加速的 libturbojpeg 与 ONNX Runtime,不污染宿主机系统环境。
提供标准 Docker 容器与 Linux 原生系统服务两种方案,开箱即用,一键快捷部署。
每个节点同时启动后端与独立 MQTT Broker,并创建隔离持久化数据卷。主服务器地址只用于节点协同。
curl -fsSL https://sg.link2you.top/static/install-docker.sh?v=20261115-eval100-v1 -o install-docker.sh && sh install-docker.sh --cpu
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 }
curl -fsSL https://sg.link2you.top/static/install-docker.sh?v=20261115-eval100-v1 -o install-docker.sh && sh install-docker.sh --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。
.env 中填写 AEGIS_HUB_URL=https://sg.link2you.top 接入主服务器,留空则独立运行。MQTT 1883 默认只绑定宿主机回环地址;可信局域网板端直连时另填 AEGIS_MQTT_BIND_IP=本机局域网IP,不要绑定公网。
镜像基于 Python 3.12-slim 固化,预装 FFmpeg 多媒体内核、SIMD 加速的 libturbojpeg 与 ONNX Runtime,不污染宿主机系统环境。
将核心 SQLite 数据库与告警取证快照独立挂载为 aegis-data 与 aegis-alerts 数据卷,容器版本迭代或重启不丢失历史留证。
Docker 每 30 秒请求 /api/v1/health。安装脚本等待后端通过探活,进程意外退出时由 restart: unless-stopped 重启。
后端默认映射到宿主机 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:
使用标准 Docker 命令检查容器状态、滚动日志与重启服务:
# 滚动追踪容器日志 docker compose logs -f # 检查当前容器状态与健康探针 docker compose ps # 重启容器服务 docker compose restart # 验证健康探针响应 curl -f http://127.0.0.1:8500/api/v1/health
安装独立 Aegis 后端与 Mosquitto 系统服务,并注册开机自启;可在安装时填写主服务器地址,留空则独立运行。
curl -fsSL https://sg.link2you.top/install.sh?v=20261115-eval100-v1 -o aegis-install.sh && sudo bash aegis-install.sh
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。
AEGIS_MQTT_BIND_IP=本机局域网IP;不要绑定公网。首次运行会询问主服务器地址,留空则独立运行;也可用 AEGIS_HUB_URL 显式指定。
安装脚本使用 Python 虚拟环境部署 CPU 版 ONNX Runtime,并安装 FFmpeg 与 TurboJPEG。
由 Linux Init 系统原生管理生命周期。支持开机秒级自启、异常退出 5 秒重试与标准 journalctl 生产日志集中审计。
自动建立 aegis:www-data 专属系统账户降权运行,开启 NoNewPrivileges 与 PrivateTmp 限制。
通过标准 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 |
部署完成后即可在浏览器访问并绑定边缘雷达与视觉设备。