百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 技术资源 > 正文

centos 生产环境安装 nginx,包含各种模块http3

off999 2025-10-19 11:31 2 浏览 0 评论

企业级生产环境 Nginx 全模块构建 的大部分功能,包括 HTTP/2、HTTP/3、流媒体、SSL、缓存清理、负载均衡、DAV 扩展、替换过滤、静态压缩等。

下面我给出一个完整的生产环境安装流程(CentOS 7/8/9 兼容),并附上对应的 模块源码准备、编译、依赖安装、启动配置和优化建议


一、安装依赖环境

yum install -y gcc gcc-c++ make automake autoconf libtool pcre pcre-devel zlib zlib-devel openssl openssl-devel git wget unzip

二、创建源码目录

mkdir -p /www/server/nginx/src
cd /www/server/nginx/src

三、下载依赖源码包

# Nginx 主程序
wget https://nginx.org/download/nginx-1.25.5.tar.gz
tar zxvf nginx-1.25.5.tar.gz

# pcre(正则支持)
wget https://ftp.pcre.org/pub/pcre/pcre-8.43.tar.gz
tar zxvf pcre-8.43.tar.gz

# openssl(支持TLS1.3与HTTP/3)
wget https://www.openssl.org/source/openssl-3.2.0.tar.gz
tar zxvf openssl-3.2.0.tar.gz -C /www/server/nginx/src/openssl --strip-components=1

# ngx_cache_purge 模块
git clone https://github.com/FRiCKLE/ngx_cache_purge.git

# sticky 模块(会话保持)
wget https://bitbucket.org/nginx-goodies/nginx-sticky-module-ng/get/master.tar.gz -O nginx-sticky-module-ng.tar.gz
tar zxvf nginx-sticky-module-ng.tar.gz
mv nginx-goodies-nginx-sticky-module-ng-* nginx-sticky-module-ng-1.3.0

# 替换过滤模块
git clone https://github.com/yaoweibin/ngx_http_substitutions_filter_module.git ngx_http_substitutions_filter_module-master

# DAV 扩展模块(WebDAV 支持)
git clone https://github.com/arut/nginx-dav-ext-module.git

四、编译 Nginx

cd /www/server/nginx/src/nginx-1.25.5

./configure \
--user=www \
--group=www \
--prefix=/www/server/nginx \
--add-module=/www/server/nginx/src/ngx_cache_purge \
--add-module=/www/server/nginx/src/nginx-sticky-module-ng-1.3.0 \
--add-module=/www/server/nginx/src/ngx_http_substitutions_filter_module-master \
--add-module=/www/server/nginx/src/nginx-dav-ext-module \
--with-openssl=/www/server/nginx/src/openssl \
--with-pcre=/www/server/nginx/src/pcre-8.43 \
--with-http_v2_module \
--with-http_v3_module \
--with-stream \
--with-stream_ssl_module \
--with-stream_ssl_preread_module \
--with-http_stub_status_module \
--with-http_ssl_module \
--with-http_image_filter_module \
--with-http_gzip_static_module \
--with-http_gunzip_module \
--with-http_sub_module \
--with-http_flv_module \
--with-http_addition_module \
--with-http_realip_module \
--with-http_mp4_module \
--with-http_auth_request_module \
--with-http_dav_module \
--with-ld-opt='-Wl,-E' \
--with-cc-opt='-Wno-error' \
--with-ipv6

编译并安装:

make -j$(nproc)
make install

五、创建 www 用户和目录

useradd -M -s /sbin/nologin www
mkdir -p /www/server/nginx/{logs,conf,html,temp}
chown -R www:www /www/server/nginx

六、配置 systemd 服务

创建服务文件:

vim /usr/lib/systemd/system/nginx.service

内容如下:

[Unit]
Description=The NGINX HTTP and reverse proxy server
After=network.target remote-fs.target nss-lookup.target

[Service]
Type=forking
PIDFile=/www/server/nginx/logs/nginx.pid
ExecStartPre=/www/server/nginx/sbin/nginx -t
ExecStart=/www/server/nginx/sbin/nginx
ExecReload=/www/server/nginx/sbin/nginx -s reload
ExecStop=/www/server/nginx/sbin/nginx -s quit
PrivateTmp=true

