云开发环境搭建指南

概述

本指南将带您完成云开发环境的完整搭建流程，从账号绑定到使用 VSCode 连接云端实例进行开发。整个过程大约需要 15 分钟。

什么是云开发环境？

云开发环境是运行在云端的开发实例，具有以下优势：

• 高性能配置：8核CPU + 16GB内存，满足大部分开发需求
• 成本优势：年费仅需 ¥600-1200，相比主流云服务商节省 70% 以上
• 随时随地：通过 VSCode Remote SSH 连接，轻薄本也能拥有工作站级别体验
• 环境隔离：独立的开发环境，支持多项目并行开发

前置条件

• 有效的用户账号
• 已安装 EZ CLI（安装指南）
• 已安装 VSCode
• 稳定的网络连接

视频教程概览

本指南包含以下关键步骤的视频演示：

• EZ CLI 安装：Ubuntu 系统下的安装过程
• 创建开发实例：使用命令行和网页两种方式
• SSH 密钥配置：自动生成和配置连接密钥
• VSCode 远程连接：通过 Remote SSH 连接云端实例

环境准备

绑定用户账号

访问用户中心

首先访问用户中心进行账号绑定：

👉 用户中心 - 账号管理

绑定账号信息

在用户中心完成以下信息绑定：

• 用户名：设置您的用户名（用于 EZ CLI 登录）
• 密码：设置安全密码
• 邮箱：绑定邮箱地址（用于接收通知）
• 手机号：绑定手机号（用于安全验证）

验证账号

完成绑定后，使用 EZ CLI 验证账号是否可用：

ez user login

输入您在用户中心设置的用户名和密码，成功登录后会显示：

Login successed.

购买开发实例套餐

选择套餐

访问实例管理页面选择合适的套餐：

👉 用户中心 - 开发资源

推荐套餐

我们提供以下开发实例套餐：

完成购买

1. 选择合适的套餐配置
2. 选择购买时长（建议选择年付享受优惠）
3. 确认订单信息
4. 完成支付

购买成功后，您可以在开发实例中创建实例，或者使用EZ CLI进行创建。

网页版创建演示

您也可以通过网页版用户中心创建开发实例：

实例创建

查看可用资源

首先查看可用的镜像和实例类型：

# 查看可用镜像
ez dg images
 
# 查看实例类型
ez dg types
 
# 查看可用区域
ez dg regions

创建开发实例

使用 ez dg create 命令创建开发实例：

# 基础创建命令
ez dg create -m ubuntu20.04 -n "我的开发环境"
 
# 指定区域和实例类型
ez dg create -m ubuntu20.04 -n "Python开发环境" -r gz -t 8

参数说明：

• -m, --image：镜像ID（必需）
• -n, --note：实例备注
• -r, --region：区域（gz=广州，sh=上海，bj=北京）
• -t, --type：实例类型ID

查看创建结果

创建成功后，查看实例列表：

ez dg ls

输出示例：

== My Devgrounds ==
id  Name        Note          Size   Image         IP          State
1   dev-001     我的开发环境   8C16G  ubuntu20.04   10.32.1.10  running

记住实例的 ID（如上例中的 1），后续步骤会用到。

命令行创建演示

以下视频演示了使用 EZ CLI 创建开发实例的完整过程：

SSH 连接配置

生成SSH密钥

为了安全便捷地连接开发实例，需要生成SSH密钥：

ez dg kengen -i 1

将 1 替换为您的实例ID。

命令执行后会自动完成以下操作：

1. 生成SSH密钥对（公钥和私钥）
2. 将公钥上传到开发实例
3. 配置本地SSH客户端
4. 创建SSH连接别名

成功后会显示：

SSH key pair generated and configured successfully!
You can now connect using: ssh dg-1

SSH 密钥生成演示

以下视频演示了 SSH 密钥的生成和配置过程：

VSCode 环境配置

安装VSCode

如果您还没有安装VSCode，请访问官网下载：

