├── .github └── FUNDING.yml ├── .gitignore ├── 404.md ├── CONTRIBUTING.md ├── How-to-Setup.md ├── How-to-Use.md ├── Install-Certificate.md ├── Known-issues.md ├── LICENSE ├── README.md ├── __sass └── custom │ └── custom.scss ├── _config.yml ├── _includes ├── body_gtag.html ├── default.html ├── footer_custom.html ├── head.html ├── head_custom.html ├── head_gtag.html └── title.html ├── asset ├── wsldl-logo.png └── wsldl-logo.svg ├── img └── cert │ ├── 1.install.png │ ├── 2.to-localmachine.png │ ├── 3.to-following.png │ └── 4.to-trustedpeople.png └── locale ├── Translations.md ├── ja-JP ├── How-to-Setup.md ├── How-to-Use.md ├── Install-Certificate.md ├── Known-issues.md ├── README.md └── img │ └── cert │ ├── 1.install.png │ ├── 2.to-localmachine.png │ ├── 3.to-following.png │ └── 4.to-rootstore.png ├── ko-KR ├── How-to-Setup.md ├── How-to-Use.md ├── Install-Certificate.md ├── Known-issues.md ├── README.md └── img │ └── cert │ ├── 1.install.png │ ├── 2.to-localmachine.png │ ├── 3.to-following.png │ └── 4.to-rootstore.png ├── pt-BR ├── How-to-Setup.md ├── How-to-Use.md ├── Install-Certificate.md ├── Known-issues.md ├── README.md └── img │ └── cert │ ├── 1.install.png │ ├── 2.to-localmachine.png │ ├── 3.to-following.png │ └── 4.to-trustedpeople.png ├── zh-CN ├── How-to-Setup.md ├── How-to-Use.md ├── Install-Certificate.md ├── Known-issues.md ├── README.md └── img │ └── cert │ ├── 1.install.png │ ├── 2.to-localmachine.png │ ├── 3.to-following.png │ └── 4.to-trustedpeople.png └── zh-TW ├── How-to-Setup.md ├── How-to-Use.md ├── Install-Certificate.md ├── Known-issues.md ├── README.md └── img └── cert ├── 1.install.png ├── 2.to-localmachine.png ├── 3.to-following.png └── 4.to-trustedpeople.png /.github/FUNDING.yml: -------------------------------------------------------------------------------- 1 | # These are supported funding model platforms 2 | 3 | github: [yuk7] 4 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | _site/ 2 | .sass-cache/ 3 | .jekyll-cache/ 4 | .jekyll-metadata 5 | -------------------------------------------------------------------------------- /404.md: -------------------------------------------------------------------------------- 1 | --- 2 | layout: default 3 | title: Page Not Found 4 | permalink: /404.html 5 | nav_exclude: true 6 | --- 7 | 8 | # :( 9 | ## 404 Page Not Found 10 | The page you requested could not be found. -------------------------------------------------------------------------------- /CONTRIBUTING.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Contributing 3 | category: Contributing 4 | layout: default 5 | --- 6 | 7 | # Contributing 8 | 9 | We welcome contributions from everyone. 10 | 11 | You can make a pull request for a document or join a member of the document team. 12 | 13 | Please contact us for more information. -------------------------------------------------------------------------------- /How-to-Setup.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "How to Setup" 3 | has_children: true 4 | --- 5 | # How to Set Up ArchWSL 6 | 7 | ## Requirements 8 | 9 | * Windows 10 1709 Fall Creators Update 64bit or later. 10 | * Windows Subsystem for Linux feature is enabled. 11 | 12 | ## Installation Instructions 13 | 14 | There are three ways to install ArchWSL. 15 | 16 | ### Method 1: zip file 17 | 18 | 1. [Download](https://github.com/yuk7/ArchWSL/releases/latest) the installer zip. 19 | 2. Extract all files in zip file to the same directory. 20 | Please extract to a folder that you have write permission. 21 | For example, `C:\Program Files` cannot be used since the rootfs cannot be modified there. 22 | 3. Run `Arch.exe` to extract the rootfs and register to WSL 23 | 24 | As a side note, the executable name is what is used as the WSL instance name. 25 | If you rename it, you can have multiple installs. 26 | 27 | ### Method 2: appx package 28 | 29 | 1. [Download the `.appx` and `.cer`](https://github.com/yuk7/ArchWSL/releases/latest) 30 | 2. Install `.cer` to the "Trusted Root Certificate Store" of the local machine. 31 | For details, please refer to the [Install Certificate page](Install-Certificate.md). 32 | You will need administrator privileges to install the certificate. 33 | 3. Install the `.appx` 34 | 35 | ### Method 3: online installer 36 | 37 | 1. [Download `Arch_Online.zip`](https://github.com/yuk7/ArchWSL/releases/latest) 38 | 2. Extract all files in zip file to the same directory. 39 | 3. Run `Arch.exe` to download rootfs and register to WSL 40 | 41 | This zip file is doesn't include rootfs (~200 MB), hence its zip file is very small (~2 MB), 42 | but rootfs is donwloaded in the first run. 43 | 44 | ## Setup after install 45 | ### [If you are a WSL1 user, you **must** change the glibc package. Please see Known issues.](Known-issues.md#wsl1--wsl2) 46 | 47 | ### Setting the root password 48 | 49 | ```shell 50 | >Arch.exe 51 | [root@PC-NAME]# passwd 52 | ``` 53 | 54 | ### Set up the default user 55 | 56 | Please see ArchWiki 57 | [Sudo](https://wiki.archlinux.org/index.php/Sudo#Example_entries) 58 | and 59 | [User and groups](https://wiki.archlinux.org/index.php/Users_and_groups) pages. 60 | 61 | ```shell 62 | >Arch.exe 63 | [root@PC-NAME]# echo "%wheel ALL=(ALL) ALL" > /etc/sudoers.d/wheel 64 | (setup sudoers file.) 65 | 66 | [root@PC-NAME]# useradd -m -G wheel -s /bin/bash {username} 67 | (add user) 68 | 69 | [root@PC-NAME]# passwd {username} 70 | (set default user password) 71 | 72 | [root@PC-NAME]# exit 73 | 74 | >Arch.exe config --default-user {username} 75 | (setting to default user) 76 | ``` 77 | 78 | If the default user has not been changed 79 | ([issue #7](https://github.com/yuk7/ArchWSL/issues/7)), 80 | please reboot the computer or alternatively, restart the LxssManager in an Admin 81 | command prompt. 82 | 83 | To restart the `LxssManager`, run this: 84 | 85 | ```batch 86 | net stop lxssmanager && net start lxssmanager 87 | ``` 88 | 89 | ### Initialize keyring 90 | 91 | Please excute these commands to initialize the keyring. 92 | (This step is necessary to use pacman.) 93 | 94 | ```shell 95 | >Arch.exe 96 | [user@PC-NAME]$ sudo pacman-key --init 97 | 98 | [user@PC-NAME]$ sudo pacman-key --populate 99 | 100 | [user@PC-NAME]$ sudo pacman -Sy archlinux-keyring 101 | 102 | [user@PC-NAME]$ sudo pacman -Su 103 | ``` 104 | 105 | ### Install patched glibc (need in WSL1) 106 | Arch's glibc is built for Linux kernel 4.4 and above and does not work with WSL1. 107 | 108 | WSL1 users **should** always follow the steps in [Known issues](Known-issues.md#wsl1--wsl2). 109 | 110 | ### Install systemctl alternative (Optional) 111 | WSL does not have support for systemd however, there are several solutions. 112 | Please see [Known issues](Known-issues.md#systemdsystemctl). 113 | -------------------------------------------------------------------------------- /How-to-Use.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "How to Use" 3 | --- 4 | # How to Use (after ArchWSL is installed) 5 | 6 | ## exe Usage 7 | 8 | ``` 9 | Usage : 10 | 11 | - Open a new shell with your default settings. 12 | 13 | run 14 | - Run the given command line in that instance. Inherit current directory. 15 | 16 | runp 17 | - Run the given command line in that instance after converting its path. 18 | 19 | config [setting [value]] 20 | - `--default-user `: Set the default user of this instance to . 21 | - `--default-uid `: Set the default user uid of this instance to . 22 | - `--append-path `: Switch of Append Windows PATH to $PATH 23 | - `--mount-drive `: Switch of Mount drives 24 | - `--wsl-version <1|2>`: Set the WSL version of this instance to <1 or 2> 25 | - `--default-term `: Set default type of terminal window. 26 | 27 | get [setting] 28 | - `--default-uid`: Get the default user uid in this instance. 29 | - `--append-path`: Get true/false status of Append Windows PATH to $PATH. 30 | - `--mount-drive`: Get true/false status of Mount drives. 31 | - `--wsl-version`: Get the version os the WSL (1/2) of this instance. 32 | - `--default-term`: Get Default Terminal type of this instance launcher. 33 | - `--lxguid`: Get WSL GUID key for this instance. 34 | 35 | backup [contents] 36 | - `--tar`: Output backup.tar to the current directory. 37 | - `--tgz`: Output backup.tar.tar to the current directory. 38 | - `--vhdx`: Output backup.ext4.vhdx to the current directory. (WSL2 only) 39 | - `--vhdxgz`: Output backup.ext4.vhdx.gz to the current directory. (WSL2 only) 40 | - `--reg`: Output settings registry file to the current directory. 41 | 42 | clean 43 | - Uninstall that instance. 44 | 45 | help 46 | - Print this usage message. 47 | ``` 48 | 49 | 50 | ## Open an interactive shell 51 | 52 | ``` 53 | >Arch.exe 54 | [root@PC-NAME user]# 55 | ``` 56 | 57 | ## Run a single command and exit 58 | 59 | ``` 60 | >Arch.exe run uname -r 61 | 4.4.0-43-Microsoft 62 | ``` 63 | 64 | ## Run a command with path translation and exit 65 | 66 | ``` 67 | >Arch.exe runp echo C:\Windows\System32\cmd.exe 68 | /mnt/c/Windows/System32/cmd.exe 69 | ``` 70 | 71 | ## Change Default User (id command required) 72 | 73 | ``` 74 | >Arch.exe config --default-user user 75 | 76 | >Arch.exe 77 | [user@PC-NAME dir]$ 78 | ``` 79 | 80 | If the default user has not been changed 81 | ([issue #7](https://github.com/yuk7/ArchWSL/issues/7)), 82 | please reboot the computer or alternatively, restart the LxssManager in an Admin 83 | command prompt. 84 | 85 | To restart the `LxssManager`, run this: 86 | 87 | ```batch 88 | net stop lxssmanager && net start lxssmanager 89 | ``` 90 | 91 | ## Backup Rootfs 92 | 93 | Backup: 94 | 95 | ``` 96 | >Arch.exe backup 97 | ``` 98 | 99 | Restore/install backup tarball: 100 | 101 | ``` 102 | >Arch.exe install full/path/to/backup.tar.gz 103 | ``` 104 | 105 | Restore/install backup vhdx: 106 | ``` 107 | >Arch.exe install full/path/to/backup.ext4.vhdx.gz 108 | ``` 109 | 110 | ## Uninstall Instance 111 | 112 | ``` 113 | >Arch.exe clean 114 | ``` 115 | -------------------------------------------------------------------------------- /Install-Certificate.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Install Certificate for AppX 3 | parent: "How to Setup" 4 | #nav_order: 5 | --- 6 | 7 | # Install Certificate for AppX 8 | 9 | ArchWSL is not approved by Microsoft. Therefore, you will need to install a code 10 | signing certificate manually if you want to install using the `.appx` package. 11 | The certificate must be installed in the "Trusted People" certificate store of the 12 | local machine. 13 | 14 | ## Instructions 15 | 16 | 1. Open the .cer file and click "Install Certificate". 17 | 18 | ![screenshot1](img/cert/1.install.png) 19 | 20 | 2. Select "Local Machine" and Next. 21 | 22 | ![screenshot2](img/cert/2.to-localmachine.png) 23 | 24 | 3. Select "Place ~ in the following store" and Click Browse to select installation destination. 25 | 26 | ![screenshot3](img/cert/3.to-following.png) 27 | 28 | 4. Select "Trusted People" and OK. 29 | 30 | ![screenshot4](img/cert/4.to-trustedpeople.png) 31 | 32 | 33 | 5. done 34 | -------------------------------------------------------------------------------- /Known-issues.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Known issues" 3 | --- 4 | # Known issues 5 | 6 | ## Launcher and Common 7 | Please see the [wsldl document](https://git.io/wsldl-doc). 8 | 9 | ## glibc 10 | The default glibc is optimized for the new kernel and uses syscall, which is not implemented in WSL1. 11 | 12 | If you don't use glibc with a patch that isn't the mainline, your instance won't start. 13 | 14 | You can use `glibc-linux4`[ᴬᵁᴿ](https://aur.archlinux.org/packages/glibc-linux4) package instead. 15 | 16 | You can install from archlinuxcn community repository (can auto-update, recommend) 17 | ``` 18 | echo '[archlinuxcn] 19 | Server = https://repo.archlinuxcn.org/$arch' >> /etc/pacman.conf 20 | sudo pacman -Syy && sudo pacman -S archlinuxcn-keyring && sudo pacman -S glibc-linux4 21 | ``` 22 | or you can install from AUR helper 23 | ``` 24 | yay -S glibc-linux4 25 | ``` 26 | 27 | ## fakeroot 28 | fakeroot is using SYSV IPC by default. 29 | but WSL1 does not support it now. 30 | 31 | You can use `fakeroot-tcp`[ᴬᵁᴿ](https://aur.archlinux.org/packages/fakeroot-tcp/) package instead. (WSL2 doesn't require that) 32 | 33 | Download [fakeroot-tcp-1.23-1-x86_64.pkg.tar.xz](https://github.com/yuk7/arch-prebuilt/releases/download/18082100/fakeroot-tcp-1.23-1-x86_64.pkg.tar.xz) and run ```pacman -U fakeroot-tcp-1.23-1-x86_64.pkg.tar.xz``` to install. 34 | 35 | ## Qt5 36 | qt >=5.10 library doesn't work in WSL1. This is an issue with WSL.(Please see [Microsoft/WSL#3023](https://github.com/Microsoft/WSL/issues/3023)) 37 | 38 | Please execute this line on root: 39 | ```strip --remove-section=.note.ABI-tag /usr/lib/libQt5Core.so.5``` 40 | 41 | ## MySQL 8/MariaDB 42 | MySQL >=8 uses the native AIO interface by default. WSL1 does not support it, so you need to configure it. 43 | Edit /etc/my.cnf.d/server.cnf for add `innodb_use_native_aio=0` to `[mysqld]` section. 44 | ``` 45 | [mysqld] 46 | innodb_use_native_aio=0 47 | ``` 48 | 49 | ## D-Bus 50 | Systemd D-Bus daemon doesn't work in WSL1. 51 | We recommend using `dbus-x11`[ᴬᵁᴿ](https://aur.archlinux.org/packages/dbus-x11/). 52 | Download [dbus-x11-1.12.16-1-x86_64.pkg.tar.xz](https://github.com/yuk7/arch-prebuilt/releases/download/20051200/dbus-x11-1.12.16-1-x86_64.pkg.tar.xz) and run ```pacman -U dbus-x11-1.12.16-1-x86_64.pkg.tar.xz``` to install. 53 | 54 | For start D-Bus daemon, run: 55 | ``` 56 | sudo mkdir /run/dbus -p 57 | sudo dbus-daemon --system 58 | ``` 59 | 60 | ## systemd/systemctl 61 | 62 | If you're using WSL 0.67.6 and above (see `wsl --version`), systemd is natively supported. To enable it, edit `/etc/wsl.conf` and then restart the distro. 63 | ``` 64 | [boot] 65 | systemd=true 66 | ``` 67 | 68 | If you're using an older version of WSL, we recommend using a systemctl alternative script or bottle for apps that require it. 69 | 70 | ### WSL1 / WSL2 71 | You can use a systemctl alternative script. 72 | However, this is only partially compatible. 73 | 74 | Download [systemd-altctl-1.4.4181-2-any.pkg.tar.xz](https://github.com/yuk7/arch-systemctl-alt/releases/download/1.4.4181-2/systemd-altctl-1.4.4181-2-any.pkg.tar.xz) and run ```pacman -U systemd-altctl-1.4.4181-2-any.pkg.tar.xz``` to install. Remember to check [the releases page](https://github.com/yuk7/arch-systemctl-alt/releases) for a newer version. 75 | 76 | ### WSL2 77 | You can use systemd bottle "[subsystemctl](https://github.com/sorah/subsystemctl)", "[genie](https://github.com/arkane-systems/genie)", "[wsl-distrod](https://github.com/nullpo-head/wsl-distrod)" or "[bottled-shell](https://github.com/lungothrin/bottled-shell)". 78 | 79 | Using any of the aformentioned solutions, will allow you to run systemd completely. 80 | 81 | #### subsystemctl 82 | You can download [PKGBUILD](https://raw.githubusercontent.com/sorah/arch.sorah.jp/master/aur-sorah/PKGBUILDs/subsystemctl/PKGBUILD) and build it. 83 | 84 | [See here for how to use it.](https://github.com/sorah/subsystemctl#usage) 85 | 86 | #### genie 87 | You can use [PKGBUILDs from here](https://gist.github.com/arlllk/7001c521de601f01735af5ca440f03ae). 88 | 89 | [See here for how to use it.](https://github.com/arkane-systems/genie#usage) 90 | 91 | #### Intel Graphics 92 | 93 | ArchWSL may not properly load the Intel WSL driver by default, which will make it impossible to use the D3D12 driver on Intel graphics cards. 94 | 95 | The cause of this problem is that the Intel WSL driver files link against libraries that do not exist on ArchLinux, you can manually fix them to make it work. 96 | 97 | You need to use `ldd` to see which libraries they are linked with, eg: `ldd /usr/lib/wsl/drivers/iigd_dch_d.inf_amd64_49b17bc90a910771/*.so`, and then look for libraries marked `not found`. Then check whether there are corresponding packages in the ArchLinux package repository. If so, install them, and the problem may be solved. If you cannot find the corresponding library file in the software package warehouse, it may be that the version suffix of the library file is different, such as `libedit.so.0.0.68` and `libedit.so.2`, then you can try to It creates a soft link to the existing version. 98 | 99 | Issue: [#308](https://github.com/yuk7/ArchWSL/issues/308) 100 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | Attribution 4.0 International 2 | 3 | ======================================================================= 4 | 5 | Creative Commons Corporation ("Creative Commons") is not a law firm and 6 | does not provide legal services or legal advice. Distribution of 7 | Creative Commons public licenses does not create a lawyer-client or 8 | other relationship. Creative Commons makes its licenses and related 9 | information available on an "as-is" basis. Creative Commons gives no 10 | warranties regarding its licenses, any material licensed under their 11 | terms and conditions, or any related information. Creative Commons 12 | disclaims all liability for damages resulting from their use to the 13 | fullest extent possible. 14 | 15 | Using Creative Commons Public Licenses 16 | 17 | Creative Commons public licenses provide a standard set of terms and 18 | conditions that creators and other rights holders may use to share 19 | original works of authorship and other material subject to copyright 20 | and certain other rights specified in the public license below. The 21 | following considerations are for informational purposes only, are not 22 | exhaustive, and do not form part of our licenses. 23 | 24 | Considerations for licensors: Our public licenses are 25 | intended for use by those authorized to give the public 26 | permission to use material in ways otherwise restricted by 27 | copyright and certain other rights. Our licenses are 28 | irrevocable. Licensors should read and understand the terms 29 | and conditions of the license they choose before applying it. 30 | Licensors should also secure all rights necessary before 31 | applying our licenses so that the public can reuse the 32 | material as expected. Licensors should clearly mark any 33 | material not subject to the license. This includes other CC- 34 | licensed material, or material used under an exception or 35 | limitation to copyright. More considerations for licensors: 36 | wiki.creativecommons.org/Considerations_for_licensors 37 | 38 | Considerations for the public: By using one of our public 39 | licenses, a licensor grants the public permission to use the 40 | licensed material under specified terms and conditions. If 41 | the licensor's permission is not necessary for any reason--for 42 | example, because of any applicable exception or limitation to 43 | copyright--then that use is not regulated by the license. Our 44 | licenses grant only permissions under copyright and certain 45 | other rights that a licensor has authority to grant. Use of 46 | the licensed material may still be restricted for other 47 | reasons, including because others have copyright or other 48 | rights in the material. A licensor may make special requests, 49 | such as asking that all changes be marked or described. 50 | Although not required by our licenses, you are encouraged to 51 | respect those requests where reasonable. More considerations 52 | for the public: 53 | wiki.creativecommons.org/Considerations_for_licensees 54 | 55 | ======================================================================= 56 | 57 | Creative Commons Attribution 4.0 International Public License 58 | 59 | By exercising the Licensed Rights (defined below), You accept and agree 60 | to be bound by the terms and conditions of this Creative Commons 61 | Attribution 4.0 International Public License ("Public License"). To the 62 | extent this Public License may be interpreted as a contract, You are 63 | granted the Licensed Rights in consideration of Your acceptance of 64 | these terms and conditions, and the Licensor grants You such rights in 65 | consideration of benefits the Licensor receives from making the 66 | Licensed Material available under these terms and conditions. 67 | 68 | Section 1 -- Definitions. 69 | 70 | a. Adapted Material means material subject to Copyright and Similar 71 | Rights that is derived from or based upon the Licensed Material 72 | and in which the Licensed Material is translated, altered, 73 | arranged, transformed, or otherwise modified in a manner requiring 74 | permission under the Copyright and Similar Rights held by the 75 | Licensor. For purposes of this Public License, where the Licensed 76 | Material is a musical work, performance, or sound recording, 77 | Adapted Material is always produced where the Licensed Material is 78 | synched in timed relation with a moving image. 79 | 80 | b. Adapter's License means the license You apply to Your Copyright 81 | and Similar Rights in Your contributions to Adapted Material in 82 | accordance with the terms and conditions of this Public License. 83 | 84 | c. Copyright and Similar Rights means copyright and/or similar rights 85 | closely related to copyright including, without limitation, 86 | performance, broadcast, sound recording, and Sui Generis Database 87 | Rights, without regard to how the rights are labeled or 88 | categorized. For purposes of this Public License, the rights 89 | specified in Section 2(b)(1)-(2) are not Copyright and Similar 90 | Rights. 91 | 92 | d. Effective Technological Measures means those measures that, in the 93 | absence of proper authority, may not be circumvented under laws 94 | fulfilling obligations under Article 11 of the WIPO Copyright 95 | Treaty adopted on December 20, 1996, and/or similar international 96 | agreements. 97 | 98 | e. Exceptions and Limitations means fair use, fair dealing, and/or 99 | any other exception or limitation to Copyright and Similar Rights 100 | that applies to Your use of the Licensed Material. 101 | 102 | f. Licensed Material means the artistic or literary work, database, 103 | or other material to which the Licensor applied this Public 104 | License. 105 | 106 | g. Licensed Rights means the rights granted to You subject to the 107 | terms and conditions of this Public License, which are limited to 108 | all Copyright and Similar Rights that apply to Your use of the 109 | Licensed Material and that the Licensor has authority to license. 110 | 111 | h. Licensor means the individual(s) or entity(ies) granting rights 112 | under this Public License. 113 | 114 | i. Share means to provide material to the public by any means or 115 | process that requires permission under the Licensed Rights, such 116 | as reproduction, public display, public performance, distribution, 117 | dissemination, communication, or importation, and to make material 118 | available to the public including in ways that members of the 119 | public may access the material from a place and at a time 120 | individually chosen by them. 121 | 122 | j. Sui Generis Database Rights means rights other than copyright 123 | resulting from Directive 96/9/EC of the European Parliament and of 124 | the Council of 11 March 1996 on the legal protection of databases, 125 | as amended and/or succeeded, as well as other essentially 126 | equivalent rights anywhere in the world. 127 | 128 | k. You means the individual or entity exercising the Licensed Rights 129 | under this Public License. Your has a corresponding meaning. 130 | 131 | Section 2 -- Scope. 132 | 133 | a. License grant. 134 | 135 | 1. Subject to the terms and conditions of this Public License, 136 | the Licensor hereby grants You a worldwide, royalty-free, 137 | non-sublicensable, non-exclusive, irrevocable license to 138 | exercise the Licensed Rights in the Licensed Material to: 139 | 140 | a. reproduce and Share the Licensed Material, in whole or 141 | in part; and 142 | 143 | b. produce, reproduce, and Share Adapted Material. 144 | 145 | 2. Exceptions and Limitations. For the avoidance of doubt, where 146 | Exceptions and Limitations apply to Your use, this Public 147 | License does not apply, and You do not need to comply with 148 | its terms and conditions. 149 | 150 | 3. Term. The term of this Public License is specified in Section 151 | 6(a). 152 | 153 | 4. Media and formats; technical modifications allowed. The 154 | Licensor authorizes You to exercise the Licensed Rights in 155 | all media and formats whether now known or hereafter created, 156 | and to make technical modifications necessary to do so. The 157 | Licensor waives and/or agrees not to assert any right or 158 | authority to forbid You from making technical modifications 159 | necessary to exercise the Licensed Rights, including 160 | technical modifications necessary to circumvent Effective 161 | Technological Measures. For purposes of this Public License, 162 | simply making modifications authorized by this Section 2(a) 163 | (4) never produces Adapted Material. 164 | 165 | 5. Downstream recipients. 166 | 167 | a. Offer from the Licensor -- Licensed Material. Every 168 | recipient of the Licensed Material automatically 169 | receives an offer from the Licensor to exercise the 170 | Licensed Rights under the terms and conditions of this 171 | Public License. 172 | 173 | b. No downstream restrictions. You may not offer or impose 174 | any additional or different terms or conditions on, or 175 | apply any Effective Technological Measures to, the 176 | Licensed Material if doing so restricts exercise of the 177 | Licensed Rights by any recipient of the Licensed 178 | Material. 179 | 180 | 6. No endorsement. Nothing in this Public License constitutes or 181 | may be construed as permission to assert or imply that You 182 | are, or that Your use of the Licensed Material is, connected 183 | with, or sponsored, endorsed, or granted official status by, 184 | the Licensor or others designated to receive attribution as 185 | provided in Section 3(a)(1)(A)(i). 186 | 187 | b. Other rights. 188 | 189 | 1. Moral rights, such as the right of integrity, are not 190 | licensed under this Public License, nor are publicity, 191 | privacy, and/or other similar personality rights; however, to 192 | the extent possible, the Licensor waives and/or agrees not to 193 | assert any such rights held by the Licensor to the limited 194 | extent necessary to allow You to exercise the Licensed 195 | Rights, but not otherwise. 196 | 197 | 2. Patent and trademark rights are not licensed under this 198 | Public License. 199 | 200 | 3. To the extent possible, the Licensor waives any right to 201 | collect royalties from You for the exercise of the Licensed 202 | Rights, whether directly or through a collecting society 203 | under any voluntary or waivable statutory or compulsory 204 | licensing scheme. In all other cases the Licensor expressly 205 | reserves any right to collect such royalties. 206 | 207 | Section 3 -- License Conditions. 208 | 209 | Your exercise of the Licensed Rights is expressly made subject to the 210 | following conditions. 211 | 212 | a. Attribution. 213 | 214 | 1. If You Share the Licensed Material (including in modified 215 | form), You must: 216 | 217 | a. retain the following if it is supplied by the Licensor 218 | with the Licensed Material: 219 | 220 | i. identification of the creator(s) of the Licensed 221 | Material and any others designated to receive 222 | attribution, in any reasonable manner requested by 223 | the Licensor (including by pseudonym if 224 | designated); 225 | 226 | ii. a copyright notice; 227 | 228 | iii. a notice that refers to this Public License; 229 | 230 | iv. a notice that refers to the disclaimer of 231 | warranties; 232 | 233 | v. a URI or hyperlink to the Licensed Material to the 234 | extent reasonably practicable; 235 | 236 | b. indicate if You modified the Licensed Material and 237 | retain an indication of any previous modifications; and 238 | 239 | c. indicate the Licensed Material is licensed under this 240 | Public License, and include the text of, or the URI or 241 | hyperlink to, this Public License. 242 | 243 | 2. You may satisfy the conditions in Section 3(a)(1) in any 244 | reasonable manner based on the medium, means, and context in 245 | which You Share the Licensed Material. For example, it may be 246 | reasonable to satisfy the conditions by providing a URI or 247 | hyperlink to a resource that includes the required 248 | information. 249 | 250 | 3. If requested by the Licensor, You must remove any of the 251 | information required by Section 3(a)(1)(A) to the extent 252 | reasonably practicable. 253 | 254 | 4. If You Share Adapted Material You produce, the Adapter's 255 | License You apply must not prevent recipients of the Adapted 256 | Material from complying with this Public License. 257 | 258 | Section 4 -- Sui Generis Database Rights. 259 | 260 | Where the Licensed Rights include Sui Generis Database Rights that 261 | apply to Your use of the Licensed Material: 262 | 263 | a. for the avoidance of doubt, Section 2(a)(1) grants You the right 264 | to extract, reuse, reproduce, and Share all or a substantial 265 | portion of the contents of the database; 266 | 267 | b. if You include all or a substantial portion of the database 268 | contents in a database in which You have Sui Generis Database 269 | Rights, then the database in which You have Sui Generis Database 270 | Rights (but not its individual contents) is Adapted Material; and 271 | 272 | c. You must comply with the conditions in Section 3(a) if You Share 273 | all or a substantial portion of the contents of the database. 274 | 275 | For the avoidance of doubt, this Section 4 supplements and does not 276 | replace Your obligations under this Public License where the Licensed 277 | Rights include other Copyright and Similar Rights. 278 | 279 | Section 5 -- Disclaimer of Warranties and Limitation of Liability. 280 | 281 | a. UNLESS OTHERWISE SEPARATELY UNDERTAKEN BY THE LICENSOR, TO THE 282 | EXTENT POSSIBLE, THE LICENSOR OFFERS THE LICENSED MATERIAL AS-IS 283 | AND AS-AVAILABLE, AND MAKES NO REPRESENTATIONS OR WARRANTIES OF 284 | ANY KIND CONCERNING THE LICENSED MATERIAL, WHETHER EXPRESS, 285 | IMPLIED, STATUTORY, OR OTHER. THIS INCLUDES, WITHOUT LIMITATION, 286 | WARRANTIES OF TITLE, MERCHANTABILITY, FITNESS FOR A PARTICULAR 287 | PURPOSE, NON-INFRINGEMENT, ABSENCE OF LATENT OR OTHER DEFECTS, 288 | ACCURACY, OR THE PRESENCE OR ABSENCE OF ERRORS, WHETHER OR NOT 289 | KNOWN OR DISCOVERABLE. WHERE DISCLAIMERS OF WARRANTIES ARE NOT 290 | ALLOWED IN FULL OR IN PART, THIS DISCLAIMER MAY NOT APPLY TO YOU. 291 | 292 | b. TO THE EXTENT POSSIBLE, IN NO EVENT WILL THE LICENSOR BE LIABLE 293 | TO YOU ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION, 294 | NEGLIGENCE) OR OTHERWISE FOR ANY DIRECT, SPECIAL, INDIRECT, 295 | INCIDENTAL, CONSEQUENTIAL, PUNITIVE, EXEMPLARY, OR OTHER LOSSES, 296 | COSTS, EXPENSES, OR DAMAGES ARISING OUT OF THIS PUBLIC LICENSE OR 297 | USE OF THE LICENSED MATERIAL, EVEN IF THE LICENSOR HAS BEEN 298 | ADVISED OF THE POSSIBILITY OF SUCH LOSSES, COSTS, EXPENSES, OR 299 | DAMAGES. WHERE A LIMITATION OF LIABILITY IS NOT ALLOWED IN FULL OR 300 | IN PART, THIS LIMITATION MAY NOT APPLY TO YOU. 301 | 302 | c. The disclaimer of warranties and limitation of liability provided 303 | above shall be interpreted in a manner that, to the extent 304 | possible, most closely approximates an absolute disclaimer and 305 | waiver of all liability. 306 | 307 | Section 6 -- Term and Termination. 308 | 309 | a. This Public License applies for the term of the Copyright and 310 | Similar Rights licensed here. However, if You fail to comply with 311 | this Public License, then Your rights under this Public License 312 | terminate automatically. 313 | 314 | b. Where Your right to use the Licensed Material has terminated under 315 | Section 6(a), it reinstates: 316 | 317 | 1. automatically as of the date the violation is cured, provided 318 | it is cured within 30 days of Your discovery of the 319 | violation; or 320 | 321 | 2. upon express reinstatement by the Licensor. 322 | 323 | For the avoidance of doubt, this Section 6(b) does not affect any 324 | right the Licensor may have to seek remedies for Your violations 325 | of this Public License. 326 | 327 | c. For the avoidance of doubt, the Licensor may also offer the 328 | Licensed Material under separate terms or conditions or stop 329 | distributing the Licensed Material at any time; however, doing so 330 | will not terminate this Public License. 331 | 332 | d. Sections 1, 5, 6, 7, and 8 survive termination of this Public 333 | License. 334 | 335 | Section 7 -- Other Terms and Conditions. 336 | 337 | a. The Licensor shall not be bound by any additional or different 338 | terms or conditions communicated by You unless expressly agreed. 339 | 340 | b. Any arrangements, understandings, or agreements regarding the 341 | Licensed Material not stated herein are separate from and 342 | independent of the terms and conditions of this Public License. 343 | 344 | Section 8 -- Interpretation. 345 | 346 | a. For the avoidance of doubt, this Public License does not, and 347 | shall not be interpreted to, reduce, limit, restrict, or impose 348 | conditions on any use of the Licensed Material that could lawfully 349 | be made without permission under this Public License. 350 | 351 | b. To the extent possible, if any provision of this Public License is 352 | deemed unenforceable, it shall be automatically reformed to the 353 | minimum extent necessary to make it enforceable. If the provision 354 | cannot be reformed, it shall be severed from this Public License 355 | without affecting the enforceability of the remaining terms and 356 | conditions. 357 | 358 | c. No term or condition of this Public License will be waived and no 359 | failure to comply consented to unless expressly agreed to by the 360 | Licensor. 361 | 362 | d. Nothing in this Public License constitutes or may be interpreted 363 | as a limitation upon, or waiver of, any privileges and immunities 364 | that apply to the Licensor or You, including from the legal 365 | processes of any jurisdiction or authority. 366 | 367 | ======================================================================= 368 | 369 | Creative Commons is not a party to its public 370 | licenses. Notwithstanding, Creative Commons may elect to apply one of 371 | its public licenses to material it publishes and in those instances 372 | will be considered the “Licensor.” The text of the Creative Commons 373 | public licenses is dedicated to the public domain under the CC0 Public 374 | Domain Dedication. Except for the limited purpose of indicating that 375 | material is shared under a Creative Commons public license or as 376 | otherwise permitted by the Creative Commons policies published at 377 | creativecommons.org/policies, Creative Commons does not authorize the 378 | use of the trademark "Creative Commons" or any other trademark or logo 379 | of Creative Commons without its prior written consent including, 380 | without limitation, in connection with any unauthorized modifications 381 | to any of its public licenses or any other arrangements, 382 | understandings, or agreements concerning use of licensed material. For 383 | the avoidance of doubt, this paragraph does not form part of the 384 | public licenses. 385 | 386 | Creative Commons may be contacted at creativecommons.org. -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | --- 2 | layout: default 3 | title: Home 4 | nav_order: 1 5 | description: "The beginning of the world" 6 | permalink: / 7 | --- 8 | 9 | # ArchWSL documentation 10 | [How to Setup](How-to-Setup.md) 11 | 12 | [How to Use](How-to-Use.md) 13 | 14 | [Known issues](Known-issues.md) 15 | 16 | [Translations](locale/Translations.md) 17 | -------------------------------------------------------------------------------- /__sass/custom/custom.scss: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /_config.yml: -------------------------------------------------------------------------------- 1 | title: "ArchWSL official documentation" 2 | description: "A ArchWSL for documentation" 3 | footer_content: "Copyright © 2020 Wsldl-pg Documentation Team. Distributed by Creative Commons Attribution 4.0 International License." 4 | logo: "/asset/wsldl-logo.svg" 5 | 6 | remote_theme: "pmarsceill/just-the-docs" 7 | color_scheme: "dark" 8 | search_enabled: true 9 | search: 10 | rel_url: true 11 | button: true 12 | baseurl: "/ArchW-docs" 13 | url: "https://wsldl-pg.github.io" 14 | aux_links: 15 | " See GitHub": 16 | - "//github.com/wsldl-pg/ArchW-docs" 17 | aux_links_new_tab: true 18 | 19 | permalink: pretty 20 | exclude: [ "node_modules/", "*.gemspec", "*.gem", "Gemfile", "Gemfile.lock", "package.json", "package-lock.json", "script/", "lib/", "bin/", "Rakefile", "docs/tests/", "module/" ] 21 | 22 | heading_anchors: true 23 | 24 | back_to_top: true 25 | back_to_top_text: "Back to top" 26 | 27 | gh_edit_link: true 28 | gh_edit_link_text: "Edit this page on GitHub" 29 | gh_edit_repository: "https://github.com/wsldl-pg/ArchW-docs" 30 | gh_edit_branch: "main" 31 | gh_edit_view_mode: "tree" 32 | 33 | #ga_tracking: UA-1234567-89 34 | #ga_tracking_anonymize_ip: true 35 | 36 | plugins: 37 | - jekyll-seo-tag 38 | - jekyll-sitemap 39 | 40 | markdown: kramdown 41 | highlighter: rouge 42 | 43 | kramdown: 44 | input: GFM 45 | syntax_highlighter_opts: 46 | block: 47 | line_numbers: false 48 | 49 | compress_html: 50 | clippings: all 51 | comments: all 52 | endings: all 53 | startings: [] 54 | blanklines: false 55 | profile: false 56 | # ignore: 57 | # envs: all 58 | -------------------------------------------------------------------------------- /_includes/body_gtag.html: -------------------------------------------------------------------------------- 1 | 2 | 4 | 5 | -------------------------------------------------------------------------------- /_includes/default.html: -------------------------------------------------------------------------------- 1 | --- 2 | layout: table_wrappers 3 | --- 4 | 5 | 6 | 7 | 8 | {% include head.html %} 9 | 10 | {% include body_gtag.html %} 11 | 12 | 13 | Link 14 | 15 | 16 | 17 | 18 | 19 | Search 20 | 21 | 22 | 23 | 24 | 25 | Menu 26 | 27 | 28 | 29 | 30 | 31 | Expand 32 | 33 | 34 | 35 | 36 | 37 | Document 38 | 39 | 40 | 41 | 42 | 43 | 44 |
45 |
46 | {% include title.html %} 47 | 48 | 49 | 50 |
51 | 69 |
70 | This site uses Just the Docs, a documentation theme for Jekyll. 71 |
72 |
73 |
74 |
75 | {% if site.search_enabled != false %} 76 |
77 |
78 | 79 | 80 |
81 |
82 |
83 | {% endif %} 84 | {% include header_custom.html %} 85 | {% if site.aux_links %} 86 | 101 | {% endif %} 102 |
103 |
104 | {% unless page.url == "/" %} 105 | {% if page.parent %} 106 | {%- for node in pages_list -%} 107 | {%- if node.parent == nil -%} 108 | {%- if page.parent == node.title or page.grand_parent == node.title -%} 109 | {%- assign first_level_url = node.url | absolute_url -%} 110 | {%- endif -%} 111 | {%- if node.has_children -%} 112 | {%- assign children_list = pages_list | where: "parent", node.title -%} 113 | {%- for child in children_list -%} 114 | {%- if page.url == child.url or page.parent == child.title -%} 115 | {%- assign second_level_url = child.url | absolute_url -%} 116 | {%- endif -%} 117 | {%- endfor -%} 118 | {%- endif -%} 119 | {%- endif -%} 120 | {%- endfor -%} 121 | 132 | {% endif %} 133 | {% endunless %} 134 |
135 | {% if site.heading_anchors != false %} 136 | {% include vendor/anchor_headings.html html=content beforeHeading="true" anchorBody="" anchorClass="anchor-heading" anchorAttrs="aria-labelledby=\"%html_id%\"" %} 137 | {% else %} 138 | {{ content }} 139 | {% endif %} 140 | 141 | {% if page.has_children == true and page.has_toc != false %} 142 |
143 |

