Nexus/docs/changelog/2026-06-11-server-onboarding-automation.md

Changelog — 2026-06-11 新服务器接入自动化

摘要

创建/导入/凭据轮询添加服务器成功后，后台自动执行 sudoers 配置（含 rsync） + 目标路径探测，无需再手动点「一键配置 sudo」和「检测目标路径」。

动机

• 非 root 新机推送失败多因未配 sudoers
• 运维希望加机后开箱即用

变更

文件	说明
server/application/services/server_onboarding_service.py	调度 onboard 批任务
server/application/services/server_batch_service.py	op onboard
server/application/server_batch_common.py	detect_and_save_target_path 抽取
server/api/servers.py	创建/导入/IP 添加后触发
frontend/.../useServerFormDialog.ts	进度条 + toast
tests/test_server_onboarding.py	单测

行为

1. 非 root：install_nexus_files_sudoers（失败则任务项失败）
2. 未设路径：探测 workerman.bat；失败仍标记成功，提示可推 /www/wwwroot
3. root：跳过 sudo，仅探测（若未设路径）

API 响应可选字段：onboarding_job_id、onboarding_label。

迁移 / 重启

需重启 API / 重建镜像。无 DB 迁移。

验证

pytest tests/test_server_onboarding.py -q
# 新建 ubuntu 服务器 → 底部任务栏「新服务器初始化」