在 Windows 上原生安装(免 WSL)

三个组件

Beagle 可直接运行在 64 位 Windows 上。npm 包已经包含原生 helper 和 WireGuard 官方签名的 wintun.dll,不需要另外下载网卡驱动。

1. 安装 Node.js

Beagle 通过 npm 分发 —— npm 是随 Node.js 一起安装的包管理器,而 Node.js 是 OpenJS 基金会的免费开源运行环境。你只需安装一次 Node.js,就得到了下面用到的 npm 和 agentnet 命令。不需要会编程也能完成这些步骤。

node --version
npm --version

2. 安装 Beagle 并创建身份

打开管理员 PowerShell(开始 → 输入 PowerShell → 右键 → 以管理员身份运行),然后执行:

npm install -g @decentnetwork/lan
agentnet --version
agentnet init --name my-windows-pc

3. 安装并启动守护进程

继续在管理员 PowerShell 中执行。这条命令会安装签名的 Wintun 虚拟网卡、10.86.0.0/16 路由,并创建名为 Decent AgentNet 的高权限启动任务,随开机启动、异常退出后自动重启。

agentnet service install

检查运行状态,第一次启动后请等待 60–90 秒让 dora 名单和节点会话完成收敛:

agentnet service status
agentnet diag
Get-NetAdapter -Name agentnet0
Get-NetRoute -DestinationPrefix 10.86.0.0/16

4. 启动代理路由器

另开一个普通 PowerShell 窗口。普通浏览只需启动路由器并保持窗口不关闭。它监听 127.0.0.1:8889,按 Ctrl+C 停止。普通代理、聊天和网页界面都不需要安装 CA 证书。

agentnet proxy router

可选 —— 观看 CCTV 等 HLS 视频:先用 Ctrl+C 停止普通路由器,只需信任一次本机视频 CA(Windows 会弹出安全确认,请允许),再带加速参数启动。该 CA 只在本机生成,只用于指定的国内视频 CDN 域名。

agentnet proxy trust-ca
agentnet proxy router --hls-accel

5. 启动网页界面

再开一个普通 PowerShell 窗口并保持运行,然后浏览器打开 http://localhost:8765 添加好友、聊天和发送文件。按 Ctrl+C 停止界面。

agentnet ui

6. 让 Chrome 使用代理

运行下面的命令,打开一个单独使用 Beagle 的 Chrome,平时的 Chrome 不受影响。默认使用国内分流:匹配的国内网站和视频走可用出口,其他流量直接连接。

& "$env:ProgramFiles\Google\Chrome\Application\chrome.exe" `
  --proxy-server="127.0.0.1:8889" `
  --user-data-dir="$env:TEMP\chrome-beagle" `
  --proxy-bypass-list="<-loopback>"

管理、升级、移除

以下守护进程命令需要在管理员 PowerShell 中运行。路由器和界面就是两个普通 PowerShell 窗口,用 Ctrl+C 停止,重新执行相应命令即可再次启动。

agentnet service status
agentnet service restart
Get-Content -Wait "$env:USERPROFILE\.agentnet\agentnet-service.log"

升级 Beagle,然后分别重启路由器和界面窗口,确保三个组件都用新版本:

npm install -g @decentnetwork/lan@latest
agentnet service restart

可选:把这台电脑作为出口节点

在管理员 PowerShell 中运行。出口代理默认监听本机 AgentNet IP 的 8888 端口。--hls-accel 应运行在观看视频的客户端上,不需要加到每个出口节点。

agentnet proxy enable
agentnet service restart

疑难排查