RunCloud 整合
概覽
RunCloud 是一個雲端伺服器管理平台,讓你可以輕鬆地在自己的雲端伺服器上部署和管理網頁應用程式。這個整合功能可以在 Ultimate Multisite 和 RunCloud 之間自動同步網域並管理 SSL 憑證。
功能特色
- 自動網域同步
- SSL 憑證管理
- 刪除對應時自動移除網域
需求條件
你必須在 wp-config.php 檔案中定義以下常數:
define('WU_RUNCLOUD_API_KEY', 'your_api_key');
define('WU_RUNCLOUD_API_SECRET', 'your_api_secret');
define('WU_RUNCLOUD_SERVER_ID', 'your_server_id');
define('WU_RUNCLOUD_APP_ID', 'your_app_id');
設定步驟
1. 取得 RunCloud API 憑證
- 登入你的 RunCloud 控制台
- 前往「User Profile」(點擊右上角的個人頭像)
- 從選單中選擇「API」
- 如果還沒有 API 金鑰,請點擊「Generate API Key」
- 複製你的 API Key 和 API Secret
2. 取得伺服器和應用程式 ID
- 在 RunCloud 控制台中,前往「Servers」
- 選擇託管你 WordPress 多站點的伺服器
- Server ID 會顯示在網址中:
https://manage.runcloud.io/servers/{SERVER_ID} - 前往「Web Applications」並選擇你的 WordPress 應用程式
- App ID 會顯示在網址中:
https://manage.runcloud.io/servers/{SERVER_ID}/apps/{APP_ID}
3. 將常數加入 wp-config.php
將以下常數加入你的 wp-config.php 檔案:
define('WU_RUNCLOUD_API_KEY', 'your_api_key');
define('WU_RUNCLOUD_API_SECRET', 'your_api_secret');
define('WU_RUNCLOUD_SERVER_ID', 'your_server_id');
define('WU_RUNCLOUD_APP_ID', 'your_app_id');
4. 啟用整合功能
- 在 WordPress 管理後台,前往 Ultimate Multisite > Settings
- 切換到「Domain Mapping」分頁
- 往下捲動到「Host Integrations」
- 啟用 RunCloud 整合
- 點擊「Save Changes」
運作方式
當網域在 Ultimate Multisite 中完成對應時:
- 整合功能會向 RunCloud 的 API 發送請求,將網域加入你的應用程式
- 如果網域成功加入,整合功能也會重新部署 SSL 憑證
- 當網域對應被移除時,整合功能會從 RunCloud 中移除該網域
對於子網域安裝模式,當新網站加入你的網路時,整合功能會自動在 RunCloud 中建立子網域。
疑難排解
API 連線問題
- 確認你的 API 憑證是否正確
- 檢查伺服器和應用程式 ID 是否正確
- 確保你的 RunCloud 帳戶有必要的權限
SSL 憑證問題
- RunCloud 可能需要一些時間來核發 SSL 憑證
- 確認你的網域已正確指向伺服器的 IP 位址
- 檢查應用程式的 RunCloud SSL 設定
網域未加入
- 檢查 Ultimate Multisite 日誌中是否有任何錯誤訊息
- 確認該網域是否已經加入 RunCloud
- 確保你的 RunCloud 方案支援多個網域