Skip to Content
使用者手冊

釋出、預覽或匯出站點

根據交付方式選擇託管預覽、正式釋出或原始碼匯出。

釋出、預覽或匯出站點

根據交付方式選擇託管預覽、正式釋出或原始碼匯出。

操作步驟

  1. 先開啟預覽連結,確認關鍵頁面、移動端和表單路徑可用。
  2. 確認後執行釋出,記錄釋出時間和版本狀態。
  3. 需要交給開發團隊時匯出站點,並附帶素材、語言內容和部署說明。

匯出獨立 CMS 包

site-only 只匯出逐頁 HTML 與靜態資源,不含安裝程式或 API;解壓後可開啟 index.html。cms-managed 是網站與 CMS 的獨立部署包;cms-only 包含 CMS 和內容 API,適用於前端獨立部署的專案。

  1. 具有發佈權限且方案支援獨立部署匯出的成員,可以在專案卡片的更多選單選擇匯出獨立 CMS 包。創作室的工具 → 匯出選單也提供此入口。
  2. 下載並解壓縮 ZIP,使用 Node.js 20.12 或更新版本。複製環境設定範例,再編輯 .env,替換管理員帳號、密碼和 Session 密鑰:
cp .env.example .env

填寫 CMS 服務的公開網域及外部網站網域。允許來源必須是以逗號分隔的完整 HTTP(S) origin,不支援萬用字元。

CMS_ADMIN_EMAIL=owner@example.com
CMS_ADMIN_PASSWORD=replace-with-at-least-12-characters
CMS_SESSION_SECRET=replace-with-at-least-32-random-characters
CMS_PUBLIC_URL=https://cms.example.com
SITE_PUBLIC_URL=https://www.example.com
CMS_ALLOWED_ORIGINS=https://www.example.com,http://localhost:4321
  1. 設定完成後啟動;執行環境會自動讀取 .env:
npm run check
npm start
  1. 開啟 /admin,使用部署設定中的帳號登入。根路徑會轉至 CMS,此包不提供網站頁面。檢查 /health,並透過 /api/content/collections/news/entries?locale=en 讀取已發佈內容。外部表單可提交至 /api/forms/contact/submissions。草稿不會公開,管理員登入仍限定於 CMS 自身網域。

持久化並備份 data 和 public/uploads,保護 data/update-config.json。更新會保留部署類型和本機資料。無法匯出時請檢查角色和方案權限;外部請求返回 403 時請核對允許來源並重新啟動。

連接獨立 CMS 到 Qokit

站點擁有者可從獨立 CMS 發起配對,並以自己的 Qokit 帳號授權。目標專案所在的工作空間須支援獨立部署匯出,帳號須具備該專案的發佈權限。

  1. 在獨立網站後台開啟系統設定 → 部署授權,選擇 連接 Qokit。選擇產生配對碼,複製配對碼,再選擇 開啟 Qokit。
  2. 選擇目標專案並輸入配對碼。既有專案未顯示時,切換至專案所在的工作空間,確認專案未封存,且目前帳號具有發佈權限。網站只存在於獨立 CMS 時,先在目標工作空間建立專案,再回到配對視窗選擇該專案。
  3. 選擇 核對連接,核對專案、CMS 名稱及位址後選擇 確認綁定。回到獨立網站後台,等待連線成功提示。

也可直接在 Qokit 開啟目標網站,進入 系統設定 → 託管與交付 → 獨立部署,選擇 連接獨立 CMS 並輸入配對碼。此入口會使用目前的專案。配對只登記安裝執行個體並簽發部署授權。配對碼過期後,回到 CMS 選擇 產生新配對碼。

這篇指南有幫助嗎?

最後更新於

本頁目錄