服务器上跑着容器,但你日常的窗口是编辑器:要么切到终端敲 docker ps、docker logs、docker exec -it ... bash,
要么来回复制容器名。使命里写的「配置顺手的工作区」,这件事正好卡在缝里 —— 容器在服务器,眼睛在编辑器。
三个具体的麻烦:
docker exec -it 容器名 sh 每次都要打全,容器名还是哈希。痛点:很容易以为装了这个扩展就等于装了 Docker —— 于是容器列表空着的时候,不知道是扩展的问题还是 Docker 的问题。
定义:容器工具(扩展 ID ms-azuretools.vscode-containers)只是把 docker CLI 的输出画成侧边栏:它自己不跑容器,所有动作(列出、起停、看日志、进 shell)最终都变成一条 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 引擎
这条链上任何一环断了,表现都是「列表空白」 —— 所以排错要从链尾往前查,而不是盯着扩展。
现场是一台 Ubuntu 服务器:容器确实在跑(docker ps 在终端里能看到),但编辑器里的容器列表是空的,而且没有报错。按链条查三步:
| 查什么 | 命令 | 本次结果 |
|---|---|---|
| 用户是否在 docker 组 | id(看末尾有没有 docker) | 有 —— 983(docker) |
| 套接字属组 | ls -l /var/run/docker.sock | srw-rw---- root docker(只有 docker 组能读写) |
| 正在跑的编辑器服务端进程有没有 docker 组 | pgrep -f vscode-server 拿 pid,再看 grep ^Groups /proc/<pid>/status | Groups: 4 24 27 30 101 1000 —— 没有 983 |
结论:用户是后来才被加进 docker 组的,而编辑器服务端进程在更早就启动了,手里是旧钥匙串 → 它执行 docker ps 会被套接字拒之门外 → 列表空白。终端里能用是因为那个终端是加组之后新开的会话。
修法(二选一):
Ctrl+Shift+P)→ Remote-SSH: Kill VS Code Server on Host... → 重新连一次。重连后进程带着新组启动,容器就出现了。等价做法:在服务器上 pkill -f vscode-server,然后重新连接。sudo setfacl -m u:$USER:rw /var/run/docker.sock。注意 Docker 引擎重启后套接字会重建,ACL 会丢 —— 所以这只是应急。顺手记住另外两种「空白」:远端没装这个扩展(扩展面板里点「Install in SSH: 主机名」);或者编辑器连的是另一台机器 / 另一套 Docker 上下文(状态栏左下角能看到当前远端主机名,容器视图标题栏可以切换 context)。
| 区域 | 能做的事 |
|---|---|
| 容器(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 用。它省的是「日常查看与轻操作」的来回切窗口。
1. 容器工具扩展本身负责什么?
对。它是个前端:所有动作最终都变成 docker 命令交给引擎执行。装它不等于装 Docker。
2. 终端里能看到容器,编辑器里看不到,先查什么?
对。最典型的原因就是:进程启动早于「加入 docker 组」,手里是旧钥匙串。用 grep ^Groups /proc/<pid>/status 一眼看出来。
3. 加入 docker 组之后为什么要重启服务端?
对。Linux 的补充组在进程创建时就固定了,已运行的进程不会自动获得新组 —— 必须重开进程(重连/重启编辑器服务端,或退出登录)。
4. 连上远端后扩展要装在哪一边?
对。远程连接时扩展宿主在远端:凡是碰远端文件与命令的扩展,都得在远端装一份(面板里显示「Install in SSH: 主机名」)。