Skip to content

Code Server#

Code Server 是一款基于 VS Code 的云端开发环境，可在浏览器中运行完整的 VS Code 编辑器。

目录#

下载#

官方仓库#

GitHub: https://github.com/coder/code-server/releases

版本信息#

当前使用版本：v4.112.0

文件 平台 说明
code-server-4.112.0-linux-arm64.tar.gz Linux ARM64 安卓/树莓派等 ARM 设备
code-server-4.112.0-linux-amd64.tar.gz Linux AMD64 x86_64 服务器
code-server-4.112.0-macos.tar.gz macOS Mac 电脑

安装#

解压安装#

# 解压
tar -xzf code-server-4.112.0-linux-arm64.tar.gz

# 进入目录
cd code-server-4.112.0-linux-arm64

# 启动测试
./bin/code-server --help

首次启动#

./bin/code-server

启动日志示例：

[2026-03-21T06:24:42.078Z] info  Wrote default config file to /root/.config/code-server/config.yaml
[2026-03-21T06:24:57.306Z] info  code-server 4.112.0 d7599ae360900ad55b503e3c840b417a1eae4798
[2026-03-21T06:24:57.319Z] info  Using user-data-dir /root/.local/share/code-server
[2026-03-21T06:24:57.428Z] info  Using config file /root/.config/code-server/config.yaml

配置#

配置文件位置#

/root/.config/code-server/config.yaml

配置示例#

# 绑定地址和端口（0.0.0.0 允许外部访问）
bind-addr: 0.0.0.0:8080

# 认证方式
auth: password

# 登录密码
password: 2c6cxxx

# 是否启用 HTTPS
cert: false

# 可选：设置工作目录
# workspace-dir: /root/projects

配置说明#

配置项 说明 示例
bind-addr 绑定地址和端口 0.0.0.0:8080 或 127.0.0.1:8080
auth 认证方式 password / none
password 登录密码 自定义强密码
cert HTTPS 证书 false 或证书路径
workspace-dir 默认工作目录 /root/projects

启动与访问#

启动方式#

# 前台启动
./bin/code-server

# 后台启动（使用 nohup）
nohup ./bin/code-server &

# 后台启动（使用 tmux）
tmux new -s code-server
./bin/code-server
# Ctrl+B, D 分离会话

访问方式#

  1. 浏览器访问：http://服务器IP:8080
  2. 输入配置的密码登录
  3. 即可使用完整的 VS Code 编辑器

Code Server 界面

查看运行状态#

# 查看进程
ps aux | grep code-server

# 查看端口占用
netstat -tlnp | grep 8080

# 查看日志
tail -f /root/.local/share/code-server/coder-logs/combined.log

停止服务#

# 查找进程
ps aux | grep code-server

# 杀死进程
kill -9 <PID>

使用技巧#

插件安装#

Code Server 支持大部分 VS Code 插件：

  1. 点击左侧 扩展 图标
  2. 搜索并安装需要的插件
  3. 插件会自动下载到本地

推荐插件：

  • Language Support: Python, Java, C/C++, Go 等语言支持
  • Prettier: 代码格式化
  • GitLens: Git 增强功能
  • Remote Development: 远程开发工具

快捷键#

快捷键 功能
Ctrl+Shift+P 命令面板
Ctrl+P 快速打开文件
Ctrl+`` 打开终端
Ctrl+Shift+F 全局搜索
Ctrl+S 保存文件

文件管理#

# 创建项目目录
mkdir -p ~/projects

# 修改配置指定工作目录
vim ~/.config/code-server/config.yaml
# 添加：workspace-dir: /root/projects

常见问题#

Q1: 无法从外部访问

  • 检查 bind-addr 是否设置为 0.0.0.0
  • 确认防火墙已开放对应端口
  • 检查手机/路由器网络设置

Q2: 密码登录失败

  • 确认配置文件中的 password 值
  • 重启 code-server 使配置生效

Q3: 插件安装失败

  • 检查网络连接
  • 尝试手动下载插件 .vsix 文件安装
  • 使用国内镜像源