NetworkTool/方案设计.md

NetworkTool 方案设计

本文档作为总入口，详细内容已拆分到 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 路由器联网

仓库结构

NetworkTool/
  server/
    cmd/
    internal/
    go.mod
  windows/
    NetworkTool.Client/
  docs/
  方案设计.md