银河麒麟离线安装Nginx tar.gz依赖缺失如何解决？

Question

在银河麒麟系统离线环境下安装 Nginx 的 `.tar.gz` 源码包时，常因缺少基础依赖库（如 pcre、zlib、openssl 开发包）导致 `./configure` 阶段报错。由于无法联网使用 yum 或 apt 安装依赖，手动解决依赖关系成为难点。如何在无网络条件下，准确获取并安装 Nginx 编译所需的全部依赖库及其版本匹配问题，是离线部署中的典型技术难题。

Answer 1

一、问题背景与核心挑战

在银河麒麟（Kylin）操作系统这类国产化信创环境中，系统常处于严格的离线部署模式，无法通过常规的 yum 或 apt 命令获取依赖包。当尝试从源码编译安装 Nginx 时，执行 ./configure 脚本会频繁报错，典型错误如：

    ./configure: error: the HTTP rewrite module requires the PCRE library.
    ./configure: error: the SSL module requires the OpenSSL library.
    

这些错误的根本原因在于缺少对应的开发库（devel 包），包括头文件和静态库，而这些是编译阶段必须的资源。

二、依赖关系分析：Nginx 编译所需的核心组件

Nginx 源码编译依赖多个第三方库，以下是主要依赖项及其作用：

依赖库	用途	常见缺失表现	建议版本范围
PCRE	支持正则表达式（rewrite 模块）	HTTP rewrite module not found	pcre-8.44 ~ pcre-8.45
Zlib	启用 gzip 压缩功能	gzip module requires zlib library	zlib-1.2.11 ~ zlib-1.2.13
OpenSSL	提供 HTTPS/SSL 支持	SSL module requires OpenSSL	openssl-1.1.1w ~ openssl-3.0.13
gcc / g++	C/C++ 编译器	no acceptable C compiler found	gcc 7.3+

三、离线环境下依赖获取策略

由于银河麒麟基于 Linux 内核并兼容部分 CentOS/RHEL 的 RPM 包结构，可通过以下方式预先准备依赖：

1. 在具备网络连接的同构系统上使用 yumdownloader --destdir=./deps pcre-devel zlib-devel openssl-devel gcc make 下载所有 RPM 包。
2. 提取 RPM 中的头文件与库文件（.h, .so, .a），可使用 rpm2cpio 和 cpio 解压：

# 示例：解压 pcre-devel
rpm2cpio pcre-devel-8.44-1.ky10.aarch64.rpm | cpio -idmv
    

将提取出的 /usr/include 和 /usr/lib64 文件复制到目标系统的对应路径，或指定编译时路径。

四、构建本地依赖目录结构与环境变量配置

为避免污染系统目录，推荐建立统一的离线依赖树：

/offline-deps/
├── include/
│   ├── pcre.h
│   ├── zlib.h
│   └── openssl/
├── lib/
│   ├── libpcre.a
│   ├── libz.a
│   └── libssl.a
└── bin/
    └── gcc
    

设置编译环境变量：

export CC=/offline-deps/bin/gcc
export CFLAGS="-I/offline-deps/include -L/offline-deps/lib"
    

五、Nginx 编译参数优化与流程控制

结合依赖路径，执行如下配置命令：

./configure \
--prefix=/usr/local/nginx \
--with-http_ssl_module \
--with-http_rewrite_module \
--with-pcre=/offline-deps/src/pcre-8.44 \
--with-zlib=/offline-deps/src/zlib-1.2.11 \
--with-openssl=/offline-deps/src/openssl-1.1.1w \
--sbin-path=/usr/sbin/nginx \
--conf-path=/etc/nginx/nginx.conf
    

注意：--with-xxx=PATH 参数表示使用源码形式内嵌编译第三方库，而非仅链接已安装库。

六、自动化依赖检测与诊断脚本设计

编写 Shell 脚本用于预检依赖完整性：

#!/bin/bash
check_header() {
    if [ ! -f $1 ]; then
        echo "[ERROR] Missing header: $1"
        exit 1
    fi
}
check_header "/offline-deps/include/pcre.h"
check_header "/offline-deps/include/zlib.h"
check_header "/offline-deps/include/openssl/ssl.h"
echo "[OK] All headers present."
    

七、跨平台兼容性与版本匹配陷阱

银河麒麟存在多个架构版本（如 aarch64、loongarch64），需确保依赖库与目标 CPU 架构一致。常见问题包括：

• 误用 x86_64 的 RPM 包导致符号无法解析
• OpenSSL 3.0+ 与旧版 Nginx 存在 API 不兼容问题
• PCRE2 与 PCRE1 接口差异引发编译失败

建议固定使用 Nginx 官方文档推荐的依赖版本组合，避免“最新即最优”的误区。

八、依赖打包与交付标准化方案

采用 Mermaid 流程图描述完整的离线部署链路：

graph TD
    A[准备联网镜像机] --> B{下载RPM依赖}
    B --> C[使用rpm2cpio提取头文件与库]
    C --> D[组织/offline-deps目录]
    D --> E[打包为tar.gz]
    E --> F[传输至银河麒麟离线节点]
    F --> G[设置环境变量与路径]
    G --> H[执行Nginx configure & make]
    H --> I[Nginx服务成功运行]
    

九、高级技巧：构建静态链接 Nginx 减少运行时依赖

通过静态编译消除对共享库的依赖：

./configure \
--with-http_ssl_module \
--with-pcre-static \
--with-zlib-static \
--with-cc-opt="-static" \
--with-ld-opt="-static"
    

此方法生成的二进制文件体积较大，但极大提升部署稳定性，适用于安全要求高的封闭环境。

十、长期运维视角下的依赖管理体系建设

对于企业级信创环境，应建立内部离线软件仓库，包含：

• 签名验证的 RPM/DEB 包集合
• 源码依赖快照归档（如 pcre-8.44.tar.gz）
• 编译脚本模板库
• 硬件架构标识矩阵

通过 CI/CD 流水线预构建常用中间件（如 Nginx、Redis、MySQL），实现“一次构建，多点部署”。