lsiodev/openvscode-server

linuxserver/openvscode-server

镜像概述和主要用途

https://github.com/gitpod-io/openvscode-server 提供VS Code的服务器版本，可在远程机器运行并通过现代浏览器访问。LinuxServer.io团队维护的此镜像具备定期更新、用户权限映射、安全增强等特性，适用于远程开发环境搭建。

核心功能和特性

• 多架构支持：兼容x86-64、arm64、armhf架构
• 灵活版本控制：提供稳定版（latest）和预览版（insiders）标签
• 安全访问控制：支持通过令牌或密钥文件限制Web UI访问
• 用户权限管理：通过PUID/PGID实现容器内用户与宿主机用户权限映射
• 定期更新：包含应用程序更新、基础操作系统更新和安全补丁
• sudo支持：可配置sudo密码，允许容器内终端使用管理员权限
• 集成支持：支持GitHub SSH密钥配置及反向代理场景

支持的架构

版本标签

应用设置

• Web UI访问：

  • 若设置CONNECTION_TOKEN或CONNECTION_SECRET环境变量，访问地址为http://<your-ip>:3000/?tkn=supersecrettoken（替换supersecrettoken为实际值）
  • 未设置令牌时，直接访问http://<your-ip>:3000

• GitHub集成：

  1. 将SSH密钥放入/config/.ssh目录
  2. 从顶部菜单打开终端，执行以下命令配置用户名和***：

  bash
  git config --global user.name "username"
  git config --global user.email "email address"
  

• 反向代理配置： 通过SWAG反向代理时，需创建*.openvscode-server.domain.com的通配符CNAME记录，并确保SWAG证书覆盖这些子域名，即可通过https://PORT.openvscode-server.domain.com访问容器内特定端口服务。

使用方法

Docker Compose（推荐）

yaml
---
version: "2.1"
services:
  openvscode-server:
    image: lscr.io/linuxserver/openvscode-server:latest
    container_name: openvscode-server
    environment:
      - PUID=1000               # 用户ID
      - PGID=1000               # 组ID
      - TZ=Europe/London        # 时区设置
      - CONNECTION_TOKEN=       # 可选，Web UI访问令牌
      - CONNECTION_SECRET=      # 可选，令牌文件路径（覆盖CONNECTION_TOKEN）
      - SUDO_PASSWORD=password  # 可选，sudo密码
      - SUDO_PASSWORD_HASH=     # 可选，sudo密码哈希（优先于SUDO_PASSWORD）
    volumes:
      - /path/to/appdata/config:/config  # 配置文件目录
    ports:
      - 3000:3000               # Web UI端口
    restart: unless-stopped

Docker CLI

bash
docker run -d \
  --name=openvscode-server \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Europe/London \
  -e CONNECTION_TOKEN= `#可选` \
  -e CONNECTION_SECRET= `#可选` \
  -e SUDO_PASSWORD=password `#可选` \
  -e SUDO_PASSWORD_HASH= `#可选` \
  -p 3000:3000 \
  -v /path/to/appdata/config:/config \
  --restart unless-stopped \
  lscr.io/linuxserver/openvscode-server:latest

参数说明

环境变量文件（Docker Secrets）

可通过FILE__前缀从文件加载环境变量，例如：

bash
-e FILE__PASSWORD=/run/secrets/mysecretpassword

将从/run/secrets/mysecretpassword文件内容设置PASSWORD环境变量。

应用程序Umask设置

通过-e UMASK=022可覆盖容器内服务的默认umask设置。Umask通过减去权限值生效，不直接等同于chmod，请参考umask说明。

用户/组标识符

使用卷（-v标志）时，可通过指定PUID（用户ID）和PGID（组ID）避免宿主机与容器间的权限问题。确保宿主机卷目录归属于指定的用户ID和组ID。

查看当前用户的PUID和PGID：

bash
id username

输出示例：uid=1000(dockeruser) gid=1000(dockergroup) groups=1000(dockergroup)

Docker Mods

https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=openvscode-server&query=%24.mods%5B%27openvscode-server%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml]([] https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=universal&query=%24.mods%5B%27universal%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml]([]

可通过Docker Mods扩展容器功能，上述徽章链接包含适用于此镜像的Mods列表。

支持信息

• 容器运行时Shell访问：docker exec -it openvscode-server /bin/bash
• 实时查看容器日志：docker logs -f openvscode-server
• 查看容器版本：docker inspect -f '{{ index .Config.Labels "build_version" }}' openvscode-server
• 查看镜像版本：docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/openvscode-server:latest

更新信息

通过Docker Compose更新

bash
# 更新所有镜像
docker-compose pull
# 或更新单个镜像
docker-compose pull openvscode-server
# 应用更新
docker-compose up -d
# 清理旧镜像
docker image prune

通过Docker Run更新

bash
# 拉取最新镜像
docker pull lscr.io/linuxserver/openvscode-server:latest
# 停止当前容器
docker stop openvscode-server
# 删除当前容器
docker rm openvscode-server
# 重新创建容器（保留/config目录则配置不会丢失）
docker run -d [原参数] lscr.io/linuxserver/openvscode-server:latest
# 清理旧镜像
docker image prune

通过Watchtower自动更新（仅推荐用于忘记原始参数时）

bash
docker run --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower \
  --run-once openvscode-server

注意：不建议使用自动更新工具，推荐使用Docker Compose进行管理。

镜像更新通知 - Diun

推荐使用Diun接收更新通知，不建议使用自动更新容器的工具。

本地构建

bash
git clone https://github.com/linuxserver/docker-openvscode-server.git
cd docker-openvscode-server
docker build \
  --no-cache \
  --pull \
  -t lscr.io/linuxserver/openvscode-server:latest .

在x86_64硬件上构建ARM变体：

bash
# 注册QEMU
docker run --rm --privileged multiarch/qemu-user-static:register --reset
# 构建特定架构
docker build -f Dockerfile.aarch64 -t lscr.io/linuxserver/openvscode-server:arm64v8-latest .

版本历史

• 12.02.22：更新install-extension工具以适应上游变更
• 04.02.22：更新1.64.0+版本二进制文件，支持无令牌访问，添加libsecret依赖
• 29.12.21：添加install-extension工具用于Mods安装扩展
• 10.12.21：更新已弃用的connectionToken参数
• 30.11.21：修复应用文件夹权限，添加sudo密码环境变量
• 29.11.21：为用户创建.profile和.bashrc文件
• 29.11.21：发布insiders标签
• 28.11.21：初始发布