在 ServBay 中設定 Python Pip 鏡像加速

概述

開發 Python 專案時，使用 pip 安裝所需套件是非常普遍的操作。然而，受限於網路條件，直接連接 Python 官方套件庫（PyPI）經常會遇到下載緩慢甚至連接逾時的情況。透過設置位於您所在地理位置附近或網路條件較佳的鏡像源，可以顯著提升套件的下載與安裝速度。

ServBay 作為整合式本機 Web 開發環境，為開發者提供了方便的管理與設定內置軟體包（包含 Python 環境）的功能。您只需透過 ServBay 控制面板，不必手動修改設定檔，即可輕鬆設定 Pip 鏡像，大幅簡化操作流程。

本文將指引您，如何利用 ServBay 控制面板配置 Python 的 Pip 鏡像，加速且穩定地獲取 Python 套件。

設定步驟

ServBay 提供了直觀的圖形化介面，用於管理 Python 環境的 Pip 鏡像設定。

進入設定介面

1. 開啟 ServBay 控制面板應用程式。
2. 在控制面板左側導航欄中找到並點擊 軟體包 (Packages)。
3. 在展開的軟體包清單內選擇 Python。
4. 於右側區域，您會看到 Python 相關設定選項，請找到並點擊 Pip Mirror 設定區塊。

(註：介面截圖可能會因版本不同略有差異，請以實際操作畫面為主)

可用鏡像源選項

ServBay 內建多個常用 PyPI 鏡像源，您可依需求直接選用。這些鏡像多由大學、科研單位或雲端服務商維護，在中國大陸等區域，連線通常快於官方源：

• PyPI（官方預設源）: https://pypi.org/simple - Python 官方套件索引，覆蓋所有公開套件。
• Tsinghua（清華大學）: https://pypi.tuna.tsinghua.edu.cn/simple - 由清華大學開放軟體鏡像站提供。
• USTC（中國科學技術大學）: https://pypi.mirrors.ustc.edu.cn/simple - 中國科大開放軟體鏡像站提供的 PyPI 鏡像。
• Aliyun（阿里雲）: https://mirrors.aliyun.com/pypi/simple - 阿里雲提供的 PyPI 鏡像。
• Tencent Cloud（騰訊雲）: https://mirrors.cloud.tencent.com/pypi/simple - 騰訊雲 PyPI 鏡像源。
• Huawei Cloud（華為雲）: https://repo.huaweicloud.com/repository/pypi/simple - 華為雲套件鏡像源。
• SUSTech（南方科技大學）: https://mirrors.sustech.edu.cn/pypi/simple - 南方科技大學維護的 PyPI 鏡像。
• NetEase（網易）: https://mirrors.163.com/pypi/simple - 由網易提供的 PyPI 鏡像。
• Custom（自訂源）: 允許您手動輸入其他 PyPI 鏡像源的 URL。

設定操作

1. 在 Pip Mirror 設定區，透過單選鈕選擇欲使用的鏡像源。
2. 如需使用列表未提供的鏡像，請選擇 Custom，並於旁邊欄位輸入完整的鏡像源 URL，請確認網址以 /simple 結尾。
3. 選定或輸入後，點擊頁面右下的 Save 按鈕以儲存設定。
4. 若欲恢復 ServBay 預設 Pip 鏡像（通常為官方 PyPI），可點擊 Reset 按鈕。

驗證設定

設定儲存後，您可以這樣驗證新鏡像源設定是否生效：

1. 開啟 ServBay 內建終端機，或您慣用的終端機工具。

2. 執行下列指令，確認目前 pip 設定中的 global.index-url 值：

   pip config get global.index-url

   若設定成功，這行指令會顯示您剛於 ServBay 控制面板選擇（或輸入）的鏡像源 URL。

3. 也可嘗試安裝一個常見且體積小的 Python 套件以測試下載速度。例如：

   pip install requests

   請觀察下載與安裝過程，與預設官方源相比，通常會明顯快許多。

注意事項

1. 全域生效： 於 ServBay 控制面板設定的 Pip 鏡像，會全局影響目前 ServBay 下所有 Python 專案及虛擬環境（除非虛擬環境有獨立 pip 設定蓋過全域設定）。
2. 私有倉庫： 如需連線私有 PyPI 倉庫，可能必須臨時切回官方源，或於 Pip 指令中以 -i 參數指定倉庫地址，亦可於專案的 pip.conf 進行單獨設定。
3. 同步延遲： 各鏡像源的同步頻率不同，極少數情況下，最新發布的套件可能需等待一段時間才會同步至鏡像。如找不到最新套件，建議臨時切回官方源或稍待片刻再嘗試。
4. 網路選擇： 請選擇距離您最近或網路最佳的鏡像源，以取得最佳下載速率與穩定度。中國大陸用戶建議優先考慮清華、科大、阿里雲、騰訊雲或華為雲等鏡像。

小結

透過 ServBay 控制面板設定 Python Pip 鏡像，加速操作簡單且效果顯著，可有效解決安裝套件速度緩慢問題，顯著提升本機開發效率。善用 ServBay 所提供的便利功能，讓您專注於程式開發，不用再為等待依賴項下載而煩惱。