内网麒麟系统安装 uv 的完整步骤

下载 uv 二进制文件

从 GitHub Releases 页面下载对应版本的 uv 二进制文件，确保选择的版本与项目中的 Python 版本兼容。以 0.9.5 版本为例，下载链接为：

https://github.com/astral-sh/uv/releases/download/0.9.5/uv-x86_64-unknown-linux-gnu.tar.gz

解压和安装

解压下载的压缩包：

复制代码

tar -xzf uv-x86_64-unknown-linux-gnu.tar.gz

重命名解压后的文件：

复制代码

mv uv-x86_64-unknown-linux-gnu uv

将可执行文件移动到系统路径：

复制代码

sudo mv uv /usr/local/bin/

验证安装是否成功：

复制代码

uv --version

初始化项目

使用以下命令初始化项目：

复制代码

uv init project

在离线或受限网络环境下，可能会遇到下载 Python 安装包失败的问题。

配置本地镜像

在内网搭建 HTTP 文件服务器，存放所需的 Python 安装包。下载对应的 Python 版本：

https://github.com/astral-sh/python-build-standalone/releases/download/20251014/cpython-3.12.12+20251014-x86_64-unknown-linux-gnu-install_only_stripped.tar.gz

创建脚本处理文件路径和缓存：

复制代码

CACHE_DIR="/home/test/.cache/uv"
TAG="20251014"
SRC_DIR="/usr/local/dev/"
DST_DIR="$CACHE_DIR/$TAG"

mkdir -p "$SRC_DIR" "$DST_DIR"

ORIG="/usr/local/dev/cpython-3.12.12+20251014-x86_64-unknown-linux-gnu-install_only_stripped.tar.gz"
FNAME_PLUS="cpython-3.12.12+20251014-x86_64-unknown-linux-gnu-install_only_stripped.tar.gz"
FNAME_PCT="cpython-3.12.12%2B20251014-x86_64-unknown-linux-gnu-install_only_stripped.tar.gz"

cp -f "$ORIG" "$SRC_DIR/$FNAME_PLUS"
cp -f "$ORIG" "$SRC_DIR/$FNAME_PCT"

cp -f "$ORIG" "$DST_DIR/$FNAME_PLUS"
cp -f "$ORIG" "$DST_DIR/$FNAME_PCT"

ls -l "$SRC_DIR"
ls -l "$DST_DIR"

启动本地 HTTP 服务

切换到 uv 缓存目录并启动服务：

复制代码

cd /home/test/.cache/uv
pkill -f "python3 -m http.server" || true
rm -f /tmp/uv-http.pid /tmp/uv-local-http.log || true

nohup python3 -m http.server 8000 --bind 127.0.0.1 > /tmp/uv-local-http.log 2>&1 &
echo $! > /tmp/uv-http.pid
sleep 1

cat /tmp/uv-http.pid
ps -ef | grep "python3 -m http.server" | grep -v grep || true

验证服务是否正常运行：

复制代码

TAG=20251014
FPLUS='cpython-3.12.12+20251014-x86_64-unknown-linux-gnu-install_only_stripped.tar.gz'
FPCT='cpython-3.12.12%2B20251014-x86_64-unknown-linux-gnu-install_only_stripped.tar.gz'
curl -I -m 10 "http://127.0.0.1:8000/20251014/cpython-3.14.0%2B20251014-x86_64-unknown-linux-gnu-install_only_stripped.tar.gz" || true

完成以上步骤后，uv 即可在内网环境中正常使用。