code-server快速入门

code-server 是社区创作的 Web 版 VS Code，后端运行在服务器中，开发者基于浏览器运行 IDE。

部署 创达睿通 提供的 code-server 之后，请参考下面的步骤快速入门。

准备​

1. 在云控制台获取您的 服务器公网IP地址

2. 在云控制台安全组中，确保 Inbound（入）规则 下的 TCP:80 端口已经开启

3. 在服务器中查看 code-server 的 默认账号和密码

4. 若想用域名访问 code-server，务必先完成 域名五步设置 过程

code-server 初始化向导​

详细步骤​

1. 使用本地 Chrome 或 Firefox 浏览器访问网址：http://域名 或 http://服务器公网IP, 进入登录页面

   
2. 输入密码，成功登录到 code-server 后台

   
3. 在 code-server 界面上打开 workspace 文件夹

   默认存放代码的根目录为：/data/apps/codeserver/data/code/workspace

   
4. 打开 Terminal，查看系统环境

   
5. 安装更多开发所需的组件

出现问题？​

若碰到问题，请第一时刻联系 技术支持。也可以先参考下面列出的问题定位或 FAQ 尝试快速解决问题。

code-server 使用入门​

下面以 Python 开发为范例，介绍如何使用 code-server：

1. 登录 code-server，在当前 WorkSpace 下克隆一个代码仓库

   git clone https://github.com/cdrt/ansible-wordpress.git

   
2. 在项目文件夹中新建一个文件，命名为：myfile.py，并拷贝下面的 Python 程序实例代码。

   #!/usr/bin/env python2
   #!/usr/bin/env python3
   #coding: utf-8
   
   import os, io, sys
   
   print("hello world")

   
3. 在【窗口的终端栏】中执行 python myfile.py 命令，运行 Python 程序

   
4. 查看正确的输出结果

需要了解更多 code-server 的使用，请参考官方文档：code-server Documentation

code-server 常用操作​

安装组件​

若默认环境不符合需求，可以直接通过 code-server 控制台安装组件，下面以 JAVA 为例进行说明：

1. 登录 code-server 控制台，在【Terminal】窗口中运行 sudo su 切换为 root 用户

   密码为 code-server 控制台登录密码

   
2. 更新 apt 仓库

   apt update

3. 安装并验证 Java

   #1 安装JRE
   apt-get install openjdk-8-jre
   
   #2 验证版本
   java -version

备份环境​

由于 code-server 基于容器运行，如果你打算将容器安装后的环境长期的备份下来，需要参考如下方式创建自定义容器镜像：

1. 登录服务器

2. 运行创建命令命令（基于 codeserver 容器创建一个名称为 codeserver-java 的镜像）

   #1 创建镜像
   sudo docker commit -m "add java" -a "your name" codeserver codeserver-java:latest
   
   #2 查看镜像
   sudo docker image ls

多开发者​

当前部署方案默认只有一个 code-server，由于它并不支持多用户，所以不合适多开发协同工作的场景。

那么如何才能支持多开发者协作使用 code-server 呢？从宏观上设计，需多开发者使用，每一名开发者分配如下资源即可实现此需求：

1. 单独分配一个宿主机的端口

2. 单独分配一个 code-server 目录

3. 单独运行一个 code-server 容器

下面是一个范例：

1. 运行下面的命令，将现有的 code-server 整个目录复制一份，命名为：/data/wwwroot/user1

   # 复制
   cd /data/wwwroot
   cp -r codeserver user1
   
   # 删除持久数据
   rm -rf user1/volumes

2. 修改 /data/wwwroot/user1/.env 文件中的 APP_PORT、APP_PASSWORD、APP_CONTAINER_NAME，然后保存

   APP_PORT=9001
   APP_PASSWORD=123456
   APP_CONTAINER_NAME=codeserver

   APP_PORT和APP_CONTAINER_NAME 必须与当前已经存在的 code-server 容器不同名称，否则无法创建

3. 启动新的 code-server 项目

   cd /data/wwwroot/user1
   sudo docker-compose  up -d

由于多用户协同开发有诸多个性化需求，无法在以上方案中一一列出，欢迎提出更多需求。

code-server 参数​

code-server 应用中包含 Nginx, Docker 等组件，可通过 通用参数表 查看路径、服务、端口等参数。

通过运行docker ps，可以查看到 code-server 运行时所有的 Container：

CONTAINER ID   IMAGE                                    COMMAND   CREATED          STATUS          PORTS                                       NAMES
81bb4aeed134   ghcr.io/linuxserver/code-server:latest   "/init"   23 minutes ago   Up 23 minutes   0.0.0.0:9001->8443/tcp, :::9001->8443/tcp   codeserver```

路径​

code-server 安装目录： /data/apps/codeserver code-server 数据目录： /data/apps/codeserver/data/code/data code-server 工作目录： /data/apps/codeserver/data/code/workspace code-server 扩展目录： /data/apps/codeserver/data/code/extensions

端口​

无特殊端口

版本​

sudo docker inspect codeserver | grep org.opencontainers.image.version | cut -d: -f2

服务​

sudo docker start | stop | restart | stats codeserver

命令行​

容器尚未安装 CLI

API​

无