linuxserver/vscode
linuxserver/vscode镜像提供在容器中运行完整VS Code桌面应用的能力，可通过Web界面访问，适用于便捷部署和管理的开发环境，支持持久化配置与权限控制。
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
linuxserver/vscode 镜像文档
镜像概述和主要用途
linuxserver/vscode是基于微软VS Code（Visual Studio Code）集成开发环境的Docker镜像。该镜像运行完整的VS Code桌面应用，区别于Web原生版本的Code Server，提供更接近本地桌面版的开发体验。用户可通过Web浏览器访问容器化的VS Code实例，适用于需要便捷部署、跨平台一致或团队共享的开发环境。
核心功能和特性
- 完整桌面应用：运行完整的VS Code桌面版本，而非简化的Web版本
- Web访问支持：通过HTTPS协议在浏览器中访问VS Code界面
- 持久化配置：配置文件通过卷挂载实现持久化存储
- 权限控制：支持通过PUID/PGID设置运行用户权限，确保文件访问权限正确
- 时区配置：可通过环境变量自定义容器时区
- 资源优化：支持配置共享内存大小，提升应用性能
使用场景和适用范围
- 快速搭建临时或持久的开发环境
- 团队共享统一配置的开发环境
- 跨平台开发环境一致性保障
- 资源受限环境下的轻量化开发部署
- 无需本地安装VS Code的临时开发需求
使用方法和配置说明
基本部署命令
bashdocker run -d \ --name=vscode \ --cap-add=IPC_LOCK \ -e PUID=1000 \ -e PGID=1000 \ -e TZ=Etc/UTC \ -p 3000:3000 \ -p 3001:3001 \ -v /path/to/vscode/config:/config \ --shm-size="1gb" \ --restart unless-stopped \ docker.xuanyuan.run/linuxserver/vscode:latest
参数说明
| 参数 | 说明 |
|---|---|
--name=vscode | 容器名称，可自定义 |
--cap-add=IPC_LOCK | 添加IPC_LOCK权限，确保应用正常运行 |
-e PUID=1000 | 运行容器的用户ID，建议设置为当前用户ID |
-e PGID=1000 | 运行容器的组ID，建议设置为当前用户组ID |
-e TZ=Etc/UTC | 容器时区设置，例如Asia/Shanghai表示中国时区 |
-p 3000:3000 | 应用内部端口映射 |
-p 3001:3001 | Web访问端口映射 |
-v /path/to/vscode/config:/config | 配置文件存储路径，替换/path/to/vscode/config为本地实际路径 |
--shm-size="1gb" | 共享内存大小，建议至少1GB以保证应用性能 |
--restart unless-stopped | 容器重启策略，除手动停止外均自动重启 |
访问应用
应用部署完成后，通过以下地址访问VS Code界面：
https://yourhost:3001/
（将yourhost替换为部署容器的主机IP或域名）
数据持久化
配置文件、扩展和工作区数据通过/config卷持久化存储，确保容器重建后数据不丢失。建议定期备份该目录以防止数据丢失。
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull linuxserver/vscode:<标签>
更多 vscode 镜像推荐
rocker/vscode
rocker
暂无描述
9 次收藏1万+ 次下载
4 年前更新
faasjs/vscode
faasjs
用于FaasJS项目的VSCode容器镜像。
1万+ 次下载
6 天前更新
alexdhill/vscode
alexdhill
基于VSCode的多用途开发套件，支持C++、Python、R语言及Notebooks功能，满足多语言开发与数据分析需求。
1万+ 次下载
3 年前更新
hewenyulucky/vscode
hewenyulucky
Web版本的VSCode，集成zsh，支持Go开发环境，可通过浏览器访问使用。
2 次收藏1万+ 次下载
3 年前更新
pahud/vscode
pahud
暂无描述
5万+ 次下载
4 年前更新
diverofdark/vscode
diverofdark
暂无描述
1 次收藏1万+ 次下载
6 年前更新
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"