code-server 安装指南：如何在 10 分钟搭好浏览器里的跨平台远程开发环境
【免费下载链接】code-serverVS Code in the browser项目地址: https://gitcode.com/GitHub_Trending/co/code-server
code-server 把完整的 VS Code 体验搬进浏览器，让低配笔记本、旧服务器甚至手机都能进行跨平台远程开发。本文不堆砌命令，而是先帮你判断该走哪条部署路线，再按场景给出 10 分钟可跑通的最小步骤，最后用一份避坑清单收尾。装好并配置完成后，你打开浏览器看到的就是这样的界面：
先做选型：三条部署路线怎么选
先花 30 秒对号入座，判断标准只有一句话：这台设备是你长期开发的主力，还是隔离、临时的场景？
| 你的情况 | 推荐路线 | 一句话理由 |
|---|---|---|
| 固定电脑或服务器，日常主力开发 | 路径 A：本机安装 | 一键脚本最省事，可开机自启 |
| 不想让开发环境污染系统 | 路径 B：Docker 容器 | 容器即环境，删容器即清理 |
| 想在 Android 手机上随时写代码 | 路径 C：Termux 部署 | 免 root，浏览器直连 |
硬件门槛不高：最低 1GB 内存 + 2 核 CPU 即可流畅运行，推荐 2GB + 4 核。另外浏览器需要支持 WebSocket（一种让浏览器与服务器保持实时双向通信的通道，远程编辑依赖它）。详细要求可查官方文档。
路径 A：本机快速上手（Linux / macOS / Windows 同一套思路）
Linux 用户最省事：官方一键脚本会自动识别发行版并选对应包管理器（Debian/Ubuntu 装 deb、Fedora 系装 rpm、其他系统装独立压缩包）：
curl -fsSL https://code-server.dev/install.sh | sh sudo systemctl start code-server@$USER # 启动服务macOS 用户走 Homebrew 即可：
brew install code-server brew services start code-serverWindows 目前官方只提供 npm 方式（需先装 Node.js LTS）：
npm install --global code-server code-server三条路线装完后的体验完全一致：浏览器打开http://127.0.0.1:8080，文件树、编辑器、内置终端全部在线。
🐳 路径 B：Docker 隔离部署怎么做
如果你的情况是"不想让开发环境碰到系统"，容器方案最合适。下面这条命令把当前目录挂载进容器、并转发你的用户权限，让容器内外文件权限保持一致：
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注意-p只绑定了127.0.0.1，默认不对外网暴露，这是刻意设计。官方镜像支持 amd64 与 arm64。
📱 路径 C：Termux 手机上轻量部署
Termux 是 Android 上的开源 Linux 终端环境，装好它相当于在手机上获得一台小型 Linux。从 F-Droid 安装 Termux 后，在 Termux 里执行：
pkg update && pkg upgrade -y pkg install -y build-essential python3 nodejs-lts npm config set python python3 npm install --global code-server手机上只建议本地无密码运行（--auth none），因为设备本身就是一道门：
code-server --auth none手机端更多技巧（键盘快捷键、常见问题）见Termux 专题文档。
首次访问与核心配置
无论哪条路线，首次访问地址都是http://127.0.0.1:8080，登录密码写在~/.config/code-server/config.yaml里（脚本或 Docker 首次启动时会自动生成）。要改端口或换密码，编辑的也是这同一个文件：
bind-addr: 0.0.0.0:8080 auth: password password: your_secure_password安全提醒：bind-addr: 0.0.0.0意味着监听所有网卡。如果你要这样绑定并开放给别人访问，务必先配好反向代理 + HTTPS；只是自己用，保持默认的127.0.0.1最稳妥。
避坑清单
Q：手机上很多扩展（包括语言包）装不上？Android 被判定为不受支持的平台，code-server 只允许 Web 扩展。两个解法：手动下载.vsix文件后，用命令面板的 "Extensions: Install from VSIX..." 安装；或者写一个平台伪装脚本，让 Node 把 Android 当作 Linux：
// android-as-linux.js Object.defineProperty(process, "platform", { get() { return "linux" } })NODE_OPTIONS="--require /path/to/android-as-linux.js" code-serverQ：低配设备感觉卡？减少常驻扩展数量；启动时加--disable-telemetry关闭遥测（后台上报使用数据的机制）。
Q：安全绑定怎么做才不裸奔？优先绑具体 IP 而不是0.0.0.0；需要跨设备访问时，用 Caddy 或 Nginx 做反向代理并挂上证书，而不是把 8080 端口直接开放出去。
Q：Termux 里 git 在 /sdcard 下不工作？把项目放到 Termux 主目录下，或用符号链接把目标目录软链进 Termux 的文件系统再操作。
收尾：不想要了怎么清理
按安装方式对应卸载，再删掉数据目录即可完全清理：
rm -rf ~/.local/share/code-server ~/.config/code-server # 删除配置与数据- 脚本安装：
rm -rf ~/.local/lib/code-server-* - Homebrew：
brew remove code-server - npm：
npm uninstall --global code-server - deb 包：
sudo apt remove code-server - Docker：
docker rm -f code-server
完整的安装与卸载命令可查安装文档。下一篇我们讲 code-server 高级配置与安全加固：HTTPS 配置、反向代理设置和多用户管理。
【免费下载链接】code-serverVS Code in the browser项目地址: https://gitcode.com/GitHub_Trending/co/code-server
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
