系统要求与网络
安装前确认主机规格、Docker 版本、QRadar 版本、授权服务 Token、大模型端点、访问域名，以及需要放通的入站与出站端口。
RST AI Copilot for QRadar 以 Docker 交付，包含三个容器：网关、Caddy 反向代理（终结 TLS）和存放账号表的 PostgreSQL。产品不包含 QRadar，用一个授权服务 Token 连接已有的 Console，事件、网络流、Offense、规则和日志源都从 Console 读取。网关自身的状态保存在 Docker 卷上的 SQLite 文件 copilot.db 中，QRadar 侧不留数据。
交付包包含这三个容器的全部镜像，安装时不访问镜像仓库。
主机
| 项目 | 要求 |
|---|---|
| 操作系统 | Ubuntu 20.04、22.04、24.04，或同等 Linux（Debian、RHEL 系） |
| 规格 | 不低于 2 vCPU、4 GB 内存、20 GB 磁盘。网关容器默认上限 2 CPU、2 GB，由 RST_GATEWAY_CPUS、RST_GATEWAY_MEM 调整 |
| 运行时 | Docker Engine 24 及以上，Docker Compose v2 |
| 权限 | 能执行 docker 的账号。一条命令安装需要 root |
QRadar
| 项目 | 要求 |
|---|---|
| 版本 | 7.5 及以上，REST API 20.0（QRADAR_API_VERSION 默认值）。已在 7.6.0 FP1 上验证。7.4（API 16.0）尚未测试 |
| 网络 | 网关主机可以访问 Console 的 443 端口。网关只连接 Console，不连接 Event Processor |
| 证书 | 默认不校验 Console 证书。受信证书设置 RST_QRADAR_VERIFY_CERTS=true；私有 CA 把 PEM 文件放入 ./certs/ 并设置 RST_QRADAR_CA_CERT |
| Token | 一个授权服务 SEC Token，权限见 QRadar Token 权限 |
大模型
任意 OpenAI 兼容端点：火山方舟、DeepSeek、通义、Azure OpenAI、自建 vLLM 或 Ollama。安装时需要 URL、API key 和模型名。离线环境使用本地模型，并选择离线脱敏档位。安装后可以在 AI 配置中添加更多 provider。
研判、调查和规则生成使用思考模型时，单次调用耗时几十秒到几分钟。单次调用超时 LLM_TIMEOUT_S 默认 180 秒，慢模型需要调大。
访问域名
CADDY_SITE_ADDRESS 使用域名，例如 copilot.corp.local。IP 字面量不能作为 TLS SNI，部分浏览器握手失败。没有内网 DNS 时，在分析师机器上添加 hosts 记录。
端口
入站（到网关主机）：
| 端口 | 来源 | 用途 |
|---|---|---|
| 443/TCP | 分析师网段 | https://<域名>/v2/，唯一入口 |
| 80/TCP | 分析师网段 | HTTP 跳转到 HTTPS，可选 |
网关的 8000 端口和账号库的 5432 端口只在 compose 内部网络中，不对外开放。
出站（从网关主机）：
| 目标 | 端口 | 用途 | 是否必需 |
|---|---|---|---|
| QRadar Console | 443 | Ariel 搜索、Offense 同步、规则与日志源目录、平台体检 | 必需 |
| 大模型端点 | 443 | 推理 | 必需。本地模型走内网 |
license.reallysec.com | 443 | 激活、心跳 | 在线激活的商业许可需要。社区版未激活许可时和离线许可不需要 |
github.com、release-assets.githubusercontent.com | 443 | 在线更新：每天检查新版本和内容包，下载交付包。版本清单和内容包从 GitHub Releases 读取 | 使用在线更新时需要，所有版本相同。离线激活的主机不连接 |
| 飞书、钉钉、企业微信、Teams、Slack、SMTP | 443、465、587 | 对外通道 | 可选 |
| syslog 接收端，可以是 QRadar 自身 | 514、6514 | 审计转发，企业版 | 可选 |