在 ServBay 中設定 Pinggy 反向代理服務指南

Pinggy 是一款輕量且易於使用的內網穿透工具，可協助您快速將本地運行的 Web 服務安全地暴露於公共網路。ServBay 內建整合 Pinggy，為 macOS 開發者提供簡便的公共存取隧道方案，特別適合程式碼展示、API 測試或與外部協作者分享在地開發成果。以下為完整的 ServBay 配置及使用 Pinggy 的流程指引。

概述

ServBay 內建對 Pinggy 的支援，使軟體的安裝與管理變得極為簡單。您可直接於 ServBay 圖形介面中啟用和控管 Pinggy 隧道，將在 ServBay 托管的本地網站映射到公開 URL，實現網際網路存取。

應用情境

• 快速展示： 立即向客戶或同事展示您於 macOS 開發環境中的網站或應用專案。
• API 與 Webhook 測試： 為需支援公開回調的第三方服務（如社群登入、訊息佇列）提供臨時公共端點。
• 遠端除錯： 讓遠端團隊成員輕鬆存取、調試您的本地開發環境。
• 行動端測試： 讓手機平板等設備可直接透過公開 URL 存取您本地運行的後端服務。

前置條件

1. ServBay 已安裝： 請確認您的 macOS 已成功安裝並執行最新版 ServBay。
2. Pinggy 帳戶： 您需要一組 Pinggy 帳號，可訪問 Pinggy 官方網站 免費註冊並選購套餐。
3. 本地網站： 至少已於 ServBay 配置並啟動一個本地網站，如 servbay.demo 或 kirby.test。

操作步驟

1. 在 ServBay 安裝 Pinggy 套件

首次於 ServBay 使用 Pinggy 時需先安裝套件：

1. 開啟 ServBay 應用程式。

2. 在左側導覽列點選 套件 (Packages)。

3. 在可用套件列表中尋找或搜尋 Pinggy。

4. 點擊 Pinggy 右側的安裝按鈕。

5. 安裝完成後，您可嘗試點擊 Pinggy 旁的啟動開關。如服務未能啟動或狀態異常，屬於正常，因尚未完成設定。接下來將進行相關配置。

   

2. 取得您的 Pinggy Access token

Pinggy 需以 Access token 驗證帳戶並啟用隧道功能。

1. 訪問 Pinggy Dashboard 並登入。

2. 登入後，一般可在主控台首頁 "Access token" 區段找到您的個人 Access token。

3. 複製此 Access token，這是一串字元，請妥善保存。

   

3. 在 ServBay 中設定 Pinggy

取得 Access token 後，回到 ServBay 進行設定：

1. 於 ServBay 左側導覽點選 Tunnel。

2. 在 Tunnel 服務列表裡選擇 Pinggy。

   

3. Auth Token（授權令牌）：

   • 在 Auth Token 輸入框貼上剛才於 Pinggy 主控台複製的 Access token。

4. 隧道配置（Local Domain 與 External Domain）： ServBay 支援針對多個本地網站建立 Pinggy 隧道。

   • Local Domain（本地網站）：
     • 點擊下拉選單，選擇您想透過 Pinggy 暴露到公網的本地網站，如 thinkphp.test 或 servbay.demo。
   • External Domain（外部網域）：
     • Pinggy 免費用戶： 請留空本欄。 Pinggy 會自動產生隨機公共 URL（多為 .a.free.pinggy.link 或 .pinggy.link 結尾）。隧道建立成功後，ServBay 將自動取得並顯示該網址。
     • Pinggy 付費用戶： 若帳號支援自訂或專屬網域，則可在此輸入期望用途的外部網域。

5. 新增更多隧道：

   • 需為其他本地網站建隧道時，請點選現有隧道條目右側的 +（加號）按鈕，再依步驟 4 配置。

6. 儲存設定：

   • 完成全部隧道設定後，請點選畫面右下角 Save（儲存） 按鈕。

4. 啟動並驗證 Pinggy 服務

1. 儲存設定後，ServBay 會根據新配置啟動 Pinggy 服務。
2. 檢查 Tunnel 列表中 Pinggy 旁邊的狀態指示燈。如設定正確且已連線成功，指示燈將變為綠色，表示服務運作中。
3. 每條成功啟動的隧道，其 External Domain 欄位（若原本留空）會出現 Pinggy 分配的公共網址，例如 https://random-string.a.free.pinggy.link。
4. 確認訪問：
   • 點擊外部域名旁的 複製圖示，複製該公共 URL。
   • 或點擊 瀏覽器圖示（如指南針或地球）直接於預設瀏覽器開啟連結。
   • 若所有設定無誤，即可透過 Pinggy URL 由外部訪問您的本地網站。

5. 管理 Pinggy 隧道

於 ServBay 的 Pinggy 設定頁，可輕鬆管理所有隧道：

• 複製外部網域： 點擊複製圖示，快速取得公共網址並分享。
• 瀏覽器開啟： 點擊瀏覽器圖示，測試隧道可用性。
• 新增隧道： 點選 + 圖示設定新隧道。
• 移除隧道： 點選 -（減號）圖示，刪除不需要的隧道設定。
• 啟動／停止服務： 直接從 Pinggy 服務條目旁的開關切換隧道啟用或停用。

注意事項

• Pinggy 免費版限制： 所產生的外部網域為動態網址，每次重啟隧道或 Pinggy 服務時可能變動。免費版在連線數、頻寬、使用時長等均有限制。若需要固定網域、高效能或進階功能，建議升級至付費方案。
• 本地服務依賴： 確保您於 Local Domain 選取的本地網站已在 ServBay 正確配置並執行（如對應 PHP 版本、Web 伺服器如 Caddy/Nginx 已運作、網站設定無誤）。Pinggy 僅負責網路流量轉發，無法取代本地服務的正確性。
• 防火牆與網路： 請確保 macOS 防火牆或其他第三方安全軟體未阻擋 ServBay 與 Pinggy 客戶端的網路連線能力。
• HTTPS 資安防護： Pinggy 通常會自動為隧道網址提供 HTTPS 加密，確保傳輸過程安全，有助於現代 Web 應用的安全需求。

常見問題 (FAQ)

• Q: 如 Pinggy 服務啟動失敗、指示燈非綠色該怎辦？
  • A: 請先檢查輸入的 Pinggy Access token 是否正確，再確認網路連線正常。可查看 Pinggy 客戶端日誌（服務右側有 log 圖示），多數錯誤訊息會在這裡呈現。
• Q: 我是 Pinggy 免費用戶，為何 External Domain 欄位需留空？
  • A: 這是 Pinggy 免費服務的標準流程，無須自行指定外部網域。隧道連線完成後，ServBay 會自 Pinggy 伺服器自動取得臨時公共網址並顯示。
• Q: Pinggy 與 Ngrok 等其他隧道服務有何差異？我該用哪款？
  • A: Pinggy 與 Ngrok 都屬優秀內網穿透解決方案，但在功能、免費限制、方案價格、設定難易與伺服器分佈等面向有細節差異。Pinggy 以輕量、易於上手著稱。您可依使用協定支援、自訂網域、預算等需求及個人偏好選擇，ServBay 亦同時支援多種隧道工具，靈活度高。

總結

ServBay 內建的 Pinggy 功能，為 macOS Web 開發者提供便捷的本地網站共享解決方案。只需簡單設定，即可將本地開發環境安全地公開於網路，極大提升演示、測試及協作效率。請根據 Pinggy 帳戶權限完成正確設定，並確保本地網站服務正常運作，充分享受 Pinggy 所帶來的便利性。