前言
在远程办公、云原生开发和多设备协同日益普及的今天,传统的本地IDE已难以满足灵活高效的开发需求。你是否曾希望:
- 在iPad或Chromebook上也能流畅写代码?
- 从任意设备访问统一的开发环境,无需重复配置?
- 快速为团队成员提供一致的编码平台?
code-server正是为此而生——它将强大的Visual Studio Code完整运行在服务器上,并通过浏览器提供访问能力,真正实现“代码在云端,开发在手边”。
本文将带你从零开始,基于Docker快速部署code-server,搭建一个安全、可持久化、随时可用的网页版VS Code开发环境。无论你是个人开发者、教育工作者,还是DevOps工程师,只需几分钟,即可拥有属于自己的在线IDE。
让我们开始吧!
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为其配置二级子域名(cpolar官网-安全的内网穿透工具 | 无需公网ip | 远程访问 | 搭建网站),该地址为固定地址,不会随机变化。
点击左侧的预留,选择保留二级子域名,地区选择china Top,然后设置一个二级子域名名称,我使用的是vscode,大家可以自定义。填写备注信息,点击保留。
登录cpolar web UI管理界面,点击左侧仪表盘的隧道管理——隧道列表,找到所要配置的隧道,点击右侧的编辑。
修改隧道信息,将保留成功的二级子域名配置到隧道中
- 域名类型:选择二级子域名
- Sub Domain:填写保留成功的二级子域名
- 地区: China Top
点击更新
更新完成后,打开在线隧道列表,此时可以看到随机的公网地址已经发生变化,地址名称也变成了保留和固定的二级子域名名称。
最后,我们使用固定的公网地址在任意设备的浏览器中访问,可以看到成功访问的页面,这样一个永久不会变化的二级子域名公网网址即设置好了。
总结
通过使用code-server,开发者可以快速在服务器或本地部署一个功能完整的网页版 VSCode,在浏览器中实现与桌面端一致的开发体验。结合cpolar内网穿透工具,还能一键将本地code-server服务安全暴露到公网,无需公网IP或复杂配置,即可随时随地通过HTTPS访问自己的在线开发环境,极大提升了开发灵活性与协作效率。
感谢您对本篇文章的喜爱,有任何问题欢迎留言交流。cpolar官网-安全的内网穿透工具 | 无需公网ip | 远程访问 | 搭建网站





























