跳轉到內容

伺服器管理

伺服器管理頁面用於管理資料庫伺服器連線,同時支援本機與遠端資料庫伺服器。 支援的資料庫類型有 MySQL、PostgreSQL、ClickHouse、MongoDB、SQLite、Elasticsearch 與 Redis。

伺服器清單

前往 資料庫 > 伺服器 分頁即可檢視伺服器清單。

伺服器清單

清單會顯示以下資訊:

  • 名稱:伺服器名稱
  • 使用者名稱:管理員使用者名稱(未設定時顯示 None)
  • 密碼:管理員密碼(預設隱藏,附有複製按鈕)
  • 主機:伺服器位址與連接埠
  • 備註:備註(可內嵌編輯)
  • 狀態:連線狀態(有效/無效)
  • 更新日期:最後更新時間
  • 操作:終端機、同步、修改、刪除

本機伺服器

安裝對應的資料庫軟體後,AcePanel 會自動新增內建的本機伺服器。 這些伺服器無法直接刪除;如需移除,請解除安裝對應的應用程式:

  • local_mysql:本機 Percona/MySQL/MariaDB 伺服器
  • local_postgresql:本機 PostgreSQL 伺服器
  • local_redis:本機 Redis 伺服器
  • local_valkey:本機 Valkey 伺服器
  • local_clickhouse:本機 ClickHouse 伺服器
  • local_mongodb:本機 MongoDB 伺服器
  • local_elasticsearch:本機 Elasticsearch 伺服器
  • local_opensearch:本機 OpenSearch 伺服器

新增遠端伺服器

  1. 點選 新增伺服器 按鈕
  2. 填寫設定:
    • 類型:選擇資料庫類型(MySQL/PostgreSQL/ClickHouse/MongoDB/SQLite/Elasticsearch/Redis)。 從特定類型的分頁開啟對話方塊時,此選擇器會被隱藏。
    • 名稱:伺服器名稱(用於識別,僅允許字母、數字、-_
    • 主機:伺服器位址。 對於 SQLite,此處會變為檔案路徑欄位,用於選擇資料庫檔案。
    • 連接埠:資料庫連接埠
    • 使用者名稱:管理員使用者名稱(Redis 與 SQLite 不顯示)
    • 密碼:管理員密碼(SQLite 不顯示)
    • 備註:備註
  3. 點選提交

遠端伺服器使用情境

  • 連線至雲端資料庫(例如阿里雲 RDS、騰訊雲 CDB)
  • 連線至容器中的資料庫服務
  • 連線至其他伺服器上的資料庫
  • 資料庫讀寫分離架構

伺服器操作

終端機

點選 終端機 按鈕即可開啟資料庫命令列終端機,您可以在其中直接執行 SQL 陳述式。 終端機會為所選的伺服器類型啟動原生用戶端,並自動傳入面板中儲存的連線參數(主機、連接埠、使用者名稱與密碼):

類型啟動的用戶端說明
MySQLmysql使用設定的使用者名稱、密碼、主機與連接埠進行連線。
PostgreSQLpsql設定了密碼時使用 PGPASSWORD;未設定密碼時則回退至 su - postgres -c 'psql'
Redisredis-cli僅在設定了密碼時才加入 -a 密碼旗標。
ClickHouseclickhouse-client一律連線原生 TCP 連接埠 9000,而非下方連接埠表格中顯示的 HTTP 連接埠 8123
MongoDBmongosh透過 mongodb:// URI 連線至 admin 資料庫。
SQLitesqlite3使用設定的檔案路徑直接開啟資料庫檔案。
Elasticsearchcurl執行 curl .../_cat/indices?v 列出索引;這是一個唯讀的 HTTP 請求,而非互動式 shell。

同步

點選 同步 按鈕可將資料庫使用者(不含其密碼)同步至面板。 當使用者直接在資料庫中建立時,可以使用此功能將其同步至面板。

TIP

同步功能適用於 MySQL、PostgreSQL 與 ClickHouse 伺服器。 它不會為 Redis、MongoDB、SQLite 與 Elasticsearch 顯示,因為這些資料庫不支援面板使用者管理。

修改

點選 修改 按鈕即可修改伺服器連線資訊,例如密碼、主機位址等。

刪除

點選 刪除 按鈕即可刪除伺服器設定。 刪除生效前需要 5 秒的確認倒數計時。

注意

刪除伺服器設定並不會刪除實際的資料庫服務,只會從面板中移除該伺服器的管理。 內建的本機伺服器無法在此刪除;請改為解除安裝對應的應用程式。

連線測試

新增或修改伺服器後,系統會自動測試連線。 若連線失敗,請檢查:

  1. 伺服器位址與連接埠是否正確
  2. 使用者名稱與密碼是否正確
  3. 防火牆是否允許連線
  4. 資料庫服務是否正常執行
  5. 是否允許資料庫使用者從目前主機連線

預設連接埠

資料庫預設連接埠
Percona/MySQL/MariaDB3306
PostgreSQL5432
Redis6379
ClickHouse8123
MongoDB27017
Elasticsearch9200
SQLite檔案路徑