警告

除已校对部分外，本项目目前翻译错漏百出，不适合用于生产。

本项目目前处于低维护状态，主要维护者因精力所限仅处理 PR。欢迎社区通过 PR 贡献力量。

正在施工，具体进度请看编辑日志。

官方原址：https://docs.freebsd.org/en/books/handbook/

旧版存档

https://www.alipan.com/s/9rUaCHKauvC

• 2025.12.1 仅更新 handbook/cutting-edge 到 https://cgit.freebsd.org/doc/commit/?id=099e57c42a

• 2025.8.15 同步至

• 2025.5.2 机器翻译至

• 2024.9.28

这部分手册是面向 FreeBSD 新用户和管理员的。在本章节：

• 介绍了 FreeBSD。

• 引导读者完成安装过程。

• 教授 UNIX® 基础知识和基本原理。

安装 FreeBSD 的硬件要求因架构和版本而异。每款 FreeBSD RELEASE 支持的硬件架构和设备列在 页面上。也提供了针对不同架构正确镜像的建议。

bsdinstall 的欢迎菜单（见提供了选项 Live CD。这对那些仍在考虑 FreeBSD 是否适合自己的用户很有帮助，他们可以在安装之前测试一些功能。

在使用 Live CD 前应注意以下几点：

• 使用系统需要身份验证。用户名为 root，密码为空。

• 由于系统直接从安装介质运行，性能将明显弱于安装在硬盘上的系统。

商标

FreeBSD 是 FreeBSD 基金会的注册商标。

IBM、AIX、OS/2、PowerPC、PS/2、S/390 和 ThinkPad 是国际商业机器公司在美国、其他国家或两者之间的商标。

IEEE、POSIX 和 802 是美国电气和电子工程师协会的注册商标。

Red Hat、RPM 是 Red Hat, Inc.在美国和其他国家的商标或注册商标。

3Com 和 HomeConnect 是 3Com Corporation 的注册商标。

Adobe、Acrobat、Acrobat Reader、Flash 和 PostScript 是 Adobe Systems Incorporated 在美国和/或其他国家的注册商标或商标。

Apple、AirPort、FireWire、iMac、iPhone、iPad、Mac、Macintosh、Mac OS、Quicktime 和 TrueType 是美国和其他国家注册的 Apple Inc.商标。

Intel、Celeron、Centrino、Core、EtherExpress、i386、i486、Itanium、Pentium 和 Xeon 是 Intel Corporation 或其在美国和其他国家的子公司的商标或注册商标。

Linux 是 Linus Torvalds 的注册商标。

Microsoft、IntelliMouse、MS-DOS、Outlook、Windows、Windows Media 和 Windows NT 是 Microsoft Corporation 在美国和/或其他国家的注册商标或商标。

Motif、OSF/1 和 UNIX 是 The Open Group 在美国和其他国家的注册商标，IT DialTone 和 The Open Group 是 The Open Group 的商标。

Sun、Sun Microsystems、Java、Java Virtual Machine、JDK、JRE、JSP、JVM、Netra、OpenJDK、Solaris、StarOffice、SunOS 和 VirtualBox 是 Sun Microsystems, Inc.在美国和其他国家的商标或注册商标。

RealNetworks、RealPlayer 和 RealAudio 是 RealNetworks, Inc.的注册商标。

Oracle 是 Oracle Corporation 的注册商标。

3ware 是 3ware Inc.的注册商标。

ARM 是 ARM Limited 的注册商标。

Adaptec 是 Adaptec, Inc.的注册商标。

Android 是 Google Inc.的商标。

Heidelberg、Helvetica、Palatino 和 Times Roman 是 Heidelberger Druckmaschinen AG 在美国和其他国家注册的商标或商标。

Intuit 和 Quicken 是 Intuit Inc.或其子公司在美国和其他国家注册的商标和/或注册服务商标。

LSI Logic、AcceleRAID、eXtremeRAID、MegaRAID 和 Mylex 是 LSI Logic Corp.的商标或注册商标。

MATLAB 是 The MathWorks, Inc.的注册商标。

SpeedTouch 是 Thomson 的商标。

VMware 是 VMware, Inc.的商标。

Mathematica 是 Wolfram Research, Inc.的注册商标。

Ogg Vorbis 和 Xiph.Org 是 Xiph.Org 的商标。

XFree86 是 The XFree86 Project, Inc.的商标。

许多制造商和销售商用来区分其产品的名称被宣称为商标。在本文档中，如果 FreeBSD 项目知晓了这些商标声明，他们的名称旁将带有符号“™”或“®”。

本章介绍了 FreeBSD 操作系统的基础命令及功能。这些章节中的大部分内容对于所有类 UNIX® 操作系统来说都是适用的。建议 FreeBSD 新用户仔细阅读本章。

阅读本章后，你将会了解：

• 如何使用和配置虚拟控制台。

• 如何在 FreeBSD 上创建和管理用户和组。

• UNIX® 文件权限和 FreeBSD 文件标志的工作原理。

• FreeBSD 文件系统的默认布局。

• FreeBSD 磁盘结构。

• 如何挂载及卸载文件系统。

• 进程、守护程序和信号分别是什么。

• 什么是 Shell，如何修改默认登录环境。

• 如何使用基本的文本编辑器。

• 什么是设备和设备节点。

• 如何阅读手册页面以获取更多信息。

欢迎来到 FreeBSD！本手册涉及了 FreeBSD 14.3-RELEASE 和 13.5-RELEASE 的安装和日常使用。本书是许多人不懈努力的成果。有些部分可能已经过时。有志于帮助更新和增补此文档的人可以发送电子邮件至 FreeBSD 文档项目邮件列表。

可以从 FreeBSD 官网得到本书的最新版本。还可以从 https://docs.FreeBSD.org/doc/ 获取旧版本。本书可以从 FreeBSD 下载服务器和众多镜像站中下载（提供了多种文件格式和压缩方式）。可以通过手册和其他文档的搜索页面中进行搜索。

X Window 系统是 UNIX® 平台的传统图形架构，既支持最新技术，又兼顾对历代应用程序的支持。包括桌面组件在内的应用程序由 Xorg(1) 服务器承载。该系统具有网络感知能力，其各个组件可以跨网络协同工作。

你手中的这本书凝聚着全世界数百人的心血。无论是改正了错别字，还是撰写了完整的章节，一切贡献都是有用的。

有多家公司通过向作者支付全职工作的工资、支付出版费用等方式来支持本文档的编写。特别是 BSDi（后来被风河系统公司收购）曾赞助 FreeBSD 文档项目的成员全职改进本书，最后于 2000 年 3 月纸质版第一版出版（ISBN 1-57176-241-8）。随后，风河系统公司又支付了几位作者的稿酬，以改进排版打印等基础工具，并增补新章节。这项工作的最终成果是于 2001 年 11 月出版的纸质版第二版（ISBN 1-57176-303-1）。在 2003-2004 年期间，FreeBSD Mall, Inc 为几位撰稿人支付了稿酬来完善手册，为纸质版第三版做准备。纸质版第三版分成了两卷本。这两卷分别以书名《FreeBSD 手册第 3 版第 1 卷：用户指南》（The FreeBSD Handbook 3rd Edition Volume 1: User Guide，ISBN 1-57176-327-9）和《FreeBSD 手册第 3 版第 2 卷：管理员指南》（The FreeBSD Handbook 3rd Edition Volume 2: Administrators Guide，ISBN 1-57176-328-7）进行出版。

设备是一个主要用于描述系统中与硬件相关活动的术语，包括磁盘、打印机、显卡和键盘。当 FreeBSD 启动时，大多数启动消息都与设备的检测有关。启动消息的副本会保存到 /var/run/dmesg.boot 文件中。

每个设备都有一个设备名称和编号。例如，ada0 是第一个 SATA 硬盘，而 kbd0 表示键盘。

FreeBSD 中的大多数设备必须通过名为设备节点的特殊文件访问，这些文件位于 /dev 目录中。

多媒体章节概述了 FreeBSD 上的多媒体支持。多媒体应用程序和技术已经成为现代计算的不可或缺的一部分，而 FreeBSD 为各种多媒体硬件和软件提供了强大而可靠的支持。本章节涵盖了音频、视频和图像处理等多种多媒体组件。它还讨论了各种媒体格式和编解码器，以及用于多媒体创作和播放的工具和应用程序。此外，本章节还介绍了多媒体系统的配置、故障排除和优化。无论你是多媒体爱好者还是专业内容创作者，FreeBSD 都为多媒体工作提供了一个强大的平台。本章节旨在帮助充分发挥 FreeBSD 的多媒体功能，提供有用的信息和实际示例，帮助用户快速入门。

当前版本的在线手册凝聚着过去十年间许多贡献者的不懈努力。自 2004 年两卷本的第三版出版以来，以下是一些重要变化：

• 新增了 ，介绍了如何在 FreeBSD 上运行 Windows® 应用程序。

• 新增了 的有关信息，它是一款功能强大的性能分析工具。

• 新增了，介绍了 FreeBSD 中的非原生文件系统，如 Sun™ 的 ZFS。

大多数 FreeBSD 的配置都是通过编辑文本文件完成的，因此熟悉一个文本编辑器是一个好主意。FreeBSD 的基本系统中自带了一些文本编辑器，Ports 中还提供了更多。

一个适合入门的简单编辑器是 ，即 easy editor（简易编辑器）。要启动该编辑器，可以键入 ee filename，其中 filename 是要编辑的文件名。进入编辑器后，所有用于操作编辑器功能的命令都会列在显示器顶部。插入符号（^）代表 Ctrl，因此 ^e 就是 Ctrl+e。要退出 ，按下 Esc，然后从主菜单中选择“leave editor（退出编辑器）”选项。如果文件已被修改，编辑器会提示保存更改。

FreeBSD 的基本系统中还包括一些功能更强的文本编辑器，比如 。其他编辑器如 和 是 FreeBSD Ports 的一部分。这些编辑器提供了更强大的功能，但学习起来也更复杂。长期来看，学习如 vim 或 Emacs 这样的强大编辑器可以节省更多时间。

许多修改文件或需要输入内容的应用程序会自动打开一个文本编辑器。要更改默认编辑器，可以按照 中的说明设置 EDITOR

