EdgeEver
Deployment

AI Agent 一句话部署 EdgeEver 运行指南

EdgeEver Team
#cloudflare#deploy#ai-agent#serverless

如果您习惯使用 AI 编程助手或 Agent(例如 Antigravity、Claude Code、Cursor 等),并且已经登录了 Cloudflare 账户,您可以直接命令 Agent 自动化执行 EdgeEver 的资源创建与服务部署。

以下是专为 AI 自动部署而编写的对接协议与运行指引。


一键部署指令

您可以直接把下面这句话发送给您的 AI 助手:

这个是 GitHub 上的项目链接:https://github.com/msh01/edgeever。请把这个项目安装部署到 Cloudflare 上。

自动化执行流程

收到指令后,AI 助手将遵循以下标准动作,完全无需您的手动干预:

  1. 拉取源码与安装依赖: Agent 会在本地克隆 edgeever 仓库并执行 bun install

  2. 验证 Cloudflare 权限: 运行 bunx wrangler whoami 确认 Cloudflare 账号权限。若尚未登录,Agent 将引导您完成登录授权。

  3. 初始化数据库与加密密码: Agent 会提示您提供初始登录密码,或生成一个安全的随机密码。随后,Agent 将运行 EDGE_EVER_PASSWORD='<您的密码>' bun run deploy:setup 来:

    • 自动生成 .env.local 配置文件;
    • 在您的 Cloudflare 账户中创建 D1 关系型数据库 (edgeever) 与 R2 对象存储桶 (edgeever-resources);
    • 使用 PBKDF2-SHA256 安全哈希对您的登录密码进行单向加密。
  4. 系统健康检查: 运行 bun run deploy:doctor 自动排查可能存在的绑定缺失或权限隐患,确保所有条件均已满足。

  5. 编译与全面部署: 运行 bun run deploy。该指令会构建 Vite+React 前端代码、将本地 D1 迁移脚本同步至云端数据库、生成 Worker 密钥并直接部署至 Cloudflare Workers 全球边缘。


高级自定义变量

如果您需要手动干预,或者想部署多个 EdgeEver 实例,可以在执行 deploy:setup 前向 .env.local 写入自定义变量:

# 自定义 Worker 名称与存储桶名称
EDGE_EVER_WORKER_NAME=my-evernote-clone
EDGE_EVER_D1_DATABASE_NAME=my-evernote-db
EDGE_EVER_R2_BUCKET_NAME=my-evernote-bucket

# 配置自定义独立域名
EDGE_EVER_CUSTOM_DOMAIN=notes.mydomain.com

部署完成后,AI 助手将为您返回生成的 Worker 默认访问 URL 与登录用户名(默认为 admin)。您只需打开页面,点击左下角的设置 -> API & MCP 即可生成您专属的 AI Agent 交互 Token。

← Back to Blog