安装 Nginx 和 PHP-FPM
在 Debian 或 Ubuntu 上安装 Nginx 和 PHP-FPM:最新软件源、虚拟主机、独立池、PHP 测试、基本设置、HTTPS、更新与故障排除。
本页内容
您的参数
只需填写一次,指南中的命令会自动更新。
本指南将向您介绍如何从 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
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.inimemory_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.confserver_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.confserver {
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:
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 请求头和已配置的域名。