Skip to content

Zeabur 部署指南

· 6 min

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

为什么选择 Zeabur#

特性说明
国内友好服务器节点覆盖亚洲，访问速度快
中文界面完整中文文档和客服支持
全栈支持前端、后端、数据库一站式部署
按量付费用多少付多少，无闲置成本
模板市场一键部署常见应用（WordPress、Halo 等）

快速开始#

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

服务管理#

部署配置#

每个服务可单独配置：

配置项说明
区域服务器地区（推荐香港）
构建命令如 npm run build
启动命令如 npm start
监听端口应用监听的端口
实例规格CPU/内存配置

环境变量#

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

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 支持两种运行模式：

容器模式（默认）#

Serverless 模式#

服务设置 → 启用 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 采用按量付费：

资源价格
CPU$0.05/核心/小时
内存$0.01/GB/小时
流量$0.12/GB（出站）
存储$0.20/GB/月

免费额度：

Zeabur vs Vercel vs Railway#

特性ZeaburVercelRailway
定位全栈前端优先后端优先
数据库✅ 内置❌ 需外接✅ 内置
计费方式按量按项目按量
亚洲节点✅ 丰富✅ 有❌ 较少
中文支持✅❌❌
免费额度$5充足$5

选择建议：

最佳实践#

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. 确认数据库服务正常运行

参考资料#