重启Docker实例后如何复用已安装的VSCode Server？

问题描述 #

我在Linux服务器上运行Docker镜像，容器挂载宿主机器的/home/<USER>目录以访问所有文件。本地通过VSCode的SSH远程连接到容器进行项目开发：

• 首次连接时，VSCode会将Server安装到远程的/home/<USER>/.vscode-server目录，远程扩展也存放在这里。
• 关闭连接后重新连接无问题，但Docker实例重启后，VSCode会将其识别为新远程机器，尝试重新安装Server时失败，报错如下：

> mkdir: cannot create directory ‘/home/<USER>/.vscode-server/bin’Creating the se
> rver install dir failed...
> 2fe8b7d51fa4: start
> exitCode==34==
> listeningOn====
> osReleaseId====
> arch====
> tmpDir==/tmp==
> platform====
> unpackResult====
> : Permission denied
> didLocalDownload==0==
> downloadTime====
> installTime====
[10:44:20.231] > extInstallTime==== 
> serverStartTime====
> 2fe8b7d51fa4: end  
[10:44:20.231] Received install output: 
exitCode==34==
listeningOn====
osReleaseId====
arch====
tmpDir==/tmp==
platform====
unpackResult====
: Permission denied
didLocalDownload==0==
downloadTime====
installTime====
extInstallTime==== 
serverStartTime====

[10:44:20.233] Resolver error: Error: Permission denied

当前临时解决方法是每次Docker重启后删除~/.vscode-server目录，让VSCode重新安装Server并再次选择需远程安装的扩展，但希望找到直接复用已有Server的办法。备注：已检查~/.vscode-server的权限，修改了所属用户和组，甚至尝试设置chmod 777，均无效。

解决方案 #

1. 对齐容器与宿主用户的UID/GID #

容器重启后，容器内用户的UID/GID可能和宿主/home/<USER>目录的权限主体不匹配，导致权限报错：

• 先查看宿主用户的UID/GID：id <USER>，得到类似uid=1000(user) gid=1000(user)的结果。
• 运行容器时指定用户身份：添加--user 1000:1000参数，或在Dockerfile中设置USER 1000:1000，确保容器内用户和宿主目录所属用户完全一致。

2. 固定容器hostname #

VSCode远程通过机器标识（如hostname）识别远程环境，容器重启后hostname默认会变化，导致被判定为新机器：

• 运行容器时添加--hostname vscode-dev-container参数，让每次重启后容器hostname固定，VSCode会识别为同一远程环境。

3. 预安装VSCode Server到镜像 #

把VSCode Server提前打包进Docker镜像，容器重启后直接复用已安装的文件：

1. 从报错信息中提取Server的commit-id（如2fe8b7d51fa4），对应VSCode版本的Server下载链接为https://update.code.visualstudio.com/commit:<commit-id>/server-linux-x64/stable。
2. 在Dockerfile中添加下载解压步骤：

RUN mkdir -p /home/<USER>/.vscode-server/bin/<commit-id> \
    && curl -L https://update.code.visualstudio.com/commit:<commit-id>/server-linux-x64/stable -o vscode-server.tar.gz \
    && tar -xzf vscode-server.tar.gz -C /home/<USER>/.vscode-server/bin/<commit-id> --strip-components 1 \
    && rm vscode-server.tar.gz

3. 重新构建镜像并运行，VSCode会直接使用预安装的Server。

4. 指定远程Server路径 #

在本地VSCode的SSH配置文件（~/.ssh/config）中添加配置，强制使用已有的Server目录：

Host docker-dev-container
    HostName <容器IP或hostname>
    User <USER>
    RemoteCommand bash -c "export VSCODE_SERVER_DATA_DIR=/home/<USER>/.vscode-server; exec bash"

内容的提问来源于stack exchange，提问作者Friedrich Gretz