在韩国服务器上搭建网站,如何配置Nginx与PHP运行环境?

发布人:A5数据发布时间:2026-11-14 09:59阅读量:32

在韩国服务器上首次运行 PHP 网站,核心是把 Nginx、PHP-FPM 和站点目录接通,而不是为韩国机房单独使用一套特殊配置。下面以 Ubuntu 22.04 LTS、Nginx、PHP 8.1-FPM 和一个站点为基线,按“准备—安装—配置—验证—异常处理—回滚”的顺序完成最小可运行环境。

韩国服务器的地域主要影响访问延迟、DNS解析和服务商网络策略,Nginx与PHP的安装方式仍取决于操作系统和软件版本。示例中的域名 example.com、站点目录和PHP版本都需要替换为实际值;命令输出属于预期示例,不代表已经在某台服务器上执行。

对于面向韩国及周边地区提供网站、业务后台或接口服务的场景,A5idc数据提供韩国首尔物理服务器,并覆盖不同CPU、内存、存储与优化/国际线路组合,可为Nginx与PHP-FPM网站部署提供独立的计算、磁盘和网络资源基础。结合业务访问地区、程序负载与数据规模,还可在多地区服务器产品中规划相应的部署资源。

一、明确环境基线与准备条件

本次配置只完成 Nginx + PHP-FPM 的首次运行,不包含数据库、代码仓库、HTTPS证书、缓存服务或完整上线流程。先固定环境,可以避免安装完成后因为PHP版本、Socket路径或目录权限不一致而反复修改。

项目示例基线主要验证方式
操作系统Ubuntu 22.04 LTS,x86_64cat /etc/os-release、uname -m
Web服务器Nginxnginx -v
PHP运行方式PHP 8.1-FPMsystemctl status php8.1-fpm
PHP-FPM通信方式Unix Socket/run/php/php8.1-fpm.sock
站点目录/var/www/example.com/publicnamei -l
对外端口TCP 80ss -lntp
域名示例example.comgetent ahostsv4

1. 登录权限与网络条件

需要准备以下条件:

  • 具备服务器的 root 权限,或当前账号可以正常使用 sudo。
  • 已确认服务器的公网IPv4地址。
  • 服务商控制台中的安全组、云防火墙或网络ACL允许TCP 80端口。
  • 如果使用域名,已准备好需要指向服务器的A记录。
  • 如果存在AAAA记录,需要确认服务器具备可用IPv6,并且Nginx监听IPv6端口。
  • 服务器上没有其他程序占用80端口,或者已经确认可以调整现有站点配置。
  • 如果是已有业务服务器,先创建云主机快照,并备份将要修改的Nginx配置。

韩国服务器不需要为了机房所在地更换PHP或Nginx的安装方式。软件源优先使用操作系统默认仓库,避免因为追求下载速度而直接添加来源不明的第三方源。

2. 检查操作系统、资源和端口

先执行基础检查,确认实际环境与示例基线是否一致:

. /etc/os-release
printf 'OS: %s %s\n' "$ID" "$VERSION_ID"
uname -m
free -h
df -h /
sudo ss -lntp | grep -E ':(80|443)\b' || true

预期可以看到类似以下信息:

OS: ubuntu 22.04
x86_64

如果80端口已经被Apache、已有Nginx实例或其他程序占用,不要直接停止服务。先确认监听进程及其业务用途:

sudo ss -lntp | grep ':80'
systemctl list-units --type=service --state=running | grep -E 'nginx|apache|httpd'

如果服务器上已有网站,后续应采用新增虚拟主机的方式,而不是覆盖原有配置。

3. 记录时区和现有配置

韩国本地业务通常使用 Asia/Seoul 时区,但是否修改系统时区要根据应用和运维习惯决定。系统时区会影响日志时间、定时任务和部分程序的默认时间处理,不能只因为服务器位于韩国就盲目修改。

先查看当前设置:

timedatectl
timedatectl show -p Timezone --value

如果确认业务和运维都需要使用韩国时间,可以记录原值后再修改:

sudo timedatectl set-timezone Asia/Seoul

回滚时恢复此前记录的时区,例如原来是UTC:

sudo timedatectl set-timezone UTC

如果只是希望应用显示韩国时间,也可以在应用配置中单独设置,不必改变整台服务器的系统时区。

二、安装Nginx与PHP-FPM

