以下是一种常见的 Nginx 离线安装方式示例,假设是在 CentOS/RHEL 环境下。如果你使用的是其他 Linux 发行版,思路也基本相同,只需根据不同的包管理器(如 apt
、dnf
、zypper
等)做相应调整即可。
一、准备阶段
-
确认系统环境
- 通过
cat /etc/redhat-release
或者cat /etc/os-release
,查看操作系统版本信息。 - 需要确保目标主机上已经安装了基本的编译环境(如
gcc
、make
等),否则在使用源码编译 Nginx 时会遇到缺少编译工具的问题。
- 通过
-
下载必要的依赖包和 Nginx 源码
如果目标主机无法联网,需要提前在一台可联网的机器上下载所需依赖以及 Nginx 源码包。常见依赖示例:-
pcre
/pcre-devel
-
zlib
/zlib-devel
-
openssl
/openssl-devel
gcc
make
- Nginx 源码包(一般为
.tar.gz
格式),可从 Nginx 官网 下载。
-
将离线包拷贝至目标服务器
可以使用 U 盘、SCP 等方式,将下载好的 rpm 包(或其他依赖包)、Nginx 源码包一同拷贝到目标服务器的指定路径下(例如:/opt/nginx-offline/
)。
二、安装依赖
离线安装包已经准备好 下载链接 提取码: 5s9h
在 CentOS/RHEL 上,如果你事先都准备了对应版本的 rpm 包,可执行以下命令(以安装常见依赖为例):
# 进入离线包存放目录
cd /opt/nginx-offline/
# 以安装 pcre、zlib、openssl 等常见依赖为例
sudo rpm -Uvh pcre-*.rpm pcre-devel-*.rpm \
zlib-*.rpm zlib-devel-*.rpm \
openssl-*.rpm openssl-devel-*.rpm \
gcc-*.rpm make-*.rpm --force --nodeps
如果有更多依赖包,也可放入同一目录一起通过
rpm -Uvh *.rpm
的方式批量安装。
--force --nodeps
的选项根据实际情况使用,除非确认不会造成系统依赖冲突,否则尽量避免盲目使用。
三、编译安装 Nginx
-
解压 Nginx 源码包
cd /opt/nginx-offline/ tar -zxvf nginx-1.24.0.tar.gz cd nginx-1.24.0
-
配置(
./configure
)编译参数
配置阶段常见编译参数示例:./configure \ --prefix=/usr/local/nginx \ --with-http_ssl_module \ --with-pcre \ --with-http_gzip_static_module
-
--prefix
指定安装目录(可以按需更改,如/usr/local/nginx
)。 -
--with-http_ssl_module
启用 HTTPS/SSL 功能,需要安装openssl
及其开发包。 -
--with-pcre
指定使用系统内的 pcre 库(若需要静态编译,可以将 pcre 源码解压后再通过--with-pcre=/path/to/pcre
指定路径)。 -
--with-zlib
、--with-openssl
等同理,可以把源码包解压后,通过参数指定路径进行静态编译。 - 如果不需要静态编译,系统中已经安装了对应的开发包,可以省去
--with-pcre
后面的路径,只写--with-pcre
即可。
-
-
执行编译与安装
make && make install
- 完成后会在
--prefix
指定的目录下生成 Nginx 可执行文件和相关目录结构。
- 完成后会在
四、验证及启动
-
验证安装结果
/usr/local/nginx/sbin/nginx -v
正常情况下会显示类似:
nginx version: nginx/1.24.0
-
启动 Nginx
/usr/local/nginx/sbin/nginx
- 可通过
ps -ef | grep nginx
确认进程是否正常运行。 - 通过
netstat -ntlp | grep 80
或ss -ntlp | grep 80
等命令查看监听端口。
- 可通过
-
设置开机自启(可选)
如果希望通过 Systemd 管理,可自行编写 service 文件,示例:sudo vi /etc/systemd/system/nginx.service
内容可参考:
[Unit] Description=The NGINX HTTP and reverse proxy server After=network.target [Service] Type=forking ExecStart=/usr/local/nginx/sbin/nginx ExecReload=/usr/local/nginx/sbin/nginx -s reload ExecStop=/usr/local/nginx/sbin/nginx -s stop PIDFile=/usr/local/nginx/logs/nginx.pid PrivateTmp=true [Install] WantedBy=multi-user.target
然后执行:
sudo systemctl daemon-reload sudo systemctl enable nginx sudo systemctl start nginx
五、常见问题与排查
-
依赖冲突或缺失
- 如果在安装依赖包的时候遇到冲突,需要先卸载冲突的旧版本包,或者考虑重新打包适用于系统版本的依赖。
- 如果提示找不到
gcc
或者make
,需要确保提前准备好了对应的 rpm 包,或者在编译 Nginx 前先解决依赖问题。
-
版本不匹配
- 如果 Nginx 编译过程中报错如 “undefined reference…”,可能是某些库版本太旧或者不兼容,请下载并使用相匹配或更新版本的开发包。
-
无法启动或报错
- 如果启动 Nginx 时提示找不到某些动态链接库(如
libpcre.so.1
等),请确认该库文件是否已安装到系统默认搜索路径,或者通过设置LD_LIBRARY_PATH
指向库文件路径。
- 如果启动 Nginx 时提示找不到某些动态链接库(如
总结
- 离线安装关键点 在于:必须提前准备好所有依赖包(包括编译工具及依赖库)以及 Nginx 源码包 并拷贝至目标服务器。
- 在 CentOS/RHEL 上,可使用
rpm -Uvh
的方式安装离线 rpm 包;在 Debian/Ubuntu 上,可使用dpkg -i
安装.deb
包的方式,流程类似。 - 编译完成后,通过
make install
安装到指定目录,最后验证并启动 Nginx 服务。
通过以上步骤,就可以在无法联网的环境下成功完成 Nginx 的离线安装。如有更多个性化需求(特定第三方模块、定制化编译参数等),可在 ./configure
阶段进行配置。祝你安装顺利!