架構

最後更新


本頁以一張概覽圖說明 go-image-server 從邊緣快取到 Go 服務、libvips 與檔案儲存的層級關係。

系統概覽


graph TB
    Client[客戶端] --> Browser[瀏覽器快取]
    Browser --> Worker[Cloudflare Worker]
    Browser --> Nginx[Nginx proxy_cache]
    Worker --> Nginx
    Nginx --> Gin[Gin 路由 routes]
    Gin --> Get[GetFromPath]
    Gin --> Post[PostToPath]
    Gin --> Del[DeleteFromPath]
    Get --> Vips[libvips govips]
    Get --> Cache[(storage/image/cache)]
    Get --> Upload[(storage/image/upload)]
    Post --> Upload
    Del --> Trash[(upload/.trash/YYYY-MM-DD)]
  1. graph TB
  2. Client[客戶端] --> Browser[瀏覽器快取]
  3. Browser --> Worker[Cloudflare Worker]
  4. Browser --> Nginx[Nginx proxy_cache]
  5. Worker --> Nginx
  6. Nginx --> Gin[Gin 路由 routes]
  7. Gin --> Get[GetFromPath]
  8. Gin --> Post[PostToPath]
  9. Gin --> Del[DeleteFromPath]
  10. Get --> Vips[libvips govips]
  11. Get --> Cache[(storage/image/cache)]
  12. Get --> Upload[(storage/image/upload)]
  13. Post --> Upload
  14. Del --> Trash[(upload/.trash/YYYY-MM-DD)]

分層


層位置職責
邊緣worker/index.js依完整 URL(含 query)快取圖片 7 天
反向代理config/nginx/nodes.conf/c/img/ 快取、上傳與刪除路由轉發、安全標頭
路由app/internal/routes/SetGET/SetPOST/SetDELETE 註冊端點,Set404 處理未知路徑
處理器app/internal/handlers/讀取轉檔、上傳、移入回收桶
設定app/internal/configs/config.go環境變數與儲存路徑
工具app/internal/utils/query 別名解析、錯誤回應

跨切原則


原則實作
每個請求 30 秒上限三個處理器皆以 context.WithTimeout 包住 goroutine,逾時回 408 timed out
參數即快取 key本地快取檔名直接串接尺寸、品質、模糊、亮度與格式參數
刪除即搬移刪除一律 os.Rename 至依日期分桶的 .trash
串流輸出圖片以 chunked 傳輸,buffer 依檔案大小調整

延伸閱讀


EN