伺服器管理
伺服器管理頁面用於管理資料庫伺服器連線,同時支援本機與遠端資料庫伺服器。 支援的資料庫類型有 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 伺服器
新增遠端伺服器
- 點選 新增伺服器 按鈕
- 填寫設定:
- 類型:選擇資料庫類型(MySQL/PostgreSQL/ClickHouse/MongoDB/SQLite/Elasticsearch/Redis)。 從特定類型的分頁開啟對話方塊時,此選擇器會被隱藏。
- 名稱:伺服器名稱(用於識別,僅允許字母、數字、
-與_) - 主機:伺服器位址。 對於 SQLite,此處會變為檔案路徑欄位,用於選擇資料庫檔案。
- 連接埠:資料庫連接埠
- 使用者名稱:管理員使用者名稱(Redis 與 SQLite 不顯示)
- 密碼:管理員密碼(SQLite 不顯示)
- 備註:備註
- 點選提交
遠端伺服器使用情境
- 連線至雲端資料庫(例如阿里雲 RDS、騰訊雲 CDB)
- 連線至容器中的資料庫服務
- 連線至其他伺服器上的資料庫
- 資料庫讀寫分離架構
伺服器操作
終端機
點選 終端機 按鈕即可開啟資料庫命令列終端機,您可以在其中直接執行 SQL 陳述式。 終端機會為所選的伺服器類型啟動原生用戶端,並自動傳入面板中儲存的連線參數(主機、連接埠、使用者名稱與密碼):
| 類型 | 啟動的用戶端 | 說明 |
|---|---|---|
| MySQL | mysql | 使用設定的使用者名稱、密碼、主機與連接埠進行連線。 |
| PostgreSQL | psql | 設定了密碼時使用 PGPASSWORD;未設定密碼時則回退至 su - postgres -c 'psql'。 |
| Redis | redis-cli | 僅在設定了密碼時才加入 -a 密碼旗標。 |
| ClickHouse | clickhouse-client | 一律連線原生 TCP 連接埠 9000,而非下方連接埠表格中顯示的 HTTP 連接埠 8123。 |
| MongoDB | mongosh | 透過 mongodb:// URI 連線至 admin 資料庫。 |
| SQLite | sqlite3 | 使用設定的檔案路徑直接開啟資料庫檔案。 |
| Elasticsearch | curl | 執行 curl .../_cat/indices?v 列出索引;這是一個唯讀的 HTTP 請求,而非互動式 shell。 |
同步
點選 同步 按鈕可將資料庫使用者(不含其密碼)同步至面板。 當使用者直接在資料庫中建立時,可以使用此功能將其同步至面板。
TIP
同步功能適用於 MySQL、PostgreSQL 與 ClickHouse 伺服器。 它不會為 Redis、MongoDB、SQLite 與 Elasticsearch 顯示,因為這些資料庫不支援面板使用者管理。
修改
點選 修改 按鈕即可修改伺服器連線資訊,例如密碼、主機位址等。
刪除
點選 刪除 按鈕即可刪除伺服器設定。 刪除生效前需要 5 秒的確認倒數計時。
注意
刪除伺服器設定並不會刪除實際的資料庫服務,只會從面板中移除該伺服器的管理。 內建的本機伺服器無法在此刪除;請改為解除安裝對應的應用程式。
連線測試
新增或修改伺服器後,系統會自動測試連線。 若連線失敗,請檢查:
- 伺服器位址與連接埠是否正確
- 使用者名稱與密碼是否正確
- 防火牆是否允許連線
- 資料庫服務是否正常執行
- 是否允許資料庫使用者從目前主機連線
預設連接埠
| 資料庫 | 預設連接埠 |
|---|---|
| Percona/MySQL/MariaDB | 3306 |
| PostgreSQL | 5432 |
| Redis | 6379 |
| ClickHouse | 8123 |
| MongoDB | 27017 |
| Elasticsearch | 9200 |
| SQLite | 檔案路徑 |
