> For the complete documentation index, see [llms.txt](https://book.bsdcn.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://book.bsdcn.org/rpicn/shu-mei-pai/yuan-cheng-fang-wen.md).

# 远程访问

## 远程访问简介

有时候，你需要在不连接显示器、键盘和鼠标的情况下访问树莓派。也许树莓派被嵌入机器人中，或安装在难以触及的位置，又或者你没有多余的显示器。

### 局域网中的远程控制

要在局域网上的其他设备远程控制你的树莓派，请使用以下服务之一：

* [SSH](https://www.raspberrypi.com/documentation/computers/remote-access.html#ssh)
* [VNC](https://www.raspberrypi.com/documentation/computers/remote-access.html#vnc)
* [树莓派 Connect](https://www.raspberrypi.com/documentation/computers/remote-access.html#raspberry-pi-connect)

SSH（**S** ecure **SH** ell）提供了对树莓派上终端会话的安全访问。VNC（**V** irtual **N** etwork **C** omputing，虚拟网络计算）提供了对树莓派桌面屏幕共享的安全访问。你只需要另一台计算机、局域网和树莓派的局域网 [IP 地址](https://en.wikipedia.org/wiki/IP_address)。树莓派 Connect 可安全地共享你的树莓派屏幕，且无需确定树莓派的局域网 IP 地址。

### 通过局域网在设备之间共享文件

无需直接控制远程设备，[NFS](https://www.raspberrypi.com/documentation/computers/remote-access.html#nfs)（网络文件系统）、[SCP](https://www.raspberrypi.com/documentation/computers/remote-access.html#scp)（Secure Copy Protocol，安全复制协议）、[Samba](https://www.raspberrypi.com/documentation/computers/remote-access.html#samba) 和 [`rsync`](https://www.raspberrypi.com/documentation/computers/remote-access.html#rsync) 等服务能让你在局域网的设备间共享文件。当你需要从其他设备访问存储在一台设备上的数据时，这些服务可能会很有用。

### 通过互联网远程控制

要从接入互联网的任意设备远程控制你的树莓派，你需要：

* 在树莓派上公开 [SSH](https://www.raspberrypi.com/documentation/computers/remote-access.html#ssh)/[VNC](https://www.raspberrypi.com/documentation/computers/remote-access.html#vnc)，可通过开放互联网、VPN 内部，或使用 RealVNC 的云 [VNC Viewer](https://www.realvnc.com/download/viewer/) 等外部服务。
* 使用[树莓派 Connect](https://www.raspberrypi.com/documentation/computers/remote-access.html#raspberry-pi-connect)，这是由树莓派提供的免费屏幕共享和远程 shell 服务。

## 查看树莓派的 IP 地址

许多从其他机器连接到树莓派的方法都需要你知道树莓派的局域网 IP 地址。

接入局域网的所有设备都会被分配一个 IP 地址。要使用 [SSH](https://www.raspberrypi.com/documentation/computers/remote-access.html#ssh)/[VNC](https://www.raspberrypi.com/documentation/computers/remote-access.html#vnc) 从别的机器连接到树莓派，你需要知道树莓派的 IP 地址。如果接入了显示器，这很容易。但还有许多方法可从网络上的其他机器远程查找它。

要查找树莓派的局域网 IP 地址，请使用以下方法之一。

### 桌面

将鼠标悬停在系统托盘中的网络图标上，便会出现工具提示。该工具提示会显示你当前连接的网络名称及 IP 地址。

![Wi-Fi 网络名称和 IP 地址的工具提示](https://1423291173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCOxpD6RTIfF28SyASLTE%2Fuploads%2Fgit-blob-38e9fc34dc4eb84d0879b9131cbc99b504cdc950%2Fnetwork-tooltip.png?alt=media)

### 命令行

运行以下命令，可将你的局域网 IP 地址打印到命令行：

```sh
$ hostname -I
```

### 启动输出

如果你的树莓派接入了显示器，并且启动到了命令行而非桌面，则可以在启动过程（boot sequence）于登录提示符之前输出的最后几条信息中，找到你的 IP 地址。

### 网络管理器

你可以使用内置的网络管理器命令行（`nmcli`）来获取有关你的网络的详细信息。请运行以下命令：

```sh
$ nmcli device show
```

你应看到类似如下输出：

```json
GENERAL.DEVICE:                         wlan0
GENERAL.TYPE:                           wifi
GENERAL.HWADDR:                         D0:3B:FF:41:AB:8A
GENERAL.MTU:                            1500
GENERAL.STATE:                          100 (connected)
GENERAL.CONNECTION:                     exampleNetworkName
GENERAL.CON-PATH:                       /org/freedesktop/NetworkManager/ActiveConnection/2
IP4.ADDRESS[1]:                         192.168.1.42/24
IP4.GATEWAY:                            192.168.1.1
IP4.ROUTE[1]:                           dst = 192.168.1.0/24, nh = 0.0.0.0, mt = 600
IP4.ROUTE[2]:                           dst = 0.0.0.0/0, nh = 192.168.1.1, mt = 600
IP4.DNS[1]:                             192.168.1.3
IP6.ADDRESS[1]:                         ab80::11ab:b1fc:bb7e:a8a5/64
IP6.GATEWAY:                            --
IP6.ROUTE[1]:                           dst = ab80::/64, nh = ::, mt = 1024

GENERAL.DEVICE:                         lo
GENERAL.TYPE:                           loopback
GENERAL.HWADDR:                         00:00:00:00:00:00
GENERAL.MTU:                            65536
GENERAL.STATE:                          100 (connected (externally))
GENERAL.CONNECTION:                     lo
GENERAL.CON-PATH:                       /org/freedesktop/NetworkManager/ActiveConnection/1
IP4.ADDRESS[1]:                         127.0.0.1/8
IP4.GATEWAY:                            --
IP6.ADDRESS[1]:                         ::1/128
IP6.GATEWAY:                            --

GENERAL.DEVICE:                         p2p-dev-wlan0
GENERAL.TYPE:                           wifi-p2p
GENERAL.HWADDR:                         (unknown)
GENERAL.MTU:                            0
GENERAL.STATE:                          30 (disconnected)
GENERAL.CONNECTION:                     --
GENERAL.CON-PATH:                       --

GENERAL.DEVICE:                         eth0
GENERAL.TYPE:                           ethernet
GENERAL.HWADDR:                         D0:3B:FF:41:AB:89
GENERAL.MTU:                            1500
GENERAL.STATE:                          20 (unavailable)
GENERAL.CONNECTION:                     --
GENERAL.CON-PATH:                       --
WIRED-PROPERTIES.CARRIER:               off
IP4.GATEWAY:                            --
IP6.GATEWAY:                            --
```

此命令将输出树莓派上各种可访问的网络接口的相关信息。查看 `GENERAL.TYPE` 这一行，可了解各个部分描述的网络接口类型。例如，“ethernet”是设备上的以太网端口，“wifi”是一些设备内置的 Wi-Fi 芯片。根据设备访问互联网的方式，你将看到不同的输出块，可查找你的 IP 地址：

* 如果你的设备使用 Wi-Fi 连接到互联网，请检查“wifi”这部分
* 如果你的设备使用以太网端口连接到互联网，请检查“ethernet”这部分

在确定了正确的网络接口部分后，请查找字段 `IP4.ADDRESS[1]` 来获取 IPv4 地址，或者查找字段 `IP6.ADDRESS[1]` 来获取 IPv6 地址。你可以忽略这些字段末尾的斜杠和数字（如 `/24`）。

在以上示例中，树莓派使用 Wi-Fi 访问互联网。查看 `GENERAL.TYPE` 字段的“wifi”部分，来查找 IP 地址。在这种情况下，你可以使用 `IP4.ADDRESS[1]` 字段中的 IPv4 地址访问此设备：`192.168.1.42`。

### 使用 mDNS 解析 `raspberrypi.local`

树莓派系统支持 Avahi 服务的多播 DNS。

如果你的设备支持 mDNS，你可以通过其主机名和后缀 `.local` 来访问你的树莓派。在新安装的树莓派系统上，默认主机名为 `raspberrypi`，因此在默认情况下，所有运行树莓派系统的树莓派都会响应：

```sh
$ ping raspberrypi.local
```

如果能访问树莓派，则 `ping` 会显示树莓派的 IP 地址：

```sh
PING raspberrypi.local (192.168.1.131): 56 data bytes
64 bytes from 192.168.1.131: icmp_seq=0 ttl=255 time=2.618 ms
```

> **技巧**
>
> 如果你使用树莓派配置（Raspberry Pi Configuration）、`raspi-config`、`/etc/hostname` 修改了树莓派的系统主机名，Avahi 会更新 `.local` 的 mDNS 地址。如果你忘记了树莓派的主机名，你可以在另一台设备上安装 Avahi，然后用 `avahi-browse` 浏览本地网络上的所有主机和服务。

### 检查路由器的设备列表

在网页浏览器中，键入你路由器的 IP 地址。然后，使用你的凭据登录。

> **技巧**
>
> 你路由器的 IP 地址通常为 `http://192.168.1.1`，但并非总是如此。你也许会在路由器的标签上找到路由器的地址和凭据。

这将指引你进入控制面板。浏览到连接设备列表或类似内容（所有路由器都不同），你能看到一些你认识的设备。某些设备被检测为 PC、平板电脑、手机、打印机等，因此你应该能识别一部分，并排除它们，找出哪个是你的树莓派。

> **技巧**
>
> 如果你用网线将你的树莓派接入网络，请尝试在列表中筛选有线设备。可供筛选的设备应该会更少。

### 使用 `nmap` 查找设备

`nmap`（Network Mapper，网络映射器）命令是用于网络发现的免费开源工具。它适用于 Linux、macOS 和 Windows。

* 要在 **Linux** 上安装，请安装软件包 `nmap`，如 `apt install nmap`。
* 要在 **macOS**、**Windows** 上安装，请参阅 [nmap.org 下载页](http://nmap.org/download.html)。

要用 `nmap` 扫描你网络上的设备，你需要知道你接入的子网。先找到你正在使用的计算机的局域网 IP 地址：

* 在 **Linux** 上，将 `hostname -I` 输入到终端窗口中。
* 在 **macOS** 上，转到 **系统设置** > **网络**，选择你的活动网络连接，然后单击按钮“**详细信息……**”
* 在 **Windows** 上，打开控制面板，然后在“**网络和共享中心**”下，单击“**查看网络连接**”，选择你的活动网络连接，然后单击“**查看此连接的状态**”

接下来，扫描整个 **子网（subnet）**，来查找其他设备。大多数局域网使用 IPv4，它使用四个介于 1 到 255 之间的数值来标识每个 IP 地址。你的子网设备使用的前三个数字都是相同的。例如，如果你的 IP 地址是 `192.168.1.5`，那么其他设备使用的地址类似于 `192.168.1.2`、`192.168.1.6` 和 `192.168.1.200`。要使用 `nmap` 扫描这个子网，请传入字符串 `192.168.1.0/24`，该字符串覆盖的子网范围是 `192.168.1.0` 到 `192.168.1.255`。使用参数 `-sn` 将在整个子网范围上运行 `ping` 扫描：

```sh
$ sudo nmap -sn 192.168.1.0/24
```

> **技巧**
>
> 取决于你的局域网速度，也许需要一分钟左右。

ping 扫描会查询所有范围内的 IP 地址是否有响应。对于每个响应 ping 的设备，输出显示主机名和 IP 地址如下：

```json
Starting Nmap 6.40 ( http://nmap.org ) at 2014-03-10 12:46 GMT
Nmap scan report for hpprinter (192.168.1.2)
Host is up (0.00044s latency).
Nmap scan report for Gordons-MBP (192.168.1.4)
Host is up (0.0010s latency).
Nmap scan report for ubuntu (192.168.1.5)
Host is up (0.0010s latency).
Nmap scan report for raspberrypi (192.168.1.8)
Host is up (0.0030s latency).
Nmap done: 256 IP addresses (4 hosts up) scanned in 2.41 seconds
```

上述输出显示，主机名为 `raspberrypi` 的设备具有 IP 地址 `192.168.1.8`。

### 使用智能手机上的应用软件查找设备

应用程序 Fing 是一款免费的智能手机网络扫描器。它适用于 [Android](https://play.google.com/store/apps/details?id=com.overlook.android.fing) 和 [iOS](https://itunes.apple.com/gb/app/fing-network-scanner/id430921107?mt=8)。

1. 将手机接入与你树莓派相同的网络。
2. 打开 Fing 应用后，请触摸屏幕右上角的刷新按钮。
3. 几秒钟后，你会看到所有已接入你网络的设备列表。
4. 向下滚动到制造商为“Raspberry Pi”的条目。IP 地址显示在条目的左下角，MAC 地址显示在条目的右下角。

## 使用 SSH 访问远程终端

你可以使用安全外壳（**S** ecure **SH** ell，SSH）协议从同一网络上的其他计算机远程访问树莓派的终端。

### 启用 SSH 服务器

在默认情况下，树莓派系统已禁用 SSH 服务器。可通过以下方式之一启用 SSH：

#### 使用桌面启用 SSH 服务器

1. 在“**首选项**”菜单中启动 **控制中心（Control Centre）**。
2. 切换到“**接口**”选项卡。
3. 选择“**SSH**”旁边的“**已启用（Enabled）**”。
4. 单击“**确定**”。

#### 写入全新的操作系统镜像时启用 SSH 服务器

在全新安装的树莓派系统上配置 SSH：

1. 按照[使用树莓派启动盘制作工具安装](https://www.raspberrypi.com/documentation/computers/getting-started.html#imager-install)指南中的说明进行安装。
2. 在 **自定义（Customisation）> 远程访问（Remote Access）** 标签页中，把 **启用 SSH** 开关切换到活动状态。
3. 选择 **使用密码认证（Use password authentication）**，使用与在物理上使用树莓派时相同的用户名和密码登录。选择 **使用公钥认证（Use public key authentication）** 以[配置 SSH 密钥](https://www.raspberrypi.com/documentation/computers/remote-access.html#configure-ssh-without-a-password)，进行基于 SSH 密钥的登录。

#### 使用终端启用 SSH 服务器

1. 在终端窗口中输入 `sudo raspi-config`。
2. 选择 **Interfacing Options**。
3. 切换到并选择 **SSH**。
4. 选择 **Yes**。
5. 选择 **Ok**。
6. 选择 **Finish**。

#### 手动启用 SSH 服务器

1. 在引导分区中创建一个叫做 `ssh` 的空文件：

   ```sh
   $ sudo touch /boot/firmware/ssh
   ```
2. 重启计算机：

   ```sh
   $ sudo reboot
   ```

### 连接到 SSH 服务器

在你的计算机上打开一个终端窗口，输入以下命令。把占位符 `<ip 地址>` [替换成你要接入的树莓派 IP 地址](https://www.raspberrypi.com/documentation/computers/remote-access.html#ip-address)，再把 `<用户名>` 替换为你的用户名：

```sh
$ ssh <用户名>@<ip 地址>
```

连接成功后，你会看到一个安全警告。请输入 `yes` 继续。你仅会在首次连接时收到该警告。

在出现提示时输入你的账户密码。

你现在会看到树莓派的命令提示符：

```sh
<用户名>@<主机名> ~ $
```

现在你已远程连接到树莓派，可以执行命令了。

> **注意**
>
> 如果你收到报错 `connection timed out`，则可能是你输入的树莓派 IP 地址有误。请检查[树莓派的 IP 地址](https://www.raspberrypi.com/documentation/computers/remote-access.html#ip-address)。

#### 通过 SSH 转发 X11

> **注意**
>
> 在 macOS 和 Windows 上，你必须安装第三方 X 服务器才能使用 X11 转发。

X11 可通过 SSH 启用图形应用程序。传递 `-Y` 参数即可通过 SSH 转发 X 会话：

```sh
$ ssh -Y <用户名>@<ip 地址>
```

在经过身份验证后，你会像往常一样看到命令行。不过，你还可以打开图形窗口，由 X 服务器为你渲染。例如，键入以下命令会启动 [Geany](https://www.geany.org/) 窗口：

```sh
$ geany &
```

### 配置无密码的 SSH

要远程访问你的树莓派而无需每次连接时提供密码，请使用 SSH 密钥对。

#### 使用树莓派启动盘制作工具预配置操作系统镜像

在使用树莓派启动盘制作工具配置操作系统镜像时，你可以预配置 SSH 密钥，以使用运行树莓派启动盘制作工具的计算机上的现有密钥。

1. 按照[使用树莓派启动盘制作工具安装](https://www.raspberrypi.com/documentation/computers/getting-started.html#imager-install)指南来配置你的启动镜像。
2. 在 **远程访问（Remote Access）** 标签页中，把 **启用 SSH** 开关切换到活动状态。
3. 选择 **使用公钥认证（Use public key authentication）**。如果你已经在 `~/.ssh/id_rsa.pub` 中存储了一个 SSH 公钥，树莓派启动盘制作工具会自动使用该公钥来预填文本框；否则，请浏览到你的公钥所在位置。
4. 选择 **下一步（Next）** 以继续镜像写入流程。

#### 手动配置 SSH 密钥

如果你已经安装了树莓派系统，你可以更新现有配置来使用 SSH 密钥认证。

#### 检查现有的 SSH 公钥

要检查远程连接到树莓派的计算机上是否存在现有的 SSH 公钥，请运行以下命令：

```sh
$ ls ~/.ssh
```

如果看到了文件 `id_ed25519.pub`、`id_rsa.pub` 或 `id_dsa.pub`，则你已经拥有一个 SSH 密钥。可跳过 SSH 密钥对生成，[将 SSH 密钥添加到你的 SSH 身份列表中](https://www.raspberrypi.com/documentation/computers/remote-access.html#add-ssh-key-identity)。

#### 生成新的 SSH 密钥对

> **技巧**
>
> 本指南提供了新 RSA 密钥的生成说明。为了增加安全性，你可以选择生成 [Ed25519](https://ed25519.cr.yp.to/) 密钥。要使用 Ed25519 密钥：在引用你的公钥和私钥文件名称时，把 `-t ed25519` 传递给 `ssh-keygen`；并把 `rsa` 替换为 `ed25519`。

要生成新的 SSH 密钥对，请输入以下命令：

```sh
$ ssh-keygen
```

当询问要将密钥保存在哪里时，请按 **回车键** 使用默认位置 `~/.ssh/id_rsa`。

当询问是否要使用可选密语时，请按 **回车键** 不使用密语。

运行以下命令以检查 `.ssh` 目录中的内容：

```sh
$ ls ~/.ssh
```

你将看到文件 `id_rsa` 和 `id_rsa.pub`：

```sh
authorized_keys  id_rsa  id_rsa.pub  known_hosts
```

`id_rsa` 文件包含你的私钥。请将其安全保存在用于远程接入树莓派的计算机上。

`id_rsa.pub` 文件包含你的公钥。你将同你的树莓派共享此密钥。当你远程接入树莓派时，将使用此密钥来验证你的身份。

#### 将 SSH 密钥添加到你的 SSH 身份列表中

启动 SSH 代理：

```sh
$ eval "$(ssh-agent -s)"
```

接下来，使用以下命令将你的密钥标识添加到 `ssh-agent`：

```sh
$ ssh-add ~/.ssh/id_rsa
```

#### 把公钥复制到你的树莓派

在你用于远程接入树莓派的计算机上，使用以下命令将你的公钥安全地复制到树莓派：

```sh
$ ssh-copy-id <用户名>@<ip 地址>
```

出现提示后，输入你树莓派用户账户的密码。现在你可以接入树莓派而无需输入密码。

#### 手动把公钥复制到你的树莓派

如果你的操作系统不支持 `ssh-copy-id`，你可以用 `scp` 来复制你的公钥。

首先，在你的树莓派上，创建 Linux 默认查找密钥的目录：

```sh
$ mkdir .ssh
```

然后，为 `.ssh` 目录配置适当的权限：

```sh
$ chmod 700 .ssh
```

在你的常用计算机上，使用 `scp` 把你的公钥复制到树莓派上的 `.ssh/authorized_keys` 文件中：

```sh
$ scp .ssh/id_rsa.pub <用户名>@<ip 地址>:.ssh/authorized_keys
```

> **技巧**
>
> 上面的命令假定你以前从未授权过任何密钥访问你的树莓派。如果你之前添加过至少一个密钥，请改为在 `authorized_keys` 文件的末尾添加一行包含公钥的新内容，以保留现有密钥。

出现提示后，输入你树莓派用户账户的密码。

然后，在你的树莓派上，配置 `authorized_keys` 文件的权限：

```sh
$ chmod 644 .ssh/authorized_keys
```

你现在可以在不输入密码的情况下连接到你的树莓派。

### 限制可连接的用户

如果你想将 SSH 访问限制到特定的用户账户，请编辑 SSH 服务器配置：

```sh
$ sudo nano /etc/ssh/sshd_config
```

找到 `AllowUsers` 指令，添加你想要允许的用户名。如果该行不存在，请将其添加到文件末尾：

```sh
AllowUsers alice bob
```

你还可以使用 `DenyUsers` 明确阻止特定用户名登录：

```sh
DenyUsers jane john
```

保存文件并重启 SSH 服务以使更改生效：

```sh
$ sudo systemctl restart ssh
```

## 使用 VNC 进行屏幕共享

有时候在物理上操作设备并不方便。虚拟网络计算（VNC）可让你通过别的设备操控某台设备的桌面。

VNC 依赖于客户端和服务器。客户端运行在你可直接与之交互的设备上，如个人笔记本电脑、台式机、平板电脑或手机。服务器运行在你的树莓派上。当你使用 VNC 时，客户端会把键盘和鼠标事件传输到服务器。服务器在你的树莓派上执行这些事件，再将屏幕更新返回给客户端。

VNC 客户端在窗口中显示你的树莓派的桌面。你可以像在树莓派本身上工作一样与桌面交互。

树莓派系统内置了 [wayvnc](https://github.com/any1/wayvnc)。它提供了一个 VNC 服务器，你可以在设备首选项中启用它。

在使用 VNC 之前，必须先在你的树莓派上启用 VNC 服务器。

### 启用 VNC 服务器

树莓派系统能以图形界面和命令行两种方式启用 VNC 服务器。

> **技巧**
>
> 启用后，你可以在 `/etc/wayvnc/` 中找到你的 WayVNC 配置。

#### 使用图形化启用 VNC 服务器

1. 在树莓派上启动图形桌面。
2. 单击桌面系统托盘中的树莓派图标。
3. 从菜单中选择 **首选项（Preferences）** > **控制中心（Control Centre）**。

![从系统托盘中的首选项菜单中选择控制中心](https://1423291173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCOxpD6RTIfF28SyASLTE%2Fuploads%2Fgit-blob-d7667147bffd6e4a1b23f36e47d599d4d051e6ce%2Fraspberry-pi-configuration.png?alt=media)

4. 切换到选项卡 **接口（Interfaces）**。
5. 单击 **VNC** 旁边的单选按钮，将其切换到活动状态。

![接口选项卡](https://1423291173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCOxpD6RTIfF28SyASLTE%2Fuploads%2Fgit-blob-37a6f71239a5a805a61823297f0241588a6eda4c%2Fvnc-enable.png?alt=media)

6. 单击“**确定（OK）**”按钮以保存配置更改。

#### 使用命令行启用 VNC 服务器

可使用命令行 [raspi-config](https://www.raspberrypi.com/documentation/computers/configuration.html#raspi-config) 启用 VNC 服务器。

1. 打开 `raspi-config`，输入以下内容：

   ```sh
   $ sudo raspi-config
   ```
2. 切换到 **接口选项（Interface Options）**。按 **回车键** 选择。
3. 选择 **VNC**。按 **回车键** 选择。
4. 在“**Would you like the VNC Server to be enabled?（你想要启用 VNC 服务器吗？）**”下，使 `<Yes>` 高亮并按 **回车键**。
5. 按 **回车键** 返回菜单。按 **Esc 键** 退出 `raspi-config`。

### 连接到 VNC 服务器

要接入你的树莓派，你需要满足如下条件：

* 你的树莓派和运行 VNC 客户端的设备接入到同一网络（如家庭无线网络/VPN）
* 你的树莓派的主机名/IP 地址
* 树莓派上账户的有效用户名和对应的密码

如果你不知道设备的 IP 地址，请参阅[查找 IP 地址的说明](https://www.raspberrypi.com/documentation/computers/remote-access.html#ip-address)。

1. 下载 [TigerVNC](https://tigervnc.org/)。你可以从其 [GitHub 存储库的 Releases 页面](https://github.com/TigerVNC/tigervnc/releases)安装最新版本。单击最新版本中的链接，找到适用于你平台的二进制文件。Windows 用户应下载 `exe`；macOS 用户应下载 `dmg`；Linux 用户应安装 `jar`。
2. 在你的客户端设备上启动 TigerVNC。在 macOS 和 Windows 上，你可以双击二进制文件。在 Linux 上，使用 `sudo apt install default-jre` 安装 java，然后运行 `java -jar VncViewer-<版本号>.jar`，将占位符 `<版本号>` 替换为你下载的版本。
3. 在“VNC 服务器”字段中输入你树莓派的 IP 地址。

![将树莓派的局域网 IP 地址输入到 TigerVNC 中](https://1423291173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCOxpD6RTIfF28SyASLTE%2Fuploads%2Fgit-blob-da4acd465ee7a696de581805061244b500700eed%2Fvnc-tigervnc-enter-ip.png?alt=media)

4. 单击按钮“Options”。切换到选项卡“输入”。勾选“无光标时显示一个点”旁边的复选框，以确保你始终可以在 TigerVNC 中看到光标。

![在 TigerVNC 中始终将光标显示为点的选项](https://1423291173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCOxpD6RTIfF28SyASLTE%2Fuploads%2Fgit-blob-61042ffc45a6c263c251733156aed432787c48fc%2Fvnc-tigervnc-show-dot.png?alt=media)

5. 单击“连接”按钮，与服务器建立连接。

* 如果 TigerVNC 警告“主机名与服务器证书不匹配”，请单击按钮“是”继续。

![TigerVNC 关于证书不匹配的警告](https://1423291173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCOxpD6RTIfF28SyASLTE%2Fuploads%2Fgit-blob-7160947acdd48931cf3526d146820b1d17742df7%2Fvnc-tigervnc-cert-warning.png?alt=media)

* 如果 TigerVNC 警告你“证书由未知机构签署”，请单击按钮“是”，为你的树莓派授予例外。

![TigerVNC 关于由未知机构签署的证书的警告](https://1423291173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCOxpD6RTIfF28SyASLTE%2Fuploads%2Fgit-blob-6587b8b0ea1d64a0752ca2947e54b491faeb6c87%2Fvnc-tigervnc-cert-signer-warning.png?alt=media)

6. 在提示输入用户名和密码时，请输入你的凭据。

![通过 TigerVNC 输入用户名和密码进行身份验证](https://1423291173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCOxpD6RTIfF28SyASLTE%2Fuploads%2Fgit-blob-33524b2281651920592623ff2f51e84426e0c1da%2Fvnc-tigervnc-username-password.png?alt=media)

7. 单击“确定”按钮以与 VNC 服务器进行身份验证。如果你的凭据正确，TigerVNC 将打开一个窗口，其中显示与你在树莓派上的账户对应的桌面。你应该能够使用鼠标和键盘与桌面交互并输入文本。

![成功通过 TigerVNC 认证后的树莓派桌面](https://1423291173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCOxpD6RTIfF28SyASLTE%2Fuploads%2Fgit-blob-5fed688dd83a18fd4e80ec5093d975a2fd7e2304%2Fvnc-tigervnc-desktop.png?alt=media)

## 使用树莓派 Connect 远程访问

你可以使用树莓派 Connect，从另一台设备的浏览器远程访问树莓派。树莓派 Connect 会自动处理配置，因此你无需查找树莓派的本地 IP 地址或网络的公网 IP 地址，也无需修改局域网防火墙以启用外部访问。

在运行 Wayland 窗口服务器的树莓派机型上，Connect 支持屏幕共享；在所有树莓派机型上，Connect 支持远程 shell（终端）访问。

更多信息，请参阅 [Connect 文档](https://www.raspberrypi.com/documentation/services/connect.html)。

## 使用 SCP 共享文件

安全复制协议（`scp`）通过 SSH 发送文件。你可以使用 `scp` 在你的树莓派和另一台计算机间复制文件。

要使用 `scp`，请[查找你树莓派的 IP 地址](https://www.raspberrypi.com/documentation/computers/remote-access.html#ip-address)。

### 将文件复制到你的树莓派

要将名为 `myfile.txt` 的文件从你的个人计算机复制到树莓派上用户的主文件夹，请在 `myfile.txt` 所在目录下运行以下命令，把占位符 `<用户名>` 替换成你用于登录到树莓派的用户名，把占位符 `<树莓派IP地址>` 替换成你的树莓派的 IP 地址：

```sh
$ scp myfile.txt <用户名>@<树莓派IP地址>:
```

要把文件复制到特定目录，请在 `scp` 命令中的 `:` 后附加目录路径。请在运行 `scp` 之前创建文件夹，因为 `scp` 不会自动创建文件夹。例如，以下命令将名为 `myfile.txt` 的文件复制到用户主文件夹中的目录 `project/` 下：

```sh
$ scp myfile.txt <用户名>@<树莓派IP地址>:project/
```

### 从你的树莓派复制文件

要将名为 `myfile.txt` 的文件从树莓派上的用户主目录复制到其他计算机的当前目录，请运行以下命令：

```sh
$ scp <用户名>@<树莓派IP地址>:myfile.txt .
```

### 用一个命令复制多个文件

要复制多个文件，请在单个命令中列出以空格分隔的文件名：

```sh
$ scp myfile.txt myfile2.txt <用户名>@<树莓派IP地址>:
```

还可以使用通配符复制所有匹配特定筛选器的文件。以下命令将复制所有以 `.txt` 结尾的文件：

```sh
$ scp *.txt <用户名>@<树莓派IP地址>:
```

以下命令可复制所有以 `m` 开头的文件：

```sh
$ scp m* <用户名>@<树莓派IP地址>:
```

以下命令能复制所有以 `m` 开头且以 `.txt` 结尾的文件：

```sh
$ scp m*.txt <用户名>@<树莓派IP地址>:
```

> **注意**
>
> 如果要复制的文件包含空格，请把文件用双引号括起来：
>
> ```sh
> $ scp "my file.txt" <用户名>@<树莓派IP地址>:
> ```

### 复制文件夹

要复制文件夹及其所有内容，请传入文件夹名称及 `-r`（递归）参数：

```sh
$ scp -r project/ <用户名>@<树莓派IP地址>:
```

## 使用 `rsync` 在计算机间同步文件夹

你可以使用 `rsync` 在计算机之间同步文件夹。例如，你可以使用 `rsync` 将树莓派拍摄的新照片自动传输到个人计算机。

在配置 `rsync` 之前，请确定如下信息：

* `<树莓派IP地址>`：你树莓派的局域网 IP 地址。更多信息，请参阅[查找你的树莓派的 IP 地址](https://www.raspberrypi.com/documentation/computers/remote-access.html#ip-address)
* `<树莓派用户名>`：你用于登录到树莓派的用户名
* `<树莓派文件夹名>`：你要从树莓派复制文件的文件夹名称
* `<个人计算机文件夹名>`：你想要在个人计算机上同步的文件夹名称

要配置 `rsync` 以同步文件，请在个人计算机上完成以下步骤，并使用上面确定的值替换命令中的占位符：

1. 创建你想要同步到的文件夹：

   ```sh
   $ mkdir <个人计算机文件夹名>
   ```
2. 使用 `rsync` 将文件同步到该文件夹：

   ```sh
   $ rsync -avz -e ssh <树莓派用户名>@<树莓派IP地址>:<树莓派文件夹名>/ <个人计算机文件夹名>/
   ```

此命令将所有文件从你的树莓派上的选定文件夹复制到个人计算机上的选定文件夹。若反复运行该命令，`rsync` 会跟踪你已经下载的文件并跳过它们。如果你在树莓派上删除/修改已同步的文件，`rsync` 会相应地更新个人计算机上的文件。

## 网络文件系统（Network File System，NFS）

网络文件系统（Network File System，NFS）能让你将一台联网计算机上的目录与同一网络上的其他计算机或设备共享。目录所在的计算机称为 **服务器**，连接到该服务器的计算机和设备称为客户端。客户端通常会把共享目录挂载（`mount`）到本地，使其成为自身目录结构的一部分。共享目录就是共享资源/网络共享的一个例子。

NFS 是在 Linux/Unix 环境中创建简单 NAS（网络附加存储）的常用方法。

NFS 也许更适用于相对固定的网络挂载目录，例如 `/home` 目录或经常访问的共享资源。如果你想让访客用户能轻松连接到网络共享，Samba 更为适合。在各种操作系统中，用于临时挂载和卸载 Samba 共享的工具更易获取。

在部署 NFS 之前，你应该熟悉：

* Linux 文件和目录权限
* 挂载/卸载文件系统

### 设置基本的 NFS 服务器

使用以下命令安装所需的软件包：

```sh
$ sudo apt install nfs-kernel-server
```

为了方便维护，我们将所有 NFS 导出隔离在单个目录中，真实目录将以 `--bind` 参数挂载到该目录中。

假设我们想要导出用户的家目录，该目录位于 `/home/users`。首先，我们创建导出文件系统：

```sh
$ sudo mkdir -p /export/users
```

> **技巧**
>
> 如果你计划配置 LDAP/NIS 身份验证，请跳过下面的 `chmod` 步骤。

授予 `/export` 和 `/export/users` 读取、写入和执行权限（`777`），这样你就可以在没有 LDAP/NIS 身份验证的情况下从客户端访问 NFS 共享：

```sh
$ chmod -R 777 /export
```

接下来，使用以下命令挂载真实的 `users` 目录：

```sh
$ sudo mount --bind /home/users /export/users
```

为了避免在每次重启后重复操作，我们把以下行添加到 `/etc/fstab`：

```sh
/home/users    /export/users   none    bind  0  0
```

有三个与 NFS 服务器相关的配置文件：

1. `/etc/default/nfs-kernel-server`
2. `/etc/default/nfs-common`
3. `/etc/exports`

现在，`/etc/default/nfs-kernel-server` 里唯一重要的参数是 `NEED_SVCGSSD`。默认设置为 `"no"`，这没有问题，因为这次我们不会启用 NFSv4 安全功能。

为了自动映射 ID 名称，文件 `/etc/idmapd.conf` 必须同时存在于客户端和服务器上，并且内容一致且带有正确的域名。此外，该文件应在 `Mapping` 部分中包含以下行：

```json
[Mapping]

Nobody-User = nobody
Nobody-Group = nogroup
```

但请注意，客户端可能对 `Nobody-User` 和 `Nobody-Group` 有不同的要求。例如，在 RedHat 的衍生版上，它们都是 `nfsnobody`。如果不确定，请通过以下命令检查是否存在 `nobody` 和 `nogroup`：

```sh
$ cat /etc/passwd
$ cat /etc/group
```

这样，服务器和客户端就无需用户共享相同的 UID/GUID。对于使用基于 LDAP 的身份验证的用户，在你的客户端的 `idmapd.conf` 中添加以下行：

```json
[Translation]

Method = nsswitch
```

这将触发 `idmapd` 查看 `nsswitch.conf`，以确定其应该查找凭据信息的位置。如果你已经使用 LDAP 身份验证，`nsswitch` 无需进一步解释。

要将我们的目录导出到本地网络 `192.168.1.0/24`，请在 `/etc/exports` 中添加以下两行：

```sh
/export       192.168.1.0/24(rw,fsid=0,insecure,no_subtree_check,async)
/export/users 192.168.1.0/24(rw,nohide,insecure,no_subtree_check,async)
```

#### 端口映射锁定（可选）

你的 NFS 上的文件对网络上的所有人都是开放的。作为安全措施，你可以限制对指定客户端的访问。

将以下行添加到 `/etc/hosts.deny`：

```sh
rpcbind mountd nfsd statd lockd rquotad : ALL
```

先阻止所有客户端，这样只有下面添加的 `/etc/hosts.allow` 中的客户端才能访问服务器。

现在把以下行添加到 `/etc/hosts.allow` 中：

```sh
rpcbind mountd nfsd statd lockd rquotad : <IPv4地址列表>
```

其中 `<IPv4地址列表>` 是服务器和所有客户端的 IP 地址列表（由于 `rpcbind` 的限制，它不支持主机名，因此它们必须是 IP 地址）。请注意，如果你设置了 NIS，你可以直接将它们添加到同一行。

请确保授权 IP 地址列表包含地址 `localhost`（`127.0.0.1`），因为最新版本的 Ubuntu 中启动脚本使用命令 `rpcinfo` 来发现 NFSv3 支持，如果 `localhost` 无法连接，NFSv3 支持将被禁用。

最后，要使更改生效，请重启服务：

```sh
$ sudo systemctl restart nfs-kernel-server
```

### 配置 NFS 客户端

现在你的服务器已经在运行，你需要设置客户端，使其能够访问服务器。首先，安装所需的软件包：

```sh
$ sudo apt install nfs-common
```

在客户端上，我们可以使用一个命令挂载完整的导出树：

```sh
$ mount -t nfs -o proto=tcp,port=2049 <nfs服务器IP>:/ /mnt
```

你还可以指定 NFS 服务器主机名，而非 IP 地址，但在这种情况下，你需要确保主机名可以在客户端上解析为 IP。一种能确保始终可解析的稳健方法是使用 `/etc/hosts` 文件。

请注意，在 NFSv4 中，`<nfs服务器IP>:/export` 不是必需的，就像在 NFSv3 中一样。根导出 `:/` 默认对应 `fsid=0` 的导出。

我们还可以挂载导出的子树：

```sh
$ mount -t nfs -o proto=tcp,port=2049 <nfs服务器IP>:/users /home/users
```

为了确保每次重启时都会挂载它，请把以下行添加到 `/etc/fstab`：

```sh
<nfs服务器IP>:/   /mnt   nfs    auto  0  0
```

如果挂载后，`/proc/mounts` 中出现的条目为 `<nfs服务器IP>://`（带有两个斜杠），那么你可能需要在 `/etc/fstab` 中指定两个斜杠，否则 `umount` 可能会报错找不到该挂载点。

#### 端口映射锁定（可选）

将以下行添加到 `/etc/hosts.deny`：

```sh
rpcbind : ALL
```

先阻止所有客户端，这样只有下面添加的 `/etc/hosts.allow` 中的客户端才能访问服务器。

现在将以下行添加到 `/etc/hosts.allow`：

```sh
rpcbind : <NFS服务器IP>
```

其中 `<NFS服务器IP>` 是服务器的 IP 地址。

### 配置复杂的 NFS 服务器

NFS 用户权限基于用户 ID（UID）。客户端上所有用户的 UID 必须与服务器上的 UID 匹配，以便用户能够访问。通常的做法有：

* 手动同步密码文件
* 使用 LDAP
* 使用 DNS
* 使用 NIS

请注意，在持有 root 访问权限的系统上，你必须小心：该用户可以更改系统上的 UID 以允许自己访问任何人的文件。本页面假定管理团队是唯一具有 root 访问权限的群组，并且他们都是可信的。其他任何情况都代表着更高级的配置，这里不会涉及。

#### 组权限

用户的文件访问权限取决于他们在客户端上所属的组，而不是服务器上的组。但是，有一个重要的限制：从客户端传递给服务器的组最多有 16 个，如果用户在客户端上属于超过 16 个组，则某些文件或目录可能会意外地无法访问。

#### DNS（可选，仅在使用 DNS 时）

将客户端名称和 IP 地址添加到 `/etc/hosts`（服务器的 IP 地址应该已经存在）。这样即使 DNS 出现问题，NFS 仍然可以正常工作。或者，如果你愿意，也可以依赖 DNS——这取决于你。

#### NIS（可选，仅在使用 NIS 时）

这适用于使用 NIS 的客户端。否则，你将无法使用 netgroups，并且应在 `/etc/exports` 中指定单独的 IP 地址或主机名。阅读 `man netgroup` 中的 BUGS 部分以获取更多信息。

首先，编辑 `/etc/netgroup` 并添加一行来对你的客户端进行分类（此步骤不是必需的，但为方便起见）：

```sh
myclients (client1,,) (client2,,) ...
```

其中，`myclients` 是 `netgroup` 的名称。

运行此命令以重建 NIS 数据库：

```sh
$ sudo make -C /var/yp
```

文件名 `yp` 指的是 Yellow Pages（黄页），即 NIS 的旧称。

#### 端口映射锁定（可选）

将以下行添加到 `/etc/hosts.deny`：

```sh
rpcbind mountd nfsd statd lockd rquotad : ALL
```

先阻止所有客户端，只有下面添加的 `/etc/hosts.allow` 中的客户端才能访问服务器。

考虑将以下行添加到 `/etc/hosts.allow`：

```sh
rpcbind mountd nfsd statd lockd rquotad : <IP地址列表>
```

其中 `<IP地址列表>` 是服务器和所有客户端的 IP 地址列表。由于 `rpcbind` 的限制，这些必须是 IP 地址。请注意，如果你设置了 NIS，可以直接将它们添加到同一行。

#### 软件包安装和配置

安装必要的软件包：

```sh
$ sudo apt install rpcbind nfs-kernel-server
```

编辑 `/etc/exports` 并添加共享：

```sh
/home @myclients(rw,sync,no_subtree_check)
/usr/local @myclients(rw,sync,no_subtree_check)
```

上面的示例将 `/home` 和 `/usr/local` 共享给 `myclients` netgroup 中的所有客户端。

```sh
/home 192.168.0.10(rw,sync,no_subtree_check) 192.168.0.11(rw,sync,no_subtree_check)
/usr/local 192.168.0.10(rw,sync,no_subtree_check) 192.168.0.11(rw,sync,no_subtree_check)
```

上面的示例将 `/home` 和 `/usr/local` 共享给具有静态 IP 地址的两个客户端。如果你希望改为允许私有网络中指定 IP 地址范围内的所有客户端访问，请考虑以下内容：

```sh
/home 192.168.0.0/255.255.255.0(rw,sync,no_subtree_check)
/usr/local 192.168.0.0/255.255.255.0(rw,sync,no_subtree_check)
```

在这里，`rw` 使共享变为读/写模式，而 `sync` 要求服务器只在全部更改已刷新到磁盘后才回复请求。这是最安全的选项；`async` 更快，但有风险。如果你正在考虑其他选项，强烈建议你阅读 `man exports`。

设置完 `/etc/exports` 后，导出共享：

```sh
$ sudo exportfs -ra
```

每当修改 `/etc/exports` 后，你都需要运行此命令。

#### 重启服务

重启 `rpcbind` 和 NFS 以使更改生效：

```sh
$ sudo systemctl restart rpcbind
$ sudo systemctl restart nfs-kernel-server
```

#### 要考虑的安全事项

除了上面讨论的 UID 问题之外，还应注意到攻击者可能会冒充允许映射共享的机器，从而允许他们创建任意 UID 以访问你的文件。一种可行的解决方案是 IPSec。你可以设置所有域成员仅通过 IPSec 相互通信，这将有效验证你的客户端身份是否与其声称的一致。

IPSec 的工作原理是：使用服务器的公钥加密发往服务器的流量，服务器则用客户端的公钥加密发回的所有回复。流量使用各自的私钥解密。如果客户端没有应该拥有的密钥，它就无法发送或接收数据。

IPSec 的替代方案是物理上分离的网络。这需要一个单独的网络交换机和单独的以太网卡，并且需要对该网络进行物理安全保护。

### 故障排除

在加密的主目录中挂载 NFS 共享只有在成功登录并解密主目录后才能正常工作。这意味着，在启动时使用 `/etc/fstab` 挂载 NFS 共享是行不通的，因为在挂载时主目录尚未解密。有一种简单的方法可以解决这个问题，即使用符号链接：

1. 创建一个替代目录来挂载 NFS 共享：

```sh
$ sudo mkdir /nfs
$ sudo mkdir /nfs/music
```

2. 编辑 `/etc/fstab`，将 NFS 共享挂载到该目录中：

```sh
nfsServer:music    /nfs/music    nfs    auto    0 0
```

3. 在你的主目录下创建一个符号链接，指向实际的挂载位置。在上述情况下，首先删除已经存在的 `Music` 目录：

```sh
$ rmdir /home/user/Music
$ ln -s /nfs/music/ /home/user/Music
```

## Samba（SMB/CIFS）

Samba 是 [Server Message Block](https://en.wikipedia.org/wiki/Server_Message_Block)（SMB，服务器消息块）网络协议的自由软件重新实现。使用 Samba，你可以在 Windows、macOS 和 Linux 机器间共享文件夹。

### 在你的树莓派上安装 Samba

在默认情况下，树莓派系统未安装 Samba。要在你的树莓派上安装 Samba，请运行以下命令，该命令会安装你运行 Samba 服务器/客户端所需的全部依赖项：

```sh
$ sudo apt update
$ sudo apt install samba samba-common-bin smbclient cifs-utils
```

### 挂载从 Windows 共享的文件夹

首先，你需要在 Windows 设备上共享一个文件夹。

#### 打开共享功能

1. 右键单击系统托盘，从菜单中选择“**网络和共享中心**”。
2. 选择“**更改高级共享设置**”。
3. 选择“**启用网络发现**”。
4. 选择“**启用文件和打印机共享**”。
5. 单击 **保存** 按钮以保存更改。

#### 共享文件夹

按照以下步骤在 Windows 上共享文件夹：

1. 右键单击要共享的文件夹，然后选择 **属性**。
2. 选择 **共享** 选项卡。
3. 单击“**高级共享**”按钮。
4. 选择“**共享此文件夹**”；在默认情况下，Windows 会使用文件夹名称作为共享名称。
5. 单击“**权限**”按钮。
6. 配置“**Everyone**”和“**完全控制**”权限。
7. 单击“**确定**”按钮以关闭 **权限** 页面。
8. 再次单击“**确定**”按钮以关闭 **高级共享** 页面。
9. 选择“**安全**”选项卡。
10. 配置“**Everyone**”和“**完全控制**”权限。
11. 单击“**确定**”按钮。

现在应该共享文件夹了。你可以通过在权限和安全页面上更改权限来修改共享文件夹权限。

#### Windows 10 共享向导

在 Windows 10 上有一个共享向导，可以帮助完成其中某些步骤。

1. 从“开始”菜单中运行 **计算机管理** 应用程序。
2. 选择“**共享文件夹**” > “**共享**”。
3. 单击鼠标右键，选择“**新建共享**”以开始共享向导。
4. 单击“**下一步**”按钮。
5. 选择要共享的文件夹，然后单击“**下一步**”按钮。
6. 单击“**下一步**”以使用共享默认设置，或选择“**自定义**”并设置所需权限。
7. 单击“**确定**”按钮。
8. 单击“**完成**”按钮以共享文件夹。

#### 在树莓派上挂载文件夹

在 Linux 中，**挂载** 即是将文件夹添加到某位置的过程，因此我们首先需要该位置。

```sh
$ mkdir windowshare
```

现在，我们需要将远程文件夹挂载到该位置。远程文件夹是 Windows PC 的主机名/IP 地址，以及在共享时使用的共享名称。我们还需要提供将用于访问远程计算机的 Windows 用户名。不要忘记用你的树莓派系统用户名替换占位符 `<用户名>`。

```sh
$ sudo mount.cifs //<主机名或IP地址>/<Windows 共享文件夹> /home/<用户名>/windowshare -o user=<Windows 用户名>
```

你现在应该能够在树莓派上查看 Windows 共享的内容。

```sh
$ ls windowshare/
```

#### 报错“Host is down”（主机已关闭）

当 SMB 协议版本不匹配且 Linux Samba 客户端返回误导性错误消息时会发生此错误。在默认情况下，树莓派系统使用 2.1 及以上版本，兼容 Windows 7 及更高版本。包括某些 NAS 设备在内的旧款设备可能需要 1.0 版本。要解决此错误，请在你的挂载命令中添加一个版本条目（例如 `,vers=1.0`）：

```sh
$ sudo mount.cifs //IP/share /mnt/挂载点 -o user=<用户名>,vers=1.0
```

你可能需要尝试不同的版本以与服务器版本匹配。可用的值有：

|  版本  | 说明                                                              |
| :--: | --------------------------------------------------------------- |
|  1.0 | 经典 CIFS/SMBv1 协议                                                |
|  2.0 | SMBv2.002 协议。Windows Vista Service Pack 1 和 Windows Server 2008 |
|  2.1 | SMBv2.1 协议。Microsoft Windows 7 和 Windows Server 2008R2          |
|  3.0 | SMBv3.0 协议。Microsoft Windows 8 和 Windows Server 2012            |
| 3.02 | SMBv3.0.2 协议。Microsoft Windows 8.1 和 Windows Server 2012R2      |
| 3.11 | SMBv3.1.1 协议。Microsoft Windows 10 和 Windows Server 2016         |
|   3  | SMBv3.0 协议版本及以上                                                 |

### 从你的树莓派共享文件夹

先创建一个要共享的文件夹。此例在当前用户的 `home` 文件夹中创建了一个名为 `shared` 的文件夹：

```sh
$ cd ~
$ mkdir shared
$ chmod 0740 shared
```

现在我们需要在访问该文件夹时告诉 Samba 你的默认用户账户。出现提示后，请输入你的密码，并用你的主用户账户的用户名替换占位符 `<用户名>`：

```sh
$ sudo smbpasswd -a <用户名>
```

现在我们需要使用 Samba 配置文件告诉 Samba 共享这个文件夹。

```sh
sudo nano /etc/samba/smb.conf
```

在文件末尾，添加以下内容以共享文件夹，为远程用户提供读写权限。用你的树莓派上主用户账户的用户名替换占位符 `<用户名>`：

```json
[share]
    path = /home/<用户名>/shared
    read only = no
    public = yes
    writable = yes
```

在同一文件中，找到 `workgroup` 这一行，如有必要，将其更改为本地 Windows 网络工作组的名称。

```json
workgroup = <你的工作组名称>
```

现在，网络上的 Windows/macOS 设备应该能看到这个共享文件夹。输入你的树莓派用户名和密码挂载文件夹。

## 设置 Apache Web 服务器

Apache 是一款流行的 Web 服务器应用程序，你可以在树莓派上安装它，使其提供网页。

若单独使用，Apache 可以通过 HTTP 提供 HTML 文件，且通过附加模块可以使用脚本语言（如 PHP）提供动态网页。

要设置 Apache Web 服务器，请参阅 Apache 官方文档：<https://httpd.apache.org/docs/>。

## 通过网络启动树莓派

你可以设置一台 DHCP/TFTP 服务器，这能让你从网络启动树莓派 3 或更新机型。

以下说明假定你有一个既有的家庭网络，并且你想要使用树莓派作为 **服务器**。你还需要另一台树莓派 3 或更新机型作为 **客户端** 来引导。仅需一张存储卡，因为在初始客户端配置后，**客户端** 将从服务器引导。

> **注意**
>
> 由于网络设备和路由器的种类繁多，我们无法保证网络启动能在所有设备上都正常工作。我们收到报告称，若无法使网络启动正常工作，可尝试在网络上禁用 STP 帧来帮助排除故障。

### 配置网络启动客户端

#### 树莓派 3B

> **注意**
>
> 此部分仅适用于树莓派 3B，因为树莓派 3B+ 在出厂时已启用网络启动。

在树莓派 3B 进行网络启动之前，需要先从带有配置选项的存储卡启动，以启用 USB 启动模式。这会在树莓派 SoC 的 OTP（一次性可编程）存储器中设置一个位，从而启用网络启动。完成此操作后，如果树莓派 3B 无法从存储卡启动，将尝试 USB 启动和网络启动。

按常规方式在存储卡上安装精简版树莓派系统或带桌面的树莓派系统。接下来，使用以下命令启用 USB 启动模式：

```sh
$ echo program_usb_boot_mode=1 | sudo tee -a /boot/firmware/config.txt
```

将 `program_usb_boot_mode=1` 添加到 [`/boot/firmware/config.txt`](https://www.raspberrypi.com/documentation/computers/config_txt.html#what-is-config-txt) 的末尾。使用 `sudo reboot` 重启树莓派。在客户端树莓派重启后，请检查 OTP 是否已编程为：

```sh
$ vcgencmd otp_dump | grep 17:
17:3020000a
```

确保输出为正确的 `0x3020000a`。

客户端配置几乎完成。作为最后一步，禁用 USB 启动。运行以下命令：

```sh
$ sudo nano /boot/firmware/config.txt
```

删除包含文本 `program_usb_boot_mode=1` 的那一行。最后，使用 `sudo poweroff` 关闭客户端树莓派。

#### 树莓派 4B

可以在树莓派 4 上使用 `raspi-config` 工具启用网络启动。首先，按照以下方式运行 `raspi-config`：

```sh
$ sudo raspi-config
```

在 `raspi-config` 中，选择 **Advanced Options**，然后选择 **Boot Order**，最后选择 **Network Boot**。然后必须重启设备，以便将引导顺序的更改编程到引导加载程序 EEPROM 中。在树莓派重启后，请检查现在的启动顺序是否为 `0xf21`：

```sh
$ vcgencmd bootloader_config
```

有关配置树莓派 4 引导加载程序的更多详细信息，请参阅[树莓派引导加载程序配置](https://www.raspberrypi.com/documentation/computers/raspberry-pi.html#raspberry-pi-bootloader-configuration)。

### 以太网 MAC 地址

在配置网络启动之前，请记下序列号和 MAC 地址，以便 TFTP/DHCP 服务器可以识别开发板。

在树莓派 4 及后续旗舰机型上，MAC 地址是在制造时写入的，MAC 地址和序列号之间没有关联。MAC 地址和序列号都显示在引导加载程序的 [HDMI 诊断](https://www.raspberrypi.com/documentation/computers/raspberry-pi.html#boot-diagnostics)屏幕上。

要查找以太网 MAC 地址，请运行以下命令：

```sh
$ ethtool -P eth0
```

要查找序列号，请运行以下命令：

```sh
$ grep Serial /proc/cpuinfo | cut -d ' ' -f 2 | cut -c 9-16
```

### 配置网络启动服务器

将存储卡插入服务器树莓派，然后启动服务器。客户端树莓派需要一个用于启动的根文件系统：我们将使用服务器的根文件系统的副本，并将其放置在 `/nfs/client1`：

```sh
$ sudo mkdir -p /nfs/client1
$ sudo apt install rsync
$ sudo rsync -xa --progress --exclude /nfs / /nfs/client1
```

在客户端文件系统中通过 `chroot` 重新生成 SSH 主机密钥：

```sh
$ cd /nfs/client1
$ sudo mount --bind /dev dev
$ sudo mount --bind /sys sys
$ sudo mount --bind /proc proc
$ sudo chroot .
$ rm /etc/ssh/ssh_host_*
$ dpkg-reconfigure openssh-server
$ exit
$ sudo umount dev sys proc
```

查找本地网络的设置。你需要找到路由器（或网关）的地址，可以通过以下方式完成：

```sh
$ ip route | awk '/default/ {print $3}'
```

然后运行：

```sh
$ ip -4 addr show dev eth0 | grep inet
```

你将看到类似以下内容的输出：

```sh
inet 10.42.0.211/24 brd 10.42.0.255 scope global eth0
```

第一个地址是你的服务器树莓派在网络上的 IP 地址，斜杠后面的部分是网络大小。你的很可能是一个 `/24`。还要注意网络的 `brd`（广播）地址。记下前一个命令的输出，其中包含了树莓派的 IP 地址和网络的广播地址。

最后，记下你的 DNS 服务器地址，这与你的网关地址相同。你可以使用以下命令找到这个地址：

```sh
$ cat /etc/resolv.conf
```

在服务器树莓派上通过 `systemd` 网络配置静态网络地址，`systemd` 网络在这里充当网络处理程序和 DHCP 服务器。

为此，你需要创建一个 `10-eth0.netdev` 和一个 `11-eth0.network`，如下所示：

```sh
$ sudo nano /etc/systemd/network/10-eth0.netdev
```

添加以下行：

```json
[Match]
Name=eth0

[Network]
DHCP=no
```

然后创建一个网络文件：

```sh
$ sudo nano /etc/systemd/network/11-eth0.network
```

添加以下内容：

```json
[Match]
Name=eth0

[Network]
Address=10.42.0.211/24
DNS=10.42.0.1

[Route]
Gateway=10.42.0.1
```

此时，你没有工作中的 DNS，因此你需要将之前记录的 DNS 服务器添加到 `systemd/resolved.conf`。在此示例中，网关地址为 `10.42.0.1`。

```sh
$ sudo nano /etc/systemd/resolved.conf
```

取消注释 DNS 那一行，并在那里添加 DNS IP 地址。另外，如果你有备用 DNS 服务器，也请一并添加。

```json
[Resolve]
DNS=10.42.0.1
#FallbackDNS=
```

启用 `systemd-networkd`，然后重启以使更改生效：

```sh
$ sudo systemctl enable systemd-networkd
$ sudo reboot
```

现在启动 `tcpdump`，以便搜索来自客户端树莓派的 DHCP 数据包。

```sh
$ sudo apt install tcpdump dnsmasq
$ sudo systemctl enable dnsmasq
$ sudo tcpdump -i eth0 port bootpc
```

把客户端树莓派接入你的网络，再打开电源。检查客户端的 LED 是否在大约 10 秒后亮起，然后你应该从客户端收到一个数据包“DHCP/BOOTP, Request from …”。

```sh
IP 0.0.0.0.bootpc > 255.255.255.255.bootps: BOOTP/DHCP, Request from b8:27:eb...
```

现在你需要修改 `dnsmasq` 配置以使 DHCP 能够回复设备。按下 **Ctrl** + **C** 退出 `tcpdump` 程序，然后输入以下内容：

```sh
$ echo | sudo tee /etc/dnsmasq.conf
$ sudo nano /etc/dnsmasq.conf
```

然后用以下内容替换 `dnsmasq.conf` 的内容：

```json
# 注意：如果你希望网络上的系统使用 DNS 服务，请注释掉端口。
port=0
dhcp-range=10.42.0.255,proxy
log-dhcp
enable-tftp
tftp-root=/tftpboot
pxe-service=0,"Raspberry Pi Boot"
```

在 `dhcp-range` 行的第一个地址处，使用你之前记录的广播地址。

现在创建一个目录 `/tftpboot`：

```sh
$ sudo mkdir /tftpboot
$ sudo chmod 777 /tftpboot
$ sudo systemctl enable dnsmasq.service
$ sudo systemctl restart dnsmasq.service
```

现在监视 `dnsmasq` 日志：

```sh
$ journalctl -f
```

你应该看到类似这样的内容：

```sh
raspberrypi dnsmasq-tftp[1903]: file /tftpboot/bootcode.bin not found
```

接下来，你需要将 boot 文件夹的内容复制到目录 `/tftpboot` 中。

首先，按下 **Ctrl** + **C** 退出监控状态。然后输入以下内容：

```sh
$ cp -r /boot/firmware/* /tftpboot
```

由于 tftp 位置已更改，请重启 `dnsmasq`：

```sh
$ sudo systemctl restart dnsmasq
```

#### 设置 NFS root

现在，客户端树莓派应该可以持续尝试启动，直到尝试加载根文件系统（而它没有根文件系统）。

在这一点上，导出之前创建的 `/nfs/client1` 文件系统和 TFTP 启动文件夹。

```sh
$ sudo apt install nfs-kernel-server
$ echo "/nfs/client1 *(rw,sync,no_subtree_check,no_root_squash)" | sudo tee -a /etc/exports
$ echo "/tftpboot *(rw,sync,no_subtree_check,no_root_squash)" | sudo tee -a /etc/exports
```

重启 RPC-Bind 和 NFS 服务器，以便它们检测到新文件。

```sh
$ sudo systemctl enable rpcbind
$ sudo systemctl restart rpcbind
$ sudo systemctl enable nfs-kernel-server
$ sudo systemctl restart nfs-kernel-server
```

编辑 `/tftpboot/cmdline.txt`，把从 `root=` 开始的内容替换为：

```sh
root=/dev/nfs nfsroot=10.42.0.211:/nfs/client1,vers=3 rw ip=dhcp rootwait
```

在这里用你记录下的 IP 地址替换 IP 地址。还要删除命令行中所有以 `init=` 开头的部分。

最后，编辑 `/nfs/client1/etc/fstab`，删除 `/dev/mmcblk0p1` 和 `p2` 这两行（只留下 `proc`）。然后，将引导分区添加回去：

```bash
$ echo "10.42.0.211:/tftpboot /boot/firmware/ nfs defaults,vers=3 0 0" | sudo tee -a /nfs/client1/etc/fstab
```

如果第一次尝试无法启动，请继续尝试。树莓派启动可能需要一分钟左右，所以请耐心等待。

## 使用 IPv6 进行网络启动

通过网络启动树莓派有 4 个阶段：

1. 引导加载程序使用 DHCP 协商获取 IP 地址和 TFTP 服务器的详细信息。
2. 引导加载程序通过 TFTP 加载固件，并将引导过程交给固件，将网络详细信息传递给它。
3. 固件通过 TFTP 加载内核和命令行。
4. 内核引导系统的其余部分，通过 NFS 或其他机制加载根文件系统（rootfs）。

引导加载程序和固件（阶段 1 到 3）已经得到增强，以支持通过 IPv6 启动。

> **重要**
>
> IPv6 网络启动是一项 **实验性 alpha 功能**，根据反馈意见，我们可能需要在将来更改其工作方式。这仅适用于树莓派 4 和计算模块 4。

### 工作原理

要通过 IPv6 启动，你需要一个更新的固件版本（例如 `start4.elf`）和引导加载程序。使用最新版本的树莓派系统和最新的稳定引导加载程序应该足够了。

> **注意**
>
> 目前常用的 DHCP 服务器 `dnsmasq` 不支持 IPv6 网络启动所需的参数，因此就目前而言，你只能使用其他 DHCP 服务器，如 [ISC DHCP](https://www.isc.org/dhcp/)。

要通过网络挂载 `rootfs`，[IPv4 网络启动教程](https://www.raspberrypi.com/documentation/computers/remote-access.html#network-boot-your-raspberry-pi)建议使用 `nfsroot`。它不支持 IPv6，因此需要其他方法来通过网络挂载 `rootfs`。

如果你的 ISP 和路由器不支持 IPv6，你将受到限制。

#### 网络地址

引导加载程序要做的第一件事是发送路由器请求，以获取网络的详细信息。路由器会以通告数据包回应，标识其以太网地址，如果 TFTP 服务器位于不同的网络上，引导加载程序可能会需要这些信息。

路由器通告包含一个标志，告诉设备是否使用有状态（托管）或无状态（非托管）配置来获取其 IP 地址。无状态配置意味着设备配置自己的 IP 地址。目前，引导加载程序生成一个从其以太网 MAC 地址和路由器提供的网络前缀派生的地址。

如果路由器指示启用了有状态配置，则使用 DHCP 来获取设备的 IP 地址。这涉及设备向 DHCP 服务器发送一个请求，服务器响应一个通告。随后客户端请求地址，并从服务器获得确认回复。

DHCP 服务器和客户端使用可变长度的 DUID（设备唯一 ID）来标识自己。在树莓派上，这是从 MAC 地址（DUID\_LL）派生的。

#### TFTP 地址

无论使用无状态还是有状态配置，DHCP 服务器用于获取 TFTP 服务器地址。这是在 `BOOTFILE-URL` 参数中编码的。我们发送客户端架构类型值 `0x29` 以识别设备。

请参阅 [RFC 5970](https://datatracker.ietf.org/doc/html/rfc5970) 和 [IANA IPv6 动态主机配置协议](https://www.iana.org/assignments/dhcpv6-parameters/dhcpv6-parameters.xhtml)文档。

#### 引导过程

设备现在应该有一个 IP 地址和 TFTP 详细信息。它从 TFTP 服务器下载固件二进制 `start4.elf`，然后继续使用此固件运行。IP 地址和 TFTP 服务器详细信息会传递给固件，以便它可以下载内核并引导系统的其余部分。

#### 内核引导

使用 IPv4 网络启动时，`nfsroot` 用于在网络上挂载 `rootfs`。这不支持 IPv6，因此需要另一种解决方案。可能涉及一个小型 RAM 文件系统，它可以在切换到正式的 `rootfs` 内容之前挂载相应的网络位置。

> **注意**
>
> 通过 IPv6 利用 NFS 启动 Linux 内核的机制仍有待演示。

### 测试设置

如果你想尝试这一功能，将需要另一台树莓派作为 TFTP 和 DHCP 服务器。

理论上，TFTP 服务器可以位于任意可路由的网络上，但 DHCP 服务器必须与将要提供服务的设备位于同一网络上。

#### TFTP 服务器

如果你有一个工作的 IPv4 网络启动设置，你可以重用 `dnsmasq` 中的 TFTP 服务器来提供文件（它可以与 IPv4 和 IPv6 通信）。

或者你可以使用一个独立的 TFTP 服务器，比如 `tftpd-hpa`。

```sh
$ sudo apt install tftpd-hpa
$ sudo systemctl start tftpd-hpa
```

#### DHCP 服务器

IPv6 中的 DHCP 发生了很大变化。我们至少需要 DHCP 告诉我们 TFTP 服务器的地址，在这种情况下是同一台机器。

```sh
$ sudo apt install isc-dhcp-server
```

修改 `/etc/default/isc-dhcp-server` 中的配置：

```sh
DHCPDv6_CONF=/etc/dhcp/dhcpd6.conf
INTERFACESv6="eth0"
```

在 `/etc/dhcp/dhcpd6.conf` 中，你需要指定 TFTP 服务器地址并设置子网。这里 DHCP 服务器配置为提供一些虚构的唯一本地地址（ULA）。`host test-rpi4` 行告诉 DHCP 为测试设备提供固定地址。

```sh
not authoritative;

# 检查客户端是否像个树莓派
if option dhcp6.client-arch-type = 00:29 {
        option dhcp6.bootfile-url "tftp://[fd49:869:6f93::1]/";
}

subnet6 fd49:869:6f93::/64 {
        host test-rpi4 {
                host-identifier option dhcp6.client-id 00:03:00:01:e4:5f:01:20:24:0b;
                fixed-address6 fd49:869:6f93::1000;
        }
}
```

必须在 `/etc/dhcpcd.conf` 中为你的服务器分配 IPv6 地址。

```sh
interface eth0
static ip6_address=fd49:869:6f93::1/64
```

现在启动 DHCP 服务器。

```sh
$ sudo systemctl restart isc-dhcp-server.service
```

#### 引导加载程序

修改配置以通过 IPv6 尝试网络启动，而非 IPv4。

```sh
BOOT_ORDER=0xf21 # 2=网络启动
USE_IPV6=1 # 启用 IPv6 网络启动
BOOT_UART=1 # 调试
```

要恢复到 IPv4 网络启动，只需从 `boot.conf` 中删除 `USE_IPV6` 行。

#### 路由器

要使用 IPv6，你确实需要支持 IPv6 的路由器和 ISP。互联网上有一些网站可以为你检查这一点，或者运行以下命令。

```sh
sudo apt install ndisc6
rdisc6 -1 eth0
```

这会向你的路由器发送路由器请求，请求你的网络详细信息，如网络前缀、路由器以太网地址以及是否使用 DHCP 进行寻址。如果此命令没有收到响应，很可能是你的网络和 ISP 仅支持 IPv4。如果支持 IPv6，很可能会配置为使用无状态配置，其中客户端生成自己的地址。

```json
Soliciting ff02::2 (ff02::2) on eth0...
Hop limit                 :           64 (      0x40)
Stateful address conf.    :           No
Stateful other conf.      :          Yes
Mobile home agent         :           No
Router preference         :       medium
Neighbor discovery proxy  :           No
Router lifetime           :          180 (0x000000b4) seconds
Reachable time            :  unspecified (0x00000000)
Retransmit time           :  unspecified (0x00000000)
```

你可能能够将路由器配置为有状态配置，这意味着设备将使用 DHCP 获取 IP 地址。

```json
Hop limit                 :           64 (      0x40)
Stateful address conf.    :          Yes
Stateful other conf.      :          Yes
Mobile home agent         :           No
Router preference         :       medium
Neighbor discovery proxy  :           No
Router lifetime           :          180 (0x000000b4) seconds
Reachable time            :  unspecified (0x00000000)
Retransmit time           :  unspecified (0x00000000)
```

### 调试

#### 日志和跟踪

如果启用了启动 UART，则应该可以从串口看到类似以下内容。以 RX6 开头的行表示正在使用 IPv6。

这里 `dc:a6:32:6f:73:f4` 是 TFTP 服务器的 MAC 地址，它具有一个 IPv6 地址 `fd49:869:6f93::1`。设备本身具有一个 MAC 地址 `e4:5f:01:20:24:0b` 和一个 IPv6 地址 `fd49:869:6f93::1000`。

```json
Boot mode: NETWORK (02) order f
GENET: RESET_PHY
PHY ID 600d 84a2
NET_BOOT: e4:5f:01:20:24:0b wait for link TFTP6: (null)
LINK STATUS: speed: 100 full duplex
Link ready
GENET START: 64 16 32
GENET: UMAC_START 0xe45f0120 0x240b0000
RX6: 12 IP: 1 MAC: 1 ICMP: 1/1 UDP: 0/0 ICMP_CSUM_ERR: 0 UDP_CSUM_ERR: 0
NET fd49:869:6f93::1000 tftp fd49:869:6f93::1
RX6: 17 IP: 4 MAC: 4 ICMP: 2/2 UDP: 2/2 ICMP_CSUM_ERR: 0 UDP_CSUM_ERR: 0
TFTP_GET: dc:a6:32:6f:73:f4 fd49:869:6f93::1 ab5a4158/start4.elf

RX6: 17 IP: 4 MAC: 4 ICMP: 2/2 UDP: 2/2 ICMP_CSUM_ERR: 0 UDP_CSUM_ERR: 0
RX6: 18 IP: 5 MAC: 5 ICMP: 2/2 UDP: 3/3 ICMP_CSUM_ERR: 0 UDP_CSUM_ERR: 0
TFTP_GET: dc:a6:32:6f:73:f4 fd49:869:6f93::1 ab5a4158/config.txt
```

最后，引导加载程序将控制权交给应该加载内核的固件。

#### 有状态配置

你可以使用 `tcpdump` 检查网络活动。

```sh
$ sudo tcpdump -i eth0 -e ip6 -XX -l -v -vv
```

下面是一个 TCP 转储的摘录，其中路由器配置为使用有状态（DHCP）网络配置。

设备发送路由器请求。

```json
12:23:35.387046 e4:5f:01:20:24:0b (oui Unknown) > 33:33:00:00:00:02 (oui Unknown), ethertype IPv6 (0x86dd), length 70: (hlim 255, next-header ICMPv6 (58) payload length: 16) fe80::e65f:1ff:fe20:240b > ip6-allrouters: [icmp6 sum ok] ICMP6, router solicitation, length 16
          source link-address option (1), length 8 (1): e4:5f:01:20:24:0b
            0x0000:  e45f 0120 240b
```

路由器发送响应，告知设备使用有状态配置。

```json
12:23:35.498902 60:8d:26:a7:c1:88 (oui Unknown) > 33:33:00:00:00:01 (oui Unknown), ethertype IPv6 (0x86dd), length 110: (hlim 255, next-header ICMPv6 (58) payload length: 56) bthub.home > ip6-allnodes: [icmp6 sum ok] ICMP6, router advertisement, length 56
        hop limit 64, Flags [managed, other stateful], pref medium, router lifetime 180s, reachable time 0ms, retrans timer 0ms
          rdnss option (25), length 24 (3):  lifetime 60s, addr: bthub.home
            0x0000:  0000 0000 003c fe80 0000 0000 0000 628d
            0x0010:  26ff fea7 c188
          mtu option (5), length 8 (1):  1492
            0x0000:  0000 0000 05d4
          source link-address option (1), length 8 (1): 60:8d:26:a7:c1:88
            0x0000:  608d 26a7 c188
```

设备发送 DHCP 请求。

```json
12:23:35.502517 e4:5f:01:20:24:0b (oui Unknown) > 33:33:00:01:00:02 (oui Unknown), ethertype IPv6 (0x86dd), length 114: (hlim 255, next-header UDP (17) payload length: 60) fe80::e65f:1ff:fe20:240b.dhcpv6-client > ff02::1:2.dhcpv6-server: [udp sum ok] dhcp6 solicit (xid=8cdd56 (client-ID hwaddr type 1 e45f0120240b) (IA_NA IAID:0 T1:0 T2:0) (option-request opt_59) (opt_61) (elapsed-time 0))
```

DHCP 服务器回复通告。

```json
12:23:35.510478 dc:a6:32:6f:73:f4 (oui Unknown) > e4:5f:01:20:24:0b (oui Unknown), ethertype IPv6 (0x86dd), length 172: (flowlabel 0xad54d, hlim 64, next-header UDP (17) payload length: 118) fe80::537a:52c:c647:b184.dhcpv6-server > fe80::e65f:1ff:fe20:240b.dhcpv6-client: [bad udp cksum 0xd886 -> 0x6d26!] dhcp6 advertise (xid=8cdd56 (IA_NA IAID:0 T1:3600 T2:7200 (IA_ADDR fd49:869:6f93::1000 pltime:604800 vltime:2592000)) (client-ID hwaddr type 1 e45f0120240b) (server-ID hwaddr/time type 1 time 671211709 dca6326f73f4) (opt_59))
```

设备向 DHCP 服务器发送地址和 TFTP 详细信息的请求。

```json
12:23:35.510763 e4:5f:01:20:24:0b (oui Unknown) > 33:33:00:01:00:02 (oui Unknown), ethertype IPv6 (0x86dd), length 132: (hlim 255, next-header UDP (17) payload length: 78) fe80::e65f:1ff:fe20:240b.dhcpv6-client > ff02::1:2.dhcpv6-server: [udp sum ok] dhcp6 request (xid=8cdd56 (client-ID hwaddr type 1 e45f0120240b) (server-ID hwaddr/time type 1 time 671211709 dca6326f73f4) (IA_NA IAID:0 T1:0 T2:0) (option-request opt_59) (opt_61) (elapsed-time 1))
```

DHCP 服务器回复，`opt_59` 用于传递 TFTP 服务器的地址。

```json
12:23:35.512122 dc:a6:32:6f:73:f4 (oui Unknown) > e4:5f:01:20:24:0b (oui Unknown), ethertype IPv6 (0x86dd), length 172: (flowlabel 0xad54d, hlim 64, next-header UDP (17) payload length: 118) fe80::537a:52c:c647:b184.dhcpv6-server > fe80::e65f:1ff:fe20:240b.dhcpv6-client: [bad udp cksum 0xd886 -> 0x6826!] dhcp6 reply (xid=8cdd56 (IA_NA IAID:0 T1:3600 T2:7200 (IA_ADDR fd49:869:6f93::1000 pltime:604800 vltime:2592000)) (client-ID hwaddr type 1 e45f0120240b) (server-ID hwaddr/time type 1 time 671211709 dca6326f73f4) (opt_59))
```

设备向 TFTP 服务器发送邻居请求，因为它需要其 MAC 地址。

```json
12:23:36.510768 e4:5f:01:20:24:0b (oui Unknown) > 33:33:ff:00:00:01 (oui Unknown), ethertype IPv6 (0x86dd), length 86: (hlim 255, next-header ICMPv6 (58) payload length: 32) fe80::e65f:1ff:fe20:240b > ff02::1:ff00:1: [icmp6 sum ok] ICMP6, neighbor solicitation, length 32, who has fd49:869:6f93::1
          source link-address option (1), length 8 (1): e4:5f:01:20:24:0b
            0x0000:  e45f 0120 240b
```

TFTP 服务器将以其 MAC 地址回复。

```json
12:23:36.510854 dc:a6:32:6f:73:f4 (oui Unknown) > e4:5f:01:20:24:0b (oui Unknown), ethertype IPv6 (0x86dd), length 86: (hlim 255, next-header ICMPv6 (58) payload length: 32) fd49:869:6f93::1 > fe80::e65f:1ff:fe20:240b: [icmp6 sum ok] ICMP6, neighbor advertisement, length 32, tgt is fd49:869:6f93::1, Flags [solicited, override]
          destination link-address option (2), length 8 (1): dc:a6:32:6f:73:f4
            0x0000:  dca6 326f 73f4
```

TFTP 请求由此时应已通过网络启动的设备发出。

```json
12:23:36.530820 e4:5f:01:20:24:0b (oui Unknown) > dc:a6:32:6f:73:f4 (oui Unknown), ethertype IPv6 (0x86dd), length 111: (hlim 255, next-header UDP (17) payload length: 57) fd49:869:6f93::1000.61785 > fd49:869:6f93::1.tftp: [udp sum ok]  49 RRQ "ab5a4158/start4.elf" octet tsize 0 blksize 1024
```

#### 无状态配置

下面是一个用于无状态（非 DHCP）网络配置的 TCP 转储的摘录。

设备发送路由器请求。

```json
12:55:27.541909 e4:5f:01:20:24:0b (oui Unknown) > 33:33:00:00:00:02 (oui Unknown), ethertype IPv6 (0x86dd), length 70: (hlim 255, next-header ICMPv6 (58) payload length: 16) fe80::e65f:1ff:fe20:240b > ip6-allrouters: [icmp6 sum ok] ICMP6, router solicitation, length 16
          source link-address option (1), length 8 (1): e4:5f:01:20:24:0b
            0x0000:  e45f 0120 240b
```

路由器回复网络详细信息。

```json
12:55:27.834684 60:8d:26:a7:c1:88 (oui Unknown) > 33:33:00:00:00:01 (oui Unknown), ethertype IPv6 (0x86dd), length 174: (hlim 255, next-header ICMPv6 (58) payload length: 120) bthub.home > ip6-allnodes: [icmp6 sum ok] ICMP6, router advertisement, length 120
        hop limit 64, Flags [other stateful], pref medium, router lifetime 180s, reachable time 0ms, retrans timer 0ms
          prefix info option (3), length 32 (4): 2a00:23c5:ee00:5001::/64, Flags [onlink, auto, router], valid time 300s, pref. time 120s
            0x0000:  40e0 0000 012c 0000 0078 0000 0000 2a00
            0x0010:  23c5 ee00 5001 0000 0000 0000 0000
          prefix info option (3), length 32 (4): fd4d:869:6f93::/64, Flags [onlink, auto, router], valid time 10080s, pref. time 2880s
            0x0000:  40e0 0000 2760 0000 0b40 0000 0000 fd4d
            0x0010:  0869 6f93 0000 0000 0000 0000 0000
          rdnss option (25), length 24 (3):  lifetime 60s, addr: bthub.home
            0x0000:  0000 0000 003c fe80 0000 0000 0000 628d
            0x0010:  26ff fea7 c188
          mtu option (5), length 8 (1):  1492
            0x0000:  0000 0000 05d4
          source link-address option (1), length 8 (1): 60:8d:26:a7:c1:88
            0x0000:  608d 26a7 c188
```

设备向 DHCP 组播地址发送信息请求，请求 TFTP 详细信息。

```json
12:55:27.838300 e4:5f:01:20:24:0b (oui Unknown) > 33:33:00:01:00:02 (oui Unknown), ethertype IPv6 (0x86dd), length 98: (hlim 255, next-header UDP (17) payload length: 44) fe80::e65f:1ff:fe20:240b.dhcpv6-client > ff02::1:2.dhcpv6-server: [udp sum ok] dhcp6 inf-req (xid=e5e0a4 (client-ID hwaddr type 1 e45f0120240b) (option-request opt_59) (opt_61) (elapsed-time 0))
```

DHCP 服务器回复 TFTP 服务器详细信息（`opt_59`）。

```json
12:55:27.838898 dc:a6:32:6f:73:f4 (oui Unknown) > e4:5f:01:20:24:0b (oui Unknown), ethertype IPv6 (0x86dd), length 150: (flowlabel 0xd1248, hlim 64, next-header UDP (17) payload length: 96) fe80::537a:52c:c647:b184.dhcpv6-server > fe80::e65f:1ff:fe20:240b.dhcpv6-client: [bad udp cksum 0xd870 -> 0x78bb!] dhcp6 reply (xid=e5e0a4 (client-ID hwaddr type 1 e45f0120240b) (server-ID hwaddr/time type 1 time 671211709 dca6326f73f4) (opt_59))
```

设备请求 TFTP 服务器 MAC 地址，因为它能判断出 TFTP 服务器在同一网络上。

```json
12:55:28.834796 e4:5f:01:20:24:0b (oui Unknown) > 33:33:ff:1d:fe:2a (oui Unknown), ethertype IPv6 (0x86dd), length 86: (hlim 255, next-header ICMPv6 (58) payload length: 32) fe80::e65f:1ff:fe20:240b > ff02::1:ff1d:fe2a: [icmp6 sum ok] ICMP6, neighbor solicitation, length 32, who has 2a00:23c5:ee00:5001:57f1:7523:2f1d:fe2a
          source link-address option (1), length 8 (1): e4:5f:01:20:24:0b
            0x0000:  e45f 0120 240b
```

TFTP 服务器将以其 MAC 地址回复。

```json
12:55:28.834875 dc:a6:32:6f:73:f4 (oui Unknown) > e4:5f:01:20:24:0b (oui Unknown), ethertype IPv6 (0x86dd), length 86: (hlim 255, next-header ICMPv6 (58) payload length: 32) 2a00:23c5:ee00:5001:57f1:7523:2f1d:fe2a > fe80::e65f:1ff:fe20:240b: [icmp6 sum ok] ICMP6, neighbor advertisement, length 32, tgt is 2a00:23c5:ee00:5001:57f1:7523:2f1d:fe2a, Flags [solicited, override]
          destination link-address option (2), length 8 (1): dc:a6:32:6f:73:f4
            0x0000:  dca6 326f 73f4
```

设备开始发出 TFTP 请求。

```json
12:55:28.861097 e4:5f:01:20:24:0b (oui Unknown) > dc:a6:32:6f:73:f4 (oui Unknown), ethertype IPv6 (0x86dd), length 111: (hlim 255, next-header UDP (17) payload length: 57) 2a00:23c5:ee00:5001:e65f:1ff:fe20:240b.46930 > 2a00:23c5:ee00:5001:57f1:7523:2f1d:fe2a.tftp: [udp sum ok]  49 RRQ "ab5a4158/start4.elf" octet tsize 0 blksize 1024
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://book.bsdcn.org/rpicn/shu-mei-pai/yuan-cheng-fang-wen.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
