客户端无法访问Web API：本地正常、远程IP访问超时求助

常见排查与解决步骤 #

1. 修正应用监听地址 #

默认启动dotnet project.dll时，应用仅监听localhost，外部机器无法接入。需调整监听范围：

• 代码配置：在Program.cs里指定监听所有网卡地址

var builder = WebApplication.CreateBuilder(args);
// 其他业务配置
var app = builder.Build();
// 替换[PORT]为实际端口号
app.Run("http://0.0.0.0:[PORT]");

• 命令行指定：启动时直接附加参数

dotnet project.dll --urls=http://0.0.0.0:[PORT]

2. 开放服务器端口防火墙 #

• Windows：打开「Windows Defender防火墙」→ 高级设置 → 新建入站规则，选择端口类型，允许目标[PORT]的TCP连接。
• Linux：根据发行版执行对应命令，例如ufw allow [PORT]/tcp或firewall-cmd --add-port=[PORT]/tcp --permanent && firewall-cmd --reload。

3. 验证网络连通性 #

• 在客户端执行ping [IP_ADDRESS]，确认服务器网络可达；若不通先排查局域网/公网链路问题。
• 用telnet [IP_ADDRESS] [PORT]或PowerShell命令Test-NetConnection [IP_ADDRESS] -Port [PORT]测试端口是否开放，若连接失败说明端口未放行或应用监听配置有误。

4. 检查服务器网络与云安全组 #

• 确认服务器使用的是客户端可访问的局域网IP/公网IP，避免使用仅本地可见的127.0.0.1类地址。
• 若服务器在云平台，需检查云服务商的安全组规则，确保目标[PORT]的入站权限已开启。

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