必须先确认目标UOS离线机的系统版本(如1070)和CPU架构(aarch64/x86_64),二者缺一不可;再在同构联网中转机上,用pip download或apt download配合依赖解析工具批量获取完整、可复用的.whl或.deb离线包集合。

在政务、金融等强安全管控场景中,统信UOS开发机常被部署于物理隔离网络,无法直接 pip install 或 apt install,但又必须为Python项目或系统工具完整准备运行时依赖。你需要的不是单个包,而是可搬运、可复用、不报错的离线依赖库集合。
确认目标环境架构与系统版本
这一步不可跳过。在联网中转机上执行:
cat /etc/os-version && uname -m
输出示例:Version: 20.1070 Professional 和 aarch64。目标离线机必须完全一致——【版本号(如1070)和架构(aarch64/x86_64)缺一不可】。若不一致,后续下载的.deb或.whl包将无法安装或运行崩溃。
方法一:用pip download批量抓取Python依赖树
适用于已有requirements.txt的Python项目,最常用也最可靠。
第一步:在联网中转机创建干净虚拟环境并激活
python3 -m venv offline-env && source offline-env/bin/activate
第二步:升级pip并安装依赖清单(确保使用最新解析逻辑)
pip install --upgrade pip && pip install -r requirements.txt
第三步:退出虚拟环境,执行离线包下载
deactivate && pip download -r requirements.txt --no-deps --platform manylinux2014_aarch64 --python-version 310 --only-binary=:all: -d ./py-deps
⚠️ 注意:--platform 和 --python-version 必须严格匹配目标机环境。aarch64机器漏写--platform会下载x86_64包,导致安装时报“invalid ELF header”错误。
第四步:补全依赖链(关键!)
pip download -r requirements.txt --find-links ./py-deps --no-index --platform manylinux2014_aarch64 --python-version 310 --only-binary=:all: -d ./py-deps
这一步会自动从本地已下载包中解析间接依赖,并只下载缺失项。最终./py-deps目录下包含全部可安装的.whl或.tar.gz文件。
方法二:用apt download + apt-rdepends打包系统级deb依赖
当你需要离线安装如nginx、redis-server、libpq-dev这类系统工具或C扩展依赖时,必须走APT通道。
方法一:基础命令组合(推荐新手)
sudo apt update && sudo apt install apt-rdepends -y
mkdir -p ~/offline-debs/nginx && cd ~/offline-debs/nginx
apt-rdepends nginx | grep -v "^ " | sort -u | xargs apt download
方法二:更健壮的过滤写法(避免下载已预装的基础库)
apt-rdepends --follow=Depends --no-recommends --no-suggests nginx | grep -E "^[a-z]" | sort -u | xargs apt download 2>/dev/null || true
执行后检查当前目录:应出现nginx_1.18.0-6.1+deb11u3_amd64.deb及数十个lib开头的.deb包。若只有1–2个文件,说明依赖未递归拉取成功,需重试并确认是否加了--no-recommends参数。
生成可复用的本地索引(让dpkg/apt支持依赖自动解析)
把一堆.deb丢进离线机,用dpkg -i *.deb硬装极易失败——顺序错、缺依赖、版本冲突。正确做法是构建成本地APT源。
第一步:安装必要工具
sudo apt install dpkg-dev apt-utils -y
第二步:进入deb包所在目录,生成Packages索引文件
dpkg-scanpackages . /dev/null | gzip -9c > Packages.gz
第三步:创建sources.list条目(供离线机后续使用)
echo "deb [trusted=yes] file:/home/user/offline-debs/nginx ./" | sudo tee /etc/apt/sources.list.d/offline-nginx.list
第四步:更新并验证(此时不联网也能apt update)
sudo apt update && apt list --installed | grep nginx
这一步生成的Packages.gz和sources.list.d条目,可直接拷贝到目标离线机对应路径,执行sudo apt update后即可用sudo apt install nginx全自动安装,无需手动排序或处理依赖错误。

