[Install]
WantedBy=multi-user.target

启动并开机自启:

systemctl daemon-reload
systemctl enable nginx
systemctl start nginx

七、验证安装

/www/server/nginx/sbin/nginx -V

输出中应包含:

--with-http_v3_module
--with-http_ssl_module
--add-module=...ngx_cache_purge
--add-module=...sticky
...

八、优化建议

优化方向

建议

worker配置

worker_processes auto;

连接优化

worker_connections 65535; use epoll;

日志分离

access、error日志按天切割

缓存优化

启用 proxy_cache_path 并结合 ngx_cache_purge 管理

TLS优化

推荐 TLSv1.2 TLSv1.3,并启用 http3(QUIC)

压缩

启用 gzip on; gzip_types text/css application/javascript image/svg+xml;

安全头

添加 add_header X-Frame-Options SAMEORIGIN; add_header X-Content-Type-Options nosniff;

模块扩展

若需 Brotli,可再加 --add-module=/path/to/ngx_brotli


九、HTTP/3 配置示例

在 nginx.conf 的 listen 处:

server {
    listen 443 ssl http2;
    listen 443 quic reuseport;

    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_certificate /etc/ssl/cert.crt;
    ssl_certificate_key /etc/ssl/cert.key;

    add_header Alt-Svc 'h3=":443"; h3-29=":443";';
    add_header QUIC-Status $quic;

    location / {
        root html;
        index index.html;
    }
}


脚本特点:

  • 自动安装依赖
  • 自动下载 Nginx + 所有模块源码
  • 自动编译(支持 HTTP/3、TLS1.3、缓存、粘性会话、替换过滤、DAV 等)
  • 自动创建 systemd 服务并开机自启
  • 自动检测并显示编译参数

一键安装脚本(nginx_install.sh)

#!/bin/bash
# =========================================================
#  CentOS 一键安装 Nginx (支持 HTTP/3 + 常用模块)
# 适配: CentOS 7 / 8 / 9
# 作者: ChatGPT 自动生成
# =========================================================

set -e

# ----------- 基础路径 -----------
NGINX_VERSION="1.25.5"
NGINX_PREFIX="/www/server/nginx"
SRC_DIR="${NGINX_PREFIX}/src"
USER="www"

echo "==== 安装依赖 ===="
yum install -y epel-release
yum install -y gcc gcc-c++ make automake autoconf libtool pcre pcre-devel zlib zlib-devel openssl openssl-devel git wget unzip

# ----------- 创建目录 -----------
mkdir -p ${SRC_DIR}
cd ${SRC_DIR}

# ----------- 下载源码包 -----------
echo "==== 下载 Nginx 源码及模块 ===="
[ ! -f nginx-${NGINX_VERSION}.tar.gz ] && wget https://nginx.org/download/nginx-${NGINX_VERSION}.tar.gz
tar zxvf nginx-${NGINX_VERSION}.tar.gz

[ ! -f pcre-8.43.tar.gz ] && wget https://ftp.pcre.org/pub/pcre/pcre-8.43.tar.gz
tar zxvf pcre-8.43.tar.gz

[ ! -d openssl ] && mkdir openssl && \
wget -O openssl.tar.gz https://www.openssl.org/source/openssl-3.2.0.tar.gz && \
tar zxvf openssl.tar.gz -C openssl --strip-components=1

[ ! -d ngx_cache_purge ] && git clone https://github.com/FRiCKLE/ngx_cache_purge.git
[ ! -d nginx-sticky-module-ng-1.3.0 ] && wget https://bitbucket.org/nginx-goodies/nginx-sticky-module-ng/get/master.tar.gz -O sticky.tar.gz && \
tar zxvf sticky.tar.gz && mv nginx-goodies-nginx-sticky-module-ng-* nginx-sticky-module-ng-1.3.0

[ ! -d ngx_http_substitutions_filter_module-master ] && git clone https://github.com/yaoweibin/ngx_http_substitutions_filter_module.git ngx_http_substitutions_filter_module-master
[ ! -d nginx-dav-ext-module ] && git clone https://github.com/arut/nginx-dav-ext-module.git

# ----------- 创建用户 -----------
if ! id -u ${USER} >/dev/null 2>&1; then
  useradd -M -s /sbin/nologin ${USER}
fi

# ----------- 编译安装 -----------
echo "==== 编译安装 Nginx ${NGINX_VERSION} ===="
cd ${SRC_DIR}/nginx-${NGINX_VERSION}

./configure \
--user=${USER} \
--group=${USER} \
--prefix=${NGINX_PREFIX} \
--add-module=${SRC_DIR}/ngx_cache_purge \
--add-module=${SRC_DIR}/nginx-sticky-module-ng-1.3.0 \
--add-module=${SRC_DIR}/ngx_http_substitutions_filter_module-master \
--add-module=${SRC_DIR}/nginx-dav-ext-module \
--with-openssl=${SRC_DIR}/openssl \
--with-pcre=${SRC_DIR}/pcre-8.43 \
--with-http_v2_module \
--with-http_v3_module \
--with-stream \
--with-stream_ssl_module \
--with-stream_ssl_preread_module \
--with-http_stub_status_module \
--with-http_ssl_module \
--with-http_image_filter_module \
--with-http_gzip_static_module \
--with-http_gunzip_module \
--with-http_sub_module \
--with-http_flv_module \
--with-http_addition_module \
--with-http_realip_module \
--with-http_mp4_module \
--with-http_auth_request_module \
--with-http_dav_module \
--with-ld-opt='-Wl,-E' \
--with-cc-opt='-Wno-error' \
--with-ipv6

make -j$(nproc)
make install

# ----------- 创建目录与权限 -----------
mkdir -p ${NGINX_PREFIX}/{logs,temp,conf,html}
chown -R ${USER}:${USER} ${NGINX_PREFIX}

# ----------- 创建 Systemd 服务 -----------
cat > /usr/lib/systemd/system/nginx.service <<EOF
[Unit]
Description=The NGINX HTTP and reverse proxy server
After=network.target remote-fs.target nss-lookup.target

[Service]
Type=forking
PIDFile=${NGINX_PREFIX}/logs/nginx.pid
ExecStartPre=${NGINX_PREFIX}/sbin/nginx -t
ExecStart=${NGINX_PREFIX}/sbin/nginx
ExecReload=${NGINX_PREFIX}/sbin/nginx -s reload
ExecStop=${NGINX_PREFIX}/sbin/nginx -s quit
PrivateTmp=true

[Install]
WantedBy=multi-user.target
EOF

systemctl daemon-reload
systemctl enable nginx
systemctl start nginx

echo
echo " Nginx 安装完成!"
echo " 安装路径: ${NGINX_PREFIX}"
echo " 查看版本与模块: ${NGINX_PREFIX}/sbin/nginx -V"
echo

使用方法

1 保存脚本:

vim nginx_install.sh

2 赋予执行权限:

chmod +x nginx_install.sh

3 运行安装:

./nginx_install.sh

4 验证:

/www/server/nginx/sbin/nginx -V
systemctl status nginx

可选增强模块(如需可加上)

模块

功能

安装方式

ngx_brotli

Brotli 压缩

git clone
https://github.com/google/ngx_brotli.git --recursive 并添加 --add-module=ngx_brotli

ngx_pagespeed

页面加速

不推荐生产使用

headers-more

更灵活添加 HTTP 头

git clone https://github.com/openresty/headers-more-nginx-module.git

lua-nginx-module

支持 Lua 脚本

需配合 OpenResty 构建


常见问题定位

问题

检查点

nginx: [emerg] unknown directive "..."

模块未编译或未加载

nginx: command not found

未安装或路径错误

nginx: [warn] module "..." version mismatch

模块版本与 Nginx 不匹配

启动失败

检查 /var/log/nginx/error.log


如果想查看完整模块清单

nginx -V 2>&1 | tr ' ' '\n' | grep -- '--with'

输出示例:

--with-http_ssl_module
--with-http_v2_module
--with-stream
--with-threads

相关推荐

在NAS实现直链访问_如何访问nas存储数据

平常在使用IPTV或者TVBOX时,经常自己会自定义一些源。如何直链的方式引用这些自定义的源呢?本人基于armbian和CasaOS来创作。使用标准的Web服务器(如Nginx或Apache...

PHP开发者必备的Linux权限核心指南

本文旨在帮助PHP开发者彻底理解并解决在Linux服务器上部署应用时遇到的权限问题(如Permissiondenied)。核心在于理解“哪个用户(进程)在访问哪个文件(目录)”。一、核心...

【Linux高手必修课】吃透sed命令!文本手术刀让你秒变运维大神!

为什么说sed是Linux运维的"核武器"?想象你有10万个配置文件需要批量修改?传统方式要写10万行脚本?sed一个命令就能搞定!这正是运维工程师的"暴力美学"时...

「实战」docker-compose 编排 多个docker 组成一个集群并做负载

本文目标docker-compose,对springboot应用进行一个集群(2个docker,多个类似,只要在docker-compose.yml再加boot应用的服务即可)发布的过程架构...

企业安全访问网关:ZeroNews反向代理

“我们需要让外包团队访问测试环境,但不想让他们看到我们的财务系统。”“审计要求我们必须记录所有第三方对内部系统的访问,现在的VPN日志一团糟。”“每次有新员工入职或合作伙伴接入,IT部门都要花半天时间...

反向代理以及其使用场景_反向代理实现过程

一、反向代理概念反向代理(ReverseProxy)是一种服务器配置,它将客户端的请求转发给内部的另一台或多台服务器处理,然后将响应返回给客户端。与正向代理(ForwardProxy)不同,正向代...

Nginx反向代理有多牛?一篇文章带你彻底搞懂!

你以为Nginx只是个简单的Web服务器?那可就大错特错了!这个看似普通的开源软件,实际上隐藏着惊人的能力。今天我们就来揭开它最强大的功能之一——反向代理的神秘面纱。反向代理到底是什么鬼?想象一下你...

Nginx反向代理最全详解(原理+应用+案例)

Nginx反向代理在大型网站有非常广泛的使用,下面我就重点来详解Nginx反向代理@mikechen文章来源:mikechen.cc正向代理要理解清楚反向代理,首先:你需要搞懂什么是正向代理。正向代理...

centos 生产环境安装 nginx,包含各种模块http3

企业级生产环境Nginx全模块构建的大部分功能,包括HTTP/2、HTTP/3、流媒体、SSL、缓存清理、负载均衡、DAV扩展、替换过滤、静态压缩等。下面我给出一个完整的生产环境安装流程(C...

Nginx的负载均衡方式有哪些?_nginx负载均衡机制

1.轮询(默认)2.加权轮询3.ip_hash4.least_conn5.fair(最小响应时间)--第三方6.url_hash--第三方...

Nginx百万并发优化:如何提升100倍性能!

关注△mikechen△,十余年BAT架构经验倾囊相授!大家好,我是mikechen。Nginx是大型架构的核心,下面我重点详解Nginx百万并发优化@mikechen文章来源:mikechen....

在 Red Hat Linux 上搭建高可用 Nginx + Keepalived 负载均衡集群

一、前言在现代生产环境中,负载均衡是确保系统高可用性和可扩展性的核心技术。Nginx作为轻量级高性能Web服务器,与Keepalived结合,可轻松实现高可用负载均衡集群(HA+LB...

云原生(十五) | Kubernetes 篇之深入了解 Pod

深入了解Pod一、什么是PodPod是一组(一个或多个)容器(docker容器)的集合(就像在豌豆荚中);这些容器共享存储、网络、以及怎样运行这些容器的声明。我们一般不直接创建Pod,而是...

云原生(十七) | Kubernetes 篇之深入了解 Deployment

深入了解Deployment一、什么是Deployment一个Deployment为Pods和ReplicaSets提供声明式的更新能力。你负责描述Deployment中的目标状...

深入理解令牌桶算法:实现分布式系统高效限流的秘籍

在高并发系统中,“限流”是保障服务稳定的核心手段——当请求量超过系统承载能力时,合理的限流策略能避免服务过载崩溃。令牌桶算法(TokenBucket)作为最经典的限流算法之一,既能控制请求的平...

取消回复欢迎 发表评论: