ServBay

繁體中文

English
简体中文
Español
العربية
Português
Русский
日本語
Deutsch
Français
Tiếng Việt
Türkçe
Italiano

繁體中文

English
简体中文
Español
العربية
Português
Русский
日本語
Deutsch
Français
Tiếng Việt
Türkçe
Italiano

Appearance

ServBay 文件：使用 Adminer 管理資料庫 ​

概述 ​

ServBay 是專為 macOS 設計的強大本機 Web 開發環境，整合多種 Web 伺服器、程式語言執行環境與資料庫系統。為方便開發者管理內建資料庫，ServBay 預先安裝並配置了 Adminer —— 一套功能齊全且輕量的資料庫管理工具。本文件將引導您如何使用 Adminer 連接並管理 ServBay 內的各類資料庫。

什麼是 Adminer ​

Adminer 是以 PHP 撰寫的單檔案資料庫管理工具，支援多種資料庫系統，包括 MySQL、MariaDB、PostgreSQL、SQLite、MongoDB 等。相較於其他大型資料庫管理客戶端，Adminer 具備以下明顯優勢：

  1. 輕量且單檔案部署： Adminer 僅需一個 PHP 檔案，無需繁瑣安裝即可使用。ServBay 已預先整合，可直接開箱使用。
  2. 多資料庫支援： 透過同一界面即可連接及管理不同資料庫，省去安裝與學習多套工具的麻煩。
  3. 簡潔直觀的界面： 介面清爽、操作直觀，就算是初次使用的開發者也能快速上手。
  4. 功能完整： 支援絕大多數常見資料庫操作如：建立、修改、刪除資料庫/資料表/索引/用戶、執行 SQL 查詢、匯入/匯出資料等。

對於利用 ServBay 進行本機開發的開發者來說，Adminer 是一項高效便利的資料庫管理工具。

訪問 Adminer ​

啟動 ServBay 後，Adminer 會自動執行，並由內建 Web 伺服器供存取。可透過 ServBay 預設本地域名加上 adminer 檔案名進行訪問：

https://servbay.host/adminer.php

請確保 ServBay 應用正在執行，且相關的 Web 伺服器（如 Caddy 或 Nginx）及您要連線的資料庫服務已啟動。

使用 adminer 管理資料庫

連接至 ServBay 內的資料庫 ​

Adminer 登入介面簡單易懂。只需選擇資料庫型別，並填入伺服器位址、用戶名稱、密碼，以及（部分資料庫需輸入）資料庫名稱即可連線。ServBay 會為內建資料庫自動生成預設帳號密碼，可在 ServBay 應用的『資料庫』分頁查閱。

連線至 MariaDB / MySQL ​

ServBay 通常預設整合 MariaDB 或 MySQL。在 Adminer 上，通常選「MySQL」型別以連接。

  1. 打開瀏覽器，訪問 Adminer 入口（https://servbay.host/adminer.php）。
  2. 登入畫面，於 系統 下拉選單選取 MySQL。
  3. 填入伺服器連接資訊：
    • 伺服器： 輸入 localhost 或使用 ServBay 提供的 Unix Socket 路徑 /Applications/ServBay/tmp/mysql.sock。透過 socket 連接效率通常更高。
    • 用戶名稱： 至 ServBay 應用的『資料庫』頁尋找 MariaDB/MySQL 的用戶名。
    • 密碼： 同上，於『資料庫』中查找對應密碼。
    • 資料庫：（選填）若欲直接連至特定資料庫可輸入名稱，留空則登入主機後可管理全部資料庫。
  4. 點選 登入。

連線至 PostgreSQL ​

ServBay 同樣支援 PostgreSQL。在 Adminer 上，請選「PostgreSQL」。

  1. 開啟瀏覽器，進入 Adminer 介面（https://servbay.host/adminer.php）。
  2. 登入畫面於 系統 下拉列表選擇 PostgreSQL。
  3. 填寫伺服器連線資訊：
    • 伺服器： 輸入 /Applications/ServBay/tmp。
    • 用戶名稱： 參考 ServBay 應用『資料庫』分頁取得 PostgreSQL 用戶名稱。
    • 密碼： 同上，於『資料庫』取得。
    • 資料庫： 輸入目標資料庫名稱，如預設的 postgres 或自行建立的資料庫名稱。
  4. 點擊 登入。

連線至 SQLite 3 ​

ServBay 支援 SQLite 3。SQLite 為檔案型資料庫，連線時需指定完整檔案路徑。

  1. 開啟瀏覽器，進入 Adminer（https://servbay.host/adminer.php）。
  2. 登入畫面於 系統 下拉選單選 SQLite 3。
  3. 輸入資料庫檔案路徑：
    • 資料庫檔案： 指定 SQLite 資料庫的完整路徑。建議將檔案放於 ServBay 資料夾下，如 /Applications/ServBay/db/sqlite/your_database_name.sqlite。
    • 若所輸入路徑指向不存在的檔案，Adminer 會提示是否新建該資料庫檔案。
  4. 按 登入。

執行常見資料庫操作 ​

進入資料庫主機或指定資料庫後，即可透過 Adminer 介面進行多種資料庫管理工作。不同類型資料庫的功能略有不同，但基本操作大同小異。

建立資料庫 ​

