节点管理

节点是 Novaix 管理的基础单元，每个节点对应一台用于运行容器/虚拟机的服务器。Novaix 通过 API 连接这些节点，实现对虚拟机和容器的集中管理。

添加节点后，您需要手动点击「初始化」，系统会通过 SSH 自动完成运行环境的安装和配置。

添加节点

在管理面板的「节点管理」页面，点击「添加节点」按钮，填写以下信息：

字段	说明
名称	节点的显示名称，如「香港节点 1」
地址	节点服务器的 IP 地址或域名
区域	节点所在地区（可选，用于展示）
服务端口	管理服务端口，默认 8443
SSH 端口	SSH 连接端口，默认 22
SSH 用户	SSH 登录用户名，默认 root
SSH 认证方式	密码认证或密钥认证（必填）
SSH 密码/私钥	根据认证方式填写对应的密码或 SSH 私钥

WARNING

• 地址填写：如果 Novaix 管理面板和节点不在同一内网，请填写节点的公网 IP。如果在同一内网，建议使用内网 IP 以减少延迟和流量费用。
• 端口开放：请确保节点服务器的防火墙（iptables / firewalld）和云服务商的安全组都已放行服务端口（默认 8443）。只放行防火墙而忘了安全组是最常见的连接失败原因。
• 证书安全：客户端证书和密钥会使用 AES-256 加密后存储在数据库中，请确保您在 config.yaml 中设置了 security.encryption_key。

测试连接

添加或编辑节点时，可以点击「测试连接」按钮验证连通性。系统会并行测试：

• SSH 连接：使用提供的 SSH 凭据连接节点并执行测试命令
• 服务端连接：使用 TLS 证书连接节点的管理 API（仅已初始化的节点）

测试结果会显示每项的连通状态和响应延迟。新建节点由于尚未初始化，只会测试 SSH 连接。

在节点列表的操作菜单中也可以对已保存的节点执行「测试连接」。编辑节点时，测试使用的是当前表单中的值（而非已保存的配置），方便在修改连接参数后先验证再保存。

初始化节点

节点添加后需要进行初始化操作，系统会通过 SSH 自动完成运行环境的安装和配置，包括：

• 检测操作系统并安装容器/虚拟机管理服务
• 启用必要的系统服务
• 安装虚拟化组件（QEMU）
• 生成 TLS 证书并配置远程管理 API
• 检测系统架构、网桥和存储池

初始化是一个异步任务，您可以在任务列表中查看进度和日志。初始化完成后，系统会自动同步节点资源信息。

操作系统要求

初始化要求节点服务器运行受支持的操作系统，不满足要求的系统（如 Ubuntu 18.04）将无法完成初始化。支持的操作系统及最低版本：

• Ubuntu 20.04+（推荐 24.04 LTS）
• Debian 11+
• CentOS / RHEL / Rocky Linux / AlmaLinux 9+
• Fedora 38+
• openSUSE Leap 15.5+ / Tumbleweed
• Arch Linux、Alpine、Void Linux、Gentoo

详见环境要求 — 节点要求。

WARNING

如果您的节点上已有运行中的实例，初始化不会影响这些实例。初始化完成后，您可以使用「同步」功能将已有实例导入到 Novaix 中。

节点终端

管理员可以直接在浏览器中打开节点的终端（Shell），无需额外 SSH 登录。在节点详情页面点击「终端」按钮即可访问。

DANGER

节点终端拥有节点服务器的完整 Shell 权限，等同于 SSH 登录。请不要在公共场合使用此功能，确保只有受信任的管理员才有面板访问权限。

同步资源

如果您直接在节点服务器上进行了操作（如手动创建了实例），可以使用「同步」功能将节点上的资源状态同步到 Novaix 数据库中。

TIP

同步操作只会将节点上的实际状态同步到 Novaix 数据库中，不会修改节点上的任何资源。如果您在 Novaix 外手动删除了实例，同步后该实例也会从 Novaix 中移除。

拉取镜像

您可以从远程镜像服务器（如 images.linuxcontainers.org）拉取镜像到指定节点的本地缓存中。这不会在 Novaix 的全局镜像管理中创建记录，主要用于提前预热节点上的镜像缓存，加速后续实例创建。

节点组

多个节点可以组织成节点组，实现集群管理、热迁移和 HA 自动疏散。详见节点组管理。

维护模式

当您需要对节点进行计划内维护时，可以将节点设为维护模式。维护模式下节点不会接收新的实例创建任务，如果节点组启用了 HA，系统会自动将该节点上的实例疏散到其他健康节点。

维护完成后，点击「退出维护」恢复节点的正常状态。详见节点组管理。

删除节点

如果节点上还有关联的实例，系统会拒绝删除操作。请先将该节点上的实例全部迁移或删除，再删除节点。如果该节点是带 VPC 节点组中的最后一个在线节点，删除和进入维护操作也会被阻止，以保护 VPC 网络正常运行。

WARNING

删除节点只会将节点从 Novaix 的管理中移除，不会影响节点服务器上的运行环境。如需彻底清理，请手动处理节点服务器上的相关配置。

监控数据

如果节点服务器安装了 Node Exporter，Novaix 会定期采集节点的资源使用数据（CPU、内存、磁盘、网络），并在管理面板的仪表盘和节点详情页面展示。

采集间隔和数据保留时间可以在 config.yaml 中配置：

collector:
  interval: 60    # 采集间隔（秒）
  retention: 720  # 数据保留时间（小时，默认 30 天）
  timeout: 10     # 单次采集超时（秒）

TIP

• Node Exporter 默认监听 9100 端口，请确保该端口对 Novaix 管理面板所在服务器可访问。出于安全考虑，建议通过防火墙规则限制只允许管理面板服务器的 IP 访问 9100 端口，不要暴露给公网。
• 如果未安装 Node Exporter，节点层面的监控图表将无数据显示，但不影响实例层面的监控（实例监控数据直接从运行环境 API 获取）。
• 监控数据保留时间设得过长会占用更多数据库空间。对于 SQLite 用户，建议 retention 不超过 720 小时（30 天），避免数据库文件过大影响性能。