code-server 安装指南：全平台详细教程

前言

code-server 是一个将 VS Code 编辑器带到浏览器中的开源项目，允许用户通过任何设备的浏览器访问完整的 VS Code 开发环境。本文将详细介绍在各种操作系统和平台上的安装方法，帮助开发者快速搭建自己的云端开发环境。

安装方法概述

code-server 提供了多种安装方式以适应不同用户的需求和环境：

1. 一键安装脚本 - 最简单快捷的安装方式
2. 独立发行版 - 适合需要自定义安装位置的用户
3. 系统包管理器 - 适合通过原生包管理系统安装
4. npm 安装 - 适合特殊环境或需要从源码构建的用户
5. 容器化部署 - 使用 Docker 快速部署

推荐安装方式：一键安装脚本

对于大多数用户，我们推荐使用官方提供的一键安装脚本，它会自动检测系统环境并选择最适合的安装方式。

安装步骤

1. 首先可以预览安装过程（不实际执行）：

curl -fsSL https://code-server.dev/install.sh | sh -s -- --dry-run

2. 实际安装命令：

curl -fsSL https://code-server.dev/install.sh | sh

安装选项

安装脚本支持多种参数来自定义安装过程：

• --method：指定安装方法（detect|standalone）
• --prefix：指定安装前缀（默认为~/.local）
• --version：安装特定版本
• --edge：安装最新的预发布版本

安装完成后，脚本会显示如何运行和启动 code-server 的说明。

各平台详细安装指南

Linux 发行版安装

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

# 启用服务
sudo systemctl enable --now code-server@$USER

RHEL/CentOS/Fedora 系统

# 下载.rpm安装包
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

Arch Linux 系统

# 使用yay从AUR安装
yay -S code-server

# 启用服务
sudo systemctl enable --now code-server@$USER

macOS 系统安装

推荐使用 Homebrew 安装：

brew install code-server
brew services start code-server

独立发行版安装

适合需要自定义安装位置或在不支持包管理的系统上安装：

# 创建安装目录
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
PATH="~/.local/bin:$PATH"

# 启动
code-server

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

特殊平台安装说明

Raspberry Pi 树莓派

推荐使用 npm 方式安装：

npm install -g code-server

Windows 系统

目前官方未提供 Windows 版二进制发行版，建议通过 npm 安装：

npm install -g code-server

安装后配置

安装完成后，code-server 会自动生成配置文件：

• 配置文件位置：~/.config/code-server/config.yaml
• 首次启动时会自动生成随机密码存储在此文件中

启动服务后，可通过浏览器访问：

http://127.0.0.1:8080

卸载方法

要完全卸载 code-server，需要删除应用程序文件和用户配置：

1. 删除配置和数据：

rm -rf ~/.local/share/code-server ~/.config/code-server

2. 根据安装方式选择对应的卸载方法：

• 如果使用一键脚本安装：

rm -rf ~/.local/lib/code-server-*

• 如果使用 Homebrew 安装：

brew uninstall code-server

• 如果使用 npm 安装：

npm uninstall -g code-server

• 如果使用系统包管理器安装：

# Debian/Ubuntu
sudo apt remove code-server

# RHEL/CentOS
sudo yum remove code-server

常见问题解决

1. 安装后无法运行：确保安装目录已加入 PATH 环境变量
2. 浏览器无法连接：检查防火墙设置和 code-server 是否正在运行
3. 插件安装问题：确保有足够的权限和磁盘空间

通过本文介绍的各种安装方法，您应该能够在任何主流平台上成功部署 code-server，享受云端开发的便利。根据您的具体需求选择最适合的安装方式，开始您的云端编码体验吧！