1. 为什么需要离线部署VS Code Server最近在给客户部署远程开发环境时遇到了一个棘手的问题他们的服务器完全隔离外网但团队又急需使用VS Code进行远程开发。这让我意识到掌握VS Code Server的离线部署方法对于企业开发环境搭建来说是个必备技能。VS Code Server是微软提供的远程开发组件它允许我们在服务器上运行一个轻量级的代码服务端然后通过本地VS Code客户端进行连接。这种架构带来了很多优势比如可以利用服务器强大的计算资源保持开发环境的一致性等。但在实际部署中网络问题往往成为最大的绊脚石。最常见的报错就是XHR Failed和超时错误。这些错误通常发生在两种场景下一是服务器完全无法连接外网二是网络状况不稳定导致下载中断。特别是在企业内网环境中出于安全考虑很多服务器都是隔离外网的这时候就需要我们手动完成离线部署。2. 准备工作获取正确的安装包2.1 确定Commit ID离线部署的第一步也是最关键的一步就是获取正确的VS Code Server安装包。这里有个小技巧分享给大家每个VS Code版本都对应一个唯一的Commit ID我们需要先获取这个ID。最简单的方法是在你本地的VS Code中查看打开VS Code点击左上角菜单栏的帮助选择关于在版本信息中就能找到Commit ID它是一串40位的哈希值比如af28b32d7e553898b2a91af498b1fb666fdebe0c如果你没有安装VS Code也可以直接访问VS Code官网的更新日志页面找到最新稳定版的Commit ID。2.2 下载离线安装包拿到Commit ID后我们就可以构造下载链接了。VS Code Server的Linux版本下载地址格式如下https://update.code.visualstudio.com/commit:${commit_id}/server-linux-x64/stable把${commit_id}替换成你获取到的实际Commit ID即可。比如https://update.code.visualstudio.com/commit:af28b32d7e553898b2a91af498b1fb666fdebe0c/server-linux-x64/stable这个链接会返回一个名为vscode-server-linux-x64.tar.gz的压缩包。这里有个实用建议最好在一台能联网的机器上下载这个包然后用U盘或其他方式传输到目标服务器。我遇到过很多次因为网络不稳定导致下载中断的情况所以建议先完整下载再传输。3. 详细安装步骤3.1 创建目录结构在目标服务器上我们需要先创建VS Code Server的标准目录结构。执行以下命令mkdir -p ~/.vscode-server/bin这个目录是VS Code Server的标准安装位置客户端连接时会自动查找这个路径。我建议保持这个默认位置避免不必要的配置问题。3.2 解压安装包将下载好的vscode-server-linux-x64.tar.gz上传到服务器后执行以下步骤# 清空原有文件如果是首次安装可以跳过 rm -rf ~/.vscode-server/bin/* # 解压安装包 tar -zxf vscode-server-linux-x64.tar.gz # 移动并重命名文件夹 mv vscode-server-linux-x64 ~/.vscode-server/bin/${commit_id}这里有个容易踩坑的地方解压后的文件夹名称必须与Commit ID完全一致。比如你的Commit ID是af28b32d7e553898b2a91af498b1fb666fdebe0c那么最终的文件夹路径就应该是~/.vscode-server/bin/af28b32d7e553898b2a91af498b1fb666fdebe0c3.3 验证安装安装完成后可以通过以下方式验证查看目录结构是否正确ls -la ~/.vscode-server/bin/${commit_id}应该能看到node、server.sh等关键文件。尝试启动服务~/.vscode-server/bin/${commit_id}/bin/code-server如果看到服务启动日志说明安装成功。4. 常见问题解决4.1 处理XHR Failed错误即使完成了离线安装首次连接时可能还是会遇到XHR Failed错误。这是因为VS Code客户端会尝试从网络获取一些元数据。解决方法很简单在客户端VS Code的设置中搜索Remote.SSH: Allow Local Server Download将其设置为false重启VS Code这个设置会强制客户端使用服务器上已经安装的VS Code Server而不是尝试从网络下载。4.2 版本不匹配问题有时候客户端和服务器的版本不一致会导致连接失败。解决方法有确保客户端和服务器的Commit ID完全一致如果必须使用不同版本可以在客户端的设置中搜索Remote.SSH: Server Pick选择从已安装的版本中选择手动选择服务器上安装的版本4.3 扩展安装问题离线环境下安装扩展也是个常见痛点。我的经验是先在能联网的机器上用VSIX方式下载所需扩展将.vsix文件传输到服务器使用以下命令安装code-server --install-extension /path/to/extension.vsix或者更简单的方法直接把能联网机器上的~/.vscode-server/extensions目录整个复制到目标服务器的相同位置。5. 高级技巧批量部署与维护5.1 自动化部署脚本如果需要给多台服务器部署相同的环境可以编写一个简单的部署脚本#!/bin/bash COMMIT_IDaf28b32d7e553898b2a91af498b1fb666fdebe0c VSCODE_SERVER_URLhttps://update.code.visualstudio.com/commit:${COMMIT_ID}/server-linux-x64/stable # 下载安装包 wget ${VSCODE_SERVER_URL} -O vscode-server-linux-x64.tar.gz # 安装 mkdir -p ~/.vscode-server/bin tar -zxf vscode-server-linux-x64.tar.gz mv vscode-server-linux-x64 ~/.vscode-server/bin/${COMMIT_ID} # 清理 rm vscode-server-linux-x64.tar.gz echo VS Code Server ${COMMIT_ID} installed successfully!5.2 版本升级策略当需要升级VS Code Server版本时建议不要直接删除旧版本先保留按照同样方法安装新版本测试新版本是否正常工作确认无误后再删除旧版本这样可以确保在升级失败时能快速回退到稳定版本。5.3 容器化部署对于使用Docker的环境可以考虑将VS Code Server打包到镜像中。Dockerfile示例FROM ubuntu:20.04 # 安装基础依赖 RUN apt-get update apt-get install -y \ wget \ tar \ openssh-server # 安装VS Code Server RUN mkdir -p /root/.vscode-server/bin \ wget https://update.code.visualstudio.com/commit:af28b32d7e553898b2a91af498b1fb666fdebe0c/server-linux-x64/stable -O vscode-server-linux-x64.tar.gz \ tar -zxf vscode-server-linux-x64.tar.gz \ mv vscode-server-linux-x64 /root/.vscode-server/bin/af28b32d7e553898b2a91af498b1fb666fdebe0c \ rm vscode-server-linux-x64.tar.gz # 启动SSH服务 RUN mkdir /var/run/sshd EXPOSE 22 CMD [/usr/sbin/sshd, -D]这样构建的镜像就包含了特定版本的VS Code Server可以方便地在各种环境中部署。
VS Code Server 离线部署全攻略（绕过网络限制与安装报错）
发布时间：2026/7/9 13:07:21
1. 为什么需要离线部署VS Code Server最近在给客户部署远程开发环境时遇到了一个棘手的问题他们的服务器完全隔离外网但团队又急需使用VS Code进行远程开发。这让我意识到掌握VS Code Server的离线部署方法对于企业开发环境搭建来说是个必备技能。VS Code Server是微软提供的远程开发组件它允许我们在服务器上运行一个轻量级的代码服务端然后通过本地VS Code客户端进行连接。这种架构带来了很多优势比如可以利用服务器强大的计算资源保持开发环境的一致性等。但在实际部署中网络问题往往成为最大的绊脚石。最常见的报错就是XHR Failed和超时错误。这些错误通常发生在两种场景下一是服务器完全无法连接外网二是网络状况不稳定导致下载中断。特别是在企业内网环境中出于安全考虑很多服务器都是隔离外网的这时候就需要我们手动完成离线部署。2. 准备工作获取正确的安装包2.1 确定Commit ID离线部署的第一步也是最关键的一步就是获取正确的VS Code Server安装包。这里有个小技巧分享给大家每个VS Code版本都对应一个唯一的Commit ID我们需要先获取这个ID。最简单的方法是在你本地的VS Code中查看打开VS Code点击左上角菜单栏的帮助选择关于在版本信息中就能找到Commit ID它是一串40位的哈希值比如af28b32d7e553898b2a91af498b1fb666fdebe0c如果你没有安装VS Code也可以直接访问VS Code官网的更新日志页面找到最新稳定版的Commit ID。2.2 下载离线安装包拿到Commit ID后我们就可以构造下载链接了。VS Code Server的Linux版本下载地址格式如下https://update.code.visualstudio.com/commit:${commit_id}/server-linux-x64/stable把${commit_id}替换成你获取到的实际Commit ID即可。比如https://update.code.visualstudio.com/commit:af28b32d7e553898b2a91af498b1fb666fdebe0c/server-linux-x64/stable这个链接会返回一个名为vscode-server-linux-x64.tar.gz的压缩包。这里有个实用建议最好在一台能联网的机器上下载这个包然后用U盘或其他方式传输到目标服务器。我遇到过很多次因为网络不稳定导致下载中断的情况所以建议先完整下载再传输。3. 详细安装步骤3.1 创建目录结构在目标服务器上我们需要先创建VS Code Server的标准目录结构。执行以下命令mkdir -p ~/.vscode-server/bin这个目录是VS Code Server的标准安装位置客户端连接时会自动查找这个路径。我建议保持这个默认位置避免不必要的配置问题。3.2 解压安装包将下载好的vscode-server-linux-x64.tar.gz上传到服务器后执行以下步骤# 清空原有文件如果是首次安装可以跳过 rm -rf ~/.vscode-server/bin/* # 解压安装包 tar -zxf vscode-server-linux-x64.tar.gz # 移动并重命名文件夹 mv vscode-server-linux-x64 ~/.vscode-server/bin/${commit_id}这里有个容易踩坑的地方解压后的文件夹名称必须与Commit ID完全一致。比如你的Commit ID是af28b32d7e553898b2a91af498b1fb666fdebe0c那么最终的文件夹路径就应该是~/.vscode-server/bin/af28b32d7e553898b2a91af498b1fb666fdebe0c3.3 验证安装安装完成后可以通过以下方式验证查看目录结构是否正确ls -la ~/.vscode-server/bin/${commit_id}应该能看到node、server.sh等关键文件。尝试启动服务~/.vscode-server/bin/${commit_id}/bin/code-server如果看到服务启动日志说明安装成功。4. 常见问题解决4.1 处理XHR Failed错误即使完成了离线安装首次连接时可能还是会遇到XHR Failed错误。这是因为VS Code客户端会尝试从网络获取一些元数据。解决方法很简单在客户端VS Code的设置中搜索Remote.SSH: Allow Local Server Download将其设置为false重启VS Code这个设置会强制客户端使用服务器上已经安装的VS Code Server而不是尝试从网络下载。4.2 版本不匹配问题有时候客户端和服务器的版本不一致会导致连接失败。解决方法有确保客户端和服务器的Commit ID完全一致如果必须使用不同版本可以在客户端的设置中搜索Remote.SSH: Server Pick选择从已安装的版本中选择手动选择服务器上安装的版本4.3 扩展安装问题离线环境下安装扩展也是个常见痛点。我的经验是先在能联网的机器上用VSIX方式下载所需扩展将.vsix文件传输到服务器使用以下命令安装code-server --install-extension /path/to/extension.vsix或者更简单的方法直接把能联网机器上的~/.vscode-server/extensions目录整个复制到目标服务器的相同位置。5. 高级技巧批量部署与维护5.1 自动化部署脚本如果需要给多台服务器部署相同的环境可以编写一个简单的部署脚本#!/bin/bash COMMIT_IDaf28b32d7e553898b2a91af498b1fb666fdebe0c VSCODE_SERVER_URLhttps://update.code.visualstudio.com/commit:${COMMIT_ID}/server-linux-x64/stable # 下载安装包 wget ${VSCODE_SERVER_URL} -O vscode-server-linux-x64.tar.gz # 安装 mkdir -p ~/.vscode-server/bin tar -zxf vscode-server-linux-x64.tar.gz mv vscode-server-linux-x64 ~/.vscode-server/bin/${COMMIT_ID} # 清理 rm vscode-server-linux-x64.tar.gz echo VS Code Server ${COMMIT_ID} installed successfully!5.2 版本升级策略当需要升级VS Code Server版本时建议不要直接删除旧版本先保留按照同样方法安装新版本测试新版本是否正常工作确认无误后再删除旧版本这样可以确保在升级失败时能快速回退到稳定版本。5.3 容器化部署对于使用Docker的环境可以考虑将VS Code Server打包到镜像中。Dockerfile示例FROM ubuntu:20.04 # 安装基础依赖 RUN apt-get update apt-get install -y \ wget \ tar \ openssh-server # 安装VS Code Server RUN mkdir -p /root/.vscode-server/bin \ wget https://update.code.visualstudio.com/commit:af28b32d7e553898b2a91af498b1fb666fdebe0c/server-linux-x64/stable -O vscode-server-linux-x64.tar.gz \ tar -zxf vscode-server-linux-x64.tar.gz \ mv vscode-server-linux-x64 /root/.vscode-server/bin/af28b32d7e553898b2a91af498b1fb666fdebe0c \ rm vscode-server-linux-x64.tar.gz # 启动SSH服务 RUN mkdir /var/run/sshd EXPOSE 22 CMD [/usr/sbin/sshd, -D]这样构建的镜像就包含了特定版本的VS Code Server可以方便地在各种环境中部署。
，我遇到了3个问题)
