# 設定

本頁列出 Go 服務讀取的環境變數、儲存目錄結構與 Docker Compose 預設值。

## 環境變數

| 變數 | 預設值 | 讀取處 | 說明 |
|---|---|---|---|
| `GO_ENV` | — | `configs.ModeDev()` | `development` 時視為開發模式 |
| `PORT` | `8080` | `configs.GetPort()` | Go 服務監聽埠 |
| `DOMAIN` | — | `configs.GetDomain()` | 非開發模式下，上傳回應 `src` 使用 `https://{DOMAIN}` |

`GetDomain()` 只影響上傳回應中的 `src`，不影響路由或快取。

## Docker Compose 預設值

`docker-compose.yaml` 為 `golang` 服務設定 `GO_ENV: development` 與 `DOMAIN: "joball.tw"`。因為 `GO_ENV` 為 `development`，`DOMAIN` 實際不會生效，上傳回應的 `src` 會是 `http://localhost:8080/...`。正式環境應移除 `GO_ENV` 並把 `DOMAIN` 改為實際對外網域。

## 儲存目錄

所有路徑以工作目錄（`os.Getwd()`）為根：

| 路徑 | 函式 | 用途 |
|---|---|---|
| `storage/image/upload/` | `GetUploadPath()` | 原始上傳檔 |
| `storage/image/cache/` | `GetCachePath()` | 轉檔快取，結構對應 `upload/` |
| `storage/image/upload/.trash/` | `GetTrashPath()` | 回收桶，依日期分資料夾 |
| `internal/assets/image/404-{light,dark}.svg` | `Get404SVG()` | 讀圖失敗時的佔位圖 |

Docker Compose 把主機的 `./image` 掛載到容器的 `storage/image`，備份或搬遷時只需處理這個目錄。