mcpField
T
tinyship-deploy

tinyship-deploy

github.com/tinyshipcn云与 DevOps576 次安装1 周前更新
代码仓库

关于 tinyship-deploy

面向 TinyShip 生产部署的技能，帮助团队选择部署平台并完成上线检查，涵盖 Docker、Vercel、Cloudflare Workers 和 VPS。

主要功能

  1. 01部署平台选择指引
  2. 02生产环境检查清单
  3. 03Docker 部署步骤
  4. 04Vercel 部署步骤
  5. 05Cloudflare Workers 指引
  6. 06VPS 部署指引

适用场景

  1. 01为 TinyShip 选择托管平台
  2. 02上线前核对生产环境设置
  3. 03将 TanStack Start 应用部署到 Cloudflare Workers

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/tinyshipcn/tinyship-skills --skill tinyship-deploy

安装后在 Claude Code 中输入/tinyship-deploy确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
cloudflare-deploy.md
docker-deploy.md
vercel-deploy.md

详细介绍

TinyShip 部署

将 TinyShip 部署到生产环境的指南。

选择平台

询问用户更倾向于哪种部署目标：

平台最适合框架支持
Docker自托管、完全掌控全部 3 个框架
VercelNext.js 项目、零配置Next.js（推荐）
Cloudflare Workers边缘部署、全球覆盖仅 TanStack Start
VPS（PM2 + Nginx）传统托管全部 3 个框架

然后阅读相关参考文件并按照步骤操作。

部署前检查清单（所有平台）

部署前，请确保：

  1. 生产数据库已就绪（推荐 PostgreSQL）
  2. 环境变量已设置为生产环境所需值：
    • APP_BASE_URL — 你的生产域名（例如：https://app.example.com）
    • BETTER_AUTH_URL — 与 APP_BASE_URL 相同
    • BETTER_AUTH_SECRET — 强随机密钥（使用 openssl rand -hex 32 生成）
    • DATABASE_URL — 生产数据库连接字符串
  3. OAuth 重定向 URI已更新为生产域名
  4. 支付 Webhook URL已更新为生产域名
  5. 数据库已迁移：针对生产数据库运行 pnpm db:push

Docker 部署

阅读 references/docker-deploy.md 查看完整步骤。

快速摘要：

# Build and run with Docker Compose
docker compose --profile next up -d  # or --profile nuxt / --profile tanstack

# Or build individual image
docker build -f apps/next-app/Dockerfile -t tinyship .

Vercel 部署

阅读 references/vercel-deploy.md 查看完整步骤。

快速摘要：

  1. 推送到 GitHub
  2. 在 Vercel Dashboard 中导入项目
  3. 将根目录设为 apps/next-app
  4. 配置环境变量
  5. 部署

Cloudflare Workers

阅读 references/cloudflare-deploy.md 查看完整步骤。

仅适用于 TanStack Start。使用 D1 数据库和 Wrangler CLI。 阅读 apps/tanstack-app/CF-NOTES.md 了解已知问题。

VPS（PM2 + Nginx）

阅读 TinyShip 仓库中的 docs/user-guide/deployment/traditional.md。

快速摘要：

  1. 构建应用：pnpm build:next（或 nuxt/tanstack）
  2. 安装 PM2：npm install -g pm2
  3. 使用 PM2 启动：pm2 start .output/server/index.mjs --name tinyship
  4. 配置 Nginx 反向代理到端口 7001
  5. 使用 Let's Encrypt 配置 SSL

部署后

部署完成后：

  1. 验证运行状况：curl https://yourdomain.com/api/health
  2. 测试登录流程
  3. 更新所有提供商的 OAuth 重定向 URI
  4. 更新支付 Webhook URL
  5. 如果已配置支付功能，运行一笔测试支付
  6. 设置监控/告警

TinyShip 仓库中的参考文件

  • docs/user-guide/deployment/overview.md — 部署文档索引
  • docs/user-guide/deployment/docker.md — Docker 部署指南
  • docs/user-guide/deployment/cloud.md — 云平台指南
  • docs/user-guide/deployment/cloudflare-workers.md — CF Workers 指南
  • docs/user-guide/deployment/traditional.md — VPS/PM2 指南
  • docker-compose.yml — Docker Compose 配置
  • apps/tanstack-app/CF-NOTES.md — Cloudflare Workers 注意事项
  • apps/tanstack-app/wrangler.jsonc — Wrangler 配置

评论

支持 Markdown