VS Code 教学工作区 · 课程 0003 · 约 15 分钟 · 前置:0002(远程开发)· 2026-10-04

容器工具:在编辑器里管 Docker

这节课的胜利:你装的那个「容器工具(Container Tools)」扩展到底在干什么,为什么它一开始一个容器都看不到, 以及怎么在 VS Code 里直接进入容器终端、翻日志、起停容器 —— 并且以后遇到「看不到容器」能自己三步定位,不用猜。

0 | 这节课解决了什么麻烦

服务器上跑着容器,但你日常的窗口是编辑器:要么切到终端敲 docker ps、docker logs、docker exec -it ... bash, 要么来回复制容器名。使命里写的「配置顺手的工作区」,这件事正好卡在缝里 —— 容器在服务器,眼睛在编辑器。

三个具体的麻烦:

1 | 三条最小知识

① 容器工具是「前端」,不是 Docker 本身

痛点:很容易以为装了这个扩展就等于装了 Docker —— 于是容器列表空着的时候,不知道是扩展的问题还是 Docker 的问题。

定义:容器工具(扩展 ID ms-azuretools.vscode-containers)只是把 docker CLI 的输出画成侧边栏:它自己不跑容器,所有动作(列出、起停、看日志、进 shell)最终都变成一条 docker 命令,交给机器上的 Docker 引擎执行。

大白话:它是仪表盘,不是发动机。发动机(引擎)不在、油管(权限)不通,仪表盘就只能是空的 —— 空不代表它坏了。

② docker 的权限:套接字 + 用户组

痛点:在终端里 docker ps 明明能跑,编辑器里的容器列表却空空如也,连个报错都不给。

定义:Docker 引擎通过 Unix 套接字 /var/run/docker.sock 接受命令,它的权限是 root:docker + 0660;想不用 sudo 就用 Docker,当前用户必须属于 docker 组(官方:安装后步骤)。

大白话:门锁只认钥匙串上的那把钥匙 —— 而 钥匙串是你进这个进程时发下来的:你把用户加进 docker 组之后,已经在跑的进程(编辑器服务端、终端会话)手里还是旧钥匙串,得重新开一次门。

③ 远端扩展与本机扩展是两套

痛点:本机扩展列表里明明有容器工具,连上远端后侧边栏却是空的。

定义:远程连接时,界面留在本机、扩展宿主在远端:凡是需要碰远端文件与命令的扩展,都得在远端也装一份(扩展面板里显示为「Install in SSH: 主机名」)。

大白话:遥控器在本机,干活的手在服务器 —— 手上没装工具,遥控器按了也没用。

串起来就是一条链:

侧边栏视图→远端的 docker CLI→/var/run/docker.sock→Docker 引擎

这条链上任何一环断了,表现都是「列表空白」 —— 所以排错要从链尾往前查,而不是盯着扩展。

2 | 本次实测:为什么看不到容器

现场是一台 Ubuntu 服务器:容器确实在跑(docker ps 在终端里能看到),但编辑器里的容器列表是空的,而且没有报错。按链条查三步:

查什么命令本次结果
用户是否在 docker 组id(看末尾有没有 docker)有 —— 983(docker)
套接字属组ls -l /var/run/docker.socksrw-rw---- root docker(只有 docker 组能读写)
正在跑的编辑器服务端进程有没有 docker 组pgrep -f vscode-server 拿 pid,再看 grep ^Groups /proc/<pid>/statusGroups: 4 24 27 30 101 1000 —— 没有 983

结论:用户是后来才被加进 docker 组的,而编辑器服务端进程在更早就启动了,手里是旧钥匙串 → 它执行 docker ps 会被套接字拒之门外 → 列表空白。终端里能用是因为那个终端是加组之后新开的会话。

修法(二选一):

  1. 重启远端编辑器服务端(推荐,一次解决):命令面板(Ctrl+Shift+P)→ Remote-SSH: Kill VS Code Server on Host... → 重新连一次。重连后进程带着新组启动,容器就出现了。等价做法:在服务器上 pkill -f vscode-server,然后重新连接。
  2. 临时绕过(不想断开时):给套接字加一条 ACL,sudo setfacl -m u:$USER:rw /var/run/docker.sock。注意 Docker 引擎重启后套接字会重建,ACL 会丢 —— 所以这只是应急。

顺手记住另外两种「空白」:远端没装这个扩展(扩展面板里点「Install in SSH: 主机名」);或者编辑器连的是另一台机器 / 另一套 Docker 上下文(状态栏左下角能看到当前远端主机名,容器视图标题栏可以切换 context)。

3 | 这个工具能干什么

区域能做的事
容器(Containers)列出全部容器(含已退出);右键:启动/停止/重启/删除、Attach Shell(进容器终端)、View Logs(实时日志)、Inspect(看配置与挂载)、复制文件进出容器
镜像(Images)看本地镜像与体积;右键:运行成容器(Run)、拉取(Pull)、打标签、推送到仓库、删除
卷与网络(Volumes / Networks)看数据卷、看容器网络;右键删除 —— 排查「数据到底挂在哪」时最省事
Compose识别项目里的 compose.yaml:右键 Compose Up / Down / Restart,或对整个项目看日志;容器会按项目分组显示
Dockerfile / compose 文件语法高亮、指令补全与悬停文档、错误提示;命令面板里 Docker: Build Image / Docker: Compose Up

它不负责:装 Docker 引擎(那是服务器上的事)、替代命令行做复杂编排、当 Docker Desktop 用。它省的是「日常查看与轻操作」的来回切窗口。

4 | 自测(选项一样长,别从长度上猜)

1. 容器工具扩展本身负责什么?

对。它是个前端:所有动作最终都变成 docker 命令交给引擎执行。装它不等于装 Docker。

2. 终端里能看到容器,编辑器里看不到,先查什么?

对。最典型的原因就是:进程启动早于「加入 docker 组」,手里是旧钥匙串。用 grep ^Groups /proc/<pid>/status 一眼看出来。

3. 加入 docker 组之后为什么要重启服务端?

对。Linux 的补充组在进程创建时就固定了,已运行的进程不会自动获得新组 —— 必须重开进程(重连/重启编辑器服务端,或退出登录)。

4. 连上远端后扩展要装在哪一边?

对。远程连接时扩展宿主在远端:凡是碰远端文件与命令的扩展,都得在远端装一份(面板里显示「Install in SSH: 主机名」)。