aleleba/code-server

Aleleba Code-Server Docker镜像文档

1. 镜像概述

本镜像基于Codercom的Code-Server构建，提供Visual Studio Code的服务器版功能，允许用户通过浏览器访问VS Code界面。镜像支持自定义扩展安装，并可灵活部署或作为基础镜像扩展，适用于远程开发、团队协作等场景。

2. 核心功能与特性

• VS Code服务器功能：提供完整的VS Code网页版体验，支持代码编辑、终端操作等核心功能
• 自定义扩展支持：通过JSON配置文件批量安装VS Code扩展
• 灵活部署方式：支持直接通过docker run命令运行或使用Docker Compose编排
• 可扩展性：可作为基础镜像，添加额外工具和依赖（如Node.js、NVM等）

3. 使用场景

• 远程开发环境搭建，通过浏览器访问开发环境
• 团队统一开发环境配置，确保开发工具一致性
• 快速部署临时开发环境
• 构建包含特定工具链的自定义开发镜像

4. 使用方法

4.1 快速启动容器

1. 克隆仓库到本地（若需要修改配置）
2. 运行以下命令启动容器：

   bash
   docker run -it -v /path/to/extensions.json:/home/extensions.json aleleba/code-server
   

   注：/path/to/extensions.json为本地扩展配置文件路径，若无需自定义扩展，可省略该卷挂载

4.2 添加VSCode扩展

4.2.1 扩展配置文件格式

创建extensions.json文件，格式如下（仅uniqueIdentifier为必填项）：

json
[
    {
        "extensionsGroup": {
            "description": "扩展组描述",
            "extensions": [
                {
                    "name": "扩展名称",
                    "notes": "扩展说明",
                    "uniqueIdentifier": "扩展唯一标识符（VS Code市场ID）"
                }
            ]
        }
    }
]

4.2.2 示例配置

json
[
    {
        "extensionsGroup": {
            "description": "西班牙语语言包",
            "extensions": [
                {
                    "name": "Spanish Language Pack for Visual Studio Code",
                    "notes": "VS Code西班牙语语言包",
                    "uniqueIdentifier": "ms-ceintl.vscode-language-pack-es"
                }
            ]
        }
    },
    {
        "extensionsGroup": {
            "description": "GitHub Copilot套件",
            "extensions": [
                {
                    "name": "GitHub Copilot",
                    "notes": "AI代码补全工具",
                    "uniqueIdentifier": "github.copilot"
                },
                {
                    "name": "GitHub Copilot Chat",
                    "notes": "Copilot聊天功能",
                    "uniqueIdentifier": "github.copilot-chat"
                }
            ]
        }
    }
]

4.2.3 应用扩展配置

启动容器时挂载扩展配置文件：

bash
docker run -it -v /本地路径/extensions.json:/home/extensions.json aleleba/code-server

容器创建后将自动安装配置文件中指定的扩展。

4.3 使用Docker Compose

创建docker-compose.yml文件：

yaml
version: '3'

services:
  vscode:
    image: aleleba/code-server
    volumes:
      - /本地路径/extensions.json:/home/extensions.json

启动服务：

bash
docker-compose up -d

查看运行状态：

bash
docker ps  # 查看容器状态

4.4 作为基础镜像使用

可基于本镜像构建自定义开发环境，示例Dockerfile（安装NVM和Node.js）：

dockerfile
FROM aleleba/code-server:latest

# 安装Node.js和NVM
SHELL ["/bin/bash", "--login", "-i", "-c"]
RUN curl https://raw.githubusercontent.com/creationix/nvm/master/install.sh | bash
RUN nvm install --lts
RUN nvm alias default lts/*
SHELL ["/bin/sh", "-c"]
RUN echo 'source ~/.nvm/nvm.sh' >> ~/.bashrc

构建自定义镜像：

bash
docker build -t custom-code-server .