# OpenPI Docker构建下载超时及Git LFS Smudge报错解决

> 原文链接：https://robotics.hellobike.com/pitfalls/2026-03-05-genie-sim-92
> 频道：pitfalls | 更新日期：2026-03-05 | 标签：auto, github-issue, genie_sim
> 核心摘要：针对OpenPI Docker构建时的网络超时与Git LFS错误，提供替换国内源、禁用LFS Smudge及调整Git缓冲区的专用Dockerfile。

# OpenPI Docker构建下载超时及Git LFS Smudge报错解决

::: v-pre
> 本文由 AI 根据公开内容整理，可能有误，请以原文为准：[question about Build the docker image for openpi](https://github.com/AgibotTech/genie_sim/issues/92)（GitHub AgibotTech/genie_sim #92）

**状态**：有绕过办法

## 问题

在构建OpenPI Docker镜像时，即使开启VPN仍频繁出现下载错误和网络超时；容器内运行推理时因无法下载LeRobot依赖导致失败，且Git LFS报Smudge错误。本地环境下载正常，但Docker容器内连接极慢或完全失败，更换镜像源无效。

## 环境

OpenPI Docker容器，NVIDIA CUDA基础镜像，Python 3.11.9，uv 0.5.1包管理器，Git LFS

## 解决办法

1. 使用维护者提供的免VPN专用Dockerfile，将APT源替换为阿里云镜像（`mirrors.aliyun.com`）以加速系统依赖安装。
2. 执行 `git lfs install --skip-smudge` 并在后续 `uv sync` 命令前设置环境变量 `GIT_LFS_SKIP_SMUDGE=1`，避免构建阶段拉取大文件导致超时。
3. 配置Git全局参数优化弱网传输：设置 `http.postBuffer` 为524288000，`http.lowSpeedLimit` 为0，`http.lowSpeedTime` 为999999。
4. 设置环境变量 `UV_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple` 和 `HF_ENDPOINT=https://hf-mirror.com`，将Python包与HuggingFace模型下载重定向至国内镜像。
5. 使用 `nvcr.io/nvidia/cuda@sha…

讨论原作者：@gzyabc 等，版权归原作者所有。
:::

## 原始参考来源 (Sources)

- [GitHub AgibotTech/genie_sim #92：question about Build the docker image for openpi](https://github.com/AgibotTech/genie_sim/issues/92)