EdgeOne Makers CLI 与本地开发

前面讲的都是在控制台网页上操作项目，其实 EdgeOne Makers 还提供了命令行工具 CLI，可以在终端里管理项目、本地调试、触发部署。对于习惯用命令行的开发者来说，CLI 比网页操作更高效。这篇就来讲讲 CLI 的安装配置、本地开发调试、命令行部署。

CLI 安装

全局安装

通过 npm 全局安装 CLI 工具:

npm install -g @edgeone/cli

安装完成后，验证一下:

edgeone --version

如果输出版本号，说明安装成功了。

更新 CLI

CLI 会不定期更新，添加新功能或修复问题。更新命令:

npm update -g @edgeone/cli

CLI 常用命令

项目列表

查看当前账号下所有的项目:

edgeone projects list

输出大概是这样:

ID   NAME              STATUS    URL
365  my-blog           ACTIVE    https://my-blog.edgeone.app
366  my-portfolio      ACTIVE    https://my-portfolio.edgeone.app
367  test-project      DEPLOYING https://test-project.edgeone.app

创建项目

用 CLI 也能创建项目:

edgeone projects create --name my-new-project --framework vue

创建完后会自动关联到当前目录的 Git 仓库。

触发部署

在本地项目目录下，执行:

edgeone deploy

CLI 会自动检测项目类型，执行构建命令，然后把产物上传到平台。

部署完成后，终端会输出访问地址。

也可以指定项目名:

edgeone deploy --project my-project

查看部署状态

edgeone deployments list --project my-project

输出最近几次部署的记录:

ID        STATUS    CREATED_AT          TRIGGER
d-abc123  SUCCESS   2026-08-18 10:00    git push
d-def456  SUCCESS   2026-08-17 15:30    cli deploy
d-ghi789  FAILED    2026-08-16 09:00    git push

回滚部署

edgeone deployments rollback --project my-project --deployment d-def456

会回滚到指定的部署版本。

查看部署日志

edgeone deployments logs --project my-project --deployment d-abc123

输出这次部署的完整日志，包括构建过程和部署过程。

删除项目

edgeone projects delete --project my-project

会提示确认，输入 yes 后删除。

本地开发调试

CLI 最实用的功能之一是本地开发调试。

本地预览

在项目目录下执行:

edgeone dev

CLI 会在本地启动一个开发服务器，默认监听 http://localhost:3000。

打开浏览器访问这个地址，就能看到你的项目了。

本地环境变量

本地调试时，可能需要用到环境变量。

可以在项目根目录创建 .env.local 文件:

API_BASE_URL=http://localhost:8080
DEBUG=true

执行 edgeone dev 时，CLI 会自动读取这个文件里的环境变量。

注意: .env.local 不要提交到 Git，加到 .gitignore 里。

模拟 Edge Functions

如果项目里用了 Edge Functions，可以在本地模拟运行。

在项目根目录创建 edge-functions 目录，里面放函数文件。

执行 edgeone dev 时，CLI 会自动加载这些函数，并在本地模拟边缘节点的运行环境。

模拟 Cloud Functions

Cloud Functions 也能在本地模拟。

创建 cloud-functions 目录，放函数文件。

执行 edgeone dev 时，也会加载这些函数。

热更新

edgeone dev 支持热更新。修改代码后，浏览器会自动刷新，不用手动重启。

这对于前端开发来说很方便，改一行代码就能看到效果。

配置文件

CLI 支持在项目根目录放一个配置文件 edgeone.json，用来覆盖默认的配置。

{
  "name": "my-project",
  "framework": "vue",
  "build": {
    "command": "npm run build",
    "output": "dist"
  },
  "functions": {
    "directory": "./edge-functions"
  },
  "redirects": [
    {
      "from": "/old-page",
      "to": "/new-page",
      "status": 301
    }
  ],
  "headers": [
    {
      "source": "/**",
      "headers": [
        {
          "key": "X-Frame-Options",
          "value": "DENY"
        }
      ]
    }
  ]
}

配置文件里的选项:

选项	说明
name	项目名称
framework	框架类型，vue/react/nextjs/nuxt 等
build.command	构建命令
build.output	输出目录
functions.directory	Edge Functions 目录
redirects	重定向规则
headers	自定义响应头

有了配置文件，部署时就不用每次都在控制台手动配置了。

高级命令

指定分支部署

edgeone deploy --branch feature/new-design

会把当前代码部署到指定的分支环境。

环境变量管理

用 CLI 也能管理环境变量:

edgeone env list --project my-project
edgeone env set API_KEY=xxx --project my-project
edgeone env delete API_KEY --project my-project

域名管理

edgeone domains list --project my-project
edgeone domains add example.com --project my-project
edgeone domains delete example.com --project my-project

CI/CD 集成

CLI 可以集成到 CI/CD 流程里。

比如在 GitHub Actions 里:

name: Deploy
on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: actions/setup-node@v3
        with:
          node-version: '18'
      - run: npm install -g @edgeone/cli
      - run: edgeone login --token ${{ secrets.EDGEONE_TOKEN }}
      - run: edgeone deploy

这样每次 push 到 main 分支，GitHub Actions 会自动部署。

速查卡片

要点	说明
安装命令	npm install -g @edgeone/cli
登录方式	edgeone login 浏览器登录，或 –token 命令行登录
本地开发	edgeone dev 启动本地开发服务器，支持热更新
本地部署	edgeone deploy 在命令行里触发部署
查看项目	edgeone projects list 列出所有项目
查看部署	edgeone deployments list 查看部署记录
配置文件	edgeone.json 覆盖默认配置，包括构建命令、输出目录等
CI/CD 集成	可以在 GitHub Actions 等 CI 工具里使用 CLI 自动部署

EdgeOne Makers 域名管理

EdgeOne Makers API Token