# 安装 Stage3 基础系统

URL: https://caijiao.org/gentoo/stage3-install
Source: docs/gentoo/stage3-install.md
Description: 本章介绍如何下载并安装 Gentoo Stage3 基础系统，为构建自定义 Gentoo Linux 系统打下基础。

在完成硬盘分区与文件系统挂载后，下一步是安装 **Gentoo Stage3 基础系统**。Stage3 提供了最小化的系统根文件（root filesystem），通过源码编译完成完整 Gentoo 系统。

## 一、下载 Stage3 文件

1. 访问官方 Stage3 下载页面：  
   [https://www.gentoo.org/downloads/](https://www.gentoo.org/downloads/)  

2. 选择与你的硬件架构对应的 Stage3 文件，例如 `amd64` 或 `x86`。

3. 下载完成后，建议校验 SHA256 校验和：

```bash
sha256sum stage3-amd64-2025.0.tar.xz
````

确保与官网提供的 SHA256 值一致。

## 二、解压 Stage3 文件

将 Stage3 文件解压到挂载的根分区（假设根分区挂载在 `/mnt/gentoo`）：

```bash
cd /mnt/gentoo
tar xpvf /path/to/stage3-*.tar.xz --xattrs-include='*.*' --numeric-owner
```

> ⚠️ 选项说明：
>
> * `p` 保留文件权限
> * `v` 显示解压过程
> * `xattrs-include='*.*'` 保留扩展属性
> * `--numeric-owner` 保持原始用户和组 ID

## 三、配置 Portage

1. 复制 Portage 配置文件：

```bash
cp -L /etc/resolv.conf /mnt/gentoo/etc/
```

2. 挂载必要的文件系统，以便 chroot 环境下可以正常使用：

```bash
mount --types proc /proc /mnt/gentoo/proc
mount --rbind /sys /mnt/gentoo/sys
mount --make-rslave /mnt/gentoo/sys
mount --rbind /dev /mnt/gentoo/dev
mount --make-rslave /mnt/gentoo/dev
```

## 四、进入 chroot 环境

进入 Stage3 环境进行系统配置和源码编译：

```bash
chroot /mnt/gentoo /bin/bash
source /etc/profile
export PS1="(chroot) $PS1"
```

在 chroot 环境下，你就可以继续安装核心系统、配置内核和 Portage。

## 五、建议操作

* 确认网络可用：

  ```bash
  ping -c 3 www.gentoo.org
  ```

* 检查挂载的文件系统是否正确
* 准备进行系统更新与核心配置（下一章内容）
