企业官网建设流程全解析

• 开发者工具
• 操作系统

ArchWSL 是一个基于 wsldl 的官方文档为骨架，结合仓库内的构建脚本与配置（Makefile、buildAppX.ps1、appveyor.yml、preset.json），系统讲解环境要求、三种安装方式、EXE 命令行全量参数、多实例玩法、更新与备份方法，帮助你在 Windows 上快速落地一套可长期使用的 Arch Linux 开发环境。

环境要求：Windows 版本与 WSL 功能

ArchWSL 官方文档对运行环境给出明确要求：

• Windows 10 1709（秋季创意者更新，Fall Creators Update，FCU）x64 或更高版本，或 Windows 11 x64；
• 必须已启用“适用于 Linux 的 Windows 子系统”（Windows Subsystem for Linux，WSL）功能。

需要特别留意的是：若使用 WSL1，必须在实例首次运行时更换 glibc 包，否则 Arch 官方软件包仓库中面向现代内核构建的二进制可能无法正常工作。官方文档对此有专门提醒，首次启动前建议先完成 glibc 的替换再执行系统更新。

从仓库结构看，appveyor.yml 在 Visual Studio 2017 环境下构建 x64 的 appx 安装包，产物包括ArchWSL-AppX_<版本>_x64.appx、配套.cer证书以及 zip 形式的Arch.zip，说明当前发行版定位为 x64 平台，arm64 用户需要自行确认官方是否提供对应产物。

安装方式一：zip 便携安装（推荐）

zip 方式是官方文档最先介绍的安装路径，也是最灵活的一种，因为它允许通过重命名 EXE 实现多实例。

第 1 步：下载并解压

从项目的 Releases 页面下载 zip 格式安装包。解压时请务必注意：

• 将 zip 内所有文件解压到同一个目录；
• 目录必须位于你拥有完整读写权限的位置，例如不能放在Program Files（WSL 实例的 rootfs 与注册操作需要写入权限，受保护目录会导致失败）。

第 2 步：运行 Arch.exe 注册实例

在解压目录中直接运行Arch.exe。它会执行两件事：

1. 解包内置的rootfs.tar.gz到 WSL 的 rootfs 目录；
2. 将该发行版注册到 WSL。

关键机制：EXE 文件名即实例名。官方文档明确指出，EXE 的文件名会被用作 WSL 实例的名称。这意味着：

• 将Arch.exe复制多份，分别改名为Arch2.exe、ArchDev.exe等；
• 运行任意一份，就会在 WSL 中注册一个对应名称的独立实例；
• 多个实例之间互不冲突，可以同时并存、独立配置。

这正是 ArchWSL “Supports multiple install”（支持多实例安装）的设计初衷，也是它与普通单实例发行版的最大区别。

第 3 步（可选）：初始化 pacman 密钥环

系统提示：keyring初始化并非安装必需步骤，但若要使用 pacman 安装软件，就必须执行。推荐在首次启动进入 shell 后运行：

pacman-key --init pacman-key --populate archlinux

之后即可正常使用pacman -Syu进行系统更新与软件安装。官方文档将该步骤指向 How-to-Setup 文档的 “Initialize keyring” 小节，本文在此给出可直接执行的最小命令集。

安装方式二：appx 商店式安装

appx 方式面向偏好 MSIX 打包安装的用户，安装过程类似从 Microsoft Store 安装应用。

1. 下载 appx 安装文件与配套的cer 证书文件；
2. 将 cer 证书安装到本地计算机的“受信任人”（Trusted People）存储区。这一步必须拥有管理员权限；
3. 双击 appx 文件完成安装。

证书的作用是建立对 appx 包签名的信任，未正确安装证书会导致安装被系统拒绝。仓库中的 buildAppX.ps1 展示了 appx 的构建方式：下载 wsldl 的icons.zip（内含启动器 EXE），再下载 ArchWSL-FS 的rootfs.tar.gz一起打包，并改写package.appxmanifest中的版本号，产物即为可安装的.appx与签名证书.cer。

安装方式三：Scoop 包管理器安装

对于使用 Scoop 的 Windows 用户，两条命令即可完成安装：

scoop bucket add extras scoop install archwsl

extrasbucket 中包含archwsl应用清单，安装后同样以Arch.exe作为启动入口，后续使用与 zip 方式安装的实例完全一致。

使用指南：Arch.exe 命令行全量参数

这是官方文档中最核心的实操章节。对于已安装的实例，Arch.exe支持如下完整命令（DOS/CMD 语法）：

Usage : <sans arguments> - 使用默认设置打开一个新的 shell。 run <ligne de commande> - 在该实例中运行给定命令行，继承当前目录。 runp <ligne de commande (inclut le chemin windows)> - 运行给定命令行，并先对其中的 Windows 路径进行转换。 config [setting [value]] - --default-user <user>: 设置该实例的默认用户为 <user>。 - --default-uid <uid>: 设置该实例默认用户的 uid 为 <uid>。 - --append-path <true|false>: 开关：是否将 Windows PATH 追加到 $PATH。 - --mount-drive <true|false>: 开关：是否挂载 Windows 驱动器。 - --wsl-version <1|2>: 设置该实例的 WSL 版本为 1 或 2。 - --default-term <default|wt|flute>: 设置默认终端窗口类型。 get [setting] - --default-uid: 读取该实例默认用户的 uid。 - --append-path: 读取是否已把 Windows PATH 追加到 $PATH（true/false）。 - --mount-drive: 读取是否已挂载驱动器（true/false）。 - --wsl-version: 读取该实例的 WSL 版本（1 或 2）。 - --default-term: 读取默认终端类型。 - --lxguid: 读取该实例的 WSL GUID 键值。 backup [contents] - --tar: 在当前目录导出 backup.tar。 - --tgz: 在当前目录导出 backup.tar.gz。 - --vhdx: 在当前目录导出 backup.ext4.vhdx（仅 WSL2）。 - --vhdxgz: 在当前目录导出 backup.ext4.vhdx.gz（仅 WSL2）。 - --reg: 在当前目录导出设置注册表文件。 clean - 卸载该实例。 help - 打印本使用说明。

