局域网 IPv4 跨设备测试 API 方法

一分耕耘，一分收获！既然打开了这篇文章《局域网 IPv4 跨设备测试 API 方法》，就坚持看下去吧！文中内容包含等等知识点...希望你能在阅读本文后，能真真实实学到知识或者帮你解决心中的疑惑，也欢迎大佬或者新人朋友们多留言评论，多给建议！谢谢！

本文教你如何将本地开发的 PHP Laravel（或其他支持 `php artisan serve` 的框架）API 服务暴露到同一 Wi-Fi 网络下的其他电脑，解决“仅 localhost 可访问、用本机 IPv4 访问失败”的常见问题。

默认情况下，php artisan serve 仅绑定到 127.0.0.1（即 localhost），这意味着外部设备无法连接——即使它们和你处于同一局域网（如 192.168.2.x 网段）。要让其他 PC 能通过你的 IPv4 地址（例如 http://192.168.2.222:8000/api/users）成功调用 API，关键在于显式指定监听地址为本机局域网 IP，并确保网络与系统层面允许入站连接。

✅ 正确启动服务：绑定到局域网 IP

在项目根目录下，执行以下命令（将 192.168.2.222 替换为你本机实际的 IPv4 地址）：

php artisan serve --host=192.168.2.222 --port=8000

? 如何查自己的 IPv4？

• Windows：运行 ipconfig，查找「无线局域网适配器 WLAN」下的 IPv4 地址；
• macOS/Linux：运行 ifconfig | grep "inet " | grep -v 127.0.0.1 或 hostname -I。

此时服务将监听 192.168.2.222:8000，而非仅 127.0.0.1:8000。另一台电脑在浏览器或 Postman 中输入 http://192.168.2.222:8000 即可访问。

⚠️ 常见失败原因与解决方案

? 补充说明与最佳实践

• 不要绑定 0.0.0.0（除非明确需要）：虽然 --host=0.0.0.0 可让服务响应所有网络接口，但会同时暴露给公网（若网络非纯内网），存在安全风险。生产环境严禁使用。
• CORS 注意事项：跨设备访问属于跨源请求，若前端（如 Vue/React）部署在另一台机器上，后端需配置 CORS 头（如 Laravel 可用 fruitcake/laravel-cors 包）。
• 替代方案（更健壮）：对于长期联调，推荐使用 ngrok 或 localtunnel 生成临时公网 URL，避免网络配置依赖。

完成上述步骤后，你的 API 将真正成为局域网内可共享的开发服务，大幅提升多端协作与真机测试效率。

本篇关于《局域网 IPv4 跨设备测试 API 方法》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！