Vista.js 部署終極指南一條命令上線 Vercel、Cloudflare、Netlify 等 5 大平臺(tái)【免費(fèi)下載鏈接】vista項(xiàng)目地址: https://gitcode.com/gh_mirrors/vista13/vistaVista.js是一款面向 React 19 的全?？蚣芩淖畲罅咙c(diǎn)之一是部署體驗(yàn)?zāi)阒恍枰粭lnpm run deploy命令就能把應(yīng)用發(fā)布到Render、Docker、Vercel、Cloudflare、Netlify這 5 大平臺(tái)SSR、Server Actions、Typed API 全部開(kāi)箱可用。本文將帶你快速看懂 Vista.js 部署機(jī)制并完成第一次上線。為什么 Vista.js 部署如此簡(jiǎn)單Vista.js 的設(shè)計(jì)目標(biāo)是本地與生產(chǎn)零差異構(gòu)建時(shí)產(chǎn)出一個(gè)獨(dú)立的 Node Flight 服務(wù)器.vista/standalone各平臺(tái)部署本質(zhì)上只是把這個(gè)服務(wù)器包裝成目標(biāo)平臺(tái)能運(yùn)行的形態(tài)目標(biāo)平臺(tái)運(yùn)行形態(tài)完整 SSR / Actions / Typed APIrenderNode standalone 長(zhǎng)駐服務(wù)?dockerNode standalone 容器?vercelNode serverlessBuild Output v3?cloudflareContainersDocker 鏡像?netlifyNode Function 包裹 standalone 服務(wù)?也就是說(shuō)無(wú)論選擇哪個(gè)平臺(tái)代碼都不用改。完整的能力對(duì)照見(jiàn) platform-matrix.md。一鍵安裝步驟先本地跑通再上線部署前確保應(yīng)用可以正常構(gòu)建。在應(yīng)用根目錄執(zhí)行npm run build # 產(chǎn)物輸出到 .vista/ npm run deploy # 自動(dòng)檢測(cè)平臺(tái)并發(fā)布如果省略--target參數(shù)Vista.js 會(huì)按以下順序自動(dòng)檢測(cè)部署目標(biāo)見(jiàn) detect.tsvista.config.ts中的deploy.target平臺(tái)環(huán)境變量VERCEL、CF_PAGES、RENDER、NETLIFY項(xiàng)目里已有的平臺(tái)文件render.yaml、vercel.json、wrangler.toml等這正是一條命令上線能成立的秘密——你在 Vercel 的 CI 里跑npm run deploy它自己就知道要按 Vercel 的方式打包。5 大平臺(tái)部署速查清單每個(gè)平臺(tái)的完整命令都遵循同一模式--target后面跟上目標(biāo)即可npm run deploy -- --target render --prod # Render npm run deploy -- --target docker --prod # Docker npm run deploy -- --target vercel --prod # Vercel npm run deploy -- --target cloudflare --prod # Cloudflare npm run deploy -- --target netlify --prod # Netlify常用選項(xiàng)還有--preview發(fā)布預(yù)覽/預(yù)發(fā)環(huán)境--dry-run只構(gòu)建、生成產(chǎn)物并校驗(yàn)不真正上線新手強(qiáng)烈建議先跑一遍--force覆蓋已生成的平臺(tái)配置文件--skip-build復(fù)用已有.vista構(gòu)建產(chǎn)物各目標(biāo)的具體機(jī)制與產(chǎn)物分別見(jiàn) vercel-deployment.md、cloudflare-deployment.md、netlify-deployment.md 和 render-deployment.md。VercelNode serverless 函數(shù)打包--target vercel會(huì)把獨(dú)立服務(wù)器打包成 Build Output API v3靜態(tài)資源走 CDN請(qǐng)求兜底進(jìn) Node 20 serverless 函數(shù)默認(rèn) 1024MB 內(nèi)存、60 秒超時(shí)、支持流式響應(yīng)。在 Vercel 后臺(tái)走 Git 部署也可以——只要構(gòu)建命令寫npm run build檢測(cè)到VERCEL1時(shí) Vista.js 會(huì)自動(dòng)生成.vercel/output。Cloudflare為什么用 Containers 而不是 WorkersVista.js 的 Flight 架構(gòu)需要雙進(jìn)程運(yùn)行依賴child_process而 Cloudflare Workers 不支持。因此完整 SSR 走Cloudflare Containers部署命令會(huì)生成Dockerfile、wrangler.toml和啟動(dòng)容器的 Durable Object之后執(zhí)行npx wrangler deploy --prod即可。若賬戶未開(kāi)通 Containers同一個(gè) Docker 鏡像也能直接跑在 Fly、Railway、Render 等任意 Docker 主機(jī)上。Netlify 與 Render同構(gòu)的 standalone 服務(wù)Netlify生成netlify/functions/ssr.js函數(shù)內(nèi)部調(diào)用與 Render/Docker 完全相同的createRequestListener()HTML 可以流式輸出。Render生成render.yamlBlueprint構(gòu)建npm run build、啟動(dòng)node .vista/standalone/server.js、端口 3003在 Render 面板連接倉(cāng)庫(kù)并應(yīng)用 Blueprint 即可。本倉(cāng)庫(kù)根目錄就有一份可用的 render.yaml 作為參考。 小貼士免費(fèi)版 Render 服務(wù)空閑后會(huì)休眠官方文檔給出了定時(shí) ping 的工作流方案詳見(jiàn) render-deployment.md 的 Keep Free Render Service Awake 一節(jié)。最快配置方法純靜態(tài)站點(diǎn)模式如果你的應(yīng)用只是官網(wǎng)、文檔站或營(yíng)銷頁(yè)完全不需要請(qǐng)求時(shí) SSR可以讓 Vista.js 只產(chǎn)出預(yù)渲染的靜態(tài)站點(diǎn)托管到任意 CDN// vista.config.ts export default { deploy: { target: vercel, // 或 cloudflare / netlify output: static, }, };再執(zhí)行對(duì)應(yīng)平臺(tái)的npm run deploy -- --target 平臺(tái) --prodVista.js 會(huì)輸出純靜態(tài)文件如 Cloudflare 走wrangler pages deploy。這是營(yíng)銷頁(yè)上線成本最低的方案。部署失敗先看這 3 處先跑--dry-run它只做構(gòu)建、產(chǎn)物生成和校驗(yàn)不會(huì)真的發(fā)布能幫你定位 90% 的配置問(wèn)題。CLI 未登錄不是終點(diǎn)Vista.js 的策略是平臺(tái) CLIvercel/wrangler/netlify/docker可用就自動(dòng)調(diào)用即使 CLI 缺失或鑒權(quán)失敗也會(huì)先輸出部署產(chǎn)物并打印手動(dòng)發(fā)布命令照著執(zhí)行即可完成上線。檢查產(chǎn)物路徑.vista/standalone服務(wù)器、.vercel/outputVercel、netlify/functionsNetlify、.vista/deploy/cloudflareCloudflare 靜態(tài)。產(chǎn)物結(jié)構(gòu)不對(duì)通常是構(gòu)建階段的問(wèn)題先重新npm run build。部署命令的完整參數(shù)說(shuō)明見(jiàn) vista-deploy-command.md命令入口源碼在 cli-runner.ts5 個(gè)平臺(tái)適配器分別位于 packages/vista/src/deploy/adapters/。總結(jié)一條命令5 個(gè)平臺(tái)0 份額外配置你的場(chǎng)景推薦目標(biāo)完整 Vista 全棧應(yīng)用SSR API 認(rèn)證vercel/render/netlify/ Cloudflare Containers營(yíng)銷頁(yè)、文檔站純 SSG任意平臺(tái) deploy.output: static本地與生產(chǎn)環(huán)境一致docker現(xiàn)在回到你的終端敲下npm run build npm run deploy——你的 Vista.js 應(yīng)用距離上線只差一次回車。??【免費(fèi)下載鏈接】vista項(xiàng)目地址: https://gitcode.com/gh_mirrors/vista13/vista創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考