Sealos Devbox 基础教程：使用 Cursor 从零开发一个 One API 替代品

最新推荐文章于 2025-04-05 23:18:34 发布
最新推荐文章于 2025-04-05 23:18:34 发布
阅读量131 收藏
点赞数
文章标签： it
原文链接：https://www.cnblogs.com/ryanyangcs/p/18632447
版权

随着技术的成熟和 AI 的崛起，很多原本需要团队协作才能完成的工作现在都可以通过自动化和智能化的方式完成。于是乎，单个开发者的能力得到了极大的提升 - 借助各种工具，一个人就可以完成开发、测试、运维等整条链路上的工作，渡劫飞升成为真正的 “全干工程师”。

之前我们分享过一些入门级的 Hello World 教程。今天，我想通过一个实际的业务案例来展示 Devbox 并非只能开发玩具，而是一个真正的生产力工具。

Sealos 平台上有很多应用，其中很多管控层面的应用都是使用 Cursor + Go + Next.js 开发的。我们的开发环境直接使用 Sealos Devbox，上线也是通过 Devbox 一键完成。这种开发模式让我们团队拥有了非常高效的作战能力 - 大部分重复性工作都通过自动化或 AI 完成，让开发者可以专注于核心业务逻辑。

以 Sealos 中的 AI Proxy 应用为例，这是一个典型的前后端分离架构的应用，主要由两部分组成：

  1. 基于 Next.js 开发的前端应用和 BFF 层。BFF 层负责用户鉴权，并将经过验证的请求转发给后端服务。
  2. 使用 Golang 开发的后端服务，负责核心业务逻辑，包括 token 存储、日志记录和请求转发等功能。

接下来，我将详细介绍如何高效地开发这样一个生产级别的系统。

Golang 后端

创建开发环境

首先在 Sealos Cloud 中打开 Debox 应用，创建一个新项目，选择 Go 作为运行环境，选择 1.23 版本。

Devbox 为开发者提供了几个非常实用的功能：

  • 灵活的资源配置：可以根据项目需求自由调整 CPU 和内存，选择合适配置既保证性能又能控制成本。
  • 一键启用 HTTPS：系统自动分配安全域名，再也不用为配置 SSL 证书发愁。
  • 全自动域名管理：从开发到测试环境，域名配置全程由系统处理，开发者可以专注于代码本身。

创建完成后，几秒钟即可启动开发环境。

环境准备好后，我们直接用 Cursor 连接开发环境。在操作选项中选择使用 Cursor 连接：

首次打开会提示安装 Devbox 插件，安装后即可自动连接开发环境。

导入项目到 Cursor

首先 Fork Sealos 源码到自己的仓库，然后再将你自己的仓库克隆到 Devbox 开发环境：

测试环境开发

在 Cursor 的面板中切换到 “Databse” 标签页，然后点击箭头指向的按钮，在浏览器中打开 Sealos 的数据库应用：

然后创建 PostgreSQL 和 Redis 实例。

回到 Cursor 面板的 “Database” 标签页，点击刷新即可看到刚创建的数据库实例，点击可复制连接信息：

在终端中启动服务：

/* by yours.tools - online tools website : yours.tools/zh/json2go.html */
export ADMIN_KEY=sealos-admin
export SQL_DSN=<复制的pgsql连接串>/postgres
export REDIS_CONN_STRING=<复制的redis连接串>
go run . --port 8080

提示 server stared 即为启动成功

在 Cursor 面板的 “Network” 标签页中，点击地址栏右侧的 🌐 按钮，然后在弹窗中选择 “Copy”，将地址复制到自己电脑上使用 curl 进行测试：

/* by yours.tools - online tools website : yours.tools/zh/json2go.html */
curl https://mmznjndvzdrv.sealoshzh.site/api/status -H "Authorization: sealos-admin"

接口返回没有问题。

优化数据库设计

在开发过程中，我们发现数据库中 Group 和 Token 之间的外键约束增加了系统维护的复杂度。为了简化这一关系，我们可以将外键约束改为程序层面的显式调用，这样可以让代码逻辑更加清晰和可控。

