2025最新版code-server安装指南：10分钟搭建跨平台远程开发环境

你是否还在为多设备开发环境不一致而烦恼？是否需要在平板或低配置设备上使用VS Code的强大功能？本文将带你10分钟内完成code-server的安装与配置，轻松搭建跨平台远程开发环境。读完本文，你将掌握：

• 3种主流系统（Linux/macOS/Windows）的快速安装方法
• 移动端（Termux）开发环境的搭建技巧
• 安全访问与基础配置优化
• 常见问题的解决方案

准备工作：环境要求与资源

code-server对硬件要求不高，但为获得流畅体验，建议满足以下配置：

• 最低配置：1GB内存 + 2核CPU
• 推荐配置：2GB内存 + 4核CPU
• 网络环境：支持WebSocket的现代浏览器（Chrome/Firefox/Safari 14+）

官方文档：docs/requirements.md

快速安装：三种主流系统方案

Linux系统（推荐）

Linux用户可通过官方一键安装脚本实现最快部署：

# 预览安装过程（可选）
curl -fsSL https://code-server.dev/install.sh | sh -s -- --dry-run

# 执行安装
curl -fsSL https://code-server.dev/install.sh | sh

安装完成后，系统会自动配置服务并启动，可通过以下命令管理：

# 启动服务
sudo systemctl start code-server@$USER

# 设置开机自启
sudo systemctl enable code-server@$USER

Debian/Ubuntu用户也可选择deb包安装：

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

macOS系统

macOS用户可通过Homebrew快速安装：

brew install code-server
brew services start code-server

Windows系统

Windows目前没有官方独立安装包，推荐使用npm方式安装：

# 先安装Node.js (LTS版本)
# 然后安装code-server
npm install --global code-server

# 启动服务
code-server

移动开发：Termux环境搭建

在Android设备上使用Termux安装code-server，实现随时随地编程：

1. 从F-Droid安装Termux应用
2. 更新源并安装依赖：

termux-change-repo  # 选择Grimler镜像源
pkg update && pkg upgrade -y
pkg install -y build-essential python3 nodejs-lts
npm config set python python3

3. 安装code-server：

npm install --global code-server

# 无密码启动（仅本地测试使用）
code-server --auth none

详细配置：docs/termux.md

容器化部署：Docker方案

使用Docker可快速隔离部署code-server：

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

访问与配置

首次访问

安装完成后，默认服务将运行在http://127.0.0.1:8080，首次登录密码位于：

~/.config/code-server/config.yaml

基础配置修改

编辑配置文件自定义端口、密码等设置：

# ~/.config/code-server/config.yaml
bind-addr: 0.0.0.0:8080
auth: password
password: your_secure_password
cert: false

常见问题解决

扩展安装失败

问题：部分扩展因平台检测失败无法安装 解决：创建平台伪装脚本android-as-linux.js：

Object.defineProperty(process, "platform", { get() { return "linux" } })

启动时使用：

NODE_OPTIONS="--require /path/to/android-as-linux.js" code-server

性能优化

• 减少同时运行的扩展数量
• 调整配置文件中的bind-addr为具体IP而非0.0.0.0
• 对于低配置设备，使用--disable-telemetry禁用遥测

卸载方法

如需卸载code-server，根据安装方式选择以下命令：

# 脚本安装方式
rm -rf ~/.local/lib/code-server-*

# Homebrew安装方式
brew remove code-server

# npm安装方式
npm uninstall --global code-server

# Debian/Ubuntu deb包
sudo apt remove code-server

总结与展望

code-server为开发者提供了极大的灵活性，无论是在老旧电脑、平板还是手机上，都能享受到VS Code的完整功能。随着云开发的普及，远程开发环境将成为主流工作方式之一。

下一篇我们将介绍：code-server高级配置与安全加固，包括HTTPS配置、反向代理设置和多用户管理。

官方仓库地址：https://gitcode.com/gh_mirrors/cod/code-server