标准架构说明
WeOps X 以单机或主备方式部署。用户通过 HTTPS 访问平台。页面、接口和节点安装介质都从这一入口进入。各服务之间通过 NATS 通信。
| 层 | 组件 | 职责 |
|---|---|---|
| 入口 | Traefik | 对外提供 443，终结 TLS，转发页面、接口和采集入口 |
| 应用 | Web、Server | 页面、接口、业务模块、异步任务和周期任务 |
| 数据 | PostgreSQL、PGVector、FalkorDB、VictoriaMetrics、VictoriaLogs、MinIO、Redis | 业务数据、向量、资产关系、指标、日志、文件和缓存 |
| 消息 | NATS | 服务间调用、指标缓冲、文件传输和主备复制 |
| 采集与执行 | fusion-collector、Telegraf、Vector、Stargazer、nats-executor | 节点纳管、指标采集、日志采集、自动发现和作业执行 |
| 模型服务 | MLflow | 模型训练与实验记录，使用 PostgreSQL 和 MinIO |
用户访问进入 443。节点上的指标经 NATS 写入 VictoriaMetrics，日志经 NATS 写入 VictoriaLogs。告警来自策略扫描、外部告警源或 SNMP Trap。作业在目标节点上执行。资产台账写入 PostgreSQL，资产关系写入 FalkorDB。
部署方式
| 方式 | 适用 | 说明 |
|---|---|---|
| 单机 | 一台 Linux 服务器 | 支持在线部署和离线部署。离线可使用镜像包或私有镜像仓库 |
| 主备 | 两台 Linux 服务器 | 两台服务器互通。主备切换由管理员执行。离线部署使用私有镜像仓库 |
| 加固操作系统 | 目标机不能运行外来脚本 | 在另一台 Linux 上生成部署文件和操作步骤。目标机只执行容器命令，并指定目标机地址和 CPU 架构 |
平台部署不需要 GPU。启用本地大模型推理时，需要 NVIDIA GPU，显存大于 8 GB。
服务器资源需求
单机和主备的每台服务器按下列配置准备。主备的两台配置相同，并保证下文列出的复制端口互通。
| 项目 | 要求 |
|---|---|
| 操作系统 | Linux，64 位 |
| CPU 架构 | amd64 或 arm64 |
| Docker | 20.10.23 及以上 |
| Docker Compose 插件 | v2.27.0 及以上 |
| 内存 | 启用 OpsPilot 时，整机不少于 16 GB，其中应用服务约占 6～8 GB。不启用 OpsPilot 和 MLOps 时，应用服务约 2.5 GB |
| 磁盘 | 离线部署时空闲空间不少于 40 GB |
服务器有多块网卡时，部署时指定对外访问地址。部署前完成时间同步。
支持的操作系统
平台服务器与被纳管主机分开选型。
平台服务器：
| CPU 架构 | 操作系统 |
|---|---|
| amd64 | Linux |
| arm64 | Linux |
离线安装 Docker 时，适用 RHEL、Debian、银河麒麟、统信 UOS、openEuler。系统中须已安装 iptables。
被纳管主机：
| 操作系统 | CPU 架构 |
|---|---|
| Linux | amd64、arm64 |
| Windows | amd64 |
控制器和采集组件按操作系统和 CPU 架构匹配安装包。批量安装时，所选节点的操作系统和 CPU 架构必须相同。
应用性能的 .NET 探针仅提供 Linux x86_64。Go 应用接入要求 Go 1.25.0 及以上。
网络权限需求
对用户只开放平台入口。数据库、对象存储和 NATS 不对外开放。采集端口按实际接入的对象开放。
| 场景 | 源地址 | 方向 | 目标地址 | 协议 | 端口 | 用途 |
|---|---|---|---|---|---|---|
| 用户访问 | 浏览器 | → | 平台入口 | TCP | 443 | 页面、接口、节点安装介质。可改为其他端口 |
| 主备复制 | 主节点 | ↔ | 备节点 | TCP | 5432 | PostgreSQL 流复制，仅两台服务器之间 |
| 主备复制 | 主节点 | ↔ | 备节点 | TCP | 7422 | NATS 主备复制，仅两台服务器之间 |
| 主备复制 | 主节点 | ↔ | 备节点 | TCP | 9000 | 对象存储主备复制，仅两台服务器之间 |
| 主备维护 | 运维机 | → | 主节点、备节点 | TCP | 22 | 初始化、升级和切换 |
| 采集 | 网络设备、服务器 | → | 平台采集入口 | UDP | 162 | SNMP Trap |
| 采集 | 日志源 | → | 平台采集入口 | UDP | 514 | Syslog |
| 采集 | 日志源 | → | 平台采集入口 | TCP | 1514 | Syslog |
| 采集 | 网络设备 | → | 平台采集入口 | UDP | 2055–2056 | NetFlow |
| 采集 | 网络设备 | → | 平台采集入口 | UDP | 6343 | sFlow |
| 采集 | 指标直推来源 | → | 平台采集入口 | TCP | 19090 | 指标 HTTP 直推 |
| 节点通信 | 受信网络中的节点 | → | 平台 NATS | TCP | 4222 | 节点与平台通信。不对公网开放 |
节点安装通过平台 443 下载安装介质，再经 NATS 与平台通信。边缘区域接回中心时使用 7422，只在受信网络内开放。
支持的数据库
业务主库默认为平台内置 PostgreSQL。
单机部署可将业务主库切换为外部数据库。切换时在新库中初始化，不迁移原库数据。主备部署使用内置 PostgreSQL，由主节点向备节点做流复制。
| 数据库 | 说明 |
|---|---|
| PostgreSQL | 平台内置，默认业务库 |
| MySQL 5.x 及以上、MariaDB 10.4 及以上 | 单机外部业务库，字符集 utf8mb4 |
| GaussDB、openGauss 5.0 | 单机外部业务库，按 MySQL 兼容模式建库 |
| OceanBase 4.2 | 单机外部业务库，使用 MySQL 模式 |
| GoldenDB | 单机外部业务库，MySQL 兼容，单分片 |
外部数据库须事先建好业务库和账号，并允许平台服务器访问。首次初始化约 10 分钟。
指标、日志、文件、缓存和资产关系分别存放在 VictoriaMetrics、VictoriaLogs、MinIO、Redis 和 FalkorDB，不随业务库切换。业务库改为外部数据库后，模型训练仍使用内置 PostgreSQL。