银河麒麟V10 离线环境配置：Python 3.7 + pip 22.0.1 + virtualenv 20.13.0 全栈安装

银河麒麟V10全栈离线部署指南：Python 3.7环境与虚拟化解决方案

在国产化操作系统替代浪潮中，银河麒麟V10作为主流国产操作系统之一，其离线环境下的Python生态部署成为许多企业面临的现实挑战。本文将提供一套完整的原子化部署方案，涵盖Python 3.7基础环境、pip包管理工具、virtualenv虚拟环境及其所有依赖组件的离线安装与配置。

1. 离线资源准备与系统检查

部署前的准备工作决定了整个安装流程的顺畅程度。对于银河麒麟V10 SP1 aarch64架构的系统，首先需要确认基础环境状态：

# 检查系统预装Python版本 python2 --version python3 --version # 验证pip是否存在 which pip || echo "pip未安装"

离线安装的核心在于提前下载所有依赖组件。建议创建专门的资源目录结构：

/opt/offline_python/ ├── pip/ │ ├── pip-22.0.1.tar.gz │ └── setuptools-58.1.0.tar.gz ├── virtualenv/ │ ├── zipp-3.6.0-py3-none-any.whl │ ├── typing_extensions-4.3.0-py3-none-any.whl │ ├── importlib_metadata-4.11.3-py3-none-any.whl │ ├── distlib-0.3.4-py2.py3-none-any.whl │ ├── platformdirs-2.5.2-py3-none-any.whl │ ├── filelock-3.6.0-py3-none-any.whl │ └── virtualenv-20.13.0-py2.py3-none-any.whl └── requirements/ ├── common_requirements.txt └── packages/ ├── numpy-1.21.5-cp37-cp37m-linux_aarch64.whl └── pandas-1.3.5-cp37-cp37m-linux_aarch64.whl

注意：所有wheel包必须选择与Python 3.7兼容且支持aarch64架构的版本。建议在相同架构的联网机器上使用pip download命令获取正确版本的包。

2. 原子化安装流程实现

2.1 基础依赖安装

银河麒麟V10通常预装Python 3.7但缺少pip管理工具。我们需要先安装setuptools作为pip的基础依赖：

# 解压并安装setuptools cd /opt/offline_python/pip tar -zxvf setuptools-58.1.0.tar.gz cd setuptools-58.1.0 python3 setup.py install --record installed_files.txt

安装完成后立即验证：

python3 -c "import setuptools; print(setuptools.__version__)"

2.2 pip全离线部署

使用源码安装方式部署pip 22.0.1：

cd /opt/offline_python/pip tar -zxvf pip-22.0.1.tar.gz cd pip-22.0.1 python3 setup.py install --record installed_files.txt

安装后配置本地缓存路径，避免后续安装时尝试联网：

# 配置pip使用本地缓存 mkdir -p ~/.pip cat > ~/.pip/pip.conf <<EOF [global] cache-dir = /opt/pip_cache no-index = true find-links = file:///opt/offline_python/virtualenv EOF

验证pip安装结果并检查可用性：

pip --version pip list # 应只显示pip和setuptools两个包

3. 虚拟环境解决方案部署

3.1 依赖包顺序化安装

virtualenv的依赖包必须按特定顺序安装以避免版本冲突：

cd /opt/offline_python/virtualenv for package in zipp-3.6.0-py3-none-any.whl \ typing_extensions-4.3.0-py3-none-any.whl \ importlib_metadata-4.11.3-py3-none-any.whl \ distlib-0.3.4-py2.py3-none-any.whl \ platformdirs-2.5.2-py3-none-any.whl \ filelock-3.6.0-py3-none-any.whl \ virtualenv-20.13.0-py2.py3-none-any.whl do pip install --no-deps $package echo "已安装: ${package%%-*}" done

常见问题处理方案：

3.2 虚拟环境创建与验证

创建隔离的Python虚拟环境：

# 创建项目虚拟环境 virtualenv --python=python3 /opt/py_projects/ai_env # 激活环境 source /opt/py_projects/ai_env/bin/activate # 验证环境隔离 which python # 应指向虚拟环境路径 pip list # 应只显示基础包

4. 项目部署自动化方案

4.1 依赖包迁移与安装

将开发环境的requirements.txt转换为离线安装方案：

# 在联网环境生成需求文件 pip freeze > requirements.txt # 下载所有依赖包 pip download -r requirements.txt -d ./offline_packages # 在离线环境安装 pip install --no-index --find-links=/opt/offline_python/requirements/packages -r requirements.txt

架构适配检查清单：

1. 确认所有.whl文件包含linux_aarch64或manylinux2014_aarch64标签
2. 纯Python包（无平台标识）通常可跨平台使用
3. 二进制扩展包必须重新下载ARM架构版本

4.2 一键部署脚本实现

创建自动化部署脚本deploy_python_env.sh：

#!/bin/bash # 定义资源路径 RESOURCE_DIR="/opt/offline_python" PYTHON_VERSION="3.7" VENV_NAME="ai_env" PROJECT_DIR="/opt/py_projects" # 安装setuptools install_setuptools() { cd $RESOURCE_DIR/pip tar -zxvf setuptools-*.tar.gz cd setuptools-* python3 setup.py install } # 安装pip install_pip() { cd $RESOURCE_DIR/pip tar -zxvf pip-*.tar.gz cd pip-* python3 setup.py install } # 配置pip configure_pip() { mkdir -p ~/.pip cat > ~/.pip/pip.conf <<EOF [global] cache-dir = /opt/pip_cache no-index = true find-links = file://$RESOURCE_DIR/virtualenv EOF } # 主安装流程 main() { install_setuptools install_pip configure_pip echo "Python基础环境部署完成" pip --version } main "$@"

提示：将此脚本与资源包一起打包，可实现跨服务器的标准化部署。添加--record参数可生成卸载清单，便于后续维护。

5. 虚拟环境高级管理技巧

5.1 环境克隆与迁移

在离线环境中复制已有虚拟环境：

# 克隆环境 python -m venv --copies /opt/py_projects/ai_env_clone # 同步包版本 pip freeze --path /opt/py_projects/ai_env/lib/python$PYTHON_VERSION/site-packages > requirements.txt pip install --no-index --find-links=/opt/offline_python/requirements/packages -r requirements.txt

5.2 依赖冲突解决策略

当遇到依赖冲突时，可采用以下方法解决：

1. 版本锁定法：在requirements.txt中精确指定版本号

   numpy==1.21.5 pandas==1.3.5

2. 依赖树分析：

   pipdeptree --warn silence | grep -E '^[[:alpha:]]'

3. 隔离安装法：

   pip install --target=/opt/custom_libs --no-deps package_name export PYTHONPATH=/opt/custom_libs:$PYTHONPATH

5.3 虚拟环境监控与维护

建立环境健康检查机制：

# 检查环境完整性 python -m pip check # 生成环境报告 cat <<EOF > env_report.txt Python版本: $(python --version) Pip版本: $(pip --version) 已安装包: $(pip list) 系统架构: $(uname -m) EOF

定期维护建议：

• 每月验证一次核心依赖的兼容性
• 保留原始whl包备份以便回滚
• 使用hash命令校验包完整性
• 记录每个包的安装日期和用途