Table of contents

144 |
    145 | {%- assign children_list = pages_list | where: "parent", page.title | where: "grand_parent", page.parent -%} 146 | {% for child in children_list %} 147 |
  • 148 | {{ child.title }}{% if child.summary %} - {{ child.summary }}{% endif %} 149 |
    • 150 | {% endfor %} 151 |
152 | {% endif %} 153 | 154 | {% capture footer_custom %} 155 | {%- include footer_custom.html -%} 156 | {% endcapture %} 157 | {% if footer_custom != "" or site.last_edit_timestamp or site.gh_edit_link %} 158 |
159 |
160 | {% if site.back_to_top %} 161 |

{{ site.back_to_top_text }}

162 | {% endif %} 163 | 164 | {{ footer_custom }} 165 | 166 | {% if site.last_edit_timestamp or site.gh_edit_link %} 167 |
168 | {% if site.last_edit_timestamp and site.last_edit_time_format and page.last_modified_date %} 169 |

170 | Page last modified: {{ page.last_modified_date | date: site.last_edit_time_format }}. 171 |

172 | {% endif %} 173 | {% if 174 | site.gh_edit_link and 175 | site.gh_edit_link_text and 176 | site.gh_edit_repository and 177 | site.gh_edit_branch and 178 | site.gh_edit_view_mode 179 | %} 180 |