（適用於 MariaDB/MySQL, PostgreSQL）

  1. 登入資料庫主機（未選特定資料庫）。
  2. 在左側選單或主畫面找到 建立資料庫 或同義選項。
  3. 輸入新資料庫名稱。
  4. 設定字符集、排序規則（如有需求）。
  5. 點選 儲存 或 建立。

（SQLite 3 建立資料庫則為登入時指定不存在路徑即自動建立。）

管理資料表與資料 ​

  1. 選取目標資料庫（登入時無指定需自行選擇）。
  2. 資料庫總覽頁，尋找 建立資料表。
  3. 輸入資料表名稱，並定義各欄位，包括欄位名、型別、長度、允許 NULL、預設值、索引（主鍵、唯一、一般索引）等。
  4. 點選 儲存 以建立。
  5. 建表完成後，可左側導航或總覽頁選擇該表。
  6. 執行資料操作：
    • 插入：新增資料列。
    • 查詢：瀏覽、搜尋、排序、篩選資料。
    • 更新：編輯既有資料列。
    • 刪除：移除資料列。
    • 以 SQL 命令 執行進階查詢與操作。

執行 SQL 命令 ​

Adminer 提供 SQL 命令輸入介面，能直接撰寫並執行 SQL，進行更彈性的管理與查詢。

  1. 選取欲執行命令的資料庫。
  2. 點選 SQL 命令 選項。
  3. 在文字區塊中輸入 SQL 語句。
  4. 按下 執行。

匯入與匯出資料 ​

Adminer 支援將資料庫結構與資料匯出為 SQL 或其他格式（如 CSV），亦能從這些檔案匯入，便於遷移、備份或分享資料。

  1. 選定欲匯入/匯出之資料庫或資料表。
  2. 尋找 匯出 或 匯入 選項。
  3. 依介面提示選擇格式及細節並執行。

刪除資料庫 ​

（適用於 MariaDB/MySQL, PostgreSQL）

  1. 登入資料庫主機（未指定特定資料庫）。
  2. 在列表中選定欲刪除的資料庫。
  3. 點擊 刪除 並確認。注意：此操作無法復原，資料庫及所有資料將永久刪除。

（SQLite 3 資料庫則直接在檔案系統中刪除 .sqlite 檔即可。）

注意事項 ​

  • 帳號密碼安全： 自 ServBay 取得的資料庫帳號與密碼請妥善保管，避免外洩。
  • ServBay 啟動狀態： Adminer 需經由 ServBay 內建 Web 伺服器訪問，且資料庫服務必須運行才能連線。若無法連上 Adminer 或資料庫，請檢查 ServBay 是否在執行及相應服務（Caddy/Nginx, MariaDB/MySQL, PostgreSQL 等）是否啟動。
  • SQLite 路徑權限： 請確保 SQLite 資料庫檔設置在 ServBay 用戶有讀寫權限之路徑，建議使用 /Applications/ServBay/db/sqlite/ 目錄。
  • 效能建議： Adminer 為輕量工具，若需管理超大型資料庫或複雜操作，建議考慮專業桌面應用（如 TablePlus、DBeaver、pgAdmin 等）以獲得進階功能與更佳效能。

常見問題（FAQ） ​

Q: 無法訪問 https://servbay.host/adminer.php 怎麼辦？

A: 請確保 ServBay 應用正在運行，且 Web 服務（通常為 Caddy 或 Nginx）已啟動。另請檢查瀏覽器是否允許連線 https://servbay.host。

Q: 忘記資料庫的用戶名稱或密碼，要去哪裡查詢？

A: 可於 ServBay 應用介面的『資料庫』頁籤查詢各資料庫自動生成的帳號與密碼。

Q: 連線 PostgreSQL 時，伺服器位址和埠號是多少？

A: 一般伺服器位址為 localhost，預設埠號為 5432。可於 ServBay 設定確認 PostgreSQL 的監聽位址與埠。如果透過 Unix Domain Socket 連接，請輸入 /Applications/ServBay/tmp（注意：PostgreSQL 不需加 .sock 結尾）。

Q: MariaDB/MySQL 連線時，伺服器位址與 socket 路徑有何不同？

A: localhost 通常以 TCP/IP 方式（預設埠號 3306）連線，而 /Applications/ServBay/tmp/mysql.sock 屬於 Unix Domain Socket。本機環境下，socket 連線通常比 TCP/IP 更快且更安全，可依實際需求選用。

Q: 可用 Adminer 管理 ServBay 未內建的其它資料庫嗎？

A: Adminer 本身支援多種類型資料庫。若您於 ServBay 外安裝了其他資料庫（如獨立 MongoDB 或遠端資料庫），理論上可借 ServBay 中的 Adminer 進行連線（需具備正確連線資訊且網路可達）。但 Adminer 的主要整合目標還是在於服務與管理 ServBay 內建資料庫。

總結 ​

Adminer 是 ServBay 隨附的便利資料庫管理工具。其單檔、輕量特性與多資料庫支援，大幅簡化了本機開發環境下 MariaDB/MySQL、PostgreSQL 與 SQLite 資料庫的日常管理工作。依本文引導，相信您能輕鬆連線並有效運用 Adminer 處理各項資料庫管理與資料操作需求。