容器範本
容器範本提供以 Docker 為基礎的一鍵部署方案，可快速部署各種常見的應用程式，無需手動設定。
事前準備
使用容器範本前，您需要先安裝 Docker：
- 前往 應用程式 > 原生應用程式
- 找到 Docker，點選 安裝
- 等待安裝完成
範本清單
前往 應用程式 頁面，點選 容器範本 分頁以檢視可用的範本：
您可以依分類標籤篩選範本，或依名稱、描述、網址進行搜尋。 從本機 panel/storage/templates 目錄載入的範本會顯示 本機 標籤。 若本機範本與遠端範本的 slug 相同，則以本機範本為準。
部署應用程式
點選範本卡片上的 部署 按鈕，即可啟動部署精靈。
步驟 1：選擇部署模式
- 建立新的 Compose：以範本建立一個新的 Docker Compose
- 更新現有 Compose：使用範本更新現有的 compose 設定
步驟 2：設定參數
依應用程式需求填寫設定資訊：
常見的設定項目：
- Compose 名稱：用於識別這次部署（僅限建立模式；更新模式下改為選擇一個現有的 compose）
- 自動啟動：是否在建立後自動啟動容器
- 自動放行防火牆：是否自動放行 compose 檔案中定義的連接埠（僅限建立模式）。 面板會掃描 compose 的
ports:項目（例如"8080:80"、"8080:80/tcp"或"80/udp"等格式），並依對應的通訊協定為入站流量放行每個主機端的連接埠（預設為 TCP，指定/udp時為 UDP）。 僅處理 1–65535 範圍內的連接埠。 - 環境變數：每個範本都定義了自己的變數（例如資料庫使用者名稱、密碼與監聽連接埠）。 沒有預設值的變數為必填項目。
每個環境變數都會依其宣告的類型轉譯為對應的輸入控制項：
| 類型 | 控制項 |
|---|---|
text | 單行文字輸入框（未指定類型時的預設值） |
password | 具有顯示/隱藏切換的密碼輸入框 |
number | 數字輸入框 |
port | 限制在 1–65535 範圍內的數字輸入框 |
select | 依變數預先定義的選項建立的下拉式選單 |
url | 以 URL 進行驗證的文字輸入框（非有效 URL 的值會被拒絕） |
在更新模式下，當您選擇一個現有的 compose 後，會載入其目前的 .env 值，並用來預先填入名稱與範本所宣告變數相符的環境變數欄位。 number 與 port 欄位的值會自動轉換為數字。
步驟 3：預覽與編輯
預覽產生的 Docker Compose 設定檔：
在這裡您可以：
- 檢視並編輯 Compose 檔案（docker-compose.yml）。 在更新模式下這是一個差異編輯器：左側顯示原始的 compose，右側顯示新的 compose，您可以對其進行編輯。
- 檢視並編輯 環境變數
步驟 4：確認部署
此步驟會顯示您所做選擇的摘要：部署模式、compose 名稱、是否啟用自動啟動、是否啟用自動放行防火牆（僅限建立模式），以及環境變數的數量。 您可以展開 Compose 內容，再次檢視最終的唯讀 compose。
確認所有設定無誤後，點選 建立（更新模式下為 更新）以完成部署：
在建立模式下，面板會將部署寫入 <root>/compose/<name>/，並同時產生一個 docker-compose.yml 以及一個依您的環境變數建立的 .env 檔案。 之後您可以在 容器 > Compose 頁面編輯這兩個檔案中的任一個。
若已啟用 自動啟動，會開啟一個終端機視窗並執行 docker compose -f <dir>/docker-compose.yml up -d 來啟動容器；您可以即時觀看啟動的輸出內容。
部署完成後，該應用程式會出現在 容器 > Compose 頁面中供您管理。
範本部署與手動部署的比較
| 功能 | 使用範本 | 手動部署 |
|---|---|---|
| 設定難度 | 簡單，只需填寫基本資訊 | 需自行撰寫 docker-compose.yml |
| 彈性 | 使用預設設定 | 可完全自訂 |
| 適用情境 | 快速部署常見應用程式 | 特殊需求、自訂設定 |
常見範本說明
WordPress
開放原始碼的部落格與內容管理系統，適合用來架設個人部落格或企業網站。
pgAdmin 4
PostgreSQL 資料庫的圖形化管理工具。
phpMyAdmin
MySQL/MariaDB 資料庫的圖形化管理工具。
Vaultwarden
輕量級的密碼管理伺服器，相容於 Bitwarden 用戶端。
Qinglong
排程任務管理平台，支援 Python、JavaScript、Shell 等腳本。
OpenList
多儲存空間彙整的檔案清單程式，支援阿里雲端硬碟、OneDrive 等。
更新快取
若範本清單不完整，或您需要取得最新的範本，請點選頁面頂端的 更新快取 按鈕來重新整理範本清單。