首先切换到 fix-aiproxy 分支：

在 sealos/service/aiproxy/model/group.go 文件中，我们需要将 Group 结构体中一个外键约束改成在程序内显示调用更新和删除来降低维护心智。

这里我选择使用 Cursor 的 Chat 功能让 AI 自己写代码，最后生成的结果如下：

这种实现方式的优势在于：当删除 Group 时，相关的 Token 删除操作会在同一个事务中完成。由于是在事务内进行，我们不需要担心删除失败或系统宕机导致的数据不一致问题。

我们可以通过一系列测试来验证这个优化是否达到预期效果。首先编译并运行服务：

go build . && ./aiproxy --port 8080

然后通过以下 API 调用来测试完整的 Group 和 Token 生命周期：

# 创建一个group
curl https://gawavirgsomu.sealosbja.site/api/group/ -H "Authorization: sealos-admin" -d '{
    "id": "ns-admin"
}'

# 创建一个token
curl https://gawavirgsomu.sealosbja.site/api/token/ns-admin -H "Authorization: sealos-admin" -d '{
    "name": "token 1"
}'

# 查询token
curl https://gawavirgsomu.sealosbja.site/api/tokens/ -H "Authorization: sealos-admin"

# 删除group
curl https://gawavirgsomu.sealosbja.site/api/group/ns-admin -H "Authorization: sealos-admin" -X DELETE

# 再次查询token
curl https://gawavirgsomu.sealosbja.site/api/tokens/ -H "Authorization: sealos-admin"

测试结果符合预期，确认优化方案可行。接下来我们就可以提交这些更改并创建 Pull Request 了。

上线到生产环境

首先在 Cursor 目录顶层的 endpoint.sh 中设置启动命令，在文件中添加以下启动配置：

cd sealos/service/aiproxy
export ADMIN_KEY=sealos-admin
# 可以再创建一个单独的生产环境数据库，与开发环境隔离
export SQL_DSN=<复制的pgsql连接串>/postgres
export REDIS_CONN_STRING=<复制的redis连接串>
# 使用编译好的二进制文件
./aiproxy --port 8080

然后来到 Devbox 发布页面发布版本：

点击发布按钮后，等待发布流程完成。发布成功后，点击 “上线” 按钮进入部署页面，然后点击 “部署应用” 即可：

部署完成后，进入应用的详情页面，等待应用变成 running 状态，然后复制公网地址：

这个公网地址就是生产环境的域名，我们可以使用生产环境的域名进行测试：

# 这里使用的是生产环境的域名
curl https://jpesudzryuhp.sealosbja.site/api/tokens/ -H "Authorization: sealos-admin"

完美！

Next.js 前端

前端项目搭建

前端环境的搭建与后端类似，具体步骤如下：

  1. 在 Devbox 中创建一个 Node.js 环境，版本选择 20，端口改成 3000。由于 pnpm 安装依赖比较消耗资源，建议选择 4c 16G 的配置。然后克隆你自己 Fork 的 Sealos 仓库：git clone https://github.com/xxx/sealos.git。AI Proxy 的前端代码位于 sealos/frontend/providers/aiproxy 目录。

  2. 切换到 sealos/frontend 目录，首先修改 sealos/frontend/package.josn 文件，去除 node 版本限制，直接删除 "node": "20.4.0" 和 "pnpm": "8.9.0" 这两行即可，这一步很重要，不然代码构建依赖会不成功。

  3. 执行命令 pnpm i 安装依赖。

  4. 执行命令 pnpm -r --filter ./packages/client-sdk run build 构建 client-sdk 包。

  5. 为了让 Cursor 的 i18n 插件正常工作，我们需要将项目根目录切换到 sealos/frontend/providers/aiproxy：

    切换目录后，建议安装所有 @recommended 插件以获得最佳的开发体验：

  6. 之前只是构建出了 Sealos Desktop SDK，并没有安装 aiproxy 的依赖，aiproxy 的依赖需要在 aiproxy 工作目录下 sealos/frontend/providers/aiproxy 进行安装。直接执行命令 pnpm i 安装即可：

