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

随着技术的不断进步和人工智能的崛起,许多原本需要团队协作才能完成的任务现在都可以通过自动化和智能化的方式独立完成。因此,单个开发者的能力得到了显著提升——借助各种工具,一个人就能完成开发、测试、运维等全链路的工作,真正成为“全能工程师”。

我们之前分享了一些入门级的 Hello World 教程。今天,我将通过一个实际的业务案例来展示 Devbox 的强大之处,它不仅仅是一个开发玩具,而是一个真正的生产力工具。

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

开发环境

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

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

架构图

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

Golang 后端

创建开发环境

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

创建项目

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

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

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

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

连接开发环境

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

安装插件

导入项目到 Cursor

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

克隆项目

克隆项目

测试环境开发

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

数据库应用

然后创建 PostgreSQL 和 Redis 实例。

创建实例

创建实例

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

复制连接信息

在终端中启动服务:

bash
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 进行测试:

bash
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 删除操作会在同一个事务中完成。由于是在事务内进行,我们不需要担心删除失败或系统宕机导致的数据不一致问题。

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

bash
go build . && ./aiproxy –port 8080

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

bash

创建一个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 中设置启动命令,在文件中添加以下启动配置:

bash
cd sealos/service/aiproxy
export ADMIN_KEY=sealos-admin

可以再创建一个单独的生产环境数据库,与开发环境隔离

export SQL_DSN=<复制的pgsql连接串>/postgres
export REDIS_CONN_STRING=<复制的redis连接串>

使用编译好的二进制文件

./aiproxy –port 8080

设置启动命令

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

发布页面

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

部署应用

部署应用

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

公网地址

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

bash

这里使用的是生产环境的域名

curl https://jpesudzryuhp.sealosbja.site/api/tokens/ -H “Authorization: sealos-admin”

测试成功

完美!

Next.js 前端

前端项目搭建

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

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

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

修改 package.json

执行命令 pnpm i 安装依赖。

安装依赖

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

构建 client-sdk

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

切换目录

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

安装推荐插件

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

安装 aiproxy 依赖

对接后端环境

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

bash
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 数据如下:

