4.2 节点管理与资源同步

一句话判断

节点管理把“多台服务器”变成“一个控制台”——左下角切节点，所有操作自动落在所选节点上；资源同步在节点之间搬文件、镜像、应用和证书。两者都是专业版/企业版能力，节点管理是所有多节点功能（数据库集群、智能体批量任务、资源同步）的地基。

节点管理是什么

版本边界：节点管理需要专业版或企业版许可证。节点列表、节点配置和涉及许可证的操作仅管理员可用；其他用户需要节点查看权限。

官方对节点管理的定位：

通过节点管理，用户可以轻松管理多个服务器节点，实现统一的资源监控、应用部署、配置管理和运维操作。

先建立空间感：这台跑 1Panel 面板的服务器叫主节点，被加进来的叫其他节点。面板左下角显示当前节点，点节点名称切换——切换之后，应用部署、网站管理等所有操作都在当前节点上进行。

这条操作纪律贯穿全书：第 1 章讲网站、第 2 章讲数据库时都提醒过“操作前先看节点选择器”。多节点环境下 90% 的“东西不见了”事故，都是因为在 A 节点上找 B 节点的东西。

节点管理的五项能力

“分组管理”不是摆设：节点一多（比如十几台），按“生产/测试”或“华东/华南”分组，找节点、做批量判断都快得多。

“配置下发”是被低估的能力：主节点配好的备份账号、告警设置，添加节点时勾选同步项，新节点开箱就有同样的配置——不用每台机器重新配一遍。

添加节点：参数与检查

点击【添加节点】，输入节点信息。参数不少，重点说几个：

“安装目录”值得多想一秒：默认 /opt 意味着应用、数据都往这里放。如果新节点的系统盘小、挂了数据盘，先想清楚再填——装完再迁移目录是一件麻烦事。参考第 2 章那套路径记忆：/opt/1panel/apps/... 是各种应用数据的家。

添加前必须先做可用性检查：验证网络连通性和认证信息，只有通过的节点才能成功添加。这一步把 90% 的低级错误（端口不通、密码错、SSH 不允许）挡在门外。

节点列表与日常操作

列表里可以看状态（在线/离线）、版本（社区版/专业版/企业版标识）、资源使用率和数据同步状态。操作有六个：

“删除”和“重启服务器”是危险操作区。官方的提醒：

节点添加和日常通信依赖管理端到节点的网络连通性。排查时应依次确认 SSH、Agent 端口、节点服务状态、证书与版本兼容性，不要在未确认数据备份的情况下直接删除节点。

节点故障排查顺序（官方给出的）：

节点异常排查
  1. SSH 能连吗
  2. Agent 端口（默认 9999）通吗
  3. 节点服务状态（1pctl status 看 agent）
  4. 证书与版本兼容性

点击节点状态列的异常图标可以直接看异常原因——先看这个再动手，比自己猜快。

资源同步：四类对传

资源同步在节点之间同步文件、容器镜像、应用和证书。专业版/企业版，仅管理员或受保护角色可操作，使用前需至少两个可用节点。

文件对传

页面左右两侧分别选节点，浏览目录后通过方向按钮双向传输单个文件或目录。前提：参与传输的节点都装了 rsync。提交后任务日志看进度。

这是“面板版 rsync”——会敲命令的直接用 rsync 也行，面板的好处是给不熟命令的同事一个图形界面，操作有日志留痕。

镜像对传

选源节点上的一个或多个容器镜像，再选目标节点。提交前页面汇总镜像数、节点数和任务数。

两条官方提醒：同步前确认目标节点磁盘空间和镜像架构兼容性。第二点在混用环境（x86 + ARM）特别容易翻车——一个 amd64 镜像同步到 ARM 服务器上，能拉下来但跑不起来。

应用对传

把源节点上一个已安装应用复制到一个或多个目标节点。

支持范围要背下来：

“对传过程中会备份并恢复应用配置和数据”——这意味着对传不是简单复制文件，而是在目标节点上重做一份应用实例。执行前应停止写入或安排维护窗口，并确认目标节点没有名称、端口和目录冲突。

有数据库依赖时要按页面提示配置目标数据库映射——源节点上的数据库叫 A，目标节点上可能叫 B，这个对应关系得你指定。

证书同步

把证书资源推送到其他节点。同步完成后，如果目标网站要用这张证书，还需要在目标节点的网站 HTTPS 配置里完成绑定或替换。

这条“后半句”是重点：同步只是“把文件送过去”，生效要自己去目标网站配置。很多人同步完证书就以为搞定了，结果目标站还是旧证书。

覆盖风险（官方警告）

资源同步会在目标节点创建或覆盖数据。提交任务前应核对源节点、目标节点、资源名称和目标路径，并为重要数据保留独立备份。

四个核对项：源节点、目标节点、资源名称、目标路径。对传是双向的，方向按钮点反了，就是“覆盖了正确的那一边”。

什么时候用资源同步，什么时候别用

注意最后两行：资源同步不是“什么都能传”。它解决的是“同一个东西在多个节点都要有一份”的问题，不是“数据迁移”工具。

本节要点

• 节点管理是专业版能力，是数据库集群、智能体批量任务、资源同步的地基；
• 切换节点后面板所有操作落在当前节点——操作前先看左下角；
• 添加节点前必须做可用性检查，安装目录提前规划；
• 节点排查顺序：SSH → Agent 端口 → 服务状态 → 证书与版本；
• 删除节点以确认框为准，先确认数据备份；
• 应用对传只支持无依赖和 MySQL/MariaDB/PostgreSQL 依赖，OpenResty/Redis/MongoDB 不支持；
• 证书同步只送文件，生效要去目标网站绑 HTTPS；
• 资源同步会覆盖目标数据，提交前核对源、目标、名称、路径。

节点管理与资源同步的完整参数见 《1Panel 官方文档：功能手册》 的“节点管理”与“资源同步”章节，Kubernetes 级别的多机编排不在 1Panel 范围内，别期待它替代专业集群方案。

下一节：规模说完，聊“人”——移动端、用户权限和安全运维报表，见 4.3 节。