在ondrej不维护Nginx仓库之后的无奈选择：自行编译Nginx以及第三方模块支持
前言
之前系统Nginx使用的是 Ondřej Surý in Launchpad维护的Nginx PPA仓库，但是前段时间正式停止维护了，主要原因是：Nginx PPA 维护成本太高 。
他在多次 Launchpad / GitHub / 邮件列表中提到过几个核心问题：
Nginx 官方更新频繁，且模块生态复杂
社区对 Nginx PPA 的期望过高，但贡献者极少
“大家都想要最新的 Nginx，但几乎没人愿意帮忙测试或提交补丁。”
换句话说： 伸手党太多，只想拿现成的，却没人愿意帮忙维护。
所以啊，现在大家喝不到汤了。他也将自己的重心放到PHP中去了。
版本
目前Nginx基本可以分为以下几类安装方式：
第一类：类似Ubuntu等官方维护的版本
版本非常稳定，但更新极慢
只会在 LTS 生命周期内做安全补丁
不追新功能
至今版本为 ：1.24 。
第二类：Nginx官方仓库（官方源）
Nginx 官方自己提供 nginx.org 官方仓库，版本会非常新：
稳定版（stable）
主线版（mainline）
最新的版本。安装方式官方有Document：nginx: Linux packages。
官方仓库的最大痛点： 官方仓库只提供“纯净版 Nginx”，不包含任何第三方模块。
如果通过apt等形式安装的模块，无法使用。也就是说使用官方源安装Nginx，就基本上只使用自带的功能，告别第三方模块支持。
第三类：自行编译完整的Nginx
对于第三方模块，比如 brotli + fancyindex + headers-more + echo + stream 等等， 那么最干净的方式是就是自行编译！
模块全部内置或动态加载
与系统兼容
可用 apt 卸载
可用 systemd 管理
这是专业运维团队最常用的方式。
无奈的选择
正是由于上面所说，想要体验一下新功能（比如HTTP/3），或者自身需求（比如stram转发），基本只能自行编译Nginx这条路。
编译示例
下文演示的一些基础的需求，比如：
BoringSSL支持的HTTP/3
修改响应头的
headers-more-nginx-module比 gzip 更高效
BrotliWebDAV的
nginx-dav-ext-module目录支持的
fancyindex官方未编译进去的
stream模块
这些也是我平时会使用的，HTTP/3 用的少，感觉国内网络支持一般，其他几个常用，比如家里Ubuntu Server部署的WebDAV，文件浏览用 Fancyindex，Windows远程桌面使用 stream 转发。
第一步：编译环境的准备
sudo apt install -y git gcc make libpcre3 libpcre3-dev zlib1g-dev libssl-dev libxml2-dev libxslt1-dev libbrotli-dev libzstd-dev cmake g++ build-essential autoconf libtool pkg-config libpsl-dev第二步：下载相关的源码及模块
直接在服务器中运行：
创建编译总目录
mkdir /root/nginx-build && cd nginx-build # 编译总目录下载nginx源码
wget https://nginx.org/download/nginx-<version>.tar.gz # 下载Nginx源码 tar -zxvf nginx-<version>.tar.gz # 解压nginx mv nginx-<version> nginx # 将nginx-<version> 重命名为 nginx
Nginx源码下载地址：[nginx: download](https://nginx.org/en/download.html)
下载第三方模块
git clone https://gitee.com/mirrors/boringssl.git # boringssl git clone https://github.com/openresty/headers-more-nginx-module.git # headers-more-nginx-module git clone --recurse-submodules -j8 https://github.com/google/ngx_brotli # brotli git clone https://github.com/aperezdc/ngx-fancyindex.git # ngx-fancyindex git clone https://github.com/arut/nginx-dav-ext-module.git # nginx-dav-ext-module
最终目录结构为：
/root/nginx-build
├── nginx/ # Nginx 源码目录
├── boringssl/ # BoringSSL
├── headers-more-nginx-module/ # headers-more 模块
├── ngx_brotli/ # brotli 模块
├── ngx-fancyindex/ # fancyindex 模块
└── nginx-dav-ext-module/ # WebDAV 扩展模块第三步：编译相关模块
编译boringssl
cd boringssl mkdir build && cd build cmake .. -DCMAKE_BUILD_TYPE=Release make -j$(nproc) cd ../..
编译brotli
cd ngx_brotli/deps/brotli mkdir out && cd out cmake -DCMAKE_BUILD_TYPE=Release -DBUILD_SHARED_LIBS=OFF -DCMAKE_C_FLAGS="-Ofast -m64 -march=native -mtune=native -flto -funroll-loops -ffunction-sections -fdata-sections -Wl,--gc-sections" -DCMAKE_CXX_FLAGS="-Ofast -m64 -march=native -mtune=native -flto -funroll-loops -ffunction-sections -fdata-sections -Wl,--gc-sections" -DCMAKE_INSTALL_PREFIX=./installed .. cmake --build . --config Release --target brotlienc cd ../../../..
第四步：编译Nginx
配置全局编译优化参数：
cd nginx
export CFLAGS="-m64 -march=native -mtune=native -Ofast -flto -funroll-loops -ffunction-sections -fdata-sections -Wl,--gc-sections"
export LDFLAGS="-m64 -Wl,-s -Wl,-Bsymbolic -Wl,--gc-sections"执行配置脚本生成 Makefile：
./configure \
--prefix=/etc/nginx \
--sbin-path=/usr/sbin/nginx \
--modules-path=/etc/nginx/modules \
--conf-path=/etc/nginx/nginx.conf \
--http-client-body-temp-path=/var/cache/nginx/client_body_temp \
--http-proxy-temp-path=/var/cache/nginx/proxy_temp \
--http-fastcgi-temp-path=/var/cache/nginx/fastcgi_temp \
--http-scgi-temp-path=/var/cache/nginx/scgi_temp \
--http-uwsgi-temp-path=/var/cache/nginx/uwsgi_temp \
--error-log-path=/var/log/nginx/error.log \
--http-log-path=/var/log/nginx/access.log \
--pid-path=/var/run/nginx.pid \
--lock-path=/run/nginx.lock \
--with-compat \
--with-http_ssl_module \
--with-http_v2_module \
--with-http_v3_module \
--with-stream \
--with-stream_realip_module \
--with-stream_ssl_preread_module \
--with-http_dav_module \
--with-http_realip_module \
--with-http_addition_module \
--with-http_sub_module \
--with-http_flv_module \
--with-http_mp4_module \
--with-pcre \
--with-pcre-jit \
--with-mail \
--with-mail_ssl_module \
--with-cc-opt="-I/root/nginx-build/boringssl/include" \
--with-ld-opt="-L/root/nginx-build/boringssl/build -L/root/nginx-build/boringssl/build/crypto -lssl -lcrypto -lstdc++ -lpthread -lm" \
--add-module=/root/nginx-build/headers-more-nginx-module \
--with-http_gunzip_module \
--with-http_gzip_static_module \
--with-http_stub_status_module \
--with-http_random_index_module \
--with-http_secure_link_module \
--with-http_degradation_module \
--with-http_slice_module \
--with-http_auth_request_module \
--add-module="/root/nginx-build/ngx_brotli" \
--add-module="/root/nginx-build/ngx-fancyindex" \
--add-module="/root/nginx-build/nginx-dav-ext-module" \
--user=www-data \
--group=www-data \
--with-threads \
--with-file-aio \
--with-debug注意其中的几个模块路径，不要错，而且要使用绝对路径。
接着：
make -j$(nproc)
make install结束后可以通过以下几个命令确定是否成功：
ls /etc/nginx
/usr/sbin/nginx -V
第五步：配置systemd服务
vim /etc/systemd/system/nginx.service内容为：
[Unit]
Description=A high performance web server and a reverse proxy server
Documentation=man:nginx(8)
After=network-online.target remote-fs.target nss-lookup.target
Wants=network-online.target
[Service]
Type=forking
PIDFile=/run/nginx.pid
ExecStartPre=/usr/sbin/nginx -t -q -g 'daemon on; master_process on;'
ExecStart=/usr/sbin/nginx -g 'daemon on; master_process on;'
ExecStartPost=/bin/sleep 0.1
ExecReload=/usr/sbin/nginx -g 'daemon on; master_process on;' -s reload
ExecStop=-/sbin/start-stop-daemon --quiet --stop --retry QUIT/5 --pidfile /run/nginx.pid
TimeoutStopSec=5
KillMode=mixed
[Install]
WantedBy=multi-user.target先创建配置的临时目录：
mkdir -p /var/cache/nginx再启动Nginx：
systemctl daemon-reload
systemctl enable nginx
systemctl start nginx
systemctl status nginx
搞定收工！
最后
编译完之后源码的目录就不能删除，之前通过 /usr/sbin/nginx -V 看到boringssl是动态链接 到源码库文件的，删除后会造成崩溃。
最终自己编译时间也不长，几分钟时间。
总体来说，使用包安装器安装比较稳定、省事，但是功能有限，自己编译可以达到系统的最优化，更多需求的模块功能，更新的版本、更高吞吐、更低CPU占用等优势。
本博客所有文章除特别声明外，均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来源 Forever Study！
相关推荐
2025-11-30
搭建HTTP3网站的最终尝试以及成果分享
前言对于HTTP/3一直有个执念：前段时间（9月份）了解HTTP/3后，在本地虚拟机测试，始终达不到要求；但又由于没有单独的多余服务器测试（主要是这台服务器陪伴已久，里面的数据以及环境都比较复杂，测试难度比较高），导致一直搁置着。 最近新申请了个域名，搭配服务器也比较优惠，就搞了台国内基础配置的云服务器。这样万事俱备，直接开干！ 成果网站预览：HTTP/3 Adventure 首页 导航栏 HTTP/3检测 悬浮球查看当前网络协议 卡片特效 网站设计这个网站90%基于Google Gemini设计。 当时只是想简单设计个页面，需求也就寥寥几个字： 我准备做一个HTTP/3的网站，帮我写一个首页的html文件，大致介绍网站的介绍，功能，以及其他一些http/3方面的支持，页面做美观大气 分别发给了Google Gemini以及ChatGPT： Gemini设计的页面基本和现在看到的区别不大； ChatGPT设计的页面非常简单，如果不对比Gemini给的页面，那么还能接受，毕竟只是想简单测试一下，对比之后就...
2022-09-25
Nginx服务配置篇·第一课：服务器环境部署（Nginx+PHP-FPM）
一切的一切都要从这里开始 前言搭建服务器最起初的第一课：服务器环境部署。 前期准备1.CVM服务器或者轻量级服务器 2.域名（推荐购买顶级域名，理由：不贵，而且以后也可以方便做其他配置） 服务器： 对于时间充裕，不急着使用的，首选内地的服务器，虽然备案可能大约要15-20天左右，但是鉴于目前环境，内地的服务器还是有优势（类似后期部署应用，无需备案的服务器国内都解析不了），而且据说在推广方面备案的服务器收录的更好。如果急着需要练手的，那么就选国外的或者中国香港的服务器，无需备案。 操作环节本文基于腾讯云-轻量级服务器进行演示。 第一步：安装Ubuntu系统进入 腾讯云控制台 - 轻量应用服务器 ，打开 服务器 界面，右侧 镜像 ， 重装系统 ，随后选择 官方镜像 - 系统镜像 - Ubuntu22.04 ，点击 确定 进入重装界面。 第二步：建立SSH远程连接安装完系统后，在概要界面-远程登陆栏，点击登陆。 会跳转到Webshell界面，下图中，可以直接登陆，也可以直接在用户名栏输入 root，本次演示以root权限进入。 进入命令模式，输入以下代码： pass...
2025-09-08
使用Nginx搭建WebDav的注意事项补充（流媒体访问）
前言搭建WebDav的两种最简单方式： Linux：Nginx Winodws：IIS 前两天在给小朋友准备一些学习（视频、音频等）的资料，让她在电视机或者iPad上可以自己看。 就想着用WebDav搭建一个影音库，里面只有这些学习的音视频，也没办法看其他东西，而由于她的资料不是很多，干脆就放在Ubuntu服务器上，24h开机也随时都能访问。 WinNAS因为有8块硬盘，24h开机太费电。 过程方案一：NginxUbuntu Server搭建WebDav的首选方案肯定是Nginx，轻量。 但是按照网上的方法，最终搭建完成后，浏览器可以正常访问，但是手机平板无法访问，只能最终放弃。 方案二：Jellyfin或者Plex这类媒体资源库其实还是非常不错的，搭建后也能正常访问，但是我又不是很想固定在一个应用上面，相当于以后又要多维护一个应用，暂时先Pass，还是再回去研究一下Nginx搭建的WebDav为什么手机平板无法访问吧～ 方案三：Nginx回来继续研究Nginx，网上搜资料，继续看看是什么原因。 后来看到手机平板必须要使用dav_ext_methods模块才能正常访问...
2022-09-30
Nginx服务配置篇·第六课：Nginx反向代理Hexo安装教程
前言使用下来，Hexo的局限性感觉还是比较大的，你要说它是一个单纯的博客，它也能给你整点花出来，要说用它搭建网站，又有点不切实际。 个人还是更喜欢wordpress这种啥都有的类型。 目前网上的教程基本上都是托管在Github Page上面的，这样的方式的好处就是成本低，不需要定期维护，而且还可以专注于写作。因此，使用自己域名加服务器的方式很少有人提及，确实非常的麻烦。 我们这边就正好用第二种方式来部署自己的Hexo。 步骤第一部分 Hexo安装1.安装nodejs和npmapt install nodejs apt install npm 2.手动更改 npm 的默认目录根据官方，不建议使用root权限，使用普通用户权限，这样会存在访问权限问题，需要修改npm默认目录。 引用文档： 若要最大程度地减少出现权限错误的可能性，可以将 npm 配置为使用其他目录。在此示例中，您将在主目录中创建和使用隐藏目录。 2.1 备份您的计算机。 2.2 在命令行上的主目录中，为全局安装创建一个目录： mkdir ~/.npm-global 2.3 将 npm 配置为使用新的目录路...
2022-09-27
Nginx服务配置篇·第三课：NextCloud部署安装
前景概要：上一篇文章我们安装完Wordpress，基本上也就知道一个简单的网站的发布流程，这一篇就开始部署Nextcloud，打造你的第一个私人网盘。 为什么推荐Nextcloud？ 免费 部署简单 功能齐全，网页以及app都完美支持 Nextcloud安装最难的点就是网站配置，如果没有根据官网的配置文件的话，就可能会有如下问题： 安装时报错，导致连接不上数据库，无法访问页面 即使安装完，在 设置 - 概览 界面，出现很多条警告 开始部署第一步：上传Nextcloud程序到网站目录这边以 /var/www/nextcloud 目录为例 方法1：本地下载后通过SSH软件上传到服务器方法2：直接使用命令wget https://download.nextcloud.com/server/releases/latest.zip mv latest.zip /var/www cd /var/www unzip latest.zip 添加访问权限： chown -R www-data:www-data /var/www/nextcloud chmod -R 755 /v...
2022-10-12
Nginx进阶篇·Nginx与Apache2共存
前言今天接触了一个项目，它只能用Apache2，而且最近PHP8.2也推出了来了，所有想着试试就逝世的态度，结果还挺简单的，只能说配置好，后续再深入了解一下。 因此这里把简单的配置方案做一下。 环境 Ubuntu Nginx PHP8.1-FPM 步骤1.安装Apache2add-apt-repository ppa:ondrej/apache2 apt install apache2 2.安装PHP8.2-fpmapt install php8.2-fpm apt install libapache2-mod-php8.2 安装完提示有错误，正常，因为80端口被nginx占用了。 Job for apache2.service failed because the control process exited with error code. See "systemctl status apache2.service" and "journalctl -xeu apache2.service" for details. invoke-rc.d: initscri...
评论