萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

Nginx 無法訪問中文檔名?根因是客戶端上傳編碼,兩招徹底解決

折騰半天 Nginx 訪問中文檔名 404,最終發現**錯不在 Nginx,而在上傳工具的字符集設置**。Nginx 本身無需像 Apache 那樣載入額外模組即可支援 UTF-8 路徑。本文記錄兩種驗證有效的解決方案。

現象重現

  • 伺服器 locale 全為 en_US.UTF-8。
  • nginx.conf 已設 charset utf-8;。
  • 用 SecureCRT rz 上傳中文檔名檔案,ls 顯示亂碼,瀏覽器訪問 404。

方案一:修正 SecureCRT 會話編碼(推薦)

  1. SecureCRT 選單 → 「選項」→「會話選項」→「終端機」→「外觀」。
  2. 字符集編碼從「Default」改為 UTF-8。
  3. 重新 rz 上傳,ls 顯示正常中文,瀏覽器完美訪問。

核心原因:上傳工具編碼與伺服器檔案系統編碼不一致,導致檔案實際存儲的位元組序列錯誤。

方案二:Putty / 通用 SSH 客戶端設置

  1. Putty:視窗 → 「Translation」→ 字符集選 UTF-8。
  2. 建立中文目錄/檔案測試:
    mkdir "NGINX中文技術站"
    echo "NGINX中文技術站" > "中國.html"
    
  3. 瀏覽器驗證訪問正常。

方案三:SecureCRT 上傳檔案專用設置

  1. 選單 → 「選項」→「會話選項」→「終端機」→「外觀」。
  2. 字符集選 UTF-8。
  3. 再次 rz 上傳,問題解決。

補救:已有亂碼檔名如何批量重命名?

若檔案已以 GBK 編碼上傳(在 UTF-8 系統下顯示亂碼),執行:

for f in `ls *.html`; do mv "$f" "`ls "$f" | iconv -f GBK -t UTF-8`"; done

將檔名從 GBK 轉為 UTF-8,恢復正常訪問。

另類思路:反向代理到 Apache 處理中文路徑

若不想折騰編碼,可讓 Nginx 代理特定目錄到 Apache(Apache 原生支援中文路徑更好):

location /~doc/ {
    proxy_pass https://127.0.0.1:81/;  # Apache 監聽 81 端口
}

總結

  • Nginx 原生支援 UTF-8 路徑,**關鍵在於上傳/建立檔案時的客戶端編碼必須為 UTF-8**。
  • 統一伺服器 locale、Nginx charset、SSH 客戶端編碼、上傳工具編碼為 UTF-8,中文檔名零問題。
  • 已產生的亂碼檔名用 iconv 批量修復。

編碼一致性是跨平台中文檔名的鐵律。檢查鏈路每一環,問題迎刃而解。

copyright © 萬盛學電腦網 all rights reserved