直接将 server.host 设为 '0.0.0.0' 即可实现局域网访问,它使 vite 监听本机所有网络接口(含 localhost 和局域网 ip),手机连同一 wi-fi 后可通过电脑局域网地址访问,且无需手动填写易变的 ip 地址。

直接把 server.host 设为 '0.0.0.0' 就行,这是最常用也最有效的配置方式。它让 Vite 开发服务器监听所有网络接口,包括本机局域网 IP,手机连同一 Wi-Fi 后就能通过电脑的局域网地址访问。
为什么是 '0.0.0.0'?
这个特殊地址不是真实 IP,而是告诉服务器“监听本机所有可用网络接口”。它自动覆盖:
- 本地回环(
localhost/127.0.0.1) - 当前 Wi-Fi 分配的局域网 IP(比如
192.168.1.105) - 其他网卡或虚拟网络接口(如 Docker、WSL2)
不需要手动填你自己的局域网 IP,也不建议写死(比如 '192.168.1.105'),因为 IP 可能变动,而 0.0.0.0 始终生效。
两种配置方式任选其一
效果一样,按你习惯选:
-
改 vite.config.js/ts:在
defineConfig的server里加一行
server: {
host: '0.0.0.0',
port: 5173,
strictPort: false
}
})
-
命令行临时启用:改
package.json的 dev 脚本
"dev": "vite --host 0.0.0.0"
}
启动后怎么看是否成功?
运行 npm run dev 后,终端会输出两行地址:
-
Local:
http://localhost:5173(仅本机) -
Network:
http://192.168.x.x:5173(这就是手机要访问的地址)
如果没看到 Network 行,说明配置没生效——检查是否漏了逗号、引号,或文件路径不对(确保改的是项目根目录下的 vite.config.js 或 .ts)。
手机访问前还要确认三件事
- 手机和电脑连的是同一个 Wi-Fi(不能一个连 Wi-Fi、一个用热点)
- Windows 防火墙允许端口入站(搜索“高级安全 Windows 防火墙”→新建入站规则→端口→TCP 5173)
- Mac 用户需在「系统设置 → 网络 → 防火墙」中允许 Node.js 或关闭防火墙(临时测试)











