Sealos Devbox ：从零搭建云原生研发环境

一、什么是 Sealos Devbox？

Sealos Devbox 是基于 Kubernetes 的云端一体化开发环境，提供以下核心能力：

• 开箱即用的开发环境：预装常用开发工具（Node.js、Python、Docker 等）
• 自动 HTTPS 与域名管理：无需手动配置 SSL 证书
• 实时协作开发：支持多开发者共享环境
• 智能资源调度：按需自动伸缩 CPU/内存
• AI 工具集成：与 Cursor、Bolt.new 等 AI 编程工具深度联动

---

二、快速上手指南

1. 注册与登录

1. 访问 Sealos 官网
2. 点击右上角「注册」，通过邮箱或 GitHub 登录
3. 创建组织/个人项目空间

2. 创建开发环境

步骤：

1. 进入控制台 → 点击「新建项目」
2. 选择运行环境：
   • Web 开发：Next.js、Vue、React
   • 后端服务：Laf 云函数、Go、Python
   • 数据科学：Jupyter Notebook + GPU 支持
3. 配置资源：

   CPU: 2核（开发推荐）
   内存: 4GB（最小可用 1GB）
   存储: 20GB（可扩展）

4. 点击「创建」，等待 30s 自动部署

有以下模板可以选择：

成果：

• 自动生成 HTTPS 域名（如：projectname.sealoshzh.site）
• 自动注入环境变量（NEXT_PUBLIC_API_URL 等）
• 可通过 ssh dev@your-domain 直接连接

---

三、开发流程实战

1. 与 Cursor 深度集成

初始化项目：

# 通过 Cursor 插件连接 Devbox
File > Open Remote > Use Devbox

需要下载插件：

创建一个模板后右上角选择Cursor就可以直接跳转到Cursor中，这里也可以选择其他编译器如VSCode等：

2. 调试与测试

• 实时预览：修改代码后自动刷新浏览器
• 网络调试：在 Devbox 控制台查看：

  NETWORK 标签 → 查看请求日志

• 性能监控：通过 top 或 htop 查看资源占用

3. 集成 AI Proxy

1. 获取 API 密钥：

   # 在 Devbox 控制台生成
   API_ENDPOINT: aiproxy.hzh.sealos.run
   API_KEY: sk-xxxxxxx

2. 配置环境变量：

   NEXT_PUBLIC_AI_API_URL="https://aiproxy.hzh.sealos.run"
   NEXT_PUBLIC_API_KEY="sk-xxxxxxx"

---

四、发布与部署

1. 版本管理

1. 在 Devbox 项目详情页点击「发布版本」
2. 配置：

   版本号: v1.0.0
   环境参数: 弹性伸缩（流量高峰自动扩容）

3. 自动触发 CI/CD 流水线

2. 自定义域名绑定

1. 登录阿里云/Cloudflare
2. 添加 CNAME 记录：

   Host: www.yourdomain.com
   Value: projectname.sealoshzh.site

3. 在 Devbox 中验证解析：

   curl -v www.yourdomain.com

3. 弹性伸缩配置

1. 在「部署模式」中选择：

   最小实例: 1
   最大实例: 10
   CPU 阈值: 80%

2. 模拟压力测试：

   ab -n 1000 -c 100 http://your-domain/api/test

---

五、高级功能

1. 容器化开发

1. 创建 Dockerfile：

   FROM node:18
   WORKDIR /app
   COPY . .
   CMD ["npm", "start"]

2. 构建镜像：

   docker build -t your-image-name .

3. 推送至私有仓库：

   docker push registry.sealos.io/your-project

2. 持续集成

1. 在 .github/workflows 中添加：

   name: CI/CD
   on: [push]
   jobs:
     build:
       runs-on: ubuntu-latest
       steps:
         - uses: actions/checkout@v3
         - name: Deploy to Devbox
           uses: sealos/actions/deploy@main

3. 多环境管理

# 开发环境
DEVBOX_ENV=dev npm start
# 生产环境
DEVBOX_ENV=prod npm start

---

六、常见问题

1. 无法访问公网？

# 检查路由表
ip route show
# 测试 DNS 解析
nslookup google.com

2. 项目启动失败？

1. 查看日志：

   journalctl -u devbox-service

2. 检查依赖：

   npm ls --depth=0

3. 如何节省成本？

# 设置自动关机
crontab -e
0 0 * * * systemctl stop devbox

---

七、典型应用场景

案例：AI 古诗游戏开发

1. 使用 Bolt.new 初始化项目：

   npx create-next-app@latest poetry-game

2. 集成 AI Proxy：

   // pages/api/generate.ts
   const res = await fetch(`${process.env.AI_API_URL}/v1/completions`, {
     headers: {
       Authorization: `Bearer ${process.env.API_KEY}`,
       'Content-Type': 'application/json'
     },
     body: JSON.stringify({
       model: "gpt-3.5-turbo",
       prompt: "生成一首关于秋天的绝句"
     })
   })

3. 添加响应式设计：

   npm install styled-components

---

八、资源推荐

1. 官方文档：https://docs.sealos.io
2. Cursor 教程：Cursor 与 Devbox 深度整合指南
3. 社区案例：
   • Next.js 博客系统
   • Laf 云函数模板