code-server：浏览器里运行 VS Code，随时随地云端开发

code-server：浏览器里运行 VS Code，随时随地云端开发

code-server 是将 VS Code 运行在服务器端、通过浏览器访问的开源项目。只要有网络，无论是 iPad、Chromebook，还是办公室的借用电脑，打开浏览器就能获得完整的 VS Code 开发体验：代码编辑、终端、Git 操作、调试——一切都在云端，本地无需安装任何开发环境。

本文将介绍如何用 Docker Compose 部署 code-server，配合 Caddy 实现 HTTPS 保护，并演示常见使用技巧。

服务器配置

code-server 本身轻量，2 核 4GB 机型足以应对轻量项目的编辑和运行；若需要在服务器内执行重型编译（如大型 C++ 项目、Rust 构建），建议选择 4 核 8GB 或更高配置。

推荐雨云服务器 rainyun-com，注册填优惠码2026off领 5 折优惠券，按量付费，随时可升配，是云端开发的理想选择。

安装 Docker：

curl-fsSLhttps://get.docker.com|shsudousermod-aGdocker$USERnewgrpdocker

Docker Compose 部署

mkdir-p~/code-server/workspace&&cd~/code-server

docker-compose.yml

version:"3.8"services:code-server:image:codercom/code-server:latestcontainer_name:code-serverrestart:unless-stoppedports:-"8080:8080"environment:-PASSWORD=your_strong_password-TZ=Asia/Shanghai-DOCKER_USER=codervolumes:# 持久化工作目录-./workspace:/home/coder/project# 持久化 VS Code 扩展和配置-code_server_config:/home/coder/.config-code_server_extensions:/home/coder/.local/share/code-server# 挂载宿主机 SSH Key（用于 GitHub）-~/.ssh:/home/coder/.ssh:rouser:"1000:1000"networks:-code_server_netnetworks:code_server_net:volumes:code_server_config:code_server_extensions:

关于user: "1000:1000"：确保容器内的coder用户与宿主机文件的属主一致，避免文件权限问题。1000是大多数 Linux 发行版第一个普通用户的 UID。

启动：

dockercompose up-ddockercompose logs-fcode-server

看到HTTP server listening on http://0.0.0.0:8080即成功。

配置 Caddy 反代

code-server 必须运行在 HTTPS 下，否则浏览器会限制剪贴板等功能。Caddy 自动处理 TLS：

sudoaptinstallcaddy-y

编辑/etc/caddy/Caddyfile：

code.yourdomain.com { reverse_proxy localhost:8080 # 开启 WebSocket 支持（终端和热更新需要） @websockets { header Connection *Upgrade* header Upgrade websocket } handle @websockets { reverse_proxy localhost:8080 } }

重载：

sudosystemctl reload caddy

将域名 A 记录解析到服务器 IP，等待 DNS 生效后访问https://code.yourdomain.com。

初始设置

1. 打开https://code.yourdomain.com，输入docker-compose.yml中设置的PASSWORD，点击Submit。
2. 进入熟悉的 VS Code 界面。
3. 左下角语言切换：Ctrl+Shift+P →Configure Display Language→ 选择zh-cn（需先安装中文扩展）。

修改密码

code-server 的密码在环境变量中配置，修改后重启容器生效：

# 修改 docker-compose.yml 中的 PASSWORD，然后：dockercompose restart code-server

或使用~/.config/code-server/config.yaml（挂载到容器内）：

bind-addr:0.0.0.0:8080auth:passwordpassword:your_new_passwordcert:false

使用指南

安装扩展

code-server 使用Open-VSX Registry（而非微软官方市场），大多数流行扩展都有同步版本：

1. 点击左侧 Extensions 图标（Ctrl+Shift+X）。
2. 搜索并安装常用扩展：
   • Python（ms-python.python）
   • Go（golang.go）
   • GitLens（eamodio.gitlens）
   • Prettier（esbenp.prettier-vscode）
   • Chinese (Simplified)（ms-ceintl.vscode-language-pack-zh-hans）
   • Remote SSH（不可用，但 code-server 本身就是远程方案）
3. 扩展安装在容器卷code_server_extensions中，重启容器后保留。

若某扩展在 Open-VSX 上不存在，可手动下载.vsix文件，通过 Extensions →...→Install from VSIX安装。

浏览器终端使用

• 打开终端：Ctrl+`或菜单Terminal → New Terminal。
• 终端完整运行在服务器内，可执行任意 Linux 命令：

# 安装 Python 依赖pipinstallflask requests# 运行开发服务器python app.py# 管理 Gitgitstatusgitadd.gitcommit-m"feat: initial commit"

Git Clone 项目

# 终端中cd/home/coder/projectgitclone https://github.com/your-org/your-repo.git

项目会出现在/home/coder/project/下，也对应宿主机的~/code-server/workspace/目录，文件直接持久化。

SSH Key 配置（连接 GitHub）

由于我们挂载了宿主机的~/.ssh目录，容器内可直接使用宿主机的 SSH 密钥：

1. 若宿主机还没有 SSH Key：

ssh-keygen-ted25519-C"your@email.com"cat~/.ssh/id_ed25519.pub

2. 将公钥添加到 GitHub → Settings → SSH and GPG Keys。
3. 在 code-server 终端中测试：

ssh-Tgit@github.com# 输出：Hi username! You've successfully authenticated...

4. 之后git clone git@github.com:...即可免密码操作。

在浏览器中工作的常用快捷键

部分快捷键会被浏览器截获，可用以下替代：

建议：在 Chrome 中使用"添加到主屏幕"功能，以 PWA 模式打开 code-server，可获得近似原生应用的体验，解决快捷键冲突。

多工作区配置

若想在一台服务器上为不同项目创建独立的 code-server 实例：

# 在 docker-compose.yml 中添加第二个服务code-server-2:image:codercom/code-server:latestcontainer_name:code-server-2ports:-"8081:8080"environment:-PASSWORD=another_passwordvolumes:-./workspace2:/home/coder/project-code_server_config_2:/home/coder/.config

在 Caddyfile 中为code2.yourdomain.com添加对应反代即可。

端口转发（预览本地服务）

code-server 内置了端口转发功能，可将容器内运行的 Web 服务暴露到浏览器：

1. 在终端内启动一个服务，如python -m http.server 5000。
2. VS Code 底部Ports面板自动检测到 5000 端口，点击Open in Browser。
3. 浏览器会在新标签中打开该服务（通过 code-server 代理）。

总结

code-server 是云端开发工作流的终极形态——一台服务器、一个域名，任何设备都能获得完整的开发环境。无需在本地配置 Node、Python、Go 等运行时，团队成员可共享同一环境配置，彻底告别"在我机器上是好的"问题。

稳定的服务器是云端开发的基石，雨云服务器 rainyun-com的2 核 4GB 机型对日常编辑任务绰绰有余，注册填优惠码2026off领 5 折，费用极低。不妨今天就搭建一套，彻底解放你的开发设备！