👉 VSCode 官方下载

选择适合您操作系统的版本进行下载安装。

安装Remote SSH插件

1. 打开VSCode
2. 点击左侧扩展图标（或按 Ctrl+Shift+X）
3. 搜索 "Remote - SSH"
4. 点击安装 Microsoft 官方的 Remote - SSH 插件

验证插件安装

安装成功后，您会在VSCode左下角看到一个绿色的连接图标。

连接云开发实例

打开SSH连接

1. 按 Ctrl+Shift+P（Mac: Cmd+Shift+P）打开命令面板
2. 输入 "Remote-SSH: Connect to Host"
3. 选择该命令

选择连接目标

在弹出的列表中，您应该能看到之前生成的SSH别名：

dg-1 (10.32.1.10)

点击选择该连接。

连接到实例

1. VSCode会打开一个新窗口开始连接
2. 首次连接可能需要选择操作系统类型（选择 Linux）
3. 等待连接建立和远程扩展安装完成

验证连接

连接成功后：

• VSCode左下角会显示 "SSH: dg-1"
• 可以打开终端（Ctrl+`` ）查看远程系统信息
• 可以打开文件夹开始开发

VSCode 远程连接演示

以下视频演示了使用 VSCode Remote SSH 连接云开发实例的完整过程：

开发环境配置

安装开发工具

连接成功后，您可以在云端实例安装所需的开发工具：

# 更新系统
sudo apt update && sudo apt upgrade -y
 
# 安装常用开发工具
sudo apt install -y git curl wget vim build-essential
 
# 安装Node.js
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
 
# 安装Python开发环境
sudo apt install -y python3 python3-pip python3-venv
 
# 安装Docker
curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker $USER

配置Git

git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

安装VSCode扩展

在远程环境中安装常用的VSCode扩展：

• Python
• JavaScript/TypeScript
• Docker
• GitLens
• Prettier
• ESLint

GitHub 配置（可选）

如果您需要在云开发环境中使用 GitHub，建议配置专用的 SSH 密钥：

生成 GitHub 专用密钥

# 在云端实例中生成 GitHub 专用密钥
ssh-keygen -t ed25519 -C "your.email@example.com" -f ~/.ssh/github
 
# 配置 SSH config 文件
cat >> ~/.ssh/config << EOF
Host github.com
    HostName github.com
    User git
    IdentityFile ~/.ssh/github
    IdentitiesOnly yes
EOF

添加公钥到 GitHub

# 查看生成的公钥
cat ~/.ssh/github.pub

将输出的公钥内容复制到 GitHub 的 SSH Keys 设置中。

GitHub SSH 配置演示

以下视频演示了 GitHub SSH 密钥的生成和配置过程：

故障排除

连接问题

问题：SSH连接失败 解决方案：

# 检查实例状态
ez dg ls
 
# 重新生成SSH密钥
ez dg kengen -i 1
 
# 手动测试SSH连接
ssh dg-1

问题：VSCode连接超时 解决方案：

1. 检查网络连接
2. 确认实例正在运行
3. 重启VSCode后重新连接

性能优化

问题：连接延迟较高 解决方案：

1. 选择距离较近的区域
2. 检查本地网络质量
3. 使用有线网络连接

总结

视频教程总结

本指南包含了以下关键步骤的视频演示：

下一步

恭喜！您已经成功搭建了云开发环境。现在您可以：

1. 开始开发项目：在云端创建和管理您的代码项目
2. 团队协作：邀请团队成员访问共享的开发环境
3. 学习教程：访问 教程中心 学习更多技能
4. 管理实例：通过 用户中心 管理您的实例
5. 观看视频：重复观看本指南中的视频演示加深理解

获取帮助

如果在搭建过程中遇到问题：

• 查看 用户手册 了解详细命令说明
• 访问 常见问题 查找解决方案
• 联系技术支持：support@32cloud.cn

现在开始享受高效便捷的云端开发体验吧！