PostgreSQL 服務管理指南：pg_ctl 啟動、停止與重啟完整操作詳解

pg_ctl 核心命令語法

pg_ctl 是 PostgreSQL 官方提供的服務控制工具，用於管理 postmaster 後端進程。以下是常用操作模式的標準語法：

pg_ctl start [-w] [-s] [-D datadir] [-l filename] [-o options] [-p path]
pg_ctl stop [-W] [-s] [-D datadir] [-m s[mart] | f[ast] | i[mmediate]]
pg_ctl restart [-w] [-s] [-D datadir] [-m s[mart] | f[ast] | i[mmediate]] [-o options]
pg_ctl reload [-s] [-D datadir]
pg_ctl status [-D datadir]
pg_ctl kill [signal_name] [process_id]

操作模式詳細說明

啟動模式 (start)

在後台啟動新的資料庫伺服器。標準輸入導向 /dev/null，若指定 -l 參數，標準輸出與錯誤將寫入日誌檔案；否則輸出導向 pg_ctl 的標準輸出。建議搭配日誌輪轉工具（如 rotatelogs）使用，避免輸出佔用控制終端導致進程無法正確脫離 shell 進程組。

關閉模式 (stop)

關閉指定資料目錄下的伺服器，支援三種關閉策略：

• Smart 模式（預設）：等待所有用戶端斷開連線後再關閉。
• Fast 模式：不等待用戶端，回滾所有進行中事務並強制斷開連線。
• Immediate 模式：直接終止進程，下次啟動時需執行崩潰恢復。

重啟模式 (restart)

相當於先執行 stop 再執行 start，但會保留並重用上一次 postmaster 的命令列參數，方便修改啟動選項後生效。

重新載入設定 (reload)

向 postmaster 發送 SIGHUP 訊號，使其重新讀取 postgresql.conf、pg_hba.conf 等設定檔，無需完整重啟即可套用新設定。

狀態查詢 (status)

檢查指定資料目錄是否有伺服器正在運行，若有則顯示其 PID 與啟動命令列參數。

進程訊號發送 (kill)

向指定進程發送訊號，在缺乏原生 kill 命令的 Windows 環境下特別有用。

常用參數對照表

環境變數與關鍵檔案

• PGDATA：預設資料目錄位置
• PGPORT：psql 預設連接埠（-w 選項使用）
• postmaster.pid：存在於資料目錄，用於判斷伺服器是否運行
• postmaster.opts.default / postmaster.opts：啟動時自動套用的命令列參數
• postgresql.conf：主設定檔，-w 模式下會解析其中的 port 設定

實務操作範例

啟動伺服器

$ pg_ctl start
$ pg_ctl -w start                 # 等待啟動完成
$ pg_ctl -o "-F -p 5433" start    # 指定埠 5433 並關閉 fsync

停止伺服器

$ pg_ctl stop
$ pg_ctl -w -m fast stop          # 等待快速關閉完成

重啟伺服器

$ pg_ctl restart
$ pg_ctl -w restart               # 等待重啟完成
$ pg_ctl -o "-F -p 5433" restart  # 變更埠號並重啟

查看狀態

$ pg_ctl status
pg_ctl: postmaster is running (pid: 13718)
Command line was:
/usr/local/pgsql/bin/postmaster '-D' '/usr/local/pgsql/data' '-p' '5433' '-B' '128'

注意事項

等待完全啟動並非嚴格定義的操作，若存取控制要求本地用戶端需手動互動（如密碼認證），可能導致等待超時。生產環境建議搭配 systemd 或 init 系統管理服務，而非直接依賴 pg_ctl。