Gentoo Linux 手册：安装Gentoo

From Gentoo Wiki
Jump to:navigation Jump to:search
This page is a translated version of the page Handbook:MIPS/Full/Installation and the translation is 100% complete.



介绍

欢迎

欢迎使用 Gentoo！Gentoo 是一个基于 Linux 的自由操作系统，他可以针对任何应用或需求进行自动优化和定制。 它基于自由软件生态系统，不会向用户隐瞒背后运行的内容。

开放

Gentoo 的主要工具是用简单的编程语言构建的。Portage/zh-cn 是 Gentoo 的软件包维护系统，他是 由 Python 编写的。Ebuilds 为 Portage 定义软件包，他是由 bash 编写的。我们鼓励用户审查、修改和完善 Gentoo 所有源代码。

默认情况下，软件包只在必要时才会打补丁，比如修复漏洞或者提供与 Gentoo 互操作。软件包通过上游项目提供的源代码编译成二进制格式，然后安装到系统中（尽管也支持预编译二进制包）。也可以通过文本文件配置 Gentoo。

出于上述和其他原因：开放是 Gentoo 设计原则之一。

选择

Gentoo 的另一个设计原则是选择。

安装 Gentoo 时，选择贯穿于整个手册中。系统管理员可以选择两种完全支持的 init 系统（Gentoo 自己的 OpenRC 和 Freedesktop.org 的 systemd），存储磁盘的分区结构，磁盘使用什么文件系统，目标 系统配置文件，通过 USE 标记对全局（系统级）或特定软件包移除、添加特性，启动引导，网络管理工具，还有很多很多。

作为一种开发哲学, Gentoo 的作者尽量避免强迫用户使用特定的系统配置文件或桌面环境。如果一些东西在 GNU/Linux 生态系统中有，那很有可能在 Gentoo 中也能使用。即使 GNU/Linux 没有，我们也很乐意看到他。如果要添加新的软件包，请提交 bug 报告或者创建你自己的 ebuild 仓库。

强力

作为一个基于源代码的操作系统，Gentoo 可以移植到新计算机指令集架构上，还可以对所有安装的软件包进行调整。这一优势体现了 Gentoo 的另一个设计原则：强力。

A system administrator who has successfully installed and customized Gentoo has compiled a tailored operating system from source code. The entire operating system can be tuned at a binary level via the mechanisms included in Portage's make.conf file. If so desired, adjustments can be made on a per-package basis, or a package group basis. In fact, entire sets of functionality can be added or removed using USE flags.

手册的读者必须明白，这些设计原则正是 Gentoo 的独特之处。由于 Gentoo 着重强调了强大的功能、多种选择和极度开放的原则，因此在使用 Gentoo 时应多努力、多思考、多用心。

安装步骤

Gentoo的安装可以被分成10个步骤，分别对应后续的章节。执行完每个步骤，都会让系统进入某种确定的状态：

步骤 结果
1 用户处于一个准备好安装 Gentoo 的工作环境中。
2 用于安装 Gentoo 的互联网连接已经准备完毕。
3 硬盘已经为 Gentoo 的安装初始化完毕。
4 安装环境已经准备好，用户准备 chroot 到新环境中去。
5 那些在所有Gentoo安装中都相同的核心软件包已经安装完毕。
6 Linux内核已经安装完毕。
7 用户已经创建好大部分的 Gentoo 系统配置文件。
8 必要的系统工具已经安装完毕。
9 合适的启动引导程序 (Bootloader) 已经安装配置完毕。
10 登录系统，你就可以在已经全新安装完毕的 Gentoo Linux 系统中尽情探索了！

当面临选择的时候，手册上会尽量说明每个选择的利弊。虽然手册会以默认选择（标题中有 "默认Default：" 标记）继续描述下去，但其他可能的选择同样也会在文档中说明（标题中有 "可选Alternative：" 标记）。请不要认为默认选项是 Gentoo的推荐选项。这只是 Gentoo 认为大多数用户会使用的选项。

有时候你也可以进行一些可选的步骤。这样的步骤会被标注为"可选Optional："，当然这些步骤对于安装Gentoo来说就不是必须的。然而，有些可选的步骤依赖于你先前所做出的决定。我们将会在你需要做这样决定以及可选步骤出现的时候提醒你。

选择合适的方法安装Gentoo

Gentoo可以以许多不同的方式安装。 它可以从官方Gentoo安装介质（如我们的可引导ISO文件）下载和安装。 安装介质可以安装在USB盘上或通过网络引导环境访问。 或者，Gentoo可以从非官方介质安装，如已安装的发行版或非Gentoo可启动磁盘（如Knoppix）。

本文讲解了如何使用Gentoo官方安装光盘或者在某些情况下使用网络启动来安装Gentoo。

附注
需要其他安装方式的帮助（包括使用非Gentoo的Linux引导介质）请阅读我们的其他安装方式。

我们也提供一篇 Gentoo 安装提示和技巧文档，它可能会有用。

遇到麻烦

如果在安装（或安装文档中）发现问题，请访问我们的 bug 跟踪系统，并确认这个 Bug 是否已经被提交。如果没有提交，请为它创建一个错误报告以方便我们的后续处理。不要害怕和被分配解决这个问题的开发人员交流——他们（通常）不吃人。

虽然你当前阅读的文档是针对某一特定的硬件架构，但是它可能还是会包含对其他平台架构的引用，因为Gentoo手册中的绝大部分在所有硬件架构都相同（避免重复劳动）。为了避免混淆，我们把这样的引用保持在最低限度。

如果你不能确定你的问题是使用者的操作问题（尽管你已经仔细地阅读了文档但仍然出了错）还是一个软件问题（尽管我们已经仔细地测试了安装步骤/文档但仍然出了错）。请联系我们： irc.libera.chat 上的 #gentoo (webchat)。当然，如果你有其他方面的关于Gentoo的问题，我们也欢迎你来这里讨论。

说到这里,如果还有任何额外的Gentoo问题,看看我们常见问题 ，或者Gentoo论坛 上的 FAQs 。






硬件需求


CPU (Big Endian port) MIPS3, MIPS4, MIPS5 or MIPS64-class CPU
CPU (Little Endian port) MIPS4, MIPS5 or MIPS64-class CPU
Memory 128 MB
Disk space 3.0 GB (excluding swap space)
Swap space At least 256 MB

For more information, read MIPS Hardware Requirements.

Installation notes

On many architectures, the processor has gone through several generations, each newer generation builds on the foundation of the previous one. MIPS is no exception. There are several generations of CPU covered under the MIPS architecture. In order to choose the right netboot image stage tarball and CFLAGS appropriately, it is necessary to be aware of which family the system's CPU belongs in. These families are referred to as the Instruction Set Architecture.

MIPS ISA 32/64-bit CPUs Covered
MIPS 1 32-bit R2000, R3000
MIPS 2 32-bit R6000
MIPS 3 64-bit R4000, R4400, R4600, R4700
MIPS 4 64-bit R5000, RM5000, RM7000 R8000, R9000, R10000, R12000, R14000, R16000
MIPS 5 4-bit None As Yet
MIPS32 32-bit AMD Alchemy series, 4kc, 4km, many others... There are a few revisions in the MIPS32 ISA.
MIPS64 64-bit Broadcom SiByte SB1, 5kc ... etc... There are a few revisions in the MIPS64 ISA.
附注
The MIPS5 ISA level was designed by Silicon Graphics back in 1994, but never actually got used in a real life CPU. It lives on as part of the MIPS64 ISA.
附注
The MIPS32 and MIPS64 ISAs are a common source of confusion. The MIPS64 ISA level is actually a superset of the MIPS5 ISA, so it includes all instructions from MIPS5 and earlier ISAs. MIPS32 is the 32-bit subset of MIPS64, it exists because most applications only require 32-bit processing.

Also, another important concept to grasp is the concept of endianness. Endianness refers to the way that a CPU reads words from main memory. A word can be read as either big endian (most significant byte first), or little endian (least significant byte first). Intel x86 machines are generally Little endian, whilst Apple and Sparc machines are Big Endian. On MIPS, they can be either. To separate them apart, we append el to the architecture name to denote little endian.

Architecture 32/64-bit Endianness Machines covered
mips 32-bit Big Endian Silicon Graphics
mipsel 32-bit Little Endian Cobalt Servers
mips64 64-bit Big Endian Silicon Graphics
mips64el 64-bit Little Endian Cobalt Servers

For those willing to learn more about ISAs, the following websites may be of assistance:

Netbooting overview

In this section, we'll cover what is needed to successfully network boot a Silicon Graphics workstation or Cobalt Server appliance. This is just a brief guide, it is not intended to be thorough, for more information, it is recommended to read the Diskless nodes article.

Depending on the machine, there is a certain amount of hardware that is needed in order to successfully netboot and install Linux.

  • In General:
    • DHCP/BOAMD Alchemy series, 4kc, 4km, many others... There are a few revisions in the MIPS32 ISA.OTP server (ISC DHCPd recommended)
    • Patience -- and lots of it
  • For Silicon Graphics workstations:
    • TFTP server (tftp-hpa recommended)
    • When the serial console needs to be used:
      • MiniDIN8 --> RS-232 serial cable (only needed for IP22 and IP28 systems)
      • Null-modem cable
      • VT100 or ANSI compatible terminal capable of 9600 baud
  • For Cobalt Servers (NOT the original Qube):
    • NFS server
    • Null-modem cable
    • VT100 or ANSI compatible terminal capable of 115200 baud
附注
SGI machines use a MiniDIN 8 connector for the serial ports. Apparently Apple modem cables work just fine as serial cables, but with Apple machines being equipped with USB & internal modems, these are getting harder to find. One wiring diagram is available from the Linux/MIPS Wiki, and most electronics stores should stock the plugs required.
附注
For the terminal, this could be a real VT100/ANSI terminal, or it could be a PC running terminal emulation software (such as HyperTerminal, Minicom, seyon, Telex, xc, screen - whatever your preference). It doesn't matter what platform this machine runs - just so long as it has one RS-232 serial port available, and appropriate software.
附注
This guide does NOT cover the original Qube. The original Qube server appliance lacks a serial port in its default configuration, and therefore it is not possible to install Gentoo onto it without the aid of a screwdriver and a surrogate machine to do the installation.

Setting up TFTP and DHCP

As mentioned earlier -- this is not a complete guide, this is a bare-bones config that will just get things rolling. Either use this when starting a setup from scratch, or use the suggestions to amend an existing setup to support netbooting.

It is worth noting that the servers used need not be running Gentoo Linux, they could very well be using FreeBSD or any Unix-like platform. However, this guide will assume to be using Gentoo Linux. If desired, it is also possible to run TFTP/NFS on a separate machine to the DHCP server.

警告
The Gentoo/MIPS Team cannot help with setting up other operating systems as netboot servers.

First Step -- configuring DHCP. In order for the ISC DHCP daemon to respond to BOOTP requests (as required by the SGI & Cobalt BOOTROM) first enable dynamic BOOTP on the address range in use; then set up an entry for each client with pointers to the boot image.

root #emerge --ask net-misc/dhcp

Once installed, create the /etc/dhcp/dhcpd.conf file. Here's a bare-bones config to get started.

文件 /etc/dhcp/dhcpd.confBare Bones dhcpd.conf
# Tell dhcpd to disable dynamic DNS.
# dhcpd will refuse to start without this.
ddns-update-style none;
  
# Create a subnet:
subnet 192.168.10.0 netmask 255.255.255.0 {
  # Address pool for our booting clients. Don't forget the 'dynamic-bootp' bit!
  pool {
    range dynamic-bootp 192.168.10.1 192.168.10.254;
  }
  
  # DNS servers and default gateway -- substitute as appropriate
  option domain-name-servers 203.1.72.96, 202.47.56.17;
  option routers 192.168.10.1;
  
  # Tell the DHCP server it's authoritative for this subnet.
  authoritative;
  
  # Allow BOOTP to be used on this subnet.
  allow bootp;
}

With that setup, one can then add any number of clients within the subnet clause. We will cover what to put in later in this guide.

Next step - Setting up TFTP server. It is recommended to use tftp-hpa as it is the only TFTP daemon known to work correctly. Proceed by installing it as shown below:

root #emerge --ask net-ftp/tftp-hpa

This will create /tftproot to store the netboot images. Move this elsewhere if necessary. For the purposes of this guide, it is assumed that it is kept in the default location.

Netbooting on SGI stations

Downloading a netboot image

Depending on the system the installation is meant for, there are several possible images available for download. These are all labelled according to the system type and CPU they are compiled for. The machine types are as follows:

Codename Machines
IP22 Indy, *Indigo 2, Challenge S
IP26 *Indigo 2 Power
IP27 Origin 200, Origin 2000
IP28 *Indigo 2 Impact
IP30 Octane
IP32 O2
附注
Indigo 2 - It is a common mistake to mix up the IRIS Indigo (IP12 w/ R3000 CPU or IP20 with a R4000 CPU, neither of which run Linux), the Indigo 2 (IP22, which runs Linux fine), the R8000-based Indigo 2 Power (which doesn't run Linux at all) and the R10000-based Indigo 2 Impact (IP28, which is highly experimental). Please bear in mind that these are different machines.

Also in the filename, r4k refers to R4000-series processors, r5k for R5000, rm5k for the RM5200 and r10k for R10000. The images are available on the Gentoo mirrors.

DHCP configuration for an SGI client

After downloading the file, place the decompressed image file in the /tftproot/ directory. (Use bzip2 -d to decompress). Then edit the /etc/dhcp/dhcpd.conf file and add the appropriate entry for the SGI client.

文件 /etc/dhcp/dhcpd.confsnippet for SGI Workstation
subnet xxx.xxx.xxx.xxx netmask xxx.xxx.xxx.xxx {
  # ... usual stuff here ...
  
  # SGI Workstation... change 'sgi' to your SGI machine's hostname.
  host sgi {
  
    # MAC Address of SGI Machine. Normally this is written on the back
    # or base of the machine.
    hardware ethernet 08:00:69:08:db:77;
  
    # TFTP Server to download from (by default, same as DHCP server)
    next-server 192.168.10.1;
  
    # IP address to give to the SGI machine
    fixed-address 192.168.10.3;
  
    # Filename for the PROM to download and boot
    filename "/gentoo-r4k.img";
  }
}

Kernel options

We're almost done, but there's a couple of little tweaks still to be done. Pull up a console with root privileges.

Disable "Path Maximum Transfer Unit", otherwise SGI PROM won't find the kernel:

root #echo 1 > /proc/sys/net/ipv4/ip_no_pmtu_disc

Set the port range usable by the SGI PROM:

root #echo "2048 32767" > /proc/sys/net/ipv4/ip_local_port_range

This should be sufficient to allow the Linux server to play nice with SGI's PROM.

Starting the daemons

At this point, start the daemons.

root #/etc/init.d/dhcp start
root #/etc/init.d/in.tftpd start

If nothing went wrong in that last step then everything is all set to power on the workstation and proceed with the guide. If the DHCP server isn't firing up for whatever reason, try running dhcpd on the command line and see what it says - if all is well, it should just fork into the background, otherwise it will display 'exiting.' just below its complaint.

An easy way to verify if the tftp daemon is running is to type the following command and confirm the output:

root #netstat -al | grep ^udp
udp        0      0 *:bootpc                *:*
udp        0      0 *:631                   *:*
udp        0      0 *:xdmcp                 *:*
udp        0      0 *:tftp                  *:* <-- (look for this line)

Netbooting the SGI station

Okay, everything is set, DHCP is running as is TFTP. Now it is time to fire up the SGI machine. Power the unit on - when "Running power-on diagnostics" comes on the screen, either click "Stop For Maintenance" or press Escape. A menu similar to the following will show up.

Running power-on diagnostics
System Maintenance Menu
  
1) Start System
2) Install System Software
3) Run Diagnostics
4) Recover System
5) Enter Command Monitor
Option?

Type in 5 to enter the command monitor. On the monitor, start the BootP process:

>>bootp(): root=/dev/ram0

From this point, the machine should start downloading the image, then, roughly 20 seconds later, start booting Linux. If all is well, a busybox ash shell will be started as shown below and the installation of Gentoo Linux can continue.

代码 When things are going right...
init started:  BusyBox v1.00-pre10 (2004.04.27-02:55+0000) multi-call binary
  
Gentoo Linux; http://www.gentoo.org/
 Copyright 2001-2004 Gentoo Technologies, Inc.; Distributed under the GPL
  
 Gentoo/MIPS Netboot for Silicon Graphics Machines
 Build Date: April 26th, 2004
  
 * To configure networking, do the following:
  
 * For Static IP:
 * /bin/net-setup <IP Address> <Gateway Address> [telnet]
  
 * For Dynamic IP:
 * /bin/net-setup dhcp [telnet]
  
 * If you would like a telnetd daemon loaded as well, pass "telnet"
 * As the final argument to /bin/net-setup.
  
Please press Enter to activate this console.

Troubleshooting

If the machine is being stubborn and refusing to download its image, it can be one of two things:

  1. The instructions were not followed correctly, or
  2. It needs a little gentle persuasion (No, put that sledge hammer down!)

Here's a list of things to check:

  • dhcpd is giving the SGI Machine an IP Address. There should be some messages about a BOOTP request in the system logs. tcpdump is also useful here.
  • Permissions are set properly in the tftp folder (typically /tftproot/ - should be world readable)
  • Check system logs to see what the tftp server is reporting (errors perhaps)

If everything on the server is checked, and timeouts or other errors occur on the SGI machine, try typing this into the console.

>>resetenv
>>unsetenv netaddr
>>unsetenv dlserver
>>init
>>bootp(): root=/dev/ram0

Netbooting on Cobalt stations

Overview of the netboot procedure

Unlike the SGI machines, Cobalt servers use NFS to transfer their kernel for booting. Boot the machine by holding down the left & right arrow buttons whilst powering the unit on. The machine will then attempt to obtain an IP number via BOOTP, mount the /nfsroot/ directory from the server via NFS, then try to download and boot the file vmlinux_raq-2800.gz (depending on the model) which it assumes to be a standard ELF binary.

Downloading a Cobalt netboot image

Inside http://distfiles.gentoo.org/experimental/mips/historical/netboot/cobalt/ the necessary boot images for getting a Cobalt up and running are made available. The files will have the name nfsroot-KERNEL-COLO-DATE-cobalt.tar - select the most recent one and unpack it to / as shown below:

root #tar -C / -xvf nfsroot-2.6.13.4-1.19-20051122-cobalt.tar

NFS server configuration

Since this machine uses NFS to download its image, it is necessary to export /nfsroot/ on the server. Install the net-fs/nfs-utils package:

root #emerge --ask net-fs/nfs-utils

Once that is done, place the following in the /etc/exports file.

文件 /etc/exportsExporting the /nfsroot directory
/nfsroot      *(ro,sync)

Now, once that is done, start the NFS server:

root #/etc/init.d/nfs start

If the NFS server was already running at the time, tell it to take another look at its exports file using exportfs.

root #exportfs -av

DHCP configuration for a Cobalt machine

Now, the DHCP side of things is relatively straightforward. Add the following to the /etc/dhcp/dhcpd.conf file.

文件 /etc/dhcp/dhcpd.confSnippet for Cobalt server
subnet xxx.xxx.xxx.xxx netmask xxx.xxx.xxx.xxx {
  # ... usual stuff here ...
  
  # Configuration for a Cobalt Server
  # Set the hostname here:
  host qube {
    # Path to the nfsroot directory.
    # This is mainly for when using the TFTP boot option on CoLo
    # You shouldn't need to change this.
    option root-path "/nfsroot";
  
    # Cobalt server's ethernet MAC address
    hardware ethernet 00:10:e0:00:86:3d;
  
    # Server to download image from
    next-server 192.168.10.1;
  
    # IP address of Cobalt server
    fixed-address 192.168.10.2;
  
    # Location of the default.colo file relative to /nfsroot
    # You shouldn't need to change this.
    filename "default.colo";
  }
}

Starting daemons

Now start the daemons. Enter the following:

root #/etc/init.d/dhcp start
root #/etc/init.d/nfs start

If nothing went wrong in that last step all should be set to power on the workstation and proceed with the guide. If the DHCP server isn't firing up for whatever reason, try running dhcpd on the command line and see what it tells - if all is well, it should just fork into the background, otherwise it will show 'exiting.' just below its complaint.

Netbooting the Cobalt machine

Now it is time to fire up the Cobalt machine. Hook up the null modem cable, and set the serial terminal to use 115200 baud, 8 bits, no parity, 1 stop bit, VT100 emulation. Once that is done, hold down the left and right arrow buttons whilst powering the unit on.

The back panel should display "Net Booting", and some network activity should be visible, closely followed by CoLo kicking in. On the rear panel, scroll down the menu until the "Network (NFS)" option then press Enter. Notice that the machine starts booting on the serial console.

