Jump to content

NixOS

From NixOS Wiki
Revision as of 20:04, 28 August 2025 by Weijia (talk | contribs) (Created page with "== 用法 ==")
Introduction to Nix

Tools and applications

☶︎
This article or section needs to be expanded. 此篇文章需要是一個簡單的入門介紹,因為它將是新用戶在此處閱讀的首批文章之一。因此,內容需要簡化一些,更複雜的主題應轉移到其他文章中。 Further information may be found in the related discussion page. Please consult the pedia article metapage for guidelines on contributing.

NixOS 是一個基於 Nix 包管理器與構建系統的 Linux 發行版。它支持聲明式的系統級配置管理以及原子化升級和回滾,同時它仍支持命令式的包管理和用戶管理。在 NixOS 中,發行版的所有組件 — 包括系統內核、已安裝的軟體包和系統配置文件 — 均由 Nix 從被稱為 Nix 表達式純函數中構建。

由於 Nix 使用了二進制緩存機制,這便為面向二進制分發(如 Debian)和面向源碼分發(如 Gentoo)的方法提供了一種獨特的折中方案。預編譯的二進制程序被視作標準組件,在其無法獲取時,自助編譯的軟體包與模塊將被自動構建。

NixOS 穩定版本每年發布兩次(大約在五月底和十一月底)。NixOS 由 Eelco DolstraArmijn Hemel 創建,並於 2003 年首次發布。目前由 NixOS 基金會 管理下的社區開發與維護。

安裝

完整的安裝指南請參閱 NixOS 手冊的 Installation 章節。此維基還包含替代或補充指南,例如 桌面設備上的 NixOS

大多數用戶通過 任一 ISO 鏡像 安裝 NixOS。每個支持架構均有 「graphical」(圖形化安裝)和 「minimal」(最小化安裝)兩種 ISO 變體;「graphical」 鏡像適用於計劃安裝桌面環境的用戶,而 「minimal」 鏡像適用於計劃將 NixOS 充當伺服器或期望更小 ISO 鏡像文件的用戶。ISO 鏡像為混合鏡像,可以刻錄到光碟介質或原封不動地複製到 USB 驅動器上並直接啟動。請參閱安裝指南以了解詳情。

除了 ISO 鏡像,下載頁面 還提供了多種安裝 NixOS 的替代方法。這些方法包括:

  • OVA 格式的虛擬機(兼容 VirtualBox);
  • Amazon EC2 AMIs;

此外,許多現有的 Linux 安裝可以通過 nixos-infectnixos-in-place 轉換為 NixOS 安裝;這對於在不原生支持 NixOS 的主機提供商平台安裝 NixOS 十分有用。

系統架構

NixOS 對大多數 x86_64 設備和通用 ARM64 設備提供了開箱即用的支持。

32位 x86 架構

對於32位 x86 架構(即 i686)的支持正在減少。大多數包仍然可以編譯和運行,但它們的緩存可用性顯著降低[1]。32位 x86 架構不再提供預構建的 ISO 鏡像文件,但其仍可手動構建。

64位 x86 架構

大多數 x86_64 設備都能順利運行 NixOS。

32位 ARM 架構

Main article: NixOS on ARM

NixOS 不官方支持 ARM32 設備(例如 armv6arm71),不過對於其中部分設備,可能存在社區支持。

64位 ARM 架構

Main article: NixOS on ARM

只要設備支持通用 systemd 引導過程,NixOS 便可開箱即用。但是,使用專有引導加載程序的特定設備可能存在運行問題。

MIPS 架構

Main article: NixOS on MIPS

NixOS 對於 MIPS 架構的支持有限, Nixpkgs 中可能存在部分對於此架構的支持。但並未有官方支持。

用法

Declarative Configuration

One of NixOS's defining features is its declarative configuration model, where the entire system state — including installed packages, system services, and settings — is described in configuration files. The primary file is typically located at /etc/nixos/configuration.nix.

Changes to the configuration are applied atomically using nixos-rebuild switch, ensuring reproducibility and the ability to roll back to previous states. Most users track their configuration files in a version control system, enabling consistent and portable system setups. These shortcomings are often rectified after-the-fact if at all by configuration management solutions such as Puppet, Ansible or Chef. These tools reconcile system configuration with a description of the expected state. However, these tools are not integrated into the operating system design and are simply layered on top, and OS configuration may still vary where an aspect of OS configuration has not been specified in the description of expected state.

Unlike conventional distributions, where system configuration is often scattered across manually edited files, NixOS integrates configuration management directly into the operating system. This eliminates configuration drift and makes NixOS particularly well-suited for automated, reproducible deployments.

For more details and examples on NixOS configurations, see NixOS system configuration.

Imperative Operations

While NixOS is typically configured declaratively as much as possible, these are a few domains where imperative operations are still necessary; these include user environment management and channel management.

User Environments

