Ubuntu VPS上ASP.NET Core REST Service公网访问404问题求助

我来帮你一步步排查这个问题，按以下顺序来验证：

• 确认服务监听的地址和端口是否正确
  先在VPS上执行命令，检查dotnet进程的监听状态：

  ss -tulpn | grep 5000
  

  正常输出应该能看到dotnet进程，且监听地址是0.0.0.0:5000（允许所有IP访问）。如果显示的是127.0.0.1:5000，说明命令行的--urls参数被代码覆盖了：

  • 打开你的Program.cs，检查是否硬编码了监听地址，比如有没有类似.UseUrls("http://localhost:5000")的代码，改成.UseUrls("http://0.0.0.0:5000")，或者确保代码优先读取命令行参数（默认的WebHost.CreateDefaultBuilder(args)已经支持，但如果手动指定了Urls会覆盖命令行）。

• 检查VPS的防火墙与外部安全组
  你提到已开放端口，但要分两层验证：

  1. Ubuntu系统防火墙（ufw）：执行ufw status，确认存在5000/tcp的入站允许规则；如果用iptables，执行iptables -L INPUT -n查看是否有接受5000端口的条目。
  2. VPS提供商的外部安全组：很多VPS服务商都有自己的后台安全组规则，即使系统内防火墙放行，外部安全组没开的话公网还是访问不了，一定要去VPS后台检查是否添加了5000端口的入站允许规则（来源选0.0.0.0/0）。

• 验证本地访问是否正常（排除服务本身问题）
  既然localhost也无法访问，先在VPS上用curl测试服务接口：

  curl http://localhost:5000/api/你的接口路径
  

  如果本地curl也返回404，那问题出在服务本身：

  • 检查控制器的路由配置：比如控制器类上是否有[Route("api/[controller]")]属性，接口方法上是否有[HttpGet]等HTTP动词属性，确保路由路径和你访问的一致。
  • 查看服务启动日志：重新启动服务，仔细看控制台输出，有没有依赖加载失败、数据库连接错误等警告/报错，这些可能导致服务启动但接口未正常注册。

• 检查ASP.NET Core环境配置

  • 环境变量影响：执行echo $ASPNETCORE_ENVIRONMENT，如果是Production环境，部分调试接口或静态资源可能不会被启用，你可以临时切换到Development环境测试：

    export ASPNETCORE_ENVIRONMENT=Development
    dotnet SimpleSvc.dll --urls:0.0.0.0:5000
    

  • HTTPS默认监听：ASP.NET Core 3.0+默认会同时监听HTTP和HTTPS端口（通常是5000和5001），如果你只访问了5000但服务实际只启用了HTTPS，也会出现404。可以查看启动日志，确认是否有Now listening on: https://0.0.0.0:5001的提示，这时候要么访问5001端口，要么调整启动参数同时启用HTTP。

• 确认端口未被其他进程占用
  执行以下命令检查5000端口是否被其他进程占用：

  lsof -i :5000
  

  如果有其他进程占用，要么杀掉该进程（用kill -9 <进程ID>），要么换个端口启动你的服务，比如：

  dotnet SimpleSvc.dll --urls:0.0.0.0:5001
  

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