VSCode + SSH + Docker 完整配置流程

以下是一份完整的、可复用的配置流程，从一台全新的 Linux 机器到 VSCode 免密管理 Docker，按顺序执行即可。

一、Linux 端准备#

1.1 开启 SSH 服务#

Kali Linux：

1
# 启动 SSH
2
sudo /etc/init.d/ssh start
3

4
# 开机自启
5
sudo systemctl enable ssh.service

Ubuntu/Debian：

1
# 安装并启动
2
sudo apt-get update
3
sudo apt-get install -y openssh-server
4
sudo service ssh start

1.2 查看 IP 地址#

1
ip a

记下 inet 后面的局域网 IP（如 192.168.17.129）。

二、Windows 端准备#

2.1 安装 VSCode 插件#

打开 VSCode，安装以下扩展：

Remote - SSH
Docker

2.2 生成 SSH 密钥对#

打开 PowerShell，执行：

1
ssh-keygen -t ed25519

保存路径：直接回车（默认 C:\Users\你的用户名\.ssh\id_ed25519）
密码：直接回车（不设密码，实现完全免密）

生成后确认文件存在：

1
ls $env:USERPROFILE\.ssh\

应看到：

id_ed25519 —— 私钥（留在 Windows）
id_ed25519.pub —— 公钥（放到 Linux）

三、配置免密登录（公私钥）#

3.1 将公钥上传到 Linux#

方法一：命令自动上传（推荐） 在 Windows PowerShell 执行（替换 IP 和用户名）：

1
type $env:USERPROFILE\.ssh\id_ed25519.pub | ssh kali@192.168.17.129 "mkdir -p ~/.ssh && cat >> ~/.ssh/authorized_keys && chmod 600 ~/.ssh/authorized_keys && chmod 700 ~/.ssh"

输入一次密码后，公钥即上传完成。

方法二：手动复制

用记事本打开 C:\Users\你的用户名\.ssh\id_ed25519.pub，复制全部内容
在 VSCode 连上的 Linux 终端中：
Terminal window
```
1
nano ~/.ssh/authorized_keys
```
粘贴 → Ctrl+O 回车保存 → Ctrl+X 退出

设置权限：

1
chmod 600 ~/.ssh/authorized_keys
2
chmod 700 ~/.ssh

3.2 配置 VSCode SSH 使用私钥#

按 Ctrl+Shift+P → Remote-SSH: Open SSH Configuration File → 选择第一个。

添加或修改配置：

1
Host kali
2
    HostName 192.168.17.129
3
    User kali
4
    IdentityFile C:\Users\你的用户名\.ssh\id_ed25519

注意：IdentityFile 指向的是私钥（id_ed25519），不是 .pub。

3.3 修复 Windows 私钥权限（关键！）#

在 PowerShell 执行：

1
cd $env:USERPROFILE\.ssh
2

3
# 移除继承权限，仅保留当前用户读取
4
icacls id_ed25519 /inheritance:r
5
icacls id_ed25519 /grant:r "$($env:USERNAME):(R)"

3.4 测试免密连接#

在 PowerShell 测试：

1
ssh -i $env:USERPROFILE\.ssh\id_ed25519 kali@192.168.17.129

如果直接连上，说明配置成功。

然后在 VSCode 中：

点击左下角绿色 >< 图标
选择 Connect to Host... → kali
应直接连上，不再提示密码

四、Linux 端安装 Docker#

4.1 安装 Docker#

推荐方式（Ubuntu/Debian）：

1
wget -qO- https://get.docker.com/ | sh

Kali Linux（Docker 官方不支持 Kali，需手动）：

1
sudo apt-get update
2
sudo apt-get install -y ca-certificates curl gnupg lsb-release
3

4
# 添加 GPG key
5
sudo mkdir -p /etc/apt/keyrings
6
curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
7

8
# 使用 Debian 源（Kali 基于 Debian）
9
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian buster stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
10

11
# 安装
12
sudo apt-get update
13
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

4.2 验证安装#

1
sudo docker run hello-world

看到 Hello from Docker! 即成功。

五、解决 Docker 权限问题#

VSCode 连上后，Docker 插件可能提示无法访问 /var/run/docker.sock。

一劳永逸的解法：

在 Linux 终端执行：

1
# 将当前用户加入 docker 组
2
sudo usermod -aG docker $USER
3

4
# 重启 Docker 服务
5
sudo systemctl restart docker

然后断开 VSCode SSH 连接，重新连接（或重启 Linux）。

验证：

1
docker ps

不再提示权限错误即成功。

六、VSCode Docker 插件使用#

连接成功后，左侧边栏出现 Docker 图标，常用功能：

功能	操作
拉取镜像	Images → 右键 `Pull` 或终端执行 `docker pull`
运行容器	镜像右键 → `Run`（后台）/ `Run Interactive`（带日志）
进入容器终端	容器右键 → `Attach Shell`
查看日志	容器右键 → `View Logs`
编辑容器文件	展开容器 `Files` 树，直接双击修改
端口转发	容器右键 → `Forward Port`，自动映射到 Windows 本地
浏览器打开	端口转发后，右键 `Open in Browser`

七、快速检查清单#

每次复用或排查问题时，按以下顺序检查：

检查项	命令/操作
Linux SSH 是否运行	`sudo service ssh status`
Windows 私钥权限	`icacls C:\Users\用户名\.ssh\id_ed25519`（应只有当前用户）
Linux 公钥是否正确	`cat ~/.ssh/authorized_keys`
Linux .ssh 权限	`ls -la ~/.ssh`（700 + 600）
用户是否在 docker 组	`groups`（应看到 `docker`）
VSCode 配置路径	`IdentityFile` 指向私钥，不是 `.pub`

八、配置文件模板#

Windows SSH 配置（C:\Users\用户名\.ssh\config）：

1
Host kali
2
    HostName 192.168.17.129
3
    User kali
4
    IdentityFile C:\Users\你的用户名\.ssh\id_ed25519
5
    ForwardAgent yes

Linux SSH 配置（/etc/ssh/sshd_config，可选加固）：

1
PubkeyAuthentication yes
2
PasswordAuthentication no    # 确认密钥可用后再开启，禁用密码登录

修改后重启 SSH：

1
sudo service ssh restart

按这个流程走，任何新的 Kali/Ubuntu/Debian 机器都可以在 5 分钟内配置好完整的远程 Docker 开发环境。