中文

应用程序

安装 Nginx 和 PHP-FPM

在 Debian 或 Ubuntu 上安装 Nginx 和 PHP-FPM:最新软件源、虚拟主机、独立池、PHP 测试、基本设置、HTTPS、更新与故障排除。

阅读约 6 分钟, 更新于 2026年11月18日

本页内容

您的参数

只需填写一次,指南中的命令会自动更新。

本指南将向您介绍如何从 nginx.org 官方仓库安装 Nginx,并安装较新版本的 PHP-FPM,然后使用独立的虚拟主机和独立的 PHP 池发布一个网站。

订购服务器

为托管您的网站,HostMyServers 提供多种方案:

前提条件

  • 运行 Debian 12/13 或 Ubuntu 22.04/24.04 的服务器
  • 使用 root 或 sudo 用户的 SSH 访问权限
  • 一个域名,其记录指向该服务器(参见 创建 A 记录)
  • 开放 TCP 的 80 和 443 端口

PHP-FPM 通过本地套接字与 Nginx 通信:它不需要开放任何端口。如果您使用 UFW(参见 配置 UFW):

终端
sudo ufw allow 80,443/tcp comment 'Web'

步骤 1:安装 Nginx

如果已经通过发行版的软件包安装了 Nginx,请先备份 /etc/nginx,然后用 sudo apt remove nginx nginx-common 将其移除。

安装所需工具。在 Debian 上:

终端
sudo apt update
sudo apt install curl gnupg2 ca-certificates lsb-release debian-archive-keyring

在 Ubuntu 上:

终端
sudo apt update
sudo apt install curl gnupg2 ca-certificates lsb-release ubuntu-keyring

导入签名密钥并显示其指纹:

终端
curl -fsSL https://nginx.org/keys/nginx_signing.key | gpg --dearmor | sudo tee /usr/share/keyrings/nginx-archive-keyring.gpg > /dev/null
gpg --show-keys /usr/share/keyrings/nginx-archive-keyring.gpg

列表中必须包含指纹 573BFD6B3D8FBC641079A6ABABF5BD827BD9BF62。否则,请删除该文件并到此为止。

添加稳定分支的仓库,设置其优先级,然后安装 Nginx:

终端
. /etc/os-release
echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] https://nginx.org/packages/$ID $(lsb_release -cs) nginx" | sudo tee /etc/apt/sources.list.d/nginx.list
printf 'Package: *\nPin: origin nginx.org\nPin: release o=nginx\nPin-Priority: 900\n' | sudo tee /etc/apt/preferences.d/99nginx
sudo apt update
sudo apt install nginx
sudo systemctl enable --now nginx
nginx -v

步骤 2:安装 PHP-FPM

PHP 项目不提供 APT 仓库。为了在所有这些系统上获得较新的版本,本指南使用 packages.sury.org 仓库,它由 Ondřej Surý 维护,他同时也是 Debian 的 PHP 软件包维护者。这是第三方仓库:只有在您信任它的情况下才添加。

终端
sudo apt install lsb-release ca-certificates curl
curl -fsSLo /tmp/debsuryorg-archive-keyring.deb https://packages.sury.org/debsuryorg-archive-keyring.deb
sudo dpkg -i /tmp/debsuryorg-archive-keyring.deb
echo "deb [signed-by=/usr/share/keyrings/debsuryorg-archive-keyring.gpg] https://packages.sury.org/php/ $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/php.list
sudo apt update

安装 PHP 8.5 及最常用的扩展:

终端
sudo apt install php8.5-fpm php8.5-cli php8.5-curl php8.5-mbstring php8.5-xml php8.5-zip php8.5-intl php8.5-gd php8.5-mysql
php -v
sudo systemctl status php8.5-fpm

请务必安装 php8.5-fpm,而不是通用的 php 软件包,后者可能会引入 Apache。

步骤 3:创建网站

这里每个网站都有一个系统用户。PHP 可以读取代码,但只能写入 uploads:

终端
sudo useradd --system --user-group --home-dir /var/www/您的域名.com --shell /usr/sbin/nologin webapp
sudo mkdir -p /var/www/您的域名.com/public/uploads
sudo chown -R "$USER":webapp /var/www/您的域名.com
sudo find /var/www/您的域名.com -type d -exec chmod 755 {} +
sudo chown webapp:webapp /var/www/您的域名.com/public/uploads

