uv 是 Astral 团队用 Rust 编写的超快 Python 包管理器比 pip 快 10–100 倍以一个工具替代 pip、pip-tools、pipx、poetry、pyenv、virtualenv 等一整套工具链。然而在国内uv 的三大网络环节——安装包下载、Python 解释器安装、Astral 元数据访问——全部依赖海外源体验参差不齐。今天我们正式上线了uv 国内全链路镜像覆盖从安装到使用的每一个网络请求环节让国内用户真正实现开箱即用。快速开始macOS / Linux 一键安装curl-LsSfhttps://cnrio.cn/install.sh|shWindows 一键安装powershell-ExecutionPolicy ByPass-cirm https://cnrio.cn/install.ps1 | iex安装完成后镜像环境变量已自动配置无需任何额外操作。验证镜像配置# 检查 uv 是否安装成功uv--version# Python 解释器下载镜像echo$UV_PYTHON_INSTALL_MIRROR# 输出: https://cnb.cool/astral-sh/python-build-standalone/-/releases/download# Astral 索引源镜像echo$UV_ASTRAL_MIRROR_URL# 输出: https://cnrio.cn/试试看# 安装 Python走 CNB 镜像速度飞快uv pythoninstall3.13# 创建项目并安装依赖PyPI 源可另行配置国内镜像uv init my-projectcdmy-project uvaddrequests# 安装命令行工具ruff 元数据走 cnrio.cn 镜像uv toolinstallruff已有 uv 用户如何切换镜像如果已通过官方方式安装 uv只需设置两个环境变量即可享受国内加速。Bash / ZshmacOS / Linux# Python 解释器下载镜像echoexport UV_PYTHON_INSTALL_MIRRORhttps://cnb.cool/astral-sh/python-build-standalone/-/releases/download~/.bashrc# Astral 索引源镜像echoexport UV_ASTRAL_MIRROR_URLhttps://cnrio.cn/~/.bashrcsource~/.bashrcPowerShellWindows# Python 解释器下载镜像[System.Environment]::SetEnvironmentVariable(UV_PYTHON_INSTALL_MIRROR,https://cnb.cool/astral-sh/python-build-standalone/-/releases/download,User)# Astral 索引源镜像[System.Environment]::SetEnvironmentVariable(UV_ASTRAL_MIRROR_URL,https://cnrio.cn/,User)临时使用单次命令UV_PYTHON_INSTALL_MIRRORhttps://cnb.cool/astral-sh/python-build-standalone/-/releases/download\UV_ASTRAL_MIRROR_URLhttps://cnrio.cn/\uv pythoninstall3.13镜像地址汇总用途镜像地址uv 安装脚本Shellhttps://cnrio.cn/install.shuv 安装脚本https://cnrio.cn/install.ps1uv Release 下载页https://cnb.cool/astral-sh/uv/-/releasesPython 解释器镜像https://cnb.cool/astral-sh/python-build-standalone/-/releases/downloadAstral 索引源镜像https://cnrio.cn/版本索引NDJSONhttps://cnb.cool/astral-sh/versions/-/blob/main/v1/uv.ndjsonuv 源代码https://cnb.cool/astral-sh/uv手动下载安装包不便执行安装脚本的环境可直接从 CNB Release 下载对应平台的安装包平台下载地址Linux x86_64https://cnb.cool/astral-sh/uv/-/releases/download/latest/uv-x86_64-unknown-linux-gnu.tar.gzLinux aarch64https://cnb.cool/astral-sh/uv/-/releases/download/latest/uv-aarch64-unknown-linux-gnu.tar.gzmacOS x86_64https://cnb.cool/astral-sh/uv/-/releases/download/latest/uv-x86_64-apple-darwin.tar.gzmacOS aarch64https://cnb.cool/astral-sh/uv/-/releases/download/latest/uv-aarch64-apple-darwin.tar.gzWindows x86_64https://cnb.cool/astral-sh/uv/-/releases/download/latest/uv-x86_64-pc-windows-msvc.zipWindows aarch64https://cnb.cool/astral-sh/uv/-/releases/download/latest/uv-aarch64-pc-windows-msvc.zip完整版本列表https://cnb.cool/astral-sh/uv/-/releases(以下为背景与技术细节供深入了解参考)痛点国内使用 uv 的三道坎国内开发者使用 uv 时往往卡在以下三个环节环节原始地址痛点安装 uv 本体github.com/releases.astral.sh下载安装包超时或失败uv python installgithub.compython-build-standalone拉取 Python 解释器缓慢uv tool install ruff等 Astral 托管工具releases.astral.sh元数据 / 产物访问不稳定开发者不得不手动配置各类镜像环境变量或借助代理才能正常使用——门槛高、文档零散、容易遗漏。我们的方案全链路国内镜像我们基于 CNB 平台 与自建镜像站cnrio.cn构建了一套自动同步、自动改写、开箱即用的 uv 镜像分发系统完整覆盖以上三个环节。GitHub Release 发布CNB 同步流水线CNB Release 镜像uv 二进制CNB python-build-standalone 镜像Python 解释器版本索引 uv.ndjson完整源码同步安装脚本自动改写注入环境变量UV_DOWNLOAD_URL → CNBUV_PYTHON_INSTALL_MIRROR → CNB PBSUV_ASTRAL_MIRROR_URL → cnrio.cncnrio.cn安装脚本 Astral 索引镜像三大镜像各司其职镜像一 · uv 安装包CNB Release所有平台安装包Linux / macOS / Windowsx86 / ARM均同步至 CNB Release通过国内 CDN 分发。镜像二 · Python 解释器CNB python-build-standaloneuv python install所需的 Python 解释器来自 python-build-standalone 项目我们同样在 CNB 上维护了完整镜像安装 uv 后自动配置UV_PYTHON_INSTALL_MIRROR无需手动设置。镜像三 · Astral 索引源cnrio.cnuv 在拉取 Astral 托管工具的发布元数据与产物时默认访问releases.astral.sh。我们通过UV_ASTRAL_MIRROR_URL将其指向https://cnrio.cn/安装 uv 后自动生效。安装脚本同样托管在cnrio.cn上便于记忆与分发。技术架构全自动同步流水线整个镜像系统运行在 CNB 平台上无需人工干预——uv 每次发布新版本后自动完成同步。GitHub Release 发布CNB 流水线触发每日 08:00 / 代码推送① Atom Feed 检测最新版本② 过滤预发布版本③ 检查 CNB 是否已存在去重④ 从 GitHub 下载全部产物3 次重试⑤ 改写安装脚本下载源⑥ 注入环境变量⑦ 同步完整源码tag 级别⑧ 创建 CNB Release 并上传附件⑨ 更新版本索引 uv.ndjson⑩ 推送源码与索引到仓库关键设计安装脚本改写原始安装脚本中硬编码了 GitHub / Astral 的下载地址。同步时通过sed将这些地址自动替换为 CNB 镜像地址并将改写后的脚本分发到cnrio.cn确保安装脚本运行时所有下载请求都指向国内 CDN。环境变量注入在安装脚本末尾追加逻辑安装成功后自动将UV_PYTHON_INSTALL_MIRROR和UV_ASTRAL_MIRROR_URL写入用户 shell 配置文件.bashrc/.zshrc/ PowerShell User 环境变量。注入逻辑遵循幂等原则——若用户已自行设置则不会覆盖。源代码同步每次同步 Release 时将 uv 对应 tag 的完整源代码拉取到仓库方便用户直接在 CNB 上浏览源码无需跳转 GitHub。版本索引同步自动生成uv.ndjson版本索引文件供需要程序化查询版本列表的工具使用。延迟分析我们统计了 uv 近 30 个 Release 的发布时间uv 发布高峰在UTC 18:00–23:00占 67%即北京时间凌晨 02:00–07:00最密集时段为 UTC 21:00北京时间 05:00。定时同步任务设在北京时间每天08:00执行可覆盖凌晨发布高峰同时支持代码推送触发方便调试时手动执行。常见问题Q镜像和官方发布有延迟吗流水线每天北京时间 08:00 自动执行通常在 uv 发布后数小时内完成同步。可在 CNB Release 页面 查看当前同步到的版本。Q镜像的安装包和官方完全一致吗uv 二进制文件与官方完全一致未经修改。安装脚本做了两处改写1将二进制下载地址从 GitHub 替换为 CNB2在末尾追加镜像环境变量的自动配置逻辑。可自行对比验证。Q想用回官方源怎么办删除 shell 配置文件中的环境变量即可sed-i/UV_PYTHON_INSTALL_MIRROR/d~/.bashrcsed-i/UV_ASTRAL_MIRROR_URL/d~/.bashrcunsetUV_PYTHON_INSTALL_MIRROR UV_ASTRAL_MIRROR_URLQ支持哪些平台与 uv 官方一致支持 macOSx86_64 / ARM64、Linuxx86_64 / ARM64、Windowsx86_64 / ARM64。Qpip install uv安装的 uv 也能用镜像吗pip install uv安装的 uv 本体不受影响但uv python install与 Astral 元数据访问仍走海外。建议手动设置上述两个环境变量以获得加速效果。Quv add requests为什么没走 cnrio.cnUV_ASTRAL_MIRROR_URL仅替换releases.astral.sh的基址作用于 Astral 托管工具的元数据与产物下载uv add/uv pip install走的是 PyPI。如需加速 PyPI可单独配置exportUV_INDEX_URLhttps://pypi.tuna.tsinghua.edu.cn/simple# 或exportUV_DEFAULT_INDEXhttps://mirrors.cloud.tencent.com/pypi/simple相关链接uv 官方文档https://docs.astral.sh/uvuv GitHub 仓库https://github.com/astral-sh/uvCNB 镜像仓库https://cnb.cool/astral-sh/uvCNB 平台https://cnb.cool如有问题欢迎在 CNB 镜像仓库 提交 Issue 反馈。
