快速开始
三步上线
vConfig 通过 Docker 运行在你自己的 Linux 服务器上，安装器会搞定一切。
1
运行安装器
在一台干净的 Ubuntu 24.04 LTS 服务器上（最低 4 vCPU / 8 GB 内存），以 root 执行一行命令。脚本会在缺少 Docker 时自动安装、腾出被占用的 80/443 端口，并拉起六个容器：应用、网关、AI 工作进程、数据库、Prometheus 与 snmp-exporter。
$ curl -fsSL https://vconfig.ai/install.sh | sudo bash
2
登录
安装完成时会打印访问地址和自动生成的管理员密码。浏览器打开 https://你的服务器（80 端口的 http:// 会自动跳转过去），用 admin 登录并按提示修改密码。密码丢了就在服务器上执行 vconfigctl password。
3
添加设备，或激活许可证
在「设备管理 → 添加设备」录入，或用 SNMP 自动发现扫出来。10 台以内永久免费。买了套餐的话，把许可证密钥粘贴到「系统设置 → 授权」，在线激活后立即生效，无需重启。
系统要求
| 组件 | 最低 | 推荐 |
|---|---|---|
| 操作系统 | Ubuntu 24.04 LTS | Ubuntu 24.04 LTS |
| CPU / RAM | 4 vCPU / 8 GB | 8 vCPU / 16 GB |
| 磁盘 | 500 GB+ | 1 TB+ |
| 网络 | 可通过 SSH/Telnet 到达被管设备；出方向 HTTPS 可达 vconfig.ai 用于激活与更新 | |
需要开放的端口
| 方向 | 端口 | 用途 |
|---|---|---|
| 入站 | TCP 443 | Web 界面与 API，走 TLS |
| 入站 | TCP 80 | 仅用于 301 跳转到 HTTPS |
| 入站 | TCP 8443 | Web 终端与堡垒机会话（WebSocket） |
| 入站 | UDP/TCP 514 | 设备 syslog——端口在安装时就已开放，但接收默认关闭，需在「系统设置 → 日志设置」中启用（日志会持续占用磁盘，这个决定权交给你） |
| 入站 | UDP 2055 | NetFlow v5/v9、IPFIX 与 sFlow 共用这一个端口——用于「可视化 → 流量分析」。同样是端口已开放、功能默认关闭；请在设备上开启采样（1:1000 是个稳妥的起点），否则繁忙路由器会把采集器淹掉。 |
| 入站 | TCP 21 + 50100-50140, TCP 2222 | 设备镜像分发：设备通过 FTP（含被动模式端口段）或 SCP 从 vConfig 拉取升级镜像。SCP 用 2222 是因为 22 端口属于宿主机的 sshd。如果你用自己的服务器分发镜像，安装时设 VCONFIG_TRANSFER_PORTS=0 即可全部不开。 |
| 出站 | TCP 22, TCP 23 | SSH / Telnet 连接被管设备——备份、盘点、终端 |
| 出站 | UDP 161 | SNMP 发现与指标采集 |
| 出站 | ICMP | 可达性与 SLA 探测 |
| 出站 | TCP 443 | vconfig.ai——仅用于许可证激活与更新检查 |
以上端口均可在安装时修改。可选集成还会用到各自的端口：邮件告警 SMTP（默认 587）、LDAP/LDAPS（389/636）、云商 API（TCP 443）。
详细步骤、离线安装与升级指南见 安装文档.