当前版本的手册凝聚了工作组的长久努力，工作组一直在审查和更新手册中的所有内容。以下是自第四版手册以来的主要更新。

• 手册已从 转换为 和 。

• 创建了 。

• 新增了 及有关在 FreeBSD 上安装和配置 Wayland 的信息。

无论软件是通过二进制包还是 Ports 安装，大多数第三方应用程序在安装后都需要进行一定程度的配置。以下命令和位置可以帮助确定应用程序安装了哪些内容。

• 大多数应用程序至少会在 /usr/local/etc 中安装一个默认的配置文件。如果应用程序有大量配置文件，则会创建一个子目录来存放这些文件。通常，示例配置文件会以 .sample 后缀结尾。应该查看并根据系统的需要编辑这些配置文件。要编辑示例文件，首先将其复制到没有 .sample 后缀的文件名。

• 提供文档的应用程序会将文档安装到 /usr/local/share/doc 目录中，许多应用程序还会安装手册页。应该在继续操作之前参考这些文档。

本节涉及基本的安装故障排除，例如常见问题。

请查看 页面上列出的硬件注意事项，确保硬件受支持。

注意

某些安装问题可以通过更新各种硬件组件的固件来避免或缓解——最明显的是主板。主板固件通常被称为 BIOS。大多数主板和计算机制造商都有一个用于升级和升级信息的网站。

制造商通常建议非必要不升级主板 BIOS，应仅在出现关键更新等情况下才考虑升级。升级过程 可能 出现问题，造成 BIOS 不完整，导致计算机无法正常工作。

如果系统在启动时探测硬件时卡住，或在安装过程中表现异常，ACPI 可能是罪魁祸首。在 i386 和 amd64 平台上，FreeBSD 在引导期间检测到系统 ACPI 服务时，会大量使用它来帮助系统配置。不幸的是，ACPI 驱动程序以及系统主板和 BIOS 固件中仍然存在一些错误。可通过在第三阶段引导加载程序中设置 hint hint.acpi.0.disabled 来禁用 ACPI：

每次系统启动时，这个设置都会被重置，因此需要将 hint.acpi.0.disabled="1" 添加到文件 /boot/loader.conf

在使用 bsdinstall 安装 FreeBSD 时，系统不会自动安装图形用户界面。本章将介绍如何选择、安装和配置 Wayland 合成器，以提供图形环境。

在阅读本章之前，你应当：

• 知道如何安装 。

• 知道如何识别和配置 。

阅读本章后，你将了解：

虽然 FreeBSD 由于其性能和稳定性而广受欢迎于服务器领域，但它同样非常适合作为日常使用的桌面系统。FreeBSD 的 Ports 中包含 36000 余款应用程序，因此构建一款能够运行多种桌面应用的定制化桌面环境变得十分简单。本章将演示如何安装常见的桌面环境，以及网页浏览器、办公软件、文档查看器和财务软件等桌面应用。

前提条件：

• 本章的读者应已了解如何在 FreeBSD 上安装 或 。

• 本章中将指导读者安装官方预编译软件包。如需了解如何通过 Ports 构建自定义软件包，请参考 一节。

FreeBSD 自带了丰富的系统工具作为基本系统的一部分。此外，FreeBSD 提供了两种互补技术用于安装第三方软件：FreeBSD Ports，用于从源代码安装；以及软件包，用于从预构建的二进制文件安装。可以使用任一方法从本地介质或网络安装软件。

阅读完本章后，你将会知道：

• 二进制软件包和 ports 之间的区别。

• 如何查找移植到 FreeBSD 的第三方软件。

• 如何使用 pkg 管理二进制包。

安装时间会因所选发行版、安装介质和计算机速度而异。一系列信息可指示进度。

首先，安装程序会格式化所选的磁盘并初始化分区。接下来，在使用 bootonly media/mini memstick 的情况下，它会下载所选组件：

图 31. 获取分发文件

接下来，会验证发行文件的完整性，确保它们在下载过程中没有损坏或在安装介质中读取错误：

图 32. 校验分发文件

最后，经过校验的分发文件会被解压到磁盘上：

图 33. 提取发行文件

主机名表示网络中主机的完全限定域名（FQDN）。

技巧

如果主机未设置主机名，FreeBSD 会将自己称为 “Amnesiac”。

7.5.1. 检查当前主机名

可以使用 来检查当前主机名：

输出应类似于以下内容：

感谢你对 FreeBSD 的关注！以下章节涉及了 FreeBSD 项目的各个方面，如历史、目标、发展模式等。

在阅读本章后，你将会收获：

• FreeBSD 与其他计算机操作系统的关系。

• FreeBSD 项目的历史。

• FreeBSD 项目的宗旨。

内核是 FreeBSD 操作系统的核心。它负责管理内存、执行安全控制、网络通信、磁盘访问等众多任务。虽然 FreeBSD 的大部分内容是动态可配置的，但一些用户可能希望配置并编译自定义内核。

阅读本章后，你将了解：

• 何时构建自定义内核。

• 如何进行硬件清单盘点。

• 如何自定义内核配置文件。

本章将深入探讨网络配置和性能，展示了 FreeBSD 操作系统强大的网络能力。无论是使用有线还是无线网络，本章都提供了在 FreeBSD 中配置和优化网络连接的全面指南。

在深入了解细节之前，读者最好对协议、网络接口和寻址等网络概念有一个基本的了解。

本章内容包括：

• 在 FreeBSD 中配置有线网络的能力，包括网络接口设置、寻址和自定义选项。

• 在 FreeBSD 中配置无线网络的技能，包括无线网络接口设置、安全协议和故障排除技术。

• FreeBSD 的网络功能及其出色网络性能的声誉。

现在基础知识已经讲解完毕。本书的这一部分讨论了 FreeBSD 的一些常用功能。这些章节包括：

• 介绍受欢迎和有用的桌面应用程序：浏览器、办公工具、文档查看器等。

• 介绍用于 FreeBSD 的多媒体工具。

• 解释构建自定义 FreeBSD 内核的过程，以实现额外的功能。

FreeBSD 新手会发现本书的第一部分旨在引导你掌握 FreeBSD 安装过程，并逐步介绍了支撑起 UNIX® 的概念和约定。阅读此部分只需要你有探索的好奇心和接受新概念的意愿。

走完这一步路后，手册中的第二部分是全方位覆盖的主题参考，包含了 FreeBSD 系统管理员所有可能感兴趣的内容。其中某些章节可能建议你在阅读前进行预习，这在每章开头的概述中有所注明。

如需更进一步的内容，请参阅。

使用 bsdinstall 安装的 FreeBSD 系统不会自动安装图形用户界面。本章介绍如何安装和配置 Xorg(1) 服务器，该服务器提供开源 X Window 系统（俗称 X11），用于提供图形化环境。

在阅读本章节之前，你应该：

• 了解如何按照 安装应用程序：软件包和 Ports 的说明安装额外的第三方软件。

阅读本章节后，你将了解：

• 如何为图形处理器（GPU）选择和安装驱动程序。

• X Window 系统的各个组件及其协作方式。

• 如何安装和配置 X.org 服务器。

• 如何为 X Window 系统安装字体。

一款有用的 Wayland 工具是 waybar，所有合成器都可以使用它。虽然 Wayfire 自带了启动菜单，但易于使用且快速的任务栏是所有合成器或桌面管理器的好配件。waybar 是一款与 Wayland 兼容的任务栏，快速且易于配置。要安装这个软件包以及一款支持的音频控制工具，可以执行以下命令：

# pkg install pavucontrol waybar

要创建配置目录并复制默认的配置文件，可以执行以下命令：

% mkdir ~/.config/waybar
% cp /usr/local/etc/xdg/waybar/config ~/.config/waybar

lavalauncher 工具提供了一个启动条，用于启动各种应用程序。该软件包没有提供示例配置文件，因此需要执行以下操作：

mkdir ~/.config/lavalauncher

以下是一个示例配置文件，它仅包含 Firefox，并将其放置在右侧：

global-settings {
	watch-config-file = true;
}

