TinyShip
TinyShip
TinyShip
TinyShip
TinyShip 文档中心
TinyShip 用户指南快速开始基础配置
积分系统配置指南
存储服务配置验证码配置
应用部署云平台部署Cloudflare Workers 部署Dokploy 部署Docker 部署传统部署
开发最佳实践本地 E2E 测试流程
用户指南应用部署

应用部署

TinyShip 部署指南

TinyShip 支持多种部署方式，您可以根据需求选择适合的方案。

部署方式对比

部署方式适用场景优点缺点难度
云平台部署生产环境自动扩展、免运维可能有供应商锁定简单
Cloudflare WorkersTanStack Start 边缘部署全球加速、冷启动极快、免运维仅限 TanStack，数据库需 Hyperdrive简单
Dokploy 部署生产环境自托管、Git 驱动部署需要维护服务器中等
Docker 部署容器化环境环境一致、易扩展需要 Docker 知识中等
传统部署开发/测试环境简单直接、版本控制方便服务器需要开发环境、构建慢复杂

推荐方案

  • 生产环境推荐: 云平台部署、Dokploy 部署 或 Docker 部署
  • 全球边缘加速: Cloudflare Workers（仅限 TanStack Start）
  • 开发/测试环境: 传统部署
  • 快速验证: 传统部署

部署前准备

无论选择哪种部署方式，都需要完成以下准备：

  1. 配置生产环境变量
  2. 设置生产数据库
  3. 配置域名和 SSL 证书
  4. 更新回调 URL 为生产域名

环境变量清单

.env
# 必需配置
DATABASE_URL="postgresql://..."
BETTER_AUTH_SECRET="your-32-char-secret"
BETTER_AUTH_URL="https://yourdomain.com"

# 根据功能需要配置
STRIPE_SECRET_KEY="sk_live_..."
STRIPE_WEBHOOK_SECRET="whsec_..."
OPENAI_API_KEY="sk-..."

通用准备工作

  1. 环境变量配置

    # 复制环境变量模板
cp .env.example .env
# 编辑配置实际的生产环境变量

  2. 数据库准备

    pnpm db:generate
pnpm db:migrate
pnpm db:check

  3. 健康检查

    • Next.js: http://your-domain/api/health
    • Nuxt.js: http://your-domain/api/health
    • TanStack Start: http://your-domain/api/health

选择部署方式

云平台部署

Vercel、Netlify、Railway 一键部署

Dokploy 部署

自托管平台，支持 Git 驱动部署

Cloudflare Workers

TanStack Start 全球边缘部署

Docker 部署

使用 Docker Compose 容器化部署

传统部署

VPS 服务器 PM2 部署

快速命令对比

操作传统部署Docker 部署Dokploy 部署云平台部署Cloudflare Workers
构建pnpm build:nextdocker build -t tinyship-next .自动构建自动构建vite build
启动pnpm start:nextdocker compose --profile next up -d自动部署自动部署wrangler deploy
查看日志pm2 logs tinyship-nextdocker compose logs -f控制台日志平台控制台wrangler tail
重启pm2 restart tinyship-nextdocker compose restart控制台重启平台控制台wrangler deploy

特性支持对比

特性传统部署Docker 部署Dokploy 部署云平台部署Cloudflare Workers
环境隔离否是是是是
自动重启是 (PM2)是是是是
水平扩展否手动配置手动配置是是（自动）
零停机部署否手动配置手动配置是是
自动备份否否否是否
监控告警手动配置手动配置手动配置是是
全球边缘否否否部分是

部署检查清单

部署前检查

  • 环境变量已配置 (.env)
  • 数据库连接正常 (pnpm db:check)
  • 所有依赖已安装 (pnpm install)
  • 应用能正常构建 (pnpm build:next 或 pnpm build:nuxt)

部署后验证

  • 应用能正常访问
  • 健康检查端点正常 (/api/health)
  • 数据库操作正常
  • 静态资源加载正常
  • 认证功能正常

生产环境额外检查

  • HTTPS 证书有效
  • 日志记录正常
  • 监控和告警配置
  • 备份策略实施
  • 性能优化完成

获取帮助

遇到问题？查看对应部署方式的故障排除章节：

  • 传统部署故障排除
  • Docker 部署故障排除
  • Dokploy 部署故障排除
  • 云平台部署故障排除
  • Cloudflare Workers 故障排除

验证码配置

配置人机验证功能

云平台部署

部署到 Vercel、Netlify、Railway 等云平台

On this page

部署方式对比推荐方案部署前准备环境变量清单通用准备工作选择部署方式快速命令对比特性支持对比部署检查清单部署前检查部署后验证生产环境额外检查获取帮助