对接后端环境

项目搭建完成后，我们需要配置环境变量来对接后端服务。在项目根目录创建一个 .env 文件，需要配置以下几个关键变量：

NEXT_PUBLIC_MOCK_USER=""
AI_PROXY_BACKEND_KEY=""
APP_TOKEN_JWT_KEY="test123"
AI_PROXY_BACKEND=""
AI_PROXY_BACKEND_INTERNAL=""
ADMIN_NAMESPACES=""

  • NEXT_PUBLIC_MOCK_USER：由于 AI Proxy 是 Sealos Desktop 的一部分，用户认证通过 JWT Token 实现，AI Proxy 只做解析 Token，JWT Token 的签发由 Sealos Desktop 完成。在开发阶段，我们需要 mock 一个 JWT Token。NEXT_PUBLIC_MOCK_USER 的值就是 mock 出来的 JWT Token。可以使用在线工具 https://www.lddgo.net/encrypt/jwt-generate 生成。

    mock 数据如下：

    {
    "workspaceId" : "test"
}

  • APP_TOKEN_JWT_KEY：JWT Token 的密钥 (随便写)

  • AI_PROXY_BACKEND_KEY：后端 API 的访问密钥 (也就是后端项目的 ADMIN_KEY)

  • AI_PROXY_BACKEND：后端服务的公网地址

  • AI_PROXY_BACKEND_INTERNAL：后端服务的内网地址 (开发测试阶段可以不填)

  • ADMIN_NAMESPACES：管理员用户名，开发时填 test 就行，和 token 中的 “workspaceId”：“test” 保持一致

环境变量配置完成后，运行 pnpm dev 即可启动开发服务器。项目的发布和部署流程与前面介绍的后端开发流程完全一致。

总结

Sealos AI Proxy 前端项目采用了经典的 Next.js App Router 架构，其中 app/[lng] 目录用于页面路由，app/api 目录则用于后端 API 路由。

在这个项目中，Next.js 的后端实际上是一个中间层，它主要负责用户认证相关的业务逻辑，并将经过认证的请求转发给真正的 Golang 后端服务。这种分层设计可以让 Golang 后端专注于核心业务逻辑，不需要关心认证等基础设施，从而提高了代码的灵活性和可移植性。

