Docker 版 Code-Server 是一个非常流行的方案,可以让你在服务器上运行 VS Code,并通过浏览器远程访问。以下是使用 Docker 快速部署 code-server 的方法。


🚀 快速启动(基础版)

docker run -d \
  --name=vscode \
  -p 8680:8080 \
  -v /opt/share/vscode/project:/home/coder/project \
  -e PASSWORD=aico.vip \
  codercom/code-server:latest

参数说明:

  • -d:后台运行容器。
  • --name=code-server:容器名称。
  • -p 8080:8080:将主机的 8080 端口映射到容器的 8080 端口(code-server 默认端口)。
  • -v /path/to/your/project:/home/coder/project:挂载本地项目目录到容器中(可选但推荐)。
  • -e PASSWORD=your_secure_password:设置访问密码(务必修改为强密码)。
  • codercom/code-server:latest:官方镜像(也可指定版本如 4.92.1)。
访问地址:http://你的服务器IP:8080
登录密码:你设置的 PASSWORD

🔐 更安全的配置(推荐)

建议使用配置文件方式启动,便于管理扩展、设置等。

1. 创建配置目录

mkdir -p ~/.config/code-server

2. 运行容器并生成初始配置

docker run --rm -v ~/.config/code-server:/home/coder/.local/share/code-server codercom/code-server:latest

这会生成默认配置文件 config.yaml

3. 编辑配置文件

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

示例内容:

bind-addr: 0.0.0.0:8080
auth: password
password: your_strong_password_here
cert: false
如需 HTTPS,可设 cert: true(自动生成证书),或挂载自己的证书。

4. 启动正式容器

docker run -d \
  --name code-server \
  -p 8080:8080 \
  -v /path/to/your/project:/home/coder/project \
  -v ~/.config/code-server:/home/coder/.local/share/code-server \
  codercom/code-server:latest

📦 持久化与扩展

  • 插件和设置:都保存在 ~/.config/code-server 中,挂载后重启不会丢失。
  • 工作区:通过 -v 挂载任意本地目录作为项目文件夹。
  • 升级:拉取新镜像后删除旧容器,用相同命令重建即可。

🛡️ 安全建议

  1. 不要暴露在公网无密码!始终设置强密码。
  2. 建议配合 反向代理(Nginx/Caddy)+ HTTPS 使用。
  3. 可限制 IP 访问或启用 2FA(需额外配置)。
  4. 考虑使用 .env 文件管理敏感信息(配合 --env-file)。

🧩 示例:带 Nginx 反向代理 + HTTPS(简略)

如果你用 Nginx + Let's Encrypt:

location / {
    proxy_pass http://localhost:8080;
    proxy_set_header Host $host;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection upgrade;
    proxy_cache_bypass $http_upgrade;
}

然后通过域名 https://code.yourdomain.com 安全访问。


需要我帮你写一个完整的 docker-compose.yml 吗?或者集成 HTTPS 的完整方案?