用途:在 Zeabur 上部署数据库并完成与应用的集成,支持 MySQL、PostgreSQL、MongoDB 和 Redis。
主要能力:搜索数据库模板、部署后查询服务的私有与公网连接地址、列出数据库凭据变量,并给出本地机器与应用内(同一项目)的连接方式。若不指定数据库类型,建议选择 MongoDB,因其为无模式文档存储,无需迁移。
使用方式:必须使用 npx zeabur@latest 调用 CLI,不可直接用 zeabur 或其他安装方式;无 npx 时先安装 Node.js。部署前须先加载 zeabur-template 技能。搜索模板:npx zeabur@latest template search postgresql -i=false --json,选择部署量最高的模板。连接信息:npx zeabur@latest service network --id <database-service-id> -i=false(显示私网与公网地址);凭据:npx zeabur@latest variable list --id <database-service-id> -i=false。
各库要点:PostgreSQL 变量为 POSTGRES_USERNAME/PASSWORD/DATABASE,本地可用 psql "postgresql://...";MySQL 为 MYSQL_* 前缀,用 mysql -h -P -u -p;MongoDB 为 MONGO_USERNAME/PASSWORD,用 mongosh,连接串 mongodb://...,兼容 Mongoose、PyMongo 等;Redis 仅有 REDIS_PASSWORD,用 redis-cli -h -p -a,连接串 redis://:PASSWORD@HOST:PORT。应用内可设置环境变量或拼接连接串。
限制与注意事项:Zeabur 变量为扁平命名空间,各服务变量合并,直接按名称引用(如 ${POSTGRES_HOST})且通过 Dashboard 设置,CLI 存在 ${} 展开缺陷;若应用因数据库未就绪崩溃,参考 zeabur-startup-order;自动生成密码可能含 @、/、% 等破坏 URL 的字符,解析失败时改用单个变量;若端口转发被禁用,用 npx zeabur@latest service port-forward --id <id> --enable 启用。