TanStack Start 部署指南：Cloudflare、Netlify、Vercel、Bun

将 TanStack Start 应用部署到各种托管平台。TanStack Start 基于 Vite 构建，支持部署到任何托管提供商。

支持的部署平台

Cloudflare Workers（官方合作伙伴）
Netlify（官方合作伙伴）
Nitro（通用层）
Vercel
Railway
Node.js
Bun
Appwrite Sites

Cloudflare Workers 部署

bash

pnpm add -D @cloudflare/vite-plugin wrangler

// vite.config.ts
import { cloudflare } from '@cloudflare/vite-plugin'

export default defineConfig({
  plugins: [
    cloudflare({ viteEnvironment: { name: 'ssr' } }),
    tanstackStart(),
    viteReact(),
  ],
})

json

// wrangler.jsonc
{
  "$schema": "node_modules/wrangler/config-schema.json",
  "name": "tanstack-start-app",
  "compatibility_date": "2025-09-02",
  "compatibility_flags": ["nodejs_compat"],
  "main": "@tanstack/react-start/server-entry"
}

bash

npx wrangler login
pnpm run deploy

Netlify 部署

bash

pnpm add --save-dev @netlify/vite-plugin-tanstack-start

import netlify from '@netlify/vite-plugin-tanstack-start'

export default defineConfig({
  plugins: [tanstackStart(), netlify(), viteReact()],
})

bash

npx netlify deploy

Bun 部署

需要 React 19+：

bash

bun install react@19 react-dom@19

export default defineConfig({
  plugins: [tanstackStart(), nitro({ preset: 'bun' }), viteReact()],
})

bash

bun run build
bun run server.ts

Bun 服务器环境变量

变量	说明	默认值
`PORT`	服务器端口	`3000`
`ASSET_PRELOAD_MAX_SIZE`	预加载最大文件大小	`5242880` (5MB)
`ASSET_PRELOAD_ENABLE_ETAG`	启用 ETag	`true`
`ASSET_PRELOAD_ENABLE_GZIP`	启用 Gzip	`true`

Appwrite Sites 部署

创建 TanStack Start 应用
推送到 GitHub 仓库
创建 Appwrite 项目
在 Sites 页面连接仓库并部署

部署平台对比

平台	优势	适用场景
Cloudflare Workers	全球边缘网络、低延迟	全球用户、高流量应用
Netlify	简单易用、一键部署	快速原型、个人项目
Vercel	优秀的开发者体验	React 生态项目
Bun	高性能、低资源占用	性能敏感应用
Node.js	兼容性好、生态丰富	传统部署环境

字节笔记本

TanStack Start 部署指南：Cloudflare、Netlify、Vercel、Bun

支持的部署平台

Cloudflare Workers 部署

Netlify 部署

Bun 部署

Bun 服务器环境变量

Appwrite Sites 部署

部署平台对比