本文介绍了在内网 Windows 主机上离线安装 Ubuntu 22.04 WSL2 的方法。主要步骤包括准备系统镜像和内核更新包，解压导入系统包，创建普通用户并配置 sudo 权限，以及离线安装系统依赖和 Python 环境。重点解决了路径含中文、内核版本不匹配及权限不足等问题，最终实现适配 Dify 部署的基础环境搭建。
输入 OptionalFeatures，然后按回车键。这将打开'启用或关闭 Windows 功能'窗口。在这里，勾选「Hyper-V」「适用于 Linux 的 Windows 子系统」「虚拟机平台」以启用虚拟机功能。
需提前下载 2 个核心文件（拷贝到内网主机）：
| 文件名称 |
|---|
| 用途 |
|---|
| 下载地址/方式 |
|---|
| Ubuntu 22.04 WSL 离线包 | 系统核心包 | 微软官方：https://aka.ms/wslubuntu2204（.appx 格式，≈400MB） |
| WSL2 内核更新包（Win10） | 适配 Win10 WSL2 内核 | 微软官方：https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi |
Ubuntu2204.appx 重命名为 Ubuntu2204.zip（修改后缀）；D:\WSL 离线包\Ubuntu2204 目录（避免中文/空格路径）；D:\WSL 离线包\Ubuntu2204\tools\distro 目录下有 install.tar.gz 文件（核心系统包）；Ubuntu2204 文件夹 + wsl_update_x64.msi 拷贝到内网主机（U 盘/内网传输），存放路径建议：D:\WSL 离线包\。wsl_update_x64.msi（管理员权限），按提示完成安装（无需联网）；Ubuntu-22.04：分发版名称（后续启动用）；D:\WSL\Ubuntu2204：WSL 系统数据存储路径；--version 2：强制使用 WSL2（必须加）；执行导入命令（替换为你的实际路径）：
wsl --import Ubuntu-22.04 D:\WSL\Ubuntu2204 D:\WSL 离线包\Ubuntu2204\tools\distro\install.tar.gz --version 2
创建 WSL 数据存储目录（非 C 盘，避免占用系统空间）：
mkdir -p D:\WSL\Ubuntu2204 # 自定义路径，无中文/空格即可
root 用户（提示符：root@localhost:~#）；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
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
内网 Ubuntu 无网，需从联网主机拷贝「系统依赖包」和「Python 依赖包」：
# 联网主机的 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
sudo apt download -d python3.11 python3.11-dev；sudo dpkg -i python3.11*.deb 安装。wsl --import 会报错「拒绝访问」。| 异常现象 | 解决方案 |
|---|---|
| 导入时提示「文件不存在」 | 检查 install.tar.gz 路径是否正确，确保后缀是 .tar.gz 而非 .tar |
| 启动 Ubuntu 提示「分发版未注册」 | 重新执行 wsl --import 命令，确认分发版名称无拼写错误 |
| 离线安装依赖包提示「依赖缺失」 | 联网主机下载时加 -o APT::Get::Missing-Since=0，下载完整依赖链 |
install.tar.gz 系统包」，而非在线下载；wsl -l -v 显示 Ubuntu-22.04 的 VERSION=2，普通用户有 sudo 权限。安装完成后，可将联网主机准备的「Dify 源码」「Python 离线依赖包」拷贝到内网 Ubuntu 的 ~/dify-offline/ 目录，继续配置 Poetry、安装 Dify 依赖，完成离线部署。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online