使用教學 / 主機系列教學

xCloud:註冊並使用 API 權杖連接到 ShipPress

這是我們主機系列的第 6 篇。xCloud 是一套能為你管理 WordPress 伺服器的控制面板。完成註冊後,在 xCloud 建立 WordPress 網站並產生 API 權杖,將它貼入 ShipPress Mac, Windows & Linux 應用程式,就能將網站發布上線。

  1. ShipPress 與 xCloud 的搭配方式

    在 ShipPress 裡,xCloud 的說明是:「一套替你管理 WordPress 伺服器的控制台:可以使用你自己的雲端伺服器,或向他們租用,並在上面建立多個網站。」

    完成連接後,ShipPress 會列出你在 xCloud 上的 WordPress 網站。你可以選擇全部、只有檔案或只有資料庫來上線,也能把線上網站下載回電腦,或是直接打開已登入的 WordPress 後台。

    上線與下載都透過 SSH 進行。ShipPress 會透過 xCloud 的 API 自動將自己的 SSH 金鑰加入網站,並保留原本的所有金鑰。請注意,ShipPress 無法直接在 xCloud 上建立新網站,因此需要先在 xCloud 控制台建立好網站。

  2. 註冊並建立 WordPress 網站

    若要開始使用,請點選下方的註冊按鈕。你可以在 xCloud 方案定價頁比較不同的伺服器選項。請注意,xCloud 在設定伺服器之前需要先綁定付款方式。

    當帳號與伺服器準備就緒後,請在 xCloud 控制台內建立 WordPress 網站。詳細的建站步驟可參考 xCloud 官方建站教學。

    在 xCloud 註冊 ↗

    上方的註冊按鈕為聯盟行銷連結:如果你透過該連結註冊,ShipPress 可能會獲得分潤佣金,你不需要支付任何額外費用(詳細說明)。

  3. 建立 API 權杖

    ShipPress 透過 API 權杖與 xCloud 通訊。請依照 xCloud API 官方指南的步驟建立:

    1. 在 xCloud 控制台中點擊 Settings,接著選擇 Developers,然後點擊 API Tokens。
    2. 點擊 Create New Token。
    3. 輸入 Token Name(例如「ShipPress」)。
    4. 選擇權限。ShipPress 提示:「建立權杖時勾選 read:servers、read:sites 和 write:sites。下載和部署走 SSH:ShipPress 會把自己的 SSH 金鑰加進網站,原本的金鑰都會保留。」選擇 Full Access 也同樣可以正常運作。
    5. 點擊 Create Token。

    建立後請立即複製權杖並妥善保存,xCloud 只會顯示這一次。

  4. 將權杖貼入 ShipPress

    1. 在 ShipPress 側邊欄點選主機設定。
    2. 找到 xCloud 該列,點擊連接。你也可以點擊到 xCloud 建立 API 金鑰 ↗直接在瀏覽器中打開權杖建立頁面。
    3. 將權杖貼入 API 金鑰(API token)欄位(該欄位顯示提示文字 「貼上 xCloud → Account → API Tokens 裡的權杖」)。
    4. 點擊連接。測試連線時按鈕會顯示 驗證中…。

    你貼上的機密資料只會儲存在系統鑰匙圈中,絕不會寫入檔案或記錄檔,AI 也永遠看不到。

    「連接 xCloud」對話框,可貼上 API 權杖,並說明建立時要勾選的權限範圍。
    把 xCloud 的 API 權杖貼進來,再按「連接」。
  5. 將網站切換為 SSH 金鑰驗證,然後上線

    由於 xCloud 不會提供 SSH 密碼,網站必須使用 SSH 金鑰進行登入。如果網站目前設定為密碼驗證,ShipPress 會暫停並提醒你:在 xCloud 打開該網站,進入 SSH/SFTP,將 Authentication 切換為 SSH key。請保留原本的金鑰,ShipPress 會將自己的金鑰加入並列。相關操作可參考 xCloud 的 SFTP 存取設定教學與 SSH 金鑰生成與新增指南。

    xCloud 會在背景套用新金鑰,因此首次連線大約需要一分鐘左右。

    準備好上線時:

    1. 在 ShipPress 中打開你的網站,點擊上線。
    2. 切換到 WordPress 主機分頁,點選 xCloud。
    3. 在要放到哪個網址下方選擇網站網址。
    4. 點擊取代並上線。
  6. 網站上線之後

    網站上線後,前往網站管理並選擇線上網站。在 xCloud 網站旁,你可以點擊 WordPress 後台 ↗直接以已登入狀態開啟管理後台,或點擊開啟 ↗瀏覽公開網站。點擊下載到這台電腦可以把線上網站抓回 ShipPress(詳見從主機下載網站指南)。

    如果你在主機設定的 xCloud 那一列點擊中斷連接,ShipPress 會忘記這台電腦上的權杖與網站連線。線上的網站仍會正常運作。ShipPress 加入的 SSH 金鑰會一直留在伺服器上,直到你在 xCloud 的 SSH/SFTP 設定中將其移除;你也可以在 xCloud 的 API Tokens 頁面刪除該權杖。

  7. 本系列的下一篇

    歡迎閱讀本系列的其他指南與相關教學: