Vercel 在 2026 年 11 月 6 日替 CLI 新增 --delete-project-after。使用 Vercel CLI 65.12.0 或更新版本建立新 project 時,可選擇一小時、一天、一週、兩週或 30 天後自動刪除;若展示需要保留,可在到期前執行 vercel project keep 移除到期設定。
這項功能處理的是短命「專案」,不是一般 Preview Deployment 的保存期限。旗標只在 vercel deploy 當下建立新 project 時生效;若目錄已連結既有 project,再帶同一旗標部署,既有 project 的 expiration 不會改變,CLI 只會警告。導入前要先分清楚團隊建立的是獨立 demo project,還是既有 production project 裡的一個 preview。
自動到期刪除的範圍比單一網址大
Vercel 的 project 是部署、網域、環境變數與設定的容器。官方專案管理文件說明,刪除 project 會一起刪除其 deployments、domains、environment variables 與 settings。因而自動到期不能只被理解成「清掉舊網址」;若 demo 誤用了正式網域、共用 secret 或唯一的測試資料入口,時間到後的影響可能跨出展示本身。
適合使用的情境包括提案 prototype、課程練習、一次性活動 demo、可重新產生的 QA sandbox,以及每次都建立獨立 project 的臨時 agent 任務。正式網站、長期 staging、需要固定 callback URL 的 OAuth 測試環境、客戶仍在驗收的站台,或保存唯一資料的服務,不應只靠預估天數自動刪除。
如果需求只是讓每個 pull request 有隔離網址,優先使用既有 project 的 Preview Deployment。它能沿用 project 設定與 Git 整合,也不會為每個分支建立新的 project。只有需要完全隔離 project-level environment、domain、權限或設定時,才值得建立到期 project。
CI 導入先防止誤連既有專案
最小指令可以是 vercel deploy --delete-project-after 1d,但 CI 還要處理 project linking。Vercel CLI 會在本機 .vercel 目錄保存 project 與 organization ID;若 pipeline 重用了 workspace、cache 或 repository 內不該存在的連結資料,原本想建立短命 project 的 job 可能改為部署到既有 project,這時 expiration 不會設定成功。
建立 job 前先確認執行目錄、team scope、project name 與 .vercel 來源。將 CLI 版本鎖在 package 或 runner,不依賴浮動最新版;檢查 exit code 與 stderr 中的 warning,並保存 CLI 印出的到期日期與時間。部署成功不等於 expiration 已套用,pipeline 要把「建立了新 project」與「既有 project 未變更」分成不同結果。
自動產生名稱時加入 repository、branch、工單或建立日期,並在 metadata 或外部 inventory 記錄 owner、用途、到期時間與正式 project 連結。名稱仍要避免放入客戶個資、機密專案代號或 token。若一天建立大量 project,還應設定並行上限與失敗清理,避免 job 在寫入 inventory 前中斷而留下孤兒資源。
Secret、資料與外部整合要能一起退場
短命 project 不應複製整套 production secrets。建立專用、最小權限且可撤銷的測試憑證,資料庫使用隔離 schema 或 disposable database,第三方 webhook 與 OAuth callback 也標記 owner 與到期日。Project 被刪除不代表外部供應商的 API key、DNS record、測試帳號或資料庫會自動消失。
在建立與清理流程中維護外部資源清冊。到期前或刪除 webhook 觸發時,撤銷專用 token、移除第三方 callback、刪除測試資料並保存必要稽核紀錄。若沒有可靠的 project deletion event,可用排程對照 inventory 與 Vercel project list;但不要在未確認 owner 的情況下自動刪除未知 project。
前端 demo 若完全無後端狀態,清理相對簡單;包含資料庫、queue、Blob 或外部 SaaS 的系統,應把 project 到期視為整個環境生命週期的一部分。Vercel 功能只負責 Vercel project,不能取代跨供應商的 teardown orchestration。
保留與到期前提醒
官方提供 vercel project keep 讓團隊在到期前取消 expiration。保留不應由任何看見網址的人決定,而要有明確 owner、原因與新的檢查日期。例如客戶驗收延期時,先確認 secrets 與資料仍符合保留政策,再執行 keep;之後把它納入長期 staging 或重新設定外部清理日期。
建立 24 小時與數小時前的提醒,通知 project owner、建立工單與相關 reviewer。提醒內容應包含 project、正式 URL、到期時間、外部資源及 keep 的批准方式。不能只寄給最初建立者,因為休假或離職會讓無人接手的 demo 在驗收中消失。
若誤刪風險高,先從一小時或一天、完全可重建的內部 sandbox 試行。驗收應包含自動到期、手動 keep、對既有 project 使用旗標時的 warning、失敗 job 清理,以及刪除後外部 secret 是否撤銷。不要直接在唯一的客戶測試站第一次驗證。
怎麼選擇 Preview、到期 Project 或長期 Staging
同一產品的 PR 檢查通常選 Preview Deployment;需要 project-level 隔離且可重建的 prototype,選到期 project;需要固定網域、長期資料、監控與多人共用的環境,選受治理的 staging。三者的差異不是網址長得像不像正式站,而是設定邊界、資料生命週期與誰負責清理。
到期時間應比工作期限多出合理緩衝,但不以最長 30 天作為預設。一天內完成的 agent demo 可用一日,短 sprint 驗證可用一或兩週;若一開始就知道會持續一個月以上,應重新判斷它是否已是長期環境。
完成條件包括:CLI 版本已固定、只對新 project 套用旗標、pipeline 能辨識 warning、每個到期 project 有 owner 與外部資源清冊、keep 有審批流程,且刪除後不留下仍有效的 secret 或測試資料。自動刪除能降低資源漂移,但只有搭配完整環境治理,才不會把「免手動清理」變成「到期才發現重要設定一起消失」。