在阿里云 ECS 上部署网站,Nginx 通常负责接收 HTTP 或 HTTPS 请求,再把请求交给静态页面或后端应用处理。实际配置时,除了修改 Nginx 文件,还得核对域名解析、安全组和实例内的防火墙。少检查一处,就可能遇到配置文件没有报错、浏览器却打不开网站的情况。
下面按部署顺序整理阿里云 Nginx 配置的七个步骤,并用一个反向代理故障案例说明常见问题。每次修改后先检查配置,再重载服务,能减少因多处同时改动而难以定位问题的情况。
一、确认 ECS 和网络条件
准备一台运行 Linux 的 ECS、具有管理权限的账号,以及已解析到服务器公网 IP 的域名。域名还没准备好时,可以先用公网 IP 测试 Nginx 是否能对外提供服务。
- 确认系统版本:安装命令和服务管理方式会因 Linux 发行版而异,先确认当前系统使用哪种包管理器和服务管理工具。
- 确认公网 IP:在阿里云控制台查看 ECS 是否分配了公网 IP,或是否通过弹性公网 IP 对外提供访问。
- 检查安全组:按业务需要放行入方向 TCP 80 和 443 端口。不要为了排错直接开放所有端口。
- 确认后端服务:如果要使用反向代理,先确认应用已经启动,并能在服务器本机访问其监听地址和端口。
阿里云安全组控制云平台侧的网络访问,Linux 防火墙则在 ECS 实例内部生效。两处都可能拦截流量。外网访问不通时,应分别检查安全组规则和系统防火墙,不要只盯着 Nginx 配置。
二、安装并启动 Nginx
安装命令取决于操作系统。以使用 DNF 的系统为例,先安装 Nginx,再设置开机启动并立即启动服务:
sudo dnf install nginx
sudo systemctl enable --now nginx
其他发行版应使用对应的软件源和包管理器。安装后运行 sudo nginx -t 检查配置语法,再用 sudo systemctl status nginx 查看服务状态。
可以先在浏览器中访问 ECS 公网 IP。如果看到 Nginx 默认页面,说明服务已启动,且当前网络路径至少允许访问默认站点。若浏览器一直等待或连接超时,优先核对公网 IP、安全组和系统防火墙;若连接被拒绝,再检查 Nginx 是否正在运行。
三、配置域名和静态网站
假设域名是 www.example.com,网站文件存放在 /var/www/example。先将域名的 A 记录指向 ECS 公网 IP,再为站点添加 Nginx 配置。例如:
server {
listen 80;
server_name www.example.com example.com;
root /var/www/example;
index index.html;
location / {
try_files $uri $uri/ =404;
}
}
Nginx 配置文件的位置会随发行版和安装方式变化,常见做法是将站点配置放在系统约定的配置目录或站点目录中。保存后运行 sudo nginx -t;确认语法检查通过,再执行 sudo systemctl reload nginx,让新配置生效。
域名能解析但页面返回 404 时,检查 root 指向的目录、首页文件是否存在,以及 Nginx 用户是否有读取权限。也要确认 server_name 与浏览器中输入的域名一致;配置写了一个域名、实际访问另一个域名时,请求可能落到其他站点配置。
四、配置反向代理,将请求交给后端
一种常见部署方式是让 Nginx 对外监听 80 端口,后端应用只监听本机的 3000 端口。可以在站点配置中加入以下内容:
location / {
proxy_pass http://127.0.0.1:3000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
127.0.0.1:3000 只适用于后端应用和 Nginx 部署在同一台 ECS 上的情况。若应用在其他主机或容器中,应改用 Nginx 实际能够访问的地址,并检查相应网络规则。
这些转发请求头可以把原始域名、客户端 IP 和访问协议传给后端。后端需要正确配置可信代理范围;如果无条件信任外部请求中的转发头,客户端可能伪造相关信息。
五、启用 HTTPS 并妥善保管证书
正式网站应配置 HTTPS。可以通过阿里云数字证书服务部署证书,也可以使用可信证书颁发机构签发的证书。取得证书文件后,在 Nginx 的 443 站点配置中填写证书和私钥路径,并设置 listen 443 ssl;。证书需要覆盖实际访问的域名,私钥文件应限制读取权限,也不能放在网站公开目录中。
配置完成后,先运行 sudo nginx -t,检查通过再重载服务。随后分别测试 HTTP 和 HTTPS,确认 HTTPS 访问正常后,再根据业务需要把 HTTP 请求跳转到 HTTPS。证书尚未生效或没有覆盖访问域名时,不要急着启用跳转,否则访问者可能看到证书错误。
六、案例:首页正常,接口却返回 502
某团队将网站部署在阿里云 ECS 上,域名可以打开首页,但调用接口时返回 502。检查后发现,Nginx 正常监听 80 端口,安全组也已放行;问题出在后端应用没有启动。Nginx 转发到 127.0.0.1:3000 时,因目标端口没有服务监听而连接失败。
排查时先在 ECS 上确认应用进程和监听端口,再运行 curl http://127.0.0.1:3000,检查后端能否本机访问。启动应用后重新请求接口,服务恢复。如果后端本机可访问,Nginx 仍返回 502,就继续核对代理地址、应用绑定地址和错误日志。常用查看命令是 sudo tail -n 100 /var/log/nginx/error.log,实际日志路径可能因系统配置而不同。
七、上线前检查常见故障
- 修改配置后没有变化:运行
nginx -t,确认通过后 reload;同时核对修改的是当前实际加载的配置文件。 - 外网连接超时:检查 ECS 公网 IP、域名解析、安全组和系统防火墙是否允许对应端口。
- 页面返回 404:核对站点根目录、目标文件、目录读取权限和
try_files规则。 - 请求返回 502:确认后端进程正在运行,监听端口与代理地址一致,并查看 Nginx 错误日志。
- HTTPS 访问报错:检查证书是否匹配域名、是否在有效期内,以及证书链和文件路径是否正确。
阿里云 Nginx 配置涉及域名、云端网络规则、站点文件和后端服务,排查时可以按这几处逐项核对。改动尽量一次只涉及一类设置,语法检查通过后再测试访问结果和日志。部署完成后,及时更新系统与 Nginx、备份配置,并只开放业务需要的端口。