服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- 多个 Agent 进程可能来自多个 systemd unit,也可能是一个 unit 的子进程;先查 cgroup 与父进程。
- 比较每个实例的配置路径、面板目标和服务状态,确定需要保留的唯一 agent。
- 只停止并 disable 已确认的重复 unit;保留原 unit 文件与配置,避免误删活动监控进程。
- 重启后确认仅预期实例运行、面板收到新样本且原监控恢复。
先区分多个进程与多个 systemd unit
同一主机出现多个 Nezha Agent 进程时,可能是重复安装了 unit,也可能是一个 unit 管理的主进程和子进程。若直接按进程名全部结束,可能会停止唯一有效的监控连接;若删除某个 unit 文件,也可能丢失仍在使用的配置和开机启动规则。
先确认 PID、父 PID、命令行、cgroup 和所属 unit,然后比较各实例连接的面板地址、安装目录与运行用户。进程列表本身不会显示所有服务语义,面板在线状态也不能单独确定哪个 unit 是正确实例。对照授权的服务器清单和已知配置,明确要保留的实例后再操作。
只读清点 unit、进程与所属 cgroup
通过 systemd 查询已加载的 Agent unit 和开机启用状态,再列出进程树与每个 PID 所属的 cgroup。unit 名称、路径和配置选项会因安装方式不同而变化;先从输出确认实际名称,再替换下面占位符。不要在公开工单中贴出完整服务命令行,因为参数可能包含 token 或面板地址。
若 systemd 中只有一个 unit 却看到多个 PID,先判断它们是否是同一服务正常生成的子进程;不要视为多个 agent 安装。若有多个 unit,则比较各 unit 的 ExecStart、用户、工作目录和配置来源,再识别重复项。
列出 Agent unit 和进程归属
shUNIT='REPLACE_WITH_CONFIRMED_AGENT_UNIT.service'
systemctl list-units --type=service --all | grep -i nezha
systemctl list-unit-files | grep -i nezha
ps -eo pid,ppid,user,cmd --forest | grep -E '[n]ezha|[a]gent'
systemctl is-active "$UNIT"
systemctl is-enabled "$UNIT"
systemctl status "$UNIT" --no-pager
确认应保留哪个监控实例
核对已授权监控面板中的主机身份、最后上报时间和 Agent 配置目标。若两个实例连接不同面板,可能是有意的双监控;只有在确认其中一项是旧安装、测试实例或错误 unit 后,才将它定义为重复。记录有效实例的 unit 名、配置位置和启用状态,作为回滚基准。
不要只依据安装目录名称或 unit 创建时间做决定。配置文件可能存放在默认目录之外,服务也可能由管理脚本生成。无法确认目标面板或服务器归属时,先询问资产负责人并保持只读,不要停止任何实例。
只停止并禁用确认的重复 unit
确认要保留的 unit 正常上报、目标 unit 确为重复且没有其他监控依赖后,先备份重复 unit 文件和它引用的配置。只停止该 unit,然后检查保留 unit 的 ActiveState,并在 Nezha 面板确认同一主机出现新上报样本。两个条件都通过后,才在独立步骤禁用重复 unit;若任一条件未通过,不要执行 disable,也不要删除文件。不要使用 pkill、killall 或按模糊进程名循环结束所有 Agent。
disable 只改变开机启动设置,并不会自动删除 unit 或配置文件。保留文件便于回滚;只有确认该 unit 完全未被其他脚本调用且已完成恢复验证后,才另行评估删除。服务修改可能使监控暂时离线,应安排维护窗口并保留管理员访问通道。
仅停止已确认的重复 unit 并检查保留服务
shDUPLICATE_UNIT='REPLACE_WITH_CONFIRMED_DUPLICATE_UNIT.service'
KEEP_UNIT='REPLACE_WITH_CONFIRMED_KEEP_UNIT.service'
sudo systemctl stop "$DUPLICATE_UNIT"
systemctl is-active "$KEEP_UNIT"
通过验证后单独禁用重复 unit
shDUPLICATE_UNIT='REPLACE_WITH_CONFIRMED_DUPLICATE_UNIT.service'
sudo systemctl disable "$DUPLICATE_UNIT"
重启后核对唯一实例和监控数据
执行维护后检查保留 unit 的 ActiveState、SubState、ExecStart 和进程 cgroup,确认重复 unit 保持 inactive/disabled。再从 Nezha 面板观察该主机的新上报时间、监控数据是否更新以及其他 Agent 主机是否正常。进程数量减少是必要观察之一,但不能证明当前 Agent 仍连到正确面板。
如果保留 unit 也停止上报,恢复备份的 unit 和配置,通过 systemd 启动原服务,再核对配置目标和日志。不要在配置含凭据时开启全量 debug 或公开服务日志。
回滚与停止条件
若保留服务未上报或需要回滚,按操作前记录的 is-enabled 与 is-active 状态恢复重复 unit;原来 disabled 的 unit 不应被一律 enable。只恢复已核实的运行状态,并再次确认监控面板与服务归属。若原状态是 static、masked、failed 或其他模板未覆盖状态,应停下并按原管理方式恢复。保留 unit 文件和配置备份,不要覆盖活动实例。
停止重复 unit 后,只有当预期 unit 正常运行、面板出现新样本且重启后仍不会启动第二个未授权实例,才能确认清理完成。不同 Agent 版本的 unit 模板与进程模型可能不同;以主机的实际 systemd 状态为准。
按记录恢复 unit 原启用与运行状态
shDUPLICATE_UNIT='REPLACE_WITH_CONFIRMED_DUPLICATE_UNIT.service'
ORIGINAL_ENABLED_STATE='REPLACE_WITH_RECORDED_ENABLED_OR_DISABLED'
ORIGINAL_ACTIVE_STATE='REPLACE_WITH_RECORDED_ACTIVE_OR_INACTIVE'
case "$ORIGINAL_ENABLED_STATE" in
enabled) sudo systemctl enable "$DUPLICATE_UNIT" ;;
disabled) sudo systemctl disable "$DUPLICATE_UNIT" ;;
*) printf 'Review the original unit file state before changing it\n' >&2; exit 1 ;;
esac
case "$ORIGINAL_ACTIVE_STATE" in
active) sudo systemctl start "$DUPLICATE_UNIT" ;;
inactive) sudo systemctl stop "$DUPLICATE_UNIT" ;;
*) printf 'Review the original runtime state before changing it\n' >&2; exit 1 ;;
esac
资料来源
常见问题
Nezha Agent 显示两个 PID,就表示重复安装了吗?
不一定。一个 unit 可以管理主进程和子进程。先看父子关系、cgroup 和 systemd unit 归属。
可以直接 pkill 所有 nezha 进程吗?
不要。它可能停止唯一有效的监控实例。先确认 unit 和 PID,再只处理明确的重复服务。
disable unit 会删除配置文件吗?
不会。它主要改变开机启动状态。建议先保留 unit 与配置备份,完成监控验证后再评估是否需要删除。
怎么确认保留的 Agent 仍正常?
检查 unit 状态和配置目标,再确认授权的 Nezha 面板收到该主机的新样本。只看进程存在不够。