NGINX反向代理配置后自定义域名my-1stconnection.lan.test无法访问排查

核心原因：域名解析未配置 #

你使用localhost访问时系统会默认解析到本地回环地址127.0.0.1，但自定义域名my-1stconnection.lan.test没有对应的解析记录，浏览器无法确定该域名指向的服务器IP，因此直接抛出"This site can’t be reached"错误。

解决方法 #

修改本地hosts文件添加域名映射：

• Windows系统：用管理员权限打开文件C:\Windows\System32\drivers\etc\hosts
• macOS/Linux系统：用root权限打开文件/etc/hosts
  在文件末尾新增如下一行内容后保存：

127.0.0.1 my-1stconnection.lan.test

修改完成后刷新浏览器即可正常访问站点。

其他可选排查方向 #

如果配置hosts后依然无法访问，可按以下顺序排查：

• 校验并加载NGINX配置：执行命令nginx -t确认配置无语法错误，再执行nginx -s reload重启NGINX加载新配置
• 检查80端口占用：确认80端口为NGINX服务占用，可执行netstat -ano | findstr :80（Windows）或lsof -i:80（macOS/Linux）查看端口占用情况
• 修正隐藏的路径转发问题：你当前配置中location /api对应的proxy_pass末尾加了斜杠，会自动去除请求路径中的/api前缀再转发到后端，比如请求/api/list会被转发为http://localhost:9900/list。如果你的后端接口本身要求携带/api前缀，将对应配置改为proxy_pass http://localhost:9900;即可。

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