离线安装 Ubuntu 22.04 WSL2

mkdir -p D:\WSL\Ubuntu2204 # 自定义路径，无中文/空格即可

3. 初始化 Ubuntu 22.04（创建普通用户）

• 此时直接进入 root 用户（提示符：root@localhost:~#）；

2. 设置默认登录用户（避免每次进 root）：
   • 退出 Ubuntu：exit；

保存后重启 WSL：

wsl --shutdown 

在打开的文件中添加以下内容（无文件则新建）：

[Ubuntu-22.04] default=username:dify_dev 

在 PowerShell 执行：

notepad "$env:USERPROFILE\.wslconfig"

创建普通用户（适配 Dify 部署，建议用户名 dify_dev）：

# 创建用户并生成主目录
useradd -m dify_dev 
# 设置密码（输入 2 次，无回显，记好密码）
passwd dify_dev 
# 赋予 sudo 权限（执行管理员命令）
usermod -aG sudo dify_dev 

启动导入的 Ubuntu：

wsl -d Ubuntu-22.04 

4. 验证离线安装结果

• 自动以 dify_dev 用户登录（提示符：dify_dev@localhost:~$）；

验证用户权限：

sudo apt update # 输入密码后无「权限拒绝」报错，说明 sudo 生效

正常输出：

NAME STATE VERSION * Ubuntu-22.04 Running 2 

验证 WSL 版本：

wsl -l -v 

重新启动 Ubuntu：

wsl -d Ubuntu-22.04 

四、步骤 3：离线配置 Ubuntu 基础环境（适配 Dify）

内网 Ubuntu 无网，需从联网主机拷贝「系统依赖包」和「Python 依赖包」：

1. 拷贝系统依赖包（联网主机预处理）

# 联网主机的 Ubuntu 中，下载 Dify 所需编译依赖到本地
sudo apt download -d -o dir::cache=~/system-debs/ \
 build-essential gcc g++ make \
 libcurl4-openssl-dev libssl-dev libpq-dev \
 meson ninja-build libcairo2-dev python3.11-dev 

• 将 ~/system-debs 目录拷贝到内网 Ubuntu 的 /mnt/d/WSL 离线包/；

内网 Ubuntu 中离线安装：

sudo cp /mnt/d/WSL 离线包/system-debs/* /var/cache/apt/archives/
sudo dpkg -i /var/cache/apt/archives/*.deb 

2. 拷贝 Python 3.11（可选，若内网 Ubuntu 无 Python 3.11）

• 联网主机下载 Python 3.11 离线包：sudo apt download -d python3.11 python3.11-dev；
• 内网 Ubuntu 中执行 sudo dpkg -i python3.11*.deb 安装。

五、关键避坑点

1. 路径问题：解压/导入路径不能有中文、空格（如「WSL 离线包」→ 改为「WSL 离线包」）；
2. 内核问题：Win10 若未装 WSL2 内核更新包，导入时会提示「版本不支持」，必须先装；
3. 用户问题：禁止长期用 root 运行 Dify，必须创建普通用户并赋予 sudo 权限；
4. 权限问题：PowerShell 必须以管理员身份运行，否则 wsl --import 会报错「拒绝访问」。

六、常见异常处理

总结

核心要点：

1. 离线安装核心是「导入 install.tar.gz 系统包」，而非在线下载；
2. 关键步骤：解压离线包 → 导入 WSL2 → 创建普通用户 → 离线安装依赖；
3. 验证标准：wsl -l -v 显示 Ubuntu-22.04 的 VERSION=2，普通用户有 sudo 权限。

后续衔接：

安装完成后，可将联网主机准备的「Dify 源码」「Python 离线依赖包」拷贝到内网 Ubuntu 的 ~/dify-offline/ 目录，继续配置 Poetry、安装 Dify 依赖，完成离线部署。