创建一个测试页面:

终端
nano /var/www/您的域名.com/public/index.php
PHP
<?php
header('Content-Type: text/plain; charset=utf-8');
echo 'PHP ', PHP_VERSION, ' (', PHP_SAPI, ')', PHP_EOL;
echo 'User: ', posix_getpwuid(posix_geteuid())['name'], PHP_EOL;
echo 'OPcache: ', (function_exists('opcache_get_status') && opcache_get_status(false)) ? 'on' : 'off', PHP_EOL;

步骤 4:创建 PHP-FPM 池

终端
sudo nano /etc/php/8.5/fpm/pool.d/您的域名.com.conf
配置
[您的域名.com]
user = webapp
group = webapp

listen = /run/php/您的域名.com.sock
listen.owner = nginx
listen.group = nginx
listen.mode = 0660

pm = dynamic
pm.max_children = 10
pm.start_servers = 2
pm.min_spare_servers = 1
pm.max_spare_servers = 3
pm.max_requests = 500

request_terminate_timeout = 120s
catch_workers_output = yes
php_admin_flag[log_errors] = on

停用不再使用的默认池:

终端
sudo mv /etc/php/8.5/fpm/pool.d/www.conf /etc/php/8.5/fpm/pool.d/www.conf.disabled

步骤 5:调整 PHP

将您的设置放在单独的文件中,更新时不会被改动:

终端
sudo nano /etc/php/8.5/fpm/conf.d/90-custom.ini
配置
memory_limit = 256M
upload_max_filesize = 32M
post_max_size = 32M
max_execution_time = 60
date.timezone = Europe/Paris

expose_php = Off
display_errors = Off
log_errors = On

session.use_strict_mode = 1
session.cookie_httponly = 1

opcache.enable = 1
opcache.memory_consumption = 128
opcache.max_accelerated_files = 10000
opcache.validate_timestamps = 1
opcache.revalidate_freq = 2

测试并重启 PHP-FPM:

终端
sudo php-fpm8.5 -t
sudo systemctl restart php8.5-fpm
ls -l /run/php/

套接字 您的域名.com.sock 的所有者必须是 nginx:nginx。

步骤 6:配置 Nginx

停用示例配置,然后创建通用设置:

终端
sudo mv /etc/nginx/conf.d/default.conf /etc/nginx/conf.d/default.conf.disabled
sudo nano /etc/nginx/conf.d/00-defaults.conf
Nginx
server_tokens off;

gzip on;
gzip_vary on;
gzip_min_length 1024;
gzip_types text/plain text/css application/javascript application/json application/xml image/svg+xml;

server {
    listen 80 default_server;
    listen [::]:80 default_server;
    server_name _;
    return 444;
}

server {
    listen 443 ssl default_server;
    listen [::]:443 ssl default_server;
    server_name _;
    ssl_reject_handshake on;
}

当请求与您的任何域名都不匹配时,这两个块会关闭连接。然后创建虚拟主机:

终端
sudo nano /etc/nginx/conf.d/您的域名.com.conf
Nginx
server {
    listen 80;
    listen [::]:80;
    server_name 您的域名.com www.您的域名.com;

    root /var/www/您的域名.com/public;
    index index.php index.html;

    access_log /var/log/nginx/您的域名.com.access.log;
    error_log /var/log/nginx/您的域名.com.error.log;

    client_max_body_size 32m;

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

    location ^~ /uploads/ {
        location ~ \.php$ {
            deny all;
        }
    }

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

    location ~ \.php$ {
        try_files $uri =404;
        fastcgi_pass unix:/run/php/您的域名.com.sock;
        fastcgi_index index.php;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        fastcgi_param DOCUMENT_ROOT $realpath_root;
    }
}

此配置会拒绝访问 .env 之类的隐藏文件,并禁止在 uploads 中执行 PHP。测试并重新加载:

终端
sudo nginx -t
sudo systemctl reload nginx

步骤 7:验证网站

在服务器上:

终端
curl -i -H 'Host: 您的域名.com' http://127.0.0.1/

响应必须是 200 OK,并显示 PHP 版本、用户 webapp 以及 OPcache: on。同时也验证这些保护措施:

终端
echo 'test' > /var/www/您的域名.com/public/.test
curl -s -o /dev/null -w '%{http_code}\n' -H 'Host: 您的域名.com' http://127.0.0.1/.test
rm /var/www/您的域名.com/public/.test

