Refactor Docker Compose examples and documentation
- Updated README.md to include new example files for minimal and production configurations with detailed instructions. - Added compose.production-alt.example.yml for an annotated production setup. - Introduced new example files: compose.minimal.example.yml, compose.production.example.yml, nginx.example.conf, and traefik.example.yml for better clarity and usability. - Removed outdated configuration files and consolidated documentation for OCR language support. - Adjusted Nginx and Traefik configurations to reflect best practices and added necessary comments for user guidance. - Minor formatting and consistency improvements across documentation files.
This commit is contained in:
parent
f6b45627e0
commit
8a84caa503
14 changed files with 175 additions and 821 deletions
|
|
@ -4,45 +4,68 @@
|
|||
|
||||
## 範例檔案
|
||||
|
||||
| 檔案 | 適用情境 | 說明 |
|
||||
| ------------------------------------------------ | ----------- | --------------------- |
|
||||
| [compose.minimal.yml](compose.minimal.yml) | Docker 老手 | 最精簡的可用配置 |
|
||||
| [compose.production.yml](compose.production.yml) | 生產環境 | 含 Reverse Proxy 設定 |
|
||||
| [compose.reference.yml](compose.reference.yml) | 參考文件 | 所有設定的完整參考 |
|
||||
| 檔案 | 適用情境 | 說明 |
|
||||
| ------------------------------------------------------------------------ | ----------- | --------------------- |
|
||||
| [compose.minimal.yml](compose.minimal.yml) | Docker 老手 | 最精簡的可用配置 |
|
||||
| [compose.production.yml](compose.production.yml) | 生產環境 | 含 Reverse Proxy 設定 |
|
||||
| [compose.production-alt.example.yml](compose.production-alt.example.yml) | 生產環境 | 詳細註解版本 |
|
||||
| [compose.reference.yml](compose.reference.yml) | 參考文件 | 所有設定的完整參考 |
|
||||
| [compose.ocr-languages.yml](compose.ocr-languages.yml) | OCR 擴展 | 安裝額外 OCR 語言包 |
|
||||
| [OCR語言擴展.md](OCR語言擴展.md) | 詳細指南 | OCR 語言擴展完整說明 |
|
||||
|
||||
## 快速選擇
|
||||
|
||||
| 你是... | 使用 |
|
||||
| ------------ | ----------------------------- |
|
||||
| 新手 | [README 主頁](../說明文件.md) |
|
||||
| Docker 熟手 | compose.minimal.yml |
|
||||
| 生產環境 | compose.production.yml |
|
||||
| 查詢所有選項 | compose.reference.yml |
|
||||
| 你是... | 使用 |
|
||||
| ----------------- | -------------------------------------------- |
|
||||
| 新手 | [README 主頁](../說明文件.md) |
|
||||
| Docker 熟手 | compose.minimal.yml |
|
||||
| 生產環境 | compose.production.yml |
|
||||
| 查詢所有選項 | compose.reference.yml |
|
||||
| 需要更多 OCR 語言 | [OCR語言擴展.md](OCR語言擴展.md)(詳細指南) |
|
||||
|
||||
## 如何使用
|
||||
## 快速開始
|
||||
|
||||
### 最小配置
|
||||
|
||||
```bash
|
||||
# 下載範例
|
||||
curl -O https://raw.githubusercontent.com/pi-docket/ConvertX-CN/main/docs/docker-compose/compose.minimal.yml
|
||||
# 1. 複製範例
|
||||
cp compose.minimal.yml docker-compose.yml
|
||||
|
||||
# 重命名
|
||||
mv compose.minimal.yml docker-compose.yml
|
||||
|
||||
# 建立 data 資料夾
|
||||
# 2. 建立資料夾
|
||||
mkdir -p data
|
||||
|
||||
# 修改 JWT_SECRET
|
||||
nano docker-compose.yml
|
||||
# 3. 修改以下欄位:
|
||||
# - JWT_SECRET(至少 32 字元隨機字串)
|
||||
|
||||
# 啟動
|
||||
# 4. 啟動
|
||||
docker compose up -d
|
||||
```
|
||||
|
||||
### 生產環境
|
||||
|
||||
```bash
|
||||
# 1. 複製範例
|
||||
cp compose.production.yml docker-compose.yml
|
||||
|
||||
# 2. 建立資料夾
|
||||
mkdir -p data
|
||||
|
||||
# 3. 修改以下欄位:
|
||||
# - JWT_SECRET(至少 32 字元隨機字串)
|
||||
|
||||
# 4. 啟動
|
||||
docker compose up -d
|
||||
```
|
||||
|
||||
> 💡 產生隨機 JWT_SECRET:`openssl rand -hex 32`
|
||||
|
||||
## 相關文件
|
||||
|
||||
- [Docker Compose 詳解](../部署指南/Docker組合.md)
|
||||
- [環境變數說明](../配置設定/環境變數.md)
|
||||
- [版本選擇指南](../版本/)
|
||||
- [Docker 部署指南](../部署指南/Docker部署.md)
|
||||
- [反向代理設定](../部署指南/反向代理.md)
|
||||
|
||||
### 我要部署到正式環境
|
||||
|
||||
|
|
@ -56,8 +79,16 @@ docker compose up -d
|
|||
|
||||
參考 [compose.reference.yml](compose.reference.yml),包含所有環境變數的說明。
|
||||
|
||||
## 相關文件
|
||||
### 我需要更多 OCR 語言支援
|
||||
|
||||
- [環境變數完整說明](../配置設定/環境變數.md)
|
||||
- [Docker 部署指南](../部署指南/Docker部署.md)
|
||||
- [反向代理設定](../部署指南/反向代理.md)
|
||||
參考 [OCR語言擴展.md](OCR語言擴展.md),這是完整的 OCR 語言擴展指南,包含:
|
||||
|
||||
- 三種擴展方法的詳細說明與比較
|
||||
- 完整的 compose.yaml 範例配置
|
||||
- 50+ 種可用語言包列表
|
||||
- 語言包下載與驗證方法
|
||||
- 常見問題解答
|
||||
|
||||
> 💡 內建 OCR 語言:英文、繁體中文、簡體中文、日文、韓文、德文、法文
|
||||
>
|
||||
> 翻譯引擎支援 15 種語言,但 OCR 預設只內建 8 種
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue