lsiodev/vscodium

linuxserver/vscodium

VSCodium是社区驱动的、自由许可的Microsoft VS Code编辑器二进制发行版。本镜像由LinuxServer.io提供，基于KasmVNC实现Web界面访问，支持多架构部署，具备定期更新、用户权限映射和安全加固等特性。

!https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/vscodium-icon.png

支持的架构

该镜像利用Docker manifest实现多平台支持，拉取lscr.io/linuxserver/vscodium:latest即可自动获取对应架构的镜像，也可通过标签指定具体架构：

应用设置

应用可通过以下地址访问：

• [***]
• [***]

KasmVNC基础GUI容器的通用选项

本容器基于https://github.com/linuxserver/docker-baseimage-kasmvnc%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%94%AF%E6%8C%81%E4%BB%A5%E4%B8%8B%E9%A2%9D%E5%A4%96%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%E5%92%8C%E8%BF%90%E8%A1%8C%E9%85%8D%E7%BD%AE%EF%BC%9A

可选环境变量

可选运行配置

无损模式

将流质量预设改为"Lossless"可实现浏览器端无损图像传输，详情见技术背景。非本地访问需使用3001 HTTPS端口；反向代理至3000端口时需设置特定 headers，详见https://github.com/linuxserver/docker-baseimage-kasmvnc#lossless%E3%80%82

使用方法

docker-compose（推荐）

yaml
---
version: "2.1"
services:
  vscodium:
    image: lscr.io/linuxserver/vscodium:latest
    container_name: vscodium
    cap_add:
      - IPC_LOCK
    security_opt:
      - seccomp:unconfined #可选
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
    volumes:
      - /path/to/config:/config
    ports:
      - 3000:3000
      - 3001:3001
    shm_size: "1gb"
    restart: unless-stopped

docker cli

bash
docker run -d \
  --name=vscodium \
  --cap-add=IPC_LOCK \
  --security-opt seccomp=unconfined `#optional` \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -p 3000:3000 \
  -p 3001:3001 \
  -v /path/to/config:/config \
  --shm-size="1gb" \
  --restart unless-stopped \
  lscr.io/linuxserver/vscodium:latest

参数说明

容器运行参数格式为<外部>:<内部>，以下是主要参数说明：

Portainer注意事项

本镜像需使用cap_add或sysctl配置，部分Portainer版本可能不支持，导致部署失败。

环境变量文件（Docker secrets）

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

bash
-e FILE__PASSWORD=/run/secrets/mysecretpassword

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

应用Umask设置

通过-e UMASK=022可覆盖容器内服务的默认umask设置，详情参考umask说明。

用户/组ID

使用卷挂载时，可通过PUID和PGID指定容器内用户权限，避免主机与容器权限冲突。通过id user命令获取主机用户ID：

bash
$ id username
  uid=1000(dockeruser) gid=1000(dockergroup) groups=1000(dockergroup)

Docker Mods

![Docker Mods]([] ![Docker Universal Mods]([]

可通过Docker Mods扩展容器功能，详见可用Mods。

支持信息

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

更新说明

通过Docker Compose

• 更新所有镜像：docker-compose pull
• 更新单个镜像：docker-compose pull vscodium
• 重启容器：docker-compose up -d（或docker-compose up -d vscodium更新单个容器）
• 清理旧镜像：docker image prune

通过Docker Run

• 更新镜像：docker pull lscr.io/linuxserver/vscodium:latest
• 停止容器：docker stop vscodium
• 删除容器：docker rm vscodium
• 重新创建容器（保留/config卷则配置不会丢失）
• 清理旧镜像：docker image prune

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

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

镜像更新通知 - Diun

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

本地构建

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

ARM架构构建（需在x86_64主机安装multiarch/qemu-user-static）：

bash
docker run --rm --privileged multiarch/qemu-user-static:register --reset
docker build -f Dockerfile.aarch64 -t lscr.io/linuxserver/vscodium:arm64v8-latest .

版本历史

• 02.04.23: 初始发布