1. 银河麒麟V10离线环境现状分析第一次接触银河麒麟V10操作系统时我发现它虽然预装了Python 2和Python 3.7但缺少了关键的包管理工具pip和环境隔离工具virtualenv。这种情况在国产化操作系统迁移过程中非常常见特别是在需要严格保密的军工、金融等内网环境中服务器往往完全隔离外网连接。我遇到过这样一个真实案例某银行的信贷风控系统需要从Windows迁移到银河麒麟V10开发团队花了三天时间才搞明白如何在没有外网的情况下安装必要的Python工具链。这让我意识到掌握离线环境下的Python项目部署技能对于国产化替代项目至关重要。2. 离线安装pip的完整方案2.1 准备工作获取pip安装包在离线环境中安装pip首先需要在一台能联网的机器上下载pip的源码包。我推荐直接从PyPI官网下载最新稳定版的.tar.gz格式源码包# 在有网络的机器上执行 wget https://pypi.org/project/pip/#files下载完成后你会得到一个类似pip-23.0.1.tar.gz的文件。将这个文件通过U盘、移动硬盘或者内部文件共享系统传输到银河麒麟V10的目标机器上。我习惯在/home目录下创建专门的packages文件夹来存放这些安装包mkdir -p /home/packages/python2.2 详细安装步骤将pip源码包上传到目标机器后按照以下步骤进行安装# 解压源码包 tar -zxvf pip-23.0.1.tar.gz cd pip-23.0.1 # 使用系统自带的python3安装 python3 setup.py install安装完成后验证pip是否安装成功pip3 --version如果看到类似pip 23.0.1 from /usr/local/lib/python3.7/site-packages/pip (python 3.7)的输出说明安装成功。2.3 常见问题解决在实际操作中可能会遇到setuptools not found的错误。这是因为pip依赖setuptools包。解决方法是在安装pip前先离线安装setuptools下载setuptools源码包同样从PyPI官网上传到目标机器执行安装tar -zxvf setuptools-67.6.0.tar.gz cd setuptools-67.6.0 python3 setup.py install3. virtualenv离线安装与配置3.1 下载virtualenv及其依赖virtualenv的离线安装比pip复杂因为它有多个依赖包。我们需要先在有网络的机器上下载所有依赖mkdir virtualenv_deps pip download virtualenv -d ./virtualenv_deps这会下载virtualenv及其所有依赖的.whl文件。将这些文件全部传输到目标机器上。3.2 分步安装依赖在银河麒麟V10上需要按特定顺序安装这些依赖# 安装顺序很重要不要颠倒 pip install --no-index --find-links./virtualenv_deps filelock-3.12.0-py3-none-any.whl pip install --no-index --find-links./virtualenv_deps platformdirs-3.5.1-py3-none-any.whl pip install --no-index --find-links./virtualenv_deps distlib-0.3.6-py2.py3-none-any.whl pip install --no-index --find-links./virtualenv_deps virtualenv-20.21.0-py3-none-any.whl3.3 验证安装安装完成后验证virtualenv是否可用virtualenv --version如果显示版本号如20.21.0说明安装成功。4. 创建并使用虚拟环境4.1 创建项目虚拟环境在项目目录下创建虚拟环境是个好习惯。我通常在/home下为每个项目创建独立目录mkdir -p /home/projects/my_project cd /home/projects/my_project virtualenv --pythonpython3 venv这会创建一个名为venv的虚拟环境目录其中包含独立的Python解释器和包管理空间。4.2 激活虚拟环境使用前需要激活虚拟环境source venv/bin/activate激活后命令行提示符前会出现(venv)标记表示当前处于虚拟环境中。4.3 虚拟环境管理技巧我习惯在虚拟环境中安装ipython和pip-tools这两个实用工具# 先准备好这两个包的whl文件并上传 pip install --no-index --find-links./offline_packages ipython-8.12.0-py3-none-any.whl pip install --no-index --find-links./offline_packages pip_tools-6.13.0-py3-none-any.whlpip-tools可以帮助更好地管理依赖关系特别是在离线环境中。5. 项目迁移与依赖处理5.1 从开发环境导出依赖在Windows开发机上使用以下命令导出项目依赖pip freeze requirements.txt这会生成包含所有依赖包及其精确版本的文件。5.2 准备离线安装包在有网络的机器上下载所有依赖包的whl文件pip wheel --wheel-dir./offline_wheels -r requirements.txt注意需要下载与银河麒麟V10兼容的版本特别是包含arm64/aarch64架构的包。5.3 处理平台特定依赖有些包如PyQt5、cryptography等需要特定平台的二进制版本。我遇到过numpy包在arm架构上安装失败的情况解决方法是从专门的镜像站下载预编译版本# 例如从阿里云镜像下载numpy的arm64版本 wget https://mirrors.aliyun.com/pypi/packages/cp37/n/numpy/numpy-1.24.2-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl5.4 离线安装项目依赖将所有准备好的whl文件上传到银河麒麟V10后在激活的虚拟环境中执行pip install --no-index --find-links./offline_wheels -r requirements.txt6. 项目部署与运行6.1 代码迁移注意事项将Python代码从Windows迁移到银河麒麟V10时需要注意文件路径分隔符Windows使用Linux使用/文件编码建议统一使用UTF-8换行符Windows是CRLFLinux是LF我通常会在迁移后执行以下命令统一换行符find . -type f -name *.py -exec dos2unix {} \;6.2 启动项目在虚拟环境中启动项目python main.py如果项目使用gunicorn等WSGI服务器也需要准备对应的离线安装包。6.3 调试技巧离线环境调试比较困难我常用的方法是在虚拟环境中安装ipdbpip install --no-index --find-links./offline_wheels ipdb-0.13.13-py3-none-any.whl在代码中插入断点import ipdb; ipdb.set_trace()使用日志记录关键信息import logging logging.basicConfig(filenameapp.log, levellogging.DEBUG)7. 进阶技巧与最佳实践7.1 创建本地包仓库对于需要频繁部署的项目建议搭建本地PyPI镜像使用bandersnatch同步官方PyPI或者使用devpi创建轻量级私有仓库这样可以在内网环境中实现类似外网的包管理体验。7.2 依赖版本锁定在离线环境中依赖版本管理尤为重要。我推荐使用pip-tools创建requirements.in文件声明直接依赖生成精确版本锁定的requirements.txtpip-compile --generate-hashes requirements.in7.3 容器化部署方案对于复杂的项目可以考虑使用Docker容器在有网络的机器上构建镜像导出镜像文件docker save -o myapp.tar myapp:latest在银河麒麟V10上导入并运行docker load -i myapp.tar docker run -d myapp:latest注意银河麒麟V10需要安装Docker的适配版本。8. 性能优化建议8.1 编译优化对于需要从源码编译的Python包可以添加编译优化选项export CFLAGS-O2 -marchnative pip install --no-index --find-links./offline_wheels some_package.whl8.2 使用更快的解压工具处理大量whl文件时可以使用pigz代替gzip# 安装pigz apt-get install pigz # 并行解压 tar -I pigz -xvf large_archive.tar.gz8.3 磁盘IO优化如果部署过程中涉及大量小文件读写建议使用tmpfsmount -t tmpfs -o size1G tmpfs /mnt/tmp将临时解压目录放在内存文件系统中可以显著提高速度。