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-server2. 运行容器并生成初始配置
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挂载任意本地目录作为项目文件夹。 - 升级:拉取新镜像后删除旧容器,用相同命令重建即可。
🛡️ 安全建议
- 不要暴露在公网无密码!始终设置强密码。
- 建议配合 反向代理(Nginx/Caddy)+ HTTPS 使用。
- 可限制 IP 访问或启用 2FA(需额外配置)。
- 考虑使用
.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 的完整方案?
最后一次更新于2025-11-12


