win10离线环境下配置wsl2和vscode远程开发环境

环境
文件准备
- wsl文件准备
- vscode文件准备
内网环境部署
- wsl环境部署
- vscode环境部署
迁移后Ubuntu中的程序无法启动

环境

内网机：win10、wsl1

文件准备

wsl文件准备

在外网机上的wsl安装Ubuntu24.04，直接在Microsoft store搜索ubuntu下载即可

shell 复制代码

# 查看下载情况，我已有Ubuntu-24.04，所以下载的是Ubuntu
wsl -l -v
#   NAME            STATE           VERSION
# * Ubuntu-24.04    Running         2
#   Ubuntu          Stopped         2

# 启动Ubuntu
wsl -d Ubuntu

# 使用apt安装需要的软件，依据需求添加
apt install redis postgresql mysql apt-offline nginx docker

# 使用外网电脑的vscode连接此ubuntu
# vscode打开此ubuntu内的文件，vscode会自动安装相应的软件vscode-server-linux-x64.tar.gz
# 在vscode中安装ubuntu中需要使用的扩展插件

# 迁移Ubuntu，打包为Ubuntu.tar
wsl --export Ubuntu Ubuntu.tar

由于我的电脑中的wsl是1需要升级为wsl2，所以还需要下载wsl的升级包wsl_update_x64.msi

下载地址https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi

vscode文件准备

获取内网机vscode的commit_id

点击 帮助-->关于，其中的提交或者commit_id即是

使用https://vscode.download.prss.microsoft.com/dbazure/download/stable/${commit_id}/vscode-server-linux-x64.tar.gz下载vscode-server-linux-x64.tar.gz文件

替换 ${commit_id} 为实际值，例如：

https://vscode.download.prss.microsoft.com/dbazure/download/stable/4437686ffebaf200fa4a6e6e67f735f3edf24ada/vscode-server-linux-x64.tar.gz

内网环境部署

wsl环境部署

shell 复制代码

# wsl载入ubuntu，需要等待几分钟
wsl --import Ubuntu-24.04 D:\WSL\Ubuntu2404 E:\Ubuntu.tar

# 检查是否安装成功
wsl -l -v
#   NAME            STATE           VERSION
# * Ubuntu-24.04    Stopped         1

# 修改默认子系统虚拟机
# wslconfig /setdefault <选定的虚拟机名称>
wslconfig /setdefault Ubuntu-24.04

# 修改默认登录用户
# 迁移后登录会发现使用的是root登录，而非安装时设置的用户
# 这里我们需要设置wsl.conf文件，一般存储在/etc/wsl.conf，具体可看官方wiki WSL中的高级设置配置
vim /etc/wsl.conf
# 添加以下内容，保存配置并退出。
[user]
default = 你安装设置的普通用户名
# 重启wsl
wsl --shutdown

双击安装 wsl_update_x64.msi

设置默认使用wsl2

wsl --set-default-version 2

将Ubuntu-24.04切换为wsl2，需要等几分钟，成功会提示转换完成

wsl --set-version Ubuntu-24.04 2

shell 复制代码

# 检查是否安装成功
wsl -l -v
#   NAME            STATE           VERSION
# * Ubuntu-24.04    Stopped         2

vscode环境部署

将vscode-server-linux-x64.tar.gz改名为vscode-server-stable-linux-x64.tar.gz文件放入到C:\Users\friday\vscode-remote-wsl\stable\${commit_id}\

启动Ubuntu wsl -d Ubuntu-24.04

将vscode-server-linux-x64.tar.gz文件也放入到ubuntu中

shell 复制代码

# 创建文件
mkdir -p ~/.vscode-server/bin/${commit_id}  
rm -rf ~/.vscode-server/bin/${commit_id}/*  # 清空旧文件（如有）

# 解压至指定目录（‌注意跳过外层文件夹‌）
tar -xzvf vscode-server-linux-x64.tar.gz --strip-components 1 -C ~/.vscode-server/bin/${commit_id}

# 添加权限
chmod 777 -R ~/.vscode-server

启动win系统中的vscode，选择远程资源管理器Ubuntu-24.04即可，之前在外网中安装的vscode扩展插件也正常加载

迁移后Ubuntu中的程序无法启动

参考另外一篇文章:wsl中迁移ubuntu24.04后docker后无法启动的问题