> [!NOTE]
> 此 README 由 [SKILL](https://github.com/agenvoy/skill-readme-generate) 生成，英文版請參閱 [這裡](https://github.com/pardnio/go-image-server/blob/master/README.md)。

***

<p align="center">
<strong>RESIZE ONCE, CACHE EVERYWHERE!</strong>
</p>

<p align="center">
<a href="https://github.com/pardnchiu/go-image-server/releases"><img src="https://img.shields.io/github/v/tag/pardnchiu/go-image-server?include_prereleases&style=for-the-badge" alt="Release"></a>
<a href="https://github.com/pardnio/go-image-server/blob/master/LICENSE"><img src="https://img.shields.io/github/license/pardnchiu/go-image-server?include_prereleases&style=for-the-badge" alt="License"></a>
</p>

***

> Go 圖片快取伺服器，具備 libvips 即時轉檔、四層快取鏈與依日期分類的軟刪除回收桶

## 目錄

- [功能特點](#功能特點)
- [架構](#架構)
- [授權](#授權)
- [Author](#author)

## 功能特點

> `docker compose up -d` · [完整文件](https://github.com/pardnio/go-image-server/blob/master/doc/doc.zh.md)

- **四層快取鏈** — 瀏覽器、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 傳輸回應，兼顧小圖延遲與大檔吞吐。

## 架構

> [完整架構](https://github.com/pardnio/go-image-server/blob/master/doc/architecture.zh.md)

```mermaid
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](https://github.com/pardnio/go-image-server/blob/master/LICENSE)。

## Author

Just [open an issue](https://github.com/pardnchiu/go-image-server/issues/new) to share an idea.

<a href="https://github.com/pardnchiu/go-image-server/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=pardnchiu/go-image-server&cache_bust=2026-10-04" alt="go-image-server contributors" />
</a>

***

©️ 2025 [邱敬幃 Pardn Chiu](https://www.linkedin.com/in/pardnchiu)