节点管理⚓︎
版本说明
1Panel 节点管理功能旨在为用户提供便捷、高效的多服务器管理体验。通过节点管理,用户可以轻松管理多个服务器节点,实现统一的资源监控、应用部署、配置管理和运维操作。
节点管理需要专业版或企业版许可证。节点列表、节点配置和涉及许可证的操作仅管理员可用;其他用户还需具有节点查看权限。
1 功能概述⚓︎
功能概述
- 节点管理功能支持多服务器节点的统一管理,包括节点添加、删除、状态监控、资源统计等
- 支持节点分组管理,便于按业务、环境或地域对节点进行分类管理
- 实时查看各节点的 CPU、内存、磁盘、网络等资源使用情况
- 支持多节点切换,可以在统一控制台切换到不同节点完成应用部署管理等操作
- 可按添加节点时选择的同步项下发系统代理、告警、自定义应用仓库和备份账号配置
2 节点概览⚓︎
在节点概览页面,可以查看当前集群所有节点的整体状态,包括节点数量、在线状态、资源使用情况、应用分布等统计信息。

3 添加节点⚓︎
点击【添加节点】按钮,输入节点信息,即可将新的服务器节点添加到集群中。
3.1 节点信息配置⚓︎
- 主机地址:输入节点的 IP 地址或域名,确保主节点服务器可以访问到该节点
- 用户名:节点的 SSH 连接用户名,需要使用 root 或具有免密 sudo 权限的用户
- 认证方式:支持密码认证和私钥认证两种方式
- 密码认证:输入节点的 SSH 连接密码
- 私钥认证:上传节点的私钥文件,支持 PEM 和 PPK 格式;如果私钥设置了密码,请一并输入
- 端口:节点的 SSH 连接端口,默认为 22
- 安装目录:1Panel 相关内容的安装目录,默认为 /opt
- 安装端口:1Panel Agent 服务的监听端口,默认为 9999,请确保该端口未被占用且主节点服务器可以访问到该端口
- 节点类型:按当前许可证和页面可选项选择节点版本;商业版节点可使用许可证授权的专业版或企业版功能
- 许可证:按页面显示为目标节点选择可用许可证及节点类型。许可证可在 面板设置 -> 许可证 中导入和管理
- 节点分组:选择节点所属的分组,便于分类管理
- 名称:为节点设置一个便于识别的名称,建议使用有意义的命名规则
- 描述:为节点添加描述信息,说明节点的用途和特点
- 数据同步配置:选择特定的配置信息是否需要同步到该节点,包括
- 系统代理设置
- 系统告警设置
- 自定义应用仓库
- 备份账号设置

3.2 可用性检查⚓︎
添加节点前,需要先进行可用性检查,以验证网络连通性和认证信息的正确性。只有通过可用性检查的节点才能成功添加。

3.3 添加节点⚓︎
可用性检查通过后,点击【确定】按钮,完成节点添加。

4 节点管理⚓︎
在节点列表页面,可以查看所有节点的详细信息,包括状态、资源使用情况、当前版本等,并对节点进行各种管理操作。
4.1 节点状态监控⚓︎
- 状态:实时显示节点的在线/离线状态
- 版本:显示当前节点的版本信息及社区版、专业版或企业版标识
- 资源使用率:显示 CPU、内存、磁盘、网络的使用情况
- 数据同步状态:显示节点的数据同步状态

4.2 节点操作⚓︎
支持对节点进行以下操作:
- 编辑:修改节点配置信息
- 删除:从管理端移除节点。是否同时清理节点侧数据,以删除确认框显示为准
- 更新:更新节点版本
- 同步:将主节点配置同步到当前节点
- 重启面板:重启节点面板服务
- 重启服务器:重启节点服务器
5 节点分组管理⚓︎
节点分组功能允许用户按照业务需求、环境类型或地理位置对节点进行分类管理。

6 节点切换⚓︎
在面板管理页面左下角,显示当前节点信息,点击节点名称,可以切换到其他节点。后续进行的所有操作,例如应用部署、网站管理等,都会在当前节点上进行。

7 故障处理⚓︎

当节点状态异常时,可以点击节点列表状态列上的异常图标,查看异常原因。
节点添加和日常通信依赖管理端到节点的网络连通性。排查时应依次确认 SSH、Agent 端口、节点服务状态、证书与版本兼容性,不要在未确认数据备份的情况下直接删除节点。
