1Panel 从节点删除指南

1Panel 从节点删除指南

当主节点无法连接时，需要在从节点上操作，清除 1panel-agent 服务以解除绑定关系。

一、概念区分

名称	说明
1Panel	完整的运维面板，拥有独立界面，通常用作主节点
1panel-agent	从节点的代理服务，负责执行主节点下发的指令

二、确认服务状态

# 查看服务状态
systemctl status 1panel-agent

# 列出所有相关服务
systemctl list-unit-files | grep -E "1panel|agent"

三、彻底删除步骤

1. 停止并禁用服务

sudo systemctl stop 1panel-agent
sudo systemctl disable 1panel-agent

2. 卸载程序并清理文件

# 使用官方工具卸载
sudo 1pctl uninstall

# 清理残留文件
sudo rm -rf /var/lib/1panel /etc/1panel /usr/local/bin/1pctl

# 删除 agent 相关文件
sudo rm -f /usr/local/bin/1panel-agent /usr/local/bin/1panel-core

# 清理 systemd 服务文件
sudo rm -f /etc/systemd/system/1panel-agent.service
sudo systemctl daemon-reload

3. 验证结果

sudo systemctl list-unit-files | grep 1panel

无返回结果表示清理完成。

四、注意事项

1. 数据不可逆：1pctl uninstall 会删除所有通过该节点安装的应用、数据等，请提前备份
2. 系统依赖：Docker、Nginx 等由 1Panel 安装的系统级依赖不会被自动删除
3. 重新添加节点：清理后可直接通过主节点重新添加

五、总结

手动在从节点上清理 1panel-agent 是强制解绑的有效方法。操作时需按顺序执行，仔细确认文件路径，避免误操作。