无互联网接入的WiFi局域网中如何配置实现gRPC连接

无公网接入的WiFi局域网环境下完全可以正常使用局域网内部署的gRPC服务。gRPC是基于HTTP/2的应用层协议，通信仅依赖客户端与服务端之间的三层网络可达性，不需要连接公网、也不需要公网域名/解析服务支撑，两端接入同一本地WiFi网络已经满足基础通信前提。

• 调整服务端监听配置：服务端启动时不要仅绑定127.0.0.1本地回环地址，需要绑定服务端在当前局域网内的网卡IP，或直接绑定0.0.0.0监听所有网卡的对应端口。以Go语言gRPC服务为例，错误写法是监听127.0.0.1:50051（仅本机可访问），正确写法是监听0.0.0.0:50051，允许局域网其他设备访问。
• 放通服务端防火墙规则：检查服务端设备的系统防火墙（Windows Defender防火墙、Linux ufw/iptables、macOS应用防火墙等），添加入站规则允许gRPC服务监听的TCP端口（常用默认端口为50051，自定义端口以实际配置为准）被局域网网段访问，避免防火墙拦截请求。
• 客户端直连服务端局域网地址：客户端初始化gRPC连接时，直接填写服务端在当前WiFi网络下分配的局域网IP+监听端口即可，例如服务端局域网IP为192.168.3.22、监听端口为50051时，连接地址直接填192.168.3.22:50051，不需要额外配置公网相关参数。
• 关闭路由器端的访问限制：登录WiFi路由器管理后台，检查是否开启了AP隔离/客户端隔离、访客网络隔离功能：AP隔离会禁止同一WiFi下的设备互相通信，访客网络默认会限制连接设备访问局域网内其他节点，这两个功能开启的话需要关闭，才能保证两端网络连通。

• 先做基础连通性校验：在客户端设备上执行ping <服务端局域网IP>，如果ping不通，优先排查：两端是否接入了同一个SSID的WiFi（不要一端连主网一端连访客网）、路由器是否开启了网段隔离、服务端IP是否因为DHCP动态分配发生变化（长期使用建议在路由器后台为服务端设备绑定静态IP，避免IP变动导致连接失败）。
• 排查代理拦截问题：如果客户端设备开启了全局网络代理，需要将本地局域网IP段（比如192.168.0.0/16、10.0.0.0/8）加入代理排除列表，避免代理工具将发往本地服务的gRPC请求转发到公网导致连接失败。
• 端口校验：在客户端设备上使用telnet <服务端IP> <gRPC端口>或者nc -zv <服务端IP> <gRPC端口>测试端口是否能正常连通，如果端口不通，回头检查服务端监听配置和防火墙规则。

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