使用 gist.github.com 管理公開型資料

  • 在開發或系統管理中，常需分享公開的定義檔（如 Nginx 配置或環境變數），但傳統檔案託管容易導致 URL 因版本更新而失效。這不僅影響外部主機的自動讀取，還可能造成維護麻煩。幸運的是，GitHub Gist 提供了一個簡單的解決方案：它支援版本控制，讓你輕鬆管理檔案變更，同時生成穩定的 Raw URL，適合大量外部系統存取。

Gist 的優勢

  • 版本控制：自動記錄每次編輯歷史，方便回溯。
  • 公開分享：無需完整 GitHub 帳號，即可快速建立。
  • 穩定 URL：Raw 連結不易因更新而變更，確保可靠存取。
  • 輕量級：適合小檔案，不需完整專案。

如何建立並使用 Gist

  1. 前往 https://gist.github.com，登入 GitHub 帳號。
  2. 右上角 + (Create new gist)
  3. 填寫 Filename Exp. example.conf
  4. 上傳檔案或直接輸入內容
  5. 點擊「Create secret gist」建立

範例

生成穩定 Raw URL 的關鍵技巧

  • 原始 Raw URL 會包含版本相關的雜湊碼（如 /4213cd6c…），更新 Gist 後會改變。為了讓 URL 永久穩定，只需移除版本部分，保留檔案名稱即可：
    • 原始 URL（不穩定）： 
      https://gist.githubusercontent.com/tryweb/bf745d68c55f581370977edac9c2a1d4/raw/4213cd6c885e10d1539f748653e53206f2e9201d/example.conf
    • 移除版本 URL（穩定）： 
      https://gist.githubusercontent.com/tryweb/bf745d68c55f581370977edac9c2a1d4/raw/example.conf
  • 這樣，即使你更新 Gist 內容，URL 仍指向最新版本
  • tech/gist.txt
  • 上一次變更: 2025/10/09 17:15
  • 由 jonathan