韩国服务器上的Nginx怎样配置为稳定运行的Web入口

发布人:A5数据发布时间:2026-10-25 08:50阅读量:118

韩国服务器上的 Nginx 可作为网站的 HTTP/HTTPS 入口,将请求转发到本机运行的 Web 应用。首次部署时,先确认域名解析和网络放行,再安装 Nginx、配置反向代理、申请证书并逐项验证;服务能启动并不等于入口已可用,域名、端口、证书和后端应用都需要分别检查。

部署概述配图

以下步骤以 Ubuntu 22.04/24.04、systemd 和一个监听 127.0.0.1:8080 的应用为例。若应用使用其他端口或服务器发行版不同,应相应调整配置与命令;Nginx 不负责安装或启动该应用。

A5数据提供韩国首尔物理服务器租用,覆盖不同CPU、内存、SSD或NVMe存储及优化线路、国际线路方案,可为以Nginx作为Web入口的企业网站、业务后台、接口服务和数据库提供相应的服务器资源基础,适配韩国本地访问及跨境业务的部署需求。

准备条件

部署前确认以下事项:

  • 已有指向韩国服务器公网地址的域名。确认 A 记录指向服务器 IPv4;只有服务器已配置并能通过外部网络访问 IPv6 时,才保留指向该服务器的 AAAA 记录。错误的 AAAA 记录可能导致部分访问者连接失败。
  • 已确认 Web 应用正在运行,并监听本机地址,例如 127.0.0.1:8080。若应用监听其他端口,记录实际地址和端口。
  • 云平台安全组或上游防火墙已允许入站 TCP 80、443。不要为了开放网站端口而改动 SSH 端口或其他无关规则。
  • 有可用的 SSH 管理权限。以下命令以具备 sudo 权限的账户执行。

先核对系统版本、DNS 和后端监听状态:

lsb_release -a
dig +short A example.com
dig +short AAAA example.com
sudo ss -lntp

将 example.com 换成实际域名。A 记录应返回这台服务器的公网 IPv4;若查询到 AAAA,应确认该 IPv6 确实配置在服务器上且公网可达。ss 输出中应能看到后端应用监听的端口。若应用只监听 127.0.0.1:8080,Nginx 与应用在同一台机器时可以直接连接。

逐步部署

1. 安装并检查 Nginx

更新软件包索引并安装 Nginx 与 Certbot 的 Nginx 插件:

sudo apt update
sudo apt install nginx certbot python3-certbot-nginx

查看服务状态和版本:

sudo systemctl status nginx --no-pager
nginx -v

若安装后服务尚未运行,可启动并设置开机启动:

sudo systemctl enable --now nginx

验证本机 HTTP 入口:

curl -I http://127.0.0.1/

若安装成功且默认站点尚未移除,通常会收到 HTTP 响应头;返回默认页面并不代表域名和后端应用已经配置完成。若连接被拒绝,先查看 systemctl status nginx 和错误日志,再继续配置。

2. 配置域名到本机应用的转发

创建一个单独的站点配置文件,便于后续检查和回滚:

sudo nano /etc/nginx/sites-available/example.com

写入以下配置,将 example.com、www.example.com 和 8080 换成实际域名与应用端口。若没有使用 www,删除对应的 server_name 项,并在申请证书时也不要包含该名称。

server {
    listen 80;
    listen [::]:80;
    server_name example.com www.example.com;

    access_log /var/log/nginx/example.com.access.log;
    error_log /var/log/nginx/example.com.error.log;

    client_max_body_size 20m;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_http_version 1.1;

        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;

        proxy_connect_timeout 5s;
        proxy_read_timeout 60s;
        proxy_send_timeout 60s;
    }
}

client_max_body_size 20m 是示例限制,应按业务上传需求调整;超过限制的请求会被 Nginx 拒绝。proxy_read_timeout 是等待后端响应的间隔限制,不是对整个请求处理过程的绝对计时;长时间处理的业务应结合应用行为评估是否调整。除非确实需要,不要直接设置为很大的值来掩盖后端响应慢的问题。

启用站点,并在修改前备份默认站点配置。以下操作只移除 Nginx 默认站点的启用链接,不删除默认配置文件:

sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/example.com
sudo cp -a /etc/nginx/sites-enabled/default /root/nginx-default-enabled.bak 2>/dev/null || true
sudo unlink /etc/nginx/sites-enabled/default 2>/dev/null || true

备份命令应在移除默认链接之前执行。若默认站点本来不存在,备份失败不影响后续操作。若 ln 提示目标已存在,先检查它指向哪个配置,不要覆盖或删除未知站点。

检查配置语法,再让 Nginx 重新加载配置:

sudo nginx -t
sudo systemctl reload nginx

预期 nginx -t 显示语法检查成功,且配置测试通过。若检查失败,不要执行 reload;根据报错路径和行号修正配置后再次测试。reload 会让 Nginx 载入新配置;已有连接通常不需要因此中断。

验证 Nginx 是否转发到应用:

curl -I -H 'Host: example.com' http://127.0.0.1/

若后端响应正常,应收到应用返回的 HTTP 状态码。收到 502 Bad Gateway 时,优先检查应用进程、监听地址和端口;收到 Nginx 默认页面时,检查站点链接、server_name 和配置是否被正确加载。

3. 申请 HTTPS 证书

