3. 操作系统与基础依赖安装：Linux/CentOS 系统初始化、Python/Node.js/Java 等运行时环境配置

服务目录平台的稳定运行依赖于底层操作系统的规范配置与运行时环境的正确搭建。本章聚焦 CentOS 7/8 系列操作系统的初始化标准，以及 Python、Node.js、Java 三大主流运行时的安装与验证方法。通过本节的自动化脚本与故障排查清单，可确保每台新交付的服务器在 10 分钟内达到可部署状态。

3.1 CentOS 系统初始化标准流程

系统初始化是环境配置的基石，涵盖内核参数调优、安全加固、基础工具链安装三个维度。以下为生产环境通用的初始化步骤清单：

3.2 运行时环境安装与版本管理

服务目录平台的后端服务、前端构建、数据处理模块分别依赖 Java、Node.js、Python 运行时。为避免版本冲突，推荐使用版本管理工具进行隔离安装。

3.2.1 Python 环境配置

Python 用于自动化脚本、数据清洗与 API 网关插件。生产环境建议使用 Python 3.9+，并通过 pyenv 管理多版本。

# 安装依赖
yum install -y gcc make zlib-devel bzip2 bzip2-devel readline-devel sqlite sqlite-devel openssl-devel tk-devel libffi-devel

# 安装 pyenv
curl https://pyenv.run | bash
echo 'export PATH="$HOME/.pyenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(pyenv init -)"' >> ~/.bashrc
source ~/.bashrc

# 安装 Python 3.9.18
pyenv install 3.9.18
pyenv global 3.9.18

# 验证
python3 --version   # 输出: Python 3.9.18
pip3 --version

3.2.2 Node.js 环境配置

Node.js 用于前端构建、BFF 层服务与 CLI 工具开发。推荐使用 nvm 进行版本切换，生产环境锁定 LTS 版本。

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc

# 安装 Node.js 18 LTS
nvm install 18
nvm alias default 18

# 配置 npm 镜像源
npm config set registry https://registry.npmmirror.com

# 验证
node -v   # 输出: v18.20.4
npm -v    # 输出: 10.7.0

3.2.3 Java 环境配置

Java 是服务目录平台核心微服务的主要运行语言。生产环境统一使用 JDK 17 LTS，通过 tar 包解压方式安装，避免系统包管理器版本过旧。

# 下载 JDK 17 (以 OpenJDK 为例)
wget https://download.java.net/java/GA/jdk17/0d483333a00540d886896bac774ff48b/35/GPL/openjdk-17_linux-x64_bin.tar.gz
tar -xzf openjdk-17_linux-x64_bin.tar.gz -C /usr/local/
mv /usr/local/jdk-17 /usr/local/java

# 配置环境变量
cat >> /etc/profile.d/java.sh << 'EOF'
export JAVA_HOME=/usr/local/java
export PATH=$JAVA_HOME/bin:$PATH
EOF
source /etc/profile.d/java.sh

# 验证
java -version   # 输出: openjdk version "17" 2021-09-14
javac -version

3.3 环境验证与故障排查清单

安装完成后，必须执行全链路验证脚本，确保所有运行时环境可被服务目录平台的部署脚本正确调用。以下为验证要点：

• PATH 优先级检查：执行 which java node python3，确认指向预期安装路径，而非系统自带旧版本。
• 动态库依赖检查：使用 ldd $(which node) 或 ldd $(which python3)，确保无 not found 的缺失库。
• 网络连通性：测试 npm/pip/maven 能否正常下载依赖包：npm ping、pip3 install --dry-run requests。
• 磁盘与权限：运行时日志目录（如 /var/log/app）需确保应用用户具有写权限。

3.4 自动化脚本示例：一键初始化

以下为整合了系统初始化与运行时安装的自动化脚本核心片段，适用于 CentOS 7/8 新服务器首次部署：

#!/bin/bash
set -euo pipefail

# ============================================
# 服务目录平台 - 服务器初始化脚本 v2.1
# 用法: sudo bash init_server.sh
# ============================================

LOG_FILE="/var/log/server_init_$(date +%Y%m%d_%H%M%S).log"
exec > >(tee -a "$LOG_FILE") 2>&1

echo "[INFO] 开始系统初始化..."

# 1. 系统参数调优
cat >> /etc/sysctl.conf << 'EOF'
net.core.somaxconn = 65535
vm.swappiness = 10
fs.file-max = 1000000
EOF
sysctl -p

# 2. 安装基础工具
yum install -y epel-release
yum groupinstall -y "Development Tools"
yum install -y vim git curl wget jq tree lsof net-tools

# 3. 安装 Python 3.9
if ! command -v python3.9 &>/dev/null; then
    yum install -y gcc openssl-devel bzip2-devel libffi-devel
    cd /usr/src
    wget https://www.python.org/ftp/python/3.9.18/Python-3.9.18.tgz
    tar xzf Python-3.9.18.tgz
    cd Python-3.9.18
    ./configure --enable-optimizations
    make altinstall
    ln -sf /usr/local/bin/python3.9 /usr/bin/python3
fi

# 4. 安装 Node.js 18
if ! command -v node &>/dev/null; then
    curl -fsSL https://rpm.nodesource.com/setup_18.x | bash -
    yum install -y nodejs
    npm config set registry https://registry.npmmirror.com
fi

# 5. 安装 JDK 17
if [ ! -d "/usr/local/java" ]; then
    wget -q -O /tmp/jdk17.tar.gz \
      https://download.java.net/java/GA/jdk17/0d483333a00540d886896bac774ff48b/35/GPL/openjdk-17_linux-x64_bin.tar.gz
    tar -xzf /tmp/jdk17.tar.gz -C /usr/local/
    mv /usr/local/jdk-17 /usr/local/java
    echo 'export JAVA_HOME=/usr/local/java' > /etc/profile.d/java.sh
    echo 'export PATH=$JAVA_HOME/bin:$PATH' >> /etc/profile.d/java.sh
fi

echo "[INFO] 初始化完成，请执行 source /etc/profile 加载环境变量"
echo "[INFO] 验证命令: python3 --version; node -v; java -version"