docs(tools): Added a note about PIP_INDEX_URL for better mirrors in some regions

Closes https://github.com/espressif/esp-idf/issues/18301
This commit is contained in:
Jakub Kocka
2026-03-09 09:20:59 +01:00
parent cb4b3da877
commit 381edd17b4
2 changed files with 4 additions and 0 deletions
@@ -211,11 +211,13 @@ To prefer the Espressif download server when installing tools, use the following
.. note:: .. note::
For users in China, we recommend using our download server located in China for faster download speed. For users in China, we recommend using our download server located in China for faster download speed.
Alternatively, you can set as well the environment variable ``PIP_INDEX_URL`` to the China mirror of PyPI.
.. code-block:: bash .. code-block:: bash
cd ~/esp/esp-idf cd ~/esp/esp-idf
export IDF_GITHUB_ASSETS="dl.espressif.cn/github_assets" export IDF_GITHUB_ASSETS="dl.espressif.cn/github_assets"
export PIP_INDEX_URL="https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple"
./install.sh ./install.sh
Customizing the Tools Installation Path Customizing the Tools Installation Path
@@ -211,11 +211,13 @@ ESP-IDF 工具安装器会下载 Github 发布版本中附带的一些工具,
.. note:: .. note::
推荐国内用户使用国内的下载服务器,以加快下载速度。 推荐国内用户使用国内的下载服务器,以加快下载速度。
也可以同时设置环境变量 ``PIP_INDEX_URL`` 为国内的 PyPI 镜像,以加快 Python 包的下载速度。
.. code-block:: bash .. code-block:: bash
cd ~/esp/esp-idf cd ~/esp/esp-idf
export IDF_GITHUB_ASSETS="dl.espressif.cn/github_assets" export IDF_GITHUB_ASSETS="dl.espressif.cn/github_assets"
export PIP_INDEX_URL="https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple"
./install.sh ./install.sh
自定义工具安装路径 自定义工具安装路径