只有在域名已解析到这台服务器、外部网络可以访问 TCP 80,且 Nginx 的 HTTP 配置已验证通过后,再申请证书。若域名同时包含 example.com 和 www.example.com,两个名称都必须解析并能通过验证。

sudo certbot --nginx --redirect -d example.com -d www.example.com

按提示填写联系邮箱并接受相关条款。Certbot 会通过域名验证申请证书,并调整 Nginx 站点配置,将 HTTP 请求重定向到 HTTPS。申请完成后,重新检查并加载配置:

sudo nginx -t
sudo systemctl reload nginx

如果只使用一个域名,命令中只保留该域名。证书申请失败时不要反复修改 Nginx 配置;先检查域名解析、80 端口放行、服务器时间和 Certbot 输出的验证错误。若域名前面还有 CDN 或其他上游入口,需确认其回源方式与域名验证路径适配当前部署。

每步验证与结果检查

从服务器本机检查 HTTPS 响应:

curl -I https://example.com/

再从服务器外部网络访问域名,确认返回的是预期站点,而不是默认页面或连接错误。检查证书域名、有效期和握手结果:

openssl s_client -connect example.com:443 -servername example.com </dev/null

-servername 用于在 TLS 握手时发送要访问的域名。检查输出中的证书主题、颁发者及有效期;若握手失败,结合 Nginx 错误日志和防火墙规则继续判断。

确认 Nginx 已设置开机启动,并查看服务状态:

sudo systemctl is-enabled nginx
sudo systemctl status nginx --no-pager

查看站点访问日志与错误日志:

sudo tail -n 50 /var/log/nginx/example.com.access.log
sudo tail -n 50 /var/log/nginx/example.com.error.log

访问日志出现请求,说明请求至少到达了 Nginx;它本身不能证明应用业务处理成功。错误日志若持续出现连接拒绝、超时或上游错误,应同步检查后端应用日志及监听状态。Ubuntu 软件包通常会为 Nginx 配置日志轮转,可检查相关规则,避免日志长期增长占满磁盘:

ls -l /etc/logrotate.d/nginx

最后确认自动续期检查可运行:

sudo certbot renew --dry-run

dry-run 用于验证续期流程,不代表证书已在此次操作中实际续期。若提示验证失败,应根据报错确认域名、端口和续期所需的 Nginx 配置;不要通过删除证书或关闭 HTTPS 来绕过错误。

常见异常处理

现象优先检查判断与处理
域名无法连接或超时A/AAAA 记录、安全组、主机防火墙、80/443 监听确认 DNS 返回的地址属于当前服务器,并检查云平台入站规则。若配置了不可达的 AAAA 记录,修正或移除该记录。
nginx -t 报错错误提示中的文件路径与行号检查括号、分号、指令拼写和重复监听配置。修正后重新运行 nginx -t,通过后再 reload。
502 Bad Gatewayss -lntp、应用状态、站点错误日志后端未启动、端口不一致或监听地址不可达时,Nginx 无法转发。确认后端监听地址与 proxy_pass 一致。
413 Request Entity Too Largeclient_max_body_size请求体超过当前限制。仅在业务确有需要时提高限制,同时确认应用端的上传限制不低于 Nginx 限制。
504 Gateway Timeout后端处理耗时、Nginx 错误日志、应用日志通常表示等待上游响应超时。先排查应用是否卡顿或依赖服务异常,再按业务需要评估超时时间。
Certbot 无法验证域名DNS、80 端口、Nginx HTTP 站点配置确认申请的每个域名均指向可访问的入口,且公网能够访问 TCP 80。对照 Certbot 输出定位具体验证失败的域名。

若使用主机防火墙,先查看现有状态和规则,不要在未确认管理入口的情况下直接启用或重置防火墙,以免影响 SSH。云安全组与主机防火墙是两层独立控制,网站端口需要在实际启用的每一层放行。

回滚与验收清单

首次上线后若 HTTPS 配置有误,可先恢复证书配置前的站点文件。申请证书之前应将 HTTP 配置另存一份,例如:

sudo cp -a /etc/nginx/sites-available/example.com /root/example.com.http.bak

回滚时先将该备份恢复到原站点文件,再检查并加载配置:

sudo cp -a /root/example.com.http.bak /etc/nginx/sites-available/example.com
sudo nginx -t
sudo systemctl reload nginx

恢复后的配置仅提供原有 HTTP 入口,不再包含 Certbot 添加的 HTTPS 设置。确认 HTTP 服务恢复后,再按问题原因重新配置证书。不要直接删除 /etc/letsencrypt 中的证书目录;该目录可能包含其他域名或服务使用的证书。若只需撤下本次新增站点,应先确认站点链接确为本次创建,再移除该链接,并在 nginx -t 通过后 reload。

上线验收至少核对以下项目:

  • 域名 A 记录指向正确;若存在 AAAA 记录,IPv6 入口也已验证。
  • 云平台及主机防火墙按需放行 TCP 80、443,SSH 管理通道未受影响。
  • 后端应用监听地址与 Nginx 的 proxy_pass 一致。
  • nginx -t 通过,Nginx 服务正在运行并设置为开机启动。
  • HTTP 请求按预期跳转到 HTTPS,HTTPS 返回目标应用内容,证书覆盖实际访问的域名。
  • 访问日志、错误日志可读取,Certbot 续期 dry-run 检查通过。
  • 回滚配置备份存在且路径明确;恢复后能再次通过配置检查并正常加载。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/5585.html

相关推荐