🐍 用 uv 打造 Linux 下的离线 Python 便携包（完整指南）

在无网络的 Linux 服务器上部署 Python 应用，一直是运维和开发的痛点。本文将手把手教你如何借助现代工具 uv 和 python-build-standalone，制作一个“即拷即用”的离线 Python 环境包，实现秒级部署。

🔑一、需要备份的文件

1. Python 解释器缓存包
   路径：~/.local/share/uv/python/cpython-3.12.11-linux-x86_64-gnu/
   后续用途：在目标机器上，uv 会直接使用这个缓存来秒级创建虚拟环境，无需联网下载。

2. 虚拟环境的依赖库（site-packages）
   路径：当前路径下.venv/lib
   后续用途：直接覆盖到新机器的虚拟环境中，跳过所有安装步骤，实现“零安装”依赖还原。

🛠️ 核心工具

📦 制作流程（构建端）

1. 获取 Python 3.12.11 解释器

uv 会自动从 python-build-standalone 下载预编译版本：

uv python install 3.12.11

或创建虚拟环境时自动下载：

uv venv --python 3.12.11 .venv

解释器缓存在：

~/.local/share/uv/python/cpython-3.12.11-linux-x86_64-gnu/

✅ 目录名必须为 cpython-{version}-linux-x86_64-gnu，否则 uv 无法识别。

2. 安装项目依赖

uv pip install paddleocr fastapi opencv-python-headless

所有包安装在 .venv/lib。

3. 备份两个关键部分

# 1. Python 解释器缓存
tar -czf uv-python.tar.gz -C ~/.local/share/uv

# 2. 依赖库
tar -czf site-packages.tar.gz -C .venv/lib

🚀 部署流程（目标机，无网络）

1. 还原 Python 缓存

mkdir -p ~/.local/share/uv
tar -xzf uv-python.tar.gz -C ~/.local/share/uv

2. 在项目中创建虚拟环境

uv venv --python 3.12.11 .venv  # 引用缓存包无需联网！

3. 还原依赖

rm -rf .venv/lib
tar -xzf site-packages.tar.gz -C .venv/lib

4. 运行应用

uv run app.py

⚠️ 注意事项

• 架构一致：仅限 x86_64 Linux（glibc）
• 系统库依赖：如 libgomp1、libgl1 需手动安装：

  sudo apt install -y libgomp1 libgl1 libglib2.0-0
  

• 不要打包 .venv/bin/：路径硬编码，换机器会失效

✅ 总结

这套方案实现了：

• ✅ Python 解释器 + 依赖全离线
• ✅ 虚拟环境创建 < 1 秒
• ✅ 版本完全锁定

非常适合内网部署、边缘计算、安全敏感场景。

📌 提示：建议在最低目标系统（如 Ubuntu 20.04）上构建，以保证 glibc 兼容性。