BKNetwork

BKNetwork 是一个轻量级本地后台服务，带有内置 Web 管理界面，用于简化用户针对北科校园网络的部分管理，并提供免流功能。

仅支持 Windows x64 系统。仅在 Win11 测试，不保证支持 Win10 使用。

tg 博客文章

Github：evansrrr/BKNetwork

Gitee：evansrrr/BKNetwork

下载与安装

在右侧栏 Releases 页面下载带版本号的 .zip 压缩包，解压后双击运行 bknetwork.exe，首次运行需要点击弹窗中 更多信息 并确定继续运行。这是因为软件没有微软签名，不必担心。如果遇到提示需要管理员权限，请选择同意。

使用说明

运行软件后会在系统托盘中显示图标，单击打开网页管理界面（http://localhost:13335），右键点击 退出 即可退出软件。

免流模式 包含 Warp 免流模式 和 DNS64 免流模式，最多同时启用一个。切换通常10s内完成，视网络状态好坏

其中 Warp 免流模式 需要安装 Cloudflare Warp，首次运行选择左侧 "Private browsing"，同意使用条款继续，然后可以使用 Warp 免流模式，需要重启生效。首次使用请在高级模式查看目标网卡，确认自动选择的是上网网卡，例如 WiFi/WLAN，而不是Warp网卡

Cloudflare Warp 软件下载页面（1.1.1.1）大陆地区目前无法访问，可以直接点此下载Windows最新版本，这是官方下载链接

对于北科校园网，USTB-Student 和 USTB-V6 支持 ipv6 免流，USTB_Wi-Fi 不支持。换句话说，免流前提是连接USTB-Student 或 USTB-V6，已登录校园网账号，并且电脑可以正常获取 ipv6 地址（testipv6）

切换到 高级模式 显示更详细的网络状态与控制选项，方便进行单独设置

设置 页面可设置软件开机自启、静默启动、Warp 客户端开机自启等

注：退出软件或开关机时不会自动恢复网络状态，请手动切换。建议在关机前关闭免流模式，否则下次开机后可能因为校园网认证失败无法上网，还得关上免流再登录认证

任何免流方式都是功能大于体验

⚠️新版本修复了v0.9.7及之前版本可能丢失浏览器cookie的bug，若还有相似情况可以反馈

常见问题 FAQ

1. 免流模式真的能实现免流吗？

   • 包的老弟。使用 ipv6 不计费，具体原理 ich.cc.cd

2. 两个免流模式有什么区别？

   • Warp 免流模式：网速快，延迟较低，极少情况可能不稳定，steam和wegame可下载。需要安装 Cloudflare WARP 客户端
   • DNS64 免流模式：原生 ipv6 直连表现良好，但原本不支持 ipv6 的网站较慢，少数应用无法使用

3. 无法使用Warp免流

   • Warp 确实偶尔连不上，稍后再试
   • 确认 Cloudflare WARP 客户端已安装，且在 PATH 中可访问
   • 更换一个 ipv6 DNS，比如 Cloudflare 或阿里的
   • 类似 VMware、 Tailscale 和蓝牙的虚拟网卡会干扰 Warp 的 DNS 连接，请禁用这些虚拟网卡

4. 免流模式不能访问校园网内网（例如校园网登录页和本研一体）

   • 免流模式为仅 ipv6，而校园网内网资源仅支持 ipv4，如需访问请先关闭免流

5. 实时流量监控

   • 推荐 Sniffnet

6. 无法初始化

   • 一些开发环境如 vue.js 可能影响，请自行排除（不折腾就不会有这事）

7. 反馈 Bug & 建议

   • 欢迎提 issue。或者先问问你的 ai 朋友（们）

开发者指南

构建二进制文件

在项目根目录执行：

cd BKNetwork
go build -o bknetwork.exe ./cmd/bknetwork

当前目录会生成 bknetwork.exe。

在 Windows 上构建并打包为服务或分发给别的机器时，建议在与目标平台相同的环境中构建（比如使用带有相同 GOOS/GOARCH 的交叉编译或在目标 Windows 主机上构建）。