预期的状态码是 403。然后在浏览器中打开 http://您的域名.com。直接请求 IP 地址不会得到响应:这正是默认块想要达到的效果。

步骤 8:启用 HTTPS

请按照指南 使用 Let's Encrypt 安装 SSL 证书 中的 Nginx 部分操作。请忽略其中关于 sites-available 的内容:您的文件是 /etc/nginx/conf.d/您的域名.com.conf。主要命令是:

终端
sudo certbot --nginx -d 您的域名.com -d www.您的域名.com

证书安装完成后,在包含 listen 443 ssl 的 server 块中添加下面这一行以启用 HTTP/2:

Nginx
http2 on;

还请在 /etc/php/8.5/fpm/conf.d/90-custom.ini 中添加下面这一行,使会话 Cookie 仅限 HTTPS 使用:

配置
session.cookie_secure = 1

应用并检查:

终端
sudo nginx -t
sudo systemctl reload nginx
sudo systemctl restart php8.5-fpm
curl -I https://您的域名.com
sudo certbot renew --dry-run

测试结束后,请用您的应用替换测试页面。

PHP-FPM 容量规划

pm.max_children 限制同时处理的 PHP 请求数量。取值过高可能耗尽内存。请测量平均内存消耗,最好在真实负载下进行:

终端
ps --no-headers -o rss -C php-fpm8.5 | awk '{s+=$1; n++} END {printf "%.0f Mo\n", s/n/1024}'
free -m

然后计算:可供 PHP 使用的内存 ÷ 单个进程的平均消耗。例如,1 024 MB ÷ 60 MB 约为 17 个进程。请为系统和数据库保留余量,然后用 sudo systemctl reload php8.5-fpm 重新加载。

更新

终端
sudo apt update
sudo apt upgrade
sudo nginx -t
sudo systemctl status nginx php8.5-fpm

若要升级到 PHP 的新分支,请安装其软件包,将您的池和 90-custom.ini 复制到新版本的目录中,停止旧服务,然后启动新服务。由于套接字名称保持不变,虚拟主机无需更改。请事先测试您的应用。

备份

备份网站及其配置,然后将归档复制到服务器之外:

终端
sudo tar czf site-backup.tar.gz /var/www/您的域名.com /etc/nginx /etc/php/8.5/fpm /etc/letsencrypt
sudo chmod 600 site-backup.tar.gz

该归档包含您证书的私钥。如果网站使用数据库,请单独备份,例如使用 mariadb-dump(参见 安装并保护 MariaDB)。

故障排除

有用的日志是 /var/log/nginx/您的域名.com.error.log 和 /var/log/php8.5-fpm.log。

502 Bad Gateway,并伴有 connect() ... failed (13: Permission denied)

Nginx 无权访问套接字。请检查池中的 listen.owner 和 listen.group,然后重启 PHP-FPM。

502 Bad Gateway,并伴有 connect() ... failed (2: No such file or directory)

PHP-FPM 已停止,或者池与 fastcgi_pass 中的套接字路径不一致。请查看 sudo systemctl status php8.5-fpm 和 sudo php-fpm8.5 -t。

File not found. 或 Primary script unknown

文件不在 root 所指的位置,或者用户 webapp 无法读取它。请用 namei -l /var/www/您的域名.com/public/index.php 检查路径和权限。

浏览器下载了 PHP 文件

location ~ \.php$ 块没有生效。请确认域名与 server_name 匹配,然后重新加载 Nginx。

413 Request Entity Too Large

请增大 Nginx 中的 client_max_body_size,以及 PHP 中的 upload_max_filesize 和 post_max_size,并保持取值一致。

504 Gateway Timeout

脚本超过了 Nginx 的超时时间。如有可能请优化脚本,或同时调整 fastcgi_read_timeout、max_execution_time 和 request_terminate_timeout。

server reached pm.max_children setting

池中的名额已全部被占用。请先查找慢请求,如果内存允许,再增大 pm.max_children。

bind() to 0.0.0.0:80 failed (98: Address already in use)

另一项服务(通常是 Apache)占用了该端口。请用 sudo ss -ltnp | grep ':80 ' 找出它。

curl: (52) Empty reply from server

请求与任何 server_name 都不匹配,默认块关闭了连接。请检查 Host 请求头和已配置的域名。

参考资料