fenfenfen520a
关注
Microsoft Dev Box：高效编程的利器及使用指南
CyberJolt的博客
09-30 640
Microsoft Dev Box是微软推出的一款供开发人员使用的硬件设备，旨在提供一个强大且高效的编程环境。它集成了各种开发工具和软件，并且配置了适用于多种编程语言和平台的开发环境。本文将介绍Microsoft Dev Box的功能和用法，并提供一些示例代码来帮助你更好地使用它进行编程。
devbox:Devbox是本地PHP开发环境，可轻松在Mac或Linux PC上运行功能强大的可自定义开发服务器
05-02
开发箱 Devbox是一个本地PHP开发环境，可轻松在Mac或Linux PC上运行功能强大的可自定义开发服务器。 Devbox基于 ，即“面向分布式应用程序的开发人员和系统管理员的开放平台”。 这使得Devbox极具可插拔性，允许您通过几次按键就可以在本地运行各种服务器软件（并且不会弄乱您的配置）。 入门 安装Devbox 在任何平台上安装Devbox只需几个简单的步骤： 安装 。 这使Devbox虚拟机可以运行。 安装 。 这将使安装和运行Devbox VM变得容易。 将此存储git clone ...到一个方便的位置： git clone ... 一些注意事项： 如果您已经在Linux上安装了Docker，并且心情很冒险，请查看下面有关直接将Devbox与Docker结合使用的部分。 您可以使用VMWare或Parallels代替VirtualBox，但是我们的默认配
devbox:一款用于整合程序员常用开发工具的桌面应用
05-13
devbox 一款集成程序员常用软件的工具箱应用 功能模块 常用工具 文本处理 系统相关 HTTP服务 FTP服务 系统设置 编译步骤 # install dependencies npm install # serve with hot reload at localhost:9080 npm run dev # build electron application for production npm run build # or npm run build:dir # run unit & end-to-end tests npm test # lint all JS/Vue component files in `src/` npm run lint 功能描述 代码片段 一个代码片段的管理应用部件, 用户创建、编辑、保存、管理用户的一些常用代码片段。 片段命名 片段选择语
devbox加cursor编写项目到上线，不到10分钟
2301_76633800的博客
04-05 511
在开始创建 Devbox 之前，需要先切换到合适的可用区。：在创建环境的页面中，选择“预配置”语言环境。：连接成功后，会生成预配置文件，此时可以开始在本地 IDE 中进行开发。：在主界面找到并点击“Devbox”选项，进入创建环境的界面。，如果没有任何报错信息，则说明环境启动成功，可以开始开发工作。：开启所需的端口，系统会自动分配一个公网域名，方便远程访问。：通过拖拽按钮，可以调整资源的大小，以满足不同的开发需求。：在 Devbox 环境中，选择你常用的本地 IDE。：点击“连接”按钮，开始连接过程。
dev_box:Dev_Box是开发人员工具箱数据库
05-18
dev_box Dev_Box是社区驱动的开发人员工具箱数据库。 在这里，您可以最终轻松找到要在下一个项目中使用的开发工具。 或者，找到上一个应该使用的工具。 技术领域 DevBox由Rails，Angular.js和Postgres提供支持，并使用Materialize.css和Material进行样式设置 特征 oauth登录 用户添加的工具 表决 每个工具的信息 名称 描述 类别 标签 语 价格/免费 例子 安装 网址 回购网址 蜜蜂 oAuth 的GitHub 堆叠交换 ER图 桌子 用户数 工具 工具_用户 分类目录 分类_工具 标签 标签_工具 评论 投票 版本（Paper_trail） 用户数 ID 名称 电子邮件 image_url 提供者 provider_id provider_hash refresh_hash hash_expires_at #
DevBox：最实用的移动开发辅助工具包
呆萌院长
03-05 2596
DevBox（for Mac）是一款多个移动开发辅助工具的合集，具有图标生成、为新应用创建在iTunes Connect的占位符、批量缩放、拾色器、设备列表、IPA文件验证、生成二维码等功能。DevBox工具包的使用，提高了软件的开发效率，可以帮开发者节省更多的时间。 DevBox主要特性： 图标生成。只需点击一下，就能为iOS、Android及Mac OS X
还在使用昂贵的虚拟机？来试试 Devbox，便宜 6 倍！
云原生实验室
10-14 953
Devbox 可以对很多开发场景进行降维打击，而且便宜的要死。比如搭建博客，用虚拟机，开发前后端应用等，细心的朋友可以发现我的截图中有个叫 sealos coin 的项目，下期给大家带来怎么用 Devbox 快速开发一个基于 Rust 的区块链项目。后续会陆续给大家带来 Devbox 的有趣玩法，Devbox 可解决掉开发者很多有趣头疼的问题。
探索开发利器：Devbox
gitblog_00067的博客
05-17 1341
探索开发利器：Devbox vr-devbox项目地址:https://gitcode.com/gh_mirrors/vr/vr-devbox 项目介绍 欢迎来到Devbox的世界，这是一个专为开发者打造的集成开发环境，通过VirtualBox和Vagrant进行管理。只需简单的命令行操作，即可快速启动一个预配置好的开发环境，让您的工作变得更加高效和便捷。 项目技术分析 Devbox的核心在于结...
Devbox 项目教程
gitblog_00042的博客
09-13 1494
Devbox 项目教程 项目地址:https://gitcode.com/gh_mirrors/dev/devbox 1. 项目目录结构及介绍 Devbox 项目的目录结构如下： devbox/ ├── cmd/ │ └── devbox/ ├── docs/ ├── examples/ ├── internal/ ├── nix/ │ └── flake/ ├── plugins/ ├─...
推荐文章：探索Devbox —— 打造统一且高效的开发环境
gitblog_00400的博客
08-23 2540
推荐文章：探索Devbox —— 打造统一且高效的开发环境 项目地址:https://gitcode.com/gh_mirrors/de/devbox 项目介绍 在快节奏的软件开发世界中，保持团队成员间开发环境的一致性至关重要。Devbox 正是为解决这一痛点而生，它是一个强大的命令行工具，允许开发者快速建立隔离的开发环境。通过简洁的配置文件，团队可以轻松定义所需的所有依赖包，确保无论在哪都能拥...
Microsoft Dev Box 带来全新云上开发体验
dotNET跨平台
05-27 465
在 5 月 24 日, 微软的产品经理 Anthony Cangialosi 在 Azure 社区发布了一篇博客(Introducing Microsoft Dev Box)， 宣布推出 Microsoft Dev Box !这是一种新的云服务，托管在 Microsoft Azure 中，提供了一个开箱即用的开发工作站，开发人员可以在上面直接编写代码，适合任何规模的团队。...
Sealos Devbox 基础教程：使用 Cursor 从零开发一个代码猜古诗小游戏
云原生实验室
12-24 864
本文带领大家完成了一个有趣的 “代码猜诗词” 小游戏。从 0 到 1，我们经历了项目初始化、开发环境搭建、到最终部署上线的完整过程。整个开发过程非常简单 —— 有了 AI 工具的加持，我们只需要动动嘴 (写写提示词)，AI 就会帮我们把代码变出来；有了 Sealos Devbox 的加持，从开发到部署也变得非常简单，全程只需要点鼠标就行了。
Sealos Devbox 基础教程：使用 Cursor 从零开发一个完整的项目
云原生实验室
12-06 2618
看完是不是发现，原来部署也可以这么简单？从前我们总觉得，不会编程就做不了产品。可现在不一样了。我们不需要成为全能选手，不需要精通所有技术细节，更不需要被那些专业术语所困扰。技术在进步，工具在迭代。Cursor 帮我们写代码，Sealos 帮我们一键部署，曾经让人头疼的技术环节，现在都变得如此简单。就算是作为程序员的我，每次用这套组合来做技术验证、快速实现想法，都会感叹：要是早几年有这些工具就好了，能少走多少弯路啊！如果你正在用 Cursor 开发自己的项目，别被那些技术障碍吓退。
Devbox 开源项目常见问题解决方案
gitblog_00759的博客
12-12 1286
Devbox 开源项目常见问题解决方案 devbox Instant, easy, and predictable development environments 项目地址: https://gitcode.com/gh_mir...
【Cursor+Devbox】 AI开发快速入门
weixin_62533201的博客
12-04 3844
本文介绍了最新的Cursor + devbox 技术进行AI项目开发,介绍了两款工具的安装使用方式以及带着大家完成了一个简易学生管理系统
Sealos 基础教程：Sealos Devbox 的架构原理解析
云原生实验室
11-04 1549
今天这篇文章咱们来聊一聊，据说隔壁老奶奶最喜欢看这种有技术深度的文章了。Devbox 返璞归真，把开发者的开发精力放到开发中去，真正做到了，除此之外还力求拉平开发与测试与运维团队之间的一切界限，从从业者的角度做到了一套环境，随处运行。
我一行代码也没写，Cursor 和 Devbox 给我写了个高仿苹果官网！
强化学习曾小健
10-28 1096
Sealos 的操作确实是简单，而且费用也确实是低。如果选择最低配置，一天才几毛钱。从项目开始到上线，总共只需要 1 天时间，其实还是利用空余时间来做的，因为我不是专职码农。这效率放到以前想都不敢想。很多自媒体都在唱 AI 要取代程序员，它这是在取代程序员吗？这分明是在助力程序员啊！害得我恨不得把原来写的哪些屎山代码拿出来重新翻炒一番了。加入 Sealos 开源社区体验像个人电脑一样简单的云操作系统🏠官网链接🐙GitHub 地址📑访问 Sealos 文档🏘️逛逛论坛。
记录让cursor帮我给ruoyi-vue后台管理项目整合mybatis-plus
chijiansong的博客
01-24 1027
work.web.exception.GlobalExceptionHandler :100 | 请求地址'/admin/device/install/detail/1',发生未知异常.然后就整合成功了，启动发现没问题了，ruoyi本身的框架查询也没问题了，好强大！直接跟它说项目需要新增mubatis-plus的支持，并提供测试，就可以做到了。给cursor提问的方式有很大区别。自己整合过程中会出现。
sealos devbox连接cursor
最新发布
04-28
<think>好的，我需要帮助用户解决如何在Sealos Devbox中连接Cursor的问题。首先，我得回顾用户提供的引用内容，特别是引用[1]、[2]、[3]和[4]，里面提到了一些步骤和相关教程。 根据引用[1]，用户需要注册Sealos账号，创建Devbox项目，配置环境，然后使用Cursor连接。这里提到安装Devbox插件并通过Cursor连接，但具体步骤可能不够详细。引用[2]和[3]提到使用Cursor开发的具体案例，说明连接过程可能涉及插件安装和终端命令操作。引用[4]则强调开发到部署的简便性，可能涉及环境配置后的自动部署。 接下来，我需要整理这些信息，形成清晰的步骤。首先，用户需要确保已经创建了Devbox项目并配置好环境，然后在Cursor中安装Devbox插件，使用项目提供的连接信息进行连接。可能还需要注意网络设置和权限问题，比如端口是否正确开放，访问地址是否有误。此外，引用[2]提到Cursor在终端命令处理上的不足，可能需要手动输入命令，这点需要提醒用户。 需要分步骤说明：创建项目、配置环境、安装插件、连接、验证连接是否成功。每个步骤要具体，比如如何找到访问地址和端口，如何输入到Cursor中。可能还需要常见问题解答，比如连接失败怎么办，权限问题如何处理。同时，参考用户之前的问题，他们可能对自动化流程感兴趣，所以可以提到未来的改进，如自动运行命令的功能。 最后，生成相关问题，帮助用户进一步探索，比如性能优化、接口测试和插件使用等。确保回答结构清晰，步骤详细，引用正确，比如引用[1]和[3]中的创建项目和连接步骤。</think>以下是在 Sealos Devbox 中连接 Cursor 的完整操作指南： ### 一、配置准备 1. **创建 Devbox 项目** - 登录 Sealos 控制台，进入「应用管理」选择 Devbox 应用 - 新建项目时需选择开发环境类型（如 Node.js/Python/Go）[^1] - 设置资源配置（建议开发环境最低配置 2 核 CPU + 4GB 内存） 2. **获取连接参数** - 项目创建成功后，在「网络配置」中记录： ``` 访问地址：your-project.devbox.sealos.io 端口号：3000（默认Web服务端口） SSH端口：2222（需手动开启） ``` ### 二、Cursor 连接步骤 1. **安装插件** - 在 Cursor 插件市场搜索「Sealos Devbox Connector」并安装 - 重启 IDE 后会在侧边栏出现 Sealos 图标 2. **建立连接** ```yaml # 连接配置示例 connection: type: ssh host: your-project.devbox.sealos.io port: 2222 user: devbox-user auth: key-based # 密钥自动从Sealos账户同步 ``` - 通过插件界面输入上述参数，支持自动补全项目信息[^3] 3. **环境验证** - 连接成功后，在 Cursor 终端执行： ```bash devbox status # 应返回运行环境信息 ``` - 文件系统会自动挂载到 `/workspace` 目录 ### 三、高级配置 1. **端口转发** 在 Devbox 网络设置中添加： ```json { "localPort": 8080, "remotePort": 3000, "protocol": "http" } ``` - 支持同时配置开发端口（3000）和调试端口（9229） 2. **协作开发** - 通过「成员权限」添加协作者邮箱 - 支持多人实时协同编码（需开启Session Sharing） ### 四、常见问题排查 - **连接超时**：检查防火墙是否开放2222端口 - **认证失败**：在 Sealos 控制台重新生成SSH密钥对 - **文件同步异常**：执行 `devbox sync --reset`
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值