如果要连同最新前端一起发布，请使用仓库里的发布脚本，它会先同步 web/ 再构建可分发目录和 zip 压缩包：

cd BKNetwork
.\scripts\build-release.ps1

或右键使用 powershell 运行。

release/ 目录里会包含 bknetwork.exe 和最新的 web/，程序运行时会自动加载同步后的前端页面。

在非 Windows 平台上交叉编译 Windows x64 二进制文件：

# 在 Linux/macOS 环境交叉编译为 Windows amd64
GOOS=windows GOARCH=amd64 go build -o bknetwork.exe ./cmd/bknetwork

以服务方式安装（Windows）

生成 bknetwork.exe 后，使用管理员权限运行安装命令：

# 以管理员身份打开 PowerShell
.\bknetwork.exe install
.\bknetwork.exe start

程序使用 github.com/kardianos/service 做为服务包装，安装/启动/停止命令均由可执行文件暴露（参见 cmd/bknetwork 目录下的实现）

HTTP / WebSocket 接口

• 静态 Web UI：根路径（/）会提供 web 目录下的文件。
• REST 状态接口：/api/v1/status — 返回最近一次网络快照与服务状态。
• 控制接口：/api/v1/switch（切换 IPv4/IPv6）、/api/v1/warp（控制 warp-cli），均为 POST 请求。
• 实时事件：WebSocket 路径为 /ws，会发送 hello、network.status、heartbeat 等事件。

注：改变网络绑定或控制 warp-cli 的命令需要以管理员权限执行，接口会在权限不足或命令不可用时返回错误信息并通过 WebSocket 发布事件。

具体api以后会写

常见问题与排查

• 首次打开页面状态加载慢：服务在采集网络快照时会调用若干 PowerShell 和外部命令（如 warp-cli），可能耗时。建议在疑难排查时直接在服务器主机上运行 go run ./cmd/bknetwork 并观察输出日志。
• warp-cli not found：如果未安装 Cloudflare WARP 客户端，/api/v1/warp 会返回错误并在日志中给出提示。安装后确保 warp-cli 在 PATH 中可访问。
• 权限不足：修改网卡绑定等操作需要管理员权限，若在非管理员上下文运行会收到 403 或相应错误信息。

开发与测试

仓库包含部分单元测试，可用以下命令运行测试：

cd BKNetwork
go test ./...

目录结构（相关）

• cmd/bknetwork — 程序入口与平台相关的包装代码（服务安装、桌面集成等）
• internal/handlers — HTTP 处理器，包含网络快照采集、warp 控制等逻辑
• internal/events — 事件总线，用于将事件广播到 WebSocket 订阅者
• web/ — 前端静态资源

TODO

• 修复浏览器新实例bug
• 新版本检测
• 增加DNS64
• 优化反馈频率
• Warp连接失败反馈->更改探测方式
• “更多免流”链接
• 自定义端口
• 分离css js
• 低饱和度扁平化UI
• 自动登录
• 纯warp-cli

免责声明

本软件仅供学习和研究使用，请勿用于任何非法用途。使用本软件产生的一切后果由用户自行承担。

具体包括但不限于：

• 本软件对因使用或无法使用而导致的任何直接、间接、特殊、偶然或后果性损害不承担责任，包括但不限于数据丢失、业务中断或利润损失。
• 开发者不保证本软件适用于任何特定目的，也不保证本软件完全没有缺陷或错误。
• 用户应当遵守相关法律法规使用本软件，不得利用本软件进行任何非法或违规操作。
• 用户应在遵守校园网及相关网络工具使用条款和规定的前提下使用本软件，开发者不对用户违规使用的行为及其后果负责。
• 因使用本软件而导致的账号被限制、设备被隔离或其他损失，开发者不承担任何责任。

使用本软件即表示你已充分理解并同意本免责声明的全部条款。

---

感谢支持！请我杯喝的QwQ

• Sponsors：

  Hikio, Anon