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!
自架 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- 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
授權
本專案採用 MIT LICENSE。
Author
Just open an issue to share an idea.
©️ 2025 邱敬幃 Pardn Chiu