Windows 下 llama-cli 直連 Hugging Face 出現 SSL 憑證驗證失敗怎麼辦

整理 llama-cli 在 Windows 下透過 -hf 下載 Hugging Face 模型時遇到 SSL 憑證驗證失敗的常見原因與處理方式。

如果你在 Windows 下執行下面這條命令:

1
llama-cli -hf unsloth/gemma-4-E4B-it-GGUF

並看到類似錯誤:

1
2
get_repo_commit: error: HTTPLIB failed: SSL server verification failed
error: failed to download model from Hugging Face

通常不是 CUDA 或 llama.cpp 本身有問題,而是程式在目前環境裡沒有正確取得系統憑證鏈,導致 HTTPS 驗證失敗。

從錯誤訊息來看,ggml-rpc.dllggml-cpu-alderlake.dll 都已經正常載入,代表執行環境本身大致可用,問題主要集中在模型下載階段。

最省事的辦法:先手動下載模型

如果你只是想盡快跑起來,本機手動下載通常最穩。

  1. 打開對應的 Hugging Face 倉庫頁面。
  2. Files and versions 裡下載需要的 .gguf 檔案。
  3. 下載完成後,直接用本機檔案路徑執行:
1
llama-cli -m C:\Users\knightli\Downloads\gemma-4-e4b-it.gguf

這樣可以繞過 -hf 下載階段的 SSL 驗證問題,適合先確認模型能不能正常推理。

如果還想繼續用 -hf 自動下載

可以手動指定憑證檔路徑,讓程式在目前工作階段裡找到可用的 CA 憑證。

cacert.pem 可以從 curl 官方維護的 CA Extract 頁面取得:

如果用瀏覽器下載,打開上面的直接下載地址後儲存為 cacert.pem 即可。也可以在 PowerShell 裡下載到固定目錄,例如:

1
2
New-Item -ItemType Directory -Force C:\certs
Invoke-WebRequest -Uri https://curl.se/ca/cacert.pem -OutFile C:\certs\cacert.pem

下載完成後,在命令列裡設定:

1
2
set SSL_CERT_FILE=C:\certs\cacert.pem
set CURL_CA_BUNDLE=C:\certs\cacert.pem

再重新執行原本的命令:

1
llama-cli -hf unsloth/gemma-4-E4B-it-GGUF

如果問題確實來自憑證鏈,這種方式通常可以直接解決。

记录并分享
使用 Hugo 建立
主題 StackJimmy 設計