QEMU启动脚本#

情况基本跟上述提到的文章一致，只不过我将环境运行在了较新的设备上而已，以下是QEMU启动Alpine镜像的启动脚本：

1
qemu-system-aarch64 \
2
        -m 2G \
3
        -cpu cortex-a72 \
4
        -smp cpus=2 \
5
        -boot order=cd \
6
        -M virt \
7
        -bios QEMU_EFI.fd \
8
        -nographic \
9
        -drive file=virt-alpine-50G.img,if=virtio,format=qcow2 \
10
        -device e1000,netdev=nde1,id=d-net1 \
11
        -netdev user,id=nde1,hostfwd=tcp::2222-:22 \

如果你看不懂也没有关系，只需要关注最后一行的端口转发部分，其指出将QEMU虚拟机内部的22端口转发到外部的2222端口，原因是ssh默认22端口在物理设备上不可用，所以将其转发到2222以让外部设备可以通过这个端口进行ssh连接；

OpenSSH 配置#

CAUTION

如果你的ssh服务并非由OpenSSH提供，可能需要自行寻找配置方法，或换用OpenSSH
一般来说除非刻意配置，各个发行版的ssh服务均由OpenSSH服务提供

VsCode需要通过ssh建立连接，且需要使用一些ssh的高级功能，这一部分在Alpine默认是关闭的，需要手动进行配置：

1
...
2
AllowTcpForwarding no
3
AllowTcpForwarding yes
4
...
5
#PermitTunnel no
6
PermitTunnel yes
7
...

这两个配置项的功能如下：

• AllowTcpForwarding
  控制是否允许 SSH 客户端通过 SSH 连接建立 TCP 端口转发，这一项必须设置为 yes
  VS Code Remote-SSH 依赖 TCP 端口转发来传输数据
  在建立 SSH 连接后，VS Code 会在后台创建多个端口转发通道用于传输文件、终端数据、扩展通信等

• PermitTunnel
  控制是否允许通过 SSH 连接建立隧道，此项可选
  通常不需要隧道功能，只有在使用高级网络功能时才需要启用

如果你的系统只有Root用户的话，还需要检查以下两个条目：

1
···
2
PermitRootLogin yes   # 允许Root用户通过SSH登录
3
···
4
PasswordAuthentication yes # 允许SSH通过密码登录
5
···

完成配置后使用如下指令重启SSH服务或者直接重启Alpine

1
rc-service sshd restart

安装必要的软件包#

1
apk update
2
apk add gcompat libstdc++ procps

• gcompat 和 libstdc++
  VsCode的远程服务端是使用glibc编译的，而Alpine默认使用musl libc，这两个包提供了兼容层；
• procps
  Alpine Linux作为轻量级发行版，使用BusyBox提供的精简版工具替代了完整的GNU工具链；
  当VSCode Remote-SSH尝试执行带有GNU风格参数（如ps -p）的命令时，BusyBox的简化实现无法识别这些参数，导致连接过程失败；
  这个包提供了VsCode可用的指令合集；

如果使用了其它的Linux发行版，这些步骤并不是必要的，仅针对Alpine需要安装这些软件包

扩展安装#

现在远程连接功能已经集成到VsCode中了，你可以在VsCode的左下角找到这个图标，点击它以建立一个远程SSH连接，VsCode会自动安装相关扩展：

如果你的VsCode找不到这个图标，建议先更新一下VsCode

配置连接#

扩展安装完成后，会在左侧出现RemoteSSH远程资源管理器选项卡，我们在SSH栏位下添加一条远程连接：

填充内容如下格式：

1
<UserName>@<Addr>:<Port>

例如在我当前的网络环境下，Alpine用户名为root，物理设备IP地址为192.168.1.8，QEMU配置将其SSH端口映射到物理设备的2222端口，则此处需要填入root@192.168.1.8:2222

更新的配置文件选择当前用户的.ssh即可：

完成后可以在远程资源管理器选项卡中看到刚才的配置，你可以点击直接修改这个配置文件：

其中第一行Host为显示在远程资源管理器选项卡中的名称，你也可以修改为物理设备名称，例如这里物理设备是一台小米15，我就将这个连接名称改为XiaoMi-15，然后点击连接：

选择连接目标的平台，VsCode会根据目标平台在对应设备进行配置，这里我们选择Linux：

点击信任目标指纹：

输入root用户的密码：

可以看到右下角VsCode完成连接，并开始在Alpine上下载部署VsCode服务器：

这个步骤需要花一些时间，等待服务器部署完成后，VsCode会进行一系列配置，等到连接完成后即可在远程资源管理器选项卡中看到已连接状态：

之后回到资源管理器选项卡打开工作区文件夹即可，当然这里建议先在Alpine中创建好对应的文件夹再使用VsCode打开： 每次打开新的文件夹或建立连接都需要再次输入密码；

远程工作区扩展#

远程服务器的扩展组件是独立于本地扩展组件的，除了某些不影响远程服务器的组件如VsCode语言包、客户端主题等，各类功能性扩展需要额外安装，例如语言支持类扩展，如果要在远程工作区使用语言支持类扩展提供的代码格式化功能，则需要单独为其安装对应的插件。

VsCode 服务器相关#

在Alpine的Root用户目录下可以找到VsCode的服务端文件：

1
alpine:~# ls -all -h ↵
2
total 56K
3
drwx------    9 root     root        4.0K Oct  9 20:13 .
4
drwxr-xr-x   22 root     root        4.0K Oct  8 14:33 ..
5
-rw-------    1 root     root        6.0K Oct 11 01:59 .ash_history
6
drwxr-xr-x    3 root     root        4.0K Oct  8 14:34 .cache
7
drwxr-xr-x    3 root     root        4.0K Oct  9 14:06 .config
8
drwxr-xr-x    3 root     root        4.0K Oct  8 17:02 .dotnet
9
-rw-r--r--    1 root     root          53 Oct  8 14:43 .gitconfig
10
drwx------    2 root     root        4.0K Oct  8 17:23 .ssh
11
-rw-------    1 root     root        4.9K Oct  9 20:13 .viminfo
12
drwxr-x---    5 root     root        4.0K Oct 11 01:47 .vscode-server
13
drwxr-xr-x    2 root     root        4.0K Oct  9 14:07 download_packages
14
drwxr-xr-x    3 root     root        4.0K Oct  8 14:37 vscode_workspace
15
alpine:~#

进入.vscode-server这个目录,里面的内容如下：

1
alpine:~/.vscode-server# ls -all -h ↵
2
total 36M
3
drwxr-x---    5 root     root        4.0K Oct 11 01:47 .
4
drwx------    9 root     root        4.0K Oct  9 20:13 ..
5
-rw-------    1 root     root         428 Oct 11 01:47 .cli.03c265b1adee71ac88f833e065f7bb956b60550a.log
6
-rw-------    1 root     root         468 Oct  9 20:42 .cli.17baf841131aa23349f217ca7c570c76ee87b957.log
7
drwxr-xr-x    3 root     root        4.0K Oct  8 14:18 cli
8
-rwxrwxr-x    1 root     root       19.2M Oct  8 22:17 code-03c265b1adee71ac88f833e065f7bb956b60550a
9
-rwxr-xr-x    1 root     root       16.7M Apr 16 07:29 code-17baf841131aa23349f217ca7c570c76ee87b957
10
drwx------    8 root     root        4.0K Oct  9 09:23 data
11
drwx------    6 root     root        4.0K Oct 11 01:48 extensions
12
alpine:~/.vscode-server#

其中cli与data存储了VsCode服务端组件，extensions中存储了VsCode服务端的扩展组件，我们安装的远程扩展会被存储在这里；

除此之外还有一个重要的文件code-03c265b1adee71ac88f833e065f7bb956b60550a，不同版本以及以及安装在不同位置的的VsCode客户端都有对应的识别码，每一个不同识别码的VsCode客户端连接到远程服务器时都会在这个目录下创建对应的服务端文件，你可以在你运行VsCode终端上运行以下指令查看对应的识别码：

如果后续出现连接不上的问题且检查其余环境配置均无果，可以试试清除对应的服务端文件及其.log日志文件后重新尝试连接，极端情况下可以移除整个.vscode-server；