用途:该技能用于在 Zeabur 上为服务配置公开可访问的 URL,解决重定向指向错误地址(缺少域名后缀或带尾斜杠)、CORS 因 URL 不一致报错,以及 WEB_URL 带尾斜杠导致路径异常等问题。
主要能力:1)在服务间暴露公开地址,建议使用 https://${ZEABUR_WEB_DOMAIN} 而非 ${ZEABUR_WEB_URL},因为后者默认带尾斜杠。示例中 entry-service 通过 env 的 APP_URL 设置 default: https://${ZEABUR_WEB_DOMAIN} 并 expose: true,backend 则引用 ${APP_URL}。系统变量 ZEABUR_WEB_URL 形如 https://app.zeabur.app/(带尾斜杠),ZEABUR_WEB_DOMAIN 形如 app.zeabur.app(仅域名无协议)。2)通过 CLI 管理域名:必须使用 npx zeabur@latest,若 npx 不可用需先安装 Node.js。列出域名:npx zeabur@latest domain list --id <service-id> -i=false。创建生成域名使用 -g,--domain 只填前缀(如 myapp):npx zeabur@latest domain create --id <service-id> -g --domain myapp -y -i=false,后缀由后端按区域自动追加(默认 myapp.zeabur.app,中国区分别对应 preview.aliyun-zeabur.cn、preview.tencent-zeabur.cn、preview.huawei-zeabur.cn,中国区后缀需完成实名验证)。前缀至少 3 个字符、不允许点号,过短报 DOMAIN_NAME_TOO_SHORT,含点报 UNSUPPORTED_DOMAIN_NAME。3)创建自定义域名不带 -g,--domain 填完整域名:npx zeabur@latest domain create --id <service-id> --domain example.com -y -i=false,之后需配置 DNS,专用服务器 IP 用 npx zeabur@latest server list -i=false 获取,再在 DNS 提供商处添加 A 记录,指向该 IP,不要猜测 DNS 值。删除域名:npx zeabur@latest domain delete --id <service-id> --domain <domain> -y -i=false。
限制:非交互模式下 --domain 必填,否则报 INVALID_DOMAIN_NAME。Wonder Mesh 服务器上服务不能直接绑定域名,会报 WONDER_MESH_SERVER_REQUIRES_GATEWAY,且重试无效,必须在 Zeabur Dashboard 的 Domains 标签页通过网关流程绑定,CLI 或 API 没有该流程;其他服务器不受影响。
适用场景:为服务配置重定向与 CORS 所需公开 URL、管理生成域名或自定义域名、排查尾斜杠问题。