在韩国服务器上搭建网站,如何配置Nginx与PHP运行环境?
在韩国服务器上首次运行 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_64 | cat /etc/os-release、uname -m |
| Web服务器 | Nginx | nginx -v |
| PHP运行方式 | PHP 8.1-FPM | systemctl status php8.1-fpm |
| PHP-FPM通信方式 | Unix Socket | /run/php/php8.1-fpm.sock |
| 站点目录 | /var/www/example.com/public | namei -l |
| 对外端口 | TCP 80 | ss -lntp |
| 域名示例 | example.com | getent 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-fpmphp8.1-cli改为php8.3-cli/run/php/php8.1-fpm.sock改为实际存在的PHP 8.3 Socketphp-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
这段配置的关键点如下:

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. 本机访问正常,公网访问超时
按由外到内的顺序检查:
- 服务商安全组是否允许TCP 80。
- UFW或其他系统防火墙是否允许TCP 80。
- Nginx是否监听公网地址,而不是仅监听本地回环地址。
- A记录是否指向当前公网IP。
- 是否存在错误的AAAA记录。
- 客户端网络是否缓存了旧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



