cloudstudio/README.md

Run VS Code on a remote server.

# Cloud Studio

在任意机器任意地方运行 VS Code，并通过浏览器方式使用它。

## 特点

1. 在具有一致开发环境的任何设备上编写代码
1. 使用云服务器加速测试、编译、下载等
1. 通过浏览器远程开发

## 快速开始

目前提供另种方式安装 Cloud Studio，如下：
1. 安装脚本
1. Docker 镜像

#### 安装脚本

安装脚本相对比较灵活，可以方便与自定义场景结合使用。执行安装脚本方式如下：

```bash
curl -fsSL https://cs-res-1258344699.file.myqcloud.com/cloudstudio/releases/download/latest/install.sh | sh
```

您可以预览安装过程中发生的情况：

```bash
curl -fsSL https://cs-res-1258344699.file.myqcloud.com/cloudstudio/releases/download/latest/install.sh | sh -s -- --dry-run
```

您可以通过包含标志来修改安装过程。运行帮助命令以供参考：

```bash
curl -fsSL https://cs-res-1258344699.file.myqcloud.com/cloudstudio/releases/download/latest/install.sh | sh -s -- --help
```

您可以通过包含以下一个或多个标志来修改安装过程：

* --dry-run: 回显安装过程的命令而不运行它们。
* --method: 选择安装方式。
  * --method=detect：检测包管理器但回退到 --method=standalone.
  * --method=standalone：将独立的发布存档安装到~/.local.
* --prefix=/usr/local：在系统范围内安装一个独立的发布存档。
* --version=X.X.X：安装版本X.X.X而不是最新版本。
* --help：请参阅使用文档。

完成后，安装脚本会打印出运行和启动代码服务器的说明。

#### Docker 镜像

您也可以直接使用我们构建好的 Docker 镜像来运行 Cloud Studio。这些镜像支持 linux/amd64 和 linux/arm64 两种架构，镜像列表如下：

1. codingopen/cloudstudio:latest

运行 Dokcer 镜像的命令如下：

```bash
docker run -it -p 8080:8080 codingopen/cloudstudio:latest --auth=none
```

您可以通过包含标志来修改启动参数。运行帮助命令以供参考：

```bash
docker run -it -p 8080:8080 codingopen/cloudstudio:latest --help
```