Deno Deploy 部署
概述
本页介绍在 Deno Deploy 上部署 ZtoApi 的流程与注意事项。部署完成后，你将获得类似 https://your-project.deno.dev 的访问地址。
提示: 未配置 ZAI_TOKEN 或 ZAI_TOKENS 时仅支持文本对话，多模态功能会被限制。
部署步骤
- 准备仓库：确保
main.ts 位于仓库根目录并已推送。
- 在 Deno Deploy 控制台创建项目并连接 GitHub 仓库。
- 选择部署分支与入口文件
main.ts。
- 配置环境变量（见下表）。
- 部署完成后访问
/v1/models 与 /dashboard 进行验证。
环境变量说明
| 变量 |
用途 |
建议 |
DEFAULT_KEY |
客户端访问密钥，用于请求鉴权 |
生产环境务必设置为强随机值 |
ZAI_TOKEN |
单个 Z.ai Token，多模态功能必需 |
没有 Token 时仅支持文本 |
ZAI_TOKENS |
多 Token 池，自动轮换提升可用性 |
生产推荐优先使用 |
ZAI_SIGNING_SECRET |
自定义签名密钥，增强安全性 |
生产建议设置 |
DEBUG_MODE |
调试日志开关 |
生产环境设为 false |
DEFAULT_STREAM |
默认启用流式响应 |
保持 true 获取更低延迟 |
DASHBOARD_ENABLED |
监控看板开关 |
需要监控时保持开启 |
建议: 生产环境推荐使用 ZAI_TOKENS 并关闭 DEBUG_MODE 以提升稳定性与性能。
示例代码
curl -X GET https://your-project.deno.dev/v1/models -H "Authorization: Bearer sk-your-key"
curl -X POST https://your-project.deno.dev/v1/chat/completions -H "Content-Type: application/json" -H "Authorization: Bearer sk-your-key" -d '{
"model": "glm-4.6",
"messages": [{"role": "user", "content": "你好"}],
"stream": false
}'
常见问题
| 问题 |
可能原因 |
处理建议 |
| 401 Unauthorized |
DEFAULT_KEY 不匹配 |
确认请求头 Bearer 与部署环境的 DEFAULT_KEY 一致 |
| 502 Bad Gateway |
上游服务异常或 Token 失效 |
检查 ZAI_TOKEN/ZAI_TOKENS 是否有效 |
| /dashboard 无法访问 |
DASHBOARD_ENABLED=false |
在部署环境变量中启用该开关 |
| 多模态请求失败 |
未配置正式 Token |
设置 ZAI_TOKEN 或 ZAI_TOKENS |