旧自动发现安装迁移
自 Lite 2.3.2、Lite-agent 2.3.1.1 起，自动发现注册接口和后台入口已经下线，Agent 不再通过自动发现创建新节点；当前 Lite 2.3.7 与 Lite-agent 2.3.6.0 继续沿用这一规则。新安装、批量部署和 Docker 重建都应先在 Lite 后台添加节点，再使用该节点“部署指令”中生成的普通命令。
本页只用于迁移历史安装，并保留旧文档链接。不要再为新节点配置 --auto-discovery 或 AGENT_AUTO_DISCOVERY_KEY。
现有安装如何继续运行
旧安装的启动参数仍带有 --auto-discovery、且没有使用普通节点部署参数时，Lite-agent 只会读取程序目录中的现有 auto-discovery.json，以原节点身份继续连接。它不会向 Lite 发起注册，也不会创建新节点。
以下任一情况都会让 Agent 停止启动，并提示从 Lite 中原节点复制普通的 -e -t 部署命令：
auto-discovery.json不存在。- 文件无法读取、JSON 损坏或内容为空。
- 保存的节点身份不完整。
旧安装仍能正常上线时，可以先继续使用，但建议在方便维护时改为普通部署命令，避免后续重建依赖历史文件。
迁移为普通部署
- 在 Lite 后台找到原服务器，打开“节点配置 → 部署指令”。
- 选择实际平台和安装选项，保存并复制完整部署命令。
- 停止旧 Agent 或容器，并备份当前安装目录及
auto-discovery.json。 - 使用刚复制的普通命令重新安装；不要再附加
--auto-discovery。 - 确认 Lite 后台仍是原节点恢复在线，且监控、探测和远程控制状态符合预期。
- 验证完成后，再决定是否删除不再使用的历史身份文件。
迁移时必须从原节点复制部署命令。重新添加一个服务器再安装会得到另一个节点记录，不会接续原节点的历史数据。
Docker 重建
历史自动发现容器在继续使用旧启动方式时，必须保留原来的 /app/auto-discovery.json 挂载；文件缺失或不完整时，Lite-agent 不会重新注册。
重建容器时建议直接改用 Lite 后台为原节点生成的普通 docker run 或 Compose 配置，并移除 --auto-discovery 和 AGENT_AUTO_DISCOVERY_KEY。确认原节点上线前不要删除宿主机上的旧文件。
新节点与批量部署
当前版本不提供自动创建节点的批量注册流程。每台服务器都要先在 Lite 后台添加节点，再分发各自生成的部署命令；不同节点的完整命令不能互换或共用。
安装、状态检查、日志和更新操作见 Agent 安装与维护。