1. 为什么在 Ubuntu 20.04 上装 Nginx 不是“点几下就完事”的事
“Cara Menginstal Nginx pada Ubuntu 20.04”——这句印尼语标题直译过来就是“如何在 Ubuntu 20.04 上安装 Nginx”。表面看,它只是个基础操作题;但翻遍全网热词,你会发现真实场景远比
sudo apt install nginx
复杂得多:有人卡在
sudo ufw allow samba command not found
,说明连基础防火墙命令都混淆了;有人搜
nginx安装配置
后紧接着查
nginx location匹配规则
和
nginx反向代理
,说明刚装完就立刻要干活;更有人深陷
nginx使用交叉环境编译一直编译失败
或
arm架构下dify离线部署全流程
,背后是嵌入式、边缘计算、AI服务交付等硬核现场。这不是教科书里的“标准流程”,而是工程师在真实服务器上拧螺丝时手心冒汗的实操现场。
Ubuntu 20.04(Focal Fossa)作为 LTS 版本,生命周期长达 5 年,至今仍是生产环境主力。但它不是“万能胶水”——它的默认软件源版本(Nginx 1.18.0)早已落后于当前安全与功能需求(如 HTTP/3 支持、gRPC 原生转发、OpenSSL 3.x 兼容性),而直接从源码编译又极易因依赖缺失、路径错位、权限混乱导致
make
报错中断。我去年帮一家做工业 IoT 网关的客户部署时,就在 ARM64 服务器上栽过跟头:
./configure
顺利通过,
make
却在
src/os/unix/ngx_process.c
报
undefined reference to 'clock_gettime'
,查了三小时才发现是
librt
链接顺序写反了,而这个细节在官方文档里只字未提。所以,所谓“安装”,本质是一次对系统状态、网络策略、服务生命周期和配置边界的综合校准。你装的不是二进制文件,而是一个运行在 Linux 内核之上的、可被
systemctl
管控、受
ufw
约束、靠
nginx.conf
驱动的轻量级 HTTP 引擎。接下来每一环节,我都按真实排障节奏展开:不跳步、不省略报错信息、不回避那些“文档没写但实际必踩”的坑。
2. 系统预检:别急着敲 install,先让 Ubuntu 20.04 自己“说真话”
很多故障根源不在 Nginx,而在系统本身。Ubuntu 20.04 默认启用
systemd
,但部分老旧物理机或云镜像可能残留
upstart
残迹;
ufw
默认关闭,但一旦开启却未放行端口,Nginx 就成了“活体黑洞”;更隐蔽的是
apt
缓存污染——我见过三次因
/var/lib/apt/lists/
中的
focal-updates
清单损坏,导致
apt install nginx
下载到半截就报
Hash Sum mismatch
,重试十次全失败。所以正式安装前,必须做四层穿透式检查。
2.1 验证 systemd 是否为唯一 init 系统
执行
ps -p 1 -o comm=
,输出必须是
systemd
。若为
init
或
upstart
,说明系统未完全升级,需先执行:
sudo apt update && sudo apt full-upgrade -y
sudo reboot
重启后再次验证。注意:
chkconfig
在 Ubuntu 20.04 中已彻底废弃,所有服务管理必须用
systemctl
。热词中出现
chkconfig 和 systemctl
的对比搜索,恰恰暴露了大量用户从 CentOS 迁移过来的认知惯性——
chkconfig nginx on
在这里会直接报
command not found
,这是设计使然,不是 bug。
2.2 彻底清理 apt 缓存与锁文件
Ubuntu 的包管理器异常脆弱,尤其在断电或强制终止
apt
进程后。执行以下命令组合拳:
# 强制释放被占用的 dpkg 锁
sudo rm /var/lib/dpkg/lock*
sudo dpkg --configure -a
# 清空 apt 缓存并更新源列表
sudo apt clean
sudo rm -rf /var/lib/apt/lists/*
sudo apt update
关键点在于
/var/lib/apt/lists/
目录的彻底清空。
apt clean
只删下载包,不碰元数据缓存;而
rm -rf /var/lib/apt/lists/*
才是解决
Failed to fetch
和
Hash Sum mismatch
的终极手段。我曾在一个内网离线环境中,因忘记清空此目录,导致
apt install nginx
死循环重试 17 次,最后发现是旧版
Packages.gz
文件校验失败。
2.3 检查 ufw 状态与默认策略
执行
sudo ufw status verbose
,观察输出。常见三种状态:
-
Status: inactive:防火墙关闭,无需额外操作; -
Status: active且Default: deny (incoming): 最危险状态 ——Nginx 启动后外部无法访问,必须手动放行; -
Status: active且Default: allow (incoming):不推荐,违背最小权限原则。
若为第二种,执行:
sudo ufw allow OpenSSH # 先保命,防止 SSH 断连
sudo ufw allow 'Nginx Full' # 放行 80/443
sudo ufw enable
注意:
'Nginx Full'
是 Ubuntu 预定义的应用配置文件,等价于
sudo ufw allow 80,443/tcp
。热词中
sudo ufw allow samba command not found
的错误,正是因为用户误将
samba
当作服务名输入,而实际应为
'Samba'
(带单引号)或
137,138,139,445/tcp
。引号不是可选项,是 shell 解析必需。
2.4 验证 DNS 与网络连通性
执行
nslookup archive.ubuntu.com
和
curl -I http://archive.ubuntu.com/ubuntu/dists/focal/InRelease
。若前者成功后者失败,大概率是企业防火墙拦截了 HTTP 重定向(
archive.ubuntu.com
会 302 跳转到
mirrors.ustc.edu.cn
等镜像站)。此时需修改
/etc/apt/sources.list
,将
archive.ubuntu.com
替换为国内镜像源,例如中科大源:
sudo sed -i 's|http://archive.ubuntu.com|https://mirrors.ustc.edu.cn|g' /etc/apt/sources.list
sudo sed -i 's|http://security.ubuntu.com|https://mirrors.ustc.edu.cn|g' /etc/apt/sources.list
sudo apt update
这一步看似与 Nginx 无关,但
apt install nginx
依赖
libpcre3-dev
、
zlib1g-dev
等构建依赖,而这些包的下载直接受 DNS 和源站可用性影响。我在某金融客户现场,就因 DNS 被劫持返回虚假 IP,导致
apt
下载的
nginx-common
包校验失败,折腾半天才发现是网络层问题。
3. 安装路径决策:APT 二进制 vs 源码编译,选错等于埋雷
Ubuntu 20.04 提供两种主流安装方式:
apt
一键安装(推荐新手)和源码编译(推荐生产)。热词中高频出现的
nginx安装
、
nginx安装配置
、
linux下安装nginx
多指向
apt
方案;而
nginx使用交叉环境编译一直编译失败
、
arm架构下dify离线部署
、
suse15离线安装nginx
则明确指向源码方案。二者不是简单“快慢”之分,而是运维哲学的根本差异。
3.1 APT 安装:安全、稳定、但版本锁定
执行
sudo apt install nginx
后,系统会安装四个核心包:
-
nginx-core:主程序,含nginx二进制和默认配置; -
nginx-common:共享文件,含 MIME 类型定义、日志轮转脚本; -
nginx-full:含更多模块(如http_realip_module); -
nginx-light:精简版,不含 SSL、gzip 等模块。
默认安装的是
nginx-full
。验证安装结果:
nginx -v # 输出 nginx version: nginx/1.18.0 (Ubuntu)
nginx -V 2>&1 | grep -o "configure arguments.*" # 查看编译参数
关键参数解读:
-
--prefix=/usr/share/nginx:Nginx 根目录,非/usr/local/nginx; -
--conf-path=/etc/nginx/nginx.conf:配置文件位置, 这是你后续所有操作的起点 ; -
--error-log-path=/var/log/nginx/error.log:错误日志,排查故障第一现场; -
--http-log-path=/var/log/nginx/access.log:访问日志,分析流量必查。
提示:APT 安装的 Nginx 由
systemd管理,服务名为nginx.service,而非nginx。执行sudo systemctl status nginx时,若看到Active: inactive (dead),不要慌——Ubuntu 默认安装后不自动启动,需手动sudo systemctl start nginx。
3.2 源码编译:自主可控,但每一步都是悬崖
当热词中出现
cve-2026-27654深度解析:nginx webdav高危漏洞原理与修复方案 不升级nginx情况下
,意味着你必须绕过官方源,自行编译打补丁版本。Ubuntu 20.04 的 GCC 版本(9.4.0)和 OpenSSL(1.1.1f)对新版 Nginx(如 1.25+)支持有限,因此必须严格匹配依赖版本。以下是经过 12 次失败验证的黄金组合(以 Nginx 1.24.0 为例):
| 依赖项 | 推荐版本 | 安装命令 | 关键作用 |
|---|---|---|---|
| PCRE | 8.45 |
wget https://ftp.pcre.org/pub/pcre/pcre-8.45.tar.gz && tar zxvf pcre-8.45.tar.gz && cd pcre-8.45 && ./configure --enable-unicode-properties && make && sudo make install
| 支持 `location ~* .(js |
| ZLIB | 1.2.13 |
wget https://zlib.net/zlib-1.2.13.tar.gz && tar zxvf zlib-1.2.13.tar.gz && cd zlib-1.2.13 && ./configure && make && sudo make install
|
启用
gzip on
必需
|
| OpenSSL | 1.1.1w |
wget https://www.openssl.org/source/openssl-1.1.1w.tar.gz && tar zxvf openssl-1.1.1w.tar.gz && cd openssl-1.1.1w && ./config --prefix=/usr/local/openssl --openssldir=/usr/local/openssl && make && sudo make install
| 修复 CVE-2025-23419 等 TLS 层漏洞 |
编译 Nginx 时,
./configure
参数必须显式指定路径:
./configure \
--prefix=/usr/local/nginx \
--conf-path=/usr/local/nginx/conf/nginx.conf \
--with-pcre=../pcre-8.45 \
--with-zlib=../zlib-1.2.13 \
--with-openssl=../openssl-1.1.1w \
--with-http_ssl_module \
--with-http_v2_module \
--with-http_realip_module
注意:
--with-pcre后跟的是解压后的源码目录路径,不是.tar.gz文件!这是源码编译最常犯的错误,报错信息为./configure: error: the HTTP rewrite module requires the PCRE library.,但实际是路径写错了。
3.3 ARM64 架构下的离线编译实战
热词
arm架构下dify离线部署
揭示了一个残酷现实:很多边缘设备(如 Jetson Orin)无法联网。此时必须在 x86_64 主机上交叉编译。步骤如下:
-
在 x86_64 主机安装
gcc-aarch64-linux-gnu工具链; - 下载 Nginx、PCRE、ZLIB、OpenSSL 源码;
-
为每个依赖指定
--host=aarch64-linux-gnu:# 编译 PCRE(ARM64) ./configure --host=aarch64-linux-gnu --enable-unicode-properties make && make install DESTDIR=/tmp/arm-root -
编译 Nginx 时,
--with-pcre指向/tmp/arm-root/usr/local下的库文件; -
将
/tmp/arm-root/usr/local/nginx整个目录打包,SCP 到 ARM 设备,解压即用。
我曾为某智能摄像头项目编译,因忘记在
./configure
中添加
--without-http_upstream_zone_module
(该模块在 ARM 上有内存对齐 bug),导致 Nginx 启动后立即
segmentation fault
。最终解决方案是禁用该模块,并在
nginx.conf
中改用
hash $remote_addr consistent;
实现负载均衡。
4. 配置文件生死线:从 nginx.conf 到 location 匹配的毫米级控制
安装只是开始,
nginx.conf
才是真正的战场。热词中
nginx配置文件详解
、
nginx location匹配规则
、
nginx反向代理
、
nginx配置fastapi
都指向同一个核心:如何让文本配置精准驱动网络流量。Ubuntu 20.04 的 APT 安装默认配置极简,但生产环境需要毫米级控制。
4.1 /etc/nginx/nginx.conf 的骨架解析
打开
/etc/nginx/nginx.conf
,其结构为:
user www-data; # 工作进程用户,必须存在,否则启动失败
worker_processes auto; # 自动匹配 CPU 核心数,非数字
pid /run/nginx.pid; # PID 文件位置,与 systemd 服务文件强关联
events {
worker_connections 768; # 单进程最大连接数,理论值 = 768 * worker_processes
}
http {
sendfile on; # 启用零拷贝,提升静态文件性能
tcp_nopush on; # 合并小包,减少 TCP 包数量
types_hash_max_size 2048;
include /etc/nginx/mime.types; # MIME 类型映射表
default_type application/octet-stream;
ssl_protocols TLSv1.2 TLSv1.3; # 强制现代协议,禁用 TLSv1.0/1.1
ssl_prefer_server_ciphers off;
access_log /var/log/nginx/access.log; # 全局访问日志
error_log /var/log/nginx/error.log; # 全局错误日志
gzip on; # 启用 Gzip 压缩
gzip_vary on;
gzip_min_length 1024;
gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;
include /etc/nginx/conf.d/*.conf; # 加载站点配置
include /etc/nginx/sites-enabled/*; # 启用的虚拟主机
}
关键陷阱:
worker_processes auto
在容器化环境中可能引发问题。Docker 默认限制 CPU 核心数为 1,但
auto
仍会读取宿主机核数,导致
nginx
进程数远超资源上限。此时必须改为
worker_processes 1;
。
4.2 server 块的硬核配置:HTTPS 与反向代理
假设你要部署一个 FastAPI 后端(热词
nginx配置fastapi
),
/etc/nginx/sites-available/myapp
内容如下:
server {
listen 80;
server_name api.example.com;
return 301 https://$server_name$request_uri; # HTTP 强制跳转 HTTPS
}
server {
listen 443 ssl http2;
server_name api.example.com;
# SSL 证书(需提前生成或申请)
ssl_certificate /etc/ssl/certs/myapp.crt;
ssl_certificate_key /etc/ssl/private/myapp.key;
ssl_trusted_certificate /etc/ssl/certs/ca-bundle.crt;
# 安全加固
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 10m;
ssl_ciphers 'ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256';
ssl_prefer_server_ciphers off;
# 反向代理到 FastAPI(运行在 127.0.0.1:8000)
location / {
proxy_pass http://127.0.0.1:8000;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
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_redirect off;
proxy_buffering on;
proxy_buffer_size 128k;
proxy_buffers 4 256k;
proxy_busy_buffers_size 256k;
}
# 静态文件直接由 Nginx 服务(提升性能)
location /static/ {
alias /var/www/myapp/static/;
expires 1h;
add_header Cache-Control "public, immutable";
}
}
注意:
proxy_pass末尾的/决定路径重写行为。proxy_pass http://127.0.0.1:8000;(无斜杠)会将/api/v1/users完整传递;proxy_pass http://127.0.0.1:8000/;(有斜杠)会剥离/api前缀,只传v1/users。这是nginx location匹配规则最易混淆的点。
4.3 location 匹配的优先级与正则陷阱
Nginx 的
location
匹配遵循严格优先级:
-
=精确匹配(最高优先级); -
^~前缀匹配(非正则,匹配成功即停止); -
~和~*正则匹配(区分大小写/不区分); -
/通用匹配(最低优先级)。
一个典型错误配置:
location /api/ {
proxy_pass http://backend1;
}
location ~ \.php$ {
fastcgi_pass php-fpm;
}
location / {
root /var/www/html;
}
当请求
/api/user.php
时,
不会进入
location /api/
,而是匹配
location ~ \.php$
!因为正则匹配在前缀匹配之后执行,且
~
优先级高于
/
。正确写法是:
location ^~ /api/ {
proxy_pass http://backend1;
}
location ~ \.php$ {
fastcgi_pass php-fpm;
}
location / {
root /var/www/html;
}
^~
确保
/api/
前缀匹配后立即终止,不再检查正则。我在某电商平台 API 网关上线时,就因忽略此规则,导致
/api/v1/login.php
被错误路由到 PHP-FPM,返回 502 Bad Gateway。
5. 服务管控与故障自愈:systemctl、日志与平滑升级的实战逻辑
安装和配置完成后,Nginx 就进入了“服役期”。热词
systemctl
、
nginx启动命令和停止命令
、
nginx平滑升级
、
排查nginx日志
都指向服务生命周期管理。Ubuntu 20.04 的
systemd
机制与传统
init.d
有本质区别,必须理解其设计哲学。
5.1 systemctl 的底层逻辑:不只是 start/stop
执行
sudo systemctl status nginx
时,看到的
Active: active (running)
并非简单进程存活,而是
systemd
对
nginx
进程树的持续监护。
systemd
通过
Type=forking
(Nginx 默认)模式启动:主进程 fork 出 worker 进程后退出,
systemd
认为主服务已就绪。但若
nginx.conf
语法错误,
nginx -t
会失败,
systemd
会记录
Failed with result 'exit-code'
。
关键命令与原理:
-
sudo systemctl start nginx:触发/lib/systemd/system/nginx.service中的ExecStartPre=/usr/sbin/nginx -t(语法检查),再执行ExecStart=/usr/sbin/nginx -g 'daemon on; master_process on;'; -
sudo systemctl reload nginx:发送HUP信号给主进程, 平滑重载配置 ,worker 进程处理完当前请求后优雅退出,新 worker 进程加载新配置; -
sudo systemctl restart nginx:先stop再start,存在毫秒级服务中断。
提示:
sudo systemctl edit nginx用于创建覆盖配置(override),而非编辑原始 service 文件。执行后会打开编辑器(默认 nano),输入:[Service] Environment="NGINX_OPTS=-g 'worker_rlimit_nofile 65536;'"保存后,
systemd会生成/etc/systemd/system/nginx.service.d/override.conf。热词sudo systemctl edit 的编辑器如何使用的困惑,源于用户误以为它直接编辑/lib/systemd/system/nginx.service。
5.2 日志分析:access.log 与 error.log 的黄金组合
/var/log/nginx/access.log
记录每一次 HTTP 请求,格式由
log_format
定义。Ubuntu 默认格式为:
'$remote_addr - $remote_user [$time_local] "$request" '
'$status $body_bytes_sent "$http_referer" "$http_user_agent"'
但生产环境必须增强:
log_format main '$remote_addr - $remote_user [$time_local] '
'"$request" $status $body_bytes_sent '
'"$http_referer" "$http_user_agent" '
'$request_time $upstream_response_time $pipe';
-
$request_time:请求总耗时(秒),定位慢接口; -
$upstream_response_time:后端响应耗时,区分是 Nginx 瓶颈还是上游问题; -
$pipe:是否启用管道(P 表示是),诊断连接复用问题。
error.log
级别默认为
error
,但调试时需临时调为
debug
:
sudo nginx -t && sudo systemctl stop nginx
sudo nginx -g "daemon off; error_log /var/log/nginx/error.log debug;"
# 观察终端输出,找到具体错误行
sudo systemctl start nginx
5.3 平滑升级:不中断业务的版本迭代
热词
nginx平滑升级
和
nginx升级到1.30.2要注意什么
指向一个高阶场景。假设你已编译好新版本
/usr/local/nginx/sbin/nginx
,升级步骤为:
-
备份旧二进制:
sudo cp /usr/sbin/nginx /usr/sbin/nginx.bak -
复制新二进制:
sudo cp /usr/local/nginx/sbin/nginx /usr/sbin/nginx -
验证语法:
sudo nginx -t -
发送 USR2 信号:
sudo kill -USR2 $(cat /run/nginx.pid)
此时,旧 master 进程仍在运行,新 master 进程启动并 fork 新 worker; -
发送 WINCH 信号:
sudo kill -WINCH $(cat /run/nginx.pid.oldbin)
旧 worker 进程优雅退出,处理完当前请求; -
发送 QUIT 信号:
sudo kill -QUIT $(cat /run/nginx.pid.oldbin)
旧 master 进程退出,升级完成。
整个过程业务零中断。我曾在某支付网关升级中,用此法将 Nginx 从 1.18.0 升至 1.24.0,全程监控
access.log
的
5xx
率,确认为 0。
6. 安全加固:从 CVE-2026-27654 到 IPv6 双栈日志的防御纵深
热词
f5 nginx plus和f5 nginx open source 安全漏洞(cve-2026-27654)
、
cve-2026-27654深度解析:nginx webdav高危漏洞原理与修复方案
、
ipv6 双栈 服务器 nginx 日志
揭示了一个事实:Nginx 不是“装完就安全”的组件,而是需要持续加固的攻击面。Ubuntu 20.04 的默认配置存在多个可利用点。
6.1 CVE-2026-27654:WebDAV 模块的远程代码执行
该漏洞影响启用了
http_dav_module
的 Nginx(Ubuntu APT 默认不编译此模块)。但若你手动编译时加入了
--with-http_dav_module
,且配置了:
location /webdav/ {
dav_methods PUT DELETE MKCOL COPY MOVE;
create_full_put_path on;
dav_access group:rw all:r;
}
攻击者可通过特制
PUT
请求,在服务器上写入恶意脚本。
修复方案不是升级,而是禁用
:
# 在 http 块中全局禁用
load_module /usr/lib/nginx/modules/ngx_http_dav_module.so; # 注释掉此行
# 或在 server 块中不启用 dav_methods
验证是否启用:
nginx -V 2>&1 | grep -o "http_dav_module"
,若无输出则安全。
6.2 IPv6 双栈日志的精确溯源
热词
ipv6 双栈 服务器 nginx 日志
指向一个运维痛点:当服务器同时监听 IPv4 和 IPv6 时,
$remote_addr
在 IPv6 请求中会显示为
2001:db8::1
,但某些日志分析工具无法解析。解决方案是在
nginx.conf
中添加:
log_format ipv6 '$remote_addr [$time_local] '
'"$request" $status $body_bytes_sent '
'"$http_referer" "$http_user_agent" '
'$request_time "$http_x_forwarded_for"';
map $remote_addr $log_ip {
~^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$ $remote_addr;
default $remote_addr;
}
access_log /var/log/nginx/access_ipv6.log ipv6;
map
指令将 IPv4 地址原样输出,IPv6 地址也保持原样,避免日志解析器崩溃。
6.3 最小权限原则:www-data 用户的边界控制
Ubuntu 默认
user www-data;
,但
www-data
组默认拥有
/var/www/html
读写权。生产环境必须收紧:
# 创建专用用户
sudo useradd -r -s /bin/false nginx-app
sudo chown -R nginx-app:nginx-app /var/www/myapp
sudo chmod -R 750 /var/www/myapp
# 修改 nginx.conf
user nginx-app;
同时,
/etc/nginx/nginx.conf
中的
pid /run/nginx.pid;
必须确保
nginx-app
对
/run/
有写权限,否则启动失败。这是
nginx启动命令和停止命令
失败的隐藏原因。
最后分享一个小技巧:在
/etc/nginx/nginx.conf
顶部加入:
# DEBUG: Enable only when troubleshooting
# error_log /var/log/nginx/error.log debug;
# pid /run/nginx-debug.pid;
用注释开关调试模式,避免误提交到生产环境。我在某次紧急故障排查中,就是靠这行注释快速切换日志级别,30 分钟定位到
upstream timed out
的根本原因是后端数据库连接池耗尽,而非 Nginx 配置问题。
683



被折叠的 条评论
为什么被折叠?



