使用教學

把網站放到 Spacefast

ShipPress v0.1.32 新增了 Spacefast 部署選項,作為 ShipPress 託管 之外的第二種靜態發佈方式。Spacefast 是 Automattic 的靜態網站發佈平台。你需要 ShipPress 0.1.32 或更新版本;如果你已經安裝近期的 Mac, Windows & Linux 應用程式,軟體可以自動更新。

  1. 這是什麼,以及何時不該使用

    發佈到 Spacefast 會將本機網站的靜態複本(將頁面和檔案打包成 zip)上傳到 Automattic 的發佈平台。這不是運作中的動態 WordPress 網站。

    只適用於靜態網站:會員登入、購物車(WooCommerce)、留言這類需要 WordPress 執行的功能不會運作。如果你目前開啟的網站含有 WooCommerce,免費網址上線 分頁會被停用,應用程式會提示你改用 WordPress 主機。

    呼叫 PHP 的頁面會顯示警告(靜態複本無法執行動態功能)。如果在匯出複本中檢查到其他問題,上傳會在開始前停止,應用程式會提示:沒有上傳。先處理這些問題: 並列出問題清單。自訂網域、Spacefast 背後的 WordPress 以及版本回滾功能並未內建在 ShipPress 中;如有需要,請至 Spacefast 控制面板進行設定。

  2. 取得 Spacefast 帳號與 API 金鑰

    ShipPress 不會替你開帳號。你必須直接到 Spacefast 網站申請帳號並建立自己的 API 金鑰,再貼回 ShipPress。

    前往 spacefast.com,輸入電子郵件並點擊 Continue,新信箱會收到六位數驗證碼。若畫面上顯示 WordPress.com、Google 或 GitHub 按鈕,也可以直接登入。詳細說明請參考 Spacefast 帳號驗證文件。Spacefast 目前提供 $0 的 Personal 方案,無需信用卡且可用於商業用途;請至 Spacefast 定價頁面 查看最新額度限制。

    API 金鑰屬於團隊,只有該團隊的擁有者與管理員可以建立。在 Spacefast 控制面板中,開啟團隊並前往 Agents,在 API keys 區塊建立金鑰。建立後請立即複製密鑰,開頭為 sfa_,系統只會顯示一次(提示如 Copy this key now. It won't be shown again.)。之後清單只會顯示如 sfa_abcd...wxyz 的預覽。請像保護密碼一樣妥善保管金鑰:切勿貼在對話、截圖或公開程式碼庫中。詳情請參閱 Spacefast API 金鑰指南。

  3. 在 ShipPress 中開啟上線並選擇 Spacefast

    先開啟你要發佈的網站。在 Mac, Windows & Linux 應用程式右上角點擊上線。若使用進階模式,這個按鈕會顯示為部署(詳見介面模式)。視窗標題是把「{name}」放上網路;若網站還沒有名稱,則是把網站放上網路。

    「上線方式」有三個分頁:免費網址上線、WordPress 主機與自行部署。選擇免費網址上線。在靜態網站放在哪裡中,選擇Spacefast(另一個選項是ShipPress 託管)。

    你也可以先在側邊欄點擊主機設定,在 Spacefast 那一列點擊連接,開啟連接 Spacefast對話框。連好後再回到上線發佈。

  4. 貼上 API 金鑰並連線

    在 Spacefast API key 欄位貼上開頭為 sfa_ 的金鑰。欄位提示寫著:金鑰只存在你電腦的系統鑰匙圈,AI 和記錄檔都看不到。 你也可以點擊應用程式內的說明連結 怎麼申請 API key ↗。

    貼上金鑰前,連線 按鈕保持停用,提示顯示 先貼上你的 API key。 點擊 連線 後,按鈕會顯示 確認中…。連線成功後,會顯示 已連線:{a} 與 中斷連線 按鈕。

    如果金鑰被拒絕,應用程式會提示 Spacefast didn't accept this key. Make a new API key at spacefast.com and paste it here. 若金鑰不屬於任何團隊,會提示 This key isn't part of any Spacefast team, so it can't make Spaces. Use a key from a team. 出現 403 錯誤代表 This Spacefast key isn't allowed to do that. Check its role and permissions at spacefast.com, or do it in the Spacefast dashboard. 在 Mac 上如果無法存取鑰匙圈,應用程式會提示:Couldn't save the key to the system keychain. If macOS asked for access, choose Always Allow, then try again. 請在系統詢問時選擇「永遠允許」。

  5. 選擇或新建一個 Space

    連線後,選擇要放置網站的 Space,或新建一個。同一個 Space 重新發佈時,網址不變。

    若目前沒有任何 Space,會提示 你還沒有 Space。在下面新建一個。 點擊 + 新建一個 Space。填寫 名稱(例如 我的烘焙坊)與 網址 代稱(例如 mybakery)。網址只能使用英文字母、數字和連字號(最多 40 個字元),下方會即時預覽 {slug}.space.fast。若名稱未填會提示 先輸入這個 Space 的名稱。 若代稱不合規則會提示 網址只能用英文字母、數字和連字號,請在「網址」欄填一個。

    建立時可設定存取權限:私人(只有你的團隊和拿到分享連結的人打得開(建議先選這個)。)或 公開(知道網址的人都能打開,搜尋引擎也能找到。)。新建的 Space 預設為私人。確認後點擊 建立 Space。如果該 Space 已被其他本機網站使用,會標註 已放著:{names},選取時會提示:這個 Space 已放著「{names}」。發佈後會換成這個網站,原本的內容會被取代。

  6. 發佈靜態複本

    選取 Space 後,點擊 發佈到 Spacefast。若尚未選取 Space,按鈕會停用並顯示 先選一個 Space。發佈進行期間,視窗無法關閉。

    應用程式會依序顯示進度:準備中…、正在複製頁面和檔案…({done} / {total})、正在檢查…、正在打包檔案…、正在上傳到 Spacefast…,以及 等 Spacefast 把網站上線…(等待時間最長可達 10 分鐘)。

    發佈完成後會顯示 已經上線:{pages} 頁,{files} 個檔案(共 {size})。 並附上已上線的網址。若 Spacefast 仍在處理最後步驟,則顯示 已送到 Spacefast,還在上線中,網址很快就能用。

  7. 誰可以打開網站

    發佈後,應用程式會說明存取狀態。若是公開狀態,會顯示:現在是公開的:知道網址的人都打得開。 若是私人狀態,則顯示:現在是私人的:只有你的團隊打得開,其他人會看到「禁止存取」。 如果是既有 Space 且未變更權限,則提示:公開或私人,維持這個 Space 原本的設定。打不開(禁止存取)代表它是私人的。

    你可以隨時點擊 設為公開 或 改回私人 切換權限。若想讓其他人免登入查看私人網站,點擊 產生分享連結,即可取得 分享連結(拿到的人不用登入就能看): 與專屬網址。

    你也可以隨時在側邊欄的 網站管理 與 主機設定 中查看各網站與 Space 的連線狀態與網址。

  8. 重新發佈、中斷連線或刪除 Space

    當你在本機修改 WordPress 內容後,再次點擊 發佈到 Spacefast 即可。發佈到同一個 Space 會保留原本的網址。

    若想將 API 金鑰從電腦的系統鑰匙圈移除,點擊 中斷連線。中斷連線只會清除本機的金鑰記錄,不會刪除 Spacefast 上的 Space 或檔案。

    若要刪除 Space,點擊 刪除。確認對話框會詢問:要永久刪除「{n}」嗎? 並說明:網站和它所有的版本都會從 Spacefast 消失,無法復原。你電腦上的網站不受影響。 點擊 永久刪除 確認,或點擊 取消。若你的 API 金鑰沒有刪除權限,按鈕會停用並提示:這把 API key 沒有刪除權限。請到 Spacefast 網站刪除。

  9. 後續步驟與相關教學

    探索 ShipPress 的其他發佈與匯出方式: