code-server 安装完全指南从 install.sh 自动检测到各平台部署与源码级原理【免费下载链接】code-serverVS Code in the browser项目地址: https://gitcode.com/GitHub_Trending/co/code-servercode-server 是一款运行在远程服务器上的 VS Code通过浏览器访问完整的 IDE 体验。本文基于官方安装文档 docs/install.md 完整梳理所有受支持的安装途径——install.sh 自动检测脚本、npm、Standalone 独立发行版、Debian/Ubuntu、Fedora/RHEL、Arch、macOS、Docker、Helm 等——并结合仓库内的 install.sh 脚本源码、package.json 入口配置与 测试脚本 深入讲解检测逻辑、版本解析与缓存机制帮助你在任意 Linux 发行版、macOS 或容器环境下一键部署并验证 code-server。一、install.sh官方推荐的自动安装方式安装 code-server 最简单的方式是使用官方安装脚本它适用于 Linux、macOS 和 FreeBSD并会优先尝试使用系统包管理器。可以先用--dry-run预览安装过程curl -fsSL https://code-server.dev/install.sh | sh -s -- --dry-run正式安装执行curl -fsSL https://code-server.dev/install.sh | sh1.1 可用的安装参数文档列出的核心参数如下参数作用--dry-run只打印将要执行的命令不实际运行--methoddetect检测系统包管理器失败时回退到--methodstandalone--methodstandalone将 Standalone 发行版归档安装到~/.local--prefix/usr/local将 Standalone 归档系统级安装默认~/.local--versionX.X.X安装指定版本而非最新版--edge安装最新的 edge预发布版本--help查看使用说明从 install.sh 源码的usage()函数L7-L74还可以看到文档未逐条展开的两个实用能力--rsh bin指定远程安装使用的 shell默认ssh脚本支持直接传入userhost参数通过 ssh 在远程主机上完成安装远端需能访问互联网。所有下载的资产会缓存到~/.cache/code-server源码函数echo_cache_dirL579-L587支持XDG_CACHE_HOME覆盖。fetch()函数L331-L347还实现了断点续传下载中的文件先写入$FILE.incomplete若目标文件已存在则直接复用缓存。文档同时提示若对curl | sh的安全性有顾虑可参考原文档引用的安全分析文章由于 install.sh 执行的命令与本文档后续各章节展示的命令完全一致因此也可以对照源码手动审查每一步操作。1.2 包管理器检测参考Detection reference文档给出的检测规则与脚本main()中的分发逻辑L264-L294一一对应平台安装方式Debian、Ubuntu安装最新 .deb 包Fedora、CentOS、RHEL、openSUSE安装最新 .rpm 包Arch Linux安装 AUR 包无法识别的 Linux安装 Standalone 发行版到~/.local需将~/.local/bin加入$PATHmacOS安装 Homebrew 包若无 Homebrew 则回退到 StandaloneFreeBSD使用 npm 安装没有预编译发行版的架构使用 npm 安装npm 包会在 postinstall 阶段编译原生模块从源码结构看检测的具体实现是os()L474-L482将uname结果规范化为linux/macos/freebsdarch()L540-L547将aarch64映射为arm64、x86_64映射为amd64——当前官方仅为amd64 和 arm64提供预编译发行版distro()L496-L519读取/etc/os-release并优先按ID_LIKE归类例如 amzn、centos、rhel 归入fedoramanjaro、endeavouros 归入arch各发行版分支通过npm_fallback包装器L451-L459实现回退若当前架构没有 Standalone 发行版则自动改用 npm 安装。Alpine 与 FreeBSD 由于没有对应发行版直接走install_npm。这套检测逻辑由 test/scripts/install.bats 以--dry-run方式对各发行版 × 架构组合做了系统化断言例如should-use-deb、should-fallback-npm等辅助函数会精确校验输出的每一步提示文本保证检测行为在脚本迭代中不回归。二、npm 安装适用于特殊环境的构建式安装以下场景文档建议改用 npm 安装机器不是amd64或arm64Linux 的glibc v2.28 或glibcxx v3.4.21运行 Alpine Linux 或使用非 glibc 的 libc。npm 方式安装时会在安装阶段构建原生模块因此需要先准备 C 依赖工具链详细说明见 docs/npm.md。该文档的关键要点包括Node.js 版本项目使用 Node.js24.x与 package.json 中engines.node: 24一致使用其他版本可能导致不可预期的行为Ubuntu/Debiansudo apt-get install -y build-essential pkg-config python3Fedora/CentOS/RHELyum groupinstall Development Tools并安装 python2Alpineapk add alpine-sdk bash libstdc libc6-compat python3 krb5-devmacOSxcode-select --installFreeBSDpkg install -y git python npm-node24 pkgconf libinotify文档明确警告不要使用 yarn安装 code-server因为它不像 npm 那样遵守分发应用的 lockfile。安装命令npm install --global code-server code-server # 然后访问 http://127.0.0.1:8080密码位于 ~/.config/code-server/config.yamlpackage.json 中postinstall指向./ci/dev/postinstall.sh这就是构建原生模块发生的时机bin字段将code-server命令映射到out/node/entry.js即 src/node/entry.ts 编译产物——它解析 CLI 参数与配置文件随后通过 wrapper 启动服务端。三、Standalone 独立发行版自包含的 tar.gz 归档每个官方版本都会发布自包含的.tar.gz归档归档内捆绑了 node 二进制和 node 模块且所有其他发行版deb/rpm/镜像都是基于 Standalone 版本构建的。唯一系统要求Linux 上glibc 2.28 且glibcxx v3.4.21macOS 无最低版本要求。使用步骤下载对应系统的最新发行版归档解压归档执行./bin/code-server运行可将./bin/code-server加入$PATH。文档提供的 Linux 示例脚本mkdir -p ~/.local/lib ~/.local/bin curl -fL https://github.com/coder/code-server/releases/download/v$VERSION/code-server-$VERSION-linux-amd64.tar.gz \ | tar -C ~/.local/lib -xz mv ~/.local/lib/code-server-$VERSION-linux-amd64 ~/.local/lib/code-server-$VERSION ln -s ~/.local/lib/code-server-$VERSION/bin/code-server ~/.local/bin/code-server PATH~/.local/bin:$PATH code-server # Now visit http://127.0.0.1:8080. Your password is in ~/.config/code-server/config.yaml这段示例与 install.sh 中install_standalone()函数L395-L424执行的是同一套动作下载归档 → 解压到$PREFIX/lib→ 重命名去掉架构后缀 → 软链接二进制到$PREFIX/bin/code-server。源码中还有一个细节若目标目录已存在同版本安装脚本会直接退出并提示先删除旧目录。四、Linux 发行版包管理器安装4.1 Debian、Ubuntu注意Standalone arm64 .deb 不支持 Ubuntu 16.04 及更早版本请升级系统或改用 npm 构建。curl -fOL https://github.com/coder/code-server/releases/download/v$VERSION/code-server_${VERSION}_amd64.deb sudo dpkg -i code-server_${VERSION}_amd64.deb sudo systemctl enable --now code-server$USER # Now visit http://127.0.0.1:8080. Your password is in ~/.config/code-server/config.yaml4.2 Fedora、CentOS、RHEL、SUSE注意Standalone arm64 .rpm 不支持 CentOS 7请升级或改用 npm。curl -fOL https://github.com/coder/code-server/releases/download/v$VERSION/code-server-$VERSION-amd64.rpm sudo rpm -i code-server-$VERSION-amd64.rpm sudo systemctl enable --now code-server$USER # Now visit http://127.0.0.1:8080. Your password is in ~/.config/code-server/config.yaml从 install.sh 源码看deb 安装使用dpkg -i、rpm 安装使用rpm -UL358-L378两者都要求 root 权限因此脚本通过sudo_sh_cL561-L577自动选择可用的提权工具doas、sudo或su。4.3 Arch Linux使用 yay 或原生 makepkg 从 AUR 安装# 方式一yay yay -S code-server sudo systemctl enable --now code-server$USER # Now visit http://127.0.0.1:8080. Your password is in ~/.config/code-server/config.yaml# 方式二makepkg git clone https://aur.archlinux.org/code-server.git cd code-server makepkg -si sudo systemctl enable --now code-server$USER # Now visit http://127.0.0.1:8080. Your password is in ~/.config/code-server/config.yaml4.4 Artix LinuxOpenRCArtix 使用 OpenRC 而非 systemd因此需要手工编写服务脚本# 从 AUR 安装 git clone https://aur.archlinux.org/code-server.git cd code-server makepkg -si将下面内容保存为/etc/init.d/code-server并执行chmod x code-server把第 3 行替换为你的用户名#!/sbin/openrc-run name$RC_SVCNAME description$name - VS Code on a remote server user # your username here homedir/home/$user command$(which code-server) # Just because you can do this does not mean you should. Use ~/.config/code-server/config.yaml instead #command_args--extensions-dir $homedir/.local/share/$name/extensions --user-data-dir $homedir/.local/share/$name --disable-telemetry command_user$user:$user pidfile/run/$name/$name.pid command_backgroundyes extra_commandsreport depend() { use logger dns need net } start_pre() { checkpath --directory --owner $command_user --mode 0755 /run/$name /var/log/$name } start() { default_start report } stop() { default_stop } status() { default_status report } report() { # Report to the user einfo Reading configuration from ~/.config/code-server/config.yaml }注册开机自启并立即启动rc-update add code-server default rc-service code-server start五、macOS 安装brew install code-server brew services start code-server # Now visit http://127.0.0.1:8080. Your password is in ~/.config/code-server/config.yamlinstall.sh 对 macOS 的处理逻辑L267-L276检测到brew命令则调用install_brew否则打印提示并回退到 Standalone 安装若当前架构无预编译包再进一步回退到 npm——这与 test/scripts/install.bats 中should-fallback-npm-brew用例断言的四层回退提示文本完全对应。六、Docker 容器部署# 启动 code-server 容器并暴露在 http://127.0.0.1:8080 # 同时把当前目录挂载为容器内 /home/coder/project并转发宿主机 UID/GID # 使容器内所有文件系统操作都以宿主机用户身份执行。 # # $HOME/.config 会被挂载到容器内 $HOME/.config便于在容器外直接访问 # 和修改 $HOME/.config/code-server/config.json。 mkdir -p ~/.config 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官方镜像支持amd64与arm64。从 ci/release-image/Dockerfile 可以看到官方镜像的构建方式基于debian:13通过dpkg -i安装 code-server 的 .deb 包即 Standalone 构建产物预置coder用户uid 1000并安装fixuid修正挂载卷的所有权入口为 ci/release-image/entrypoint.sh默认以--bind-addr 0.0.0.0:8080启动DOCKER_USER环境变量正是示例命令中-e传入的那个用于在转发 uid 后保持 docker-exec 的身份一致性。七、Helm 部署可以使用 Helm 包管理器将 code-server 部署到 Kubernetes。仓库内自带了完整的 Helm chart见 ci/helm-chart/Chart.yaml 与 ci/helm-chart/values.yaml模板涵盖 deployment.yaml、service.yaml、ingress.yaml、pvc.yaml、secrets.yaml 等更完整的部署说明见 docs/helm.md。八、Windows、Raspberry Pi、Termux 与云厂商Windows官方目前不发布 Windows 原生发行版通常借助 WSL、Docker 或虚拟机方式使用。Raspberry Pi文档推荐通过 npm 安装树莓派多为 arm 架构不在 amd64/arm64 预编译范围内。Termux安装步骤请查阅专门的 docs/termux.md。云厂商项目为 DigitalOcean、Railway、Heroku、Azure 等维护有一键应用与安装脚本可在各自云市场直接部署。九、卸载 code-servercode-server 的卸载分两部分删除应用目录 删除用户配置数据。删除配置与数据rm -rf ~/.local/share/code-server ~/.config/code-server各安装方式对应的应用删除命令install.sh 安装默认位于~/.local/lib/code-server-versionrm -rf ~/.local/lib/code-server-*Homebrew 安装brew remove code-server # 等价写法 brew uninstall code-servernpm 安装npm uninstall --global code-serverDebian/Ubuntusudo apt remove code-server十、安装后的配置入口源码视角无论采用哪种安装方式服务启动后都会提示相同的验证路径访问http://127.0.0.1:8080密码在~/.config/code-server/config.yaml。这个路径来自 src/node/cli.ts 中path.join(paths.config, config.yaml)的默认拼接其中paths由 src/node/util.ts 引入的xdg-basedir包按 XDG 规范解析——这也是卸载章节中~/.config/code-server与~/.local/share/code-server两个目录的由来前者存放config.yamlbind-addr、密码、认证方式等后者存放扩展与运行时数据。code-server命令本身即 package.json 声明的out/node/entry.js入口其 src/node/entry.ts 流程为解析 CLI 参数 → 读取config.yaml→ 填充默认值 → 判断是否需要转发到 VS Code CLI 或复用已有实例 → 通过 wrapper 启动服务进程。因此安装完成后除浏览器访问外也可直接运行code-server前台调试用--help查看全部参数用code-server --version查看版本字符串由 src/node/constants.ts 中的getVersionString()生成包含 code-server 版本、commit 与内置 Code 版本。小结code-server 的安装策略可以归纳为一条主线优先系统包管理器无发行版时回退 npmStandalone 是全部产物链的基座。install.sh 通过os()/arch()/distro()三函数完成环境判定用npm_fallback统一处理架构回退并用~/.cache/code-server缓存所有下载资产npm 方式则面向无预编译包的架构、旧 glibc 与 Alpine/musl 环境代价是需要本机 C 工具链在 postinstall 阶段编译原生模块。选择安装方式时对照本文的检测参考表与 glibc/架构限制即可得出确定答案安装后统一通过http://127.0.0.1:8080与~/.config/code-server/config.yaml完成验证与后续配置。【免费下载链接】code-serverVS Code in the browser项目地址: https://gitcode.com/GitHub_Trending/co/code-server创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