...
elf: 80080000 <-- 00001000 6586368t + 192624t
elf: entry 80328040
net: interface down
CPU revision is: 000028a0
FPU revision is: 000028a0
Primary instruction cache 32kB, physically tagged, 2-way, linesize 32 bytes.
Primary data cache 32kB 2-way, linesize 32 bytes.
Linux version 2.4.26-mipscvs-20040415 (root@khazad-dum) (gcc version 3.3.3...
Determined physical RAM map:
 memory: 08000000 @ 00000000 (usable)
Initial ramdisk at: 0x80392000 (3366912 bytes)
On node 0 totalpages: 32768
zone(0): 32768 pages.
zone(1): 0 pages.
zone(2): 0 pages.
Kernel command line: console=ttyS0,115200 root=/dev/ram0
Calibrating delay loop... 249.85 BogoMIPS
Memory: 122512k/131072k available (2708k kernel code, 8560k reserved, 3424k dat)

A busybox ash shell will pop up as shown below, from which the Gentoo Linux installation can continue.

代码 When things are going right...
VFS: Mounted root (ext2 filesystem) readonly.
Freeing unused kernel memory: 280k freed
init started:  BusyBox v1.00-pre10 (2004.04.27-02:55+0000) multi-call binary
  
Gentoo Linux; http://www.gentoo.org/
 Copyright 2001-2004 Gentoo Technologies, Inc.; Distributed under the GPL
  
 Gentoo/MIPS Netboot for Cobalt Microserver Machines
 Build Date: April 26th, 2004
  
 * To configure networking, do the following:
  
 * For Static IP:
 * /bin/net-setup <IP Address> <Gateway Address> [telnet]
  
 * For Dynamic IP:
 * /bin/net-setup dhcp [telnet]
  
 * If you would like a telnetd daemon loaded as well, pass "telnet"
 * As the final argument to /bin/net-setup.
  
Please press Enter to activate this console.

Troubleshooting

If the machine is being stubborn and refusing to download its image, it can be one of two things:

  1. the instructions have not been followed correctly, or
  2. it needs a little gentle persuasion. (No, put that sledge hammer down!)

Here's a list of things to check:

  • dhcpd is giving the Cobalt Machine an IP Address. Notice messages about a BOOTP request in the system logs. tcpdump is also useful here.
  • Permissions are set properly in the /nfsroot/ folder (should be world readable).
  • Make sure the NFS server is running and exporting the /nfsroot/ directory. Check this using exportfs -v on the server.


使用一张安装CD

Handbook:MIPS/Blocks/Booting/zh-cn




自动网络检测配置

它能够自动检测到么？

如果系统接入到一个具有 IPv6 路由或 DHCP 服务器的以太网络，那么系统很可能会自动配置好网络。这样就不需要进一步进行高级配置了。你可以这样测试网络连接。

使用DHCP

DHCP（动态主机配置协议）协助网络配置，并可提供各种参数的配置，包括：IP地址、网络掩码、路由、DNS服务器、NTP服务器等。

DHCP 需要服务器和请求“lease”的客户端在相同的“layer 2”（以太网）网段上运行。DHCP 经常用于 RFC1918（“私有”）网络，但也经常用于从 ISP 获取公共 IP 信息。

提示
官方 Gentoo “启动介质”将在启动时自动运行 dhcpcd。你可以向“启动介质”的kernel 命令行中添加nodhcp以禁用此行为。

如果其未在运行，enp1s0 上的 dhcpcd 可以这样启动：

root #dhcpcd enp1s0

一些网络管理员要求你使用DHCP服务器所提供的主机名和域名。 这种情况下请用：

root #dhcpcd -HD enp1s0

如果要停止 dhcpcd，可以使用 -x：

root #dhcpcd -x
sending signal Term to pid 10831
waiting for pid 10831 to exit
另请参阅
使用 Dhcpcd

测试网络

正确配置的“默认”路由是互联网连接的重要组成部分，可通过以下方法检查路由配置：

root #ip route
default via 192.168.0.1 dev enp1s0

如果“默认”路由未定义，则无法连接互联网，需要进行额外配置。

基础互联网连接可以通过 ping 进行验证：

root #ping -c 3 1.1.1.1
提示
首先 ping 一个已知的 IP 地址而不是主机名，这样做很有帮助。这可以排除 DNS 问题对于基本互联网连接检验的干扰。

可通过以下方式确认出站 HTTPS 访问和 DNS 解析：

root #curl --location gentoo.org --output /dev/null

如果没有出现curl报错，或者其他测试失败，安装进程可以直接跳到准备磁盘。

如果 curl 报错，但互联网出站的 ping 请求正常工作，DNS 也许需要进行配置。

如果还没有建立互联网连接，应先核实接口信息，然后：

获取接口信息

如果网络连接不能正常工作，则必须采取其他步骤启用互联网连接。一般来说，第一步是列出主机网络接口。

ip 命令，属于 sys-apps/iproute2 软件包，他可以用来查询和配置系统网络。

link 参数可以用来显示网络接口的链接：

root #ip link
1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN mode DEFAULT group default qlen 1000
    link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
4: enp1s0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP mode DEFAULT group default qlen 1000
    link/ether e8:40:f2:ac:25:7a brd ff:ff:ff:ff:ff:ff

address 参数可以查询设备地址信息：

root #ip address
2: enp1s0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP group default qlen 1000
    link/ether e8:40:f2:ac:25:7a brd ff:ff:ff:ff:ff:ff
    inet 10.0.20.77/22 brd 10.0.23.255 scope global enp1s0
       valid_lft forever preferred_lft forever
    inet6 fe80::ea40:f2ff:feac:257a/64 scope link 
       valid_lft forever preferred_lft forever

此命令的输出包含每一次系统网络接口的信息。条目从设备索引开始，随后是设备名称：enp1s0。

提示
如果使用标准的ifconfig命令没有显示除了lo（“loopack”）以外的接口，则说明硬件有错误，或者接口驱动没有加载到内核中。这些情况都超过本手册的范围。联系#gentoo (webchat)寻求支持。

为了保持一致性，本手册中假设主要的网络接口为 enp1s0。

附注
因为名称变成了预测的网络接口名称（Predictable Network Interface Names），所以系统的接口名称可能和旧的 eth0 命名规则很不一样。现代的Gentoo启动介质使用的接口名称带有前缀，如eno0、ens1或enp5s0。

可选：应用特殊配置

下面的方法一般来说并不是必须的，但在需要进一步配置网络连接时也许有所帮助。

可选：配置网络代理

如果需要通过代理来访问互联网。那么必须为 Portage 定义代理信息，这样才能正确访问每个支持协议的代理。 Portage 使用 http_proxy、ftp_proxy 和 RSYNC_PROXY 环境变量，通过 wget 和 rsync 的检索机制来下载软件包。

link等某些基于文本的网络浏览器也可以使用环境变量来配置网络代理；特别是 HTTPS 访问需要https_proxy环境变量进行定义。在调用过程中，Portage 不会传递额外的运行时参数，而 links 则需要设置代理。

大多数情况下，只要将这个环境变量定义为代理服务器主机名。在下面的例子中，假定代理服务器的主机是 proxy.gentoo.org 并且端口为 8080。

附注
下列命令中的 # 符号是注释。添加 # 符号只是为了清楚起见，在输入命令时不需要输入 # 符号。

定义一个 HTTP 代理（用于 HTTP 和 HTTPS 流量）:

root #export http_proxy="http://proxy.gentoo.org:8080" # 同时应用到 Portage 和 Links
root #export https_proxy="http://proxy.gentoo.org:8080" # 只应用到 Links

如果代理需要验证，使用下面的语法来设置用户名和密码：

root #export http_proxy="http://username:password@proxy.gentoo.org:8080" # 同时应用到 Portage 和 Links
root #export https_proxy="http://username:password@proxy.gentoo.org:8080" # 只应用到 Links

使用下列参数启动可以为 links 使用代理：

user $links -http-proxy ${http_proxy} -https-proxy ${https_proxy}

为 Portage 和 links 定义 FTP 代理：

root #export ftp_proxy="ftp://proxy.gentoo.org:8080" # 同时应用到 Portage 和 Links

使用下列参数启动可以为 links 使用 FTP 代理：

user $links -ftp-proxy ${ftp_proxy}

为 Portage 定义 RSYNC 代理：

root #export RSYNC_PROXY="proxy.gentoo.org:8080" # 应用到 Portage：Links 不支持 rsync 代理

对 ADSL 使用 pppoe-setup

如果需要使用 PPPoE 访问互联网，Gentoo“启动介质”包含pppoe-setup脚本以简化ppp配置。

安装时，pppoe-setup 会询问：

  • 连接到 ADSL 调制解调器的以太网 接口 名称。
  • PPPoE 用户名和密码。
  • DNS 服务器 IP。
  • 是否需要防火墙。
root #pppoe-setup
root #pppoe-start

如果出现故障，则应验证 /etc/ppp/pap-secrets 或 /etc/ppp/chap-secrets 中的凭证。如果凭证正确，则应检查 PPPoE 以太网接口选择。

使用 PPTP

如果需要 PPTP 支持，可以使用 pptpclient，但是需要在使用前提前配置。

编辑 /etc/ppp/pap-secrets 或者 /etc/ppp/chap-secrets，让他们包含正确的用户名和密码：

root #nano /etc/ppp/chap-secrets

如果需要，继续调整/etc/ppp/options.pptp：

root #nano /etc/ppp/options.pptp

配置完成后，运行 pptp（带着一些options.pptp无法设定的选项）来连接到服务器：

root #pptp <server ipv4 address>

配置 WEP

警告
除非万不得已，不要使用 WEP。在开放网络上，WEP 基本不提供安全性保障
重要
iw只有在下列架构中可用：amd64, x86, arm, arm64, ppc, ppc64, and riscv。

当使用一块无线（802.11）网卡，在继续之前需要先配置无线设置。要查看当前无线网卡的设置，你可以使用iw。运行iw可能会显示如下：

root #iw dev wlp9s0 info
Interface wlp9s0
	ifindex 3
	wdev 0x1
	addr 00:00:00:00:00:00
	type managed
	wiphy 0
	channel 11 (2462 MHz), width: 20 MHz (no HT), center1: 2462 MHz
	txpower 30.00 dBm

检查当前连接：

root #iw dev wlp9s0 link
Not connected.

或

root #iw dev wlp9s0 link
Connected to 00:00:00:00:00:00 (on wlp9s0)
	SSID: GentooNode
	freq: 2462
	RX: 3279 bytes (25 packets)
	TX: 1049 bytes (7 packets)
	signal: -23 dBm
	tx bitrate: 1.0 MBit/s
附注
一些无线网卡的设备名可能是wlan0或ra0而不是 wlp9s0。运行 ip link 可以识别正确的设备名称。

对于大多数用户，只需要两个设置来连接，即ESSID（也称无线网络名称）和可选的WEP密钥。

  • 首先，确保接口处于活动状态：
root #ip link set dev wlp9s0 up
  • 连接到名为“GentooNode”的开放网络：
root #iw dev wlp9s0 connect -w GentooNode
  • 设置一个WEP密钥：使用d:前缀：
root #iw dev wlp9s0 connect -w GentooNode key 0:d:1234123412341234abcd
  • 使用ASCII WEP密钥连接：
root #iw dev wlp9s0 connect -w GentooNode key 0:some-password
附注
如果无线网络配置为WPA或WPA2，则需要使用wpa_supplicant。关于为Gentoo Linux配置无线网络的更多信息，请阅读Gentoo手册中的无线网络章节。

使用iw dev wlp9s0 link确认无线设置。如果无线已经工作，继续按下一章节（了解网络属于）配置IP级别的网络选项或者使用前面描述的net-setup工具。

使用 net-setup

如果自动网络配置不成功，Gentoo“启动介质”会提供脚本来帮助进行网络配置。net-setup 可用于配置无线网络信息和静态 IP。

root #net-setup enp1s0

net-setup将会询问关于网络环境的一些问题，并用这些信息配置wpa_supplicant或“静态寻址”。

重要
在进行任何配置后，网络的状态都需要检验。在配置脚本不起作用的情况下，需要手动配置网络。

互联网和 IP 基础

如果上述方法都失败，则必须手动配置网络。这并不是一件特别困难的事情，但在操作过程中应考虑周全。本节旨在阐明术语，并向用户介绍与手动配置互联网连接有关的基本网络概念。

提示
一些CPE（运营商提供设备）包含了“路由”、“接入点”、“调解器”、和“DNS 服务器”功能。我们必须分清设备功能和物理设备的不同。

接口和地址

网络“接口”是网络设备的逻辑表示。“接口”需要一个“地址”才能与“网络”上的其他设备通信。虽然只需要一个“地址”，但可以为一个“接口”分配多个地址。这对于双协议栈（IPv4 + IPv6）配置尤其有用。

为了保证一致性，本指南假定接口为enp1s0并将使用192.168.0.2地址。

重要
IP 地址可以任意设定。因此，这有可能造成多个设备使用相同的 IP 地址，从而导致“地址冲突”。地址冲突可以通过使用 DHCP 或 SLAAC 得到解决。
提示
IPv6 通常使用无状态地址自动配置（StateLess Address AutoConfiguration, SLAAC）进行地址配置。在多数情况下，手动配置IPv6不是个好操作。如果希望使用特定的地址后缀，可以使用接口识别令牌。

网络和 CIDR

当选定一个地址后，如何让一台设备知道怎样与其他设备交流呢？

IP“地址”关联着“网络”。IP“网络”是连续逻辑地址范围。

“无类别域间路由”或“CIDR”符号用于区分网络大小。

  • “CIDR”值通常以/开始，表示网络大小。
    • 公式“2 ^ (32 - CIDR)”可用于计算网络大小。
    • 计算出网络规模后，可用节点数必须减少2。
      • 网络中第一个 IP 地址是“网络地址”，最后一个是“广播地址”。这些地址是特殊的，且不能用于普通服务器。
提示
最常见的“CIDR”值是/24和/32，分别表示254个节点和一个节点。

/24的“CIDR”实际上是默认网络地址大小。这对应着子网掩码“255.255.255.0”，其中最后8位保留用于网络上的节点 IP 地址。

符号192.168.0.2/24可以解释为：

  • “地址”192.168.0.2
  • 位于“网络”192.168.0.0
  • 拥有大小 254（2 ^ (32 - 24) - 2）
    • 可用的 IP 段为 192.168.0.1 - 192.168.0.254
  • 具有“广播地址”192.168.0.255
    • 在多数情况下，最后一个网络地址是“广播地址”，但也可以修改。

使用这个配置，一台设备就可以与同一“网络”（192.168.0.0）上的任何设备交流。

互联网

当一个设备接入网络时，它如何知道怎样与互联网上的设备交流？

为了和本地“网络”之外的设备交流，就必须使用“路由”。“路由器”是一个简单的网络设备，用于转发其他设备的信息。术语“默认路由”或“网关”通常指当前网络上用于外部网络访问的任何设备。

提示
将“网关”设定为网络上的第一个或最后一个 IP 地址是标准操作。

如果连接互联网的路由器位于192.168.0.1，它可以设定为“默认路由”，掌管互联网访问。

总结来说：

  • 接口必须配置了“地址”或“网络”信息，例如“CIDR”值。
  • 本地网络访问用于与“路由器”连接到同一网络上。
  • “默认路由”需要配置，从而向外部网络发送的信息会被转发到“网关”，提供互联网访问。

域名系统

记忆 IP 地址很难。为了建立的“域名”与“IP 地址”的映射关系，我们建立了“域名系统”。

Linux 系统使用/etc/resolv.conf来定义用于“DNS解析”的“域名服务器”。

提示
很多“路由器”也有 DNS 服务器的功能，使用本地 DNS 服务器可以保护隐私并通过缓存提升查询速度。

许多 ISP 都运行 DNS 服务器，通常通过 DHCP 向 “网关 ”发布广告。使用本地 DNS 服务器往往会改善查询延迟，但大多数公共 DNS 服务器都会返回相同的结果，因此服务器的使用主要取决于偏好。

手动配置网络

配置接口地址

重要
手动配置 IP 地址时，必须考虑本地网络拓扑结构。IP 地址可以任意设置，但冲突可能会导致网络中断。

为了将 enp1s0 配置到地址 192.168.0.2 和 CIDR /24上：

root #ip address add 192.168.0.2/24 dev enp1s0
提示
此命令的开头可以简写为ip a。

配置默认路由

为接口配置地址和网络信息将配置 link 路由，并允许与此 network segment 通信：

root #ip route
192.168.0.0/24 dev enp1s0 proto kernel scope link src 192.168.0.2
提示
此命令可以简写为ip r。

通过default路由设定为192.168.0.1：

root #ip route add default via 192.168.0.1

配置 DNS

域名服务信息通常需要使用 DHCP，但也可以通过在/etc/resolv.conf添加nameserver条目手动设定。

警告
如果“dhcpcd”正在运行，/etc/resolv.conf的更改不会立即生效。可以通过ps x | grep dhcpcd查看状态。

nano包含在Gentoo“启动介质”中，可用于编辑/etc/resolv.conf：

root #nano /etc/resolv.conf

包含关键字 nameserver 和 DNS 服务器 IP 地址的行按定义顺序查询：

文件 /etc/resolv.conf使用Quad9 DNS
nameserver 9.9.9.9
nameserver 149.112.112.112
文件 /etc/resolv.conf使用 Cloudflare DNS
nameserver 1.1.1.1
nameserver 1.0.0.1

DNS 状态可以通过 ping 一个域名进行检查：

root #ping -c 3 gentoo.org

在确认连接成功后，请继续进行准备磁盘。





块设备简介

块设备

让我们来好好看看Gentoo Linux以及普通Linux中有关磁盘方面的知识，包括块设备、分区和Linux文件系统。一旦磁盘的来龙去脉都了解了，我们将设置分区和文件系统以进行安装。

首先，让我们来看看块设备。SCSI和SATA磁盘以/dev/sda,/dev/sdb,/dev/sdc等形式被标注。在更先进的设备中，基于PCI Express的NVMe固态磁盘一般以/dev/nvme0n1,/dev/nvme0n2等形式被标注。

下表将帮助读者确定在系统中哪里可以找到块设备的类型：

设备类型 默认设备句柄 社论笔记和注意事项
IDE，SATA，SAS，SCSI 或 USB 闪存 /dev/sda 从大约 2007 年到现在，这可能是 Linux 中最常用的设备句柄。这类设备可以连接在 SATA 总线，SCSI，USB 总线上作为块储存。例如，在第一个 SATA 设备的第一个分区称为 /dev/sda1。
NVM Express (NVMe) /dev/nvme0n1 NVMe设备是最新的固态技术，它连接在 PCI Express 总线，并且拥有市面上最快的传输速度。2014 年前后的系统可能会支持 NVMe 硬件。在第一个 NVMe 设备的第一个分区称为 /dev/nvme0n1p1。
MMC，eMMC 和 SD /dev/mmcblk0 嵌入式 MMC 设备，SD 卡和其它类型的记忆卡 可以作为数据存储使用。也就是说，许多系统可能不允许从这些类型的设备启动。建议不使用这些设备用来安装 Linux，而是考虑用它们来传输文件，这也是它们主要的设计意图。另外，这种储存类型很适合用来做短期的文件备份和快照。

上面的块设备代表磁盘的抽象接口。用户程序可以使用这些块设备来与你的磁盘进行交互，而无需担心驱动器到底是 SATA，SCSI 还是其他什么东西。该程序可以把磁盘当作一系列连续的，可随机访问的 4096 字节块（4K）的存储。

Handbook:MIPS/Blocks/Disks/zh-cn

创建文件系统

警告
在使用 SSD 或者 NVMe 驱动，请检查是否需要升级固件。特别是有些英特尔的 SSD（600p 和 6000p）需要升级固件来减少XFS I/O 使用模式导致的可能的数据损坏。问题位于固件层面而非 XFS 文件系统造成的。smartctl 组件可以检查型号和固件版本。

介绍

现在分区已经创建，该在上面设置文件系统了。下一章节中描述了 Linux 所支持的众多文件系统。知道使用哪一个文件系统的读者可以继续阅读为分区应用文件系统。剩下的人应该学习可用的文件系统……

文件系统

Linux 支持数十种文件系统，尽管其中许多只是为了特定目的而部署。在 mips 架构上只能找到某些稳定的文件系统 - 建议在为重要分区选择更具实验性的文件系统之前查阅文件系统及其支持状态。XFS 是推荐的全平台通用的文件系统。下面是一个不完全的文件系统列表：

btrfs
下一代文件系统，提供许多高级功能，例如快照、通过校验和进行自我修复、透明压缩、子卷和集成 RAID。不能保证 5.4.y 之前的内核在生产中与 btrfs 一起使用是安全的，因为对严重问题的修复仅存在于 LTS 内核分支的最新版本中。文件系统损坏问题在较旧的内核分支上很常见，比如说启用压缩后，较旧的内核（比 5.4.y 小）更可能发生损坏。 RAID 5/6 和配额组在所有版本的 btrfs 上都不安全。
ext4
Ext4 是一个可靠的、通用的全平台文件系统，但是它缺乏诸如引用链接之类的现代化功能。
f2fs
Flash-Friendly File System 最初是由三星为与 NAND 闪存一起使用而创建的。截至 2016 年第二季度，这个文件系统仍然被认为是不成熟的，但在将 Gentoo 安装到 microSD 卡、USB 驱动器或其他基于闪存的存储设备上时，它是一个不错的选择。
XFS
具有元数据日志的文件系统，具有强大的功能集并针对可扩展性进行了优化。 XFS 不断升级来支持现代化功能。 XFS 唯一的缺点是还不能缩减分区，不过这个问题正在解决中。XFS 特别支持反向链接和写入时复制（CoW），因为用户需要完成大量编译工作，所以对 Gentoo 系统很有用。推荐使用 XFS 这个现代化的通用全平台文件系统。XFS 要求分区至少300MB。
VFAT
也称为 FAT32，Linux 支持但不支持标准的 UNIX 权限设置。它主要用于与其他操作系统（Microsoft Windows 或 Apple 的 macOS）的互操作和交换，但也是某些系统引导加载程序固件（如 UEFI）的必需品。UEFI 系统的用户需要使用 VFAT 格式化的 EFI 系统分区才能启动。
NTFS
这个“新技术”文件系统是自 Windows NT 3.1 以来 Microsoft Windows 的旗舰文件系统。与 vfat 类似，它不存储 BSD 或 Linux 正常运行所需的 UNIX 权限设置或扩展属性，大多数情况下，不应将其用作为根文件系统。它应该仅用于与Microsoft Windows 系统的互操作和数据交换（注意强调仅）。

更多有关于文件系统的信息可以在社区维护的 文件系统文章 中找到。

为分区应用文件系统

附注
安装结束后，请确保在重新启动之前，为之后在手册中选择的文件系统 emerge 相应的用户空间组件软件包。在接近安装尾声时您将看到另一个提醒。

在一个分区或卷上创建一个文件系统，这里有用于每一个可能的分区的工具。 单击下表中的文件系统名称，了解每个文件系统的更多信息：

文件系统 创建命令 是否包含在live环境中？ 软件包
btrfs mkfs.btrfs 是 sys-fs/btrfs-progs
ext4 mkfs.ext4 是 sys-fs/e2fsprogs
f2fs mkfs.f2fs 是 sys-fs/f2fs-tools
xfs mkfs.xfs 是 sys-fs/xfsprogs
vfat mkfs.vfat 是 sys-fs/dosfstools
NTFS mkfs.ntfs 是 sys-fs/ntfs3g
重要
手册建议将新建分区作为安装过程的一部分，但值得在注意的是任何mkfs命令都会擦除分区上之前含有的任何数据。必要时，在创建文件系统之前应确保所有数据都被正确备份。

比如，在示例分区结构中，使用 xfs 的根分区（/dev/sda5），会使用下面的命令：

root #mkfs.xfs /dev/sda5

EFI 系统分区文件系统

EFI 系统分区（/dev/sda1）必须是 FAT32 格式：

root #mkfs.vfat -F 32 /dev/sda1

传统 BIOS 启动分区文件系统

通过带有 MBR/DOS 磁盘标签的传统 BIOS 启动的系统可使用引导加载程序支持的任何文件系统格式。

例如，XFS 格式：

root #mkfs.xfs /dev/sda1

小型 ext4 分区

在较小的分区（少于8 GiB）上使用 ext4 时，则创建文件系统时应带适当的选项以保留足够的 inode。这可以使用-T small 选项：

root #mkfs.ext4 -T small /dev/<device>

这样一般将是对于给定的文件系统inode数量的四倍，因为它的“字节每inode”从16kB每个减少到4kB每个。

激活 swap 分区

mkswap是用来初始化swap分区的命令：

root #mkswap /dev/sda10

要激活swap分区，使用swapon：

root #swapon /dev/sda10

由于交换分区是在实时环境中新创建的，所以才需要这一 “激活 ”步骤。系统重启后，只要交换分区在 fstab 或其他挂载机制中定义正确，交换空间就会自动激活。

挂载 root 分区

附注
之前开始但并未完成的安装可以从手册的这个位置开始继续进行。使用此链接作为固定链接：从这里继续未完成的安装。

一些 live 环境可能缺少推荐的 Gentoo 根分区挂载点（/mnt/gentoo），或在分区部分创建的其他分区的挂载点：

root #mkdir --parents /mnt/gentoo

仅对于 EFI 安装，ESP 应安装在根分区位置下：

root #mkdir --parents /mnt/gentoo

使用 mkdir 命令继续为之前步骤中创建的其他（自定义）分区创建必要的挂载点。

创建挂载点后，现在可以通过mount命令使得分区可以访问。

挂载根分区：

root #mount /dev/sda5 /mnt/gentoo

根据需要使用 mount 命令继续挂载其他（自定义）分区。

附注
如果/tmp/需要放在一个独立分区，确保在挂载后变更它的权限：
root #chmod 1777 /mnt/gentoo/tmp
这同样适用于/var/tmp。

在后面的介绍中，将挂载proc文件系统（一个内核的虚拟接口）和其它内核伪文件系统。不过首先必须提取 Gentoo stage 文件。





选择 stage 文件

提示
在支持的体系结构上，建议面向桌面（图形化）操作系统环境的用户使用名称中包含 desktop 的stage文件。这些文件包括 sys-devel/llvm 和 dev-lang/rust-bin 等包以及 USE 标志调整，这将大大缩短安装时间。

stage文件 充当 Gentoo 安装的种子。stage文件是发布工程团队使用Catalyst制作的。stage 文件基于特定的 profiles，并包含一个几乎完整的系统。

在选择stage文件时，选择一个具有与所需系统类型对应的配置文件目标的文件非常重要。

重要
虽然在建立安装后可以进行重大的配置文件更改，但切换需要大量的努力和考虑，并且超出了本安装手册的范围。切换 init 系统很困难，从 no-multilib 切换到 multilib 还需要广泛的 Gentoo 和低级工具链知识。
提示
大多数用户应该不需要使用“高级”tar包选项；它们用于一些不常见的和高级的软件或硬件配置。

OpenRC

OpenRC 是一个基于依赖的 init 系统（负责在内核启动后启动系统服务），OpenRC 与系统提供的 init 程序保持兼容，通常在 /sbin/init。它是 Gentoo 原创的 init 系统，但也部署在一些其它的 Linux 发行版和 BSD 系统。

默认情况下，OpenRC 不能替代 /sbin/init 文件 以及 100% 兼容 Gentoo init 脚本。这意味着可以在 Gentoo ebuild 仓库找到运行多个守护进程的解决方案。

systemd

systemd 是Linux 系统上一个现代化的 SysV 风格的 init 以及 rc 替代方案。大多数 Linux 发行版使用 systemd 作为主要的 init 系统。Gentoo 全面支持 systemd，并且已经达到预期。如果手册中似乎缺少 systemd 安装路径的内容，在寻求支持之前，请查看 systemd 文章。

multilib（32 位和 64 位）

附注
不是所有架构都有 multilib 选项。许多只使用原生代码运行。Multilib 最常应用于amd64。

multilib 配置文件尽可能使用 64 位库，并且仅在兼容性绝对必要时才回退到 32 位版本。对于大多数安装来说，这是一个很好的选择，因为它为将来的自定义提供了很大的灵活性。

提示
与 no-multilib 相比，使用 multilib 目标可以让以后切换换配置文件时更轻松

no-multilib（纯64位）

警告
刚开始使用 Gentoo 的读者，除非很有必要，否则不应该选择 no-multilib 包。把一个系统从 no-multilib 迁移到 multilib 需要极其丰富的使用Gentoo 的知识并熟悉底层的工具链。这一做法甚至可能使工具链开发者不寒而栗。因此不适合胆小的用户，而且也超出了本指南的范围。

选择 no-multilib 压缩包可以在系统的基础上提供完整的 64 位操作系统环境（不包含 32 位的软件）。尽管技术上可行，但这样会使切换到 multilib 配置文件的工作变得很复杂。

下载 stage 文件

在下载 stage 文件 之前，当前目录应该设置为用于安装的挂载位置：

root #cd /mnt/gentoo

设置日期和时间

Stage 存档通常使用 HTTPS 获取，这需要相对准确的系统时间。时钟偏差会阻止下载工作，如果在安装后将系统时间调整了相当多，则可能导致不可预知的错误。

可以使用 date 验证当前时间和日期：

root #date
Mon Oct  3 13:16:22 PDT 2021

如果显示的日期/时间超时几分钟，则应使用下列方法之一进行精确更新。

自动

使用 NTP 来纠正时钟偏差通常比手动设置系统时钟更容易、更可靠。

chronyd，net-misc/chrony 的一部分，可以使用这个命令将系统时间更新为UTC：

root #chronyd -q
重要
没有正常运行的实时时钟 （RTC） 的系统必须在每次系统启动时同步系统时钟，此后必须定期同步。这对于具有 RTC 的系统也有好处，因为电池可能会发生故障，并且时钟偏差可能会累积。
警告
标准 NTP 协议不包括身份验证，因此验证从网络获取的时间数据非常重要。

手动

当 NTP 访问不可用时，可以使用 date 手动设置系统时钟。

附注
建议所有 Linux 系统使用 UTC 时间。稍后在安装期间将定义时区，这将修改时钟的显示为本地时间。

以下参数格式用于设置时间：MMDDhhmmYYYY 语法（Month（月），Day（天），hour（小时），minute（分钟） 和 Year（年））。

比如，设置时间到 2021 年 10 月 3 日的 13:16，示例：

root #date 100313162021

图形化浏览器

可以使用图形化网页浏览器从主网站下载小节复制 stage 文件 URL。只需选择适当的选项卡，右键单击 stage 文件的链接，然后复制链接到剪贴板，然后将链接粘贴到命令行中的 wget 程序来下载 stage 文件：

root #wget <PASTED_STAGE_FILE_URL>

命令行浏览器

更多传统的读者或是 Gentoo 的“老前辈”专门使用命令行工作，他们可能更喜欢使用非图形化菜单驱动的浏览器 links（www-client/links）。 要下载一个 stage，请像下面这样访问Gentoo镜像列表：

root #links https://www.gentoo.org/downloads/mirrors/

要设置links使用一个HTTP代理，在传入URL上加一个-http-proxy选项：

root #links -http-proxy proxy.server.com:8080 https://www.gentoo.org/downloads/mirrors/

links之外还有一个 lynx（www-client/lynx）浏览器。和links 类似，它也是一个非图形化的浏览器，但不是自带的。

root #lynx https://www.gentoo.org/downloads/mirrors/

如果需要定义一个代理，设置http_proxy和/或ftp_proxy变量：

root #export http_proxy="http://proxy.server.com:port"
root #export ftp_proxy="http://proxy.server.com:port"

在镜像列表中，选择一个附近镜像站。通常HTTP镜像站就足够了，但其他网络协议是可用的。请访问releases/mips/autobuilds/ 。 那里将显示所有可用stage文件 （可能他们个别小组架构在命名的子目录中存储）。选择一个，然后按 d 下载。

stage 文件下载完成后，可以验证 stage 文件的完整性并验证其内容。感兴趣的人应该进行 下一节。

对验证 stage 文件不感兴趣的用户可以通过按 q 来关闭命令行浏览器，并且可以直接移步到 解包 stage 文件 部分。

验证

附注
大多数 stages 现在明确带有 init 系统类型 (openrc 或 systemd)后缀，尽管某些架构现在可能仍然缺少后缀。

与最小安装CD一样，可以使用额外的下载来验证stage文件。 虽然这些步骤可以被跳过，但这些文件是为那些关心他们刚刚下载的文件合法性的用户提供的。额外的文件位于 mirrors 目录的根目录下。浏览到硬件体系结构和系统配置文件的相应位置，并下载关联的 .CONTENTS.gz、.DIGESTS 和 .sha256 文件。

root #wget https://distfiles.gentoo.org/releases/
  • .CONTENTS 包含stage压缩包内的所有文件的列表的文件。
  • .DIGESTS 包含用不同的算法校验的stage文件的文件。
  • .sha256 包含 stage 文件的 PGP 签名 SHA256 校验和。并非所有 stage 文件都提供此文件下载。

加密工具和实用程序（如 openssl、sha256sum 或 sha512sum）可用于将输出与 .DIGESTS 文件提供的校验和进行比较。

使用 openssl 验证 SHA512 校验值：

root #openssl dgst -r -sha512 stage3-mips-<release>-<init>.tar.xz

dgst 指示 openssl 命令使用消息摘要子命令，-r 以 coreutils 格式打印摘要输出，-sha512 选择 SHA512 算法进行摘要。

使用 openssl 验证 BLAKE2B512 校验值：

root #openssl dgst -r -blake2b512 stage3-mips-<release>-<init>.tar.xz

将校验和命令的输出与 .DIGESTS 文件所比较。配对的值需要与校验和命令的输出匹配，否则下载的文件已损坏，应丢弃并重新下载。

要验证来自关联的 .sha256 文件，使用 sha256sum 工具：

root #sha256sum --check stage3-mips-<release>-<init>.tar.xz.sha256

--check 选项指示 sha256sum 读取预期文件和相关哈希的列表，然后为每个校验正确的文件打印关联的 “OK” 或校验错误的文件打印 “FAILED” 。

就像 ISO 文件一样，tar.xz 文件的加密签名可以使用 gpg 进行验证，以确保没有对 tarball 执行篡改。

对于官方的 Gentoo live image，sec-keys/openpgp-keys-gentoo-release 软件包为自动发布提供了 PGP 签名密钥。必须先将密钥导入到用户的会话中，才能用于验证：

root #gpg --import /usr/share/openpgp-keys/gentoo-release.asc

对于所有在 live 环境中提供 gpg 和 wget 的非官方 live 镜像，可以获取并导入包含 Gentoo 密钥的捆绑包：

root #wget -O - https://qa-reports.gentoo.org/output/service-keys.gpg | gpg --import

验证 tarball 的签名以及关联的校验和文件（可选）：

root #gpg --verify stage3-mips-<release>-<init>.tar.xz.asc
root #gpg --verify stage3-mips-<release>-<init>.tar.xz.DIGESTS
root #gpg --verify stage3-mips-<release>-<init>.tar.xz.sha256

如果验证成功，则 Good signature from（良好签名）将出现在先前命令的输出中。

OpenPGP 密钥的指纹用来对释出的安装媒介签名，在 发行的安装媒介签名页面 上可以找到 OpenPGP 密钥的指纹。

安装 stage 文件

下载完 stage 文件并且验证之后，可以使用 tar 提取 stage 文件：

root #tar xpvf stage3-*.tar.xz --xattrs-include='*.*' --numeric-owner

在提取之前，请验证选项：

  • x extract（提取），指示 tar 提取存档的内容。
  • p preserve（保留），保留权限。
  • V verbose（详细），提供详细输出。
  • f file（文件），为 tar 提供输入存档的名称。
  • --xattrs-include='*.*' 在存档中存储的所有命名空间中保留扩展属性。
  • --numeric-owner 确保从 tarball 中提取的文件的用户和组 ID 与 Gentoo 的发布工程团队的预期相同（即使冒险的用户在安装过程中没有使用官方的 Gentoo live 环境）。

现在stage文件已经解压好了，下面我们继续配置编译选项。

配置编译选项

介绍

优化系统时，可以设置影响 Portage 的变量，Gentoo 官方支持包管理器。 所有这些变量可以设置为环境变量（使用export），但通过 export 设置不是永久的。

附注
从技术上来说，可以通过 shell 的 配置文件或 rc 文件来导出变量，但这不是基本系统管理的最佳实践。

Portage 在运行时会读取 make.conf 文件，将根据文件中保存的值更改运行时行为。make.conf 可以认为是 Portage 的主要配置文件，因此请谨慎处理其内容。

提示
所有可能的变量的注释列表可以在 /mnt/gentoo/usr/share/portage/config/make.conf.example中找到。额外的关于 make.conf 文档可以运行 man 5 make.conf 查找。

要成功安装 Gentoo，只需设置下面提到的变量。

启动编辑器（在本指南中，我们使用 nano）来更改我们将在下面讨论的优化变量。

root #nano /mnt/gentoo/etc/portage/make.conf

从make.conf.example文件中可以明显看出文件的结构：注释行以 # 开头，其他行使用 VARIABLE="value" 语法定义变量。接下来选取其中的几个进行讨论。

CFLAGS 和 CXXFLAGS

CFLAGS 和 CXXFLAGS 变量分别定义了GCC C和C ++编译器的优化标志。 尽管这些标志一般在这里默认被定义过，但为了性能最大化，需要分别优化每个程序的这些配置。 原因是因为每个程序都不同。 但是，这是不可管理的，因此这些标志在 make.conf 文件中定义。

应该在make.conf中定义优化标志，这将使系统的响应速度最快。 不要在此变量中放置实验性的设置; 太多的优化可能会使程序产生问题（崩溃，甚至更糟，产生故障）。

Handbook不会解释所有可能的优化选项。 要了解它们，请阅读GNU在线手册或 gcc 信息页面 (info gcc)。make.conf.example 文件本身也包含了很多例子和信息; 不要忘了读它。

第一个设置是标志 -march= 和 -mtune= ，指定目标体系结构的名称。 可能用到的选项在make.conf.example文件中有描述（作为注释）。 一个常用的值是“native”，它告诉编译器选择当前系统体系结构（用户正在安装Gentoo时的系统）。

第二个是标志 -O（即大写的字母O，而不是数字零），它指定了gcc优化级别标志。 可能用到级别的是s（对于大小最优化），0（零 - 无优化），1,2或甚至3等更多的优化选项（每个级别具有与前面相同的标志，加上一些额外选项）。 -O2是建议的默认值。 -O3在整个系统范围内使用时会导致问题，因此我们建议您坚持使用-O2。

另一个普遍使用的优化标记是-pipe（不同编译阶段通信使用管道而不是临时文件）。它对产生的代码没有任何影响，但是会使用更多的内存。在内存不多的系统里，gcc可能会被杀掉。如果是那样的话，就不要用这个标记。

使用 -fomit-frame-pointer（它将不在寄存器里为不需要帧指针的函数保存帧指针）可能会在调试程序的时候造成严重后果！

在你定义 CFLAGS和CXXFLAGS的时候，你需要把这些优化标记都合并起来。stage文件里包含的你解压缩出来的默认值已经足够好了。下面这个例子仅仅是个例子：

代码 CFLAGS 和 CXXFLAGS 变量示例
# 为所有语言设置编译标志
COMMON_FLAGS="-mabi=32 -mips4 -pipe -O2"
# 为两个变量使用相同的设置
CFLAGS="${COMMON_FLAGS}"
CXXFLAGS="${COMMON_FLAGS}"
提示
通过 GCC 优化指导这篇文章获取有更多的信息，比如这些优化变量如何影响你的系统，Safe CFLAGS 也许是对初学者开始优化系统更实用的一篇文章

MAKEOPTS

通过使用 MAKEOPTS 可以定义在安装软件时，并行编译的数目。在 3.0.31 版本的 portage[1] 中，如果未定义该值， portage 默认的行为是，设置 MAKEOPTS 的值与 nproc 的返回线程数相同。

Further, as of Portage 3.0.53[2], if left undefined, Portage's default behavior is to set the MAKEOPTS load-average value to the same number of threads returned by nproc.

比较好的选择是从 CPU 线程数，或系统 RAM 总量除以 2 GiB 中选择是较小的那个值。

警告
大量的 job 显著消耗内存。建议每个 job 至少有 2 GiB RAM （所以，-j6 至少 需要 12 GiB）。避免内存溢出，根据可用内存降低 job 数量。
提示
当并行使用 emerge （--jobs），有效的 job 数量可以指数式加速（通过 emerge jobs 使 job 增加）。可以通过运行一个仅限于本地主机的 distcc 配置来解决这个问题，该配置将限制每个主机的编译器实例数量。
文件 /etc/portage/make.conf声明 MAKEOPTS 示例
# 如果未定义，Portage 的默认行为是：
# - 将 MAKEOPTS jobs 值设置为与 'nproc' 返回的相同线程数
# - 将 MAKEOPTS load-average 值设置为略高于 'nproc' 返回的线程数，因为它是一个阻尼值
# 请根据系统需要替换 '4' （使用系统线程数或GB记内存除以二的最小值），或者不设置。
MAKEOPTS="-j4 -l5"

在 man 5 make.conf 查找 MAKEOPTS 更多细节。

就位，预备，出发 ！

根据你的喜好更新并保存 /mnt/gentoo/etc/portage/make.conf（nano 用户可以敲 Ctrl+o 可以保存更改，然后 Ctrl+x 退出）。

References

  1. ↑ https://gitweb.gentoo.org/proj/portage.git/commit/?id=5d2af567772bb12b073f1671daea6263055cbdc2
  2. ↑ https://gitweb.gentoo.org/proj/portage.git/commit/?id=de7be7f45ee54e3f789def46542919550687d15e





Chrooting

复制DNS信息

在进行新环境之前，还有一件要做的事情就是复制/etc/resolv.conf中的DNS信息。需要完成这个来确保即使进入到新环境后网络仍然可以使用。/etc/resolv.conf包含着当前网络中的DNS服务器。

要复制这个信息，建议通过cp命令的 --dereference 选项。这可以保障如果/etc/resolv.conf是一个符号链接的话，复制的是那个目标文件而不是这个符号文件自己。否则在新环境中，符号文件将指向一个不存在的文件（因为链接目标非常可能不会在新环境中）。

root #cp --dereference /etc/resolv.conf /mnt/gentoo/etc/

挂载必要的文件系统

稍等片刻，Linux 的根目录将变更到新的位置。

需要提供的文件系统是：

  • /proc/ 是一个伪文件系统，虽然它看起来像是常规文件，但是却是由 Linux 内核生成
  • /sys/ 是一个伪文件系统，它类似被取代的 /proc/，但是比 /proc/ 更结构化
  • /dev/ 是一个包含全部设备文件的常规文件系统，一部分由Linux设备管理器（通常是udev）管理
  • /run/ 是一个临时文件系统，用于运行时生成的文件，例如 PID 文件和锁

/proc/位置将要挂载到/mnt/gentoo/proc/，而其它的都是绑定挂载。字面上的意思是，例如/mnt/gentoo/sys/事实上就是/sys/（它只是同一个文件系统的第二个条目点），而/mnt/gentoo/proc/是（可以说是）文件系统的一个新的挂载。

提示
如果使用官方Gentoo install镜像，这一步可以被简化为 arch-chroot /mnt/gentoo.
root #mount --types proc /proc /mnt/gentoo/proc
root #mount --rbind /sys /mnt/gentoo/sys
root #mount --make-rslave /mnt/gentoo/sys
root #mount --rbind /dev /mnt/gentoo/dev
root #mount --make-rslave /mnt/gentoo/dev
root #mount --bind /run /mnt/gentoo/run
root #mount --make-slave /mnt/gentoo/run
附注
--make-rslave操作是稍后安装systemd支持时所需要的。
警告
当使用非Gentoo安装媒介时，这时可能还不算完。一些发行版将/dev/shm符号链接到/run/shm/，在chroot后将变得不可用。为了让/dev/shm/是一个正常挂载的tmpfs，可以这样修复：
root #test -L /dev/shm && rm /dev/shm && mkdir /dev/shm
root #mount --types tmpfs --options nosuid,nodev,noexec shm /dev/shm

同时确保设置了权限为1777：

root #chmod 1777 /dev/shm /run/shm

进入新环境

现在所有的分区已经初始化，并且基础环境已经安装，是时候进入到新的安装环境了。这意思着会话将把根目录（能访问到最顶层的位置）从当前的安装环境（安装CD或其他安装媒介）变为安装系统（叫做初始化分区）。因此叫作 change root 或 chroot。

完成chroot有三个步骤：

  1. 如果可以的话，使用 chroot 或 arch-chroot 将根目录的位置从 /（在安装媒介里）更改成 /mnt/gentoo/ （在分区里）
  2. 使用 source 命令将一些设置（那些在 /etc/profile 中的）重新载入到内存中
  3. 更改主提示符来帮助我们记住当前会话在一个 chroot 环境里面。
root #chroot /mnt/gentoo /bin/bash
root #source /etc/profile
root #export PS1="(chroot) ${PS1}"

从现在开始，所有的动作将立即在新 Gentoo Linux 环境里生效。

提示
如果安装Gentoo时在这一步之后的任何地方中断，那么“应该”可以从这一步“继续”安装。不必再重新给磁盘分区！只需要挂载 root 分区 并运行上述步骤，然后通过复制 DNS 信息重新进入工作环境。 这也对修复引导程序问题很有用。更多的信息可以在 chroot 文章中找到。

Preparing for a bootloader

Now that the new environment has been entered, it is necessary to prepare the new environment for the bootloader. It will be important to have the correct partition mounted when it is time to install the bootloader.

UEFI 系统

For UEFI systems, was formatted with the FAT32 filesystem and will be used as the EFI System Partition (ESP). Create a new directory (if not yet created), and then mount ESP there:

root #mkdir
root #mount

DOS/Legacy BIOS systems

For DOS/Legacy BIOS systems, the bootloader will be installed into the /boot directory, therefore mount as follows:

root #mount /dev/sda1 /boot

配置 Portage

从网站安装 Gentoo ebuild 数据库快照

接下来，是安装 Gentoo ebuild 数据库。这个快照包含一组文件，包括通知 Portage 中有关可用软件的标题（用于安装），系统管理员可以选择哪些配置文件，软件包或 profile 特定新闻 (news) 项目等。

建议那些使用限制性防火墙的用户使用 emerge-webrsync 命令（它使用 HTTP / FTP 协议下载快照）节省网络带宽。 没有网络或带宽限制的读者可以愉快地跳到下一节。

这将从Gentoo的一个镜像中获取最新的快照（每天发布）并将其安装到系统上：

root #emerge-webrsync
附注
在这个操作中，emerge-webrsync可能会报找不到 /var/db/repos/gentoo/ 位置。这是预期内的并且不用担心——这个工具将会创建这个位置。

从现在开始，Portage 可能会提示建议运行某些更新。这是因为在安装了一个新的repository 快照后，Portage 发现了 stage 文件中已经安装的某些软件包有更新的版本。现在可以安全的忽略包的更新；可以延迟到 Gentoo 安装完成之后更新。


可选：选择镜像站点

为了能更快的下载源代码，推荐选择一个访问快、地理位置接近的镜像。Portage 将会在make.conf文件中查找GENTOO_MIRRORS变量，并使用其中所列的镜像。可以通过浏览 Gentoo 镜像列表搜索一个（或一组）最接近系统物理位置（往往那是最快的）的镜像。

镜像选择工具 mirrorselect 提供一个美观的文字界面（TUI）以便快速查询和选择合适的镜像源。使用时，导航到要选择的镜像源，按下Spacebar空格键以选择一个或多个镜像源。

root #emerge --ask --verbose --oneshot app-portage/mirrorselect
root #mirrorselect -i -o >> /etc/portage/make.conf

除此之外，可在这里找到一份可用镜像源列表。

可选：更新Portage ebuild 数据库

Gentoo 数据库可以更新到最新版本。前面的emerge-webrsync命令将安装一个最近的快照（通常是24小时以内），所以这一步是可选的。

假设需要最新更新的软件包（1小时以内），可以使用emerge --sync。这个命令将使用rsync协议来更新 Gentoo ebuild 数据库（之前通过emerge-webrsync获得的）到最新状态。

root #emerge --sync

在慢速的终端上，比如一些framebuffer或者串口控制台，建议使用--quiet选项来加速这个进程：

root #emerge --sync --quiet

阅读新闻条目

当同步Portage ebuild 数据库时，Portage 可能会输出类似于下面的信息：

* IMPORTANT: 2 news items need reading for repository 'gentoo'.
* Use eselect news to read news items.

创建新闻条目是为了提供一个通信媒介，通过 Gentoo ebuild 数据库来给用户推送重要的消息。可以使用 eselect news 管理新闻条目。eselect 应用程序是一个Gentoo 特有的应用程序，它允许使用通用管理接口来管理系统。在这里，要用到 eselect 的 news 模块。

对于news模块，最常用的有三个操作：

  • 使用list显示一个可用新闻条目的预览。
  • 使用read来阅读新闻条目。
  • 使用purge将在新闻条目阅读后删除，并且不能再次阅读。
root #eselect news list
root #eselect news read

可以通过新闻阅读器手册页查看更多关于新闻阅读器的信息：

root #man news.eselect

选择正确的配置文件

提示
桌面配置文件并非只是 桌面环境。也可能是小的窗口管理器，例如 i3 或 sway。

配置文件是任何一个Gentoo系统的积木。它不仅指定USE、CFLAGS和其它重要变量的默认值，还会锁定系统的包版本范围。这些设定全是由Gentoo的Portage开发者们来维护。

运行 eselect 使用 profile模块，能看到当前系统正在使用什么配置文件：

root #eselect profile list
Available profile symlink targets:
  [1]   default/linux/mips/23.0 *
  [2]   default/linux/mips/23.0/desktop
  [3]   default/linux/mips/23.0/desktop/gnome
  [4]   default/linux/mips/23.0/desktop/kde
附注
命令的这个输出只是一个示例，并会随时间演变。
附注
若要使用 systemd, 请选择名称中包含 "systemd" 的配置文件。否则，选择相反的配置文件。

一些架构还会有桌面的子配置文件。

警告
升级 profile 不能掉以轻心。 选择初始 profile 时，使用与最初使用的 stage3 “相同的版本”（例如 23.0 ）。 每个新的 profile 版本都通过新闻项目公布，新闻项目中包含了迁移说明。 在切换到较新的 profile 之前，请按照说明操作。

在看完框架的可用配置文件mips之后，用户可以键入以下命令为系统选择一个不同的配置文件：

root #eselect profile set 2



附注
developer 子配置文件是专用于Gentoo Linux开发，也就是说不适用于普通用户。

可选：添加二进制包源

从2023年12月开始，Gentoo的发布工程团队提供了一个官方的二进制包源（可以简称为“binhost”）供一般社区用于检索和安装二进制包 （binpkg）。[1]

添加二进制包源允许 Portage 安装加密签名的、编译的包。在许多情况下，添加二进制包主机将“大大”减少包安装的平均时间，并在较旧、较慢或低功耗的系统上运行 Gentoo 时增加很多好处。

存储库配置

The repository configuration for a binhost is found in Portage's /etc/portage/binrepos.conf/ directory, which functions similarly to the configuration mentioned in the Gentoo ebuild repository section.

When defining a binary host, there are two important aspects to consider:

  1. The architecture and profile targets within the sync-uri value do matter and should align to the respective computer architecture (mips in this case) and system profile selected in the Choosing the right profile section.
  2. Selecting a fast, geographically close mirror will generally shorten retrieval time. Review the mirrorselect tool mentioned in the Optional: Selecting mirrors section or review the online list of mirrors where URL values can be discovered.

文件 /etc/portage/binrepos.conf/gentoobinhost.confCDN-based binary package host example
[binhost]
priority = 9999
sync-uri = https://distfiles.gentoo.org/releases/<arch>/binpackages/<profile>/x86-64/

Installing binary packages

Portage will compile packages from code source by default. It can be instructed to use binary packages in the following ways:

  1. The --getbinpkg option can be passed when invoking the emerge command. This method of for binary package installation is useful to install only a particular binary package.
  2. Changing the system's default via Portage's FEATURES variable, which is exposed through the /etc/portage/make.conf file. Applying this configuration change will cause Portage to query the binary package host for the package(s) to be requested and fall back to compiling locally when no results are found.

For example, to have Portage always install available binary packages:

文件 /etc/portage/make.confConfigure Portage to use binary packages by default
# Appending getbinpkg to the list of values within the FEATURES variable
FEATURES="${FEATURES} getbinpkg"
# Require signatures
FEATURES="${FEATURES} binpkg-request-signature"

Please also run getuto for Portage to set up the necessary keyring for verification:

root #getuto

Additional Portage features will be discussed in the the next chapter of the handbook.

配置 USE 变量

USE是Gentoo为用户提供的最具威力的变量之一。很多程序通过它可以选择编译或者不编译某些可选的支持。例如，一些程序可以在编译时加入对 GTK+或是对Qt的支持。其它的程序可以在编译时加入或不加入对于SLL的支持。有些程序甚至可以在编译时加入对framebuffer的支持（svgalib）以取代X11（X服务器）。

大多数的发行版会使用尽可能多的支持特性编译它们的软件包，这既增加了软件的大小也减慢了启动时间，而这些还没有算上可能会涉及到的大量依赖性问题。Gentoo可以让你自己定义软件编译的选项，而这正是USE要做的事。

在USE变量里你可以定义关键字，它被用来对应相应的编译选项。例如，ssl将会把SSL支持编译到程序中以支持它。-X会移除其对于X服务器的支持（注意前面的减号）。gnome gtk -kde -qt5 将会以支持GNOME（和GTK+）但不支持KDE（和Qt）的方式编译软件，使系统为GNOME做完全调整（如果架构支持）。

默认的USE设置全放在了系统所使用的Gentoo配置文件的make.defaults文件中。Gentoo对它的配置文件们使用了一个（复杂的）继承系统，在这个阶段我们不去深入。最简单的检查当前活动的USE标记的办法是运行emerge --info并选择以USE开头的那一行：

root #emerge --info | grep ^USE
USE="X acl alsa amd64 berkdb bindist bzip2 cli cracklib crypt cxx dri ..."
附注
上面的示例被截断了，实际上的USE列表值是非常非常多的。

可以在系统的 /var/db/repos/gentoo/profiles/use.desc 中找到可用的USE标记的完整描述。

root #less /var/db/repos/gentoo/profiles/use.desc

在less命令中，可以通过使用↑和↓键来滚动，并且可以按q退出。

作为示例，我们展示一个支持DVD、ALSA,以及CD录制的基于KDE系统的USE设置：

root #nano /etc/portage/make.conf
文件 /etc/portage/make.conf为基于 KDE/Plasma 系统启用 DVD、ALSA 和 CD录制支持 flag
USE="-gtk -gnome qt5 kde dvd alsa cdr"

当在 /etc/portage/make.conf中定义一个 USE 值，会添加到系统 USE 标志中。USE 标志可以通过在列表内的值前面中添加 - 减号来全局移除。例如，禁用　X　图形化环境的支持，可以设置 -X：

文件 /etc/portage/make.conf忽略默认USE标记
USE="-X acl alsa"
警告
尽管可以设置 -*（这将禁用除 make.conf 中指定的值之外的所有 USE 值），但这样做很不推荐，也不理智。Ebuild 开发人员在 ebuild 中选择某些默认的 USE 标志值以防止冲突，增强安全性，避免错误，以及其他原因。禁用 所有 USE 标志将否定默认行为，并可能导致重大问题。

CPU_FLAGS_*

一些架构（包括 AMD64/X86、ARM、PPC）有称为 CPU_FLAGS_<ARCH> 的 USE_EXPAND 变量，请将 <ARCH> 替换为相应的系统架构名称。

重要
不要糊涂! AMD64 和 X86 系统有一些共同的架构，所以 AMD64 正确的变量名称是 CPU_FLAGS_X86。

该变量用于构建编译特定的汇编代码或其他内置函数——通常是手写或其它的， 并且与要求编译器输出针对某个 CPU 功能的优化代码不同。（例如 -march=）

如果需要，用户除了配置他们的 COMMON_FLAGS ，还应该设置此变量。

需要几个步骤来设置它：

root #emerge --ask --oneshot app-portage/cpuid2cpuflags

如果有疑问，请手动检查输出：

root #cpuid2cpuflags

然后复制输出到 package.use：

root #echo "*/* $(cpuid2cpuflags)" > /etc/portage/package.use/00cpu-flags

VIDEO_CARDS

VIDEO_CARDS USE_EXPAND 变量应根据使用的 GPU 进行适当配置。仅控制台安装则不需​​要设置 VIDEO_CARDS。

Below is an example of a properly set VIDEO_CARDS variable. Substitute the name of the driver(s) to be used.

文件 /etc/portage/make.conf
VIDEO_CARDS="amdgpu radeonsi"

Details for various GPU(s) can be found at the AMDGPU, Intel, Nouveau (Open Source), or NVIDIA (Proprietary) articles.

可选：配置 ACCEPT_LICENSE 变量

Starting with Gentoo Linux Enhancement Proposal 23 (GLEP 23), a mechanism was created to allow system administrators the ability to "regulate the software they install with regards to licenses... Some want a system free of any software that is not OSI-approved; others are simply curious as to what licenses they are implicitly accepting."[2] With a motivation to have more granular control over the type of software running on a Gentoo system, the ACCEPT_LICENSE variable was born.

Portage 在 ACCEPT_LICENSE 中查找允许安装的软件包。打印当前系统范围的值运行：

user $portageq envvar ACCEPT_LICENSE
@FREE

在 Gentoo 仓库中定义的许可证组，由 Gentoo Licenses project 项目管理，有：

组别名称 描述
@GPL-COMPATIBLE 由自由软件基金会批准的 GPL 兼容许可 GPL [a_license 1]
@FSF-APPROVED 由 FSF 批准的自由软件许可证（包括@GPL-COMPATIBLE ）
@OSI-APPROVED 由开放源代码促进会批准的许可证 [a_license 2]
@MISC-FREE Misc 许可证可能是自由软件，即遵循自由软件定义 [a_license 3] ，但不被 FSF 或 OSI 批准
@FREE-SOFTWARE 结合 @FSF-APPROVED，@OSI-APPROVED 和 @MISC-FREE
@FSF-APPROVED-OTHER 经 FSF 批准的“免费文档”和“除软件和文档外的实际使用作品”（包括字体）许可证
@MISC-FREE-DOCS 遵循自由定义的免费文档和其他作品（包括字体） [a_license 4]且没有在 @FSF-APPROVED-OTHE 中列出的杂项许可
@FREE-DOCUMENTS 结合 @FSF-APPROVED-OTHER 和 @MISC-FREE-DOCS
@FREE 所有许可证的 metaset，可以自由使用，共享，修改和共享修改。结合 @FREE-SOFTWARE 和 @FREE-DOCUMENTS
@BINARY-REDISTRIBUTABLE 至少允许以二进制形式自由分发软件的许可证。包括 @FREE
@EULA 试图剥夺您的权利的许可协议。与“保留所有权利”和需要明确的批准相比，@EULA 有更多的限制

Some common license groups include:

A list of software licenses grouped according to their kinds.
Name Description
@GPL-COMPATIBLE GPL compatible licenses approved by the Free Software Foundation [a_license 5]
@FSF-APPROVED Free software licenses approved by the FSF (includes @GPL-COMPATIBLE)
@OSI-APPROVED Licenses approved by the Open Source Initiative [a_license 6]
@MISC-FREE Misc licenses that are probably free software, i.e. follow the Free Software Definition [a_license 7] but are not approved by either FSF or OSI
@FREE-SOFTWARE Combines @FSF-APPROVED, @OSI-APPROVED, and @MISC-FREE.
@FSF-APPROVED-OTHER FSF-approved licenses for "free documentation" and "works of practical use besides software and documentation" (including fonts)
@MISC-FREE-DOCS Misc licenses for free documents and other works (including fonts) that follow the free definition [a_license 8] but are NOT listed in @FSF-APPROVED-OTHER.
@FREE-DOCUMENTS Combines @FSF-APPROVED-OTHER and @MISC-FREE-DOCS.
@FREE Metaset of all licenses with the freedom to use, share, modify and share modifications. Combines @FREE-SOFTWARE and @FREE-DOCUMENTS.
@BINARY-REDISTRIBUTABLE Licenses that at least permit free redistribution of the software in binary form. Includes @FREE.
@EULA License agreements that try to take away your rights. These are more restrictive than "all-rights-reserved" or require explicit approval
  1. ↑ https://www.gnu.org/licenses/license-list.html
  2. ↑ https://www.opensource.org/licenses
  3. ↑ https://www.gnu.org/philosophy/free-sw.html
  4. ↑ https://freedomdefined.org/
  5. ↑ https://www.gnu.org/licenses/license-list.html
  6. ↑ https://www.opensource.org/licenses
  7. ↑ https://www.gnu.org/philosophy/free-sw.html
  8. ↑ https://freedomdefined.org/

Currently set system wide acceptable license values can be viewed via:

user $portageq envvar ACCEPT_LICENSE
@FREE

As visible in the output, the default value is to only allow software which has been grouped into the @FREE category to be installed.

Specific licenses or licenses groups for a system can be defined in the following locations:

  • 整个系统的在已选择的 profile。
  • 整个系统的在 /etc/portage/make.conf。
  • 每个软件包的在 /etc/portage/package.license 文件。
  • 每个软件包的在/etc/portage/package.license/ 目录 或文件。

可选择通过在配置文件中更改 /etc/portage/make.conf 覆盖系统范围默认接受项。

文件 /etc/portage/make.conf如何在系统范围接受 ACCEPT_LICENSE 许可证示例
ACCEPT_LICENSE="-* @FREE @BINARY-REDISTRIBUTABLE"

也可以选择为每个软件包定义接受的许可证，如下面的文件目录所示。需要注意的是，如果 package.license 目录不存在的话，需要创建该目录。

root #mkdir /etc/portage/package.license

Software license details for an individual Gentoo package are stored within the LICENSE variable of the associated ebuild. One package may have one or many software licenses, therefore it be necessary to specify multiple acceptable licenses for a single package.

文件 /etc/portage/package.license/kernel如何接受每个软件包的许可证示例
app-arch/unrar unRAR
sys-kernel/linux-firmware @BINARY-REDISTRIBUTABLE
sys-firmware/intel-microcode intel-ucode
重要
ebuild 中 的 LICENSE 变量仅是为 Gentoo 开发人员和用户准备的一份指南。它既不是法律声明，也不保证其真实性。因此不要过度依赖它，您需要深入检查软件包的本身，以及已经安装到系统的所有文件。

更新@world集合

当系统应用了任何升级，或从 任何profile 构建了stage3 后，应用了变化的 use 标记时，下一步是必要的。

  1. A profile target different from the stage file has been selected.
  2. Additional USE flags have been set for installed packages.

Readers who are performing an 'install Gentoo speed run' may safely skip @world set updates until after their system has rebooted into the new Gentoo environment.

Readers who are performing a slow run can have Portage perform updates for package, profile, and/or USE flag changes at the present time:

root #emerge --ask --verbose --update --deep --newuse @world

Removing obsolete packages

It is important to always depclean after system upgrades to remove obsolete packages. Review the output carefully with emerge --depclean --pretend to see if any of the to-be-cleaned packages should be kept if personally using them. To keep a package which would otherwise be depcleaned, use emerge --noreplace foo.

root #emerge --ask --pretend --depclean

If happy, then proceed with a real depclean:

root #emerge --ask --depclean
提示
如果选择了桌面环境配置文件，则此过程可能大大增加安装过程所需的时间量。时间紧迫的人可以通过这个“经验法则”工作：配置文件名称越短，系统 @world 集 越不具体; @world 集越不具体，系统将需要的软件包越少。换一种说法：
  • 选择 default/linux/amd64/23.0 将只有很少的包被重装或更新
  • 选择 default/linux/amd64/23.0/desktop/gnome/systemd 将需要安装许多软件包，因为 init 系统要从 OpenRC 更改为 systemd，并且将安装 GNOME 桌面环境框架。


时区

附注
这一步不适用于 musl libc 用户。不知道 musl libc 是什么的用户应该执行此步骤。

请避免使用 /usr/share/zoneinfo/Etc/GMT* 时区，它们的名字并不意味着想要的时区。例如，GMT-8 实际上是 GMT+8。

为系统选择时区。在/usr/share/zoneinfo/中查找可用的时区，然后写进/etc/timezone文件。

root #ls /usr/share/zoneinfo
root #ls -l /usr/share/zoneinfo/Europe/
total 256
-rw-r--r-- 1 root root 2933 Dec  3 17:19 Amsterdam
-rw-r--r-- 1 root root 1742 Dec  3 17:19 Andorra
-rw-r--r-- 1 root root 1151 Dec  3 17:19 Astrakhan
-rw-r--r-- 1 root root 2262 Dec  3 17:19 Athens
-rw-r--r-- 1 root root 3664 Dec  3 17:19 Belfast
-rw-r--r-- 1 root root 1920 Dec  3 17:19 Belgrade
-rw-r--r-- 1 root root 2298 Dec  3 17:19 Berlin
-rw-r--r-- 1 root root 2301 Dec  3 17:19 Bratislava
-rw-r--r-- 1 root root 2933 Dec  3 17:19 Brussels
...

假设要选择的时区是 “Europe/Brussels”。

OpenRC

我们把时区名称写入 /etc/timezone 文件。

root #echo "Europe/Brussels" > /etc/timezone

接下来，重新配置 sys-libs/timezone-data 包，将会为我们基于 /etc/timezone 条目更新 /etc/localtime 文件。 /etc/localtime 文件用于让系统的 C 类库知道系统在什么时区。

root #emerge --config sys-libs/timezone-data
附注
The /etc/localtime file is used by the system C library to know the timezone the system is in.

systemd

当使用 systemd 时，采用一种稍有不同的方法。生成一个符号链接：

root #ln -sf ../usr/share/zoneinfo/Europe/Brussels /etc/localtime

之后当 systemd 运行时，时区和相关设置可以使用 timedatectl 命令配置。

配置区域设置

附注
这一步不适用于 musl libc 用户。不知道 musl libc 是什么的用户应该执行此步骤。

生成区域设置

大多数用户只想在他们的系统上使用一或两个地区。

Locale 不只是指定用户应该使用与系统进行交互的语言，同时也指定了字符串排序，日期和时间的显示等规则。Locale 是 "区分大小写" 的，必须完全按照描述的方式表示。完整的 locale 可用列表可以在 /usr/share/i18n/SUPPORTED 文件中找到。

系统支持的 locale 必须在 /etc/locale.gen 文件中定义。

root #nano /etc/locale.gen

下面的地区是一个示例，展示了同时使用英语（美国）和德语（德国）及附加字符格式（如 UTF-8）。

文件 /etc/locale.gen启用US和 DE 地区及附加字符格式
en_US ISO-8859-1
en_US.UTF-8 UTF-8
de_DE ISO-8859-1
de_DE.UTF-8 UTF-8
警告
许多应用程序需要至少有 UTF-8 区域设置才能正确构建。

下一步是运行 locale-gen 命令。此命令会生成 /etc/locale.gen 文件中所有指定的地区。

root #locale-gen

要验证当前所选择的 locale 可用，可以运行 locale -a。

在 systemd 安装中，可以使用 localectl，例如 localectl set-locale ... 或者 localectl list-locales。

选择区域设置

等完成后，我们就来设定系统级别的区域设置。我们再次使用 eselect 设定区域设置，现在使用 locale 模块。

通过 eselect locale list 可显示可用的目标：

root #eselect locale list
Available targets for the LANG variable:
  [1]  C
  [2]  C.utf8
  [3]  en_US
  [4]  en_US.iso88591
  [5]  en_US.utf8
  [6]  de_DE
  [7]  de_DE.iso88591
  [8]  de_DE.utf8
  [9] POSIX
  [ ]  (free form)

可以使用 eselect locale set <NUMBER> 选择正确的区域设置：

root #eselect locale set 2

还可以手动编辑 /etc/env.d/02locale 文件，在 systemd 是 /etc/locale.conf 文件，来选择区域设置：

文件 /etc/env.d/02locale手动设置系统区域设置 定义
LANG="de_DE.UTF-8"
LC_COLLATE="C.UTF-8"

设定区域设置可以避免在后面安装中，内核和软件汇编时的警告和错误。

现在重新加载环境：

root #env-update && source /etc/profile && export PS1="(chroot) ${PS1}"

更多有关区域设置选择过程的指导，另请参阅本地化指南和 UTF-8 指南。

References

  1. ↑ https://www.gentoo.org/news/2023/12/29/Gentoo-binary.html
  2. ↑ https://www.gentoo.org/glep/glep-0023.html#id7





可选：安装固件和微代码

固件

Linux Firmware

在开始配置内核部分之前，最好了解下，一些硬件设备需要先在系统上安装附加的固件，有时是非自由及开放源代码软件（FOSS）才能正常运行。我们经常网络接口上会使用附加的固件，特别是无线网络接口，常用于台式电脑和笔记本电脑。此外，来自 AMD，Nvidia 和 Intel 等供应商的现代视频芯片，要想使用完整的功能，通常也需要外部固件文件。现代硬件设备的大多数固件都可以在 sys-kernel/linux-firmware 软件包中找到。

为了在必要时提供固件，首次重启系统之前推荐安装 sys-kernel/linux-firmware 软件包：

root #emerge --ask sys-kernel/linux-firmware
附注
安装某些固件软件包时，经常需要接受固件关联的许可证。有需要的话，访问手册的许可证处理章节有助于你接受许可证。

注意，当内核以模块（M）加载内核符号时，将从文件系统中加载其相关的固件文件。对于以模块加载的符号，没有必要把设备固件文件加入内核二进制镜像中。

微码

除了独立显卡硬件和网络接口之外，CPU 可能也需要固件更新。通常这种固件被称为微码（microcode）。有时需要更新版本的微码来修补 CPU 硬件中的不稳定性、安全问题或其他复杂的错误。

AMD CPU 的微码更新在前面提到的 sys-kernel/linux-firmware 软件包内分发。Intel CPU 的微码可以在 sys-firmware/intel-microcode 包中找到，并且需要单独安装。更多有关如何更新微码的细节，请查看微码文章。

内核配置和编译

现在是时候来配置和编译内核源代码了。将介绍三种用内核管理安装的方法，但是安装后，任何时候都可以采用新的方法。

由操作最少到操作最多排序：

全自动方法：Distribution 内核
Distribution 内核用来配置、自动构建安装 Linux 内核、相关模块和 initramfs 文件（可选，但是默认启用）。将来内核就像其他的系统软件包一样，通过使用包管理器全自动升级。如果需要定制内核，它可以提供自定义内核配置文件。这种过程操作最少，并且非常适合新 Gentoo 用户，因为它开箱即用，并且系统管理员最少参与。
混合方法：Genkernel
通过系统包管理器安装新内核源代码。系统管理员可以使用 Gentoo 的 genkernel 工具的配置，构建和安装 Linux 内核、相关模块和 initramfs 文件（可选，但默认不 启用）。如果要自定义内核，它可以提供自定义内核配置文件。将来每次更新内核配置、编译和安装都需要系统管理员运行 eselect kernel，genkernel和其他可能的命令。
全手动方法
通过系统包管理器安装新的内核源代码。使用 eselect kernel 和一大堆 make 命令手动配置、构建和安装内核。将来内核升级需要重复手动配置、构建和安装内核文件的过程。这是操作做多的过程，但是在内核更新过程提供最大程度控制。

Linux内核是所有发行版的核心。它位于用户程序和系统硬件之间。尽管手册提供给用户一些可选的内核源码，但是在内核概述页面有更全面的列表，上面有着更多的细节描述。

提示
Kernel installation tasks such as, copying the kernel image to /boot or the EFI System Partition, generating an initramfs and/or Unified Kernel Image, updating bootloader configuration, can be automated with installkernel. Users may wish to configure and install sys-kernel/installkernel before proceeding. See the Kernel installation section below for more more information.

安装内核源码

附注
本小节只有关于使用 genkernel（混合）或手动内核管理方法

The use of sys-kernel/installkernel is not strictly required, but highly recommended. When this package is installed, the kernel installation process will be delegated to installkernel. This allows for installing several different kernel versions side-by-side as well as managing and automating several tasks relating to kernel installation described later in the handbook. Install it now with:

root #emerge --ask sys-kernel/installkernel

当为基于 mips 的系统安装和编译内核时，Gentoo 推荐使用 sys-kernel/mips-sources 软件包。

选择一个合适的内核并使用 emerge 来安装它。

root #emerge --ask sys-kernel/mips-sources

这将在 /usr/src/ 中安装路径中特定版本的 Linux 内核源码。如果没有在所选内核源码包内启用 USE=symlink，它将不会自行创建符号链接。

我们习惯性的维护 /usr/src/linux 符号链接。这样，它指向与当前运行的内核相对应的源代码。然而，默认情况下不会创建这个符号链接。有一个简单创建符号链接的方法是利用 eselect 的内核模块。

更多有关符号链接的信息以及如何管理符号链接，请参考升级内核。

首先，列出所有已安装的内核：

root #eselect kernel list
Available kernel symlink targets:
  [1]   linux-6.6.21-gentoo

要创建一个名为 linux 的符号链接，使用：

root #eselect kernel set 1
root #ls -l /usr/src/linux
lrwxrwxrwx    1 root   root    12 Oct 13 11:04 /usr/src/linux -> linux-6.6.21-gentoo

可选：手动配置

介绍

附注
In case it was missed, this section requires the kernel sources to be installed. Be sure to obtain the relevant kernel sources, then return here for the rest of section.

手动配置内核经常被 Linux 用户认为是最困难的步骤。但是事实并非如此──当您手动配置几次内核之后，你就不会再觉得它有多么难了！

无论如何，有一件事是真实的：当手动配置内核时，了解（硬件）系统是至关重要的。大多数信息可以通过安装包含lspci命令的sys-apps/pciutils来收集：

root #emerge --ask sys-apps/pciutils
附注
在chroot中，可以安全的忽略任何lspci可能抛出的关于pcilib的警告（比如pcilib: cannot open /sys/bus/pci/devices）。

另一个系统信息来源是运行lsmod来查看安装CD使用什么内核模块，它可能对启用什么提供了一个好的暗示。

现在进入内核源码目录并执行make menuconfig。这将启动一个菜单驱动的配置屏幕。

root #cd /usr/src/linux
root #make menuconfig

Linux 内核配置有很多很多的章节。我们先列出一些必须激活的选项（否则 Gentoo 将无法工作，或者离开附加的调整将无法正常工作）。我们同时在 Gentoo 维基上有一个 Gentoo 内核配置指南可能会在将来有帮助。

启用必要的选项

当使用 sys-kernel/gentoo-sources 时，强烈推荐启用 Gentoo 特有的配置选项。这些确保了系统可以正常运行所需的最少内核特性：

内核 启用 Gentoo 特有选项
Gentoo Linux --->
  Generic Driver Options --->
    [*] Gentoo Linux support
    [*]   Linux dynamic and persistent device naming (userspace devfs) support
    [*]   Select options required by Portage features
        Support for init systems, system and service managers  --->
          [*] OpenRC, runit and other script based systems and managers
          [*] systemd

当然，最后两行的选择取决于所选择的 init 系统 (OpenRC 对比 systemd)。但是两种 init 系统都启用也并没有害处。

当使用 sys-kernel/vanilla-sources时，不能使用额外的 init 系统。可以使用已启用的 init 系统，但这超出了手册的范围。

启用典型的系统组件支持

确保引导系统的每一个至关重要的驱动（比如 SATA 控制器，NVMe 块设备支持，文件系统支持，等等）是编译进内核而不是作为一个模块，否则系统将无法完全引导。

接下来选择最正确的CPU类型。同时建议启用MCE功能（如果可用）能在硬件出现问题时通知用户。在一些架构（比如x86_64），这些错误不会打印到 dmesg，但是会到/dev/mcelog。这需要app-admin/mcelog包。

同时选择Maintain a devtmpfs file system to mount at /dev来让重要的设备文件在引导过程的早期就已就绪(CONFIG_DEVTMPFS and CONFIG_DEVTMPFS_MOUNT):

内核 启用 devtmpfs 支持（CONFIG_DEVTMPFS）
Device Drivers --->
  Generic Driver Options --->
    [*] Maintain a devtmpfs filesystem to mount at /dev
    [*]   Automount devtmpfs at /dev, after the kernel mounted the rootfs

验证 SCSI 磁盘支持是否已激活(CONFIG_BLK_DEV_SD):

内核 启用 SCSI 磁盘支持（CONFIG_SCSI, CONFIG_BLK_DEV_SD）
Device Drivers --->
  SCSI device support  ---> 
    <*> SCSI device support
    <*> SCSI disk support
内核 启用基础 SATA 和 PATA 支持（CONFIG_ATA_ACPI, CONFIG_SATA_PMP, CONFIG_SATA_AHCI, CONFIG_ATA_BMDMA, CONFIG_ATA_SFF, CONFIG_ATA_PIIX）
Device Drivers --->
  <*> Serial ATA and Parallel ATA drivers (libata)  --->
    [*] ATA ACPI Support
    [*] SATA Port Multiplier support
    <*> AHCI SATA support (ahci)
    [*] ATA BMDMA support
    [*] ATA SFF support (for legacy IDE and PATA)
    <*> Intel ESB, ICH, PIIX3, PIIX4 PATA/SATA support (ata_piix)

验证已经启用基础 NVMe 支持：

内核 启用 Linux 4.4.x 基础 NVMe 支持（CONFIG_BLK_DEV_NVME）
Device Drivers  --->
  <*> NVM Express block device
内核 启用 Linux 5.x.x 基础 NVMe 支持（CONFIG_DEVTMPFS）
Device Drivers --->
  NVME Support --->
    <*> NVM Express block device

也可以启用下列额外的 NVMe 支持：

内核 启用额外的 NVMe 支持（CONFIG_NVME_MULTIPATH，CONFIG_NVME_MULTIPATH，CONFIG_NVME_HWMON，CONFIG_NVME_FC，CONFIG_NVME_TCP，CONFIG_NVME_TARGET，CONFIG_NVME_TARGET_PASSTHRU，CONFIG_NVME_TARGET_LOOP，CONFIG_NVME_TARGET_FC，CONFIG_NVME_TARGET_FCLOOP，CONFIG_NVME_TARGET_TCP
[*] NVMe multipath support
[*] NVMe hardware monitoring
<M> NVM Express over Fabrics FC host driver
<M> NVM Express over Fabrics TCP host driver
<M> NVMe Target support
  [*]   NVMe Target Passthrough support
  <M>   NVMe loopback device support
  <M>   NVMe over Fabrics FC target driver
  < >     NVMe over Fabrics FC Transport Loopback Test driver (NEW)
  <M>   NVMe over Fabrics TCP target support

现在进入File Systems并选择系统将使用的文件系统。不要作为模块来编译根文件系统所使用的文件系统，否则系统可能不挂载这个分区。同时选择Virtual memory和/proc file system根据系统的需要选择一个或多个以下选项：

内核 启用文件系统支持 (CONFIG_EXT2_FS, CONFIG_EXT3_FS, CONFIG_EXT4_FS, CONFIG_BTRFS_FS, CONFIG_XFS_FS, CONFIG_MSDOS_FS, CONFIG_VFAT_FS, CONFIG_PROC_FS, and CONFIG_TMPFS)
File systems --->
  <*> Second extended fs support
  <*> The Extended 3 (ext3) filesystem
  <*> The Extended 4 (ext4) filesystem
  <*> Btrfs filesystem support
  <*> XFS filesystem support
  DOS/FAT/NT Filesystems  --->
    <*> MSDOS fs support
    <*> VFAT (Windows-95) fs support
  Pseudo Filesystems --->
    [*] /proc file system support
    [*] Tmpfs virtual memory file system support (former shm fs)

如果使用PPPoE连接到互联网，或者是拨号调制解调器，则启用下面的选项(CONFIG_PPP, CONFIG_PPP_ASYNC, and CONFIG_PPP_SYNC_TTY)：

内核 启用 PPPoE 所需要的驱动（PPPoE，CONFIG_PPPOE，CONFIG_PPP_ASYNC，CONFIG_PPP_SYNC_TTY
Device Drivers --->
  Network device support --->
    <*> PPP (point-to-point protocol) support
    <*>   PPP support for async serial ports
    <*>   PPP support for sync tty ports

这两个压缩选项将是无害的，但是它们一定是不需要的，包括基于以太网的PPP选项也是一样，只有在配置内核模式PPPoE时才会需要。

不要忘记在内核中包括网（以太网或无线）卡。

大多数系统会有多核心处理，所以激活 Symmetric multi-processing support（对称多处理） 很重要 (CONFIG_SMP)：

内核 激活 SMP 支持（CONFIG_SMP）
Processor type and features  --->
  [*] Symmetric multi-processing support
附注
在多核系统中，每个核心视为一个处理器。

如果使用USB输入设备（比如键盘和鼠标）或其他USB设备，不要忘记启用那些：

内核 启用 USB 和人类输入设备支持（CONFIG_HID_GENERIC，CONFIG_USB_HID，CONFIG_USB_SUPPORT，CONFIG_USB_XHCI_HCD，var>CONFIG_USB_EHCI_HCD，CONFIG_USB_OHCI_HCD，(CONFIG_HID_GENERIC，CONFIG_USB_HID，CONFIG_USB_SUPPORT，CONFIG_USB_XHCI_HCD，CONFIG_USB_EHCI_HCD，CONFIG_USB_OHCI_HCD，CONFIG_USB4）
HID support  --->
    -*- HID bus support
    <*>   Generic HID driver
    [*]   Battery level reporting for HID devices
      USB HID support  --->
        <*> USB HID transport layer
  [*] USB support  --->
    <*>     xHCI HCD (USB 3.0) support
    <*>     EHCI HCD (USB 2.0) support
    <*>     OHCI HCD (USB 1.1) support

Optional: Signed kernel modules

To automatically sign the kernel modules enable CONFIG_MODULE_SIG_ALL:

内核 Sign kernel modules CONFIG_MODULE_SIG_ALL
[*] Enable loadable module support  
  -*-   Module signature verification    
    [*]     Automatically sign all modules    
    Which hash algorithm should modules be signed with? (Sign modules with SHA-512) --->

Optionally change the hash algorithm if desired.

To enforce that all modules are signed with a valid signature, enable CONFIG_MODULE_SIG_FORCE as well:

内核 Enforce signed kernel modules CONFIG_MODULE_SIG_FORCE
[*] Enable loadable module support  
  -*-   Module signature verification    
    [*]     Require modules to be validly signed
    [*]     Automatically sign all modules
    Which hash algorithm should modules be signed with? (Sign modules with SHA-512) --->

To use a custom key, specify the location of this key in CONFIG_MODULE_SIG_KEY, if unspecified the kernel build system will generate a key. It is recommended to generate one manually instead. This can be done with:

root #openssl req -new -nodes -utf8 -sha256 -x509 -outform PEM -out kernel_key.pem -keyout kernel_key.pem

OpenSSL will ask some questions about the user generating the key, it is recommended to fill in these questions as detailed as possible.

Store the key in a safe location, at the very least the key should be readable only by the root user. Verify this with:

root #ls -l kernel_key.pem
 -r-------- 1 root root 3164 Jan  4 10:38 kernel_key.pem

If this outputs anything other then the above, correct the permissions with:

root #chown root:root kernel_key.pem
root #chmod 400 kernel_key.pem
内核 Specify signing key CONFIG_MODULE_SIG_KEY
-*- Cryptographic API  ---> 
  Certificates for signature checking  --->  
    (/path/to/kernel_key.pem) File name or PKCS#11 URI of module signing key

To also sign external kernel modules installed by other packages via linux-mod-r1.eclass, enable the modules-sign USE flag globally:

文件 /etc/portage/make.confEnable module signing
USE="modules-sign"
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
# Optionally, when using custom signing keys.
MODULES_SIGN_KEY="/path/to/kernel_key.pem"
MODULES_SIGN_CERT="/path/to/kernel_key.pem" # Only required if the MODULES_SIGN_KEY does not also contain the certificate
MODULES_SIGN_HASH="sha512" # Defaults to sha512
附注
The MODULES_SIGN_KEY and MODULES_SIGN_CERT may be different files. For this example the pem file generated by OpenSSL includes both the key and the accompanying certificate, and thus both variables are set to the same value.

Optional: Signing the kernel image (Secure Boot)

When signing the kernel image (for use on systems with Secure Boot enabled) it is recommended to set the following kernel config options:

内核 Lockdown for secureboot
General setup  --->
  Kexec and crash features  --->   
    [*] Enable kexec system call                                                                                          
    [*] Enable kexec file based system call                                                                               
    [*]   Verify kernel signature during kexec_file_load() syscall                                                        
    [*]     Require a valid signature in kexec_file_load() syscall                                                        
    [*]     Enable ""image"" signature verification support
</div>  

<div lang="en" dir="ltr" class="mw-content-ltr">
[*] Enable loadable module support  
  -*-   Module signature verification    
    [*]     Require modules to be validly signed
    [*]     Automatically sign all modules
    Which hash algorithm should modules be signed with? (Sign modules with SHA-512) --->
</div>  

<div lang="en" dir="ltr" class="mw-content-ltr">
Security options  ---> 
[*] Integrity subsystem   
  [*] Basic module for enforcing kernel lockdown                                                                       
  [*]   Enable lockdown LSM early in init                                                                       
        Kernel default lockdown mode (Integrity)  --->
</div>            

  <div lang="en" dir="ltr" class="mw-content-ltr">
[*]   Digital signature verification using multiple keyrings                                                            
  [*]     Enable asymmetric keys support                                                                                     
  -*-       Require all keys on the integrity keyrings be signed                                                              
  [*]       Provide keyring for platform/firmware trusted keys                                                                
  [*]       Provide a keyring to which Machine Owner Keys may be added                                                        
  [ ]         Enforce Machine Keyring CA Restrictions

Where ""image"" is a placeholder for the architecture specific image name. These options, from the top to the bottom: enforces that the kernel image in a kexec call must be signed (kexec allows replacing the kernel in-place), enforces that kernel modules are signed, enables lockdown integrity mode (prevents modifying the kernel at runtime), and enables various keychains.

On arches that do not natively support decompressing the kernel (e.g. arm64 and riscv), the kernel must be built with its own decompressor (zboot):

内核 zboot CONFIG_EFI_ZBOOT
Device Drivers --->                                                                                                                           
  Firmware Drivers --->                                                                                                                       
    EFI (Extensible Firmware Interface) Support --->                                                                                               
      [*] Enable the generic EFI decompressor

After compilation of the kernel, as explained in the next section, the kernel image must be signed. First install app-crypt/sbsigntools and then sign the kernel image:

root #emerge --ask app-crypt/sbsigntools
root #sbsign /usr/src/linux-x.y.z/path/to/kernel-image --cert /path/to/kernel_key.pem --key /path/to/kernel_key.pem --out /usr/src/linux-x.y.z/path/to/kernel-image
附注
For this example the same key that was generated to sign the modules is used to sign the kernel image. It is also possible to generate and use a second sperate key for signing the kernel image. The same OpenSSL command as in the previous section may be used again.

Then proceed with the installation.

To automatically sign EFI executables installed by other packages, enable the secureboot USE flag globally:

文件 /etc/portage/make.confEnable Secure Boot
USE="modules-sign secureboot"
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
# Optionally, to use custom signing keys.
MODULES_SIGN_KEY="/path/to/kernel_key.pem"
MODULES_SIGN_CERT="/path/to/kernel_key.pem" # Only required if the MODULES_SIGN_KEY does not also contain the certificate.
MODULES_SIGN_HASH="sha512" # Defaults to sha512
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
# Optionally, to boot with secureboot enabled, may be the same or different signing key.
SECUREBOOT_SIGN_KEY="/path/to/kernel_key.pem"
SECUREBOOT_SIGN_CERT="/path/to/kernel_key.pem"
附注
The SECUREBOOT_SIGN_KEY and SECUREBOOT_SIGN_CERT may be different files. For this example the pem file generated by OpenSSL includes both the key and the accompanying certificate, and thus both variables are set to the same value.
附注
When generating an Unified Kernel Image with systemd's ukify the kernel image will be signed automatically before inclusion in the unified kernel image and it is not necessary to sign it manually.

Handbook:MIPS/Blocks/Kernel/zh-cn

备选：genkernel

附注
In case it was missed, this section requires the kernel sources to be installed. Be sure to obtain the relevant kernel sources, then return here for the rest of section.

Genkernel should only be considered by users that have a required need that only Genkernel can meet, otherwise it is recommended to use the Distribution kernel or manually compile your own as it will make maintaining a Gentoo system a lot more simple. An example of why genkernel is more difficult to manage is the lack of integration with sys-kernel/installkernel. This means a user will not get the same level of automation as provided by the other methods, such as Unified Kernel Images will need to be created manually when using Genkernel.

Genkernel 提供了通用的内核配置文件，并且会编译内核和 initramfs，然后将生成的二进制文件安装到适当的位置。它提供了系统首次启动时最小的常规硬件支持，并允许将来自定义内核配置以及对内核额外升级。

请注意：虽然使用 genkernel 维护内核可以让系统管理员对系统内核，initramfs 和其他选项更新时有更多的操作，但当新的源代码发行时，却会投入更多的时间和精力去更新内核。所以那些希望不手动内核维护的人应该使用 distribution 内核。

更进一步说，认为 genkernel 可以为正在运行的硬件自动生成自定义的内核配置 是一种误解；genkernel 使用了支持大多数通用硬件的预定的内核配置文件，并且可以自动处理 make 命令来汇编和安装内核、相关模块以及 initramfs 文件。

二进制可再分发软件许可证组

如果已经预先安装了 linux-firmware 软件包，那么跳转到安装章节。

由于 sys-kernel/genkernel 软件包默认启用 firwmare USE 标志，所以包管理器还会尝试拉取 sys-kernel/linux-firmware 软件包。安装 linux-firmware 之前，需要接受二进制可再分发软件许可证。

通过在 /etc/portage/make.conf 文件为 ACCEPT_LICENSE 变量添加 @BINARY-REDISTRIBUTABLE 值，可以接受系统范围任何软件包的许可证组。通过在 /etc/portage/package.license/linux-firmware 文件添加特定内容，可以单独接受 linux-firmware 软件包的许可证组。

如果有必要，查看手册安装基本系统里的接受软件许可证的方法章节，然后修改一些可接受的软件许可证。

如果分析不出来，可以这样做：

root #mkdir /etc/portage/package.license
文件 /etc/portage/package.license/linux-firmware为 linux-firmware 软件包接受二进制可再分发许可证（binary redistributable）
sys-kernel/linux-firmware @BINARY-REDISTRIBUTABLE

安装

说明完以及准备好之后，安装 sys-kernel/genkernel 软件包：

root #emerge --ask sys-kernel/genkernel

常规

运行genkernel all来编译内核源码。值得注意的是，使用 genkernel 编译的内核适用于不同计算机体系结构的各种硬件，这可能使编译过程需要一阵子来完成。

附注
如果 root 分区／卷 不是使用 ext4 作为文件系统，它可能需要使用 genkernel --menuconfig all 来手动配置内核，并在内核中添加对这个具体文件系统的支持（比如：不是作为一个模块）。LVM2用户可能要作为参数来添加--lvm。
附注
LVM2 用户应该在下面 genkernel命令添加 --lvm 参数 。
root #genkernel --mountboot --install all

genkernel 完成后，将在 /boot 目录生成并安装内核和初始化内存文件（initial ram filesystem,initramfs）。/lib/modules 目录将安装相关模块。initramfs 将在内核加载后立即启动，然后进行硬件自动检测（就像在 live 磁盘镜像环境中一样）。

root #ls /boot/vmlinu* /boot/initramfs*
root #ls /lib/modules

Kernel installation

Installkernel

Installkernel may be used to automate, the kernel installation, initramfs generation, unified kernel image generation and/or bootloader configuration among other things. sys-kernel/installkernel implements two paths of achieving this: the traditional installkernel originating from Debian and systemd's kernel-install. Which one to choose depends, among other things, on the system's bootloader. By default systemd's kernel-install is used on systemd profiles, while the traditional installkernel is the default for other profiles.

If unsure, follow the 'Traditional layout' subsection below.

systemd-boot

When using systemd-boot (formerly gummiboot) as the bootloader, systemd's kernel-install must be used. Therefore ensure the systemd and the systemd-boot USE flags are enabled on sys-kernel/installkernel, and then install the relevant package for systemd-boot.

On OpenRC systems:

文件 /etc/portage/package.use/systemd-boot
sys-apps/systemd-utils boot kernel-install
sys-kernel/installkernel systemd systemd-boot
root #emerge --ask sys-apps/systemd-utils

On systemd systems:

文件 /etc/portage/package.use/systemd
sys-apps/systemd boot
sys-kernel/installkernel systemd-boot
root #emerge --ask sys-apps/systemd

GRUB

Users of GRUB can use either systemd's kernel-install or the traditional Debian installkernel. The systemd USE flag switches between these implementations. To automatically run grub-mkconfig when installing the kernel, enable the grub USE flag.

文件 /etc/portage/package.use/installkernel
sys-kernel/installkernel grub
root #emerge --ask sys-kernel/installkernel

Traditional layout, other bootloaders (e.g. lilo, etc.)

The traditional /boot layout (for e.g. LILO, etc.) is used by default if the grub, systemd-boot and uki USE flags are not enabled. No further action is required.


Building an initramfs

In certain cases it is necessary to build an initramfs - an initial ram-based file system. The most common reason is when important file system locations (like /usr/ or /var/) are on separate partitions. With an initramfs, these partitions can be mounted using the tools available inside the initramfs. The default configuration of the Project:Distribution Kernel requires an initramfs.

Without an initramfs, there is a risk that the system will not boot properly as the tools that are responsible for mounting the file systems require information that resides on unmounted file systems. An initramfs will pull in the necessary files into an archive which is used right after the kernel boots, but before the control is handed over to the init tool. Scripts on the initramfs will then make sure that the partitions are properly mounted before the system continues booting.

重要
If using genkernel, it should be used for both building the kernel and the initramfs. When using genkernel only for generating an initramfs, it is crucial to pass --kernel-config=/path/to/kernel.config to genkernel or the generated initramfs may not work with a manually built kernel. Note that manually built kernels go beyond the scope of support for the handbook. See the kernel configuration article for more information.

Installkernel can automatically generate an initramfs when installing the kernel if the dracut USE flag is enabled:

文件 /etc/portage/package.use/installkernel
sys-kernel/installkernel dracut

Alternatively, dracut may be called manually to generate an initramfs. Install sys-kernel/dracut first, then have it generate an initramfs:

root #emerge --ask sys-kernel/dracut
root #dracut --kver=6.6.21-gentoo

The initramfs will be stored in /boot/. The resulting file can be found by simply listing the files starting with initramfs:

root #ls /boot/initramfs*

Optional: Building an Unified Kernel Image

An Unified Kernel Image (UKI) combines, among other things, the kernel, the initramfs and the kernel command line into a single executable. Since the kernel command line is embedded into the unified kernel image it should be specified before generating the unified kernel image (see below). Note that any kernel command line arguments supplied by the bootloader or firmware at boot are ignored when booting with secure boot enabled.

An unified kernel image requires a stub loader, currently the only one available is systemd-stub. To enable it:

For systemd systems:

文件 /etc/portage/package.use/systemd
sys-apps/systemd boot

For OpenRC systems:

文件 /etc/portage/package.use/systemd-utils
sys-apps/systemd-utils boot kernel-install

Installkernel can automatically generate an unified kernel image using either dracut or ukify, by enabling the respective flag. The uki USE flag should be enabled as well to install the generated unified kernel image to the $ESP/EFI/Linux directory on the EFI system partition (ESP).

For dracut:

文件 /etc/portage/package.use/installkernel
sys-kernel/installkernel dracut uki
文件 /etc/dracut.conf
uefi="yes"
kernel_cmdline="some-kernel-command-line-arguments"

For ukify:

文件 /etc/portage/package.use/installkernel
sys-apps/systemd ukify          # For systemd systems
sys-apps/systemd-utils ukify    # For OpenRC systems
sys-kernel/installkernel dracut ukify uki
文件 /etc/kernel/cmdline
some-kernel-command-line-arguments

Note that while dracut can generate both an initramfs and an unified kernel image, ukify can only generate the latter and therefore the initramfs must be generated separately with dracut.

Generic Unified Kernel Image

The prebuilt sys-kernel/gentoo-kernel-bin can optionally install a prebuilt generic unified kernel image containing a generic initramfs that is able to boot most systemd based systems. It can be installed by enabling the generic-uki USE flag, and configuring installkernel to not generate a custom initramfs or unified kernel image:

文件 /etc/portage/package.use/generic-uki
sys-kernel/gentoo-kernel-bin generic-uki
sys-kernel/installkernel -dracut -ukify uki

Secure Boot

The generic Unified Kernel Image optionally distributed by sys-kernel/gentoo-kernel-bin is already pre-signed. How to sign a locally generated unified kernel image depends on whether dracut or ukify is used. Note that the location of the key and certificate should be the same as the SECUREBOOT_SIGN_KEY and SECUREBOOT_SIGN_CERT as specified in /etc/portage/make.conf.

For dracut:

文件 /etc/dracut.conf
uefi="yes"
kernel_cmdline="some-kernel-command-line-arguments"
uefi_secureboot_key="/path/to/kernel_key.pem"
uefi_secureboot_cert="/path/to/kernel_key.pem"

For ukify:

文件 /etc/kernel/uki.conf
[UKI]
SecureBootPrivateKey=/path/to/kernel_key.pem
SecureBootCertificate=/path/to/kernel_key.pem

Rebuilding external kernel modules

External kernel modules installed by other packages via linux-mod-r1.eclass must be rebuilt for each new kernel version. When the distribution kernels are used this may be automated by enabling the dist-kernel flag globally.

文件 /etc/portage/package.use/module-rebuild
*/* dist-kernel

External kernel modules may also be rebuilt manually with:

root #emerge --ask @module-rebuild

内核模块

列出可用的内核模块

附注
硬件模块手动列出是可选的。在大多数情况下，udev 通常将加载所有被检测为已连接的硬件模块。然而，列出自动检测到的模块并没有什么不良影响的。有时，一些奇特硬件需要帮助来加载其驱动程序。

可以在 /etc/modules-load.d/*.conf 文件中添加需要在每次启动时加载的模块，格式为每行一个模块。如果模块需要附加选项，可以在 /etc/modprobe.d/*.conf 文件内设置。

对于特定的内核版本，如果要查看所有可用模块，使用下面的 find 命令。不要忘记在查找时替换 “<kernel version>” 为对应的内核版本：

root #find /lib/modules/<kernel version>/ -type f -iname '*.o' -or -iname '*.ko' | less

强制加载特定内核模块

要强制加载内核 3c59x.ko 模块（3Com 网卡家族的特定驱动），编辑/etc/modules-load.d/network.conf 文件并在里面输入模块名字。

root #mkdir -p /etc/modules-load.d
root #nano -w /etc/modules-load.d/network.conf

注意，模块的 .ko 文件后缀对加载机制影响不大，所以配置文件中没有文件后缀：

文件 /etc/modules-load.d/network.conf强制加载 3c59x 模块
3c59x

继续到配置系统来安装。





文件系统信息

分区表和 UUID

MBR（BIOS）和GPT都支持“文件系统”标签和“文件系统”的UUID。 这些属性可以在尝试查找和挂载块设备时使用，作为 mount 命令的替代方法，在 /etc/fstab 中定义。文件系统标签和 UUID 由 LABEL 和 UUID 前缀标识，可以使用 blkid 命令查看：

root #blkid
警告
如果分区中的文件系统被擦除，则文件系统标签和UUID值将随后被更改或删除。

出于唯一性，建议使用 MBR 分区表的读者使用 UUID 来定义/etc/fstab 中的可挂载卷。

重要
LVM 卷文件系统的 UUID 与其 LVM 快照相同，因此应避免使用 UUID 挂载 LVM 卷。

分区卷标和 UUID

已经使用 GPT 磁盘的用户有一些更稳定的选项可用于在 /etc/fstab 中定义分区。分区卷标和分区 UUID 可以用来标识块设备的单独分区，而不管为分区本身选择了什么文件系统。分区卷标和 UUID 分别由 PARTLABEL 和 PARTUUID 前缀标识，可以通过运行 blkid 命令在终端中很好地查看分区标签。EFI 系统的输出如下所示：

Output for an amd64 EFI system using the Discoverable Partition Specification UUIDs may like the following:

root #blkid
/dev/sr0: BLOCK_SIZE="2048" UUID="2023-08-28-03-54-40-00" LABEL="ISOIMAGE" TYPE="iso9660" PTTYPE="PMBR"
/dev/loop0: TYPE="squashfs"
/dev/sda2: UUID="12c37dea-624b-48b6-88b8-fba427f5f341" TYPE="swap" PARTLABEL="swap" PARTUUID="0657fd6d-a4ab-43c4-84e5-0933c84b4f4f"
/dev/sda3: UUID="9bd83a8f-75c6-4a04-b155-6f6b748509a9" BLOCK_SIZE="512" TYPE="xfs" PARTLABEL="rootfs" PARTUUID="4f68bce3-e8cd-4db1-96e7-fbcaf984b709"
/dev/sda1: UUID="166F-2917" BLOCK_SIZE="512" TYPE="vfat" PARTLABEL="efi" PARTUUID="c12a7328-f81f-11d2-ba4b-00a0c93ec93b"

虽然对于分区表不总是正确的，但使用UUID来标识fstab 中的分区，即使文件系统更改，也可以保证在寻找某个卷时引导加载程序不会被混淆。对于经常重新启动并定期添加和删除SATA设备时，在 fstab 中定义分区，使用旧的默认分区文件 (/dev/sd*N非常危险) 。

块设备文件的命名取决于许多因素，包括磁盘如何以及以什么顺序加载到系统。它们也可能以不同的顺序显示，具体情况取决于在早期启动过程中内核首先检测到哪些设备。因此，除非系统管理员打算经常调整磁盘顺序，否则可以简单直接地使用默认块设备文件。

关于 fstab

在Linux系统下，系统所用到的所有分区都必须在 /etc/fstab 文件中指明。这个文件包含了这些分区的挂载点（在系统目录树中的位置）、挂载方法和特殊挂载选项（是否自动挂载，是否某个用户可以挂载它等）。

创建 /etc/fstab 文件

附注
If the init system being used is systemd, the partition UUIDs conform to the Discoverable Partition Specification as given in Preparing the disks, and the system uses UEFI, then creating an fstab can be skipped, since systemd auto-mounts partitions that follow the spec.

/etc/fstab 文件使用一种特殊语法格式。每行都包含六个字段。这些字段之间由空白键（空格键，tab键，或者两者混合使用）分隔。每个字段都有自己的含意：

  1. ＃第一个字段显示要挂载的特殊 block 设备或远程文件系统。 有几种设备标识符可用于特殊块设备节点，包括设备文件路径，文件系统标签，UUID，分区标签以及UUID。
  2. 第二个字段是分区挂载点，也就是分区应该挂载到的地方。
  3. 第三个字段给出分区所用的文件系统的类型。
  4. 第四个字段给出的是挂载分区时 mount 命令所用的挂载选项。由于每个文件系统都有自己的挂载选项，我们建议系统管理员阅读 mount 手册（man mount）以获得所有挂载选项的列表。多个挂载选项之间是用逗号分隔的。
  5. 第五个字段是给dump使用的，用以决定这个分区是否需要dump。一般情况下，你可以把该字段设为 0（零）。
  6. 第六个字段是给fsck使用的，用以决定系统非正常关机之后文件系统的检查顺序。根文件系统应该为 1，而其它的应该为 2（如果不需要文件系统自检的话可以设为 0）。
重要
Gentoo stage 文件默认提供的 /etc/fstab “不”是有效的fstab 文件，它只是提供了几个模板，可用于输入相关值。
root #nano /etc/fstab

DOS/传统 BIOS 系统

让我们来看看如何写下/boot/分区的选项。 这只是一个示例，应根据安装时的具体情况进行修改。 在mips分区示例中， /boot/ 通常是/dev/sda1 xfs 作为文件系统。 它需要在启动期间进行检查，所以我们写下：

文件 /etc/fstab/etc/fstab 中 DOS/传统 BIOS 启动行的示例
# 调整与"准备磁盘"步骤的任何格式差异
/dev/sda1   /boot     ext2    defaults        0 2

有些用户不希望 /boot/ 分区自动挂载，以提高系统的安全性。 他们应该用noauto.代替 defaults。这意味着这些用户将需要在每次他们想要使用它时手动挂载这个分区。

增加符合你分区方案的规则，为你的光驱（当然，如果你有其他分区或者驱动器，也为它们加上）添加挂载规则。

下面是/etc/fstab文件的例子：

文件 /etc/fstab针对 DOS/传统 BIOS 系统 的完整 /etc/fstab 例子
# 调整与"准备磁盘"步骤的任何格式差异
/dev/sda1   /boot        ext2    defaults    0 2
/dev/sda10   none         swap    sw                   0 0
/dev/sda5   /            xfs    defaults,noatime              0 1
</div>

/dev/cdrom  /mnt/cdrom   auto    noauto,user          0 0

UEFI 系统

Below is an example of an /etc/fstab file for a system that will boot via UEFI firmware:

文件 /etc/fstabA full /etc/fstab example for an UEFI system
# Adjust for any formatting differences and/or additional partitions created from the "Preparing the disks" step
                    0 2
/dev/sda10   none             sw                   0 0
/dev/sda5   /            xfs    defaults,noatime              0 1
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
/dev/cdrom  /mnt/cdrom   auto    noauto,user          0 0

DPS UEFI PARTUUID

Below is an example of an /etc/fstab file for a disk formatted with a GPT disklabel and Discoverable Partition Specification (DPS) UUIDs set for UEFI firmware:

文件 /etc/fstabGPT disklabel DPS PARTUUID fstab example
# Adjust any formatting difference and additional partitions created from the "Preparing the disks" step.
# This example shows a GPT disklabel with Discoverable Partition Specification (DSP) UUID set:
PARTUUID=c12a7328-f81f-11d2-ba4b-00a0c93ec93b                                  0 2
PARTUUID=0657fd6d-a4ab-43c4-84e5-0933c84b4f4f   none            sw                           0 0
PARTUUID=   /           xfs    defaults,noatime              0 1

auto选项可以使mount 猜测文件系统（推荐对于可移动设备采用这个选项，因为它们可能采用很多不同的文件系统），而 user选项使得非root用户可以挂载光驱。

To improve performance, most users would want to add the noatime mount option, which results in a faster system since access times are not registered (those are not needed generally anyway). This is also recommended for systems with solid state drives (SSDs). Users may wish to consider lazytime instead.

提示
由于会使性能下降，所以不推荐在 /etc/fstab 定义 discard 挂载选项。一般来说，最好使用作业调度器（例如 cron 或 timer （systemd））定期丢弃块。查看定期 fstrim 作业来获取更多信息。

仔细检查/etc/fstab文件，保存并退出以继续。

网络信息

特别注意，以下部分可以帮助读者快速设置他们的系统接入局域网。

对于运行 OpenRC 的系统，更多网络设置的细节参考高级网络配置章节，手册末尾附近有介绍。有更具体网络需求的系统可能需要跳过此章节，然后返回此处继续后续的安装。

更多关于 systemd 具体的网络设置，请参考 systemd 文章的网络部分。

主机名

系统管理员必须要做的事情之一就是命名他们的机器。尽管这看上去很容易，但是很多用户觉得很难起一个合适的主机名。为了加快进度，应该知道所有你所命名的名字都是可以在今后重新修改的。下面的示例使用 tux 作为主机名。

设置主机名（OpenRC 和 systemd）

root #echo tux > /etc/hostname

systemd

可以使用 hostnamectl 工具在正运行 systemd 的系统设置系统的主机名。但是，在安装过程中，应当使用 systemd-firstboot 命令（参见手册的后续部分）。

可以将设置主机名为 "tux"：

root #hostnamectl hostname tux

运行 hostnamectl --help 或 man 1 hostnamectl 查看帮助。

网络

配置网络接口有许多可用的方法。本章节只介绍了其中一些方法。你可以选择一个看起来最合适的设置方法。

通过 dhcpcd 使用 DHCP （任何 init 系统）

大多数 LAN 网络都运行 DHCP 服务器。如果是这种情况，则建议使用 dhcpcd 程序获取 IP 地址。

安装：

root #emerge --ask net-misc/dhcpcd

在 OpenRC 系统中启用和开始服务：

root #rc-update add dhcpcd default
root #rc-service dhcpcd start

在 systemd 系统中启用服务：

root #systemctl enable dhcpcd

完成这些步骤后，下次系统启动时，dhcpcd 应该就会从 DHCP 服务器获取 IP 地址。 更多细节请查看 Dhcpcd 文章。

netifrc (OpenRC)

提示
在 OpenRC 使用 Netifrc 设置网络是一种特殊的方法。还有更简单的方法设置，比如 Dhcpcd。

配置网络

在Gentoo Linux安装时,网络已经配置。然而,这是安装的 live 环境本身的配置,并不是新的系统环境的网络配置。现在你所要设置的是 Gentoo 系统的永久网络配置。

附注
更多关于网络配置的详细信息，包括网卡绑定、网桥、802.1Q VLANs和无线网络在内的高级配置会在高级网络配置这一部分介绍.

/etc/conf.d/net 当中收集了所有的网络信息。尽管这个文件采用直接易懂的语法，如果你还是因为觉得不够直观而完全不知道如何手动进行网络配置的话，请不用担心，我们将一一解释。在 /usr/share/doc/netifrc-*/net.example.bz2 中有一个详细注释过的例子，它涵盖了许多种类不同的配置。

首先安装net-misc/netifrc:

root #emerge --ask --noreplace net-misc/netifrc

系统默认使用DHCP。如果使用DHCP的话，你需要安装一个DHCP客户端。这个将在稍后的安装必要的系统工具部分介绍。

如果你需要配置你的网络连接，不管是因为你是需要指定DHCP选项还是你不使用DHCP，打开 /etc/conf.d/net:;

root #nano /etc/conf.d/net

设置 config_eth0 和 routes_eth0 输入IP地址信息和路由信息：

附注
假定网络接口名称是 eth0。这个名称非常依赖于系统，如果安装介质足够新，则建议在从安装介质引导时重命名接口。更多信息可以在网络接口命名章节中找到。
文件 /etc/conf.d/net静态IP定义
config_eth0="192.168.0.2 netmask 255.255.255.0 brd 192.168.0.255"
routes_eth0="default via 192.168.0.1"

要使用DHCP，定义 config_eth0:

文件 /etc/conf.d/netDHCP 配置
config_eth0="dhcp"

请阅读 /usr/share/doc/netifrc-*/net.example.bz2 获取额外的配置文件选项的列表。如果你需要设定特殊的 DHCP 选项，请参考你的 DHCP 客户端的 man 手册页。

如果你有多个网络接口，那么重复之前对于config_eth1，config_eth2等操作步骤。

现在保存配置并退出。

在启动时自动启用网络连接

为了在启动时自动激活网络接口，你必须添加这些到default运行级别。

root #cd /etc/init.d
root #ln -s net.lo net.eth0
root #rc-update add net.eth0 default

如果系统有多个网络接口，那么需要创建适当的net.* 文件，就像我们使用net.eth0一样。

如果在引导系统后，发现网络接口名称（目前写作 eth0）是错误的，那么执行以下步骤来纠正这一点：

  1. 用正确的名称更新 /etc/conf.d/net（比如说 enp3s0 或者 enp5s0 取代 eth0）。
  2. 创建符号链接（比如 /etc/init.d/net.enp3s0）。
  3. 删除旧的符号链接（rm /etc/init.d/net.eth0）。
  4. 创建新的默认运行级别。
  5. 删除旧的运行级别，使用 rc-update del net.eth0 default。

hosts 文件

现在你需要告诉Linux有关你的网络的信息。这需要在/etc/hosts文件中定义，它将帮助你将那些无法被域名解析器解析的主机名解析成IP地址。

root #nano /etc/hosts
文件 /etc/hostsFilling in the networking information
# 定义当前系统
127.0.0.1     tux.homenetwork tux localhost
  
# 可选，定义网络上的其它系统
192.168.0.5   jenny.homenetwork jenny
192.168.0.6   benny.homenetwork benny

保存并退出编辑器，继续


系统信息

Root 密码

使用passwd命令设置root密码。

root #passwd

稍后将为日常操作创建其他常规用户帐户。

配置引导和启动

OpenRC

当在 Gentoo 中使用 OpenRC 时，系统使用/etc/rc.conf配置系服务，启动和关闭。 打开 /etc/rc.conf 并查看文件中的所有注释。查看设置并根据需要进行更改。

root #nano /etc/rc.conf

接下来，打开/etc/conf.d/keymaps 来处理键盘设置。编辑它就可以设置你的键盘。

root #nano /etc/conf.d/keymaps

要特别注意keymap这个变量 。如果你选择了错误的KEYMAP，在你敲击键盘的时候会有奇怪的结果。

完成 /etc/conf.d/hwclock 的配置之后，保存并退出。

root #nano /etc/conf.d/hwclock

如果你机器上的时钟不用UTC，你需要在配置文件加上clock="local"。否则，你的时钟就有可能出现偏差。

systemd

首先，建议运行 systemd-machine-id-setup ，然后运行 systemd-firstboot ，这将准备正确设置系统的各个组件，以便首次启动进入新的systemd环境。 传递以下选项将包括提示用户设置区域设置、时区、主机名、root 密码和 root shell 值。 它还会为安装分配一个随机机器 ID:

root #systemd-machine-id-setup
root #systemd-firstboot --prompt

接下来，用户应该运行 systemctl 来重置所有已安装工具的文件为预设的策略值：

root #systemctl preset-all --preset-mode=enable-only

虽然可以运行完整的预设更改，但这可能会重置在此过程中已配置的任何服务：

root #systemctl preset-all

这两个步骤将有助于确保从 live 环境平滑过渡到安装过程的首次启动。





系统日志工具

OpenRC

因为有一些工具提供给用户的功能比较类似，它们就没有包含在stage3当中。现在就是你选择安装哪一个的时候了。

首先需要决定的工具就是系统日志机制。Unix 和 Linux 在日志记录功能方面有良好的传统——如果愿意的话，可以把系统发生的所有事件都记录到日志文件中。

Gentoo提供了多种系统日志工具可供选择。包括：

  • app-admin/sysklogd -提供传统的系统日志记录守护程序。默认日志配置容易学习，这个包是初学者的好选择。
  • app-admin/syslog-ng -高级系统记录器。 需要额外配置很多东西， 更高级的用户可以根据它的日志潜力选择这个包; 注意额外的配置是任何种类的智能日志记录的必要条件。
  • app-admin/metalog -一个可以灵活配置的系统日志工具。

Gentoo ebuild 仓库内或许还有其他系统日志工具，因为可用软件包数量每天在增加。

提示
如果打算使用 syslog-ng ，建议安装并且配置 logrotate。syslog-ng 并没有提供系统日志文件的滚动功能。新版本（>= 2.0）的 sysklogd 会自己处理日志滚动。

要安装你所选择的系统日志工具，你可以用 emerge 命令安装它。在 OpenRC 中，使用 rc-update 将它加入默认运行级别。以下就是一个安装 app-admin/sysklogd 并作为系统 syslog 工具的例子：

root #emerge --ask app-admin/sysklogd
root #rc-update add sysklogd default

systemd

日志记录工具一般只有使用 OpenRC 的系统需要选择，systemd 已经自带了一个叫 systemd-journald 的服务作为日志记录工具。systemd-journald 服务通常能够支持并处理大部分上面提到的日志记录工具的功能。换而言之，使用 systemd 运行系统作为服务管理器可以安全跳过添加额外的系统日志记录工具。

更多关于使用 journalctl 审查系统的细节，请查看 man journalctl。

对于因为某种原因需要将日志转发到中心主机的情况，在使用 systemd 的系统上支持冗余的系统记录机制可能很重要。但对于本手册的受众和目的来说，这是一个非典型常见且高阶的情况。因此本手册没有涵盖它。

可选：Cron守护进程

OpenRC

尽管这是可选的并且不是系统所必须的，但是最好能够安装一个 cron 守护进程。

cron守护程序执行计划中的命令。 如果某些命令需要定期执行（例如每天，每周或每月），这是非常方便的。

All cron daemons support high levels of granularity for scheduled tasks, and generally include the ability to send an email or other form of notification if a scheduled task does not complete as expected.

Gentoo 提供了三个可选的 cron 守护进程，包括：

  • sys-process/cronie - cronie is based on the original cron and has security and configuration enhancements like the ability to use PAM and SELinux.
  • sys-process/dcron - This lightweight cron daemon aims to be simple and secure, with just enough features to stay useful.
  • sys-process/fcron - A command scheduler with extended capabilities over cron and anacron.
  • sys-process/bcron - A younger cron system designed with secure operations in mind. To do this, the system is divided into several separate programs, each responsible for a separate task, with strictly controlled communications between parts.

cronie

下面的示例使用 sys-process/cronie：

root #emerge --ask sys-process/cronie

添加 cronie 作为默认系统运行级别后，将会开机自启。

root #rc-update add cronie default

可选：dcron

root #emerge --ask sys-process/dcron

如果 dcron 是前置 cron agent，则需要执行额外的初始化命令：

root #crontab /etc/crontab

可选：fcron

root #emerge --ask sys-process/fcron

如果选择 fcron 作为任务调度器，则需要额外的 emerge 步骤：

root #emerge --config sys-process/fcron

可选：bcron

bcron 是一款新的内建特权分离的 cron agent。

root #emerge --ask sys-process/bcron

systemd

提示
systemd 不需要 cron 守护进程，因为它有 timers，但仍然可以运行 cron 守护程序。

可选：文件索引

如果你想索引你的系统文件使得你能够使用locate工具很快定位它们，你需要安装sys-apps/mlocate。

root #emerge --ask sys-apps/mlocate

可选：远程 shell 访问

提示
opensshd 默认配置不允许远程登录 root 用户。如果有需要的话，请在安装后创建一个非 root 用户，并且配置合适的权限，或者调整 /etc/ssh/sshd_config，使其允许 root 远程登录。

要在安装后远程访问系统，必须配置为在启动时运行sshd。

OpenRC

在 OpenRC 上将 sshd init 脚本添加到默认运行级别：

root #rc-update add sshd default

如果需要访问串行控制台（在远程服务器的情况下这是可能的），必须配置 agetty。

在 /etc/inittab 中取消串行控制台部分的注释：

root #nano -w /etc/inittab
# SERIAL CONSOLES
s0:12345:respawn:/sbin/agetty 9600 ttyS0 vt100
s1:12345:respawn:/sbin/agetty 9600 ttyS1 vt100

systemd

运行以下命令来启用 SSH 服务端：

root #systemctl enable sshd

运行以下命令来启用串行控制台支持：

root #systemctl enable getty@tty1.service

可选：Shell 补全

Bash

Bash 是Gentoo系统里默认的shell，所以安装补全建议插件支持可以更有效率，更便捷。app-shells/bash-completion 将会提供Gentooo系统特有的和其他常用命令和工具的可用的建议补全

root #emerge --ask app-shells/bash-completion

完成安装后，可以使用eselect命令管理bash的补全支持的项目 。 查阅关于bash补全的文章获取更多详情：Shell completion integrations section

时间同步

使用一些同步系统时钟的方法很重要。通常使用 NTP 协议和软件。有一些 NTP 协议的其他实现，例如 Chrony。

设置 Chrony，例如

root #emerge --ask net-misc/chrony

OpenRC

在 OpenRC 上，运行：

root #rc-update add chronyd default

systemd

在 systemd 上，运行：

root #systemctl enable chronyd.service

另外，systemd 用户可能希望使用默认安装的更简单的 systemd-timesyncd SNTP 客户端。

root #systemctl enable systemd-timesyncd.service

文件系统工具

根据你所使用的文件系统的不同，可能需要安装需要的文件系统工具（用于检查文件系统完整性、（重新）格式化文件系统等）。请注意，作为 @system 集一部分的，已经安装了 ext4 用户空间的工具 (sys-fs/e2fsprogs)。

以下的表格列出了特定文件系统所需要安装的工具。

文件系统 软件包
XFS sys-fs/xfsprogs
ext4 sys-fs/e2fsprogs
VFAT (FAT32, ...) sys-fs/dosfstools
Btrfs sys-fs/btrfs-progs
ZFS sys-fs/zfs
JFS sys-fs/jfsutils

It's recommended that sys-block/io-scheduler-udev-rules is installed for the correct scheduler behavior with e.g. nvme devices:

root #emerge --ask sys-block/io-scheduler-udev-rules
提示
获取更多关于Gentoo上文件系统的信息请看文件系统文章。

网络工具

如果在之前配置系统步骤配置好网络，并且完成网络设置，那么本‘网络工具’章节可以安全地跳过。这样的话，继续配置引导程序章节。

安装DHCP客户端

重要
大多数用户需要 DHCP 客户端连接到他们网络。如果没有安装的话，则系统可能无法访问网络，从而使之后也无法下载 DHCP 客户端。

DHCP 客户端可以使用 netifrc 脚本自动获取一个或多个IP地址。我们建议使用 net-misc/dhcpcd（另请参阅 dhcpcd）：

root #emerge --ask net-misc/dhcpcd

可选：安装PPPoE客户端

如果你需要ppp来连接网络，你需要安装它 net-dialup/ppp 。

root #emerge --ask net-dialup/ppp

可选：安装无线网络工具

如果系统将连接无线网络,请为开放网络或 WEP 网络安装 net-wireless/iw 包，为 WPA 或 WPA2 网络安装 net-wireless/wpa_supplicant 包。iw 也是一个有用的无线网络扫描的基本诊断工具

root #emerge --ask net-wireless/iw net-wireless/wpa_supplicant

现在继续配置引导启动程序。





Handbook:MIPS/Blocks/Bootloader/zh-cn

重启系统

退出chroot环境并unmount全部已持载分区。然后敲入一条有魔力的命令来初始化最终的、真实的测试：reboot。

(chroot) livecd #exit
livecd~#cd
livecd~#umount -l /mnt/gentoo/dev{/shm,/pts,}
livecd~#umount -R /mnt/gentoo
livecd~#reboot

当别忘了移除 live 镜像，否则可能再次从 live 镜像启动，而不是新安装的 Gentoo 系统！

当重启进全新安装的 Gentoo 环境后，最好进行完成Gentoo安装。





用户管理

添加一个日常使用的用户

在 Unix/Linux 系统中，用 root 进行工作是一件危险的事情，应该尽量避免。因此我们强烈推荐您为日常使用添加一个或更多的标准用户账户。

用户所属的组定义了其可以执行的活动。下表中列出了许多您可能希望使用的重要组：

Group Description
audio 允许使用声音设备
cdrom 允许直接使用光驱设备
floppy 允许直接使用软驱
games 允许运行游戏
portage 能够访问portage受限资源。
usb 允许使用USB设备
video 允许使用视频采集设备和硬件加速
wheel 可以使用su.

比如，创建一个叫作 larry 的 wheel、users 和 audio 组的成员用户，首先使用 root 登录（只有 root 能创建用户）并运行 useradd：

Login:root
Password: (Enter the root password)

When setting passwords for standard user accounts, it is good security practice to avoid using the same or a similar password as set for the root user.

Handbook authors recommended to use a password at least 16 characters in length, with a value fully unique from every other user on the system.

root #useradd -m -G users,wheel,audio -s /bin/bash larry
root #passwd larry
Password: (Enter the password for larry)
Re-enter password: (Re-enter the password to verify)

Temporarily elevating privileges

如果一个用户仍需要以 root 身份做一些任务，他们可以使用 su - 来临时得到 root 权限。另一种方式是使用 sudo（app-admin/sudo）或者 doas (app-admin/doas) 工具，如果配置正确的话，非常安全。

Disabling root login

To prevent possible threat actors from logging in as root, deleting the root password and/or disabling root login can help improve security.

To disable root login:

root #passwd -l root

To delete the root password and disable login:

root #passwd -dl root

磁盘清理

删除安装后的残留文件

如果 Gentoo 安装完毕并且系统已经重启过，并且所有事情都完成好了，那么我们现在就要从硬盘上删除下载的 stage3 的 tar 包。记住它们下载在 / 目录。

The files are located in the / directory and can be removed with the following command:

root #rm /stage3-*.tar.*

下一步该做什么？

不知道接下来该做什么？现在有许多途径可以探索……Getoo 为用户提供了大量的可能性，因此也已经在 wiki 和其他与 Gentoo 相关的子域名上提供大量的文档（少量没有），可以通过这些文档来进行探索（参见下面的 Gentoo 在线章节）。

额外的文档

需要注意的是，由于 Gentoo 中可用的选项数量众多，手册提供的文档范围有限——它主要侧重于启动和运行 Gentoo 系统的基础知识以及基本的系统管理活动。该手册有意排除了有关图形环境的说明、有关强化的详细信息以及其他重要的管理任务。话虽如此，本手册还有更多部分可以帮助读者使用更多基本功能。

读者一定要看一下手册的下一章节使用 Gentoo，讲述了如何保障软件是最新的、如何安装额外的软件包、USE 标记的更多细节、OpenRC init 系统，以及与 Gentoo 系统安装后，管理相关的各种其他信息话题。

除了这本手册，也鼓励读者去探索Gentoo维基的其他角落来寻找更多的、社区提供的文档。Gentoo wiki 组同时提供一个文档概述，其中按照类别列出了一系列的维基文档。比如，它指向的本地化指南能使系统更有家的感觉（特别适用于以英语为第二语言的用户）。

大多数使用桌面的用户将设置图形环境。有许多社区维护支持桌面环境（DEs）和窗口管理器 （WMs）的 'meta' 文章。读者应该知道，每个桌面环境设置有略微不同的步骤，这会增加 Bootstrap 的复杂性。

许多其他的 Meta 文章 为我们的读者提供了对 Gentoo 中可用软件的高级概述。

Gentoo 在线

重要
读者应注意，所有在线的 Gentoo 官方网站均受Gentoo的 行为准则约束。活跃于 Gentoo 社区是一种特权，而不是一种权利，用户应该知道行为准则的存在是有原因的。

除了 Libera.Chat 托管的因特网中继聊天（ internet relay chat IRC）网络和邮件列表之外，大多数Gentoo 网站要求每个站点都有一个帐户，以便提问、展开讨论或上报 Bug。

论坛 和 IRC

欢迎每个用户来我们的 Gentoo 论坛 或我们的 Gentoo 的 因特网中继聊天（ internet relay chat IRC）频道。有很多以前发现的新 Gentoo 安装遇到的问题，在获得一些反馈后得以解决，这些问题的经验可以在论坛中轻松地搜索查看。其他用户第一次使用 Gentoo 遇到安装问题的可能性非常令人惊讶。建议用户在 Gentoo 支持频道寻求帮助之前搜索论坛和 wiki。

邮件列表

这些是提供给社区成员的一些邮件列表，他们更愿意通过电子邮件请求支持或反馈，而不是在论坛或IRC上创建用户帐户。用户需要按照说明进行操作，以便订阅特定的邮件列表。

Bug

有时，在查看 wiki、搜索论坛、在IRC频道或邮件列表中寻求支持之后，并没有问题已知的解决方案。一般来说，这是在 Gentoo 的 Bugzilla 网站 上报告 bug 的信号。

开发指南

希望了解更多有关开发 Gentoo 的读者可以查看开发指南。该指南提供了有关编写 ebuild、使用 eclass 的说明，并提供了 Gentoo 开发中许多基本概念的定义。

结语

Gentoo 是一个健壮、灵活、维护良好的发行版。开发者社区很高兴听到关于如何使Gentoo 成为一个“更好的”发行版的反馈。

在此提醒，任何关于 “本手册”的反馈应该按照如何改进手册？章节中开头的详细准则。

我们期待看到我们的用户将如何选择使用 Gentoo 满足他们独特的用例和需求。



Warning: Display title "Gentoo Linux 手册：安装Gentoo" overrides earlier display title "手册：MIPS/全部/安装".

Retrieved from "https://wiki.gentoo.org/index.php?title=Handbook:MIPS/Full/Installation/zh-cn&oldid=345548"