code-server 远程开发环境搭建：服务器上跑 VS Code，用 cpolar 随时打开工作区

code-server 远程开发环境搭建服务器上跑 VS Code用 cpolar 随时打开工作区我最怕的一类开发环境是代码、依赖、密钥、终端历史分散在几台电脑上。今天在办公室写一半晚上换笔记本继续第二天又发现本地 Node 版本不一样项目跑不起来。code-server 解决的是这个问题把 VS Code 跑在服务器上浏览器只负责打开编辑器。cpolar 负责把这个只在内网可访问的工作区临时映射成 HTTPS 地址人在外面也能打开同一套目录、同一个终端、同一份依赖环境。这篇不讲 VS Code 插件大合集只做一件事在服务器上搭一个带密码的 code-server 工作区先本地验证再用 cpolar 做远程访问验证收尾时把安全检查补齐。1 什么是 code-server这篇里它负责什么code-server 是 Coder 开源的浏览器版 VS Code。官方说明很直接Run VS Code on any machine anywhere and access it in the browser也就是在任意机器上运行 VS Code再用浏览器访问。在这篇教程里code-server 只负责三件事在服务器上打开项目目录在浏览器里提供编辑器和终端用密码挡住工作区入口官方仓库给出的基础资源要求是 Linux machine with WebSockets enabled, 1 GB RAM, and 2 vCPUs。个人开发机、轻量云服务器、家里闲置小主机都能按这个思路搭。这里别把它当成“在线版 VS Code 玩具”终端能操作服务器项目里的配置文件也能被编辑入口暴露前必须先处理鉴权和访问边界。2 环境准备确认服务器、目录和端口本文用 Ubuntu/Debian 系服务器演示当前登录用户为普通用户不用 root 直接做日常开发。下面的命令里工作区目录统一放在~/workspace/demo-appcode-server 监听127.0.0.1:8080。先确认系统里有curl并准备一个干净目录sudo apt update sudo apt install -y curl mkdir -p ~/workspace/demo-app cd ~/workspace/demo-app printf # demo-app\n README.md这一步不是为了凑一个示例项目而是确认后面浏览器打开的就是这个服务端目录。进入 code-server 后能看到README.md说明工作区路径没有指错。再检查 8080 端口没有被占用ss -lntp | grep :8080 || echo 8080 is free如果输出里已经有:8080换一个内部端口例如18080后面的bind-addr和 cpolar 映射端口保持同一个数字。端口前后一致排错会轻很多。3 安装 code-server 并创建服务code-server 官方提供安装脚本脚本会尽量使用系统包管理器完成安装。先做 dry-run 看脚本要执行的动作curl -fsSL https://code-server.dev/install.sh | sh -s -- --dry-run确认输出里没有报错后执行安装curl -fsSL https://code-server.dev/install.sh | sh安装完成后检查版本code-server --version接着创建用户级 systemd 服务。code-server 官方安装后的服务名形如code-server$USER用当前用户启动即可sudo systemctl enable --now code-server$USER systemctl status code-server$USER --no-pager状态里看到active (running)说明服务已经由 systemd 接管。这里不要用 root 跑工作区普通用户的权限边界更清楚误操作影响面也更小。4 配置密码和监听地址code-server 的用户配置文件在~/.config/code-server/config.yaml打开配置文件nano ~/.config/code-server/config.yaml把内容整理成下面这种结构password换成自己的强密码bind-addr: 127.0.0.1:8080 auth: password password: change-this-to-a-strong-password cert: false这里有两个点别填错。bind-addr保持127.0.0.1:8080让 code-server 只监听服务器本机回环地址。远程入口交给 cpolar 来开不让 code-server 自己直接对公网监听。auth保持password不要改成none。官方文档明确提醒不能在没有鉴权和加密的情况下把 code-server 直接暴露到互联网否则别人能通过终端接管机器。保存后重启服务sudo systemctl restart code-server$USER systemctl status code-server$USER --no-pager再看监听地址ss -lntp | grep :8080看到127.0.0.1:8080才是这篇教程要的结果。如果显示0.0.0.0:8080回到配置文件检查bind-addr改完立刻重启服务。5 本地验证先确认工作区能打开在服务器本机执行curl -I http://127.0.0.1:8080返回里看到 HTTP 响应头说明 code-server 已经在本机端口上提供页面。此时用服务器本机浏览器访问http://127.0.0.1:8080登录页会要求输入密码。输入刚才配置的password后打开~/workspace/demo-app目录页面里能看到README.md。如果页面打不开按这个顺序查systemctl status code-server$USER --no-pager看服务是否运行journalctl -u code-server$USER -n 80 --no-pager看启动日志ss -lntp | grep :8080看端口监听是否存在~/.config/code-server/config.yaml看 YAML 缩进和端口是否写错这一步跑通后再做 cpolar。否则远程地址打不开时很难判断是 code-server 没启动还是隧道没有打通。6 安装 cpolar 并映射 code-server 端口cpolar 的作用很明确把服务器本机的127.0.0.1:8080通过 HTTP 隧道生成一个公网 HTTPS 访问地址。code-server 仍然只监听本机端口外部浏览器访问 cpolar 地址再转回这台服务器的 8080。Linux 上使用官方一键安装脚本curl -L https://www.cpolar.com/static/downloads/install-release-cpolar.sh | sudo bash安装完成后检查命令和本地控制台cpolar version curl -s http://127.0.0.1:9200 || echo cpolar web ui is not ready打开 cpolar 本地 Web UIhttp://127.0.0.1:9200登录后账号会写入本地配置。纯命令行环境下也可以在 cpolar 后台拿到 authtoken 后执行cpolar authtoken xxxxxxxxxxxx创建临时 HTTP 隧道映射 code-server 的 8080 端口cpolar http 8080终端输出里会出现https://开头的公网地址。把这个地址复制出来后面远程浏览器访问它。如果更习惯 Web UI在 cpolar 控制台里按下面的值创建隧道名称code-server协议http本地地址8080域名类型免费套餐选择随机域名地区按页面实际可选项选择创建后进入“状态 → 在线隧道列表”能看到对应的公网地址。免费随机公网地址 24 小时内会变化固定二级子域名需要基础套餐或以上。长期使用时把随机地址换成固定二级子域名书签、手机入口和同事验收链接都不会频繁变动。7 远程访问验证用外部网络打开工作区拿到 cpolar 的 HTTPS 地址后换一台不在同一局域网的设备访问例如手机流量网络或外地电脑浏览器。打开地址后页面应进入 code-server 登录页。输入 code-server 密码后确认三件事能看到~/workspace/demo-app工作区能打开README.md能打开内置终端并执行pwd终端里执行pwd ls -lapwd输出应落在自己的工作区目录附近ls -la能看到README.md。这一步不是为了测试而测试而是确认“浏览器入口、cpolar 隧道、code-server 服务、服务端目录”四段链路已经连上。再做一个文件写入验证printf remote edit ok\n remote-check.txt ls -l remote-check.txt刷新左侧文件列表后能看到remote-check.txt说明远程浏览器操作确实落到了服务器工作区。8 常见问题按链路一段一段查8.1 打开 cpolar 地址不是 code-server 页面先在服务器上查本地服务curl -I http://127.0.0.1:8080本地都没有响应时回去看 code-server 服务日志journalctl -u code-server$USER -n 80 --no-pager本地有响应、公网地址没有响应时打开http://127.0.0.1:9200进入“状态 → 在线隧道列表”确认code-server隧道在线并且本地地址写的是8080。8.2 登录页反复提示密码错误直接查看配置文件里的密码sed -n 1,120p ~/.config/code-server/config.yaml确认auth: password和password:是同一份配置。改完后必须重启服务sudo systemctl restart code-server$USER密码里含有特殊字符时用 YAML 字符串写法包起来例如password: Change_Me_2026_!8.3 远程页面能打开但终端或预览异常code-server 的浏览器连接依赖 WebSocket。cpolar HTTP 隧道正常在线时先刷新页面重新登录仍然异常时检查浏览器控制台和 code-server 日志journalctl -u code-server$USER -n 120 --no-pager项目预览类端口不要和 code-server 的 8080 混用。前端项目跑在5173后端接口跑在3000就分别在 code-server 终端里启动项目再按需给这些端口单独开 cpolar HTTP 隧道。8.4 cpolar 提示登录实例超限或地址变化不要在多个终端里同时执行多条cpolar http 8080。cpolar 文档提示前台同时打开多个命令行隧道会触发登录实例限制。关闭旧进程后再保留一个隧道pkill -f cpolar http 8080 || true cpolar http 8080免费随机地址会变化。需要固定入口时在 cpolar 后台保留固定二级子域名再把隧道绑定到这个域名。9 安全检查远程开发入口要收口code-server 的入口连着服务器终端安全检查要当成必做步骤不要当成可有可无的附录。9.1 确认 code-server 没有直接监听公网执行ss -lntp | grep :8080目标输出是127.0.0.1:8080。如果看到0.0.0.0:8080说明所有网卡都能访问这个端口立刻把配置改回bind-addr: 127.0.0.1:8080再重启sudo systemctl restart code-server$USER9.2 不要把 root 目录当工作区工作区放在普通用户目录下例如mkdir -p ~/workspace/demo-app code-server ~/workspace/demo-app不要把/、/root、/etc这类系统目录作为日常工作区。浏览器里误删一个系统配置文件恢复成本比重新拉项目高得多。9.3 临时验收后关闭隧道临时给同事看环境验收结束就关闭前台 cpolar 进程pkill -f cpolar http 8080 || true如果使用 cpolar Web UI 创建了隧道就在控制台里停用对应隧道。固定域名用于长期自用入口时也要保留 code-server 密码并定期更换密码。9.4 留一份检查清单上线前按这几项扫一遍code-server 配置是auth: passwordbind-addr是127.0.0.1:8080工作区是普通用户目录cpolar 只映射 HTTP 8080不暴露 SSH、数据库等端口临时分享结束后关闭隧道这几项都满足远程开发入口的风险边界才清楚。10 总结到这里服务器上的 code-server 已经能以浏览器工作区的方式使用代码和依赖留在服务器外部设备只打开 cpolar 的 HTTPS 地址登录后进入同一套项目目录。整个链路里code-server 负责服务端编辑器cpolar 负责远程访问入口安全边界靠密码、localhost 监听和隧道收口来兜住。安装 code-server 后把配置固定为bind-addr: 127.0.0.1:8080和auth: password本地先用curl -I http://127.0.0.1:8080验证再用 cpolar 映射 8080远程访问时验证登录页、工作区文件和终端写入确认链路真正打通后面要长期使用就把 cpolar 随机地址换成固定二级子域名再把工作区按项目拆开。个人开发时用一台服务器承载主要环境临时验收时只短时间打开隧道。这个组合的好处很直接开发环境不再跟着电脑跑入口也不用长期裸露在公网。