VS Code Web

应用介绍

VS Code Web（code-server）可以在服务器/NAS 上运行 VS Code，并通过浏览器进行远程开发。它适合将开发环境固定在 NAS 上，避免本地环境碎片化，同时利用服务器的计算和网络资源加速构建与下载。结合反向代理与 HTTPS，可安全地在任意设备上随时接入同一开发环境。

在 NAS 场景中，推荐使用 LinuxServer.io 的 code-server 镜像，具备多架构支持与标准的 PUID/PGID 权限管理，便于挂载工作空间与配置目录，避免文件权限混乱。

安装说明

前提依赖

• 准备好持久化的配置目录与工作空间目录
• 如需公网访问，建议绑定域名并在代理层启用 HTTPS 与基本认证
• 根据宿主机用户设置 PUID/PGID，避免容器内生成的文件与宿主权限冲突

安装配置

以下示例使用 LinuxServer.io 官方镜像 lscr.io/linuxserver/code-server，默认监听 8443 端口：

version: "3.8"
services:
  code-server:
    image: lscr.io/linuxserver/code-server:latest
    container_name: code-server
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
      - PASSWORD=yourpassword
      - SUDO_PASSWORD=yourpassword
    volumes:
      - ./config:/config
      - ./project:/config/workspace
    ports:
      - "8443:8443"
    restart: unless-stopped

注意：

• 使用 id 命令获取宿主机用户的 UID/GID，替换 PUID/PGID
• 默认通过密码访问；也可结合反向代理添加额外的认证与限流策略
• 工作空间挂载到 /config/workspace，便于与扩展和设置共存与备份

使用说明

• 首次访问：浏览器打开 https://NAS_IP:8443，使用设定的密码登录
• 扩展与设置：所有配置与扩展保存在 ./config；建议定期备份
• 项目管理：将项目目录挂载到 project；也可通过 Git 直接拉取与推送
• 安全建议：公网访问务必置于反向代理后开启 TLS 与强密码或双重认证

开源信息

• LinuxServer.io 镜像文档：https://docs.linuxserver.io/images/docker-code-server/ [来源]
• Docker Hub（codercom）：https://hub.docker.com/r/codercom/code-server [来源]
• 项目主页与文档：https://github.com/coder/code-server [来源]