1. 更新软件索引

先更新APT软件索引,不建议在首次部署时直接执行没有评估范围的系统级大版本升级:

sudo apt update

确认Ubuntu 22.04仓库能够提供目标软件包:

apt-cache policy nginx php8.1-fpm

如果能看到 Candidate 版本,说明当前软件源具备安装条件。若 php8.1-fpm 没有候选版本,不要直接把配置中的Socket路径写成猜测值,应先确认操作系统版本和仓库提供的PHP版本。

例如Ubuntu 24.04通常使用PHP 8.3系列,此时需要把后文的:

  • php8.1-fpm 改为对应的 php8.3-fpm
  • php8.1-cli 改为 php8.3-cli
  • /run/php/php8.1-fpm.sock 改为实际存在的PHP 8.3 Socket
  • php-fpm8.1 改为实际的FPM检查命令

2. 安装基础软件包

以Ubuntu 22.04和PHP 8.1为例:

sudo apt install -y \
  nginx \
  php8.1-fpm \
  php8.1-cli \
  php8.1-mbstring \
  php8.1-xml \
  php8.1-curl \
  php8.1-zip \
  php8.1-opcache

这些软件包分别承担以下职责:

  • nginx:处理HTTP请求、静态文件和PHP请求转发。
  • php8.1-fpm:以FastCGI方式运行PHP脚本。
  • php8.1-cli:用于命令行检查和脚本执行。
  • mbstring、xml、curl、zip:常见PHP程序的基础扩展。
  • opcache:提供PHP字节码缓存,减少重复编译开销。

如果应用明确使用MySQL或MariaDB,再安装数据库扩展:

sudo apt install -y php8.1-mysql

不要为了“可能用得到”而安装大量扩展。扩展越多,后续版本升级和安全维护的范围越大。

安装完成后确认版本:

php -v
nginx -v
dpkg -l | grep -E 'nginx|php8.1'

需要注意,php -v检查的是命令行PHP版本,不能单独证明Nginx已经能够调用PHP-FPM。PHP-FPM服务和Socket还需要单独验证。

三、准备站点目录并启动PHP-FPM

1. 创建最小站点目录

将站点根目录放在应用的公开目录,例如:

sudo install -d -o root -g www-data -m 0755 /var/www/example.com/public

这里使用 public 作为Nginx根目录,避免把应用的配置文件、依赖目录或版本控制目录直接暴露给浏览器。目录权限说明如下:

  • root拥有目录,减少Web进程修改代码的机会。
  • www-data作为所属组,便于Nginx和PHP-FPM读取文件。
  • 0755允许进程遍历目录并读取公开文件,但不提供所有人写入权限。

不要在整个项目目录上执行 chmod -R 777,也不要在没有明确需求时执行 chown -R www-www-data。如果应用需要上传文件,应单独创建上传目录,并只对该目录授予必要的写权限。

2. 创建临时PHP入口

为了验证PHP-FPM是否工作,可以先创建一个内容简单的入口文件:

sudo tee /var/www/example.com/public/index.php >/dev/null <<'PHP'
<?php
header('Content-Type: text/plain; charset=UTF-8');

echo "nginx-php-fpm: ok\n";
printf("php_version: %s\n", PHP_VERSION);
PHP

这个文件只用于确认请求是否经过PHP-FPM处理,不应在正式应用部署后继续暴露过多环境信息。后续部署真实程序时,用应用自己的入口文件替换它。

3. 检查并启动PHP-FPM

先检查PHP-FPM配置语法:

sudo php-fpm8.1 -t

预期结果类似:

NOTICE: configuration file /etc/php/8.1/fpm/php-fpm.conf test is successful

启动服务并设置为系统启动时自动启动:

sudo systemctl enable --now php8.1-fpm

检查运行状态:

systemctl is-enabled php8.1-fpm
systemctl is-active php8.1-fpm
sudo ss -lx | grep '/run/php/php8.1-fpm.sock'

预期结果分别接近:

enabled
active
u_str LISTEN ... /run/php/php8.1-fpm.sock

如果Socket文件名称不同,应以实际输出为准,并在Nginx配置中使用同一个路径。不要只根据PHP主版本手写Socket路径。

四、配置Nginx站点与PHP转发

1. 备份已有站点配置

如果目标配置文件已经存在,先备份。下面的命令不会修改已有配置,只在存在同名文件时创建带时间戳的副本:

sudo install -d -m 0755 /etc/nginx/site-backups

if [ -f /etc/nginx/sites-available/example.com ]; then
  sudo cp -a /etc/nginx/sites-available/example.com \
    "/etc/nginx/site-backups/example.com.$(date +%Y%m%d%H%M%S)"
fi

如果这是新服务器,也建议保留该备份目录,便于后续出现配置错误时恢复。

2. 创建虚拟主机配置

将下面的 example.com 替换为实际域名:

sudo tee /etc/nginx/sites-available/example.com >/dev/null <<'NGINX'
server {
    listen 80;
    server_name example.com www.example.com;

    root /var/www/example.com/public;
    index index.php index.html;

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

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.1-fpm.sock;
    }

    location ~ /\.(?!well-known).* {
        deny all;
    }
}
NGINX

这段配置的关键点如下:

四、配置Nginx站点与PHP转发配图

  • root只指向公开目录,不指向整个项目目录。
  • try_files优先查找静态文件,找不到时交给应用入口。
  • include snippets/fastcgi-php.conf使用Ubuntu提供的PHP FastCGI通用参数。
  • fastcgi_pass必须与实际PHP-FPM Socket完全一致。
  • 隐藏文件默认拒绝访问,可减少.env等文件被直接下载的风险。
  • access_log和error_log使用独立文件,便于定位单个站点的问题。

本示例只监听IPv4的80端口。如果域名配置了AAAA记录,先检查服务器是否具备正常IPv6:

sudo ss -lnt6

确认IPv6可用后,再在同一个 server 块中增加:

listen [::]:80;

如果服务器没有可用IPv6,应删除错误的AAAA记录,或暂时只使用A记录。否则部分客户端可能优先访问IPv6,表现为域名在某些网络中无法打开。

3. 启用站点并检查配置

创建站点链接:

sudo ln -s /etc/nginx/sites-available/example.com \
  /etc/nginx/sites-enabled/example.com

如果提示目标已存在,先检查它是有效软链接还是已有配置文件:

ls -l /etc/nginx/sites-enabled/example.com

不要直接用强制覆盖参数替换未知配置。确认内容无误后,再根据实际情况处理重复链接。

检查Nginx完整配置:

sudo nginx -t

预期结果:

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

语法检查通过后启动Nginx:

sudo systemctl enable --now nginx
sudo systemctl reload nginx

如果Nginx原本没有运行,enable --now会启动它;如果已经运行,reload会在不中断现有连接的情况下重新加载配置。配置检查没有通过时不要执行reload,应先处理报错。

五、检查安全组、防火墙和DNS

服务器能够本地响应,并不代表公网一定能够访问。韩国服务器通常还会受到服务商安全组、云防火墙和系统防火墙的共同影响。

1. 检查服务商侧端口

在服务商控制台确认至少允许:

  • TCP 22或实际SSH管理端口,仅限必要来源更安全。
  • TCP 80,用于本次HTTP验证。
  • TCP 443,等配置HTTPS时再开放。

如果TCP 80未开放,即使Nginx显示 active,公网访问也可能超时。

2. 检查UFW状态

先查看系统防火墙,不要在不了解现有规则的情况下直接启用或清空规则:

sudo ufw status verbose

如果UFW已经启用,但缺少80端口规则,可以增加:

sudo ufw allow 80/tcp

如果UFW尚未启用,只有在确认SSH规则正确、并且拥有服务商控制台或带外终端的情况下,才考虑启用。假设SSH确实使用22端口,可以先加入SSH规则:

sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw enable

启用防火墙可能导致远程管理连接中断,尤其是SSH端口不是22、来源地址有限制或当前连接依赖其他端口时。回滚由本次部署新增的80端口规则时,应确认该规则不是其他业务共用的:

sudo ufw delete allow 80/tcp

不要为了排障直接执行 ufw reset,这会清除已有防火墙规则,影响范围远大于本次站点配置。

3. 检查DNS解析

在客户端或服务器上检查域名是否已经指向目标公网IP:

getent ahostsv4 example.com

如果服务器安装了DNS查询工具,也可以使用:

dig +short A example.com
dig +short AAAA example.com

A记录应指向服务器公网IPv4。若AAAA记录指向了不可用的IPv6地址,应先修正AAAA记录,否则部分访问者可能无法正常连接。

