Dokploy 部署

Dokploy 是自托管部署平台，提供可视化面板与 Git 驱动部署能力，适合需要自建运维的团队。

前置条件

• Linux VPS（root 权限）
• 已安装 Docker
• 域名（推荐配置 HTTPS）
• Git 仓库访问权限

安装 Dokploy

请参考 Dokploy 官方安装文档，快速安装脚本如下：

curl -sSL https://dokploy.com/install.sh | sh

安装前请确保端口 80、443 和 3000 可用。

创建项目

1. 打开 Dokploy 控制台（默认：http://your-server-ip:3000）
2. 创建新项目
3. 绑定你的 Git 仓库

配置构建与启动

TinyShip 建议配置如下：

• Root Directory: apps/next-app 或 apps/nuxt-app
• Install Command: pnpm install
• Build Command: pnpm run build
• Start Command: pnpm run start:next 或 pnpm run start:nuxt
• Port: 使用项目实际运行端口（默认：7001）

环境变量

在 Dokploy 控制台中添加必要环境变量：

DATABASE_URL="postgresql://..."
BETTER_AUTH_SECRET="your-32-char-secret"
BETTER_AUTH_URL="https://yourdomain.com"

数据库与迁移

准备生产数据库并执行迁移：

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

部署与验证

1. 在 Dokploy 中点击 Deploy
2. 配置域名与 HTTPS
3. 访问健康检查端点：/api/health

故障排除

如部署失败，请检查：

• Dokploy 控制台构建日志
• 环境变量与数据库连接
• 端口暴露与域名路由
• 健康检查端点可访问

返回 部署概览