bar {
	output            = eDP-1;
	position          = bottom;
	background-colour = "#202020";

	# 默认配置集的条件。
	condition-resolution = wider-than-high;

	config {
		position = right;
	}

	button {
		image-path          =     /usr/local/lib/firefox/browser/chrome/icons/default/default48.png;
		command[mouse-left] =     /usr/local/bin/firefox;
	}
	button {
	  image-path           =   /usr/local/share/pixmaps/thunderbird.png;
	  command[mouse-left]  =   /usr/local/bin/thunderbird;
}

虽然有多种登录管理器，并且它们正在慢慢迁移到 Wayland 上，其中一个选择是 x11/ly 文本用户界面（TUI）管理器。ly 的配置最简单，能够通过在系统初始化时展示登录窗口来启动 Sway、Wayfire 等。要安装 ly，可以执行以下命令：

# pkg install ly

系统会提供一些配置提示，导入步骤是将以下内容添加到 /etc/gettytab 文件中：

Ly:\
  :lo=/usr/local/bin/ly:\
  :al=root:

然后修改 /etc/ttys 文件中的 ttyv1 行，修改为以下内容：

ttyv1 "/usr/libexec/getty Ly" xterm onifexists secure

重启系统后，登录界面应该会出现。要配置特定的设置，如语言，可以编辑 /usr/local/etc/ly/config.ini 文件。至少，这个文件中应该指定之前在 /etc/ttys 文件中设置的 tty。

注意

如果将 ttyv0 设置为登录终端，可能需要按下 alt 和 F1 键，才能正确看到登录窗口。

当登录窗口出现时，使用左右箭头键可以切换不同的支持的窗口管理器。

第三版是 FreeBSD 文档项目专员连续两年工作的成果。纸质版变得非常厚重，所以必须分成两卷本来出版。以下是新版本的主要变化：

• 配置和调优已增补，提供了有关 ACPI 电源和资源管理、系统实用程序 cron 以及更多内核调优参数的新内容。

• 安全已增补，提供有关虚拟专用网络（VPN）、文件系统访问控制列表（ACL）和安全通告的新内容。

• 此版新增了章节。它解释了什么是 MAC 以及如何使用该机制来保护 FreeBSD 系统。

• 已增补，包括有关 USB 存储设备、文件系统快照、文件系统配额、文件和网络支持的文件系统以及加密磁盘分区的新内容。

• 中新增了故障排除部分。

• 已增补，包括了有关使用替代传输代理、SMTP 身份验证、UUCP、fetchmail、procmail 以及其他高级主题的新内容。

• 此版新增了这一章。本章包含了有关设置 Apache HTTP 服务器、ftpd 以及为 Microsoft® Windows® 客户端设置服务器的方法。有些来自部分的内容被移至此处，以改进章节排布。

• 部分已增补，新增了有关在 FreeBSD 上使用蓝牙®设备、设置无线网络以及异步传输模式（ATM）网络的教程。

• 书中增加了一个词汇表，为全书所用技术术语的定义提供了一个集中的位置。

• 对全书的表格和图表进行了诸多美化。

为了提供一致且易于阅读的内容，全书遵循了一些惯例。

排版惯例

斜体

斜体 字体用于文件名、网址、重点内容强调以及当技术术语首次出现。

等宽

monospaced 字体用于错误信息、命令、环境变量、Port、主机名、用户名、组名、设备名、变量和代码片段。

加粗

应用程序、命令和按键均使用 粗体 字体。

用户输入

按键以粗体 显示， 以便与其他文本区分开来。需要同时输入的按键组合以 + 按键之间显示，例如：

Ctrl+Alt+Del

这意味着用户应该同时按下 Ctrl、Alt 和 Del 键。

需要按顺序输入的键将用逗号分隔，例如：

Ctrl+X、Ctrl+S

这意味着用户需要同时按下 Ctrl 和 X 键，然后再同时按下 Ctrl 和 S 键。

示例

以 C:> 开头的示例表示 MS-DOS® 命令。除非另有说明，否则这些命令一般可以在现代微软® Windows® 环境上的“命令提示符”窗口中执行。

以 # 开头的示例表示该命令必须用 FreeBSD 中的超级用户身份调用。你可以以普通用户身份登录并以 root 键入命令，或以普通用户身份登录并使用 获得超级用户权限。

以 % 开头的示例表示应使用普通用户账户调用的命令。除非另有说明，否则一律使用 C-shell 语法来设置环境变量和其他 shell 命令。

FreeBSD port 是一组旨在自动化从源代码编译应用程序的过程的文件。这些组成 Ports 的文件包含所有必要的信息，能够自动下载、解压、打补丁、编译和安装应用程序。

如果软件尚未适配并经过 FreeBSD 测试，可能需要编辑源代码，以便其能够正确安装和运行。

然而，已有 36000 余款第三方应用程序被移植到了 FreeBSD。当可行时，这些应用程序会作为预编译的 包 提供下载。

可以使用 FreeBSD 包管理命令来操作包。

包和 Ports 都能处理依赖关系。如果使用包或 Ports 安装应用程序，而所依赖的库尚未安装，库将自动先行安装。

FreeBSD 包包含应用程序的所有命令的预编译副本，以及任何配置文件和文档。可以使用 pkg(8) 命令（例如 pkg install）来操作包。

尽管这两种技术相似，包和 Ports 各自有其优势。选择符合你需求的技术来安装特定应用程序。

包的优点

• 压缩的包 tarball 通常比包含应用程序源代码的压缩包小。

• 包不需要编译时间。对于大型应用程序，如 Firefox、KDE Plasma 或 GNOME，这在系统较慢时尤为重要。

• 包不需要理解在 FreeBSD 上编译软件的过程。

Ports 的优点

• 包通常使用保守选项进行编译，因为它们必须在最大数量的系统上运行。通过从 Ports 编译，可以更改编译选项。

• 一些应用程序有与安装特性相关的编译时选项。例如，NGINX® 可以通过各种内建选项进行配置。 在某些情况下，同一个应用程序可能会有多个包，配置不同的选项。例如，NGINX® 有 nginx 包和 nginx-lite 包，前者启用了更多的选项，但这也需要安装更多的依赖项，因此会增加空间消耗和攻击面。

  传递依赖项可能会变得相当庞大，例如完整的 nginx 包会拉入多个 X 库，这可能让人感到惊讶，因此从 Ports 编译可以让你选择仅需要的选项，而不使用“万金油”方法。在某些情况下，可能会为同一应用程序提供多个包，以指定特定设置。

• 某些软件的许可条款禁止二进制分发。这类软件必须以源代码形式分发，且必须由最终用户编译。

要跟踪更新的 Port，可以订阅 和 。

警告

在安装应用程序之前，请检查 以了解相关的安全问题。

要审核已安装的包以检查已知漏洞，请运行 pkg audit -F。

本章其余部分将解释如何使用包和 Ports 在 FreeBSD 上安装和管理第三方软件。

FreeBSD 可用应用程序的列表一直在不断增长。有多种方式可以找到要安装的软件：

• FreeBSD 网站维护着一个最新的可搜索应用程序列表，地址为 Ports Portal。可以按应用程序名称或软件类别搜索 Port。

• Dan Langille 维护着 FreshPorts，提供了一个全面的搜索工具，还跟踪 Ports 中的应用程序变化。注册用户可以创建一个自定义的关注列表，以便在关注的 Port 更新时收到自动邮件。

• 如果寻找特定应用程序变得困难，可以尝试在 SourceForge 和 GitHub 等网站上搜索，然后返回 Ports Portal 查看该应用程序是否已被移植。

• 使用 命令在二进制包仓库中搜索应用程序。

当某个 Port 无法构建或安装时，可以尝试以下方法：

1. 在 问题报告数据库 中搜索该 Port 是否有待解决的修复。如果有，实施提议的修复可能会解决该问题。

2. 向 Port 的维护者寻求帮助。在 Port 目录中输入 make maintainer，或阅读 Port 的 Makefile 以查找维护者的电子邮件地址。记得在发给维护者的电子邮件中包含导致错误的输出信息。

   注意

   有些 Port 不是由个人维护，而是由一个由 代表的群体维护。许多（但不是所有）此类地址看起来像 。发送邮件时请注意这一点。

   特别是，维护 的 Port 并非由特定个人维护。因为所有的修复和支持来自订阅该邮件列表的一般社区。总是需要更多的志愿者！

   如果没有收到邮件回复，请按照 中的说明使用 Bugzilla 提交 bug 报告。

3. 修复它！ 包含有关 Port 基础设施的详细信息，你可以用它来修复偶尔出现的问题 Port ，甚至提交你自己的修复！

4. 使用 中的说明，安装包而不是 Port。

待保存了自定义配置文件的编辑内容，就可以按照以下步骤编译内核源代码：

过程：构建内核

1. 切换到此目录：

   复制

   # cd /usr/src

2. 通过指定自定义内核配置文件的名称来编译新内核：

   复制

   # make buildkernel KERNCONF=MYKERNEL

3. 安装与指定内核配置文件关联的新内核。此命令将新内核复制到 /boot/kernel/kernel 并将旧内核保存到 /boot/kernel.old/kernel：

   复制

   # make installkernel KERNCONF=MYKERNEL

4. 关闭系统并重启进入新内核。如果出现问题，请参考 。

默认情况下，当编译自定义内核时，所有内核模块都会重新编译。要更快地更新内核或仅构建自定义模块，可以在开始构建内核之前编辑 /etc/make.conf。

例如，以下变量指定要构建的模块列表，而不是默认构建所有模块：

或者，此变量列出要从构建过程中排除的模块：

还可以使用其他变量。有关详细信息，请参阅 。

第二版是 FreeBSD 文档项目专员两年多努力的结晶。本版的主要变化如下：

• 添加了完整索引。

• 所有 ASCII 图均被图形化的图表取代。

• 每章都增加了独立的概述小节，以在短时间内获得该章所涉及的内容，以及读者应了解的内容。

在提高生产力方面，用户通常会寻找一款办公套件或易于使用的文字处理软件。虽然一些桌面环境，如 ，提供了办公套件，但并没有默认的生产力软件包。无论安装了哪种桌面环境，FreeBSD 上都有多个办公套件和图形化文字处理软件可供选择。

本节介绍了如何安装以下流行的生产力软件，并指出这些应用是否资源占用较高、从 Port 编译时是否需要较长时间，或是否有任何重大依赖。

表 4. 支持的桌面办公生产力套件

传统上，FreeBSD 使用的是宏内核。该内核是一款大型程序，支持固定的设备列表，并且要改变内核的行为，必须编译并重新启动到新内核中。

如今，FreeBSD 内核中的大部分功能都包含在可以根据需要动态加载和卸载的模块中。这使得运行中的内核能够立即适应新硬件，并将新的功能引入内核。这种内核被称为模块化内核。

有时，仍然需要进行静态内核配置。某些功能与内核紧密绑定，无法动态加载。一些安全环境会阻止加载和卸载内核模块，要求只能将所需功能静态编译到内核中。

构建定制内核通常是高级 BSD 用户的必由之路。这个过程虽然耗时，但能为 FreeBSD 系统带来很多好处。与必须支持广泛硬件的 GENERIC 内核不同，定制内核可以精简，只提供对该计算机硬件的支持。这有以下几个好处：

• 更快的启动时间。由于内核只会探测系统中的硬件，系统启动所需的时间可能会减少。

• 更低的内存使用。定制内核通常通过省略不使用的功能和设备驱动程序来减少内存占用。这一点非常重要，因为内核代码始终驻留在物理内存中，防止该内存被应用程序占用。因此，定制内核对于内存较小的系统非常有用。

设置有线或无线连接是 FreeBSD 用户的常见任务。本节将介绍如何识别有线和无线网络适配器以及如何配置它们。

在开始配置之前，必须了解以下网络数据：

• 网络是否启用了 DHCP

• 如果网络没有 DHCP，使用的静态 IP

• 子网掩码

摘要：必须安装 服务器以承载 。必须把用户添加到 video 组才能使用它。

待显卡驱动安装并启用后，可以作为元包安装 X.org 服务器，也可以通过 Ports 树在本地编译。

完整元包安装速度快，但可自定义选项较少：

此安装将完整的 X Window 系统安装到系统中，包括传统窗口管理器 以及传统桌面套件。大多数用户会希望安装并配置自己选择的现代 。

当前用户必须是 video 组的成员才能运行图形环境。要将用户添加到 video 组，请执行以下命令：

要运行 X Window 系统，可使用来自 的 ，或安装并配置显示管理器，在启动时进行图形登录。

在排查硬件和软件配置问题时，应首先检查最基础的内容：

• 网线是否插好？

• 网络服务是否配置正确？

• 防火墙是否配置正确？

Hikari 合成器采用多个围绕生产力的概念，如工作区、工作表等。因此，它与平铺窗口管理器相似。具体来说，合成器从一个工作区开始，这类似于虚拟桌面。Hikari 使用单个工作区或虚拟桌面进行用户交互。工作区由多个视图组成，视图是合成器中以工作表或组的形式分组的工作窗口。工作表和组都由一组视图组成，也就是那些分组在一起的窗口。在切换工作表或组时，活动的工作表或组将被集体称为工作区。手册页将详细介绍每个功能的具体内容，但在本文中，我们将假设使用单个工作区和单个工作表。Hikari 安装由一个软件包组成：，以及终端仿真器 alacritty：

注意

其他终端，如 kitty 或 Plasma Terminal，也能在 Wayland 下正常工作。用户可以尝试他们喜欢的终端编辑器来验证兼容性。

Hikari 使用配置文件 hikari.conf，该文件可以放置在 XDG_RUNTIME_DIR 中，或者通过 -c 参数在启动时指定。不需要自动启动配置文件，但可以使迁移到这个合成器的过程更轻松。配置开始时，创建 Hikari 配置目录并复制配置文件进行编辑：

配置文件分为不同的部分，例如 ui、outputs、layouts 等。对于大多数用户来说，默认设置已足够；然而，应该做一些重要的更改。例如，$TERMINAL 变量通常不会在用户的环境中设置。可以修改该变量或将 hikari.conf 文件中的设置更改为：

为了创建一个自定义内核配置文件并构建自定义内核，必须首先安装完整的 FreeBSD 源代码树。

如果 /usr/src/ 目录不存在或为空，则说明源代码未安装。可以按照 中的说明通过 Git 安装源代码。

安装完源代码后，请查看 /usr/src/sys 目录的内容。该目录包含多个子目录，其中包括表示以下受支持架构的目录：amd64、i386、powerpc 和 sparc64。每个特定架构的目录只处理该架构的相关内容，其他代码则是所有平台通用的机器无关代码。每个受支持架构都有一个 conf 子目录，其中包含该架构的 GENERIC 内核配置文件。

不要直接编辑 GENERIC 文件。相反，应将文件复制并编辑复制的文件。命名约定是使用全大写字母的名称。在管理多台具有不同硬件的 FreeBSD 机器时，建议将其命名为机器的主机名。以下示例为 amd64 架构的 GENERIC 配置文件创建名为 MYKERNEL 的副本：

现在可以使用任何 ASCII 文本编辑器自定义 MYKERNEL。默认编辑器是 vi，但 FreeBSD 还安装了一个更适合初学者的编辑器，名为 ee。

内核配置文件的格式很简单。每行包含一个代表设备或子系统的关键字、一个参数和一个简短的描述。任何在 #

之前文中提到，Wayland 不提供与 Xorg 相同的 X 服务器访问方式。但用户可以选择远程桌面协议，如 RDP 或 VNC。FreeBSD Ports 有 wayvnc，它支持基于 wlroots 的合成器，如本文中讨论的那些。可以使用以下命令安装该应用：

与其他一些包不同，wayvnc 没有配置文件。幸运的是，手册页文档中列出了重要的选项，这些选项可以提取成一个简单的配置文件：

需要生成密钥文件，并强烈建议使用它们来增强连接的安全性。启动 wayvnc 时，它会在 ~/.config/wayvnc/config 中查找配置文件。也可以在启动服务器时使用 -C configuration_file 选项覆盖该配置文件。因此，要启动 wayvnc 服务器，可以执行以下命令：

警告

在本文写作时，没有 rc.d 脚本来在系统初始化时启动 wayvnc

FreeBSD 支持多种架构，包括 amd64、ARM®、RISC-V® 和 PowerPC®。根据架构和平台，可以不同镜像来安装或者直接运行 FreeBSD。

镜像类型包括：

• 虚拟机磁盘镜像，如 qcow2、vmdk、vhd 和裸设备镜像。这些不是安装镜像，而是已预安装 FreeBSD 的镜像，可准备执行安装后的任务。虚拟机镜像在云环境中也很常用。

• SD 卡镜像，适用于嵌入式设备，如树莓派。必须解压缩这些文件，以裸镜像写入 SD 卡，卡板将从中启动。

如果没有配置 FreeBSD 在启动时自动进入图形环境，那么系统将启动到命令行登录提示界面，如下所示：

第一行包含了一些系统信息。amd64 表示 FreeBSD 正运行在 64 位 x86 设备上。主机名是 pc3.example.org，而 ttyv0 表示这是“系统控制台”。第二行是登录提示符。

由于 FreeBSD 是款多用户系统，因此它需要一种方法来区分不同的用户。这是通过要求每个用户在访问系统上的程序之前先行登录来实现的。每位用户都有一个唯一的“用户名”及其对应的个人“密码”。

要登录系统控制台，请输入安装系统时配置的用户名（详见 添加用户）并按下 Enter 键。然后输入与该用户名关联的密码并再次按下 Enter。出于安全原因，输入的密码不会回显。

若输入了正确的密码，将会显示“今日信息”（MOTD），随后出现命令提示符。根据用户创建时选择的 shell，此提示符可能是 #、$ 或 % 字符。这个提示符表明用户已登录到 FreeBSD 系统控制台，并可开始尝试使用可用命令。

3.2.1. 虚拟控制台

虽然可以用系统控制台来与系统交互，但在 FreeBSD 系统的键盘上进行命令行操作的用户通常会登录到虚拟控制台。这是因为系统消息默认会输出到系统控制台上。这些信息会覆盖用户正在处理的命令和文件，从而妨碍工作。

FreeBSD 默认配置了多个虚拟控制台供用户输入命令。每个虚拟控制台都有自己的登录提示和 shell，用户可以方便地在它们之间切换。这实质上提供了图形环境中多窗口操作的命令行等价体验。

FreeBSD 保留了快捷键 Alt+F1 到 Alt+F8 用于切换虚拟控制台。使用 Alt+F1 可切换到系统控制台（ttyv0），Alt+F2 可访问第一个虚拟控制台（ttyv1），Alt+F3 可访问第二个虚拟控制台（ttyv2），依此类推。当使用 Xorg 作为图形控制台时，快捷键变为 Ctrl+Alt+F1 返回文本模式虚拟控制台。

在控制台之间切换时，FreeBSD 会管理屏幕输出。这样产生了一种拥有多个虚拟屏幕和键盘的错觉，每个都可以用于输入 FreeBSD 要执行的命令。在一个虚拟控制台中启动的程序在切换到其他控制台时 不会 停止运行。

更详细的 FreeBSD 控制台与键盘驱动说明，可参考 、、、 和 。

在 FreeBSD 中，可用虚拟控制台的数量配置在 /etc/ttys 文件的以下部分：

要禁用某个虚拟控制台，在对应那一行的开头加上注释符号（#）。例如，要将虚拟控制台数量从八个减少到四个，可以在 ttyv5 到 ttyv8 这四行前添加 #。不要注释掉系统控制台 ttyv0 的那一行。注意最后一个虚拟控制台（ttyv8）用于在已安装并配置 Xorg 时访问图形环境，详见 。

关于该文件中每一列的详细说明以及虚拟控制台的可用选项，参见 。

3.2.2. 单用户模式

FreeBSD 启动菜单提供了选项 “Boot Single User” 。如果选择此项，系统将启动到一种特殊模式，称为“单用户模式”。该模式通常用于修复无法启动的系统，或者在不知道 root 密码时重置该密码。在单用户模式下，网络功能和其他虚拟控制台不可用。但可以获得系统的完整 root 权限，并且默认不需要输入 root 密码。出于这些原因，启动到该模式需要对键盘有物理访问权限，因此在保护 FreeBSD 系统时，应考虑谁可以访问键盘这一问题。

控制单用户模式的设置位于 /etc/ttys 文件的以下部分：

在默认情况下，状态设为 secure。这意味着默认假设对键盘的物理访问要么不重要，要么由实体安全策略加以控制。如果将该设置改为 insecure，则说明当前环境是不安全的，因为任何人都可以访问键盘。当将这一行改为 insecure 时，FreeBSD 会在用户选择启动单用户模式时提示输入 root 密码。

注意

更改此设置为 insecure 时请小心！ 如果忘记了 root 密码，虽然仍可启动到单用户模式，但对不熟悉 FreeBSD 启动流程的人来说可能会很困难。

3.2.3. 更改控制台显示模式

FreeBSD 控制台的默认显示模式可以调整为 1024x768、1280x1024 或任何显卡和显示器支持的分辨率。要使用不同的显示模式，需加载 VESA 模块：

要查看硬件支持哪些显示模式，请使用 。运行以下命令可获取支持的显示模式列表：

此命令的输出列出了硬件支持的显示模式。要选择新的显示模式，使用 root 用户身份通过 指定模式：

如果新的显示模式符合要求，可以通过在 /etc/rc.conf 中添加以下行，使其在启动时自动生效：

FreeBSD 上最全面的文档形式是手册页。几乎系统上的每个程序都有一份简短的参考手册，解释基本操作和可用参数。这些手册可以通过 man 命令查看：

其中 command 是要了解的命令名称。例如，要了解更多关于 ls(1) 的信息，可以输入：

手册页分为不同的章节，每个章节代表不同的主题类型。在 FreeBSD 中，以下是可用的章节：

1. 用户命令。

2. 系统调用和错误号码。

3. C 库中的函数。

4. 设备驱动程序。

5. 文件格式。

6. 游戏和其他娱乐。

7. 杂项信息。

8. 系统维护和操作命令。

9. 系统内核接口。

在某些情况下，同一主题可能出现在多个章节中。例如，chmod 用户命令和 chmod() 系统调用都存在。要告诉 显示哪个章节，可以指定章节编号：

这将显示用户命令 的手册页。手册页的各章节通常在书面文档中用括号标出，因此 指的是用户命令，而 指的是系统调用。

如果不知道手册页的名称，可以使用 man -k 命令搜索手册页描述中的关键词：

此命令将显示描述中包含“mail”关键词的命令列表。这等同于使用 。

要查看 /usr/sbin 目录中所有命令的描述，可以输入：

或者

3.12.1. GNU Info 文件

FreeBSD 包含了由自由软件基金会（FSF）制作的几个应用程序和工具。除了手册页，这些程序还可能包括名为 info 文件的超文本文档。这些文件可以通过 或者在安装了 的情况下，通过 emacs 的 info 模式查看。

使用 时，输入：

要查看简短的介绍，输入 h。要快速查看命令参考，输入 ?。

FreeBSD 的目录层级结构是理解整个系统的基础。根目录（“/”）是最重要的目录，它在启动时最先挂载，包含了操作系统的基础部分，为多用户操作做准备。根目录还包含了其他文件系统的挂载点，这些文件系统在进入多用户模式时被挂载。

挂载点是将额外文件系统附加到父文件系统（通常是根文件系统）上的目录。常见的挂载点包括 /usr/、/var/、/tmp/、/mnt/ 和 /cdrom/。这些目录在 /etc/fstab 文件中有条目。大多数文件系统会在启动时通过 rc(8) 脚本自动挂载，除非它们的条目包含 noauto。

文件系统层级的完整说明见 hier(7)。以下是常见目录的简要概述：

poudriere 是一个采用 BSD 许可证的实用工具，用于创建和测试 FreeBSD 软件包。它通过 FreeBSD jail 创建隔离的编译环境。这些 jail 可用于为与当前系统版本不同的 FreeBSD 构建软件包，也可以在 amd64 主机上为 i386 构建软件包。构建完成后，生成的软件包布局与 FreeBSD 官方镜像相同，能被 pkg(8) 及其他包管理工具使用。

poudriere 可通过 ports-mgmt/poudriere 软件包或 port 安装。安装后会附带一个示例配置文件 /usr/local/etc/poudriere.conf.sample，可将其复制为 /usr/local/etc/poudriere.conf 并根据本地系统进行编辑。

虽然运行 poudriere 的系统不要求使用 ZFS，但使用 ZFS 有助于提升性能。启用 ZFS 时，需要在 /usr/local/etc/poudriere.conf 中设置 ZPOOL，并将 FREEBSD_HOST 设为附近的镜像站。定义 CCACHE_DIR 可启用 ，对重复编译的代码进行缓存，加快构建速度。建议将 poudriere 的数据集挂载到一个独立的目录（如 /poudriere）。大多数默认配置项通常已经足够。

系统会根据可用处理器核心数决定并行构建的数量。请确保系统具有足够的虚拟内存（RAM 或交换空间），否则 jail 会在构建时中止并被销毁，可能导致莫名其妙的错误信息。

4.6.1. 初始化 Jail 和 Ports 树

完成配置后，需要初始化 poudriere，使其安装所需的 FreeBSD jail 和 Ports 树。使用 -j 指定 jail 名称，-v 指定 FreeBSD 版本。在 FreeBSD/amd64 系统上，也可使用 -a 指定架构（i386 或 amd64），默认使用 uname 输出的架构：

然后拉取并初始化一个 ports 树：

poudriere 支持在单机上构建多个配置的 ports，分别使用不同的 jail、ports 树和配置集合（sets）。关于 set 的详细内容，请参阅 中的 CUSTOMIZATION 部分。

以下是基本配置示例：为每一个 jail/ports/set 组合提供一个专用的 make.conf 文件，命名规则为 <jail>-<ports>-<set>-make.conf。该文件与系统的 make.conf 合并后，将用于构建。

要构建的软件包列表写入 13amd64-local-workstation-pkglist 文件（带有 的 ports 使用 @FLAVOR 指定）：

配置这些 port 的选项与依赖：

开始构建并生成软件包仓库：

构建过程中按下 Ctrl+t 可查看当前构建状态。构建日志会保存于 /poudriere/logs/bulk/jailname，可通过 Web 服务器查看构建详情。

构建完成后，新生成的软件包可通过 poudriere 提供的软件仓库进行安装。

如需了解更多内容，请参阅 和 poudriere 官方页面 。

4.6.2. 配置 pkg 客户端使用 poudriere 仓库

虽然可以同时使用自定义软件包仓库与官方仓库，但有时更希望禁用官方仓库。这可以通过创建一个覆盖官方配置的文件来实现。创建 /usr/local/etc/pkg/repos/FreeBSD.conf，内容如下：

通常最方便的做法是通过 HTTP 将 poudriere 软件包仓库提供给客户端访问。可以通过 Web 服务器提供仓库目录，例如 /usr/local/poudriere/data/packages/13amd64，其中 13amd64 是构建名。

假设软件包仓库的 URL 是 ，那么应在 /usr/local/etc/pkg/repos/custom.conf 中创建如下配置文件：

如果不希望将软件包仓库暴露在互联网中，可以使用 file:// 协议直接指向本地路径，例如：

DNS 可以理解为一本电话簿，其中将 IP 地址与主机名相互关联。

有三个文件负责管理 FreeBSD 系统如何与 DNS 进行交互。这三个文件是 hosts(5)、resolv.conf(5) 和 nsswitch.conf(5)。

除非在 /etc/nsswitch.conf 文件中另有说明，FreeBSD 将首先查看 /etc/hosts 文件中的地址，然后查看 /etc/resolv.conf 文件中的 DNS 信息。

注意

nsswitch.conf(5) 文件指定了 nsdispatch（名称服务切换调度器）应如何运行。

在默认情况下，/etc/nsswitch.conf 文件中的 hosts 部分如下所示：

例如，在使用 服务时，可以通过将该行更改为如下所示，来更改优先级顺序：

7.6.1. 本地地址

/etc/hosts 文件是一个简单的文本数据库，用于提供主机名到 IP 地址的映射。可以将通过局域网连接的本地计算机的条目添加到此文件中，以便简化命名，而无需设置 DNS 服务器。此外，/etc/hosts 还可以用于提供互联网名称的本地记录，从而减少查询外部 DNS 服务器的需求，特别是对于常访问的名称。

例如，如果在本地环境中有一个 的本地实例，可以将其添加到 /etc/hosts 文件中，如下所示：

7.6.2. 配置 Nameserver

FreeBSD 系统如何访问互联网域名系统（DNS）由 控制。

/etc/resolv.conf 中最常见的条目有：

典型的 /etc/resolv.conf 文件如下所示：

注意

选项 search 和 domain 只能使用其中一个。

使用 DHCP 时， 通常会根据从 DHCP 服务器接收到的信息重写 /etc/resolv.conf。

注意

如果当前正在配置的这台机器 不是 DNS 服务器，可以使用 来提升 DNS 查询性能。

要在系统启动时启用它，请执行以下命令：

要启动 服务，请执行以下命令：

本节介绍了如何在 FreeBSD 系统上安装和配置一些流行的开发工具。

表 3. 支持的开发工具

8.4.1. Visual Studio Code

Visual Studio Code 是一种工具，它将代码编辑器的简便性与开发人员在核心编辑、构建和调试周期中所需的功能相结合。它提供了全面的编辑和调试支持、可扩展性模型以及与现有工具的轻量集成。

安装 Visual Studio Code，执行：

8.4.2. Qt Creator

Qt Creator 是一个跨平台的集成开发环境（IDE），专为 Qt 开发人员的需求量身定制。Qt Creator 包含的功能有：

• 支持 C++、QML 和 ECMAscript 的代码编辑器；

• 快速的代码导航工具；

• 输入时进行静态代码检查和样式提示；

• 上下文敏感帮助；

安装 Qt Creator，执行：

8.4.3. Kdevelop

Kdevelop 是一个开源的功能丰富、可扩展插件的 IDE，支持 C/C++ 和其他编程语言。它基于 KDevPlatform 和 KDE 与 Qt 库，自 1998 年以来一直在开发。

安装 Kdevelop，执行：

8.4.4. Eclipse IDE

Eclipse 平台是一个开放的、可扩展的 IDE，适用于各种用途。Eclipse 平台提供了构建和运行集成软件开发工具的基础模块和平台。Eclipse 平台允许工具开发者独立开发与他人工具集成的工具。

安装 Eclipse IDE，执行：

8.4.5. Vim

Vim 是一个高度可配置的文本编辑器，旨在实现高效的文本编辑。它是 vi 编辑器的改进版本，分发在大多数 UNIX 系统中。

Vim 常被称为“程序员的编辑器”，它在编程中非常有用，以至于许多人认为它是一个完整的 IDE。然而，它不仅仅适用于程序员，Vim 也非常适合各种文本编辑，从编写电子邮件到编辑配置文件。

安装 Vim，执行：

Wayfire 是款旨在轻量化和可定制的合成器。它提供了多种功能，并恢复了之前发布的 Compiz Fusion 桌面的一些元素，在现代硬件上看起来非常美观。要启动 Wayfire，首先需要安装必要的软件包：

# pkg install wayfire wf-shell alacritty swaylock-effects swayidle wlogout kanshi mako wlsunset

alacritty 包提供了一个终端仿真器，但并不是完全必需的，因为其他终端仿真器，如 kitty 和 XFCE-4 Terminal，在 Wayfire 合成器下也已经过测试并确认可以正常运行。Wayfire 配置相对简单，它使用一个文件，用户可以查看该文件并进行自定义。首先，将示例文件复制到运行时环境配置目录，然后编辑该文件：

对于大多数用户来说，默认配置应该已经足够。在配置文件中，像著名的 cube 之类的项目已被预配置，并且有说明帮助用户理解可用的设置。几个值得注意的基本设置如下：

在这个示例中，配置文件中的输出屏幕应该是列出的模式和赫兹。例如，模式应该设置为 widthxheight@refresh_rate。position 将输出放置在指定的像素位置，默认设置对于大多数用户应该没问题。transform 设置背景变换，scale 将输出缩放到指定的缩放因子。这些选项的默认设置通常是可以接受的；更多信息可以参见文档。

如前所述，Wayland 是新的协议，并非所有应用程序都已经更新为完全兼容此协议。目前，sddm 似乎不支持在 Wayland 中启动和管理合成器。在这些示例中，使用了 swaylock 实用程序。配置文件包含选项，用于运行 swayidle 和 swaylock 来管理空闲和屏幕锁定。

定义系统空闲时应采取的操作的选项如下：

锁定超时通过以下几行进行配置：

第一个选项将在 300 秒后锁定屏幕，再过 300 秒后，通过 dpms_timeout 选项将屏幕关闭。

最后需要注意的是 <super> 键。大多数配置都提到了这个键，它是键盘上的传统 Windows 键。大多数键盘上都有这个超级键；如果没有，可以在配置文件中重新映射。例如，要锁定屏幕，按住 super 键和 shift 键，再按 escape 键。除非映射发生了变化，否则这将启动 swaylock 应用程序。swaylock 的默认配置将显示一个灰色的屏幕，但该应用程序非常可定制并且文档齐全。此外，由于安装了 swaylock-effects 版本，还可以使用例如模糊效果等多种选项，如下所示：

此外，还有 --clock 参数，用于在锁屏时显示时钟和日期。当安装了 时，默认的 pam.d 配置已包括在内。它提供了默认的选项，适合大多数用户使用。更高级的选项可通过 PAM 文档获得更多信息。

此时，是时候测试 Wayfire 并检查它是否能在系统上启动了。只需输入以下命令：

合成器现在应该启动，并在屏幕上显示背景图像以及顶部的菜单栏。Wayfire 会尝试列出安装的兼容应用程序并呈现在下拉菜单中。例如，如果安装了 XFCE-4 文件管理器，它将在下拉菜单中显示出来。如果某个特定应用程序兼容且足够重要，它可以通过 wayfire.ini 配置文件映射到一个键盘快捷键。Wayfire 还提供了一个名为 Wayfire Config Manager 的配置工具，可以通过下拉菜单启动，也可以通过终端输入以下命令启动：

通过此应用程序，可以启用、禁用或配置各种 Wayfire 配置选项，包括合成特殊效果。此外，为了提供更友好的用户体验，可以在配置文件中启用背景管理器、面板和停靠应用程序：

警告

通过 wcm 所做的更改将覆盖在 wayfire.ini 配置文件中的自定义更改。因此，强烈建议备份 wayfire.ini 文件，以便在需要时恢复任何重要的更改。

最后，wayfire.ini 中列出的默认启动器是 ，如果用户愿意，也可以用其他面板替换它。

在安装 Wayland 时，除非 Wayland 是在没有 X11 支持的情况下构建的，否则 Xwayland 二进制文件应该已经安装。如果 /usr/local/bin/Xwayland 文件不存在，请使用以下命令安装它：

# pkg install xwayland

注意

推荐使用 Xwayland 的开发版本，并且它很可能与 Wayland 包一起安装。每个合成器都有启用或禁用此功能的方法。

安装 Xwayland 后，需要在所选合成器中进行配置。对于 Wayfire，在 wayfire.ini 文件中需要添加以下行：

对于 Sway 合成器，Xwayland 应该默认启用。即使如此，建议手动在 ~/.config/sway/config 中添加以下配置行：

最后，对于 Hikari，不需要做任何更改。默认情况下，Xwayland 的支持已内建。如果需要禁用该支持，可以从 Ports 重新构建该包，并在此时禁用 Xwayland 支持。

完成这些更改后，启动合成器并通过键绑定执行一个终端。在此终端中，执行 env 命令并搜索 DISPLAY 变量。如果合成器能够正确启动 Xwayland X 服务器，则这些环境变量应该类似于以下内容：

在此输出中，显示了默认的 Wayland 显示器和为 Xwayland 服务器设置的显示器。验证 Xwayland 是否正常工作的另一种方法是安装并测试一个小的包：[x11/eyes]，并检查输出。如果 xeyes 应用程序启动并且眼睛跟随鼠标指针，则说明 Xwayland 正常工作。如果出现如下错误，说明在 Xwayland 初始化期间发生了问题，可能需要重新安装：

警告

Wayland 的一个安全特性是，在没有运行 X 服务器的情况下，不会有其他网络监听程序。待启用 Xwayland，此安全特性不再适用于系统。

对于某些合成器，如 Wayfire，Xwayland 可能无法正确启动。因此，env 会显示以下 DISPLAY 环境变量信息：

尽管已经安装并配置了 Xwayland，X11 应用程序仍然无法启动，并会出现显示问题。为了解决这个问题，需要验证是否已经有一个通过 UNIX 套接字运行的 Xwayland 实例。首先，检查 sockstat 的输出并搜索 X11-unix：

输出应该类似于以下信息：

这表明存在一个 X11 套接字。可以进一步通过在合成器下的终端仿真器中尝试手动执行 Xwayland 来验证这一点：

如果已经有一个 X11 套接字可用，用户会看到以下错误：

由于已经有一个活跃的 X 显示器（显示号为 0），因此环境变量设置不正确。要修复此问题，可以将 DISPLAY 环境变量更改为 :0 并重新尝试执行该应用程序。以下示例使用 作为需要 Xwayland 服务的应用程序：

做出此更改后， 应用程序应该能够使用 Xwayland 启动并按预期工作。

在编辑内核配置文件之前，建议对机器的硬件进行清单盘点。在双重启动系统中，可以从其他操作系统创建硬件清单。例如，Microsoft® 的设备管理器包含有关已安装设备的信息。

注意

某些版本的 Microsoft® Windows® 有个系统图标，可以用来访问设备管理器。

如果 FreeBSD 是唯一安装的操作系统，可以使用 dmesg(8) 来确定在启动探测过程中找到并列出的硬件。FreeBSD 上的大多数设备驱动程序都有手册页，其中列出了该驱动程序支持的硬件。例如，以下几行表明 psm(4) 驱动程序找到了一个鼠标：

psm0: <PS/2 Mouse> irq 12 on atkbdc0
psm0: [GIANT-LOCKED]
psm0: [ITHREAD]
psm0: model Generic PS/2 mouse, device ID 0

由于此硬件存在，因此不应将该驱动程序从自定义内核配置文件中删除。

如果 dmesg 的输出未显示启动探测的结果，可以改为读取 /var/run/dmesg.boot 的内容。

另一个用于查找硬件的工具是 pciconf(8)，它提供了更详细的输出。例如：

% pciconf -lv
ath0@pci0:3:0:0:        class=0x020000 card=0x058a1014 chip=0x1014168c rev=0x01 hdr=0x00
    vendor     = 'Atheros Communications Inc.'
    device     = 'AR5212 Atheros AR5212 802.11abg wireless'
    class      = network
    subclass   = ethernet

此输出表明 ath 驱动程序找到了一款无线以太网设备。

的 -k 标志可以用于提供有用的信息。例如，它可以用来显示包含特定设备品牌或名称的手册页列表：

创建硬件清单后，请参考它以确保在编辑自定义内核配置时不会删除已安装硬件的驱动程序。

本节介绍了 FreeBSD Ports 中的一些可用于视频播放的软件。

表 4. 视频播放器包

9.4.1. MPlayer

MPlayer 是一款多媒体播放器和编码器套件，支持多个平台并可通过命令行操作。它支持众多不同的文件格式和编解码器，包括流行的 DivX、XviD、H.264 流媒体，以及 DVD 和 SVCD，还支持许多常见的音频编解码器。

要安装 MPlayer，请执行：

有关 MPlayer 工作示例，请参见 。

9.4.2. SMPlayer

SMPlayer 旨在成为 MPlayer 的完整前端，从基本功能（如播放视频、DVD 和 VCD）到更高级的功能（如支持 MPlayer 滤镜等）。

要安装 SMPlayer，请执行：

9.4.3. VLC 媒体播放器

VLC 媒体播放器是一款高度可移植的多媒体播放器，支持多种音频和视频格式（如 MPEG-1、MPEG-2、MPEG-4、DivX、mp3、ogg 等），以及 DVD、VCD 和多种流媒体协议。它还可以用作服务器，通过高带宽网络在 IPv4 或 IPv6 上进行单播或多播流媒体传输。VLC 还具备实时转码功能，可以进行流媒体传输或保存到磁盘。

要安装 VLC，请执行：

9.4.4. Kodi (XBMC)

Kodi（前身为 XBMC）是一个免费的开源跨平台媒体播放器和娱乐中心。它允许用户播放和查看来自本地和网络存储媒体以及互联网的多数视频、音乐、播客和其他数字媒体文件。

要安装 Kodi，请执行：

重要

在默认情况下，出现以下信息之前，安装器将不会对磁盘进行任何更改：

在此警告之前，可以随时退出安装。如果担心某些配置错误，只需在此之前关闭计算机，设备磁盘将不会有任何变更。

本节讲解了如何从使用的说明准备的安装介质启动系统。当使用可引导 USB 闪存驱动器时，请在打开计算机之前插入 USB 闪存驱动器。当从 CD/DVD 启动时，请在打开计算机后立刻插入介质。如何配置系统从插入的介质启动取决于架构。

2.4.1. FreeBSD 引导加载程序菜单

在系统从安装介质启动后，将显示类似如下内容的菜单：

FreeBSD 是一款开源、符合标准的类 Unix 操作系统，适用于 x86（32 位和 64 位）、ARM、AArch64、RISC-V、POWER 和 PowerPC 计算机。它提供了现今被视为理所当然的所有功能，例如抢占式多任务处理、内存保护、虚拟内存、多用户功能、SMP（对称多处理）支持，以及为不同语言和框架提供了所有的开源开发工具，以及基于 X Window 系统、KDE 和 GNOME 的桌面功能。FreeBSD 的独家优势包括：

• 自由的开源许可证：你可以自由修改和扩展其源代码，并将其纳入开源项目和闭源产品中，而不受典型著佐权许可证的限制，同时规避了潜在的许可证不兼容问题。

• 强大的 TCP/IP 网络功能：FreeBSD 实现了行业标准协议，性能和可扩展性日益增强。这使其在服务器、路由和防火墙角色中都非常适合，实际上许多公司和供应商正是出于这个目的而使用 FreeBSD。

FreeBSD 桌面环境可以用于参加视频会议。本节将介绍如何配置摄像头以及 FreeBSD 支持哪些视频会议应用程序。

9.5.1. 配置摄像头

为了让 FreeBSD 访问摄像头并进行配置，需要安装一些实用工具：

• 是守护进程，支持使用数百种不同的 USB 摄像头和 DVB USB 设备。

文件系统最好被想象成一棵树，其“根”位于 /。/dev、/usr 和根目录下的其他目录是这棵树的分支，它们又可能有自己的分支，比如 /usr/local，以此类推。

出于多种原因，可以将这些目录中的某些放在独立的文件系统上。/var 包含 log/、spool/ 目录以及各种临时文件，因此可能会被写满。写满根文件系统并不是好事，因此通常建议将 /var 与 / 分离。

另一个常见的原因是某些目录树可能存放在独立的物理磁盘上，或独立的虚拟磁盘上，例如网络文件系统挂载（见 ），或 CDROM 驱动器。

本节介绍了 FreeBSD Ports 中的一些可用于音频播放的软件。

表 3. 音频播放器包

本部分展示了 bsdinstall 菜单的顺序以及在系统安装之前将询问的信息类型。使用箭头键高亮菜单选项，然后按 空格键 选择/取消选择该菜单项。在完成后，按 回车键 可保存选择，进入下一个界面。

2.5.1. 键盘布局选择菜单

在开始安装过程之前，bsdinstall 将加载键盘布局文件，如所示。

图 4. 键盘布局加载

在加载键盘布局后，bsdinstall 将显示。使用上下箭头选择与系统接入的键盘最相符的键盘布局。按

自 UNIX® 面世以来，一些新的文档格式逐渐流行起来，而这些格式所需的查看器可能在基本系统中不可用。本节介绍了如何安装以下文档查看器：

表 5. 支持的文档查看器

Sway 合成器是款平铺合成器，旨在替代 i3 窗口管理器。它应当可以与用户当前的 i3 配置兼容，但某些新功能可能需要额外的设置。

在开始安装 Sway 之前，请确保安装并正确配置了显卡（GPU）。请参考 部分进行指导。这一步对于 Sway 合成器的正常工作至关重要。

以下示例假定进行的是一次全新安装，而没有迁移任何 i3 配置。要安装 Sway 和相关组件，请以 root 用户身份执行以下命令：

为了获得一个基本的配置文件，执行以下命令并在复制后编辑配置文件：

基本的配置文件包含了许多默认设置，这对大多数用户来说已经足够。以下是需要做的一些重要更改：

在上面的例子中，加载了 evdev(4) 事件的 xkb 规则，并将 $mod 键设置为 Windows 键，以便进行键绑定。接下来，设置了终端仿真器为 alacritty，并定义了屏幕锁定命令（稍后会详细介绍）。output 关键字定义了显示模式、位置，背景墙纸也被设置并指示 Sway 拉伸墙纸以填充屏幕。最后，swayidle 被设置为守护进程，并在 300 秒后锁定屏幕，在 600 秒后进入休眠模式。黑色的锁定背景色（000000）也在这里定义。使用 swaylock-effects，还可以使用 --clock

Wayland 是一种新的显示服务器，它与 Xorg 在多个重要方面有所不同。

首先，Wayland 只是一个协议，充当客户端之间的中介，采用不同的机制，从而去除了对 X 服务器的依赖。Xorg 包括 X11 协议，用于运行远程显示，X 服务器接受连接并显示窗口。而在 Wayland 下，合成器或窗口管理器提供显示服务器，而不是传统的 X 服务器。

由于 Wayland 不是 X 服务器，传统的 X 屏幕连接需要使用其他方法，如 VNC 或 RDP 进行远程桌面管理。其次，Wayland 可以作为一个独立的实体管理客户端与合成器之间的复合通信，而无需支持 X 协议。

Wayland 相对较新，并不是所有软件都已更新为原生运行而无需 Xwayland 支持。由于 Wayland 不提供 X 服务器，并期望合成器提供该支持，因此尚未支持 Wayland 的 X11 窗口管理器将要求 Xwayland 在没有 -rootless 参数的情况下启动。移除 -rootless 参数后，将恢复 X11 窗口管理器的支持。

注意

当前的 NVIDIA® 驱动程序应该能够与大多数 wlroots 合成器兼容，但可能会略显不稳定，并且可能不支持所有功能。目前，NVIDIA® DRM 的志愿者正在寻求帮助。

全书在逻辑上被分为五个独立的部分。第一部分是 入门，涉及 FreeBSD 的安装和基本用法。预设读者会按顺序阅读这些章节（可跳过已熟悉的话题）。第二部分是 常见任务，涉及一些 FreeBSD 的常用功能。第二及后续所有部分都可以乱序阅读。每章都以简洁的概述开头，讲解本章的内容以及读者应该掌握的知识。这样设计是为了让跳读的读者也能够找到感兴趣的章节。第三部分是 系统管理，涉及管理主题。第四部分是 网络通信，涉及网络和服务器主题。第五部分是包含书目的附录。

为新用户讲解 FreeBSD。它涉及 FreeBSD 项目的历史、目标和开发模型。

指导用户使用 bsdinstall 实现 FreeBSD 9.x（及更高版本）的完整安装。

涉及 FreeBSD 操作系统的基础命令和功能。如果你熟悉 Linux® 或其他版本的 UNIX®，那么你大可以跳过本章节。

涉及使用 FreeBSD 创新的“Ports”和单个二进制包来安装第三方软件的方法。

本节介绍了如何在 FreeBSD 系统上安装和配置一些流行的 web 浏览器，从高资源消耗的全功能浏览器到减少资源使用的命令行浏览器。

表 2 支持的浏览器

FreeBSD 是一个多任务操作系统。每个在任意时刻运行的程序都称为一个 进程（process）。每个正在运行的命令都会启动至少一个新进程，并且 FreeBSD 还会运行一些系统进程。

每个进程都有一个唯一的编号，称为 进程 ID（PID）。类似于文件，每个进程也有一个所有者和所属组，系统会依据所有者和组的权限来判断进程可以访问哪些文件和设备。大多数进程也有一个启动它们的父进程。例如，shell 是一个进程，而在 shell 中启动的任何命令也都是进程，它们的父进程就是该 shell。唯一的例外是一个特殊进程，叫做 ，它总是在系统启动时第一个启动，进程 ID 永远是 1。

某些程序并不是设计来持续接受用户输入的，它们会在合适的时机脱离终端。例如，Web 服务器是用来响应网络请求而不是用户输入的。邮件服务器也是这种程序的一个例子。这类程序被称为 守护进程（daemon）。daemon 一词来自希腊神话，表示一种既非善也非恶、在幕后默默执行有用任务的存在。这就是为什么 BSD 的吉祥物是那个穿着运动鞋、手持三叉戟、神态轻松的小恶魔。

守护进程的程序通常以 “d” 结尾命名是一种惯例。例如，BIND（Berkeley Internet Name Domain）的实际运行程序是 named；Apache Web 服务器程序是 httpd；打印服务的后台处理进程是 lpd。这只是命名习惯，例如 Sendmail 的主邮件守护进程叫做 sendmail，而不是 maild

在 FreeBSD 中，图像扫描仪的访问通过 提供，该软件在 FreeBSD Ports 中可用。

9.6.1. 检查扫描仪

在进行任何配置之前，检查扫描仪是否受到 SANE 支持非常重要。

将扫描仪连接好后，运行以下命令以获取所有连接的 USB 设备：

输出应类似于以下内容：

运行以下命令获取 idVendor 和 idProduct：

shell 提供了用于与操作系统交互的命令行界面。Shell 从输入通道接收命令并执行它们。许多 shell 提供内建函数，用于协助日常任务，例如文件管理、文件通配（globbing）、命令行编辑、命令宏以及环境变量。FreeBSD 提供了多个 shell，包括 Bourne shell（）和扩展的 C shell（）。其它 shell 可通过 FreeBSD Ports 获得，例如 zsh 和 bash。

使用哪一个 shell 实际上是个人喜好问题。C 语言程序员可能更倾向于使用类似 C 语言的 shell，比如 。Linux® 用户可能更喜欢 bash。每种 shell 都具有其独特属性，这些属性可能符合，也可能不符合用户所偏好的工作环境，因此才会有选择 shell 的自由。

一个常见的 shell 特性是文件名补全。用户输入命令或文件名前几个字母并按下 Tab 后，shell 会补全剩余部分。假设有两个文件分别叫做 foobar 和 football，用户要删除 foobar，可能会键入 rm foo 并按下 Tab 来补全文件名。

在确定设备满足安装 FreeBSD 的最低硬件要求后，就可以下载安装文件，准备安装介质了。

技巧

如果你想在已安装其他操作系统的系统上使用 FreeBSD，请考虑使用虚拟化。

在进行安装之前，请检查下列清单中的项目，查看系统是否准备就绪：

1. 备份重要数据

   在安装任何操作系统之前，请 始终 先备份所有重要数据。不要将备份存储在要安装的系统上，而应将数据保存到可移动磁盘，如 USB 驱动器、网络上的其他系统和在线备份服务。请在开始安装之前测试备份，以确保它包含所有所需文件。在安装程序格式化系统磁盘后，存储在该磁盘上的所有数据都将丢失。

2. 选择安装 FreeBSD 的位置

   如果你仅安装 FreeBSD 这一个操作系统，则可以跳过此步骤。但如果 FreeBSD 将与其他操作系统共享磁盘，则需决定使用哪块磁盘和分区。

   在 i386 和 amd64 架构中，可以使用两种分区方案之一将磁盘划分为多个分区。传统的 主引导记录（MBR）包含一个分区表，最多可定义四个 主分区。出于历史原因，FreeBSD 称这些主分区为 切片（slice）。其中某主分区可以作为 扩展分区，可包含多个 逻辑分区。GUID 分区表（GPT）是一种新款且更简单的磁盘分区方法。常见的 GPT 实现可使每块磁盘最多有 128 个分区，消除了对逻辑分区的需求。

   FreeBSD 引导加载程序需要一个主分区/GPT 分区。如果所有主分区/GPT 分区已被使用，则必须为 FreeBSD 释放一个分区。要在不删除现有数据的情况下创建分区，可以使用分区调整工具缩小现有分区，使用释放的空间创建新分区。

   另一种修改系统现有磁盘分区的方法是使用，这能让多个操作系统同时运行，而无需更改分区。

   各种免费和商业的分区调整工具列在上。 是一款免费的 Live CD，内置 GParted 分区编辑器。

警告

若使用得当，磁盘缩小工具可安全地为创建新分区创造空间。由于可能选择错误的分区，请始终备份重要数据，并在修改磁盘分区之前检查备份的完整性。

　　包含不同操作系统的磁盘分区使在一台计算机上安装多个操作系统成为可能。

1. 收集网络信息

   某些 FreeBSD 安装方法需要网络连接用于下载安装文件。在安装后，安装程序会提供设置系统网络接口的选项。

   如果网络有 DHCP 服务器，则可以用它来提供自动网络配置。如果没有 DHCP，则必须从本地网络管理员或互联网服务提供商获取以下网络信息：

   所需的网络信息：

   1. IP 地址

   2. 子网掩码

2.3.1. 准备安装介质

FreeBSD 安装程序不是能在其他操作系统中运行的应用程序。请下载 FreeBSD 安装文件，将其刻录到与其文件类型和大小相对应的介质（CD、DVD 或 USB）上，然后从插入的介质安装启动系统。

可以在 上获取 FreeBSD 安装文件。每个安装文件的名称包括 FreeBSD 的发布版本、架构和文件类型。

安装文件以多种格式提供，可以使用 压缩/未压缩。格式因计算机架构和介质类型而异。

安装文件类型：

• -bootonly.iso：这是最小的安装文件，仅包含安装程序。安装过程中需要一个有效的互联网连接，因为安装程序会下载完成 FreeBSD 安装所需的文件。该文件应刻录到光盘上。

• -disc1.iso：该文件包含安装 FreeBSD 所需的所有文件、源代码和 Ports。应将该文件刻录到光盘上。

• -dvd1.iso：该文件包含安装 FreeBSD 所需的所有文件、源代码和 Ports。它还包含一组流行的二进制包，用于安装窗口管理器和一些应用程序，以便可以从介质安装完整的系统，而无需连接互联网。应将该文件刻录到光盘上。

下载镜像文件后，请从同一目录下载至少一个 checksum（校验和）文件。有两个校验和文件可用，文件名包含发布编号和架构名称。例如：CHECKSUM.SHA256-FreeBSD-13.1-RELEASE-amd64 和 CHECKSUM.SHA512-FreeBSD-13.1-RELEASE-amd64。

下载其中一个文件（或两个文件）后，计算镜像文件的校验和并与 checksum 文件中显示的进行比较。请注意，你需要将计算出的校验和与正确的文件进行比较，因为它们对应于两种不同的算法：SHA256 和 SHA512。FreeBSD 提供了 、 用于计算 checksum。其他操作系统也有类似的程序。

在 FreeBSD 中，可以通过执行以下命令自动完成校验和的验证：

校验和必须完全匹配。如果校验和不符合，则镜像文件已损坏，必须重新下载。

2.3.1.1. 将镜像文件写入 USB

*memstick.img 文件是 USB 闪存驱动器内容的 镜像。它 不能 作为文件复制到目标设备。可用多个应用程序将 *.img 写入 USB 闪存驱动器。本节介绍了其中两个工具。

重要

在继续之前，请备份 USB 闪存驱动器上的所有重要数据。此过程将删除驱动器上的现有数据。

使用 ​dd​ 写入镜像的步骤

警告

此示例使用 /dev/da0 作为目标设备，镜像将在此设备上写入。请 务必小心，使用正确的设备，因为此命令将删除指定目标设备上的现有数据。

1. 此命令行工具可在 BSD、Linux® 和 Mac OS® 系统上使用。要使用 dd 刻录镜像，请插入 USB 闪存驱动器，然后确定其设备名称。接下来，指定下载的安装文件的名称和 USB 闪存驱动器的设备名称。此示例将在现有 FreeBSD 系统的首个 USB 设备上刻录 amd64 安装镜像。

如果此命令失败，请检查，不应挂载 USB 闪存驱动器，并且设备名称是磁盘，而非分区。

使用 Windows® 写入镜像的步骤

警告

请确保选择了正确的驱动器字母，因为所指定驱动器上的现有数据将被覆盖和删除。

1. 获取 Windows® 镜像写入工具

Windows® 镜像写入工具是一款免费应用程序，可以正确地将镜像文件写入 USB 闪存驱动器。请从 下载，然后将其解压到一个文件夹中。

1. 使用镜像写入工具写入镜像

双击 Win32DiskImager 图标可启动程序。验证

大多数无线网络基于 IEEE® 802.11 标准。

FreeBSD 支持使用 802.11a、802.11b、802.11g 和 802.11n 的网络。

注意

FreeBSD 对 802.11ac 的支持目前正在开发中。

一个基本的无线网络由多个站点与在 2.4GHz 或 5GHz 频段中广播的无线电通信组成，虽然根据地区不同，这些频段也在变化，正在增加 2.3GHz 和 4.9GHz 范围的通信能力。

配置无线网络的基本步骤有三步：

1. 扫描并选择接入点

2. 对站点进行身份验证

3. 配置 IP 地址或使用 DHCP

接下来的各节讨论每个步骤。

7.4.1. 快速连接到无线网络

将 FreeBSD 连接到现有无线网络是个非常常见的操作。

本快速入门流程展示了使用基本认证连接网络所需的步骤。更详细的操作流程将在下一节中说明。

第一步是从网络管理员处获取无线网络的服务集标识符（SSID）和预共享密钥（PSK）。

第二步是在 /etc/wpa_supplicant.conf 中为该网络添加一条条目。

如果该文件不存在，请创建它。有关在此文件中格式化条目的详细信息，请参阅 。

• ① 这是无线网络的 SSID。将其替换为无线网络的名称。

• ② 这是无线网络的 PSK。将其替换为无线网络的密码。

第三步是添加网络接口条目，以便在启动时配置网络。使用 sysctl net.wlan.devices 获取网络设备接口。在下面的示例中，该 sysctl 输出显示网络设备接口为 “iwn0”。

输出应类似如下：

在接下来的 sysrc 命令中，如有必要，将 “iwn0” 替换为 sysctl 命令的输出：

• 最后一步是重启 netif 服务，执行以下命令：

7.4.2. 基本无线配置

本节提供了一个更详细的无线网卡配置示例。要查看系统中有哪些无线网卡，请参阅章节 。

要使该更改在重启后生效，请执行以下命令：

注意

由于全球各地的法规情况不同，因此需要正确设置适用于你所在位置的区域，以获得有关可用信道的正确信息。

要使设置持久化，将其添加到 /etc/rc.conf 文件中：

7.4.3. 扫描无线网络

可以使用 扫描可用的无线网络。

要列出无线网络，执行以下命令：

输出应类似于以下内容：

1. SSID/MESH ID：标识网络的名称。

2. BSSID：标识接入点的 MAC 地址。

3. CAPS：显示每个网络的类型及其站点的功能（有关 list scan 的更多详细信息，请参见 的定义）。

7.4.4. 连接和认证无线网络

待从扫描到的无线网络列表中选择了一个网络，就需要执行连接和认证。在绝大多数无线网络中，认证是通过路由器中配置的密码进行的。其他方案则要求在数据流量开始之前完成加密握手，可能使用预共享密钥或密码，或者使用涉及后台服务（如 RADIUS）的更复杂的方案。

7.4.4.1. 使用 WPA2/WPA/Personal 认证

无线网络中的认证过程由 管理。

的配置将保存在 /etc/wpa_supplicant.conf 文件中。更多信息请参见 。

完成无线网络扫描后，选择了一个网络并获取了密码（PSK），该信息将添加到 /etc/wpa_supplicant.conf 文件中，如下所示：

• ① SSID 扫描技术。仅当网络为隐藏时需要使用此选项。

• ② 网络名称。

• ③ 无线网络的密码。

下一步是配置无线连接到 /etc/rc.conf 文件中。

如果使用静态地址，需要执行以下命令：

如果使用动态地址，需要执行以下命令：

然后执行以下命令重启网络：

注意

有关如何执行更高级认证方法的信息，请参见 。

7.4.4.2. 使用开放网络进行认证

技巧

连接没有任何认证的开放网络时，用户需要 非常 小心。

完成无线网络扫描并选择无线网络的 SSID 后，执行以下命令：

然后执行 获取配置的地址：

7.4.5. 同时使用有线和无线连接

有线连接提供更好的性能和可靠性，而无线连接提供灵活性和流动性。笔记本用户通常希望在这两种连接之间无缝切换。

在 FreeBSD 上，可以将两个或更多网络接口结合起来，以“故障转移”方式使用。这种配置使用一组网络接口中最优先和可用的连接，当链路状态发生变化时，操作系统会自动切换。

链路聚合和故障转移的详细内容请参见 ，并且可以在 中找到使用有线和无线连接的示例。

摘要：如果显示器或输入设备的默认设置不符合要求，桌面 提供了图形界面进行配置，或者也可以手动配置。

X.org 服务器支持大多数常见的图形处理器、显示器和输入设备。首先应尝试使用默认设置。本小节概述其配置方法。

5.5.1. X.org 配置文件

过去，X.org 服务器通过 /usr/local/etc/X11/ 下的文件进行配置。这种方式仍然被支持用于特殊情况，但可能与动态自动配置冲突。

除非自动配置失败，否则不要在 xorg.conf 中创建配置，也不要运行 Xorg -configure。

X.org 服务器会在多个目录中查找配置文件。/usr/local/etc/X11/ 是 FreeBSD 上推荐的配置文件目录。使用此目录有助于将应用程序文件与操作系统文件分开管理。

使用多个文件分别配置具体设置，比传统的单一 xorg.conf 更加方便。这些文件存储在子目录 /usr/local/etc/X11/xorg.conf.d/ 中。

5.5.2. 配置显卡

直接渲染允许同时无缝使用独立显卡（dGPU）和集成显卡（iGPU），称为 PRIME。驱动程序会在需要时自动将高强度任务卸载到 dGPU，并在可能时关闭其电源。

在 PRIME 中使用更强大的 GPU 启动应用程序时，使用环境变量 DRI_PRIME=1。

如果多个图形驱动冲突，可在 /usr/local/etc/X11/xorg.conf.d/ 目录中指定图形处理器的驱动。

Intel® 驱动配置示例：

/usr/local/etc/X11/xorg.conf.d/20-intel.conf

AMD® 驱动配置示例：

/usr/local/etc/X11/xorg.conf.d/20-radeon.conf

NVIDIA® 驱动配置示例：

/usr/local/etc/X11/xorg.conf.d/20-nvidia.conf

技巧

也可用于对 NVIDIA 驱动的配置选项进行基本控制。

SCFB 驱动配置示例：

/usr/local/etc/X11/xorg.conf.d/20-scfb.conf

VESA 驱动配置示例：