常用配置实战示例

以下是在 Windows 命令行（CMD）中可直接执行的典型操作：

:: 设置实例默认登录用户（最常用，避免每次以 root 进入） Arch.exe config --default-user myuser :: 查看当前默认用户 uid Arch.exe get --default-uid :: 关闭 Windows PATH 追加（隔离 Windows 工具链，防止命令冲突） Arch.exe config --append-path false :: 将实例切换为 WSL2 Arch.exe config --wsl-version 2 :: 将默认终端切换为 Windows Terminal Arch.exe config --default-term wt :: 导出整个系统为 tar 归档（备份/迁移） Arch.exe backup --tar :: 导出 WSL2 的 ext4 虚拟磁盘 Arch.exe backup --vhdx :: 彻底卸载当前实例 Arch.exe clean

几个参数的深层含义值得展开：

• --default-user/--default-uid：设置进入 shell 时的默认用户与 uid。通常先以 root 完成useradd、passwd与 sudo 配置，再通过该命令切换到普通用户，避免日常操作都以 root 身份进行；
• --append-path true|false：控制是否把 Windows 的 PATH 环境变量追加到 Linux 侧$PATH。默认追加可让你在 Bash 中直接调用 Windows 程序（如code、explorer.exe），而置为false则能获得更纯净的 Linux 环境、避免同名命令冲突；
• --mount-drive true|false：控制是否挂载 Windows 驱动器（如 C:）。WSL2 下驱动器的自动挂载由/etc/wsl.conf协同控制，此参数提供实例级开关；
• --wsl-version 1|2：在 WSL1 与 WSL2 之间切换。WSL2 基于轻量级虚拟机，具备完整内核、文件系统性能与兼容性更好，且支持 vhdx 备份；WSL1 则共享 Windows 内核，无需虚拟化支持；
• --default-term default|wt|flute：选择启动终端。default为系统默认（如 conhost），wt为 Windows Terminal，flute为 Fluent Terminal。

多实例并存技巧

由于 EXE 文件名即实例名，多开场景非常自然：

Arch.exe → 实例名 Arch（主环境） ArchDev.exe → 实例名 ArchDev（开发环境） ArchTest.exe → 实例名 ArchTest（测试环境）

每份 EXE 解包出的 rootfs 相互独立，各自拥有独立的用户、软件包与配置；备份、切换 WSL 版本、卸载等操作也都按实例隔离执行，不会互相影响。

更新 ArchWSL

zip 方式更新

1. 下载最新 zip 安装包；
2. 从中解压Arch.exe与rootfs.tar.gz两个文件；
3. 用它们覆盖你现有的同名文件；
4. 重新运行Arch.exe即可完成升级，原有实例数据（rootfs 中的用户与文件）保持不变。

appx 方式更新

1. 下载最新 appx 文件；
2. 双击安装，系统会以覆盖方式升级，无需先卸载旧版本。

已知问题与官方文档

官方文档指出，已知问题请统一参阅 ArchW-docs 官方文档站。常见话题包括 WSL1 下的 glibc 替换、rootfs 初始化流程、证书安装等。安装过程中如遇异常，建议优先对照官方 How-to-Setup 步骤逐条排查。

附：仓库构建链路与文件清单（深入理解发行版是如何产出的）

为了让读者理解 zip/appx 产物从何而来，这里结合仓库源码梳理构建链路：

• Makefile 是 zip 产物的构建入口：通过 GitHub API 获取 ArchWSL-FS 最新rootfs.tar.gz与 wsldl 的icons.zip，解压得到Launcher.exe后重命名为Arch.exe，与 rootfs 一起打包为Arch.zip；
• preset.json 记录在线版安装器的 rootfs 下载地址与 SHA256 校验值（installfile与installfilesha256），供在线安装器下载时校验完整性；
• buildAppX.ps1 负责 appx 构建：下载 wsldl 的icons.zip与 ArchWSL-FS 的rootfs.tar.gz，写入appx\wsldl-AppX\，并更新package.appxmanifest的版本号；
• appveyor.yml 是 Windows 侧 CI 配置：在 Visual Studio 2017 中同时构建本地版（appx）与在线版（appx-online）两个 appx，并把Arch.exe+rootfs.tar.gz压缩为Arch.zip、把Arch.exe+preset.json压缩为Arch_Online.zip，最终统一生成 SHA256 校验清单；
• appx 与 appx-online 是仓库的两个 git 子模块，分别对应 appx 分支与 appx-online 分支的 wsldl 打包工程。

从 README.md 及各语言版本（如 i18n/README_zh-cn.md）可以看出，本项目采用 MIT 许可（见 LICENSE），围绕 “基于 wsldl 的 Arch Linux WSL 发行版 + 多实例支持” 这一核心定位持续迭代。

总结

ArchWSL 用极简的交付形态解决了 Windows 上使用 Arch Linux 的核心诉求：zip 便携包 + 单 EXE 注册、EXE 改名即多开、全量 config/get/backup 命令行管理、zip/appx/Scoop 三种安装通道。按照本文流程，你可以在 5 分钟内完成首个实例的安装，并通过config --default-user、backup --tar、--wsl-version 2等命令构建一套可备份、可迁移、可多开的长期 Arch 开发环境。

• 开发者工具
• 操作系统