使用WSL2运行Node应用时Windows浏览器无法访问的解决求助

检查Node服务器监听地址 #

• 很多Node应用默认只监听WSL内部的127.0.0.1，Windows无法跨网络栈访问这个地址。需修改代码让服务器监听0.0.0.0，接受所有网络接口的请求：
  原代码示例：

  app.listen(3000, '127.0.0.1', () => { ... })
  

  修改后：

  app.listen(3000, '0.0.0.0', () => { ... })
  

  也可直接省略地址参数（默认即为0.0.0.0）：

  app.listen(3000, () => { ... })
  

适配WSL 2的网络模式 #

WSL 2采用虚拟化网络，和Windows不在同一网络栈，需通过WSL的局域网IP访问：

• 在WSL终端执行hostname -I，获取WSL的本地IP（格式如192.168.x.x）
• 在Windows浏览器中用该IP加端口访问，例如http://192.168.x.x:3000

检查Windows防火墙规则 #

Windows防火墙可能拦截WSL端口请求：

• 临时关闭防火墙测试，若能访问则添加入站规则：
  1. 打开Windows Defender防火墙「高级设置」
  2. 新建入站规则，选择「端口」，输入Node应用使用的端口号
  3. 允许连接，应用到所有网络类型，完成规则创建

确认端口未被占用 #

• 在Windows终端执行netstat -ano | findstr :<端口号>，检查端口是否被其他程序占用。若被占用，要么关闭占用程序，要么修改Node应用的监听端口。

利用VS Code Remote扩展的端口转发 #

使用VS Code Remote-WSL扩展时，可手动配置端口转发：

• 按下Ctrl+Shift+P，输入「Port: Focus on Ports View」打开端口面板
• 手动添加Node应用的监听端口，之后直接用127.0.0.1:<端口号>访问即可

内容的提问来源于stack exchange，提问作者syntaX