181 | {{ site.gh_edit_link_text }} 182 |

183 | {% endif %} 184 |
185 | {% endif %} 186 |
187 | {% endif %} 188 | 189 |
190 |
191 | 192 | {% if site.search_enabled != false %} 193 | {% if site.search.button %} 194 | 195 | 196 | 197 | {% endif %} 198 | 199 |
200 | {% endif %} 201 |
202 | 203 | 204 | -------------------------------------------------------------------------------- /_includes/footer_custom.html: -------------------------------------------------------------------------------- 1 | 2 |

Copyright © 2020 Wsldl-pg Documentation Team. Distributed by Creative Commons Attribution 4.0 International License.

3 | 4 | 29 | -------------------------------------------------------------------------------- /_includes/head.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | {% include head_gtag.html %} 6 | 7 | {% unless site.plugins contains "jekyll-seo-tag" %} 8 | {{ page.title }} - {{ site.title }} 9 | 10 | {% if page.description %} 11 | 12 | {% endif %} 13 | {% endunless %} 14 | 15 | 16 | 17 | 18 | 19 | 20 | {% if site.ga_tracking != nil %} 21 | 22 | 29 | 30 | {% endif %} 31 | 32 | {% if site.search_enabled != false %} 33 | 34 | {% endif %} 35 | 36 | 37 | 38 | 39 | {% seo %} 40 | 41 | {% include head_custom.html %} 42 | 43 | -------------------------------------------------------------------------------- /_includes/head_custom.html: -------------------------------------------------------------------------------- 1 | 35 | -------------------------------------------------------------------------------- /_includes/head_gtag.html: -------------------------------------------------------------------------------- 1 | 2 | 7 | 8 | 9 | 10 | 16 | -------------------------------------------------------------------------------- /_includes/title.html: -------------------------------------------------------------------------------- 1 | ArchWSL Documentation 2 | -------------------------------------------------------------------------------- /asset/wsldl-logo.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/wsldl-pg/ArchW-docs/0e149e961dcf62aab856d0ad299a9bc61887b41e/asset/wsldl-logo.png -------------------------------------------------------------------------------- /asset/wsldl-logo.svg: -------------------------------------------------------------------------------- 1 | 2 | 3 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | -------------------------------------------------------------------------------- /img/cert/1.install.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/wsldl-pg/ArchW-docs/0e149e961dcf62aab856d0ad299a9bc61887b41e/img/cert/1.install.png -------------------------------------------------------------------------------- /img/cert/2.to-localmachine.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/wsldl-pg/ArchW-docs/0e149e961dcf62aab856d0ad299a9bc61887b41e/img/cert/2.to-localmachine.png -------------------------------------------------------------------------------- /img/cert/3.to-following.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/wsldl-pg/ArchW-docs/0e149e961dcf62aab856d0ad299a9bc61887b41e/img/cert/3.to-following.png -------------------------------------------------------------------------------- /img/cert/4.to-trustedpeople.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/wsldl-pg/ArchW-docs/0e149e961dcf62aab856d0ad299a9bc61887b41e/img/cert/4.to-trustedpeople.png -------------------------------------------------------------------------------- /locale/Translations.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Translations" 3 | has_children: true 4 | --- 5 | 6 | # Translations 7 | 8 | [English](../README.md) 9 | 10 | [Japanese（日本語）](ja-JP/README.md) 11 | 12 | [Simplified Chinese（简体中文）](zh-CN/README.md) 13 | 14 | [Traditional Chinese（繁體中文）](zh-TW/README.md) 15 | 16 | [Korean (한국어) ](ko-KR/README.md) 17 | 18 | [Brazilian Portuguese (Português Brasileiro)](pt-BR/README.md) 19 | -------------------------------------------------------------------------------- /locale/ja-JP/How-to-Setup.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "インストール方法" 3 | parent: "日本語" 4 | grand_parent: "Translations" 5 | has_children: true 6 | --- 7 | # ArchWSLのセットアップ 8 | 9 | ## システム要件 10 | 11 | * Windows 10 1709 Fall Creators Update x64以上 12 | * Windows Subsystem for Linux機能が有効になっていること 13 | 14 | ## インストール手順 15 | 現在は2種類のパッケージを提供しています。 16 | 17 | ### 1: zipファイル 18 | 19 | 1. zipファイルを[ダウンロード](https://github.com/yuk7/ArchWSL/releases/latest) 20 | 2. zip内のすべてのファイルを同じディレクトリに展開します 21 | 展開先のディレクトリには書き込み権限が必要です。 22 | 例えば、`C:\Program Files` は使用できません。 23 | 3. `Arch.exe` を実行するとそのディレクトリ内でインストールが実行されます。 24 | 25 | exeファイルのファイル名がWSLのインスタンス名に使用されます。 26 | リネームすると、 27 | 28 | ### 2: appxパッケージ 29 | 30 | 1. [`.appx`と`.cer`ファイルをダウンロード](https://github.com/yuk7/ArchWSL/releases/latest)します。 31 | 2. `.cer`ファイルを"ローカルマシン"の"信頼されたルート証明機関"にインストールします。 32 | 詳細は[証明書のインストール](Install-Certificate.md)ページを参照してください。 33 | 証明書のインストールには管理者権限が必要です。 34 | 3. `.appx`をダブルクリックし、インストールします。 35 | 36 | ## インストール後の設定 37 | 38 | ### rootパスワードの設定 39 | 40 | ```shell 41 | >Arch.exe 42 | [root@PC-NAME]# passwd 43 | ``` 44 | 45 | ### デフォルトユーザーの設定 46 | ArchWikiを参照してください。 47 | [Sudo](https://wiki.archlinux.jp/index.php/Sudo#.E3.82.A8.E3.83.B3.E3.83.88.E3.83.AA.E3.81.AE.E4.BE.8B) 48 | 49 | [ユーザーとグループ](https://wiki.archlinux.jp/index.php/%E3%83%A6%E3%83%BC%E3%82%B6%E3%83%BC%E3%81%A8%E3%82%B0%E3%83%AB%E3%83%BC%E3%83%97) 50 | 51 | ```shell 52 | >Arch.exe 53 | [root@PC-NAME]# echo "%wheel ALL=(ALL) ALL" > /etc/sudoers.d/wheel 54 | (sudoersファイルを設定します) 55 | 56 | [root@PC-NAME]# useradd -m -G wheel -s /bin/bash {username} 57 | ({username}というユーザーを追加します) 58 | 59 | [root@PC-NAME]# passwd {username} 60 | ({username}というユーザーにパスワードを設定します) 61 | 62 | [root@PC-NAME]# exit 63 | 64 | >Arch.exe config --default-user {username} 65 | (デフォルトのユーザーを{username}に設定します) 66 | ``` 67 | 68 | デフォルトユーザーの変更がうまく行かない場合は, 69 | コンピュータを再起動するか、LxssManagerサービスを再起動してください。 70 | 詳細は([issue #7](https://github.com/yuk7/ArchWSL/issues/7))を参照してください。 71 | 72 | `LxssManager`を再起動するには、管理者権限のコマンドプロンプトで以下のコマンドを実行します: 73 | 74 | ```batch 75 | net stop lxssmanager && net start lxssmanager 76 | ``` 77 | 78 | ### キーリングの初期化 79 | 以下のコマンドを実行してｍキーリングを初期化してください。 80 | (この作業はpacmanを使用する前に必ず必要です。) 81 | 82 | ```shell 83 | >Arch.exe 84 | [user@PC-NAME]$ sudo pacman-key --init 85 | 86 | [user@PC-NAME]$ sudo pacman-key --populate 87 | 88 | [user@PC-NAME]$ sudo pacman -Syy archlinux-keyring 89 | ``` 90 | 91 | ### systemctl代替ツールをインストール (任意) 92 | 93 | WSLはsystemdをサポートしていません。 しかし、systemdを代替するツールや別の名前空間を作成しsystemdを実行するツールを使用できます。 94 | [既知の問題](Known-issues.md#systemdsystemctl)を参照してください。 95 | -------------------------------------------------------------------------------- /locale/ja-JP/How-to-Use.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "使い方" 3 | parent: "日本語" 4 | grand_parent: "Translations" 5 | --- 6 | # 使い方(インストール後) 7 | ## exe Usage 8 | 9 | ``` 10 | Usage : 11 | <引数なし> 12 | - デフォルト設定で新しいシェルを起動します 13 | 14 | run 15 | - 与えられたコマンドラインをインスタンス内で実行します。 カレントディレクトリが引き継がれます。 16 | 17 | runp 18 | - 与えられたコマンドラインのパスを変換した上でインスタンス内で実行します。 19 | 20 | config [setting [value]] 21 | - `--default-user `: インスタンスのデフォルトユーザーをに設定します。 22 | - `--default-uid `: インスタンスのデフォルトユーザーのuidをに設定します。 23 | - `--append-path `: Windows側のPATH設定をLinux側に引き継ぐ機能のon/offを設定します。 24 | - `--mount-drive `: Windowsのドライブをマウントする機能のon/offを設定します。 25 | - `--default-term `: デフォルトのターミナルを設定します。 26 | 27 | get [setting] 28 | - `--default-uid`: インスタンスのデフォルトユーザーのuidを取得します。 29 | - `--append-path`: Windows側のPATH設定をLinux側に引き継ぐ機能のon/offを確認します。 30 | - `--mount-drive`: Windowsのドライブをマウントする機能のon/offを確認します。 31 | - `--wsl-version`: WSLのバージョン(1/2)を確認します。 32 | - `--default-term`: このランチャーに設定されたデフォルトのターミナルを確認します。 33 | - `--lxuid`: システム内部で使用されているLxUIDを取得します。 34 | 35 | backup [contents] 36 | - `--tar`: カレントディレクトリにbackup.tarを出力します。 37 | - `--reg`: 設定のレジストリファイルをbackup.regとしてカレントディレクトリに出力します。 38 | 39 | clean 40 | - インスタンスをアンインストールします。 41 | 42 | help 43 | - helpを表示します。 44 | ``` 45 | 46 | 47 | ## 対話シェルを起動 48 | 49 | ``` 50 | >Arch.exe 51 | [root@PC-NAME user]# 52 | ``` 53 | 54 | ## コマンドを実行し終了 55 | 56 | ``` 57 | >Arch.exe run uname -r 58 | 4.4.0-43-Microsoft 59 | ``` 60 | 61 | ## 与えられたコマンドラインのパスを変換し実行 62 | 63 | ``` 64 | >Arch.exe runp echo C:\Windows\System32\cmd.exe 65 | /mnt/c/Windows/System32/cmd.exe 66 | ``` 67 | 68 | ## デフォルトユーザーを変更 69 | 70 | ``` 71 | >Arch.exe config --default-user user 72 | 73 | >Arch.exe 74 | [user@PC-NAME dir]$ 75 | ``` 76 | 77 | デフォルトユーザーの変更がうまく行かない場合は, 78 | コンピュータを再起動するか、LxssManagerサービスを再起動してください。 79 | 詳細は([issue #7](https://github.com/yuk7/ArchWSL/issues/7))を参照してください。 80 | 81 | `LxssManager`を再起動するには、管理者権限のコマンドプロンプトで以下のコマンドを実行します: 82 | 83 | ```batch 84 | net stop lxssmanager && net start lxssmanager 85 | ``` 86 | 87 | ## rootfsをバックアップ 88 | 89 | バックアップ: 90 | 91 | ``` 92 | >Arch.exe backup 93 | ``` 94 | 95 | バックアップしたtarをインストール/リストア: 96 | 97 | ``` 98 | >Arch.exe install full/path/to/backup.tar 99 | ``` 100 | 101 | ## インスタンスをアンインストール 102 | 103 | ``` 104 | >Arch.exe clean 105 | ``` 106 | -------------------------------------------------------------------------------- /locale/ja-JP/Install-Certificate.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "AppX用の証明書のインストール方法" 3 | parent: "インストール方法" 4 | #nav_order: 5 | --- 6 | 7 | # AppX用の証明書をインストールする 8 | 9 | ArchWSLはMicrosoftの承認を受けていません。そのため、`.appx`パッケージを使用してインストールする場合は、署名証明書を手動で取得する必要があります。 10 | 証明書は、ローカルコンピューターの「信頼されたルート証明書ストア」にインストールされている必要があります。 11 | 12 | ## 手順 13 | 14 | 1. `.cer`ファイルを開き、「証明書のインストール」をクリックします。 15 | 16 | ![screenshot1](img/cert/1.install.png) 17 | 18 | 2. 「ローカルコンピューター」を選択し、「次へ」をクリックします。 19 | 20 | ![screenshot2](img/cert/2.to-localmachine.png) 21 | 22 | 3. 「証明書をすべて次のストアに配置する」を選択し、「参照」をクリックしてインストール先を選択します。 23 | 24 | ![screenshot3](img/cert/3.to-following.png) 25 | 26 | 4. 「信頼されたルート証明機関」を選択し、OKを押す。 27 | 28 | ![screenshot4](img/cert/4.to-rootstore.png) 29 | 30 | 5. インストール完了！ -------------------------------------------------------------------------------- /locale/ja-JP/Known-issues.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "既知の問題" 3 | parent: "日本語" 4 | grand_parent: "Translations" 5 | --- 6 | # Known issues 7 | 8 | ## Launcher and Common 9 | Please see [wsldl document](https://git.io/wsldl-doc) 10 | 11 | ## glibc 12 | 最新のglibcはWSL1と互換性がありません。 13 | 古いバージョンでglibcを固定するか、WSL2をしようしてください。 14 | 15 | ## fakeroot 16 | fakerootはSYSV IPCをデフォルトで使用しています。 17 | WSL1では、SYSV IPCをサポートしていません。 18 | 19 | `fakeroot-tcp`[ᴬᵁᴿ](https://aur.archlinux.org/packages/fakeroot-tcp/) 代わりに使用できます。(WSL2ではSYSV IPCをサポートしているため、必要ありません。) 20 | 21 | [fakeroot-tcp-1.23-1-x86_64.pkg.tar.xz](https://github.com/yuk7/arch-prebuilt/releases/download/18082100/fakeroot-tcp-1.23-1-x86_64.pkg.tar.xz)をダウンロードし、```pacman -U fakeroot-tcp-1.23-1-x86_64.pkg.tar.xz``` をシェルで実行するとインストールすることが出来ます。 22 | 23 | ## Qt5 24 | qt >=5.10ライブラリはWSL1では動作しません。 これはWSL1の問題に起因します。(Please see [Microsoft/WSL#3023](https://github.com/Microsoft/WSL/issues/3023)) 25 | 26 | このコマンドを実行してください。: 27 | ```strip --remove-section=.note.ABI-tag /usr/lib/libQt5Core.so.5``` 28 | 29 | ## MySQL 8/MariaDB 30 | MySQL >=8 はネイティブAIOインターフェイスをデフォルトで使用します。 WSL1はそれに対応していません。 31 | そのため、ネイティブAIOインターフェイスを使用しないように設定を変更する必要があります。 32 | `/etc/my.cnf.d/server.cnf`を編集し、`innodb_use_native_aio=0` を `[mysqld]`セクションに追加します。 33 | ``` 34 | [mysqld] 35 | innodb_use_native_aio=0 36 | ``` 37 | 38 | ## D-Bus 39 | SystemdのD-BusデーモンはWSL1では動作しません。 40 | `dbus-x11`[ᴬᵁᴿ](https://aur.archlinux.org/packages/dbus-x11/)の使用を推奨します。 41 | [dbus-x11-1.12.16-1-x86_64.pkg.tar.xz](https://github.com/yuk7/arch-prebuilt/releases/download/20051200/dbus-x11-1.12.16-1-x86_64.pkg.tar.xz)をダウンロードし、 ```pacman -U dbus-x11-1.12.16-1-x86_64.pkg.tar.xz``` をシェルで実行することでインストール出来ます。 42 | 43 | D-Busデーモンを起動するには、以下のコマンドを実行します: 44 | ``` 45 | sudo mkdir /run/dbus -p 46 | sudo dbus-daemon --system 47 | ``` 48 | 49 | ## systemd/systemctl 50 | systemdはWSLに対応していません。 51 | systemctlを使用する場合は、systemctlの代替スクリプトやボトルツールを推奨します。 52 | 53 | #### WSL1 / WSL2 54 | systemctlの互換スクリプトを使用できます。 55 | しかし、これには完全な互換性はありません。 56 | 57 | [systemd-altctl-1.4.4181-1-any.pkg.tar.xz](https://github.com/yuk7/arch-systemctl-alt/releases/download/1.4.4181-1/systemd-altctl-1.4.4181-1-any.pkg.tar.xz)をダウンロードし、シェルで ```pacman -U systemd-altctl-1.4.4181-1-any.pkg.tar.xz``` を実行するとインストール出来ます。 58 | 59 | #### WSL2 60 | "[subsystemctl](https://github.com/sorah/subsystemctl)"や"[genie](https://github.com/arkane-systems/genie)"のようなsystemdのbottleを使用できます。 61 | 62 | これらを使用すると、systemdはコンテナ内で正しく動作します。 63 | 64 | ##### subsystemctl 65 | [PKGBUILD](https://raw.githubusercontent.com/sorah/arch.sorah.jp/master/aur-sorah/PKGBUILDs/subsystemctl/PKGBUILD)をダウンロードして、ビルドします。 66 | 67 | [詳細はプロジェクトページを参照してください](https://github.com/sorah/subsystemctl#usage) 68 | 69 | ##### genie 70 | [リンク先にあるPKGBUILD](https://gist.github.com/arlllk/7001c521de601f01735af5ca440f03ae)を使用することも出来ます。 71 | 72 | [詳細はプロジェクトページを参照してください](https://github.com/arkane-systems/genie#usage) 73 | -------------------------------------------------------------------------------- /locale/ja-JP/README.md: -------------------------------------------------------------------------------- 1 | --- 2 | layout: default 3 | title: "日本語" 4 | parent: "Translations" 5 | description: "日本語版のホーム" 6 | permalink: /locale/ja-JP/ 7 | has_children: true 8 | --- 9 | 10 | # ArchWSL documentation 11 | [インストール方法](How-to-Setup.md) 12 | 13 | [使い方](How-to-Use.md) 14 | 15 | [既知の問題](Known-issues.md) 16 | 17 | [Languages](../Translations.md) 18 | -------------------------------------------------------------------------------- /locale/ja-JP/img/cert/1.install.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/wsldl-pg/ArchW-docs/0e149e961dcf62aab856d0ad299a9bc61887b41e/locale/ja-JP/img/cert/1.install.png -------------------------------------------------------------------------------- /locale/ja-JP/img/cert/2.to-localmachine.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/wsldl-pg/ArchW-docs/0e149e961dcf62aab856d0ad299a9bc61887b41e/locale/ja-JP/img/cert/2.to-localmachine.png -------------------------------------------------------------------------------- /locale/ja-JP/img/cert/3.to-following.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/wsldl-pg/ArchW-docs/0e149e961dcf62aab856d0ad299a9bc61887b41e/locale/ja-JP/img/cert/3.to-following.png -------------------------------------------------------------------------------- /locale/ja-JP/img/cert/4.to-rootstore.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/wsldl-pg/ArchW-docs/0e149e961dcf62aab856d0ad299a9bc61887b41e/locale/ja-JP/img/cert/4.to-rootstore.png -------------------------------------------------------------------------------- /locale/ko-KR/How-to-Setup.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "셋업하는법" 3 | parent: "한국어" 4 | grand_parent: "Translations" 5 | has_children: true 6 | --- 7 | # ArchWSL 셋업하기 8 | 9 | ## 요구사항 10 | 11 | * 윈도우 10 1709 또는 그 이상 12 | * WSL(Windows용 Linux 하위 시스템) 활성화됨 13 | 14 | ## 설치 과정 15 | 16 | ArchWSL을 설치하는 2가지 방법이 있습니다. 17 | 18 | ### 1: zip파일 설치 19 | 20 | 1. 설치 zip 파일을 [다운로드합니다](https://github.com/yuk7/ArchWSL/releases/latest) . 21 | 2. zip 파일에 있는 모든 파일들을 같은 디렉토리에 압축해제하십시오. 22 | 쓰기 권한이 있는 경로에 압축 해제 하십시오. 23 | 예를 들어, `C:\Program Files` 는 사용될 수 없습니다. 24 | 3. `Arch.exe` 를 실행해 루트 파일시스템을 압축해제하고 WSL에 등록하십시오. 프로세스는 자동입니다. 25 | 26 | 참고로, 실행파일의 이름은 WSL에서 등록되는 이름과 동일합니다. 27 | 이름을 변경하시면, 다중설치가 가능합니다. 28 | 29 | ### 2: appx 패키지 30 | 31 | 1. [`.appx` 와 `.cer` 를 다운로드하십시오](https://github.com/yuk7/ArchWSL/releases/latest) 32 | 2. `.cer` 파일을 기기의 "신뢰할 수 있는 루트 인증 기관" 에 설치하십시오. 33 | 추가적인 설명이 필요하시다면, [인증서 설치 가이드](Install-Certificate.md) 를 따라주십시오. 34 | 인증서 설치를 위해서는 관리자 권한이 필요합니다. 35 | 3. `.appx` 를 클릭해 설치하십시오. 36 | 37 | ## 설치 후에 셋업하기 38 | 39 | ### 루트 계정 비밀번호 설정하기 40 | 41 | ```shell 42 | >Arch.exe 43 | [root@PC-NAME]# passwd 44 | ``` 45 | 46 | ### 기본 유저 설정하기 47 | 48 | ArchWiki를 참고하십시오. 49 | [Sudo](https://wiki.archlinux.org/index.php/Sudo#Example_entries) 50 | 와 51 | [User and groups](https://wiki.archlinux.org/index.php/Users_and_groups) 페이지도 참고하십시오. 52 | 53 | ```shell 54 | >Arch.exe 55 | [root@PC-NAME]# echo "%wheel ALL=(ALL) ALL" > /etc/sudoers.d/wheel 56 | (sudoers 설정) 57 | 58 | [root@PC-NAME]# useradd -m -G wheel -s /bin/bash {username} 59 | (유저 추가) 60 | 61 | [root@PC-NAME]# passwd {username} 62 | ({username}의 비밀번호 설정) 63 | 64 | [root@PC-NAME]# exit 65 | 66 | >Arch.exe config --default-user {username} 67 | ({username}을 기본 유저로 설정) 68 | ``` 69 | 70 | 기본 유저가 변경되지 않았다면 71 | ([이슈 #7](https://github.com/yuk7/ArchWSL/issues/7)), 72 | 디바이스를 재시작하거나 LxssManager를 재시작하십시오. 73 | 74 | `LxssManager` 를 재시작하려면, 이 명령을 실행하십시오: 75 | 76 | ```batch 77 | net stop lxssmanager && net start lxssmanager 78 | ``` 79 | 80 | ### 키링 초기화 81 | 82 | 이 명령을 실행하여 키링 초기화를 하십시오. 83 | (pacman 사용을 위해서 필수적인 단계입니다.) 84 | 85 | ```shell 86 | >Arch.exe 87 | [user@PC-NAME]$ sudo pacman-key --init 88 | 89 | [user@PC-NAME]$ sudo pacman-key --populate 90 | 91 | [user@PC-NAME]$ sudo pacman -Syy archlinux-keyring 92 | ``` 93 | 94 | ### systemctl 설치하기(선택) 95 | 96 | WSL 은 systemd를 기본적으로 사용하지 않지만, 여러가지의 솔루션이 있습니다. 97 | [알려진 문제점](Known-issues.md#systemdsystemctl) 를 참고해주십시오. 98 | -------------------------------------------------------------------------------- /locale/ko-KR/How-to-Use.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "사용법" 3 | parent: "한국어" 4 | grand_parent: "Translations" 5 | --- 6 | # 사용법 (설치된 후) 7 | ## exe 사용법 8 | 9 | ``` 10 | 사용법 : 11 | <인수 없음> 12 | - 기본 설정으로 새로운 쉘을 엽니다. 13 | 14 | 15 | run 16 | - 현재 디렉토리에서 주어진 명령을 실행합니다. 17 | 18 | runp 19 | - 주어진 경로에서 명령을 실행합니다. 20 | 21 | config [setting [value]] 22 | - `--default-user `: 배포판의 기본 유저를 로 설정 23 | - `--default-uid `: 배포판의 기본 유저 uid를 로 설정 24 | - `--append-path `: 환경 변수 PATH 를 $PATH 에 추가하기 25 | - `--mount-drive `: 드라이브 마운트 켜기/끄기 26 | 27 | get [setting] 28 | - `--default-uid`: 배포판의 기본 uid 출력 29 | - `--append-path`: PATH를 $PATH에 추가했는지 확인하기 30 | - `--mount-drive`: 드라이브 마운트 설정 확인하기 31 | - `--lxguid`: 본 배포판의 WSL GUID 키 가져오기 32 | 33 | backup [contents] 34 | - `--tar`: backup.tar을 현재 디렉토리에 생성하기 35 | - `--reg`: 설정 레지스트리 파일을 현재 디렉토리에 생성하기 36 | 37 | clean 38 | - 설치를 제거합니다. 39 | 40 | help 41 | - 본 사용법 메시지를 출력합니다. 42 | ``` 43 | 44 | 45 | ## 명령 쉘 열기 46 | 47 | ``` 48 | >Arch.exe 49 | [root@PC-NAME user]# 50 | ``` 51 | 52 | ## 명령 하나 실행하고 끝내기 53 | 54 | ``` 55 | >Arch.exe run uname -r 56 | 4.4.0-43-Microsoft 57 | ``` 58 | 59 | ## 주어진 디렉토리에서 명령 실행하고 끝내기 60 | 61 | ``` 62 | >Arch.exe runp echo C:\Windows\System32\cmd.exe 63 | /mnt/c/Windows/System32/cmd.exe 64 | ``` 65 | 66 | ## 기본 사용자 바꾸기 (id 필수) 67 | 68 | ``` 69 | >Arch.exe config --default-user user 70 | 71 | >Arch.exe 72 | [user@PC-NAME dir]$ 73 | ``` 74 | 75 | 기본 유저가 바뀌지 않았으면, 디바이스를 재부팅하거나 LxssManager을 관리자 명령 프롬프트에서 재시작하십시오. 76 | ([issue #7](https://github.com/yuk7/ArchWSL/issues/7)) 77 | 78 | `LxssManager`를 재시작하려면, 이걸 실행하세요 : 79 | 80 | ```batch 81 | net stop lxssmanager && net start lxssmanager 82 | ``` 83 | 84 | ## 루트 파일시스템 백업하기 85 | 86 | 백업: 87 | 88 | ``` 89 | >Arch.exe backup 90 | ``` 91 | 92 | 백업된 tar 파일을 복구하거나 설치: 93 | 94 | ``` 95 | >Arch.exe install full/path/to/backup.tar 96 | ``` 97 | 98 | ## 설치 제거하기 99 | 100 | ``` 101 | >Arch.exe clean 102 | ``` 103 | -------------------------------------------------------------------------------- /locale/ko-KR/Install-Certificate.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "AppX 설치용 인증서 설치 가이드" 3 | parent: "셋업하는법" 4 | #nav_order: 5 | --- 6 | 7 | # AppX 설치용으로 8 | 9 | ArchWSL 은 마이크로소프트로부터 인증받은 소프트웨어가 아닙니다. 그러므로, `.appx`를 설치하려면, 10 | 인증서 사인을 수동으로 해야 합니다. 11 | 인증서는 반드시 디바이스의 "신뢰할 수 있는 루트 인증 기관"에 설치되어야 합니다. 12 | 13 | ## 설치 단계 14 | 15 | 1. .cer 파일을 더블클릭하고 "인증서 설치"를 누릅니다. 16 | 17 | ![screenshot1](img/cert/1.install.png) 18 | 19 | 2. "로컬 기기"를 선택하고 "다음"을 클릭합니다. 20 | 21 | ![screenshot2](img/cert/2.to-localmachine.png) 22 | 23 | 3. "~를 스토어에 설치하기" 를 선택하고 설치 경로로 들어갑니다. 24 | 25 | ![screenshot3](img/cert/3.to-following.png) 26 | 27 | 4. "신뢰할 수 잇는 루트 인증 기관"을 선택하고 "확인"을 누릅니다. 28 | 29 | ![screenshot4](img/cert/4.to-rootstore.png) 30 | 31 | 5. 끝 32 | -------------------------------------------------------------------------------- /locale/ko-KR/Known-issues.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "알려진 이슈들" 3 | parent: "한국어" 4 | grand_parent: "Translations" 5 | --- 6 | # 알려진 문제점 7 | 8 | ## 실행파일과 일반 사항 9 | [wsldl 문서](https://git.io/wsldl-doc) 를 참조해주십시오. 10 | 11 | ## glibc 12 | glibc의 새로운 버전은 WSL1과 호환성 오류가 있습니다. 13 | 14 | WSL2를 사용하세요(그리고 WSL1은 너무 느립니다.) 15 | 16 | ## fakeroot 17 | fakeroot은 SYSV IPC를 기본으로 사용중입니다. 18 | WSL1은 그걸 더이상 지원하지 않습니다. 19 | 20 | `fakeroot-tcp`[ᴬᵁᴿ](https://aur.archlinux.org/packages/fakeroot-tcp/) 를 사용해서 해결할 수 있습니다. (WSL2는 그런거 없으니까 제발 WSL2 쓰세요) 21 | 22 | [fakeroot-tcp-1.23-1-x86_64.pkg.tar.xz](https://github.com/yuk7/arch-prebuilt/releases/download/18082100/fakeroot-tcp-1.23-1-x86_64.pkg.tar.xz) 를 다운로드하고 ```pacman -U fakeroot-tcp-1.23-1-x86_64.pkg.tar.xz``` 를 실행하여 설치하십시오. 23 | 24 | ## Qt5 25 | qt >=5.10 라이브러리는 WSL1에서 작동하지 않습니다. 이건 WSL 자체의 문제점입니다.([Microsoft/WSL#3023](https://github.com/Microsoft/WSL/issues/3023) 을 참고하십시오.) 26 | 27 | 루트 권한으로 이 명령을 실행하십시오: 28 | ```strip --remove-section=.note.ABI-tag /usr/lib/libQt5Core.so.5``` 29 | 30 | ## MySQL 8/MariaDB 31 | MySQL >=8은 네이티브 AIO 인터페이스를 기본으로 사용합니다. WSL1은 기본으로 지원하지 않음으로, 수동으로 설정하십시오. 32 | /etc/my.cnf.d/server.cnf 에서 `innodb_use_native_aio=0` 를 `[mysqld]` 섹션으로 추가 편집하십시오. 33 | ``` 34 | [mysqld] 35 | innodb_use_native_aio=0 36 | ``` 37 | 38 | ## D-Bus 39 | Systemd D-Bus 데몬은 WSL1에서 작동하지 않습니다. 40 | `dbus-x11`[ᴬᵁᴿ](https://aur.archlinux.org/packages/dbus-x11/) 사용을 권장합니다. 41 | [dbus-x11-1.12.16-1-x86_64.pkg.tar.xz](https://github.com/yuk7/arch-prebuilt/releases/download/20051200/dbus-x11-1.12.16-1-x86_64.pkg.tar.xz) 를 다운로드하고 ```pacman -U dbus-x11-1.12.16-1-x86_64.pkg.tar.xz``` 를 실행하여 설치하십시오. 42 | 43 | D-Bus daemon을 시작하려면, 이걸 실행하십시오: 44 | ``` 45 | sudo mkdir /run/dbus -p 46 | sudo dbus-daemon --system 47 | ``` 48 | 49 | ## systemd/systemctl 50 | 51 | WSL 0.67.6 이상을 사용하는 경우(`wsl --version` 참조) systemd가 기본적으로 지원됩니다. 활성화하려면 `/etc/wsl.conf`를 편집한 다음 배포판을 다시 시작하십시오. 52 | ``` 53 | [boot] 54 | systemd=true 55 | ``` 56 | 57 | 이전 버전의 WSL을 사용하는 경우 systemctl 대체 스크립트나 bottle을 사용하십시오. 58 | 59 | ### WSL1 / WSL2 60 | systemctl 대체 스크립트를 사용할 수 있습니다. 61 | 그러나, 부분적으로만 호환됩니다. 62 | 63 | [systemd-altctl-1.4.4181-1-any.pkg.tar.xz](https://github.com/yuk7/arch-systemctl-alt/releases/download/1.4.4181-1/systemd-altctl-1.4.4181-1-any.pkg.tar.xz) 를 다운로드하고 ```pacman -U systemd-altctl-1.4.4181-1-any.pkg.tar.xz``` 를 실행하여 설치하십시오. 64 | 65 | ### WSL2 66 | systemd bottle "[subsystemctl](https://github.com/sorah/subsystemctl)", "[genie](https://github.com/arkane-systems/genie)", "[wsl-distrod](https://github.com/nullpo-head/wsl-distrod)" 또는 "[bottled-shell](https://github.com/lungothrin/bottled-shell)"를 사용할 수 있습니다. 67 | 68 | 앞에서 언급한 솔루션을 사용하면 systemd를 사용할 수 있습니다. 69 | 70 | #### subsystemctl 71 | [PKGBUILD](https://raw.githubusercontent.com/sorah/arch.sorah.jp/master/aur-sorah/PKGBUILDs/subsystemctl/PKGBUILD)를 다운로드하여 빌드할 수 있습니다. 72 | 73 | [사용 방법은 여기를 참조하세요.](https://github.com/sorah/subsystemctl#usage) 74 | 75 | #### genie 76 | [PKGBUILD](https://gist.github.com/arlllk/7001c521de601f01735af5ca440f03ae)다운로드하여 빌드할 수 있습니다. 77 | 78 | [사용 방법은 여기를 참조하세요.](https://github.com/arkane-systems/genie#usage) 79 | -------------------------------------------------------------------------------- /locale/ko-KR/README.md: -------------------------------------------------------------------------------- 1 | --- 2 | layout: default 3 | title: "한국어" 4 | parent: "Translations" 5 | description: "한국어 버전 홈" 6 | permalink: /locale/ko-KR/ 7 | has_children: true 8 | --- 9 | 10 | # ArchWSL documentation 11 | [셋업하기](How-to-Setup.md) 12 | 13 | [사용법](How-to-Use.md) 14 | 15 | [알려진 문제점](Known-issues.md) 16 | 17 | [Languages](../Translations.md) 18 | -------------------------------------------------------------------------------- /locale/ko-KR/img/cert/1.install.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/wsldl-pg/ArchW-docs/0e149e961dcf62aab856d0ad299a9bc61887b41e/locale/ko-KR/img/cert/1.install.png -------------------------------------------------------------------------------- /locale/ko-KR/img/cert/2.to-localmachine.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/wsldl-pg/ArchW-docs/0e149e961dcf62aab856d0ad299a9bc61887b41e/locale/ko-KR/img/cert/2.to-localmachine.png -------------------------------------------------------------------------------- /locale/ko-KR/img/cert/3.to-following.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/wsldl-pg/ArchW-docs/0e149e961dcf62aab856d0ad299a9bc61887b41e/locale/ko-KR/img/cert/3.to-following.png -------------------------------------------------------------------------------- /locale/ko-KR/img/cert/4.to-rootstore.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/wsldl-pg/ArchW-docs/0e149e961dcf62aab856d0ad299a9bc61887b41e/locale/ko-KR/img/cert/4.to-rootstore.png -------------------------------------------------------------------------------- /locale/pt-BR/How-to-Setup.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Como configurar" 3 | parent: "Português Brasileiro" 4 | grand_parent: "Translations" 5 | has_children: true 6 | --- 7 | # Como configurar o ArchWSL 8 | 9 | ## Requisitos 10 | 11 | * Windows 10 1709 Fall Creators Update 64 bits ou posterior. 12 | * O recurso Windows Subsystem for Linux estar ativado. 13 | 14 | ## Instruções de instalação 15 | 16 | Existem duas maneiras de instalar o ArchWSL. 17 | 18 | ### Método 1: arquivo zip 19 | 20 | 1. [Baixe](https://github.com/yuk7/ArchWSL/releases/latest) o zip do instalador. 21 | 2. Extraia todos os arquivos do arquivo zip para o mesmo diretório. 22 | Extraia para uma pasta que você tenha permissão de gravação. 23 | Por exemplo, `C:\Arquivos de Progamas` não pode ser usada porque o rootfs não pode ser modificado lá. 24 | 3. Execute `Arch.exe` para extrair o rootfs e registre no WSL 25 | 26 | Note que o nome do executável é o que é usado como o nome da instância WSL. 27 | Se você renomeá-lo, poderá ter várias instalações. 28 | 29 | ### Método 2: pacote appx 30 | 31 | 1. [Baixe o `.appx` e o `.cer`](https://github.com/yuk7/ArchWSL/releases/latest) 32 | 2. Instale o `.cer` no "Armazenamento de Autoridades de Certificação Confiáveis" da máquina local. 33 | Para obter detalhes, consulte a [página Instalar certificado](Install-Certificate.md). 34 | Você precisará de privilégios de administrador para instalar o certificado. 35 | 3. Instale o `.appx` 36 | 37 | ## Configuração após a instalação 38 | ### [Se você é um usuário do WSL1, você **deve** alterar o pacote glibc. Consulte Problemas conhecidos.](Known-issues.md#wsl1--wsl2) 39 | 40 | ### Configurando a senha de root 41 | 42 | ```shell 43 | >Arch.exe 44 | [root@NOME-PC]# passwd 45 | ``` 46 | 47 | ### Configurar o usuário padrão 48 | 49 | Veja 50 | [Sudo](https://wiki.archlinux.org/index.php/Sudo#Example_entries) 51 | e 52 | [Users and groups](https://wiki.archlinux.org/index.php/Users_and_groups) 53 | no ArchWiki 54 | 55 | ```shell 56 | >Arch.exe 57 | [root@NOME-PC]# echo "%wheel ALL=(ALL) ALL" > /etc/sudoers.d/wheel 58 | (configurar o arquivo sudoers.) 59 | 60 | [root@NOME-PC]# useradd -m -G wheel -s /bin/bash {usuário} 61 | (adicionar usuário) 62 | 63 | [root@NOME-PC]# passwd {usuário} 64 | (definir senha de usuário padrão) 65 | 66 | [root@NOME-PC]# exit 67 | 68 | >Arch.exe config --default-user {usuário} 69 | (configuração para usuário padrão) 70 | ``` 71 | 72 | Se o usuário padrão não foi alterado 73 | ([issue #7](https://github.com/yuk7/ArchWSL/issues/7)), 74 | reinicie o computador ou, alternativamente, reinicie o LxssManager em um prompt de 75 | comando de Administrador. 76 | 77 | Para reiniciar o `LxssManager`, execute isto: 78 | 79 | ```batch 80 | net stop lxssmanager && net start lxssmanager 81 | ``` 82 | 83 | ### Inicializar o chaveiro 84 | 85 | Execute estes comandos para inicializar o chaveiro. 86 | (Esta etapa é necessária para usar o pacman.) 87 | 88 | ```shell 89 | >Arch.exe 90 | [usuario@NOME-PC]$ sudo pacman-key --init 91 | 92 | [usuario@NOME-PC]$ sudo pacman-key --populate 93 | 94 | [usuario@NOME-PC]$ sudo pacman -Syy archlinux-keyring 95 | ``` 96 | 97 | ### Instalar o glibc corrigido (necessário no WSL1) 98 | O glibc do Arch é construído para o kernel Linux 4.4 e superior e não funciona com o WSL1. 99 | 100 | Os usuários do WSL1 **devem** sempre seguir as etapas em [Problemas conhecidos](Known-issues.md#wsl1--wsl2). 101 | 102 | ### Instalar uma alternativa para o systemctl (opcional) 103 | O WSL não tem suporte a systemd. No entanto, existem várias soluções. 104 | Consulte [Problemas conhecidos](Known-issues.md#systemdsystemctl). 105 | -------------------------------------------------------------------------------- /locale/pt-BR/How-to-Use.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Como usar" 3 | parent: "Português Brasileiro" 4 | grand_parent: "Translations" 5 | --- 6 | # Como usar (após a instalação do ArchWSL) 7 | 8 | ## Uso do exe 9 | 10 | ``` 11 | Uso: 12 | 13 | - Abre um novo shell com suas configurações padrão. 14 | 15 | run 16 | - Executa a linha de comando fornecida nessa instância. Herda o diretório atual. 17 | 18 | runp 19 | - Executa a linha de comando fornecida nessa instância após converter seu caminho. 20 | 21 | config [configuração [valor]] 22 | - `--default-user `: Define o usuário padrão desta instância para . 23 | - `--default-uid `: Define o uid de usuário padrão desta instância para . 24 | - `--append-path `: Ativa ou desativa a anexação do Windows PATH para $PATH 25 | - `--mount-drive `: Ativa ou desativa a unidades de montagem 26 | - `--wsl-version <1|2>`: Define a versão do WSL desta instância para <1 ou 2> 27 | - `--default-term `: Define o tipo padrão da janela do terminal. 28 | 29 | get [configuração] 30 | - `--default-uid`: Obtém o uid de usuário padrão nesta instância. 31 | - `--append-path`: Obtém o status true/false de anexação do Windows PATH para $PATH. 32 | - `--mount-drive`: Obtém o status true/false das unidades de montagem. 33 | - `--wsl-version`: Obtém a versão do WSL (1/2) desta instância. 34 | - `--default-term`: Obtém o tipo de terminal padrão deste lançador de instâncias. 35 | - `--lxguid`: Obtém a chave WSL GUID para esta instância. 36 | 37 | backup [conteúdo] 38 | - `--tar`: Gera backup.tar no diretório atual. 39 | - `--tgz`: Gera backup.tar.tar no diretório atual. 40 | - `--vhdx`: Gera backup.ext4.vhdx no diretório atual. (somente WSL2) 41 | - `--vhdxgz`: Gera backup.ext4.vhdx.gz no diretório atual. (somente WSL2) 42 | - `--reg`: Gera um arquivo de registro de configurações no diretório atual. 43 | 44 | clean 45 | - Desinstala essa instância. 46 | 47 | help 48 | - Imprime esta mensagem de uso. 49 | ``` 50 | 51 | 52 | ## Abrir um shell interativo 53 | 54 | ``` 55 | >Arch.exe 56 | [root@NOME-PC usuario]# 57 | ``` 58 | 59 | ## Executar um único comando e sair 60 | 61 | ``` 62 | >Arch.exe run uname -r 63 | 4.4.0-43-Microsoft 64 | ``` 65 | 66 | ## Executar um comando com tradução de caminho e sair 67 | 68 | ``` 69 | >Arch.exe runp echo C:\Windows\System32\cmd.exe 70 | /mnt/c/Windows/System32/cmd.exe 71 | ``` 72 | 73 | ## Alterar o usuário padrão (comando id necessário) 74 | 75 | ``` 76 | >Arch.exe config --default-user usuario 77 | 78 | >Arch.exe 79 | [usuario@NOME-PC dir]$ 80 | ``` 81 | 82 | Se o usuário padrão não foi alterado 83 | ([issue #7](https://github.com/yuk7/ArchWSL/issues/7)), 84 | reinicie o computador ou, alternativamente, reinicie o LxssManager em um prompt de 85 | comando de Administrador. 86 | 87 | Para reiniciar o `LxssManager`, execute isto: 88 | 89 | ```batch 90 | net stop lxssmanager && net start lxssmanager 91 | ``` 92 | 93 | ## Fazer backup do rootfs 94 | 95 | Fazer o backup: 96 | 97 | ``` 98 | >Arch.exe backup 99 | ``` 100 | 101 | Restaurar/instalar o tarball de backup: 102 | 103 | ``` 104 | >Arch.exe install caminho/completo/para/o/backup.tar.gz 105 | ``` 106 | 107 | Restaurar/instalar backup vhdx: 108 | ``` 109 | >Arch.exe install caminho/completo/para/o/backup.ext4.vhdx.gz 110 | ``` 111 | 112 | ## Desinstalar a instância 113 | 114 | ``` 115 | >Arch.exe clean 116 | ``` 117 | -------------------------------------------------------------------------------- /locale/pt-BR/Install-Certificate.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Instalar certificado para AppX 3 | parent: "Como configurar" 4 | #nav_order: 5 | --- 6 | 7 | # Instalar certificado para AppX 8 | 9 | ArchWSL não é aprovado pela Microsoft. Portanto, você precisará instalar um código 10 | assinando o certificado manualmente se você deseja instalar usando o pacote `.appx`. 11 | O certificado deve ser instalado no repositório de certificados "Pessoas Confiáveis" 12 | da máquina local. 13 | 14 | ## Instruções 15 | 16 | 1. Abra o arquivo .cer e clique em "Instalar Certificado". 17 | 18 | ![captura de tela 1](img/cert/1.install.png) 19 | 20 | 2. Selecione "Máquina Local" e Avançar. 21 | 22 | ![captura de tela 2](img/cert/2.to-localmachine.png) 23 | 24 | 3. Selecione "Colocar todos os certificados no repositório a seguir" e clique em Procurar para selecionar o destino da instalação. 25 | 26 | ![captura de tela 3](img/cert/3.to-following.png) 27 | 28 | 4. Selecione "Pessoas Confiáveis" e OK. 29 | 30 | ![captura de tela 4](img/cert/4.to-trustedpeople.png) 31 | 32 | 5. feito -------------------------------------------------------------------------------- /locale/pt-BR/Known-issues.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Problemas conhecidos" 3 | parent: "Português Brasileiro" 4 | grand_parent: "Translations" 5 | --- 6 | # Problemas conhecidos 7 | 8 | ## Iniciador e Comum 9 | Consulte a [documentação do wsldl](https://git.io/wsldl-doc). 10 | 11 | ## glibc 12 | O glibc padrão é otimizado para o novo kernel e usa syscall, que não é implementado no WSL1. 13 | 14 | Se você não usar glibc com um patch que não seja a linha principal, sua instância não será iniciada. 15 | 16 | Você pode usar o pacote `glibc-linux4`[ᴬᵁᴿ](https://aur.archlinux.org/packages/glibc-linux4) em vez disso. 17 | 18 | Você pode instalar a partir do repositório da comunidade archlinuxcn (pode atualizar automaticamente, recomendado) 19 | ``` 20 | echo '[archlinuxcn] 21 | Server = https://repo.archlinuxcn.org/$arch' >> /etc/pacman.conf 22 | sudo pacman -Syy && sudo pacman -S archlinuxcn-keyring && sudo pacman -S glibc-linux4 23 | ``` 24 | ou você pode instalar a partir com um auxiliar do AUR ("AUR helper") 25 | ``` 26 | yay -S glibc-linux4 27 | ``` 28 | 29 | ## fakeroot 30 | fakeroot está usando SYSV IPC por padrão, mas o WSL1 não o suporta agora. 31 | 32 | Você pode usar o pacote `fakeroot-tcp`[ᴬᵁᴿ](https://aur.archlinux.org/packages/fakeroot-tcp/) em vez disso. (WSL2 não precisa disso) 33 | 34 | Baixe [fakeroot-tcp-1.23-1-x86_64.pkg.tar.xz](https://github.com/yuk7/arch-prebuilt/releases/download/18082100/fakeroot-tcp-1.23-1-x86_64.pkg.tar.xz) e execute ```pacman -U fakeroot-tcp-1.23-1-x86_64.pkg.tar.xz``` para instalar. 35 | 36 | ## Qt5 37 | A biblioteca qt >=5.10 não funciona no WSL1. Este é um problema com o WSL. (Consulte [Microsoft/WSL#3023](https://github.com/Microsoft/WSL/issues/3023)) 38 | 39 | Execute esta linha na raiz: 40 | ```strip --remove-section=.note.ABI-tag /usr/lib/libQt5Core.so.5``` 41 | 42 | ## MySQL 8/MariaDB 43 | MySQL >=8 usa a interface AIO nativa por padrão. O WSL1 não tem suporte a ela, então você precisa configurá-la. 44 | Edite /etc/my.cnf.d/server.cnf para adicionar `innodb_use_native_aio=0` à seção `[mysqld]`. 45 | ``` 46 | [mysqld] 47 | innodb_use_native_aio=0 48 | ``` 49 | 50 | ## D-Bus 51 | O daemon Systemd D-Bus não funciona no WSL1. 52 | Recomendamos usar `dbus-x11`[ᴬᵁᴿ](https://aur.archlinux.org/packages/dbus-x11/). 53 | Baixe [dbus-x11-1.12.16-1-x86_64.pkg.tar.xz](https://github.com/yuk7/arch-prebuilt/releases/download/20051200/dbus-x11-1.12.16-1-x86_64.pkg.tar.xz) e execute ```pacman -U dbus-x11-1.12.16-1-x86_64.pkg.tar.xz``` para instalar. 54 | 55 | Para iniciar o daemon D-Bus, execute: 56 | ``` 57 | sudo mkdir /run/dbus -p 58 | sudo dbus-daemon --system 59 | ``` 60 | 61 | ## systemd/systemctl 62 | O WSL não oferece suporte ao systemd nativamente, portanto, recomendamos o uso de um script alternativo para systemctl ou bottle para aplicativos que o exigem. 63 | 64 | ### WSL1 / WSL2 65 | Você pode usar um script alternativo para systemctl. 66 | No entanto, isso é apenas parcialmente compatível. 67 | 68 | Baixe [systemd-altctl-1.4.4181-1-any.pkg.tar.xz](https://github.com/yuk7/arch-systemctl-alt/releases/download/1.4.4181-1/systemd-altctl-1.4.4181-1-any.pkg.tar.xz) e execute ```pacman -U systemd-altctl-1.4.4181-1-any.pkg.tar.xz``` para instalar. 69 | 70 | ### WSL2 71 | Você pode usar bottle de systemd "[subsystemctl](https://github.com/sorah/subsystemctl)", "[genie](https://github.com/arkane-systems/genie)", "[wsl-distrod](https://github.com/nullpo-head/wsl-distrod)" ou "[bottled-shell](https://github.com/lungothrin/bottled-shell)". 72 | 73 | O uso de qualquer uma das soluções mencionadas permitirá que você execute o systemd completamente. 74 | 75 | #### subsystemctl 76 | Você pode baixar o [PKGBUILD](https://raw.githubusercontent.com/sorah/arch.sorah.jp/master/aur-sorah/PKGBUILDs/subsystemctl/PKGBUILD) e compilá-lo. 77 | 78 | [Veja aqui como usá-lo.](https://github.com/sorah/subsystemctl#usage) 79 | 80 | #### genie 81 | Você pode usar os [PKGBUILDs daqui](https://gist.github.com/arlllk/7001c521de601f01735af5ca440f03ae). 82 | 83 | [Veja aqui como usá-lo.](https://github.com/arkane-systems/genie#usage) 84 | -------------------------------------------------------------------------------- /locale/pt-BR/README.md: -------------------------------------------------------------------------------- 1 | --- 2 | layout: default 3 | title: "Português Brasileiro" 4 | parent: "Translations" 5 | description: "O início do mundo" 6 | permalink: /locale/pt-BR/ 7 | has_children: true 8 | --- 9 | 10 | # Documentação do ArchWSL 11 | [Como configurar](How-to-Setup.md) 12 | 13 | [Como usar](How-to-Use.md) 14 | 15 | [Problemas conhecidos](Known-issues.md) 16 | 17 | [Traduções](../Translations.md) 18 | -------------------------------------------------------------------------------- /locale/pt-BR/img/cert/1.install.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/wsldl-pg/ArchW-docs/0e149e961dcf62aab856d0ad299a9bc61887b41e/locale/pt-BR/img/cert/1.install.png -------------------------------------------------------------------------------- /locale/pt-BR/img/cert/2.to-localmachine.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/wsldl-pg/ArchW-docs/0e149e961dcf62aab856d0ad299a9bc61887b41e/locale/pt-BR/img/cert/2.to-localmachine.png -------------------------------------------------------------------------------- /locale/pt-BR/img/cert/3.to-following.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/wsldl-pg/ArchW-docs/0e149e961dcf62aab856d0ad299a9bc61887b41e/locale/pt-BR/img/cert/3.to-following.png -------------------------------------------------------------------------------- /locale/pt-BR/img/cert/4.to-trustedpeople.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/wsldl-pg/ArchW-docs/0e149e961dcf62aab856d0ad299a9bc61887b41e/locale/pt-BR/img/cert/4.to-trustedpeople.png -------------------------------------------------------------------------------- /locale/zh-CN/How-to-Setup.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "如何安装" 3 | parent: "简体中文" 4 | grand_parent: "Translations" 5 | has_children: true 6 | --- 7 | # 如何安装及设置ArchWSL 8 | 9 | ## 系统需求 10 | 11 | * Windows 10 1709 秋季创意者更新或者更高版本 12 | * 开启 `适用于 Linux 的 Windows 子系统` 功能 13 | 14 | ## 安装方法 15 | 16 | 安装ArchWSL有两种方法. 17 | 18 | 19 | 20 | ### 方法 1：zip 文件 21 | 1. 下载 [[GH](https://github.com/yuk7/ArchWSL/releases/latest)/[镜像](https://gitee.com/yuk7/archwsl-mirror)] zip 安装包。 22 | 2. 解压缩 zip 文件中的全部内容到相同的目录。 23 | 请解压到一个你拥有改写权限的目录。 24 | 例如， `C:\Program Files` 就不应该被使用，因为rootfs在这里不能被修改 25 | 3. 运行 `Arch.exe` 来提取 rootfs 并且配置注册表到WSL。 26 | 27 | 另外，EXE 文件的名称会同时用作你的 WSL 实例名称。如果你重命名这个exe文件，你将会进行拥有多个不同的 ArchWSL 并且互不冲突。 28 | 29 | ### 方法 2：appx 包 30 | 1. 从 [[GH](https://github.com/yuk7/ArchWSL/releases/latest)/[镜像](https://gitee.com/yuk7/archwsl-mirror)] 下载发布的 .appx 和 .cer 文件。 31 | 32 | 2. 安装 .cer 文件到 “本地计算机” 的 “受信任的根证书颁发机构”。 33 | 更多详情，请查看对应[文档页面](https://wsldl-pg.github.io/ArchW-docs/locale/zh-CN/Install-Certificate/)。 34 | 3. 双击安装 appx 文件。 35 | 36 | ## 完成安装后的操作 37 | ### [如果你使用 WSL1 ，你将**必须**修改一下 glibc 包。更多详情，请查看已知问题章节。](Known-issues.md#wsl1--wsl2) 38 | 39 | ### 设置Root密码 40 | 41 | ```shell 42 | >Arch.exe 43 | [root@PC-NAME]# passwd 44 | ``` 45 | 46 | ### 设置默认用户 47 | 48 | 参考 ArchWiki 的 49 | [Sudo](https://wiki.archlinux.org/index.php/Sudo#Example_entries) 50 | 和 51 | [User and groups](https://wiki.archlinux.org/index.php/Users_and_groups) 页。 52 | 53 | ```shell 54 | >Arch.exe 55 | [root@PC-NAME]# echo "%wheel ALL=(ALL) ALL" > /etc/sudoers.d/wheel 56 | (设置 sudoers 文件。) 57 | 58 | [root@PC-NAME]# useradd -m -G wheel -s /bin/bash {username} 59 | (添加用户) 60 | 61 | [root@PC-NAME]# passwd {username} 62 | (设置默认用户密码) 63 | 64 | [root@PC-NAME]# exit 65 | 66 | >Arch.exe config --default-user {username} 67 | (设置默认用户) 68 | ``` 69 | 70 | 如果默认用户密码被更改 71 | ([issue #7](https://github.com/yuk7/ArchWSL/issues/7)), 72 | 请重启电脑或者用管理员CMD重启LxssManager。 73 | 74 | 要重启 `LxssManager`, 请运行： 75 | 76 | ```batch 77 | net stop lxssmanager && net start lxssmanager 78 | ``` 79 | 80 | ### 初始化密钥环（keyring） 81 | 82 | 请执行这些命令以初始化密钥环（keyring）。 83 | (必须执行此步骤才可以使用 Pacman) 84 | 85 | ```shell 86 | >Arch.exe 87 | [user@PC-NAME]$ sudo pacman-key --init 88 | 89 | [user@PC-NAME]$ sudo pacman-key --populate 90 | 91 | [user@PC-NAME]$ sudo pacman -Syy archlinux-keyring 92 | ``` 93 | 94 | ### 安装修改版 GLibc (WSL1 环境下必需) 95 | Arch Linux 的官方 glibc 包是为新版内核（4.4以上版本）设计的，并且使用了未在 WSL1 被实现的系统调用。 96 | 97 | 因此，如果你不使用打过 Patch 的 Glibc 包，你的实例会完全开不起来。 98 | 99 | WSL1 用户 **必须** 跟着[这些](Known-issues.md#wsl1--wsl2)步骤修改 GLibc 后才可使用。 100 | 101 | ### 安装 systemctl 替代品（可选） 102 | 103 | WSL 并不支持 systemd，但是也有一些解决方案。 104 | 可以查看 [已知问题](Known-issues.md#systemdsystemctl)。 105 | -------------------------------------------------------------------------------- /locale/zh-CN/How-to-Use.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "如何使用" 3 | parent: "简体中文" 4 | grand_parent: "Translations" 5 | --- 6 | # 如何使用 (ArchWSL 安装以后) 7 | 8 | ## exe 用法 9 | 10 | ```shell 11 | 用法 : 12 | <无参数> 13 | - 以你的默认设置打开一个新的Shell。 14 | 15 | run <命令行> 16 | - 在此实例中运行你所给出的命令，继承当前Shell的所在目录。 17 | 18 | runp <命令行 (包含 windows 路径)> 19 | - 在此实例里运行转译过的命令行。 20 | 21 | config [setting [值]] 22 | - `--default-user <用户>`: 设定此实例的默认用户到 <用户>。 23 | - `--default-uid `: 设定此实例的默认用户 UID 到 。 24 | - `--append-path `: 加入 Windows PATH 到 $PATH 的开关。 25 | - `--mount-drive `: 挂载驱动器的开关。 26 | - `--default-term `: 设置默认的终端窗口样式。 27 | 28 | get [setting] 29 | - `--default-uid`: 输出此实例的默认用户UID。 30 | - `--append-path`: 输出”加入 Windows PATH 到 $PATH“的开关状态。 31 | - `--mount-drive`: 输出”挂载驱动器”的开关状态。 32 | - `--wsl-version`: 输出此实例的WSL版本（1/2）。 33 | - `--default-term`: 输出此实例启动器的默认终端样式。 34 | - `--lxguid`: 输出此实例的 WSL GUID key。 35 | 36 | backup [contents] 37 | - `--tar`: 输出 backup.tar 到当前目录。 38 | - `--reg`: 输出设置注册表文件到当前目录。 39 | 40 | clean 41 | - 卸载此实例。 42 | 43 | help 44 | - 显示此帮助信息。 45 | ``` 46 | 47 | ## 打开默认 Shell 48 | 49 | ```shell 50 | >Arch.exe 51 | [root@PC-NAME user]# 52 | ``` 53 | 54 | ## 立刻运行一个命令后退出 55 | 56 | ```shell 57 | >Arch.exe run uname -r 58 | 4.4.0-43-Microsoft 59 | ``` 60 | 61 | ## 运行一个命令（转译路径）后退出 62 | 63 | ```shell 64 | >Arch.exe runp echo C:\Windows\System32\cmd.exe 65 | /mnt/c/Windows/System32/cmd.exe 66 | ``` 67 | 68 | ## 更改默认用户（需要 ID 命令） 69 | 70 | ```shell 71 | >Arch.exe config --default-user 用户 72 | 73 | >Arch.exe 74 | [user@PC-NAME dir]$ 75 | ``` 76 | 77 | 若是默认用户未被更改 78 | ([issue #7](https://github.com/yuk7/ArchWSL/issues/7)), 79 | 请重启电脑或者重启 LxssManager 服务。 80 | 81 | 若要重启 `LxssManager`, 在管理员命令提示符中运行： 82 | 83 | ```batch 84 | net stop lxssmanager && net start lxssmanager 85 | ``` 86 | 87 | ## 备份 Rootfs 88 | 89 | 备份: 90 | 91 | ```shell 92 | >Arch.exe backup 93 | ``` 94 | 95 | 还原备份文件： 96 | 97 | ```shell 98 | >Arch.exe install full/path/to/backup.tar 99 | ``` 100 | 101 | ## 卸载实例 102 | 103 | ```shell 104 | >Arch.exe clean 105 | ``` 106 | -------------------------------------------------------------------------------- /locale/zh-CN/Install-Certificate.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 安装 AppX 所用的证书 3 | parent: "如何安装" 4 | #nav_order: 5 | --- 6 | 7 | # 安装 AppX 的证书 8 | 9 | ArchWSL 并不是 Microsoft 开发的。因此，你必须手动安装 10 | 一个代码签名证书才能正常使用 `.appx` 包。 11 | 这个证书需要被安装到本地计算机的“受信任人”存储区。 12 | 13 | ## 第一步 14 | 15 | 1. 打开 .cer 文件，然后点击“安装证书”。 16 | 17 | ![screenshot1](img/cert/1.install.png) 18 | 19 | 2. 选择“本地计算机”，然后下一步。 20 | 21 | ![screenshot2](img/cert/2.to-localmachine.png) 22 | 23 | 3. 选择 “将所有的证书都放入下列存储”，然后点击“浏览”选择安装目标。 24 | 25 | ![screenshot3](img/cert/3.to-following.png) 26 | 27 | 4. 现在选择“受信任人”。完成后点击确定。 28 | 29 | ![screenshot4](img/cert/4.to-trustedpeople.png) 30 | 31 | 5. 安装完成！ 32 | -------------------------------------------------------------------------------- /locale/zh-CN/Known-issues.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "已知问题" 3 | parent: "简体中文" 4 | grand_parent: "Translations" 5 | --- 6 | # 已知问题 7 | 8 | ## 快捷方式 9 | 10 | 请查看 [wsldl 的文档](https://git.io/wsldl-doc)。 11 | 12 | ## glibc 13 | Arch 默认的 Glibc 包是为新版本 Linux 内核的 syscall 设计的，而 WSL1 并不支持它们。 14 | 15 | 因此，如果你不使用打过 Patch 的 Glibc 包，你的实例会完全开不起来。 16 | 17 | 建议使用 AUR 中的 `glibc-linux4`[ᴬᵁᴿ](https://aur.archlinux.org/packages/glibc-linux4) 包。 18 | 19 | 建议从 archlinuxcn 社区仓库安装此包，以方便自动更新。 20 | ``` 21 | echo '[archlinuxcn] 22 | Server = https://repo.archlinuxcn.org/$arch' >> /etc/pacman.conf 23 | sudo pacman -Syy && sudo pacman -S archlinuxcn-keyring && sudo pacman -S glibc-linux4 24 | ``` 25 | 当然，你也可以直接使用 AUR 助手安装。 26 | ``` 27 | yay -S glibc-linux4 28 | ``` 29 | 30 | ## fakeroot 31 | 32 | fakeroot 默认使用 SYSV IPC， 33 | 但是 WSL1 目前还不支持它。 34 | 35 | 你可以转而使用 `fakeroot-tcp`[ᴬᵁᴿ](https://aur.archlinux.org/packages/fakeroot-tcp/) 包。 (WSL2 无此问题) 36 | 37 | 下载 [fakeroot-tcp-1.23-1-x86_64.pkg.tar.xz](https://github.com/yuk7/arch-prebuilt/releases/download/18082100/fakeroot-tcp-1.23-1-x86_64.pkg.tar.xz) 然后运行 `pacman -U fakeroot-tcp-1.23-1-x86_64.pkg.tar.xz` 以安装。 38 | 39 | ## Qt5 40 | 41 | qt >=5.10 库在 WSL1 不能使用，这是 WSL 的问题。(在 [Microsoft/WSL#3023](https://github.com/Microsoft/WSL/issues/3023)) 42 | 43 | 请以 Root 执行这个： 44 | `strip --remove-section=.note.ABI-tag /usr/lib/libQt5Core.so.5` 45 | 46 | ## MySQL 8/MariaDB 47 | 48 | MySQL >=8 默认会使用使用原版的 AIO interface。WSL1 并不兼容它，因此你必须手动配置它。 49 | 编辑 `/etc/my.cnf.d/server.cnf` ，增加 `innodb_use_native_aio=0` 到 `[mysqld]` 。 50 | 51 | ```text 52 | [mysqld] 53 | innodb_use_native_aio=0 54 | ``` 55 | 56 | ## D-Bus 57 | 58 | systemd D-Bus 守护进程在 WSL1 不能使用。 59 | 我建议使用 `dbus-x11`[ᴬᵁᴿ](https://aur.archlinux.org/packages/dbus-x11/)。 60 | 下载 [dbus-x11-1.12.16-1-x86_64.pkg.tar.xz](https://github.com/yuk7/arch-prebuilt/releases/download/20051200/dbus-x11-1.12.16-1-x86_64.pkg.tar.xz) 并运行 `pacman -U dbus-x11-1.12.16-1-x86_64.pkg.tar.xz` 以安装。 61 | 62 | 要启动 D-Bus 守护进程，运行： 63 | 64 | ```bash 65 | sudo mkdir /run/dbus -p 66 | sudo dbus-daemon --system 67 | ``` 68 | 69 | ## systemd/systemctl 70 | 71 | WSL 并没有 systemd 的原生支持。 72 | 如果你需要使用依赖 systemd 支持的程序，我们建议使用替代脚本或容器。 73 | 74 | ### WSL1 / WSL2 75 | 76 | 你可以用 systemctl 替代脚本， 77 | 不过它只能部分兼容 systemctl。 78 | 79 | 下载 [systemd-altctl-1.4.4181-1-any.pkg.tar.xz](https://github.com/yuk7/arch-systemctl-alt/releases/download/1.4.4181-1/systemd-altctl-1.4.4181-1-any.pkg.tar.xz) 然后运行 `pacman -U systemd-altctl-1.4.4181-1-any.pkg.tar.xz` 以安装。 80 | 81 | ### WSL2 82 | 83 | 你可以使用 systemd 容器 [subsystemctl](https://github.com/sorah/subsystemctl) 或是 [genie](https://github.com/arkane-systems/genie)。 84 | 85 | 使用它们，你就可以使用完整的 systemd 了。 86 | 87 | #### subsystemctl 88 | 89 | 你可以下载 [PKGBUILD](https://raw.githubusercontent.com/sorah/arch.sorah.jp/master/aur-sorah/PKGBUILDs/subsystemctl/PKGBUILD) 然后构建它。 90 | 91 | [读这里了解更多信息。](https://github.com/sorah/subsystemctl#usage) 92 | 93 | #### genie 94 | 95 | 你可以下载 [这里的 PKGBUILDs](https://gist.github.com/arlllk/7001c521de601f01735af5ca440f03ae). 96 | 97 | [读这里了解更多信息。](https://github.com/arkane-systems/genie#usage) 98 | 99 | #### Intel 显卡 100 | 101 | ArchWSL 默认可能无法正常加载 Intel WSL 驱动，这会导致无法在 Intel 显卡上使用 D3D12 驱动程序。 102 | 103 | 导致这个问题的原因是 Intel WSL 驱动文件链接了 ArchLinux 并不存在的库文件，你可以手动修复它们使其正常工作。 104 | 105 | 你需要先使用 `ldd` 查看它们链接了那些库，例如: `ldd /usr/lib/wsl/drivers/iigd_dch_d.inf_amd64_49b17bc90a910771/*.so`，然后查找标记为 `not found` 的库。接着查看 ArchLinux 软件包仓库是否有对应的包，如果有，安装它们，问题或许就解决了。如果在软件包仓库找不到对应的库文件，那可能是库文件的版本后缀不一样，比如 `libedit.so.0.0.68` 和 `libedit.so.2`，这时你可以试着为其创建一个指向现有版本的软链接。 106 | 107 | Issue: [#308](https://github.com/yuk7/ArchWSL/issues/308) 108 | -------------------------------------------------------------------------------- /locale/zh-CN/README.md: -------------------------------------------------------------------------------- 1 | --- 2 | layout: default 3 | title: "简体中文" 4 | parent: "Translations" 5 | description: "简体中文的主页" 6 | permalink: /locale/zh-CN/ 7 | has_children: true 8 | --- 9 | 10 | # ArchWSL 文档 11 | 12 | [如何安装](How-to-Setup.md) 13 | 14 | [如何使用](How-to-Use.md) 15 | 16 | [已知问题](Known-issues.md) 17 | 18 | [回到翻译列表](../Translations.md) 19 | -------------------------------------------------------------------------------- /locale/zh-CN/img/cert/1.install.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/wsldl-pg/ArchW-docs/0e149e961dcf62aab856d0ad299a9bc61887b41e/locale/zh-CN/img/cert/1.install.png -------------------------------------------------------------------------------- /locale/zh-CN/img/cert/2.to-localmachine.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/wsldl-pg/ArchW-docs/0e149e961dcf62aab856d0ad299a9bc61887b41e/locale/zh-CN/img/cert/2.to-localmachine.png -------------------------------------------------------------------------------- /locale/zh-CN/img/cert/3.to-following.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/wsldl-pg/ArchW-docs/0e149e961dcf62aab856d0ad299a9bc61887b41e/locale/zh-CN/img/cert/3.to-following.png -------------------------------------------------------------------------------- /locale/zh-CN/img/cert/4.to-trustedpeople.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/wsldl-pg/ArchW-docs/0e149e961dcf62aab856d0ad299a9bc61887b41e/locale/zh-CN/img/cert/4.to-trustedpeople.png -------------------------------------------------------------------------------- /locale/zh-TW/How-to-Setup.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "如何安裝" 3 | parent: "繁體中文" 4 | grand_parent: "Translations" 5 | has_children: true 6 | --- 7 | # 如何安裝 8 | 9 | ## 系統需求 10 | 11 | * Windows 10 1709 秋季創作者更新或者更高版本 12 | * 開啟 `適用於 Linux 的 Windows 子系統` 功能 13 | 14 | ## 安裝方法 15 | 16 | 有兩種方法安裝 ArchWSL. 17 | 18 | 19 | 20 | ### 方法 1：zip 檔案 21 | 1. 下載 [[GH](https://github.com/yuk7/ArchWSL/releases/latest) / [鏡像](https://gitee.com/yuk7/archwsl-mirror)] zip 安裝包。 22 | 2. 解壓縮 zip 檔案中的全部內容到相同的目錄。 23 | 請解壓到一個你擁有寫許可權的目錄。 24 | 例如， `C:\Program Files` 就不該被使用。 25 | 3. 執行 `Arch.exe` 來安裝 rootfs 和註冊表配置。 26 | 27 | 另外，EXE 檔案的名稱會同時用作你的 WSL 實例名稱。 28 | 29 | 也就是說，如果複製多個 EXE 檔案，並重命名成不同的名稱，你就同時擁有了多個不同的 ArchWSL 並且互不衝突。 30 | 31 | ### 方法 2：appx 包 32 | 1. 從 [[GH](https://github.com/yuk7/ArchWSL/releases/latest) / [鏡像](https://gitee.com/yuk7/archwsl-mirror)] 下載發佈的 .appx 和 .cer 檔案。 33 | 34 | 2. 安裝 .cer 檔案到 「本機電腦」 的 「受信任的根憑證授權單位」。 35 | 更多詳情，請 [檢視對應的文件頁面](Install-Certificate.md)。 36 | 3. 雙擊安裝 appx 檔案。 37 | 38 | ## 完成安裝後的操作 39 | ### 若你使用 WSL1 ，你將**必須**修改一下 glibc 包。更多詳情，請 [檢視已知問題章節](Known-issues.md#wsl1--wsl2)。 40 | 41 | ### 設定Root密碼 42 | 43 | ```shell 44 | >Arch.exe 45 | [root@PC-NAME]# passwd 46 | ``` 47 | 48 | ### 設定預設使用者 49 | 50 | 參考 ArchWiki 的 51 | [Sudo](https://wiki.archlinux.org/index.php/Sudo#Example_entries) 52 | 和 53 | [User and groups](https://wiki.archlinux.org/index.php/Users_and_groups) 頁。 54 | 55 | ```shell 56 | >Arch.exe 57 | [root@PC-NAME]# echo "%wheel ALL=(ALL) ALL" > /etc/sudoers.d/wheel 58 | (設定 sudoers 檔案。) 59 | 60 | [root@PC-NAME]# useradd -m -G wheel -s /bin/bash {username} 61 | (新增使用者) 62 | 63 | [root@PC-NAME]# passwd {username} 64 | (設定預設使用者密碼) 65 | 66 | [root@PC-NAME]# exit 67 | 68 | >Arch.exe config --default-user {username} 69 | (設定預設使用者) 70 | ``` 71 | 72 | 如果預設使用者密碼被更改 73 | ([issue #7](https://github.com/yuk7/ArchWSL/issues/7)), 74 | 請重啟電腦或者用管理員CMD重啟LxssManager。 75 | 76 | 要重啟 `LxssManager`, 請執行： 77 | 78 | ```batch 79 | net stop lxssmanager && net start lxssmanager 80 | ``` 81 | 82 | ### 初始化金鑰環（keyring） 83 | 84 | 請執行這些命令以初始化金鑰環（keyring）。 85 | (必須執行此步驟才可以使用 Pacman) 86 | 87 | ```shell 88 | >Arch.exe 89 | [user@PC-NAME]$ sudo pacman-key --init 90 | 91 | [user@PC-NAME]$ sudo pacman-key --populate 92 | 93 | [user@PC-NAME]$ sudo pacman -Syy archlinux-keyring 94 | ``` 95 | 96 | ### 安裝修改版 glibc (WSL1 環境下必需) 97 | Arch 官方的 glibc 包是為新版內核（4.4以上版本）設計的，並且使用了未在 WSL1 被實現的系統呼叫。 98 | 99 | 因此，如果你不使用打過 patch 的 glibc 包，你的實例會完全開不起來。 100 | 101 | WSL1 使用者 **必須** 跟著 [這些步驟](Known-issues.md#wsl1--wsl2) 修改 glibc 後才可使用。 102 | 103 | ### 安裝 systemctl 替代品（可選） 104 | 105 | WSL 並不支援 systemd，但是也有一些解決方案。 106 | 可以 [檢視已知問題](Known-issues.md#systemdsystemctl)。 107 | -------------------------------------------------------------------------------- /locale/zh-TW/How-to-Use.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "如何使用" 3 | parent: "繁體中文" 4 | grand_parent: "Translations" 5 | --- 6 | # 如何使用 (ArchWSL 安裝以後) 7 | 8 | ## exe 用法 9 | 10 | ```shell 11 | 用法 : 12 | <無參數> 13 | - 以你的預設設定打開一個新的 Shell。 14 | 15 | run <命令列> 16 | - 在此實例中執行你所給出的命令，繼承當前Shell的所在目錄。 17 | 18 | runp <命令列 (包含 windows 路徑)> 19 | - 在此實例里執行轉譯過的命令列。 20 | 21 | config [setting [值]] 22 | - `--default-user <使用者>`: 設定此實例的預設使用者到 <使用者>。 23 | - `--default-uid `: 設定此實例的預設使用者 UID 到 。 24 | - `--append-path `: 加入 Windows PATH 到 $PATH 的開關。 25 | - `--mount-drive `: 掛載驅動器的開關。 26 | - `--default-term `: 設定預設的終端視窗樣式。 27 | 28 | get [setting] 29 | - `--default-uid`: 輸出此實例的預設使用者UID。 30 | - `--append-path`: 輸出「加入 Windows PATH 到 $PATH」的開關狀態。 31 | - `--mount-drive`: 輸出「掛載驅動器」的開關狀態。 32 | - `--wsl-version`: 輸出此實例的WSL版本（1/2）。 33 | - `--default-term`: 輸出此實例啟動器的預設終端樣式。 34 | - `--lxguid`: 輸出此實例的 WSL GUID key。 35 | 36 | backup [contents] 37 | - `--tar`: 輸出 backup.tar 到目前目錄。 38 | - `--reg`: 輸出設定註冊表檔案到目前目錄。 39 | 40 | clean 41 | - 解除安裝此實例。 42 | 43 | help 44 | - 顯示此幫助資訊。 45 | ``` 46 | 47 | ## 打開預設 Shell 48 | 49 | ```shell 50 | >Arch.exe 51 | [root@PC-NAME user]# 52 | ``` 53 | 54 | ## 立刻執行一個命令後退出 55 | 56 | ```shell 57 | >Arch.exe run uname -r 58 | 4.4.0-43-Microsoft 59 | ``` 60 | 61 | ## 執行一個命令（轉譯路徑）後退出 62 | 63 | ```shell 64 | >Arch.exe runp echo C:\Windows\System32\cmd.exe 65 | /mnt/c/Windows/System32/cmd.exe 66 | ``` 67 | 68 | ## 更改預設使用者（需要 ID 命令） 69 | 70 | ```shell 71 | >Arch.exe config --default-user 使用者 72 | 73 | >Arch.exe 74 | [user@PC-NAME dir]$ 75 | ``` 76 | 77 | 若是預設使用者未被更改 78 | ([issue #7](https://github.com/yuk7/ArchWSL/issues/7)), 79 | 請重啟電腦或者重啟 LxssManager 服務。 80 | 81 | 若要重啟 `LxssManager`, 在管理員命令提示符中執行： 82 | 83 | ```batch 84 | net stop lxssmanager && net start lxssmanager 85 | ``` 86 | 87 | ## 備份 Rootfs 88 | 89 | 備份: 90 | 91 | ```shell 92 | >Arch.exe backup 93 | ``` 94 | 95 | 還原備份檔案： 96 | 97 | ```shell 98 | >Arch.exe install full/path/to/backup.tar 99 | ``` 100 | 101 | ## 解除安裝實例 102 | 103 | ```shell 104 | >Arch.exe clean 105 | ``` 106 | -------------------------------------------------------------------------------- /locale/zh-TW/Install-Certificate.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 安裝 AppX 所用的憑證 3 | parent: "如何安裝" 4 | #nav_order: 5 | --- 6 | 7 | # 安裝 AppX 的憑證 8 | 9 | ArchWSL 並不是 Microsoft 開發的。因此，你必須手動安裝一個代碼簽章憑證才能正常使用 `.appx` 包。 10 | 這個憑證需要被安裝到本機電腦的「受信任人」儲存區。 11 | 12 | ## 第一步 13 | 14 | 1. 打開 .cer 檔案，然後點選「安裝憑證」。 15 | 16 | ![screenshot1](img/cert/1.install.png) 17 | 18 | 2. 選擇「本機電腦」，然後下一步。 19 | 20 | ![screenshot2](img/cert/2.to-localmachine.png) 21 | 22 | 3. 選擇 「將所有憑證放入以下的存放區」，然後點選「瀏覽」選擇安裝目標。 23 | 24 | ![screenshot3](img/cert/3.to-following.png) 25 | 26 | 4. 現在選擇「受信任的人」。完成後點選確定。 27 | 28 | ![screenshot4](img/cert/4.to-trustedpeople.png) 29 | 30 | 5. 安裝完成！ 31 | -------------------------------------------------------------------------------- /locale/zh-TW/Known-issues.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "已知問題" 3 | parent: "繁體中文" 4 | grand_parent: "Translations" 5 | --- 6 | # 已知問題 7 | 8 | ## 快捷方式 9 | 10 | 請 [檢視 wsldl 的文件](https://git.io/wsldl-doc)。 11 | 12 | ## glibc 13 | Arch 預設的 glibc 包是為新版本 Linux 內核的 syscall 設計的，而 WSL1 並不支援它們。 14 | 15 | 因此，如果你不使用打過 patch 的 glibc 包，你的實例會完全開不起來。 16 | 17 | 你可以使用 AUR 中的 `glibc-linux4`[ᴬᵁᴿ](https://aur.archlinux.org/packages/glibc-linux4) 包。 18 | 19 | 你可以從 archlinuxcn 社區倉庫安裝此包，以方便自動更新。 20 | ``` 21 | echo '[archlinuxcn] 22 | Server = https://repo.archlinuxcn.org/$arch' >> /etc/pacman.conf 23 | sudo pacman -Syy && sudo pacman -S archlinuxcn-keyring && sudo pacman -S glibc-linux4 24 | ``` 25 | 當然，你也可以直接使用 AUR helper 安裝。 26 | ``` 27 | yay -S glibc-linux4 28 | ``` 29 | 30 | ## fakeroot 31 | 32 | fakeroot 預設使用 SYSV IPC， 33 | 但是 WSL1 目前還不支援它。 34 | 35 | 你可以轉而使用 `fakeroot-tcp`[ᴬᵁᴿ](https://aur.archlinux.org/packages/fakeroot-tcp) 包。 (WSL2 無此問題) 36 | 37 | 下載 [fakeroot-tcp-1.23-1-x86_64.pkg.tar.xz](https://github.com/yuk7/arch-prebuilt/releases/download/18082100/fakeroot-tcp-1.23-1-x86_64.pkg.tar.xz) 然後執行 `pacman -U fakeroot-tcp-1.23-1-x86_64.pkg.tar.xz` 以安裝。 38 | 39 | ## Qt5 40 | 41 | qt >=5.10 庫在 WSL1 不能使用，這是 WSL 的問題。(在 [Microsoft/WSL#3023](https://github.com/Microsoft/WSL/issues/3023)) 42 | 43 | 請以 root 執行這個： 44 | `strip --remove-section=.note.ABI-tag /usr/lib/libQt5Core.so.5` 45 | 46 | ## MySQL 8/MariaDB 47 | 48 | MySQL >=8 預設會使用使用原版的 AIO interface。WSL1 並不相容它，因此你必須手動配置它。 49 | 編輯 `/etc/my.cnf.d/server.cnf` ，增加 `innodb_use_native_aio=0` 到 `[mysqld]` 。 50 | 51 | ```text 52 | [mysqld] 53 | innodb_use_native_aio=0 54 | ``` 55 | 56 | ## D-Bus 57 | 58 | systemd D-Bus 守護程序在 WSL1 不能使用。 59 | 我建議使用 `dbus-x11`[ᴬᵁᴿ](https://aur.archlinux.org/packages/dbus-x11/)。 60 | 下載 [dbus-x11-1.12.16-1-x86_64.pkg.tar.xz](https://github.com/yuk7/arch-prebuilt/releases/download/20051200/dbus-x11-1.12.16-1-x86_64.pkg.tar.xz) 並執行 `pacman -U dbus-x11-1.12.16-1-x86_64.pkg.tar.xz` 以安裝。 61 | 62 | 要啟動 D-Bus 守護程序，執行： 63 | 64 | ```bash 65 | sudo mkdir /run/dbus -p 66 | sudo dbus-daemon --system 67 | ``` 68 | 69 | ## systemd/systemctl 70 | 71 | WSL 並沒有 systemd 的原生支援。 72 | 如果你需要使用依賴 systemd 支援的程式，我們建議使用替代指令碼或容器。 73 | 74 | ### WSL1 / WSL2 75 | 76 | 你可以用 systemctl 替代指令碼， 77 | 不過它只能部分相容 systemctl。 78 | 79 | 下載 [systemd-altctl-1.4.4181-1-any.pkg.tar.xz](https://github.com/yuk7/arch-systemctl-alt/releases/download/1.4.4181-1/systemd-altctl-1.4.4181-1-any.pkg.tar.xz) 然後執行 `pacman -U systemd-altctl-1.4.4181-1-any.pkg.tar.xz` 以安裝。 80 | 81 | ### WSL2 82 | 83 | 你可以使用 systemd 容器 [subsystemctl](https://github.com/sorah/subsystemctl) 或是 [genie](https://github.com/arkane-systems/genie)。 84 | 85 | 使用它們，你就可以使用完整的 systemd 了。 86 | 87 | #### subsystemctl 88 | 89 | 你可以下載 [PKGBUILD](https://raw.githubusercontent.com/sorah/arch.sorah.jp/master/aur-sorah/PKGBUILDs/subsystemctl/PKGBUILD) 然後構建它。 90 | 91 | [讀這裡瞭解更多資訊](https://github.com/sorah/subsystemctl#usage)。 92 | 93 | #### genie 94 | 95 | 你可以下載 [這裡的 PKGBUILDs](https://gist.github.com/arlllk/7001c521de601f01735af5ca440f03ae). 96 | 97 | [讀這裡瞭解更多資訊](https://github.com/arkane-systems/genie#usage)。 98 | 99 | #### Intel 顯示卡 100 | 101 | ArchWSL 預設可能無法正常載入 Intel WSL 驅動，這會導致無法在 Intel 顯示卡上使用 D3D12 驅動程式。 102 | 103 | 導致這個問題的原因是 Intel WSL 驅動檔案連結了 ArchLinux 並不存在的庫檔案，你可以手動修復它們使其正常工作。 104 | 105 | 你需要先使用 `ldd` 檢視它們連結了哪些庫，例如: `ldd /usr/lib/wsl/drivers/iigd_dch_d.inf_amd64_49b17bc90a910771/*.so`，然後查詢標記為 `not found` 的庫。接著檢視 ArchLinux 軟體包倉庫是否有對應的包，如果有，安裝它們，問題或許就解決了。如果在軟體包倉庫找不到對應的庫檔案，那可能是庫檔案的版本後綴不一樣，比如 `libedit.so.0.0.68` 和 `libedit.so.2`，這時你可以試著為其建立一個指向現有版本的軟連結。 106 | 107 | Issue: [#308](https://github.com/yuk7/ArchWSL/issues/308) 108 | -------------------------------------------------------------------------------- /locale/zh-TW/README.md: -------------------------------------------------------------------------------- 1 | --- 2 | layout: default 3 | title: "繁體中文" 4 | parent: "Translations" 5 | description: "繁體中文的主頁" 6 | permalink: /locale/zh-TW/ 7 | has_children: true 8 | --- 9 | 10 | # ArchWSL 文件 11 | 12 | [如何安裝](How-to-Setup.md) 13 | 14 | [如何使用](How-to-Use.md) 15 | 16 | [已知問題](Known-issues.md) 17 | 18 | [回到翻譯列表](../Translations.md) 19 | -------------------------------------------------------------------------------- /locale/zh-TW/img/cert/1.install.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/wsldl-pg/ArchW-docs/0e149e961dcf62aab856d0ad299a9bc61887b41e/locale/zh-TW/img/cert/1.install.png -------------------------------------------------------------------------------- /locale/zh-TW/img/cert/2.to-localmachine.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/wsldl-pg/ArchW-docs/0e149e961dcf62aab856d0ad299a9bc61887b41e/locale/zh-TW/img/cert/2.to-localmachine.png -------------------------------------------------------------------------------- /locale/zh-TW/img/cert/3.to-following.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/wsldl-pg/ArchW-docs/0e149e961dcf62aab856d0ad299a9bc61887b41e/locale/zh-TW/img/cert/3.to-following.png -------------------------------------------------------------------------------- /locale/zh-TW/img/cert/4.to-trustedpeople.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/wsldl-pg/ArchW-docs/0e149e961dcf62aab856d0ad299a9bc61887b41e/locale/zh-TW/img/cert/4.to-trustedpeople.png --------------------------------------------------------------------------------