跳轉到內容

第一個容器:部署 pgAdmin 4

本文以 pgAdmin 4 為例,示範如何透過 AcePanel 快速部署 Docker 容器。

安裝 Docker

前往「應用程式」頁面,在「原生應用程式」分頁中找到 Docker 並安裝。 安裝進度可在「任務」->「面板任務」中檢視。

中國大陸的伺服器

在中國大陸的伺服器上拉取映像檔速度緩慢。 建議設定 Millisecond Mirror 提供的付費加速來源。

部署容器

前往「應用程式」->「容器範本」,找到 pgAdmin 4,然後點選「部署」。 部署是一個四步驟精靈:部署模式、設定、預覽與編輯、確認。

容器範本清單

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

在「部署模式」步驟中,選擇「建立新 Compose」(另一個選項「更新現有 Compose」則是將範本套用至既有的 Compose)。

部署步驟 1

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

部署步驟 2

  • 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」頁面手動管理:

Compose 清單

存取服務

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