文章目录背景为什么需要手动下载手动安装第一步下载 VSCode Server方法1直接执行如下批处理脚本方法2使用 PowerShell第二步传输文件到远程 Linux 机器方法 1使用 SCP 命令方法 2使用 SFTP 工具方法 3使用 PowerShell第三步在远程 Linux 机器上安装第四步重启 VSCode 并重新连接常见问题问题 1下载速度慢问题 2解压失败问题 3权限问题验证安装成功清理背景为什么需要手动下载VSCode远程SSH连接需要在远程Linux机器上安装一个VSCode Server组件。通常情况下VSCode会自动下载并安装这个组件但有时会失败原因包括网络问题- 远程机器无法访问VSCode更新服务器防火墙限制- 企业网络或防火墙阻止了下载下载超时- 网络速度慢导致下载超时代理配置错误- 代理设置不当导致连接失败远程机器无外网访问- 内网环境无法直接下载当自动下载失败时就需要手动在本地下载然后传输到远程机器进行安装。手动安装在自动下载时长时间无法成功、或反复失败这时候看日志能看到Commit HASH比如我这次是ce099c1ed25d9eb3076c11e4a280f3eb52b4fbeb。依照这个HASH值来找到 server 组件。注意1. 使用以下脚本或命令应把COMMIT_HASH的值替换为你所需要的值。2. 本次测试本地机为Windows远程机为LinuxOSX86第一步下载 VSCode Server在 Windows 本地运行以下任一脚本方法1直接执行如下批处理脚本# vscode-server-downloader.batecho off chcp65001nulechoechoVSCode Server 下载工具echoecho.setCOMMIT_HASHce099c1ed25d9eb3076c11e4a280f3eb52b4fbebsetDOWNLOAD_URLhttps://update.code.visualstudio.com/commit:%COMMIT_HASH%/server-linux-x64/stablesetOUTPUT_FILEvscode-server-linux-x64.tar.gzecho正在下载 VSCode Server...echoCommit Hash: %COMMIT_HASH%echo下载地址: %DOWNLOAD_URL%echo输出文件: %OUTPUT_FILE% echo. REM 检查是否已安装curl wherecurlnul2nulif%ERRORLEVEL% NEQ0(echo[错误]未找到curl命令 echo.echo请安装curl或使用以下 PowerShell 命令手动下载echoInvoke-WebRequest-Uri%DOWNLOAD_URL%-OutFile%OUTPUT_FILE%echo. pauseexit/b1)REM 使用curl下载curl-L-o%OUTPUT_FILE%%DOWNLOAD_URL%if%ERRORLEVEL% NEQ0(echo.echo[错误]下载失败echo请检查网络连接或稍后重试 pauseexit/b1)echo.echoecho下载成功echoecho.echo文件已保存到: %CD%\%OUTPUT_FILE% echo.echo接下来的步骤echo1. 将 %OUTPUT_FILE% 文件传输到远程Linux机器echo2. 在远程机器上执行以下命令解压echomkdir-p~/.vscode-server/bin/%COMMIT_HASH%echotar-xzfvscode-server-linux-x64.tar.gz-C~/.vscode-server/bin/%COMMIT_HASH% --strip-components1echo. pause方法2使用 PowerShell如果批处理脚本无法运行打开 PowerShell 并执行$commitHashce099c1ed25d9eb3076c11e4a280f3eb52b4fbeb$downloadUrlhttps://update.code.visualstudio.com/commit:$commitHash/server-linux-x64/stable$outputFilevscode-server-linux-x64.tar.gzInvoke-WebRequest-Uri$downloadUrl-OutFile$outputFile第二步传输文件到远程 Linux 机器使用以下任一方法将下载的vscode-server-linux-x64.tar.gz文件传输到远程机器方法 1使用 SCP 命令scpvscode-server-linux-x64.tar.gz usernameremote-host:/tmp/方法 2使用 SFTP 工具使用 WinSCP、FileZilla 或其他 SFTP 工具上传文件方法 3使用 PowerShellscp vscode-server-linux-x64.tar.gz usernameremote-host:/tmp/第三步在远程 Linux 机器上安装SSH 登录到远程机器然后执行以下命令# 设置变量COMMIT_HASHce099c1ed25d9eb3076c11e4a280f3eb52b4fbeb# 创建目标目录mkdir-p~/.vscode-server/bin/$COMMIT_HASH# 解压文件tar-xzf/tmp/vscode-server-linux-x64.tar.gz-C~/.vscode-server/bin/$COMMIT_HASH--strip-components1# 验证安装ls-la~/.vscode-server/bin/$COMMIT_HASH/第四步重启 VSCode 并重新连接关闭 VSCode重新打开 VSCode尝试连接到远程 SSH 主机常见问题问题 1下载速度慢如果下载速度很慢可以尝试使用代理服务器更换网络环境使用国内镜像如果有问题 2解压失败确保远程机器上安装了tar命令sudoapt-getinstalltar# Debian/Ubuntusudoyuminstalltar# CentOS/RHEL问题 3权限问题如果遇到权限问题可以尝试sudomkdir-p~/.vscode-server/bin/$COMMIT_HASHsudotar-xzf/tmp/vscode-server-linux-x64.tar.gz-C~/.vscode-server/bin/$COMMIT_HASH--strip-components1sudochown-R$USER:$USER~/.vscode-server验证安装成功安装成功后VSCode Server 的目录结构应该是~/.vscode-server/ └── bin/ └── ce099c1ed25d9eb3076c11e4a280f3eb52b4fbeb/ ├── bin/ ├── node/ ├── extensions/ └── ...清理安装完成后可以删除临时文件rm/tmp/vscode-server-linux-x64.tar.gz
VSCode Server 手动安装指南
文章目录背景为什么需要手动下载手动安装第一步下载 VSCode Server方法1直接执行如下批处理脚本方法2使用 PowerShell第二步传输文件到远程 Linux 机器方法 1使用 SCP 命令方法 2使用 SFTP 工具方法 3使用 PowerShell第三步在远程 Linux 机器上安装第四步重启 VSCode 并重新连接常见问题问题 1下载速度慢问题 2解压失败问题 3权限问题验证安装成功清理背景为什么需要手动下载VSCode远程SSH连接需要在远程Linux机器上安装一个VSCode Server组件。通常情况下VSCode会自动下载并安装这个组件但有时会失败原因包括网络问题- 远程机器无法访问VSCode更新服务器防火墙限制- 企业网络或防火墙阻止了下载下载超时- 网络速度慢导致下载超时代理配置错误- 代理设置不当导致连接失败远程机器无外网访问- 内网环境无法直接下载当自动下载失败时就需要手动在本地下载然后传输到远程机器进行安装。手动安装在自动下载时长时间无法成功、或反复失败这时候看日志能看到Commit HASH比如我这次是ce099c1ed25d9eb3076c11e4a280f3eb52b4fbeb。依照这个HASH值来找到 server 组件。注意1. 使用以下脚本或命令应把COMMIT_HASH的值替换为你所需要的值。2. 本次测试本地机为Windows远程机为LinuxOSX86第一步下载 VSCode Server在 Windows 本地运行以下任一脚本方法1直接执行如下批处理脚本# vscode-server-downloader.batecho off chcp65001nulechoechoVSCode Server 下载工具echoecho.setCOMMIT_HASHce099c1ed25d9eb3076c11e4a280f3eb52b4fbebsetDOWNLOAD_URLhttps://update.code.visualstudio.com/commit:%COMMIT_HASH%/server-linux-x64/stablesetOUTPUT_FILEvscode-server-linux-x64.tar.gzecho正在下载 VSCode Server...echoCommit Hash: %COMMIT_HASH%echo下载地址: %DOWNLOAD_URL%echo输出文件: %OUTPUT_FILE% echo. REM 检查是否已安装curl wherecurlnul2nulif%ERRORLEVEL% NEQ0(echo[错误]未找到curl命令 echo.echo请安装curl或使用以下 PowerShell 命令手动下载echoInvoke-WebRequest-Uri%DOWNLOAD_URL%-OutFile%OUTPUT_FILE%echo. pauseexit/b1)REM 使用curl下载curl-L-o%OUTPUT_FILE%%DOWNLOAD_URL%if%ERRORLEVEL% NEQ0(echo.echo[错误]下载失败echo请检查网络连接或稍后重试 pauseexit/b1)echo.echoecho下载成功echoecho.echo文件已保存到: %CD%\%OUTPUT_FILE% echo.echo接下来的步骤echo1. 将 %OUTPUT_FILE% 文件传输到远程Linux机器echo2. 在远程机器上执行以下命令解压echomkdir-p~/.vscode-server/bin/%COMMIT_HASH%echotar-xzfvscode-server-linux-x64.tar.gz-C~/.vscode-server/bin/%COMMIT_HASH% --strip-components1echo. pause方法2使用 PowerShell如果批处理脚本无法运行打开 PowerShell 并执行$commitHashce099c1ed25d9eb3076c11e4a280f3eb52b4fbeb$downloadUrlhttps://update.code.visualstudio.com/commit:$commitHash/server-linux-x64/stable$outputFilevscode-server-linux-x64.tar.gzInvoke-WebRequest-Uri$downloadUrl-OutFile$outputFile第二步传输文件到远程 Linux 机器使用以下任一方法将下载的vscode-server-linux-x64.tar.gz文件传输到远程机器方法 1使用 SCP 命令scpvscode-server-linux-x64.tar.gz usernameremote-host:/tmp/方法 2使用 SFTP 工具使用 WinSCP、FileZilla 或其他 SFTP 工具上传文件方法 3使用 PowerShellscp vscode-server-linux-x64.tar.gz usernameremote-host:/tmp/第三步在远程 Linux 机器上安装SSH 登录到远程机器然后执行以下命令# 设置变量COMMIT_HASHce099c1ed25d9eb3076c11e4a280f3eb52b4fbeb# 创建目标目录mkdir-p~/.vscode-server/bin/$COMMIT_HASH# 解压文件tar-xzf/tmp/vscode-server-linux-x64.tar.gz-C~/.vscode-server/bin/$COMMIT_HASH--strip-components1# 验证安装ls-la~/.vscode-server/bin/$COMMIT_HASH/第四步重启 VSCode 并重新连接关闭 VSCode重新打开 VSCode尝试连接到远程 SSH 主机常见问题问题 1下载速度慢如果下载速度很慢可以尝试使用代理服务器更换网络环境使用国内镜像如果有问题 2解压失败确保远程机器上安装了tar命令sudoapt-getinstalltar# Debian/Ubuntusudoyuminstalltar# CentOS/RHEL问题 3权限问题如果遇到权限问题可以尝试sudomkdir-p~/.vscode-server/bin/$COMMIT_HASHsudotar-xzf/tmp/vscode-server-linux-x64.tar.gz-C~/.vscode-server/bin/$COMMIT_HASH--strip-components1sudochown-R$USER:$USER~/.vscode-server验证安装成功安装成功后VSCode Server 的目录结构应该是~/.vscode-server/ └── bin/ └── ce099c1ed25d9eb3076c11e4a280f3eb52b4fbeb/ ├── bin/ ├── node/ ├── extensions/ └── ...清理安装完成后可以删除临时文件rm/tmp/vscode-server-linux-x64.tar.gz
