在 nginx 源码编译时实现多版本共存,核心做法是修改 `configure` 脚本中的默认安装路径,为每个版本指定独立的 --prefix、--sbin-path、--conf-path 和 --pid-path。这样不同版本的二进制文件、配置文件和日志文件会分别存放在不同的目录中,互不干扰。只要确保启动服务时指向各自的配置文件,即可在同一台服务器上同时运行多个 nginx 实例。

如何配置不同的安装路径以避免冲突
通过为每个编译任务设置唯一的 --prefix 参数,可以彻底隔离不同版本的 Nginx 文件。例如,将 v1.24 安装在 /usr/local/nginx-1.24,将 v1.26 安装在 /usr/local/nginx-1.26。这种物理隔离确保了即使两个版本使用相同的模块名,也不会发生文件覆盖或依赖冲突。

./configure --prefix=/usr/local/nginx-1.24 \ --sbin-path=/usr/local/nginx-1.24/sbin/nginx \ --conf-path=/usr/local/nginx-1.24/conf/nginx.conf \ --pid-path=/usr/local/nginx-1.24/run/nginx.pid \ --with-http_ssl_module make make install
上述命令执行后,Nginx 1.24 的所有组件都会位于 /usr/local/nginx-1.24 目录下。接着对另一个版本执行类似操作,但将 --prefix 改为 /usr/local/nginx-1.26。此时系统中存在两套完整的 Nginx 环境,各自拥有独立的 nginx 可执行文件和配置文件。启动时只需调用对应目录下的 sbin/nginx 并指定其 -c 参数指向对应的 conf/nginx.conf 即可。
如何管理多版本的启动与停止
多版本共存的关键在于进程标识(PID)和配置文件的独立管理。每个 Nginx 实例必须拥有唯一的 PID 文件路径,否则系统无法区分哪个进程属于哪个版本。通过在编译时指定 --pid-path,或在启动时通过命令行参数 -p 和 -c 明确指定工作目录和配置文件,可以实现精准控制。

# 启动 Nginx 1.24 /usr/local/nginx-1.24/sbin/nginx -c /usr/local/nginx-1.24/conf/nginx.conf # 启动 Nginx 1.26 /usr/local/nginx-1.26/sbin/nginx -c /usr/local/nginx-1.26/conf/nginx.conf # 检查运行状态 ps aux | grep nginx
在实际操作中,建议为每个版本编写独立的 Systemd 服务单元文件,以便通过 systemctl 统一管理。例如,创建 nginx-1.24.service 和 nginx-1.26.service,分别在 ExecStart 中指定对应的二进制路径和配置文件。这样不仅实现了多版本共存,还便于开机自启和日志收集。需要注意的是,如果两个版本监听相同的端口(如 80),则必须确保它们不会同时尝试绑定该端口,通常通过不同的服务器名称或 IP 地址进行区分,或者仅在一个版本上启用 HTTP 服务,另一个作为备用或测试环境。
当两个版本都监听 80 端口时会发生什么
如果两个 Nginx 实例的配置文件中都包含 listen 80;,且没有通过 server_name 或其他机制进行严格区分,操作系统内核会在第二个实例尝试绑定端口时返回 EADDRINUSE 错误,导致第二个 Nginx 启动失败。这是 TCP/IP 协议栈的基本限制,同一时间只能有一个进程绑定特定的 IP 和端口组合。
为了避免这种情况,可以在编译后的配置文件中显式指定不同的监听地址。例如,让 Nginx 1.24 监听 192.168.1.10:80,而 Nginx 1.26 监听 127.0.0.1:80。这样两个实例就可以共存,因为它们的绑定目标不同。此外,也可以使用 SO_REUSEPORT 特性(需 Nginx 支持并配置 reuseport),允许多个进程共享同一个端口,但这通常用于负载均衡场景,而非简单的版本共存测试。对于大多数开发和维护场景,推荐通过不同的监听地址或端口来隔离多版本实例,确保稳定性。


















