|
1 | 1 | # ArchWSL
|
2 |
| -WSL 的 ArchLinux 封装,适用于 Windows 10 1709 或更高版本, |
3 |
| -基于 [wsldl](https://github.com/yuk7/wsldl)。 |
4 | 2 |
|
| 3 | +适用于 Windows 10 秋季创意者更新及更新版本的,基于 [wsldl](https://github.com/yuk7/wsldl) 的,运行在 WSL 上的 Arch Linux。 |
| 4 | + |
| 5 | +<div align="center"> |
5 | 6 |
|
6 | 7 | 
|
7 | 8 |
|
| 9 | +[](https://ci.appveyor.com/project/yuk7/archwsl) |
| 10 | +[](https://github.com/yuk7/ArchWSL-FS/actions) |
| 11 | +[](https://github.com/yuk7/ArchWSL/releases/latest) |
| 12 | +[](https://makeapullrequest.com) |
| 13 | +[](https://github.com/yuk7/ArchWSL/blob/master/LICENSE) |
| 14 | + |
| 15 | +[English](https://github.com/yuk7/ArchWSL/blob/master/README.md) | [日本語]([README_ja.md](https://github.com/yuk7/ArchWSL/blob/master/i18n/README_ja.md)) | [简体中文](https://github.com/yuk7/ArchWSL/blob/master/i18n/README_zh-cn.md) | [繁體中文](https://github.com/yuk7/ArchWSL/blob/master/README_zh-tw.md) | [Español](https://github.com/yuk7/ArchWSL/blob/master/README_es.md) | [Português](https://github.com/yuk7/ArchWSL/blob/master/README_pt-br.md) | [한국어](https://github.com/yuk7/ArchWSL/blob/master/README_ko-kr.md) |
| 16 | + |
| 17 | +[⬇ GitHub 下载](https://github.com/yuk7/ArchWSL/releases/latest) | [⬇ Gitee 镜像下载](https://gitee.com/yuk7/archwsl-mirror) | [📓 文档](https://wsldl-pg.github.io/ArchW-docs/) |
| 18 | + |
| 19 | +</div> |
8 | 20 |
|
| 21 | +## 💻 需求 |
| 22 | +- Windows 10 1709 秋季创意者更新及之后的 x64 版本,或 Windows 11 的任意版本; |
| 23 | +- `适用于 Linux 的 Windows 子系统` 功能已打开。 |
9 | 24 |
|
10 |
| -[English](https://github.com/yuk7/ArchWSL/blob/master/README.md) | [Deutsch](i18n/README_de.md) |
| 25 | +## 💾 安装 |
| 26 | +**如果需要更多信息,请参考 [文档](https://wsldl-pg.github.io/ArchW-docs/How-to-Setup)**。 |
11 | 27 |
|
12 |
| -### [⬇GH下载](https://github.com/yuk7/ArchWSL/releases/latest) | [⬇镜像下载](https://gitee.com/yuk7/archwsl-mirror) | [📓文档](https://wsldl-pg.github.io/ArchW-docs/) |
| 28 | +**如果你使用 WSL1,在实例的初次运行时,你必须更换其 glibc 包。详情请参考 [文档](https://wsldl-pg.github.io/ArchW-docs/How-to-Setup)**。 |
13 | 29 |
|
14 |
| -## 💻系统需求 |
15 |
| -* Windows 10 1709 秋季创意者更新或者更高版本 / 任何版本的 Windows 11 |
16 |
| -* 开启 `适用于 Linux 的 Windows 子系统` 功能 |
17 |
| -* WSL2 的 Linux 内核包 |
| 30 | +### 📁 zip |
18 | 31 |
|
19 |
| -## 💾安装 |
20 |
| -**[更多详情,请查看文档](https://wsldl-pg.github.io/ArchW-docs/locale/zh-CN/How-to-Setup/)** |
| 32 | +1. [此处](https://github.com/yuk7/ArchWSL/releases/latest) 下载 `zip` 形式的安装包。 |
21 | 33 |
|
22 |
| -**※若你使用 WSL1 ,你将必须修改一下 glibc 包。更多详情,请查看[文档对应章节](https://wsldl-pg.github.io/ArchW-docs/How-to-Setup)** |
| 34 | +2. 将 `zip` 安装包中的所有文件解压到同一个目录里。 |
23 | 35 |
|
24 |
| -### 📁Zip |
25 |
| -#### 1. 下载 [[GH](https://github.com/yuk7/ArchWSL/releases/latest)/[镜像](https://gitee.com/yuk7/archwsl-mirror)] zip 安装包。 |
| 36 | + ⚠️ 请确保 `zip` 安装包解压在一个程序拥有写权限的目录里。例如,`Program Files` 就是一个不恰当的目录。 |
26 | 37 |
|
27 |
| -#### 2. 解压缩 zip 文件中的全部内容到相同的目录。 |
28 |
| -请解压到一个你拥有写权限的目录。 |
| 38 | +3. 运行**解压后的** `Arch.exe` 来解包 `rootfs`,并将实例注册到 WSL。 |
29 | 39 |
|
30 |
| -例如, `C:\Program Files` 就不该被使用。 |
| 40 | + 同时,`exe` 文件的文件名将会作为新的 WSL 实例的名称。 |
31 | 41 |
|
32 |
| -#### 3. 运行 `Arch.exe` 来安装 rootfs 和注册表配置。 |
| 42 | + 这说明,如果你复制多个具有不同的文件名的 `exe` 文件,则安装后,你将拥有互不冲突的,不同的 `ArchWSL` 实例。 |
33 | 43 |
|
34 |
| -另外,EXE 文件的名称会同时用作你的 WSL 实例名称。 |
| 44 | +4. (可选)注册 Pacman Keyring。 |
35 | 45 |
|
36 |
| -也就是说,如果复制多个 EXE 文件,并重命名成不同的名称,你就同时拥有了多个不同的 ArchWSL 并且互不冲突。 |
| 46 | + 这并不是必须的操作。如果你想要使用 Pacman,请参见 [文档](https://wsldl-pg.github.io/ArchW-docs/How-to-Setup/#initialize-keyring)。 |
37 | 47 |
|
38 |
| -#### 4. 初始化 pacman keyring (可选) |
39 |
| -这并不是必须的,但若是你想要使用 pacman,则你需要进行此操作。 |
40 |
| -请查看对应[文档页面](https://wsldl-pg.github.io/ArchW-docs/How-to-Setup/#initialize-keyring)。 |
| 48 | +### 📦 appx |
41 | 49 |
|
42 |
| -### 📦appx |
43 |
| -#### 1. 从 [[GH](https://github.com/yuk7/ArchWSL/releases/latest)/[镜像](https://gitee.com/yuk7/archwsl-mirror)] 下载发布的 .appx 和 .cer 文件。 |
| 50 | +1. [此处](https://github.com/yuk7/ArchWSL/releases/latest) 下载 `zip` 形式的安装包和 `cer` 文件。 |
44 | 51 |
|
45 |
| -#### 2. 安装 .cer 文件到 “本地计算机” 的 “受信任人”。 |
46 |
| -更多详情,请查看对应[文档页面](https://wsldl-pg.github.io/ArchW-docs/locale/zh-CN/Install-Certificate/)。 |
| 52 | +2. 安装 `cer` 文件到 **本地计算机** 的 **受信任人**。 |
47 | 53 |
|
48 |
| -你必须有管理员权限才能安装证书! |
49 |
| -#### 3. 安装 .appx 。 |
| 54 | + 更多详情,请参见 [文档](https://wsldl-pg.github.io/ArchW-docs/Install-Certificate)。你需要管理员权限来安装证书。 |
| 55 | + |
| 56 | +3. 双击以安装 `.appx` 文件。 |
50 | 57 |
|
51 | 58 | ### 🥄 Scoop
|
52 |
| -`scoop bucket add extras ` |
53 | 59 |
|
54 |
| -`scoop install archwsl ` |
| 60 | +1. 输入 `scoop bucket add extras` 为 `scoop` 添加 `bucket` |
| 61 | + |
| 62 | +2. 输入 `scoop install archwsl` 以安装 `archwsl` |
| 63 | + |
| 64 | +## 📝 如何使用(适用于已安装的实例) |
55 | 65 |
|
56 |
| -## 📝如何使用(对于已安装的实例) |
57 |
| -#### exe 用法 |
58 |
| -```shell |
59 |
| -用法 : |
| 66 | +### 对于 `exe` 文件 |
| 67 | + |
| 68 | +```dos |
| 69 | +用例: |
60 | 70 | <无参数>
|
61 |
| - - 以你的默认设置打开一个新的Shell。 |
| 71 | + - 使用默认参数打开一个新的 Shell。 |
62 | 72 |
|
63 |
| - run <命令行> |
64 |
| - - 在此实例中运行你所给出的命令,继承当前Shell的所在目录。 |
| 73 | + run <command line> |
| 74 | + - 继承当前目录并运行给定的命令行指令。 |
65 | 75 |
|
66 |
| - runp <命令行 (包含 windows 路径)> |
67 |
| - - 在此实例里运行转译过的命令行。 |
| 76 | + runp <command line (includes windows path)> |
| 77 | + - 在切换目录后运行给定的命令行指令。 |
68 | 78 |
|
69 |
| - config [setting [值]] |
70 |
| - - `--default-user <用户>`: 设定此实例的默认用户到 <用户>。 |
71 |
| - - `--default-uid <uid>`: 设定此实例的默认用户 UID 到 <uid>。 |
72 |
| - - `--append-path <on|off>`: 加入 Windows PATH 到 $PATH 的开关。 |
73 |
| - - `--mount-drive <on|off>`: 挂载驱动器的开关。 |
74 |
| - - `--wsl-version <1|2>`: Set the WSL version of this instance to <1 or 2> |
75 |
| - - `--default-term <default|wt|flute>`: 设置默认的终端窗口样式。 |
| 79 | + config [setting [value]] |
| 80 | + - `--default-user <user>`: 将 <user> 设置为该实例的默认用户。 |
| 81 | + - `--default-uid <uid>`: 将 <uid> 设置为该实例默认用户的 uid。 |
| 82 | + - `--append-path <true|false>`: 是否将 Windows Path 加入 $PATH。 |
| 83 | + - `--mount-drive <true|false>`: 是否挂载驱动器。 |
| 84 | + - `--wsl-version <1/2>`: 切换该实例的 WSL 版本到 1 或 2。 |
| 85 | + - `--default-term <default|wt|flute>`: 设置终端窗口的默认样式。 |
76 | 86 |
|
77 | 87 | get [setting]
|
78 |
| - - `--default-uid`: 输出此实例的默认用户UID。 |
79 |
| - - `--append-path`: 输出”加入 Windows PATH 到 $PATH“的开关状态。 |
80 |
| - - `--mount-drive`: 输出”挂载驱动器”的开关状态。 |
81 |
| - - `--wsl-version`: 输出此实例的WSL版本(1/2)。 |
82 |
| - - `--default-term`: 输出此实例启动器的默认终端样式。 |
83 |
| - - `--lxguid`: 输出此实例的 WSL GUID key。 |
| 88 | + - `--default-uid`: 获取该实例中默认用户的 uid。 |
| 89 | + - `--append-path`: 获取是否已经将 Windows Path 加入了 $PATH。 |
| 90 | + - `--mount-drive`: 获取是否已经挂载了驱动器。 |
| 91 | + - `--wsl-version`: 获取当前实例的 WSL 版本(1 或 2)。 |
| 92 | + - `--default-term`: 获取当前终端窗口的默认样式。 |
| 93 | + - `--lxguid`: 获取当前实例的 WSL GUID key。 |
84 | 94 |
|
85 | 95 | backup [contents]
|
86 |
| - - `--tar`: 在当前目录输出 backup.tar 文件。 |
87 |
| - - `--tgz`: 在当前目录输出 backup.tar.gz 文件。 |
88 |
| - - `--vhdx`: 在当前目录输出 backup.ext4.vhdx 文件。(仅 WSL2) |
89 |
| - - `--vhdxgz`: 在当前目录输出 backup.ext4.vhdx.gz 文件。(仅 WSL2) |
90 |
| - - `--reg`: 在当前目录输出注册表配置文件。 |
| 96 | + - `--tar`: 在当前文件夹下输出 backup.tar。 |
| 97 | + - `--tgz`: 在当前文件夹下输出 backup.tar.gz。 |
| 98 | + - `--vhdx`: (仅 WSL2)在当前文件夹下输出 backup.ext4.vhdx。 |
| 99 | + - `--vhdxgz`: (仅 WSL2)在当前文件夹下输出 backup.ext4.vhdx.gz。 |
| 100 | + - `--reg`: 在当前文件夹下输出注册表配置文件。 |
91 | 101 |
|
92 | 102 | clean
|
93 |
| - - 卸载此实例。 |
| 103 | + - 卸载该实例。 |
94 | 104 |
|
95 | 105 | help
|
96 |
| - - 显示此帮助信息。 |
| 106 | + - 打印该用例信息。 |
97 | 107 | ```
|
98 | 108 |
|
99 |
| -## ⬆️更新 |
100 |
| -### 📁zip |
101 |
| -#### 1. [下载](https://github.com/yuk7/ArchWSL/releases/latest) 发布的 zip 文件。 |
102 |
| -#### 2. 从 zip 包中解压 .exe 和 rootfs.tar.gz,然后覆盖你已有的文件。 |
| 109 | +## ⬆️ 更新 |
| 110 | + |
| 111 | +### 📁 zip |
| 112 | + |
| 113 | +1. [此处](https://github.com/yuk7/ArchWSL/releases/latest) 下载 `zip` 形式的安装包。 |
| 114 | + |
| 115 | +2. 从安装包中解压 `exe` 文件和 `rootfs.tar.gz`,并覆盖已有文件。 |
| 116 | + |
| 117 | +### 📦 appx |
| 118 | + |
| 119 | +1. [此处](https://github.com/yuk7/ArchWSL/releases/latest) 下载 `appx` 形式的安装包。 |
| 120 | + |
| 121 | +2. 双击以安装更新。 |
103 | 122 |
|
104 |
| -### 📦appx |
105 |
| -#### 1. [下载](https://github.com/yuk7/ArchWSL/releases/latest) 发布的 .appx 文件。 |
106 |
| -#### 2. 覆盖已有的 .appx 文件。 |
| 123 | +## 🚫 已知问题 |
107 | 124 |
|
108 |
| -## 🚫已知问题 |
109 |
| -请查看 [文档](https://wsldl-pg.github.io/ArchW-docs/locale/zh-CN/)。 |
| 125 | +详见 [文档](https://wsldl-pg.github.io/ArchW-docs/)。 |
0 commit comments