codercom/code-server
在任何设备上运行VS Code并通过浏览器访问，提供跨设备一致的开发环境，支持利用远程服务器资源提升开发效率。
让 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 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
code-server Docker镜像文档
概述
code-server Docker镜像是一个允许在任何机器上运行https://github.com/Microsoft/vscode%E5%B9%B6%E9%80%9A%E8%BF%87%E6%B5%8F%E8%A7%88%E5%99%A8%E8%AE%BF%E9%97%AE%E7%9A%84%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88%E3%80%82%E5%AE%83%E6%89%93%E7%A0%B4%E4%BA%86%E8%AE%BE%E5%A4%87%E9%99%90%E5%88%B6%EF%BC%8C%E8%AE%A9%E7%94%A8%E6%88%B7%E5%8F%AF%E4%BB%A5%E5%9C%A8Chromebook%E3%80%81%E5%B9%B3%E6%9D%BF%E3%80%81%E7%AC%94%E8%AE%B0%E6%9C%AC%E7%AD%89%E5%90%84%E7%B1%BB%E8%AE%BE%E5%A4%87%E4%B8%8A%E4%BD%BF%E7%94%A8%E4%B8%80%E8%87%B4%E7%9A%84%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%EF%BC%8C%E6%89%80%E6%9C%89%E6%93%8D%E4%BD%9C%E9%80%9A%E8%BF%87%E6%B5%8F%E8%A7%88%E5%99%A8%E5%AE%8C%E6%88%90%E3%80%82
核心功能与特性
随时随地编码
- 在Chromebook、平板和笔记本电脑上使用一致的开发环境
- 在Linux机器上开发，可从任何具有网页浏览器的设备继续工作
服务器驱动
- 利用大型云服务器加速测试、编译、下载等任务
- 外出时节省设备电量，所有密集型任务在服务器上运行
- 将闲置电脑转变为完整的开发环境
使用场景
- 跨设备开发：需要在办公电脑、家用设备、移动设备间保持一致开发体验的开发者
- 资源优化：希望利用远程服务器资源（如更高配置的云服务器）提升开发效率的用户
- 设备复用：将闲置硬件（如旧电脑）转化为可用开发环境的场景
使用方法
基本部署示例
以下命令将启动code-server容器，并通过http://127.0.0.1:8080访问。它会挂载本地配置目录和当前工作目录，确保文件权限与宿主机一致，并保留用户配置。
bash# 创建配置目录（若不存在） mkdir -p ~/.config # 启动code-server容器 docker run -it --name code-server -p 127.0.0.1:8080:8080 \ -v "$HOME/.config:/home/coder/.config" \ # 挂载配置目录，确保外部可修改code-server配置 -v "$PWD:/home/coder/project" \ # 挂载当前目录到容器内的项目目录 -u "$(id -u):$(id -g)" \ # 转发宿主机用户UID/GID，确保文件系统操作权限一致 -e "DOCKER_USER=$USER" \ # 传递宿主机用户名到容器环境变量 codercom/code-server:latest
参数说明
| 参数 | 说明 |
|---|---|
-p 127.0.0.1:8080:8080 | 将容器的8080端口映射到本地8080端口，仅限本地访问 |
-v "$HOME/.config:/home/coder/.config" | 挂载宿主机~/.config目录到容器内，确保code-server配置文件（位于~/.config/code-server/config.json）可在外部修改 |
-v "$PWD:/home/coder/project" | 将宿主机当前工作目录挂载到容器内的/home/coder/project，作为开发项目目录 |
-u "$(id -u):$(id -g)" | 设置容器内运行用户的UID和GID与宿主机一致，避免文件权限冲突 |
-e "DOCKER_USER=$USER" | 将宿主机用户名传递到容器内，用于身份标识 |
开源依赖
本镜像使用以下开源依赖：
- https://github.com/microsoft/vscode%EF%BC%88MIT%E8%AE%B8%E5%8F%AF%E8%AF%81%EF%BC%89
- 更多依赖归因请参考：[***]
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 code-server 镜像标签
DockerHub 原生拉取命令
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
"Docker访问体验非常流畅，大镜像也能快速完成下载。"