釋出、預覽或匯出站點
根據交付方式選擇託管預覽、正式釋出或原始碼匯出。
釋出、預覽或匯出站點
根據交付方式選擇託管預覽、正式釋出或原始碼匯出。
操作步驟
- 先開啟預覽連結,確認關鍵頁面、移動端和表單路徑可用。
- 確認後執行釋出,記錄釋出時間和版本狀態。
- 需要交給開發團隊時匯出站點,並附帶素材、語言內容和部署說明。
匯出獨立 CMS 包
site-only 只匯出逐頁 HTML 與靜態資源,不含安裝程式或 API;解壓後可開啟 index.html。cms-managed 是網站與 CMS 的獨立部署包;cms-only 包含 CMS 和內容 API,適用於前端獨立部署的專案。
- 具有發佈權限且方案支援獨立部署匯出的成員,可以在專案卡片的更多選單選擇匯出獨立 CMS 包。創作室的工具 → 匯出選單也提供此入口。
- 下載並解壓縮 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- 設定完成後啟動;執行環境會自動讀取
.env:
npm run check
npm start- 開啟
/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 帳號授權。目標專案所在的工作空間須支援獨立部署匯出,帳號須具備該專案的發佈權限。
- 在獨立網站後台開啟系統設定 → 部署授權,選擇 連接 Qokit。選擇產生配對碼,複製配對碼,再選擇 開啟 Qokit。
- 選擇目標專案並輸入配對碼。既有專案未顯示時,切換至專案所在的工作空間,確認專案未封存,且目前帳號具有發佈權限。網站只存在於獨立 CMS 時,先在目標工作空間建立專案,再回到配對視窗選擇該專案。
- 選擇 核對連接,核對專案、CMS 名稱及位址後選擇 確認綁定。回到獨立網站後台,等待連線成功提示。
也可直接在 Qokit 開啟目標網站,進入 系統設定 → 託管與交付 → 獨立部署,選擇 連接獨立 CMS 並輸入配對碼。此入口會使用目前的專案。配對只登記安裝執行個體並簽發部署授權。配對碼過期後,回到 CMS 選擇 產生新配對碼。
最後更新於