企业官网建设流程全解析

nginx-autoinstall版本选择攻略：Stable与Mainline究竟怎么选？

【免费下载链接】nginx-autoinstallCompile NGINX from source with custom modules and patches on Debian and Ubuntu项目地址: https://gitcode.com/gh_mirrors/ng/nginx-autoinstall

nginx-autoinstall 是一个在 Debian 和 Ubuntu 上从源码编译安装 Nginx 的开源脚本，它支持自定义模块与补丁，并内置了 Stable（稳定版）与 Mainline（主线版）两种版本的一键选择。很多新手第一次运行脚本时，都会在"版本选择"这一步犹豫不决：Stable 和 Mainline 到底有什么区别？生产环境该选哪个？本攻略将用通俗的语言讲清两种 Nginx 版本的区别，并给出针对不同场景的版本选择建议，帮你一次装对、少走弯路。

一、nginx-autoinstall 是什么？为什么要用它装 Nginx？

在 Debian/Ubuntu 上，大多数人习惯用apt install nginx安装 Nginx，但系统源里的版本往往偏旧，也无法自由添加第三方模块。nginx-autoinstall 帮你从源码编译出一个"定制版"Nginx：既能选官方最新主线版或稳定版，也能一键集成 Brotli、HTTP/3、PageSpeed、ModSecurity、GeoIP2 等几十个常用模块与补丁。

使用起来非常简单，先获取脚本：

git clone https://gitcode.com/gh_mirrors/ng/nginx-autoinstall

进入目录后执行：

sudo ./nginx-autoinstall.sh

脚本会以问答方式引导你完成安装，兼容 Debian 9+ 与 Ubuntu 16.04+。安装完成后，它还会自动部署 systemd 服务（conf/nginx.service）、日志轮转配置（conf/nginx-logrotate）和一份开箱即用的conf/nginx.conf，并通过 APT pinning 屏蔽系统源中的 nginx，避免两种安装方式互相冲突。可以说，从"装"到"管"，一个脚本全包了。⚙️

二、Stable 与 Mainline：两种 Nginx 版本的核心区别

Nginx 官方一直同时维护两条版本线，二者的定位截然不同：

• Mainline（主线版）：新功能、新特性的"试验田"，Bug 修复也会第一时间上线，更新节奏快。
• Stable（稳定版）：功能冻结，只接收 Bug 修复，几乎不会引入新特性，更新节奏慢、更稳。

有个小技巧可以快速分辨版本线：看版本号中间的数字，奇数通常是 Mainline（如 1.21.x、1.23.x），偶数通常是 Stable（如 1.22.x、1.24.x）。在 nginx-autoinstall 脚本中，默认值也遵循这一规律：

一句话总结：Stable 求稳，Mainline 求新。Nginx 官方虽然建议新部署可以优先考虑 Mainline，但对大多数业务服务器来说，"稳"往往比"新"更重要。

三、nginx-autoinstall 版本选择实操：交互式安装怎么选？

运行脚本后，进入安装流程时会看到这样的版本选择提示：

Do you want to install Nginx stable or mainline? 1) Stable 1.22.0 2) Mainline 1.21.6 Select an option [1-2]:

没错，这一步就是在问你选哪个版本线。脚本默认选中1) Stable，直接回车即可。底层逻辑其实很简单：脚本在nginx-autoinstall.sh开头用两个变量保存默认版本号，再通过分支把选项映射成具体版本：

• NGINX_STABLE_VER（默认 1.22.0）→ 选 1 或输入 STABLE
• NGINX_MAINLINE_VER（默认 1.21.6）→ 选 2 或输入 MAINLINE

如果你心里已经有了答案，直接输入对应数字回车，剩下的模块选择按提示逐个确认即可。

四、Headless 模式：命令行一键指定 Stable 或 Mainline

不喜欢交互问答？nginx-autoinstall 支持 Headless（无交互）模式，一条命令直接指定版本线，非常适合脚本化部署。💡

安装 Mainline 主线版：

HEADLESS=y NGINX_VER=MAINLINE ./nginx-autoinstall.sh

安装 Stable 稳定版：

HEADLESS=y NGINX_VER=STABLE ./nginx-autoinstall.sh

甚至可以手动指定任意版本号，比如把 Mainline 指定为 1.25.3：

HEADLESS=y NGINX_VER=MAINLINE NGINX_MAINLINE_VER=1.25.3 ./nginx-autoinstall.sh

注意：Headless 模式下所有可选项都有默认值，NGINX_VER不指定时默认回退到 Stable，对自动化脚本来说这是最安全的选择。

五、版本选择如何影响模块与补丁？

选择版本线不只是"新一点"和"稳一点"的区别，它还会直接影响你后续要安装的模块与补丁：

• HTTP/3（QUIC）：属于较新的特性，通常建议搭配 Mainline 使用，同时需要应用补丁patches/nginx-http3-1.19.7.patch（新版 nginx 适配）。
• HPACK 编码补丁：若同时启用 HTTP/3，需使用专门修正过冲突的patches/nginx_hpack_push_with_http3.patch。
• 第三方模块：如 Lua、ModSecurity、RTMP、Redis 缓存等，在 Stable 版本上编译的兼容性记录更成熟；而 Mainline 大版本更新时，个别补丁可能滞后于最新版本，需要额外适配。

所以一个实用建议是：如果你打算大量堆砌第三方模块，优先选 Stable 更省心；如果追求 HTTP/3 等前沿特性，选 Mainline 并留意补丁更新。

六、实战建议：不同场景下 Stable 与 Mainline 怎么选？

七、常见问题（FAQ）

Q1：装完之后发现版本选错了，能改吗？可以。重新运行./nginx-autoinstall.sh，选择"Install or update Nginx"，脚本会重新编译并覆盖现有文件，此时重新选择版本线即可。

Q2：Stable 和 Mainline 的配置写法差别大吗？差别很小。两条版本线的配置语法基本一致，主要差异在于内置功能和更新节奏，不用担心换版本后配置推倒重来。

Q3：脚本默认版本比较旧，怎么用上新版本？直接在命令行通过环境变量覆盖，例如把 Stable 指定为最新版本：NGINX_STABLE_VER=1.26.0 HEADLESS=y NGINX_VER=STABLE ./nginx-autoinstall.sh，无需修改脚本文件。

八、总结

nginx-autoinstall 把"从源码编译 Nginx"这件复杂事变成了几个简单的问答，而版本选择则是其中最关键的一步。追求稳定选 Stable，追求新特性选 Mainline——没有绝对的对错，只有是否适合你的场景。希望这份版本选择攻略能帮你做出最合适的决定，装出一个称心如意的 Nginx！

【免费下载链接】nginx-autoinstallCompile NGINX from source with custom modules and patches on Debian and Ubuntu项目地址: https://gitcode.com/gh_mirrors/ng/nginx-autoinstall