pardnchiu/go-image-server

最後更新

Note此 README 由 SKILL 生成,英文版請參閱 這裡。

Warning已於 2026-10-30 封存。 go-image-server 不再維護;原始碼與 docker compose up -d 部署設定仍可使用,但不再發布新功能、錯誤修正或安全性更新,也不再受理 issue 與 pull request。



RESIZE ONCE, CACHE EVERYWHERE!


License




自架 Go 圖片快取伺服器,具備 libvips 即時縮圖、WebP/AVIF 轉檔與四層 CDN 快取

目錄



功能特點


docker compose up -d · 完整文件

  • 四層快取鏈 — 瀏覽器、Cloudflare Worker、Nginx proxy_cache 與本地參數化快取檔逐層攔截,同一張圖只需由 libvips 處理一次。
  • URL 參數即時轉檔 — 以 query string 指定尺寸、品質、高斯模糊、亮度與輸出格式(AVIF/WebP/JPG/PNG),不需預先產生縮圖。
  • 預設 WebP 瘦身 — 未指定參數時自動輸出 WebP,且短邊超過 1024 px 的原圖會將長邊縮至 1024 px,大幅降低傳輸量。
  • 日期分類回收桶 — DELETE 不會真的刪檔,而是移入 .trash/YYYY-MM-DD/,並回傳回收位置供日後還原。
  • 自適應串流輸出 — 依檔案大小動態選擇 2–16 KiB chunk buffer 以 chunked 傳輸回應,兼顧小圖延遲與大檔吞吐。

架構


完整架構

graph TB
    Client[客戶端] --> Browser[瀏覽器快取 7 天]
    Browser --> Worker[Cloudflare Worker 7 天]
    Browser --> Nginx[Nginx proxy_cache 7 天]
    Worker --> Nginx
    Nginx --> Gin[Gin 路由]
    Gin --> Get[GET 轉檔處理]
    Gin --> Post[POST 上傳]
    Gin --> Del[DELETE 移入回收桶]
    Get --> Vips[libvips]
    Get --> Storage[(storage/image<br>upload / cache / .trash)]
    Post --> Storage
    Del --> Storage
  1. graph TB
  2. Client[客戶端] --> Browser[瀏覽器快取 7 天]
  3. Browser --> Worker[Cloudflare Worker 7 天]
  4. Browser --> Nginx[Nginx proxy_cache 7 天]
  5. Worker --> Nginx
  6. Nginx --> Gin[Gin 路由]
  7. Gin --> Get[GET 轉檔處理]
  8. Gin --> Post[POST 上傳]
  9. Gin --> Del[DELETE 移入回收桶]
  10. Get --> Vips[libvips]
  11. Get --> Storage[(storage/image<br>upload / cache / .trash)]
  12. Post --> Storage
  13. Del --> Storage

授權


本專案採用 MIT LICENSE。

Author


Just open an issue to share an idea.
go-image-server contributors


©️ 2025 邱敬幃 Pardn Chiu
EN