network-topology-discovery/USAGE_WINDOWS.md

Windows 10 使用说明

解决中文乱码问题

已将脚本中的中文改为英文，避免乱码问题。

在 Win10 上编译和运行

方法一：从网络位置编译（推荐）

1. 打开PowerShell或CMD

2. 切换到项目目录：

   cd \\192.168.6.193\Share\Projects\network-topology-discovery
   

3. 编译程序：

   build.bat
   

4. 运行程序：

   start.bat
   

5. 访问Web界面： 打开浏览器访问：http://localhost:8080

方法二：复制到本地编译（更快）

如果网络位置编译慢，可以：

1. 复制整个项目到本地：

   xcopy \\192.168.6.193\Share\Projects\network-topology-discovery C:\Projects\network-topology-discovery /E /I
   

2. 切换到本地目录：

   cd C:\Projects\network-topology-discovery
   

3. 编译和运行：

   build.bat
   start.bat
   

方法三：手动命令行编译

如果批处理脚本有问题，可以手动执行：

# 切换到项目目录
cd \\192.168.6.193\Share\Projects\network-topology-discovery

# 编译
set GOOS=windows
set GOARCH=amd64
go build -o network-topology.exe -ldflags="-s -w" ./cmd

# 运行
network-topology.exe

常见问题

1. 提示 "go.mod file not found"

原因：没有在项目根目录运行脚本

解决：

# 先切换到正确的目录
cd \\192.168.6.193\Share\Projects\network-topology-discovery

# 确认go.mod存在
dir go.mod

# 然后再运行
build.bat

2. 编译后找不到 network-topology.exe

原因：编译失败或输出到错误目录

解决：

# 手动编译并指定输出路径
go build -o network-topology.exe ./cmd

# 检查文件是否存在
dir network-topology.exe

3. 运行时提示 "web目录不存在"

原因：web文件夹不在正确位置

解决： 确保目录结构如下：

network-topology-discovery/
├── network-topology.exe
├── web/
│   ├── index.html
│   ├── css/
│   └── js/
└── config.json

4. 端口8080被占用

解决： 编辑 config.json，修改端口：

{
  "web": {
    "port": 8081
  }
}

环境要求

确保已安装：

• ✅ Go 1.22 或更高版本
• ✅ Windows 10/11
• ✅ 网络连接（访问网络设备）

检查Go版本：

go version

快速测试

编译完成后，可以快速测试：

# 1. 编译
build.bat

# 2. 启动
start.bat

# 3. 打开浏览器
# 访问: http://localhost:8080

# 4. 测试添加设备
# 点击"添加设备"，输入你的设备IP和SSH凭据

更新项目

如果从Git仓库更新：

# 拉取最新代码
git pull

# 重新编译
build.bat

# 运行
start.bat

---

如有其他问题，请查看 README.md 或提交Issue。