json
{
“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 后端专注于核心业务逻辑,不需要关心认证等基础设施,从而提高了代码的灵活性和可移植性。

👉 野卡 | 一分钟注册,轻松订阅海外线上服务

(0)
上一篇 2025年3月15日
下一篇 2025年3月15日

相关推荐

  • Perplexity 新功能全解析:从入门到进阶

    Perplexity 有哪些神奇之处?本文将深入解析,并提供实用案例,助你挖掘 AI 潜力,提升工作效率。 Perplexity 最近推出了一系列令人惊艳的更新,今天我非常兴奋地与…

    文章 2025年5月27日
  • Cursor代码生成器中文使用指南:新手入门全攻略

    最近,苏米正式开始使用Cursor编程。之前一直依赖GPT-4和Claude 3.5进行对话式编程代码获取,而自从接触Cursor代码生成器后,繁琐的复制粘贴操作被彻底替代,直接对…

    2025年6月25日
  • 【全面指南】如何在OnlyFans订阅HongkongDoll?使用虚拟信用卡的详细教程

    OnlyFans如何使用虚拟卡充值?一文教你订阅博主(最新图文教程) 大家好,OnlyFans是一个备受欢迎的内容订阅服务平台,允许创作者通过粉丝的订阅获得收益。今天,我们将教大家…

    文章 2025年6月19日
  • Chipper Cash支付平台详解:2025年注册与使用指南

    一、Chipper Cash支付平台概述 Chipper Cash是一家成立于2018年的跨境移动汇款服务商,总部位于美国旧金山,主要面向非洲地区提供服务。由哈姆·塞伦乔吉(Ham…

    文章 2025年3月13日
  • 虚拟信用卡能否提现?

    虚拟信用卡通常无法直接提现,因为它主要用于在线消费并保护用户隐私。用户可以通过虚拟信用卡进行网上购物或支付,但无法像实体信用卡那样直接提取现金。如果需要现金,建议使用实体信用卡或其…

    2025年4月16日
  • 2025年最新Stripe账号申请与管理指南

    近年来,尽管PayPal已经相对普及,但在欧美地区,信用卡依然是主流的支付方式。根据我的经验,后台订单中大约40%是通过信用卡支付的,另外60%则使用PayPal。如果我们的独立站…

    文章 2025年5月31日
  • 关于 SubscribeStar 的 10 个有趣事实

    在当今数字时代,内容创作者需要一个可靠的平台来实现作品的货币化。对于那些寻求替代主流选择的人来说,SubscribeStar 是一个理想的选择。这个平台提供了独特的功能组合,旨在支…

    2025年4月14日
  • 虚拟信用卡合法性对消费者保护的影响

    虚拟信用卡的合法性为消费者提供了额外的安全保障,减少了个人信息泄露和欺诈风险。它们允许用户生成一次性或可控金额的卡号,从而降低在线交易的风险。消费者在遇到纠纷时更容易追溯和保护自己…

    文章 2025年5月22日
  • Notion AI 会员价格与功能详解

    现在,Notion AI 提供问答功能,加入任何付费会员计划的费用为每位会员每月 8 美元(按年计费)。如果选择按月计费,每位会员的费用为 10 美元。所有会员均可享受无限制使用的…

    文章 2025年6月25日
  • 手把手教你获取和使用 Claude API 密钥

    今天,我将与大家分享如何获取和使用 Claude API 密钥。作为一款强大的工具,Claude API 能够帮助我们更好地处理数据和进行分析,因此获取并正确使用 API 密钥至关…

    2025年2月19日
  • 十分钟轻松完成 Midjourney 付费订阅

    最新动态更新 2024/08/15 更新 请查看新的方式:ChatGPT4 充值渠道 FOMEPay 跑路?我找来了替代方案:野卡! 2024/08/14 更新 FOMEPay 疑…

    2025年7月5日
  • 如何安装 Winder(非程序员的 AI 编码助手)

    人工智能的出现为多个领域带来了显著的进步,其中之一就是代码编辑器的领域。最近推出的 Winder 是一款 AI 代码编辑器,旨在挑战现有竞争者如 Cursor AI 的主导地位。W…

    文章 2025年3月24日
  • 如何免费使用Cursor编辑器及其模型

    什么是Cursor编辑器? Cursor编辑器是一款基于GPT-4的智能编程工具,旨在通过自然语言处理能力为开发者提供代码建议。它支持多种编程语言,包括Python、Java、C/…

    2025年3月14日
  • 虚拟信用卡的概述与应用

    虚拟信用卡(Virtual Credit Card),也被称为虚拟VISA信用卡、VISA虚拟卡等,是为那些没有国际信用卡或对信用卡支付安全性有顾虑的用户而设计的产品。它适用于国外…

    2025年3月5日
  • Claude订阅使用指南:2025年国内如何充值购买Claude

    Claude是一款功能强大的AI对话模型,其最新版本Claude Sonnet 3.5在处理复杂指令、理解上下文以及生成自然文本方面表现尤为出色。许多人认为Claude Pro是C…

    2025年2月28日
  • 如何顺利订阅 ChatGPT Plus 会员?详细指南

    ChatGPT Plus 会员是 OpenAI 推出的付费订阅计划,提供更快的响应速度和更高质量的 GPT-4 访问权限,极大提升了用户体验。然而,许多国际用户在订阅过程中可能会遇…

    文章 2025年3月1日
  • 如何在国内使用 GPT-4.0?一键升级 GPT-4.0 的详细教程

    1. 升级到 GPT-4.0 的理由 1.1 GPT-4.0 的优势 更快的响应速度:与 3.5 版本相比,GPT-4.0 提供更快的响应,提升服务效率。 优先体验新功能:升级后可…

    文章 2025年5月5日
  • 为什么选择 野卡 虚拟信用卡?

    随着 ChatGPT、OpenAI、Claude 等 AI 工具在国内的普及,越来越多用户希望通过订阅这些服务来提升学习与工作效率。然而,许多用户在支付和订阅时面临诸多问题,比如支…

    文章 2025年4月29日
  • 美国虚拟Visa信用卡申请指南

    美国虚拟Visa信用卡是一种便捷、安全的支付方式,广泛用于在线购物、国际支付以及订阅服务。它不仅适合美国本地用户,也为国际用户提供了一种高效的跨境支付解决方案。以下是如何申请美国虚…

    2025年2月9日
  • ChatGPT 4.0 开通全方位指南

    本文将分享我(以及一些ChatGPT Plus爱好者和群友)亲身体验的ChatGPT Plus支付宝付费版升级流程,以及使用ChatGPT 4.0的感受。虽然价格较高,但绝对值得尝…

    文章 2025年6月28日