把 Vercel 部署儲存空間從 13.96 GB 降到 20.27 MB — 關閉預覽、縮短保留期
Vercel Hobby 方案的部署儲存空間超過了 10 GB 上限。問題出在部署次數:每次部署會增加 147 MB,而三十天內部署了 189 次。

本頁目錄
引言
Vercel 的用量頁面在 Deployment Storage 旁邊顯示了一個紅圈:免費額度 10 GB,用掉 13.96 GB。同一個帳戶裡,其他項目沒有一項超過上限的 20%。

我第一個想知道的是線上網站會不會受影響。答案是不會。不過一直超過上限還是有代價的:Vercel 不再等滿 30 天的保留期,而是直接刪掉符合條件的部署,在用量回到額度以內之前也可能拒絕新的部署。
我一開始懷疑的是 repo,畢竟這裡每篇文章都帶著圖表和截圖。然而 repo 打包後只有 9.79 MiB,所有影像和影片加起來也才 9.4 MB。這個網站部署一次用掉的空間是 147 MB,而三十天內共部署了 189 次。
關掉預覽建置、把保留期縮到一天,再在發布流程的開頭加上一步清理舊部署,Deployment Storage 就降到了 20.27 MB。
讀懂配額:一次建置 147 MB,repo 9.79 MiB
Deployment Storage 量的是每次部署所保留的建置產物,在這個網站上大約是 repo 本身的 15 倍大。
兩個數字各用一行指令就能拿到。
輸入git count-objects -vH | grep size-pack輸出size-pack: 9.79 MiB輸入du -sm .vercel/output輸出147 .vercel/output配額算的是第二個數字 .vercel/output,也就是 vercel build 產生、vercel deploy --prebuilt 上傳的內容。部署端的檔案樹有 2847 個檔案,本機是 2843 個,可見傳輸過程中沒有多出什麼實質內容。
147 MB 分布在哪裡
每次部署有一半是伺服器 bundle,而這一半裡面有 20 MB 是伺服器 bundle 的第二份複本。
static/_astro 則是三種語系共 893 個影像衍生檔。_render.func 裡面有 29 MB 的 node_modules,也就是 Astro 的伺服器執行環境,加上文章頁在算繪時會引入的一切。static/_astro 是 Astro 寫出處理後影像的位置,那 893 個檔案,是同一批原始圖片在三種語系下產生的衍生檔。
把影像搬到外部為什麼只能省下 6%
這個 repo 裡所有影像和影片加起來是 9.4 MB,所以就算全部搬去物件儲存的 bucket,能省下的空間也只有一次部署的十六分之一。
輸入find src -type f \( -name '*.mp4' -o -name '*.png' -o -name '*.jpg' -o -name '*.webp' -o -name '*.avif' \) -exec du -ch {} + | tail -1輸出9.4M total配額算的是 static/_astro,那些衍生檔是建置時從原始圖片產生的。把原圖改由 bucket 提供,只是把 9.4 MB 移出 git,33 MB 的衍生檔照樣留在每次部署裡。
就算我能夠把 147 MB 砍成一半,佔用 Deployment Storage 的空間還是會隨著部署次數一路疊加上去,因此管理單次部署的大小並非解決問題的關鍵。
三十天內 189 次部署
儲存空間等於建置大小乘以部署次數,而我之前從來沒去關注過部署次數這一項。
GitHub 會為每次部署留下紀錄,所以次數是從 repo 而不是從 Vercel 取得的。
gh api "repos/<owner>/<repo>/deployments?per_page=100" --paginate把最近三十天的紀錄依建立者分組,vercel[bot] 對 Preview 環境建立了 122 次,這個 repo 自己的 CI 對 production 建立了 67 次。
以每次 147 MB 計算,189 次部署等於一個月內往 10 GB 的額度裡灌進 27.8 GB。
沒人打開過的 122 個預覽
189 次部署裡有三分之二,是早已合併並刪除的分支所留下的預覽,而且每一個都是自動建立的。
帳戶超額當時還存活的四個預覽部署說明了原因。每一個都是某個分支的最新預覽,而那些分支都已經在 squash 合併後被刪掉,git ls-remote --heads origin 一個也列不出來。
Vercel 會保留「仍在使用中」的分支的最新預覽,卻沒有察覺那四個分支早就不存在了。
關掉預覽、縮短保留期,再清理一次
三個設定,分別對著乘積裡的一項:部署被建立的頻率、被保留的時間,以及此刻還擺在那裡的數量。
關掉 Git 整合
Vercel 的 Git 整合預設會替每一次 push 建立一個部署,不分分支,而每個部署都佔用 147 MB 的 Deployment Storage。
這個網站不需要那些自動部署:production 環境是由 GitHub Actions 部署的,其他分支的部署也都不需要。
{ "git": { "deploymentEnabled": false }}git.deploymentEnabled: false 會停掉 Git 整合在所有分支上自動建立的部署,包括 main。
保留期是 Project Settings 裡的四個下拉選單
保留期設定在 Vercel 的控制台,位於 Project Settings 的 Build and Deployment 底下,名稱是 Deployment Retention Policy。這個帳戶裡的每個專案都停在方案的預設值。
| 部署類型 | 變更前 | 變更後 |
|---|---|---|
| Canceled | 30 天 | 1 天 |
| Errored | 30 天 | 1 天 |
| Pre-Production | 30 天 | 1 天 |
| Production | 30 天 | 1 天 |
30 天是 Hobby 方案的上限,所以預設值同時也是保留最久、清得最慢的設定。四項全部改成最短的一天。