DNS修改存在缓存时间。配置刚完成时,可以先使用本地 --resolve 验证Nginx,再等待DNS逐步生效,不要把DNS缓存问题误判为PHP配置错误。

六、按层次验证首次运行结果

1. 验证服务状态

systemctl is-active nginx
systemctl is-active php8.1-fpm
sudo nginx -t

三个检查分别用于确认:

  • Nginx进程正在运行。
  • PHP-FPM进程正在运行。
  • 当前配置可以被Nginx接受。

2. 不依赖DNS验证本机请求

使用 --resolve 将域名临时解析到本机,同时保留正确的Host请求头:

curl -i --resolve example.com:80:127.0.0.1 \
  http://example.com/index.php

预期可以看到:

HTTP/1.1 200 OK
Content-Type: text/plain; charset=UTF-8

响应正文应类似:

nginx-php-fpm: ok
php_version: 8.1.x

如果页面返回的是PHP源代码,例如直接出现 <?php,应立即停止继续对外测试,说明Nginx没有把该请求交给PHP-FPM,需要检查PHP location 配置和 fastcgi_pass。

也可以只检查状态码和关键文本:

curl -fsS --resolve example.com:80:127.0.0.1 \
  http://example.com/index.php | grep -q 'nginx-php-fpm: ok' \
  && echo 'PHP request passed'

3. 验证公网访问

DNS和防火墙生效后,从外部网络执行:

curl -i http://example.com/index.php

如果暂时没有DNS,可以用公网IP访问并手动指定Host:

curl -i -H 'Host: example.com' http://服务器公网IP/index.php

公网检查至少确认以下结果:

  • HTTP状态码为200。
  • 返回内容是PHP执行后的文本,而不是PHP源代码。
  • 浏览器地址访问时没有落到Nginx默认站点。
  • 服务器日志中没有持续出现502或权限错误。

4. 查看访问和错误日志

sudo tail -n 50 /var/log/nginx/example.com.access.log
sudo tail -n 50 /var/log/nginx/example.com.error.log
sudo journalctl -u php8.1-fpm -n 50 --no-pager

一次正常的PHP请求通常会在Nginx访问日志中留下200状态码。若返回502,重点查看PHP-FPM日志;若请求没有进入站点日志,则优先检查DNS、Host头、端口和防火墙。

七、常见异常及处理顺序

1. 安装时找不到PHP 8.1软件包

先确认系统版本和软件源:

cat /etc/os-release
apt-cache policy php-fpm php8.1-fpm

如果操作系统是Ubuntu 24.04,应使用仓库提供的PHP 8.3系列,并同步修改服务名、Socket路径和安装包名称。不要只修改安装命令而保留 /run/php/php8.1-fpm.sock,否则Nginx会连接到不存在的文件。

2. Nginx启动失败或提示80端口被占用

查看端口和服务:

sudo ss -lntp | grep ':80'
sudo systemctl status nginx --no-pager
sudo journalctl -u nginx -n 50 --no-pager

如果是已有Web服务占用80端口,不要直接停止它。可以选择:

  • 将新站点并入现有Nginx配置。
  • 在确认业务影响后停止不再使用的服务。
  • 使用其他临时端口进行内部验证。

如果只是配置语法错误,先执行:

sudo nginx -t

根据报错中的文件路径和行号修改,不要用reload反复尝试。

3. 返回502 Bad Gateway

502通常表示Nginx无法连接PHP-FPM,按以下顺序检查:

systemctl is-active php8.1-fpm
ls -l /run/php/
grep -R "fastcgi_pass" /etc/nginx/sites-enabled /etc/nginx/sites-available

重点确认:

  • php8.1-fpm服务是否为 active。
  • /run/php/下是否存在实际Socket。
  • Nginx中的 fastcgi_pass是否使用了同一个Socket。
  • PHP-FPM日志是否显示配置错误或进程启动失败。

修正配置后重新检查并加载:

sudo nginx -t
sudo systemctl reload nginx

如果是权限问题,不要直接给Socket或整个目录执行777权限,应先确认PHP-FPM运行用户和Socket所属组。

4. 访问到Nginx默认页面

这类问题通常不是PHP故障,而是请求没有匹配到目标虚拟主机。检查:

ls -l /etc/nginx/sites-enabled/
grep -R "server_name" /etc/nginx/sites-enabled/

