第一個容器:部署 pgAdmin 4
本文以 pgAdmin 4 為例,示範如何透過 AcePanel 快速部署 Docker 容器。
安裝 Docker
前往「應用程式」頁面,在「原生應用程式」分頁中找到 Docker 並安裝。 安裝進度可在「任務」->「面板任務」中檢視。
中國大陸的伺服器
在中國大陸的伺服器上拉取映像檔速度緩慢。 建議設定 Millisecond Mirror 提供的付費加速來源。
部署容器
前往「應用程式」->「容器範本」,找到 pgAdmin 4,然後點選「部署」。 部署是一個四步驟精靈:部署模式、設定、預覽與編輯、確認。

在範本清單中,您可以透過頂部的分類標籤或右側的搜尋框來縮小選擇範圍。 每個範本卡片都會顯示其圖示、名稱與說明;「本機」標籤用於標示儲存在本伺服器上的範本(而非從遠端範本儲存庫取得),而有定義首頁的範本會顯示一個外部連結按鈕,點選即可開啟專案網站。
在「部署模式」步驟中,選擇「建立新 Compose」(另一個選項「更新現有 Compose」則是將範本套用至既有的 Compose)。

在「設定」步驟中,填寫設定:

- Compose 名稱:為 compose 取一個名稱,例如
pg4admin - 自動啟動:勾選後,於建立完成後自動拉取映像檔並啟動
- 自動防火牆:勾選後,自動放行 compose 中定義的連接埠
- 存取連接埠:將容器的 80 連接埠對應至主機連接埠,例如
999 - 管理員信箱/密碼:pgAdmin 4 的登入憑證
「環境變數」分隔線下方的欄位(存取連接埠、管理員信箱、管理員密碼等) 來自範本的環境變數,並因範本而異。 每個變數都會算繪為符合其宣告類型的輸入欄位:
| 類型 | 顯示的輸入欄位 | 備註 |
|---|---|---|
text | 純文字輸入欄位 | 預設類型 |
password | 密碼輸入欄位(點選可顯示) | 用於管理員密碼等機密資訊 |
number | 數字輸入欄位 | 僅限數字 |
port | 限制為 1-65535 的數字輸入欄位 | 用於存取連接埠等主機連接埠對應 |
url | 文字輸入欄位 | 會驗證是否為格式正確的 URL |
select | 下拉式選單 | 從範本提供的選項中選擇 |
凡範本未定義預設值的欄位皆為必填,必須填寫後才能繼續;具有預設值的欄位可留空以保留該預設值。
點選「下一步」進入「預覽與編輯」步驟。 此步驟有兩個分頁:
- Compose 檔案:顯示最終
docker-compose.yml的 YAML 編輯器。 您可以在部署前手動微調。 - 環境變數:列出將要寫入的每個變數的鍵/值編輯器。 您可以在此新增、編輯或移除項目。
再次點選「下一步」即可進入「確認」步驟。 它會顯示您所選內容的摘要(部署模式、Compose 名稱、自動啟動、自動防火牆以及環境變數數量),以及一個可摺疊的唯讀最終 compose 內容預覽。 點選「建立」以確認。
更新現有 Compose
在第一個步驟中,您也可以改為選擇「更新現有 Compose」,將範本套用至伺服器上既有的 compose。 流程同樣是這四個步驟,但有幾處差異:
- 在「設定」步驟中,您會從可搜尋的下拉式選單中挑選目標 compose,而非輸入新名稱。 接著表單會預先填入該 compose 既有的環境變數值,因此您只需調整有變動的部分。
- 「預覽與編輯」步驟會顯示差異編輯器:左側是原始 compose,右側是新的 compose(可供編輯),讓您能清楚看出範本將要變更的內容。
- 「確認」按鈕會顯示「更新」而非「建立」,且此模式下不會顯示自動防火牆選項。
等待啟動
若勾選「自動啟動」,建立完成後會彈出一個終端機視窗並執行 docker compose ... up -d,即時串流映像檔拉取與啟動進度:

若您未勾選「自動啟動」,則尚未拉取任何映像檔。 前往「容器」->「Compose」頁面,並在該處啟動 compose。
您也可以在「容器」->「Compose」頁面手動管理:

存取服務
啟動完成後,在瀏覽器中存取 http://ServerIP:Port(例如 http://x.x.x.x:999),並使用先前設定的信箱與密碼登入。
