code-server 完整安装部署指南5 种方式在浏览器里跑起 VS Code【免费下载链接】code-serverVS Code in the browser项目地址: https://gitcode.com/GitHub_Trending/co/code-servercode-server 把完整的 VS Code 搬到远程机器上运行你只需打开浏览器就能用代码编辑器、内置终端、扩展和 Git——开发环境建一次笔记本、平板、旧电脑随时接入。本文覆盖从环境自检、主流安装方式、Docker 部署到首次登录拿密码、改端口改密码、排错和卸载的完整流程照着做即可跑通。先选安装方式按环境对比 5 条路线不同系统走不同的路先对号入座后面只跟其中一条方式适用环境复杂度推荐度官方脚本 install.shLinux / macOS / FreeBSD低⭐⭐⭐⭐⭐HomebrewmacOS低⭐⭐⭐⭐npm 全局安装Windows、Alpine、树莓派、老 glibc 系统中⭐⭐⭐Docker 容器需要隔离环境、不想污染宿主中⭐⭐⭐⭐TermuxAndroid 手机高⭐⭐判断逻辑很简单有 amd64/arm64 的 Linux 或 macOS直接走第一条路系统特殊Windows、Alpine、glibc 太老走 npm想把编辑器关在容器里走 Docker。安装前环境自检内存、核心数与 glibc 版本装之前花 30 秒确认机器够格官方给出的最低要求是1GB 内存 2 核 CPU浏览器端必须支持 WebSocket主流 Chrome/Firefox/Safari 均满足。在 Linux 上依次运行确认资源够、glibc 达标独立安装包要求 glibc ≥ 2.28free -h nproc # 查看可用内存与CPU核心数内存应≥1GB、核心≥2 ldd --version | head -n1 # 查看glibc版本需≥2.28macOS 用sysctl hw.memsize hw.ncpu查看内存和核心数无 glibc 要求。注意如果 glibc 低于 2.28老 CentOS 7 常见独立包跑不了请走 npm 方式现场编译见后文。Linux 与 macOS 怎么装官方脚本一条命令搞定install.sh 会自动识别你的发行版并选最合适的包Debian/Ubuntu 装 debFedora/RHEL/openSUSE 装 rpmArch 走 AUR其他发行版装独立压缩包到~/.localmacOS 走 Homebrew。先加--dry-run预演看看脚本打算执行哪些命令再决定是否真装curl -fsSL https://code-server.dev/install.sh | sh -s -- --dry-run # 只打印将执行的命令不实际安装确认无误后正式安装curl -fsSL https://code-server.dev/install.sh | sh常用参数拼接在sh -s --后面--version4.9.3装指定版本而不是最新版替换成你要的版本号--methodstandalone强制装独立压缩包到~/.local--prefix/usr/local独立包装到系统目录--edge装预发布版验证装完终端会打印启动指引。运行code-server --version能输出版本号即安装成功。如果提示code-server: command not found说明~/.local/bin不在PATH里把它加进~/.bashrc后重开终端。macOS 用户也可以跳过脚本直接用 Homebrewbrew install code-server # 安装code-server的brew包 brew services start code-server # 注册为launchd服务并立即启动验证brew services list | grep code-server状态应为started。npm 方式安装Windows、Alpine 与树莓派的绕路方案官方明确推荐在以下三种场景用 npm 装非 amd64/arm64 架构、Linux 上 glibc 2.28、Alpine 等非 glibc 系统。npm 安装时会现场编译原生模块所以前置条件是先装 C 编译工具链不要跳过这一步。先装编译依赖按系统选其一# Ubuntu / Debian sudo apt-get install -y build-essential pkg-config python3 # 安装C/C编译链 npm config set python python3 # 让node-gyp使用python3 # Fedora / CentOS / RHEL sudo yum groupinstall -y Development Tools # 安装开发工具组 # Alpine apk add alpine-sdk bash libstdc libc6-compat python3 krb5-dev # alpine-sdk含编译链 # macOS xcode-select --install # 安装Xcode命令行工具含clang然后要求Node.js 24.x版本不对可能出现难以定位的怪异行为全局安装npm install --global code-server # 全局安装安装过程会编译原生模块耗时较长注意官方明确警告不要用 yarn 安装code-server它不遵守 lockfile会拉取与发布版本不匹配的依赖导致行为异常。Android 上的 Termux 同样属于这一类npm 编译安装但它有独立的源切换和依赖配置流程单独写在 docs/termux.md照那篇做即可本文不展开。验证终端直接敲code-server看到监听信息即成功。Docker 部署一条命令获得隔离环境容器方案适合不想污染宿主、或需要给不同项目隔离开发环境的场景。官方镜像支持 amd64 和 arm64。以下命令把当前目录挂进容器当工作区并把你的 UID/GID 转发进去保证容器内创建的文件在宿主机上属于你本人mkdir -p ~/.config # 确保配置目录存在容器会挂载它来存放code-server配置 docker run -it --name code-server -p 127.0.0.1:8080:8080 \ -v $HOME/.local:/home/coder/.local \ -v $HOME/.config:/home/coder/.config \ -v $PWD:/home/coder/project \ -u $(id -u):$(id -g) \ -e DOCKER_USER$USER \ codercom/code-server:latest逐行说明关键参数-p 127.0.0.1:8080:8080只把 8080 端口映射到本机回环地址外部网卡直接访问不到天然更安全-v $PWD:/home/coder/project当前目录进容器作为工作目录换成你想开发的任意路径-v $HOME/.config:...配置目录透传密码文件在宿主机上可直接查看修改-u $(id -u):$(id -g)容器内进程以宿主机当前用户身份运行验证另开终端curl -I http://127.0.0.1:8080返回HTTP/1.1 200说明容器已就绪首次启动时密码会写入宿主机~/.config/code-server/config.yaml。首次启动验证访问地址和密码在哪拿前台运行最简单适合先验证一遍code-server # 前台启动CtrlC 可随时停止启动时终端会打印监听地址形如HTTP server listening on http://127.0.0.1:8080和登录密码。首次运行时还会自动生成配置文件~/.config/code-server/config.yaml默认内容长这样bind-addr: 127.0.0.1:8080 # 只监听本机回环地址默认端口8080 auth: password # 启用密码认证 password: 首次启动随机生成 # 随机密码持久化在此 cert: false # 默认不开TLS验证浏览器打开http://127.0.0.1:8080输入配置文件里的密码看到熟悉的 VS Code 界面即部署成功。如果你用的是 deb/rpm/brew 安装系统已生成服务单元建议转成后台服务并开机自启sudo systemctl enable --now code-server$USER # $USER自动展开为当前用户名启用并立即启动验证systemctl status code-server$USER显示active (running)。安全上记住两点默认只监听 localhost所以换台电脑访问不到。要远程访问要么走 SSH 隧道ssh -N -L 8080:127.0.0.1:8080 用户名服务器IP在本地执行把远端端口映射到本地 8080要么把bind-addr改成服务器 IP——但官方警告永远不要把 code-server 裸暴露在公网没有认证和加密时任何人都能通过它的终端接管你的机器。密码登录有防暴力破解的限速每分钟 2 次 每小时额外 12 次输错多了等一会儿再试。基础配置改端口、改密码、关遥测所有配置项都是 config.yaml 里的字段与code-server命令行参数一一对应code-server --help可查全量命令行参数优先级高于配置文件。改完配置都要重启服务才生效。改端口三选一按需替换 3000PORT3000 code-server # 方式一环境变量临时指定端口 code-server --bind-addr 127.0.0.1:3000 # 方式二命令行参数临时指定方式三是编辑~/.config/code-server/config.yaml把bind-addr改成127.0.0.1:3000。注意bind-addr建议写具体回环地址而不是0.0.0.0缩小暴露面。改密码编辑 config.yaml 里的password字段换成你的强密码然后sudo systemctl restart code-server$USER # 重启服务使新密码生效安全加固常用开关code-server --auth none # 关闭密码认证仅配合SSH隧道等可信链路使用 code-server --disable-telemetry # 禁用遥测上报需要更复杂的公网访问方案域名 Lets Encrypt 自动 HTTPS、Caddy/Nginx 反代参考 docs/guide.md。常见报错排查与卸载Webview 白屏、扩展界面加载不出浏览器控制台报Error loading webview: Error: Could not register service workers: SecurityError...。原因是 webview 依赖 Service Worker而 Service Worker 只在安全上下文HTTPS 或 localhost下可用——你用 IP 地址 HTTP 访问就中招。解决办法从 localhost 访问SSH 隧道场景、用带真实证书的域名、或 mkcert 生成受信任的自签证书。npm 安装中途报 node-gyp 相关错误缺 C 编译依赖回到上一节把对应系统的工具链装全再重装。装好依赖后若仍失败用npm install --loglevel verbose --global code-server看详细日志定位。升级 Node.js 版本后行为异常npm 装的版本需要重编译原生模块进到 code-server 的lib/vscode目录执行npm rebuild再重启或直接卸载重装。忘记密码改 config.yaml 的password字段后重启服务即可这是最快的找回方式。扩展装不上Android/Termux 场景通常是平台检测导致处理方式见 docs/termux.md。卸载按安装方式对号入座先停服务再删程序# 1. 停止并取消开机自启服务方式安装才需要 sudo systemctl disable --now code-server$USER # 2. 按安装方式删程序选其一 rm -rf ~/.local/lib/code-server-* # 脚本/独立包安装 brew remove code-server # Homebrew npm uninstall --global code-server # npm sudo apt remove code-server # Debian/Ubuntu deb # 3. 彻底清理配置与用户数据不可恢复确认后再执行 rm -rf ~/.local/share/code-server ~/.config/code-server验证卸载which code-server无输出且~/.config/code-server目录已不存在。常用命令速查与下一步code-server --version # 查版本 code-server # 前台启动 code-server --bind-addr 127.0.0.1:3000 # 换端口启动 code-server --disable-telemetry # 关遥测 sudo systemctl restart code-server$USER # 改配置后重启服务接下来可以按需要深入公网 HTTPS 访问Caddy Lets Encrypt 自动证书看 docs/guide.md移动开发Termux 或 iPad 远程连接方案看 docs/termux.md复用现有 VS Code 配置与扩展市场问题查 docs/FAQ.md 中扩展与配置迁移部分。装好只是起点把 SSH 隧道和 HTTPS 这两道门关上你的远程开发环境才算真正可以 7×24 挂着用。【免费下载链接】code-serverVS Code in the browser项目地址: https://gitcode.com/GitHub_Trending/co/code-server创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考