convertor/docs/環境變數總覽.md

環境變數設定

📦 本文件已遷移至新位置，請參閱：docs/config/environment.md

---

快速參考

完整說明請參考 環境變數完整說明。

優先級	變數	說明
必填	JWT_SECRET	登入驗證金鑰
建議	TZ	時區設定
建議	HTTP_ALLOWED	是否允許 HTTP
可選	TRUST_PROXY	信任反向代理

---

相關文件

• 環境變數完整說明
• 安全性設定
• Docker 部署指南

---

🎨 介面設定

WEBROOT

項目	說明
預設值	(空)
用途	子路徑部署，例如 /convertx

若透過子路徑存取（如 https://example.com/convertx/）：

- WEBROOT=/convertx

HIDE_HISTORY

項目	說明
預設值	false
用途	隱藏歷史紀錄頁面

LANGUAGE

項目	說明
預設值	en
用途	日期格式語言（BCP 47 格式）

影響介面上的日期顯示格式（如 2026/01/20 vs 01/20/2026）。

---

⚙️ 轉換設定

MAX_CONVERT_PROCESS

項目	說明
預設值	0
用途	最大同時轉換數（0 = 無限制）

限制同時進行的轉換任務數量，避免伺服器過載。

FFMPEG_ARGS

項目	說明
預設值	(空)
用途	FFmpeg 輸入參數，用於硬體加速等

硬體加速範例：

# NVIDIA GPU
- FFMPEG_ARGS=-hwaccel cuda

# Intel QSV
- FFMPEG_ARGS=-hwaccel qsv

# AMD VAAPI
- FFMPEG_ARGS=-hwaccel vaapi

FFMPEG_OUTPUT_ARGS

項目	說明
預設值	(空)
用途	FFmpeg 輸出參數

# 使用較快的編碼預設
- FFMPEG_OUTPUT_ARGS=-preset veryfast

---

🔧 進階設定

UNAUTHENTICATED_USER_SHARING

項目	說明
預設值	false
用途	未登入使用者是否共享檔案空間

設為 true 時，所有匿名使用者會看到相同的檔案。

---

情境範例

開發環境

environment:
  - HTTP_ALLOWED=true
  - ACCOUNT_REGISTRATION=true
  - TZ=Asia/Taipei

生產環境

environment:
  - JWT_SECRET=your-very-long-and-random-secret-key-change-me
  - ACCOUNT_REGISTRATION=false
  - HTTP_ALLOWED=false
  - TRUST_PROXY=true
  - TZ=Asia/Taipei
  - AUTO_DELETE_EVERY_N_HOURS=24

公開服務（允許匿名使用）

environment:
  - ALLOW_UNAUTHENTICATED=true
  - HIDE_HISTORY=true
  - AUTO_DELETE_EVERY_N_HOURS=1

---

相關文件

• Docker 部署指南
• Docker Compose 範例
• 常見問題

帶硬體加速

environment:
  - JWT_SECRET=your-secret-key
  - FFMPEG_ARGS=-hwaccel cuda
  - FFMPEG_OUTPUT_ARGS=-c:v h264_nvenc -preset fast