這篇完成：一個靜態站已建立，ZIP 已上傳並開始部署。
上線請再到 如何預覽、發布與回滾。
前提
- 站台已開啟靜態網站（見 模組如何開啟）。
- 你的角色是擁有者或網站編輯者。
- 尚未滿 3 站（列表會顯示「已用 x/3」）。
路徑
側欄 靜態網站（/admin/static-sites）。空狀態：「還沒有靜態網站」／「建立一個子網域並上傳 HTML ZIP。」
建立一站（逐步）
- 在列表上方表單填：
| 欄位 | 說明 |
|---|---|
| 名稱 | 後台顯示用，可之後再改 |
| 子網域 slug | 會變成 slug.sites.… 的前段。用小寫英文、數字、連字號；上線後少改 |
- 點 建立。成功提示「已建立靜態網站」，並進入該站編輯頁。
- 編輯頁上方會顯示平台公開網址（等寬字）。請抄下來，之後預覽與 DNS 都會用到。
建立當下還沒有檔案，列表狀態會是「尚未發布」。一般訪客開公開網址會看到尚未發布，這是正常的。
ZIP 要怎麼打包？
- 壓縮檔裡必須有
index.html（或index.htm）當首頁。 - 請把首頁放在 ZIP 最外層，或只包一層資料夾（該資料夾內有
index.html）。不要把首頁藏在更深的子目錄。macOS 壓縮產生的__MACOSX、.DS_Store系統會忽略。 - 允許的類型大致為：HTML／CSS／JS、常見圖片與字型、
json／xml／txt、pdf、短影片（mp4／webm）。 - 不要放進 README、
.md、PHP、執行檔、.env、.git等；有不允許的副檔名時整包部署會失敗。 - 請勿放入空檔（0 byte）。單一檔案解壓後上限約 50MB。
- 整包 ZIP 上傳上限 50MB。解壓後若超過約 200MB 或超過約 5000 個檔，這次部署會失敗，已經上線的舊版會繼續運作。
上傳會計入站台儲存空間；空間不足時無法完成部署。
上傳（逐步）
- 進入該站（列表點 管理）。
- 找到 上傳 ZIP。畫面會提示大小上限。
- 選
.zip檔。上傳中會顯示進度百分比。 - 成功提示「已開始部署，完成後請預覽再發布」。
- 稍後重新整理，到 版本 表看狀態。失敗原因在「失敗原因」欄；線上網站不會被清空。
重新上傳成功後會先變成預覽，不會立刻蓋掉線上版。一定要再按 發布上線 訪客才看得到新版。
怎麼驗
- 列表出現該站，網址欄是
…sites…。 - 版本 出現新的一列，狀態可預覽（不是失敗）。
- 有 開啟預覽 連結（見下一篇）。
常見卡住
| 狀況 | 怎麼辦 |
|---|---|
| 無法建立 | 已滿 3 站，或 slug 已被占用。換代碼或刪／停用不再使用的站（若畫面允許） |
| 部署失敗：找不到 index.html | 把首頁放到 ZIP 根目錄或只包一層資料夾再傳 |
| ZIP 超過大小上限 | 壓縮前先縮小圖片／影片；單檔也不要超過 50MB |
| 空間不足 | 清主站圖庫或不需要的舊檔後再傳 |
| 上傳後版本一直失敗 | 看失敗原因：通常是禁副檔名、空檔或檔案太多 |
相關說明
- 如何預覽、發布與回滾
- 圖片破圖與快取