d563682753
✨ Features: - 全頁拖曳上傳：檔案可拖曳到頁面任何位置 - Setup 頁面新增語言選擇器 🐛 Bug Fixes: - 語言 icon 尺寸修復（h-5→h-6） - Dropdown 背景完全不透明 - 新增 scrollbar 樣式 🌍 i18n: - 所有 confirm/alert 訊息國際化 - Setup 頁面 i18n 完整化 📚 Documentation: - README 精簡為開箱即用版本 - 新增 docs/deployment/, docs/config/, docs/versions/
166 lines
3.4 KiB
Markdown
166 lines
3.4 KiB
Markdown
# 環境變數設定
|
||
|
||
> 📦 本文件已遷移至新位置，請參閱：[docs/config/environment.md](config/environment.md)
|
||
|
||
---
|
||
|
||
## 快速參考
|
||
|
||
完整說明請參考 [環境變數完整說明](config/environment.md)。
|
||
|
||
| 優先級 | 變數 | 說明 |
|
||
| ------ | -------------- | ------------- |
|
||
| 必填 | `JWT_SECRET` | 登入驗證金鑰 |
|
||
| 建議 | `TZ` | 時區設定 |
|
||
| 建議 | `HTTP_ALLOWED` | 是否允許 HTTP |
|
||
| 可選 | `TRUST_PROXY` | 信任反向代理 |
|
||
|
||
---
|
||
|
||
## 相關文件
|
||
|
||
- [環境變數完整說明](config/environment.md)
|
||
- [安全性設定](config/security.md)
|
||
- [進階部署指南](deployment.md)
|
||
|
||
---
|
||
|
||
## 🎨 介面設定
|
||
|
||
### WEBROOT
|
||
|
||
| 項目 | 說明 |
|
||
| ------ | ---------------------------- |
|
||
| 預設值 | (空) |
|
||
| 用途 | 子路徑部署，例如 `/convertx` |
|
||
|
||
若透過子路徑存取（如 `https://example.com/convertx/`）：
|
||
|
||
```yaml
|
||
- WEBROOT=/convertx
|
||
```
|
||
|
||
### HIDE_HISTORY
|
||
|
||
| 項目 | 說明 |
|
||
| ------ | ---------------- |
|
||
| 預設值 | `false` |
|
||
| 用途 | 隱藏歷史紀錄頁面 |
|
||
|
||
### LANGUAGE
|
||
|
||
| 項目 | 說明 |
|
||
| ------ | --------------------------- |
|
||
| 預設值 | `en` |
|
||
| 用途 | 日期格式語言（BCP 47 格式） |
|
||
|
||
影響介面上的日期顯示格式（如 2026/01/20 vs 01/20/2026）。
|
||
|
||
---
|
||
|
||
## ⚙️ 轉換設定
|
||
|
||
### MAX_CONVERT_PROCESS
|
||
|
||
| 項目 | 說明 |
|
||
| ------ | ---------------------------- |
|
||
| 預設值 | `0` |
|
||
| 用途 | 最大同時轉換數（0 = 無限制） |
|
||
|
||
限制同時進行的轉換任務數量，避免伺服器過載。
|
||
|
||
### FFMPEG_ARGS
|
||
|
||
| 項目 | 說明 |
|
||
| ------ | ------------------------------- |
|
||
| 預設值 | (空) |
|
||
| 用途 | FFmpeg 輸入參數，用於硬體加速等 |
|
||
|
||
**硬體加速範例**：
|
||
|
||
```yaml
|
||
# NVIDIA GPU
|
||
- FFMPEG_ARGS=-hwaccel cuda
|
||
|
||
# Intel QSV
|
||
- FFMPEG_ARGS=-hwaccel qsv
|
||
|
||
# AMD VAAPI
|
||
- FFMPEG_ARGS=-hwaccel vaapi
|
||
```
|
||
|
||
### FFMPEG_OUTPUT_ARGS
|
||
|
||
| 項目 | 說明 |
|
||
| ------ | --------------- |
|
||
| 預設值 | (空) |
|
||
| 用途 | FFmpeg 輸出參數 |
|
||
|
||
```yaml
|
||
# 使用較快的編碼預設
|
||
- FFMPEG_OUTPUT_ARGS=-preset veryfast
|
||
```
|
||
|
||
---
|
||
|
||
## 🔧 進階設定
|
||
|
||
### UNAUTHENTICATED_USER_SHARING
|
||
|
||
| 項目 | 說明 |
|
||
| ------ | ---------------------------- |
|
||
| 預設值 | `false` |
|
||
| 用途 | 未登入使用者是否共享檔案空間 |
|
||
|
||
設為 `true` 時，所有匿名使用者會看到相同的檔案。
|
||
|
||
---
|
||
|
||
## 情境範例
|
||
|
||
### 開發環境
|
||
|
||
```yaml
|
||
environment:
|
||
- HTTP_ALLOWED=true
|
||
- ACCOUNT_REGISTRATION=true
|
||
- TZ=Asia/Taipei
|
||
```
|
||
|
||
### 生產環境
|
||
|
||
```yaml
|
||
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
|
||
```
|
||
|
||
### 公開服務（允許匿名使用）
|
||
|
||
```yaml
|
||
environment:
|
||
- ALLOW_UNAUTHENTICATED=true
|
||
- HIDE_HISTORY=true
|
||
- AUTO_DELETE_EVERY_N_HOURS=1
|
||
```
|
||
|
||
---
|
||
|
||
## 相關文件
|
||
|
||
- [進階部署指南](deployment.md)
|
||
- [Docker Compose 範例](docker-compose/)
|
||
- [常見問題](faq.md)
|
||
|
||
### 帶硬體加速
|
||
|
||
```yaml
|
||
environment:
|
||
- JWT_SECRET=your-secret-key
|
||
- FFMPEG_ARGS=-hwaccel cuda
|
||
- FFMPEG_OUTPUT_ARGS=-c:v h264_nvenc -preset fast
|
||
```
|