# 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 迁移。

## 验证

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