In addition to declarative system configuration, NixOS users can utilize Nix's imperative nix-env command to install packages at the user level, without changing the system state. See the user environments section of the Nix article for more information.

Channels

In the Nix ecosystem, channels are a mechanism for distributing collections of Nix packages and NixOS module definitions. A channel represents a curated, versioned set of package definitions and system configurations, typically corresponding to a particular release or the latest available development state.

When using channels, your system or user environment pulls package definitions and options from a URL pointing to a specific snapshot of the Nix Packages collection (Nixpkgs) and associated NixOS modules.

For more information on using and configuring nix channels, refer to channel branches.

Internals

Comparison with traditional Linux Distributions

The main difference between NixOS and other Linux distributions is that NixOS does not follow the Linux Standard Base file system structure. On LSB-compliant systems software is stored under /{,usr}/{bin,lib,share} and configuration is generally stored in /etc. Software binaries are available in the user environment if they are placed in one of the LSB's /bin directories. When a program references dynamic libraries it will search for the required libraries in the LSB folders (/lib, /usr/lib).

In NixOS however /lib and /usr/lib do not exist. Instead all system libraries, binaries, kernels, firmware and configuration files are placed in the Nix store. The files and directories in /nix/store are named by hashes of the information describing the built data. All of the files and directories placed in the Nix store are immutable. /bin and /usr/bin are almost absent: they contain only /bin/sh and /usr/bin/env respectively, to provide minimal compatibility with existing scripts using shebang lines. User-level environments are implemented using a large number of symbolic links to all required packages and auxiliary files. These environments are called profiles and are stored in /nix/var/nix/profiles, each user having their own profiles. Structuring the system in this way is how NixOS obtains its key advantages over conventional Linux distributions, such as atomicity and rollback support.

Usage of the Nix store

A lot of confusion for newcomers arises from the fact that configuration is stored in the read-only /nix/store tree along with all the installed packages. This fact makes it impossible to manually edit system configuration; all configuration changes must be performed by editing the /etc/nixos/configuration.nix file and executing nixos-rebuild switch. NixOS provides the module system for editing all required configurations. Users should first use the option search tool to check if the option they need exists before attempting to manually add files or configuration via low-level NixOS features like activation scripts.

The system purity makes it possible to keep system configuration in a central place, without the need to edit multiple files. This configuration can be distributed or version controlled as desired. It also provides for determinism; if you provide the same inputs, the same version of Nixpkgs and the same /etc/nixos/configuration.nix you will get the exact same system state.

Modules

The NixOS module system as defined in Nixpkgs provides the means necessary to customize the configuration of the OS. It is used to enable and customize services such as nginx, enable firmware and customize the kernel.

All module configuration is generally performed by adding options to /etc/nixos/configuration.nix. Most of the examples in the wiki show how this file can be used to configure the OS.

The NixOS module system implements a typing system which allows typechecking of option settings. It also enables options defined in multiple places to be merged automatically. This allows you to spread your configuration over multiple files, and the options you set across all of those files will be merged together:

❄︎ /etc/nixos/configuration.nix
{
  imports = [
    ./basic-webserver.nix
    ./blog.nix
  ];
}
❄︎ /etc/nixos/basic-webserver.nix
{
  services.nginx.enable = true;
  services.nginx.virtualHosts."example.com" = {
    root = "/var/www/example.com";
  };
}
❄︎ /etc/nixos/blog.nix
{
  services.nginx.virtualHosts."blog.example.com" = {
    root = "/var/www/blog.example.com";
  };
}

See the Modules section of the NixOS Manual for more details.

Generations

Every time the system state is rebuilt using nixos-rebuild switch, a new generation is created. You can revert to the previous generation at any time, which is useful if a configuration change (or system update) turns out to be detrimental.

You can roll back via:

$ nix-env --rollback               # roll back a user environment
$ nixos-rebuild switch --rollback  # roll back a system environment

NixOS also places entries for previous generations in the bootloader menu, so as a last resort you can always revert to a previous configuration by rebooting. To set the currently booted generation as the default run

$ /run/current-system/bin/switch-to-configuration boot

Because NixOS keeps previous generations of system state available in case rollback is desired, old package versions aren't deleted from your system immediately after an update. You can delete old generations manually:

# delete generations older than 30 days
$ nix-collect-garbage --delete-older-than 30d
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
# delete ALL previous generations - you can no longer rollback after running this
$ nix-collect-garbage -d

List generations:

# as root
$ nix-env --list-generations --profile /nix/var/nix/profiles/system

Switch generations:

# as root switch to generation 204
$ nix-env --profile /nix/var/nix/profiles/system --switch-generation 204

delete broken generation(s):

# as root delete broken generations 205 and 206 
$ nix-env --profile /nix/var/nix/profiles/system --delete-generations 205 206

You can configure automatic garbage collection by setting the nix.gc options in /etc/nixos/configuration.nix. This is recommended, as it keeps the size of the Nix store down.

See also