前言

如果你平时写代码的场景比较杂——今天在台式机、明天可能换个地方用笔记本、有时候干脆只想拿 iPad 应急——大概率会遇到这么一个问题：每换一台设备就得重新配一遍环境，插件、主题、快捷键习惯全得从头来。

code-server 解决的就是这件事。它是一个把 Visual Studio Code 跑在服务器上、然后通过浏览器访问的开源项目。换句话说，你打开任何一个设备的浏览器，连上服务器地址，输入密码，进去就是那套你熟悉的 VS Code 界面——插件在、配置在、文件在，连终端都是同一套。

这个组合的实际好处比较实在：代码不落在本地上，服务器开着就能随时连；多设备之间不存在环境不一致的问题；搭在低配机器上也不会因为本地性能吃紧而卡顿。部署方式用 Docker，一条命令拉起来，整个过程不到十分钟。

cpolar 在这里负责解决访问通道的问题——服务器在局域网里，外网访问不到，内网穿透把它映射到公网地址，不管在哪都能连上来。接下来直接看怎么搭。

1.什么是code-server？

code-server是一个开源项目，它将Microsoft Visual Studio Code（VS Code） 运行在远程服务器上，并通过Web浏览器 提供访问能力。简单来说：

code-server = VS Code + 浏览器访问 + 云端运行

核心特点

特性	说明
✅ 完整 VS Code 体验	支持扩展市场、调试器、终端、Git、主题等几乎所有原生功能
💕轻量易部署	官方提供 Docker 镜像，一条命令即可启动
🌐 跨平台访问	只要有浏览器（手机、平板、Chromebook、Windows/Mac/Linux），就能写代码
💻 统一开发环境	代码、配置、依赖全部部署在服务器，避免“在我机器上能跑”的问题
🔒 私有部署	数据完全掌握在自己手中，不依赖第三方云 IDE（如 GitHub Codespaces）

工作原理

• 你在服务器（本地、云主机、NAS 等）上运行 code-server
• code-server 启动一个 Web 服务（默认端口 8080）
• 你通过浏览器访问 http://你的服务器IP:8080
• 输入密码后，即可在网页中使用 VS Code 界面操作服务器上的文件

典型使用场景

• 远程开发：在家连接公司/实验室的高性能服务器写代码
• 教学演示：老师一键分发统一编程环境给学生
• 移动办公：用 iPad + 键盘随时随地编码
• 资源受限设备：在低配笔记本或树莓派上通过浏览器使用强大 IDE
• 团队共享环境：快速为新成员提供预装工具链的开发沙箱

技术栈简述

• 基于 VS Code 的开源版本（OSS） 构建
• 使用 Node.js 和 TypeScript 开发
• 通过 WebSocket 实现编辑器与浏览器的实时同步
• 支持 Linux / macOS / Windows / Docker / Kubernetes 部署

2.安装docker

安装Docker：

curl -fsSL https://get.docker.com/ | sh

启用Docker服务：

systemctl enable --now docker

检查Docker状态：

systemctl status docker

3.部署code-server

3.1 安装code-server

使用以下命令下载最新的code-server镜像：

docker pull codercom/code-server:latest

启动code-server容器：

docker run -d \
 --name code-server \
 -p 8000:8080 \
 -e PASSWORD=123456 \
 -v /docker/vscode/data:/root/.vscode-server \
 codercom/code-server:latest

验证部署，打开docker发现确实已经启动容器啦：

部署完成后，在浏览器中输入 http://localhost:8008 就能看到code-server的界面：

3.2 使用code-server

使用启动命令的密码“123456”登录：

登录成功后，同意协议并进行下一步：

安装中文版vscode:

点击如图所示：

选择中文版。

然后就成功啦！

搜索“Live Server”安装，为了后续查看页面效果：

可以新建一个文件，创造页面看看：

也可以使用终端：

code-server是一个强大的工具，它让你可以在任何设备的浏览器中运行完整的VS Code开发环境。但默认情况下，code-server只能在本地访问（如 http://localhost:8080），无法从外部网络直接使用。

这时候，你就需要一个内网穿透工具——而cpolar正是为此而生。

4.安装cpolar实现随时随地开发

4.1 什么是cpolar？

cpolar是一款安全高效的内网穿透工具，无需公网IP或复杂配置，只需一条命令，即可将本地服务器、Web服务或任意端口映射到公网，让你随时随地远程访问内网应用，特别适合开发调试、远程运维和应急部署等场景。

4.2 部署cpolar

cpolar 可以将你本地电脑中的服务（如 SSH、Web、数据库）映射到公网。即使你在家里或外出时，也可以通过公网地址连接回本地运行的开发环境。

❤️以下是安装cpolar步骤：

使用一键脚本安装命令：

sudo curl https://get.cpolar.sh | sh

安装完成后，执行下方命令查看cpolar服务状态：（如图所示即为正常启动）

sudo systemctl status cpolar

Cpolar安装和成功启动服务后，在浏览器上输入虚拟机主机IP加9200端口即:【http://ip:9200】访问Cpolar管理界面，使用Cpolar官网注册的账号登录,登录后即可看到cpolar web 配置界面,接下来在web 界面配置即可：

打开浏览器访问本地9200端口，使用cpolar账户密码登录即可,登录后即可对隧道进行管理。

5.配置公网地址

登录cpolar web UI管理界面后,点击左侧仪表盘的隧道管理——创建隧道：

• 隧道名称：可自定义，本例使用了:vscode，注意不要与已有的隧道名称重复
• 协议：http
• 本地地址：8000
• 域名类型：随机域名
• 地区：选择China Top

创建成功后，打开左侧在线隧道列表,可以看到刚刚通过创建隧道生成了公网地址，接下来就可以在其他电脑或者移动端设备（异地）上，使用地址访问。

访问成功。

6.保留固定公网地址

使用cpolar为其配置二级子域名，该地址为固定地址，不会随机变化。

点击左侧的预留，选择保留二级子域名，地区选择china Top，然后设置一个二级子域名名称，我使用的是vscode，大家可以自定义。填写备注信息，点击保留。

登录cpolar web UI管理界面，点击左侧仪表盘的隧道管理——隧道列表，找到所要配置的隧道，点击右侧的编辑。

修改隧道信息，将保留成功的二级子域名配置到隧道中

• 域名类型：选择二级子域名
• Sub Domain：填写保留成功的二级子域名
• 地区: China Top

点击更新

更新完成后，打开在线隧道列表，此时可以看到随机的公网地址已经发生变化，地址名称也变成了保留和固定的二级子域名名称。

最后，我们使用固定的公网地址在任意设备的浏览器中访问，可以看到成功访问的页面，这样一个永久不会变化的二级子域名公网网址即设置好了。

总结

code-server 加上 cpolar 这套组合，解决的其实是两个独立的问题：前者把 VS Code 变成浏览器里的应用，后者让这个应用在任何网络环境下都能访问。两者配合起来，构成了一个完整可用的云端开发环境。

从实际体验来看，code-server 保留了 VS Code 几乎全部的核心功能，扩展市场、终端、Git、调试器这些都在，界面和桌面版基本一致。对于需要多设备切换、或者服务器本身性能更强的场景，这个方案比传统本地开发更灵活。cpolar 的作用是扫掉网络限制这道障碍，装完配好之后不需要再动什么。

总体来说，这套方案的适用人群比较明确：有远程开发需求、不想被设备绑死、或者需要为他人快速搭建统一编码环境的开发者或者团队。配置起来不算复杂，愿意折腾一下的话可以试试。