Zeabur 是一款国产的云部署平台，类似 Vercel/Railway，但对国内用户更友好。支持一键部署前端应用、后端服务、数据库，无需管理服务器，按量付费。

为什么选择 Zeabur

快速开始

1. 注册登录

1. 访问 zeabur.com
2. 使用 GitHub 账号登录
3. 创建项目（Project）

2. 部署服务

Zeabur 支持多种部署方式：

Git 仓库部署：

1. 项目中点击「添加服务」
2. 选择「Git」→ 授权 GitHub
3. 选择仓库和分支
4. Zeabur 自动检测并部署

模板部署：

1. 选择「模板」
2. 浏览并选择需要的应用
3. 一键部署

Docker 镜像部署：

1. 选择「Docker 镜像」
2. 输入镜像地址
3. 配置端口和环境变量

3. 支持的技术栈

前端：
- Next.js / Nuxt / Astro
- React / Vue / Svelte
- Vite / CRA

后端：
- Node.js / Bun / Deno
- Python / Go / Rust
- Java / PHP / Ruby

数据库：
- PostgreSQL / MySQL
- MongoDB / Redis
- Dragonfly

服务管理

部署配置

每个服务可单独配置：

环境变量

服务设置 → 环境变量 → 添加变量

DATABASE_URL=postgres://user:pass@host:5432/db
API_KEY=sk-xxxxx
NODE_ENV=production

支持从 .env 文件批量导入。

服务间通信

同一项目内的服务可通过内网通信：

# 数据库连接示例
DATABASE_URL=postgres://user:pass@postgresql.zeabur.internal:5432/db

# 服务名 + .zeabur.internal

内网通信无需暴露公网，更安全且免流量费。

数据库服务

Zeabur 提供一键部署的数据库服务：

PostgreSQL

1. 添加服务 → PostgreSQL
2. 自动生成连接信息
3. 在其他服务中引用变量

连接变量自动注入：

POSTGRES_HOST
POSTGRES_PORT
POSTGRES_USERNAME
POSTGRES_PASSWORD
POSTGRES_DATABASE
POSTGRES_URI  # 完整连接字符串

Redis

1. 添加服务 → Redis
2. 获取连接信息

REDIS_HOST
REDIS_PORT
REDIS_PASSWORD
REDIS_URI

MongoDB

1. 添加服务 → MongoDB
2. 配置用户名密码

自定义域名

添加域名

1. 服务设置 → 域名
2. 点击「添加域名」
3. 输入自定义域名

DNS 配置

添加 CNAME 记录：

类型: CNAME
名称: @ 或 www
值: <region>.zeabur.app

例如香港区域：hkg.zeabur.app

免费域名

每个服务可获得免费的 .zeabur.app 子域名。

Serverless 部署

Zeabur 支持两种运行模式：

容器模式（默认）

• 服务持续运行
• 适合后端服务、WebSocket
• 按运行时间计费

Serverless 模式

• 按请求触发
• 无请求时不计费
• 适合 API、定时任务

服务设置 → 启用 Serverless

预构建镜像

对于构建时间长的项目，可使用预构建：

# Dockerfile
FROM node:20-alpine
WORKDIR /app
COPY . .
RUN npm install && npm run build
CMD ["npm", "start"]

配置 Zeabur 使用 Dockerfile 构建。

持久化存储

默认情况下，服务重启数据会丢失。需要持久化时：

服务设置 → 存储 → 添加持久化卷

挂载路径示例：

/app/data      # 应用数据
/var/lib/mysql # MySQL 数据

监控与日志

实时日志

服务详情 → 日志

支持搜索、过滤、下载。

资源监控

服务详情 → 监控

查看 CPU、内存、网络使用情况。

部署历史

服务详情 → 部署

查看历史部署，支持回滚。

定价

Zeabur 采用按量付费：

免费额度：

• 新用户赠送 $5 余额
• 每月免费构建时间

Zeabur vs Vercel vs Railway

选择建议：

• 纯前端项目 → Vercel
• 需要数据库的全栈项目 → Zeabur/Railway
• 国内访问速度要求高 → Zeabur

最佳实践

1. 使用环境变量

不要硬编码敏感信息：

// ❌ 错误
const apiKey = 'sk-xxxxx'

// ✅ 正确
const apiKey = process.env.API_KEY

2. 配置健康检查

服务设置 → 健康检查 → 配置检查路径

例如：/api/health

3. 使用内网通信

同项目服务间使用内网地址，减少延迟和费用。

4. 合理配置资源

根据实际负载调整 CPU/内存，避免浪费。

常见问题

部署失败

1. 查看构建日志定位错误
2. 确认 Node.js 版本
3. 检查构建命令是否正确

服务无法访问

1. 确认端口配置正确
2. 检查域名 DNS 配置
3. 查看服务日志

数据库连接失败

1. 确认使用内网地址
2. 检查环境变量是否正确引用
3. 确认数据库服务正常运行

参考资料

• Zeabur 官方文档
• Zeabur 模板市场
• Zeabur 定价说明
• Zeabur Discord 社区