安装

在 Windows 上安装(WSL2)

在 WSL2 内运行 AgentNet，并让 Windows 浏览器安全访问本地控制台。除非企业策略限制，否则优先用原生安装指南。

2026 年 7 月

准备 WSL2

安装 WSL2

以管理员身份打开 PowerShell，执行后按提示重启。

wsl --install

打开 Ubuntu

完成 Linux 用户名与密码设置，并在 WSL 内安装 Node.js 20+。

安装软件包

在 Ubuntu 终端中运行。

sudo npm install -g pm2 @decentnetwork/lan

创建身份与服务

以 WSL 普通用户初始化，再安装网络助手。

agentnet init
sudo agentnet service install

为 Windows 浏览器启动服务

pm2 start "agentnet proxy router --listen 0.0.0.0:8889" --name agentnet-router
pm2 start "agentnet ui --listen 0.0.0.0:8765" --name agentnet-ui
pm2 save

在 Windows 中打开 http://localhost:8765。当前 Windows 版本会把 localhost 流量转发到 WSL2 环境。

Windows 防火墙

若本机转发被关闭或防火墙阻止，请仅在可信/专用网络中放行 WSL 进程，不要把控制台暴露给不可信局域网。

让 Windows Chrome 使用代理

你从 Windows 浏览,而 Windows 会把 localhost 转发到 WSL,所以让 Windows Chrome 指向 127.0.0.1:8889。在 Windows PowerShell 里运行(不是在 WSL 内),平时的 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>"

其他方式

也可以安装 ZeroOmega 或 FoxyProxy 插件,添加 HTTP 代理 127.0.0.1 端口 8889。想让所有网站都走出口?用 agentnet proxy router --all 启动。

验证

agentnet identity show
agentnet doctor
pm2 status

下一篇在 Windows 上原生安装(免 WSL) →