NixOS Wiki

NixOS Installation Guide/zh: Difference between revisions

← Older edit
VisualWikitext
Mayer (talk | contribs)
328 edits
No edit summary
Ardenet (talk | contribs)
1,679 edits
No edit summary
 
(56 intermediate revisions by 4 users not shown)
Line 1: Line 1:
这份指南是对[https://nixos.org/nixos/manual/index.html#ch-installation 官方手册]的一份参考指南. 它讲述了把[[NixOS]]作为完整操作系统的安装过程. 为了在一个已存在的操作系统内安装[[Nix]], 请见[[Nix Installation Guide|Nix安装指南]].
<languages/>
本指南是官方手册 [https://nixos.org/nixos/manual/index.html#ch-installation] 的配套指南。它描述了如何将 [[Special:MyLanguage/NixOS|NixOS]] 安装为完整的操作系统。有关在现有操作系统中安装 [[Special:MyLanguage/Nix|Nix]] 的说明，请参阅 [[Special:MyLanguage/Nix Installation Guide|Nix 安装指南]]。


除了讲述官方手册上的步骤, 它还提供了用于常见使用场景的已知良好指导. 当官方手册和这份指南之间出现矛盾时, 以官方手册中描述的情况为准.
除了涵盖官方手册中的步骤外，它还提供了针对常见用例的已知有效操作。当官方手册与本指南之间存在差异时，支持用例以手册中描述的为准。
 
把这份指南当作逐步操作指南使用. 出现不同选择时, 只使用选定的部分, 并在这部分的结尾按照它的指示前进.


<span id="Installation_target"></span>
<span id="Installation_target"></span>
Line 25: Line 24:
== 制作安装媒介 ==
== 制作安装媒介 ==


从NixOS 14.11开始, 安装程序ISO(镜像文件)是混合型的. 这意味着它通过CD和USB驱动器都可以启动. 它也可以在EFI系统上启动, 如大多数现代主板和苹果系统. 接下来的指导将假设复制镜像文件到USB驱动器的标准方式. 当使用CD或者DVD时, 刻录到光盘的通常方式应当也适用于该iso文件.
从NixOS 14.11开始, 安装程序ISO(镜像文件)是混合型的. 这意味着它通过CD和USB驱动器都可以启动. 它也可以在EFI系统上启动, 如大多数现代主板和苹果系统. 接下来的指导将假设使用复制镜像文件到USB驱动器的标准方式. 当使用CD或者DVD时, 刻录到光盘的通常方式应当也适用于该iso文件.


<span id="&quot;Burning&quot;_to_USB_drive"></span>
<span id="&quot;Burning&quot;_to_USB_drive"></span>
Line 38: Line 37:
# 复制到设备: <code>cp nixos-xxx.iso <em>/dev/sdX</em></code>
# 复制到设备: <code>cp nixos-xxx.iso <em>/dev/sdX</em></code>


{{note|不要使用 /dev/sdX1 或硬盘的分区, 使用整块硬盘 /dev/sdX}}
{{note|不要使用 /dev/sdX1 或硬盘的分区, 请使用整块硬盘 /dev/sdX}}


也可通过 <code>dd if=nixos.iso of=/dev/sdX bs=4M status=progress conv=fdatasync</code> 写入硬盘镜像
也可通过 <code>dd if=nixos.iso of=/dev/sdX bs=4M status=progress conv=fdatasync</code> 写入硬盘镜像
Line 45: Line 44:
==== 在macOS上 ====
==== 在macOS上 ====


<div lang="en" dir="ltr" class="mw-content-ltr">
# 使用<code>diskutil list</code>找到正确的设备, 比如说<code><i>diskX</i></code>.
# Find the right device with <code>diskutil list</code>, let's say <code><i>diskX</i></code>.
# 使用<code>diskutil unmountDisk <i>diskX</i></code>取消挂载.
# Unmount with <code>diskutil unmountDisk <i>diskX</i></code>.
# 使用<code>sudo dd if=<b>path_to_nixos.iso</b> of=/dev/<i>diskX</i></code>进行刻录
# Burn with: <code>sudo dd if=<b>path_to_nixos.iso</b> of=/dev/<i>diskX</i></code>
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
{{tip|使用<code>rdiskX</code>而不是<code>diskX</code>可以大幅改变速度. 你可以在另一个终端里使用<code>iostat 2</code>检查写入速度.}}
{{tip|Using <code>rdiskX</code> instead of <code>diskX</code> can makes a large speed difference. You can check the write speed with <code>iostat 2</code> in another terminal.}}
</div>


<span id="From_Windows"></span>
<span id="From_Windows"></span>
==== 在Windows上====
==== 在Windows上====


<div lang="en" dir="ltr" class="mw-content-ltr">
# 下载USBwriter.
# Download [http://sourceforge.net/projects/usbwriter/ USBwriter].
# 启动USBwriter.
# Start USBwriter.
# 选择下载的ISO文件作为'Source'
# Choose the downloaded ISO as 'Source'
# 选择USB驱动器作为'Target'
# Choose the USB drive as 'Target'
# 点击'Write'
# Click 'Write'
# 当USBWriter完成写入操作后, 安全拔出USB驱动器
# When USBwriter has finished writing, safely unplug the USB drive.
</div>


<span id="Alternative_installation_media_instructions"></span>
<span id="Alternative_installation_media_instructions"></span>
Line 74: Line 67:
这些方式也同样有记录, 它们可以使用USB驱动器启动多个发行版. 这种方式不被支持, 结果可能因人而异.
这些方式也同样有记录, 它们可以使用USB驱动器启动多个发行版. 这种方式不被支持, 结果可能因人而异.


<div lang="en" dir="ltr" class="mw-content-ltr">
* [[NixOS_Installation_Guide/Unetbootin|使用 Unetbootin]]
* [[NixOS_Installation_Guide/Unetbootin|Using Unetbootin]]
* [[NixOS_Installation_Guide/Manual USB Creation|手动 USB 创建]]
* [[NixOS_Installation_Guide/Manual USB Creation|Manual USB Creation]]
* [[NixOS_Installation_Guide/multibootusb|multibootusb]]
* [[NixOS_Installation_Guide/multibootusb|multibootusb]]
</div>


== 启动安装媒介 ==
== 启动(Boot)安装媒介 ==
{{expansion|Troubleshooting steps, and details are lacking.}}
{{expansion|Troubleshooting steps, and details are lacking.}}


因为安装媒介是混合型的, 它通过legacy bios模式和UEFI模式都可以启动.
由于安装镜像为混合镜像，因此可在传统 BIOS 模式或 [[Special:MyLanguage/UEFI|UEFI]] 模式下启动。


无论使用哪种方式启动安装媒介, 你可能需要修改主板或者电脑的配置, 以允许从光盘驱动器(对于CD/DVD)或者一个外部的USB驱动器启动.
无论使用哪种方式启动安装媒介, 你可能需要修改主板或者电脑的配置, 以允许从光盘驱动器(对于CD/DVD)或者从一个外部的USB驱动器启动.


<span id="Legacy_bios_boot"></span>
<span id="Legacy_bios_boot"></span>
Line 108: Line 99:


<span id="Tethered_(Internet_Sharing)"></span>
<span id="Tethered_(Internet_Sharing)"></span>
==系留式(网络共享)==
==有线连接（网络共享）==


如果你无法通过网线或者wifi连接到网络, 你可以使用智能手机的网络共享能力. 依赖于你的手机的能力, 只需要内核自带的驱动就可以提供有效的网络连接.
如果你无法通过网线或者wifi连接到网络, 你可以使用智能手机的网络共享能力. 依赖于你的手机的能力, 只需要内核自带的驱动就可以提供有效的网络连接.
Line 115: Line 106:
=== 无线网络 ===
=== 无线网络 ===


Network Manager安装在图形界面ISO文件中, 意味着可以在命令行中使用<code>nmtui</code>来连接到网络.
[[Special:MyLanguage/NetworkManager|NetworkManager]] 安装在图形化 ISO 镜像上，这意味着可以在命令行上使用 <code>nmtui</code> 命令连接到网络。


<div lang="en" dir="ltr" class="mw-content-ltr">
使用左上方的"Applications(应用)"标签页或者在底部的启动栏, 打开一个终端应用, 在那里启动 <code>nmtui</code>. 这可以让你'activate(激活)'一个(无线)连接 - 你应该可以在列表里看到你那里的SSID(无线网络名称), 除此之外你还可以添加一个新的连接. 当无线连接处于活动状态, 并且你已经测试过了时, 一开始就启动的安装程序很可能还没有检测到新的连接. 关掉安装程序, 再重新从屏幕底部的启动栏打开它. 这时它应该会检测到新的网络连接而继续.
Using the "Applications" tab at top
left or the launcher bar at bottom, choose a terminal application and from there launch <code>nmtui</code>. This will allow you to 'activate' a (wireless) connection - your local SSIDs should be visible in the list, else you can add a new connection. When the wireless connection is active and you have tested it, it is likely the install app which launched on startup has not detected the new connection. Close down the install app, and reopen it from the launcher bar at the bottom of the screen. This should then find the new connection and proceed.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
在最小化 ISO 镜像上，或者您更熟悉 [[Special:MyLanguage/wpa_supplicant|wpa_supplicant]]，那么您也可以运行 <code>wpa_passphrase ESSID | sudo tee /etc/wpa_supplicant.conf</code> 命令，然后输入您的密码并执行 <code>systemctl restart wpa_supplicant</code> 命令。
On the minimal ISO, or if you are more familiar with <code>wpa_supplicant</code> then you can also run <code>wpa_passphrase ESSID | sudo tee /etc/wpa_supplicant.conf</code>, then enter your password and <code>systemctl restart wpa_supplicant</code>.
</div>


<span id="Partitioning"></span>
<span id="Partitioning"></span>
== Partitioning(分区) ==
== Partitioning(分区操作) ==


为了给连续存储进行分区, 运行 <code>sudo fdisk /dev/diskX</code> , 然后跟着针对DOS或(U)EFI的指示来做.
要对持久存储进行分区，请运行 <code>sudo fdisk /dev/diskX</code> 并按照 MBR 或 (U)EFI 的说明进行操作。要确定您使用的启动模式，请运行：
这里有一个非常简单的示例设置.


=== DOS ===
<syntaxhighlight lang="console">
$ [ -d /sys/firmware/efi/efivars ] && echo "UEFI" || echo "Legacy"
</syntaxhighlight>


<div lang="en" dir="ltr" class="mw-content-ltr">
这里给出了一个非常简单的示例设置。
* o (dos disk label)
 
<span id="Legacy_Boot_(MBR)"></span>
=== 传统启动（Legacy Boot, MBR）===
 
* o (dos硬盘标签)
* n new
* n new
* p primary (4 primary in total)
* p primary (4 primary in total)
* 1 (partition number [1/4])
* 1 (分区编号[1/4])
* 2048 first sector (alignment for performance)
* 2048 first sector (alignment for performance)
* +500M last sector (boot sector size)
* +500M last sector (引导扇区的大小)
* rm signature (Y), if ex. => warning of overwriting existing system, could use wipefs
* rm signature (Y), if ex. => warning of overwriting existing system, could use wipefs
* n
* n
* p
* p
* 2
* 2
* default (fill up partition)
* default (填满分区)
* default (fill up partition)
* default (填满分区)
* w (write)
* w (写入)
</div>


=== UEFI ===
=== UEFI ===
Line 165: Line 155:
* w (写入)
* w (写入)


<span id="Label_partitions"></span>
<span id="Format_partitions"></span>
== 给分区贴标签 ==
=== 格式化分区 ===


<div lang="en" dir="ltr" class="mw-content-ltr">
以下示例使用 [[Special:MyLanguage/ext4|ext4]] 文件系统格式。如果您希望使用其他文件系统格式，例如 [[Special:MyLanguage/Btrfs|Btrfs]] 或 [[Special:MyLanguage/ZFS|ZFS]]：
This is useful for having multiple setups and makes partitions easier to handle<syntaxhighlight lang="console">
 
$ lsblk
* [[Special:MyLanguage/Bcachefs#NixOS installation on bcachefs|在 bcachefs 上安装 NixOS]]
$ sudo mkfs.fat -F 32 /dev/sdX1
* [[Special:MyLanguage/Btrfs#Installation of NixOS on btrfs|在 btrfs 上安装 NixOS]]
$ sudo fatlabel /dev/sdX1 NIXBOOT
* [[Special:MyLanguage/LVM#Basic Setup|LVM 基础设置]]
$ sudo mkfs.ext4 /dev/sdX2 -L NIXROOT
* [[Special:MyLanguage/ZFS#Simple NixOS ZFS on root installation|Simple NixOS ZFS on root installation]]
$ sudo mount /dev/disk/by-label/NIXROOT /mnt
 
$ sudo mkdir -p /mnt/boot
这对于有多个分区设置的情况很有用, 使分区更容易处理
$ sudo mount /dev/disk/by-label/NIXBOOT /mnt/boot
 
<syntaxhighlight lang="console">
$ lsblk # lists current system block devices
# mkfs.fat -F 32 -n boot /dev/sdX1
# mkfs.ext4 /dev/sdX2 -L nixos
# mount /dev/disk/by-label/nixos /mnt
# mkdir -p /mnt/boot
# mount /dev/disk/by-label/boot /mnt/boot
</syntaxhighlight>
</syntaxhighlight>
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
<span id="NixOS_configuration"></span>
== Swap file ==
== NixOS 配置 ==
 
NixOS 通过 [[Special:MyLanguage/Overview of the NixOS Linux distribution#Declarative Configuration|声明式配置]] 文件进行配置。要生成默认配置文件，请运行 [[Special:MyLanguage/nixos-generate-config]]：
 
<syntaxhighlight lang="console">
<syntaxhighlight lang="console">
$ sudo dd if=/dev/zero of=/mnt/.swapfile bs=1024 count=2097152 (2GB size)
# nixos-generate-config --root /mnt
$ sudo chmod 600 /mnt/.swapfile
# nano /mnt/etc/nixos/configuration.nix
$ sudo mkswap /mnt/.swapfile
$ sudo swapon /mnt/.swapfile
</syntaxhighlight>
</syntaxhighlight>
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
有关使用系统配置的信息，请参阅 [[Special:MyLanguage/NixOS system configuration|NixOS 系统配置]]。有关特定于桌面的配置，请参阅 [[Special:MyLanguage/NixOS as a desktop|桌面设备上的 NixOS]]。
== NixOS config ==
 
最重要的变化：
 
* 键盘布局（keyboard layout）, 也就是 <code>[[Keyboard Layout Customization|services.xserver.xkb.layout]]</code>
* [[networking|网络]] (wifi), 若出现问题, 请参阅下方的修复方法
* 安装 [[:Category:Text Editor|编辑器]] 来编辑配置
 
具有自我说明性的NixOS选项可以在[https://search.nixos.org/options NixOS选项搜索]上搜索到.
 
<span id="Swap_file"></span>
== 交换文件 ==
 
有关配置交换空间的更多方法，请参阅 [[Swap]]。以下示例演示了如何创建和启用一个 [[Swap#Swap file|交换文件]]：
 
{{file|/mnt/etc/nixos/configuration.nix|nix|
<nowiki>
  swapDevices = [{
    device = "/var/lib/swapfile";
    size = 16*1024; # 16 GB
  }];
</nowiki>
}}
 
<span id="Bootloader"></span>
=== 引导加载程序 ===
 
NixOS 支持多种 [[Bootloader|引导加载程序]]，例如 [[GNU GRUB]] 和 [[Systemd/boot]]。
 
Systemd-boot 是推荐的引导加载程序。以下示例演示了如何在配置中启用 systemd-boot：
 
{{file|/mnt/etc/nixos/configuration.nix|nix|
<nowiki>
  boot.loader.systemd-boot.enable = true;
</nowiki>
}}
 
您可能还希望配置 [[Secure Boot|安全启动]]。
 
<span id="Users"></span>
=== 用户 ===
 
有关创建和管理用户的信息，请参阅 [[User management|用户管理]] 和 {{NixOS Manual|name=NixOS Manual: Chapter - Package Management|anchor=#sec-user-management}}。请参阅以下示例：
 
{{file|/mnt/etc/nixos/configuration.nix|nix|
<nowiki>
  users.users.alice = {
    isNormalUser = true;
    initialPassword = "pw123";
  };
</nowiki>
}}
 
<span id="NixOS_installation"></span>
== 安装 NixOS ==
 
<syntaxhighlight lang="console">
<syntaxhighlight lang="console">
$ sudo nixos-generate-config --root /mnt
# cd /mnt
$ cd /mnt/etc/nixos/
# nixos-install
$ sudo vim configuration.nix
</syntaxhighlight>
</syntaxhighlight>Most essential changes:
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
安装后：运行<code>passwd</code>更改用户密码。
* keyboard layout, ie <code>[[Keyboard Layout Customization|services.xserver.xkb.layout]]</code>
* <code>users.users.user</code> with adding entry <code>initialPassword = "pw123";</code>
* [[networking]] (wifi), see below for fix if it breaks
* <code>boot.loader.grub.device = "/dev/sda"; #or "nodev" for efi only</code>
* install editor to edit the configuration
* change hardware config to use labels
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
如果网络出现问题, 请尝试下面的一种方法:
The self-documenting NixOS options can be searched with [https://search.nixos.org/options NixOS options search].
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
== NixOS installation ==
<syntaxhighlight lang="console">
<syntaxhighlight lang="console">
$ cd /mnt
# nixos-rebuild switch --option substitute false # no downloads
$ sudo nixos-install
# nixos-rebuild switch --option binary-caches "" # no downloads
</syntaxhighlight>after installation: Run <code>passwd</code> to change user password.
</syntaxhighlight>
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
* 设置 wpa_supplicant 标志来连接到 wifi
if internet broke/breaks, try one of the following:<syntaxhighlight lang="console">
$ nixos-rebuild switch --option substitute false # no downloads
$ nixos-rebuild switch --option binary-caches "" # no downloads
</syntaxhighlight>
* wpa_supplicant flags to connect to wifi
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
<hr />
<hr />
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
<span id="Additional_notes_for_specific_hardware"></span>
== Additional notes for specific hardware ==
== 有关特定硬件的附加说明 ==
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
这些是有关特定硬件问题的收集到的说明或链接.
These are collected notes or links for specific hardware issues.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
* 博客文章：如何在 [http://grahamc.com/blog/nixos-on-dell-9560 Dell 9560] 上安装 NixOS
* Blog post how to install NixOS on a [http://grahamc.com/blog/nixos-on-dell-9560 Dell 9560]
* 品牌服务器可能需要在 initrd 中包含额外的内核模块（在 configuration.nix 中配置 <code>boot.initrd.extraKernelModules</code>）。例如，HP Proliant 需要“hpsa”模块才能访问磁盘驱动器。
* Brand servers may require extra kernel modules be included into initrd (<code>boot.initrd.extraKernelModules</code> in configuration.nix) For example HP Proliant needs "hpsa" module to see the disk drive.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
[[Category:Guide|分类：指南]]
[[Category:Guide]][[Category:Deployment]]
[[Category:Deployment|分类：开发]]
</div>
[[Category:NixOS|分类：NixOS]]
Retrieved from "https://wiki.nixos.org/wiki/NixOS_Installation_Guide/zh"