你是不是也在为离线状态下安装 Nginx 各个模块而发愁？在互联网大厂后端开发工作中，我们常常会遇到一些特殊的网络环境，比如公司内部的离线服务器，或是处于隔离状态的测试环境。当需要在这些离线环境中安装 Nginx 模块时，没有网络支持，常规的在线安装方法就行不通了，很多后端开发人员因此陷入困境，不知道从何下手。

我们先来了解一下离线安装 Nginx 模块面临的背景。在互联网大厂的项目部署过程中，出于数据安全、合规性等多方面因素考虑，部分服务器会被设置为离线状态，禁止与外部网络连接 。而 Nginx 作为一款高性能的 Web 服务器和反向代理服务器，其丰富的模块能为项目带来诸如负载均衡、缓存加速等强大功能。当我们需要在这些离线服务器上部署项目，并且需要使用特定的 Nginx 模块时，离线安装就成为了必须掌握的技能。但由于缺乏网络，无法直接使用yum、apt等包管理工具在线获取安装包和依赖，使得安装过程变得复杂棘手。

不过别担心，下面就来和你聊聊有效的解决办法。

准备工作

确定服务器环境：明确离线服务器的操作系统类型及版本，例如 CentOS 7、Ubuntu 20.04 等。不同的操作系统，安装 Nginx 及模块的细节会有所不同。

下载安装包和依赖包

• Nginx 安装包：访问 Nginx 官方网站（https://nginx.org/），下载对应操作系统版本的稳定版 Nginx 安装包，通常为.tar.gz格式。
• 模块包：根据项目需求，确定要安装的 Nginx 模块，如ngx_http_redis_module、ngx_http_sub_module等。在对应的开源仓库或模块官方网站下载其源代码包。
• 依赖包：常见的依赖包括gcc（用于编译）、pcre（处理正则表达式）、openssl（支持 HTTPS）、zlib（用于数据压缩）等。
• CentOS 系统：在有网络的机器上，使用yumdownloader命令下载依赖包的rpm文件，例如yumdownloader gcc pcre-devel openssl-devel zlib-devel 。
• Ubuntu 系统：使用apt-get download命令下载依赖包的deb文件，如apt-get download build-essential libpcre3-dev libssl-dev zlib1g-dev。

传输文件：将下载好的 Nginx 安装包、模块包和依赖包，通过 U 盘、移动硬盘或其他存储设备，拷贝到离线服务器上，建议创建一个专门的目录，如/opt/nginx - offline用于存放这些文件 。

安装依赖

CentOS 系统

打开终端，进入存放依赖包的目录，例如cd /opt/nginx - offline。按照顺序安装依赖包，先安装gcc：

rpm -ivh gcc*.rpm

接着安装pcre相关依赖：

rpm -ivh pcre*.rpm pcre - devel*.rpm

安装openssl相关依赖：

rpm -ivh openssl*.rpm openssl - devel*.rpm

安装zlib相关依赖：

rpm -ivh zlib*.rpm zlib - devel*.rpm

如果遇到依赖冲突问题，可以使用--nodeps --force参数强制安装，但这可能会导致部分功能无法正常使用，仅在确定不会影响系统稳定时使用，如：

rpm -ivh --nodeps --force pcre - 8.32 - 17.el7.x86_64.rpm

Ubuntu 系统

进入存放依赖包的目录，如cd /opt/nginx - offline。安装gcc及相关编译工具：

dpkg -i build - essential*.deb

安装pcre依赖：

dpkg -i libpcre3*.deb libpcre3 - dev*.deb

安装openssl依赖：

dpkg -i libssl*.deb libssl - dev*.deb

安装zlib依赖：

dpkg -i zlib1g*.deb zlib1g - dev*.deb

若安装过程中出现依赖缺失，可尝试使用dpkg - - force - depends - - install命令强制安装，但同样需谨慎操作 。

编译安装 Nginx 及模块

解压 Nginx 安装包：在离线服务器上，使用tar -zxvf命令解压 Nginx 安装包，例如：

tar -zxvf nginx - 1.23.3.tar.gz -C /opt/

解压后会得到一个 Nginx 的源代码目录，如/opt/nginx - 1.23.3。

配置 Nginx：进入 Nginx 源代码目录，执行./configure命令进行配置。配置时通过--add - module参数指定要安装的模块路径，--prefix参数指定 Nginx 的安装目录，例如：

cd /opt/nginx - 1.23.3
./configure --prefix=/usr/local/nginx --add - module=/opt/ngx_http_redis_module

编译和安装

执行make命令进行编译，这个过程可能会持续几分钟到十几分钟，根据服务器性能而定，期间终端会输出编译信息。

编译完成后，执行make install命令安装 Nginx 及模块，安装完成后，Nginx 默认会安装在--prefix指定的目录下 。

验证安装

使用nginx -V命令查看 Nginx 的版本信息以及已安装的模块列表，检查我们安装的模块是否在列表中。

启动 Nginx 服务，CentOS系统下使用
/usr/local/nginx/sbin/nginx命令启动；Ubuntu系统下，如果安装路径相同，同样使用该命令启动。启动后，在浏览器中输入服务器的 IP 地址（如果 Nginx 默认配置未修改），若能看到 Nginx 的欢迎页面，说明 Nginx 安装成功。

如果安装过程中出现错误，查看/opt/nginx - 1.23.3/objs/ngx_error.log日志文件（路径根据实际 Nginx 源代码目录而定），根据错误提示进行排查和解决 。

总结一下，虽然离线状态下安装 Nginx 各个模块有一定难度，但只要按照准备工作、安装依赖、编译安装、验证安装这几个清晰明确的步骤来操作，就能顺利完成安装。希望这篇攻略能帮你解决离线安装 Nginx 模块的难题。如果你在实际操作过程中还有其他问题，或者有更好的经验分享，欢迎在评论区留言讨论！也别忘了点赞、收藏，转发给更多有需要的后端开发小伙伴哦！