快速部署网页版VS Code:使用code-server搭建在线开发环境

前言

在远程办公、云原生开发和多设备协同日益普及的今天,传统的本地IDE已难以满足灵活高效的开发需求。你是否曾希望:

  • 在iPad或Chromebook上也能流畅写代码?
  • 从任意设备访问统一的开发环境,无需重复配置?
  • 快速为团队成员提供一致的编码平台?

code-server正是为此而生——它将强大的Visual Studio Code完整运行在服务器上,并通过浏览器提供访问能力,真正实现“代码在云端,开发在手边”。

本文将带你从零开始,基于Docker快速部署code-server,搭建一个安全、可持久化、随时可用的网页版VS Code开发环境。无论你是个人开发者、教育工作者,还是DevOps工程师,只需几分钟,即可拥有属于自己的在线IDE。

让我们开始吧!

image-20260319175348975

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

image-20260319163131382

启动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

image-20260319163228786

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

b99619bdf3ac429ccfe092f32cd3e880

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

ce7027d73be780dc4456cd77c344e802

3.2 使用code-server

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

6e6bb1afa73a76e2e48da6464375ee85登录成功后,同意协议并进行下一步:

92191769e57b981d73616e9ffb0284e6

安装中文版vscode:

image-20260319164202238

点击如图所示:

image-20260319164317874

选择中文版。

image-20260319164413135

然后就成功啦!

image-20260319164939582

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

image-20260319165348320

可以新建一个文件,创造页面看看:

image-20260319165535314

也可以使用终端:

image-20260319173024611

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步骤:

官网在此:https://www.cpolar.com

使用一键脚本安装命令:

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

image-20250725104019896

安装完成后,执行下方命令查看cpolar服务状态:(如图所示即为正常启动)

sudo systemctl status cpolar

22e5adfaf290a17fc3384bb296055259

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

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

8a6698b1bf26d64ba3645827fbfb1c29

5.配置公网地址

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

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

image-20260319174414014

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

image-20260319174550283

访问成功。

image-20260319174622159

6.保留固定公网地址

使用cpolar为其配置二级子域名(cpolar官网-安全的内网穿透工具 | 无需公网ip | 远程访问 | 搭建网站),该地址为固定地址,不会随机变化。

image-20250918151358733

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

image-20260319174846813

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

image-20260319174916628

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

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

点击更新

image-20260319174946053

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

image-20260319180726217

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

image-20260319180809930

总结

通过使用code-server,开发者可以快速在服务器或本地部署一个功能完整的网页版 VSCode,在浏览器中实现与桌面端一致的开发体验。结合cpolar内网穿透工具,还能一键将本地code-server服务安全暴露到公网,无需公网IP或复杂配置,即可随时随地通过HTTPS访问自己的在线开发环境,极大提升了开发灵活性与协作效率。

感谢您对本篇文章的喜爱,有任何问题欢迎留言交流。cpolar官网-安全的内网穿透工具 | 无需公网ip | 远程访问 | 搭建网站

Share:

发表回复

目录

On Key

推荐文章