# NetTool 方案设计

本文档作为总入口，详细内容已拆分到 `docs` 目录。

## 文档目录

1. `docs/01-总体方案.md`
   - 项目目标
   - 总体架构
   - 地址与路由策略
   - 安全边界

2. `docs/02-网口识别规则.md`
   - `LAN1`、`LAN2` 逻辑标识定义
   - 真实接口识别规则
   - 多网口场景处理方式

3. `docs/03-通信与HTTP_API.md`
   - UDP 发现协议
   - HTTP API 设计
   - 认证规则
   - 回滚与任务状态

4. `docs/04-客户端流程与MVP.md`
   - Windows 客户端流程
   - 配置与回滚流程
   - 日志建议
   - MVP 范围
   - 后续扩展项

5. `docs/05-Server模块设计.md`
   - Linux Server 模块划分
   - 请求处理链路
   - netplan 与回滚职责
   - 建议实现顺序

6. `docs/06-netplan修改策略.md`
   - 现有 netplan 文件定位规则
   - 目标接口字段修改规则
   - 备份与回滚规则
   - 首版实现边界

7. `docs/07-Server首阶段实现清单.md`
   - Server 第一阶段接口清单
   - 建议结构体与模块顺序
   - 联调前置条件
   - 开发里程碑

8. `docs/08-构建与编译.md`
   - Windows 客户端编译命令
   - Server Windows/Linux 编译命令
   - 一键编译脚本用法
   - 常见编译问题

## 当前约束摘要

1. Linux 发行版：`Ubuntu 24`
2. 网络管理方式：`netplan`
3. 通信协议：`UDP + HTTP`
4. 鉴权方式：固定初始化密码，当前阶段写死在 Server 代码中
5. `LAN1`、`LAN2` 仅作为逻辑标识，实际操作对象为 Linux 真实接口名
6. `LAN2` 保留固定维护地址 `169.254.100.2/16`，同时支持接 4G 路由器联网

## 仓库结构

```text
NetTool/
  server/
    cmd/
    internal/
    go.mod
  windows/
    NetTool.Client/
  docs/
  方案设计.md
```