然后确认:

  • 浏览器访问的域名与 server_name一致。
  • DNS已经指向当前服务器。
  • 测试时使用的Host头正确。
  • 目标配置软链接已经启用。
  • default站点没有被误认为是目标站点。

本机测试应优先使用:

curl -i --resolve example.com:80:127.0.0.1 \
  http://example.com/index.php

这样可以区分Nginx匹配问题和公网DNS问题。

5. 返回403 Forbidden

先检查目录层级权限:

namei -l /var/www/example.com/public/index.php
sudo -u www-data test -r /var/www/example.com/public/index.php \
  && echo 'readable'

Nginx用户需要能够遍历 /var/www、站点目录和 public目录,并读取入口文件。不要直接对整个项目执行递归开放权限。修复权限时应限定到实际站点路径,并记录修改前的属主和权限,方便回滚。

6. PHP源代码被直接返回

这是高风险配置错误,应立即停止对外暴露该页面。重点检查:

  • location ~ \.php$是否位于正确的 server 块内。
  • 是否包含了PHP FastCGI配置。
  • fastcgi_pass是否指向有效PHP-FPM Socket。
  • 是否存在更高优先级的静态文件匹配规则。
  • 当前请求是否实际命中了另一个Nginx站点。

修正后必须用 curl确认响应正文不包含 <?php,再恢复公网访问。

7. 本机访问正常,公网访问超时

按由外到内的顺序检查:

  1. 服务商安全组是否允许TCP 80。
  2. UFW或其他系统防火墙是否允许TCP 80。
  3. Nginx是否监听公网地址,而不是仅监听本地回环地址。
  4. A记录是否指向当前公网IP。
  5. 是否存在错误的AAAA记录。
  6. 客户端网络是否缓存了旧DNS结果。

使用以下命令确认监听地址:

sudo ss -lntp | grep ':80'

如果输出是 0.0.0.0:80,通常表示监听所有IPv4地址;如果只显示 127.0.0.1:80,则公网无法直接连接,需要检查其他Nginx配置中的listen设置。

七、常见异常及处理顺序配图

八、验收与回滚检查项

1. 验收清单

首次部署完成后,逐项确认:

  • [ ] 操作系统版本、PHP版本和Nginx版本已记录。
  • [ ] php8.1-fpm服务状态为 active,并设置为自动启动。
  • [ ] 实际PHP-FPM Socket存在,且与Nginx配置一致。
  • [ ] sudo nginx -t返回语法检查成功。
  • [ ] 站点目录只将 public作为Web根目录。
  • [ ] 本机使用正确Host访问时返回200。
  • [ ]响应正文是PHP执行结果,没有暴露PHP源代码。
  • [ ] 公网DNS的A记录指向当前服务器。
  • [ ] 服务商安全组和系统防火墙允许TCP 80。
  • [ ] 访问日志和错误日志路径可读,且没有持续出现502、403或连接错误。
  • [ ] 没有使用777权限,也没有删除或覆盖其他站点配置。
  • [ ] 已保存Nginx配置备份或服务器快照。

2. 配置回滚

如果新站点配置导致Nginx异常,可以先临时停用该站点软链接,而不是删除全部Nginx配置:

sudo mv /etc/nginx/sites-enabled/example.com \
  /etc/nginx/sites-enabled/example.com.disabled

sudo nginx -t
sudo systemctl reload nginx

如果需要恢复部署前的站点配置,先列出备份文件:

sudo ls -lt /etc/nginx/site-backups/

确认目标备份后再恢复:

sudo cp -a /etc/nginx/site-backups/example.com.时间戳 \
  /etc/nginx/sites-available/example.com

sudo nginx -t
sudo systemctl reload nginx

如果服务器上还有其他网站,不要直接停止或卸载Nginx、PHP-FPM。systemctl disable --now php8.1-fpm会影响所有使用该PHP-FPM服务的站点,只有在确认该服务只属于本次新建环境时才可执行。

如果本次只新增了防火墙80端口规则,并且确认没有其他业务依赖,可以回滚该规则:

sudo ufw delete allow 80/tcp

DNS回滚则应恢复此前的A记录,并考虑TTL和本地缓存带来的延迟。目录和PHP测试入口不应使用没有确认范围的 rm -rf 删除;部署真实应用时,直接用正式入口文件替换测试文件,并保留站点目录备份。

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

相关推荐