Pre-Production Deployments 那一列。這裡沒有設定要保留幾個部署的欄位。在 Hobby 方案上,vercel usage 什麼都報不出來。
輸入pnpm dlx vercel@58 usage輸出Error: Billing cost data is unavailable for 2026-09-01 through 2026-09-21.Hobby 方案沒有帳務紀錄,CLI 也就無從讀起。GB 這個數字只存在於控制台。
--safe 保住什麼,又刪掉什麼
vercel remove <project> --safe 刪除的是部署;同一條指令少了 --safe,刪掉的就是整個專案。
輸入pnpm dlx vercel@58 remove oharu-tech-blog --safe --yes輸出> Found 8 deployments for removal in oharu121s-projects [1s]> Success! Removed 8 deployments [909ms]然而 --safe 會跳過持有別名的部署,因此有四個持有分支別名的預覽也一起被留了下來。
--safe 刪掉的八個部署,和 --safe 放過的四個預覽。預覽的分支別名活得比別名指向的分支還久,所以第二次清理要逐一指名部署。十三個部署刪掉八個,剩下五個:線上那個正式部署,加上四個分支早就沒了的預覽。確認過分支真的不在之後,這四個只能用 URL 逐一指名刪除。
輸入pnpm dlx vercel@58 remove <url> <url> <url> <url> --yes輸出> Found 4 deployments for removal in oharu121s-projects [934ms]> Success! Removed 4 deployments [731ms]清理該放在發布流程的哪裡
清理要放在發布流程的開頭。放在結尾的話,production 環境才剛換上新版本,舊的那個部署就被刪掉了,想回滾也沒得回。
從 13.96 GB 到 20.27 MB

我做了三件事讓 Deployment Storage 從 13.96 GB 降到了 20.27 MB:關掉 Git 整合的自動部署、把四種保留期都改成一天,再用 vercel remove 把堆積的部署清掉。
Hobby 方案的第二個上限:一天 5,000 次上傳
關掉 Git 整合之後,所有 production 環境部署都改由 GitHub Actions 執行 vercel deploy --prebuilt。這個指令會把 .vercel/output 裡每個有變更的檔案,各用一個請求分別上傳。Hobby 方案一天只接受 5,000 次,在一天發布了八次的那天,第七次部署就被拒絕了:
Uploading [--------------------] (0.0B/85.7MB)Error: Too many requests - try again in 24 hours (more than 5000, code: "api-upload-free").Try using `--archive=tgz` to limit the amount of files you upload.建置本身通過了,失敗的只有上傳,所以 production 環境停留在上一個版本,網站上也看不出任何異常。這個上限是以帳號擁有者為單位計算,而不是以專案為單位,所以同一個帳號底下的所有專案共用同一個 5,000 次的額度。
於是我加上了錯誤訊息建議的旗標:
url=$(pnpm dlx "$VERCEL_CLI" deploy --prebuilt --prod --token="$VERCEL_TOKEN")url=$(pnpm dlx "$VERCEL_CLI" deploy --prebuilt --prod --archive=tgz --token="$VERCEL_TOKEN")--archive=tgz 會把建置輸出打包成封存檔上傳,而不是每個檔案各發一個請求。加上之後,下一次部署在同一天、額度仍然用完的情況下順利通過了。代價是 Vercel 無法再略過伺服器上已經有的檔案,所以每次部署都會上傳完整的 86 MB。
這 86 MB 已經接近下一個上限。根據 Vercel 的限制說明,Hobby 方案透過 CLI 部署時,上傳的檔案上限是 100 MB。
總結
部署儲存空間等於建置大小乘以部署次數,而比較容易判斷錯的是次數。這個帳戶有十個專案、185 個存活的部署、147 MB 的建置,而 repo 小到對總量沒有影響。
要分辨 Deployment Storage 超額是儲存空間的問題還是 repo 的問題,有三個檢查。du -sm .vercel/output 給出一次部署的大小,平台自己的部署紀錄給出次數,兩者的乘積對上額度,就能決定應該要把部署變小,還是要減少部署次數。
如果問題出在次數,我們能做三件事:用 git.deploymentEnabled: false 關閉 Vercel 的自動部署、縮短舊部署的保留時間,以及用 vercel remove --safe 手動刪除已經不需要的舊部署。能立竿見影的方法只有最後一個,而且我們應該把它放在整個發布流程的開頭,而不是結尾。
改從 CI 部署之後,就會受到 Hobby 方案的第二個上限影響,也就是每個帳號一天 5,000 次檔案上傳。加上 --archive=tgz,就能讓 --prebuilt 部署維持在這個上限之內。
參考連結
- Vercel: Deployment Storage(這個指標算什麼,以及保留的例外)
- Vercel: Optimize deployment storage
- Vercel: Git configuration(deploymentEnabled 的布林值與分支物件兩種寫法)
- Vercel changelog: Hobby projects now retain fewer deployments to free up storage
- Vercel: Limits(含 api-upload-free 速率限制與 CLI 上傳的 100 MB 上限)
- Vercel CLI: vercel deploy(含
--archive選項)





