Docker 一键部署

方式一：Git 一条命令部署（推荐）

git clone --depth 1 --branch v2.2.1 https://github.com/Fausto-404/EFF-Monitoring.git && cd EFF-Monitoring && ./install.sh

install.sh 会检测 CPU 架构：ARM64 自动下载 eff-monitoring-v2.2.1-images-arm.tar，amd64/x86_64 自动下载 eff-monitoring-v2.2.1-images-amd.tar，然后导入镜像并自动生成安全密码。

脚本会在启动前检查 Docker、磁盘空间、CPU 架构和端口；默认使用 8000（API）和 8080（前端），端口被占用时会自动选择下一个可用端口，也可以手动指定：

./install.sh --api-port 8001 --web-port 8081

离线镜像包需要与目标机器 CPU 架构一致。Release 中应同时上传 arm 和 amd 两个架构的镜像包。

方式二：已有离线镜像包部署

如果已经将镜像包下载到本地：

./deploy.sh --offline /path/to/eff-monitoring-v2.2.1-images.tar

该方式不会下载任何镜像，也不会执行镜像构建。

方式三：直接使用 Docker Compose

适合不想下载 600MB 以上离线镜像包、希望直接从源码构建镜像的场景。该方式需要目标机器能够访问 Docker 基础镜像和依赖包仓库。

复制环境变量模板并修改密码和密钥：

cp .env.example .env

至少修改 .env 中的以下配置：

POSTGRES_PASSWORD=请替换为随机密码
DATABASE_URL=postgresql+psycopg://eff:请替换为随机密码@eff-postgres:5432/eff_monitoring
JWT_SECRET=请替换为随机密钥
INITIAL_ADMIN_PASSWORD=请替换为管理员初始密码

然后启动服务：

docker compose up -d --build

该方式会根据 Dockerfile.backend、Dockerfile.frontend 和 docker-compose.yml 构建 API、Worker 和前端镜像；首次使用前必须完成 .env 配置。

发布制作者可按目标机器架构制作离线包：

./scripts/export-images.sh --platform linux/amd64 --output ./eff-monitoring-v2.2.1-images-amd.tar
./scripts/export-images.sh --platform linux/arm64 --output ./eff-monitoring-v2.2.1-images-arm.tar

打包脚本会在导出前校验镜像架构，普通用户不需要执行。

首次部署结束时请保存终端输出的管理员密码。密码同时保存在当前目录 .env 中。

默认访问地址（如果端口未被占用）：

• 前端页面：http://localhost:8080

• FastAPI 文档：http://localhost:8000/docs

• 后端 API：http://localhost:8000
• 健康检查：http://localhost:8000/healthz

快速启动

可选演示数据

默认打包配置为 ENABLE_DEMO_DATA=false，首次启动只初始化系统默认规则、内置模板和管理员账号，不自动写入演示告警、演示资产和演示用户。

如需快速验证平台能力，可在 .env 中设置：

ENABLE_DEMO_DATA=true

开启后，系统会自动初始化一组演示数据，便于快速验证功能：

• 演示用户：demo_analyst / demo_viewer 等，密码通过 DEMO_USER_PASSWORD 环境变量配置（默认 demo123456）
• 演示设备：WAF、NDR、态势感知
• 演示资产：门户、交易 API、数据库、办公终端、WebLogic 业务服务器、网段资产
• 演示规则：通用规则、WAF/NDR 规则、态势感知日志解析规则
• 演示模板：态势感知研判通报、Excel 行、CSV 资产导出
• 演示告警：可验证资产命中、AI 研判、Hash 搜索、重复限制、运营总览和导出功能

演示日志中的公网 IP 使用文档保留地址段，不包含真实客户 IP。

界面预览

能力配置

适配常见大模型 API、威胁情报和消息通知，支持个人配置覆盖全员配置。并支持浏览器插件PAT接入。 <img width="3002" height="1522" alt="image" src="https://github.com/user-attachments/assets/3849fa0a-844f-4eb0-ac57-386e7fb4b41b" />