编辑日志

2026 年第三季度

• 2026.7.2

  • 格式清理（空格、大小写统一、统一格式）

2026 年第二季度

• 2026.6.27

  • 目录结构调整
• 2026.6.25

  • 从迁移指南中拆分出“第 3 章 BSD 文化与 BSD 发行版概论”
• 2026.6.24

  • X11 的归 X11、Wayland 的归 Wayland
  • 为全书增补 Mermaid 图
• 2026.6.22

  • “10.2 KDE 6 桌面环境（Wayland 会话）”新增“通过 Ly 启动桌面”
  • 使用 Port www/code-server 重新整理“22.1 code-server 和 clangd 开发环境”

---

• 2025.4.21-2026.6.22

  • 《FreeBSD 从入门到跑路》第三版完成（TAG 2026.6.22）

---

• 2026.6.14

  • 更新“5.5 基于 Apple M1 和 VMware Fusion Pro 安装 FreeBSD”到 VMware Fusion Pro 26H1
  • 更新“5.4 基于 Apple M1 和 Parallels Desktop 安装 FreeBSD”到 Parallels Desktop 26.3.3
• 2026.6.13

  • 全面调整章节结构
• 2026.6.12

  • “16.8 OpenSSH”中的“SSH 和 SCP 客户端”移动到“5.1 Windows 用户迁移指南”
  • “26.1 数据库概论”增补 PostgreSQL 对应语法，由自动程序测试通过所有语法
  • “22.2-22.4”由自动程序测试通过所有语法
  • “16.8 OpenSSH”新增“tmux”
  • 从“7.3 使用 PkgBase 更新 FreeBSD”拆分出“7.3 使用 PkgBase 转换基本系统”“7.4 使用 ZFS 启动环境更新 FreeBSD”“20.7 更新 OpenZFS 版本”
• 2026.6.11

  • 使全书符合最佳实践，标记不符合生产环境的行为
  • 废除冗余的 A/B 组 shell，环境变量一律改用用户分级方法
  • “27.4 vsftpd”：使用基本系统内置的 openssl 取代 apache24
  • 完全重写并从手册增补更新：“28.3 网络文件系统（NFS）”
• 2026.6.10

  • “14.1 Godot 开源游戏引擎”新增“项目演示”
  • “28.2 Samba 文件共享”更新到 samba4.23
  • 更新“3.1 安装前的准备工作”
• 2026.6.9

  • 从“14.3 我的世界（Minecraft）”拆分出“14.2 我的世界（Minecraft）服务器”
  • “16.13 NTP 时间同步与时区”：增补“NTP 配置文件”
  • 把若干列表适当地转换为表格便于阅读
  • 新增“14.5 R 语言”
  • 从手册增补更新“8.2 基础网络管理”，新增“别名地址”
  • 从手册增补更新“8.8 网桥”
  • 从手册增补更新“8.9 链路聚合与故障转移”，注意：示例 1. 使用交换机进行 LACP 聚合无法测试，需要交换机支持。后续再重写。
  • 从手册增补更新“8.10 VLAN”，后续再重写
• 2026.6.8

  • “16.13 NTP 时间同步与时区”删除“Cron 任务中的时区”，内容不正确。FreeBSD 的 Cron 不支持此项，这是 Linux 才有的变量。
• 2026.6.7

  • 删除“14.5 科研和专业计算”中直接引用的维基百科等内容
  • 删除“7.1 系统更新检测”，对于 KDE 无用，且不具有实际价值
• 2026.6.5

  • 移除“4.5 基于 Apple M1 和 UTM 安装 FreeBSD”。

    • 参见 https://reviews.freebsd.org/D55012 和 Bug 283646 - x11-drivers/xf86-video-scfb: startx fails: (EE) scfb(0): scfb_mmap: Invalid argument
  • 删除“14.1 Ren'Py 视觉小说引擎”，Port 已经被移除，且实用性不强，类似游戏较少，且目前的例子（心跳文学社！）不合适

    • 提交 Bug 295539 games/renpy: Maybe need update to 8.x.y not deprecate
• 2026.6.4

  • 完全重写“13.5 Slackware Linux 兼容层”
  • 新增“23.2 厚 Jail（Thick Jail）”
• 2026.6.3

  • 完全重写：“13.3 Ubuntu/Debian 兼容层”，更新到 Ubuntu 26.04 LTS、Debian 13
  • 新增 Kali Linux 兼容层
  • 删除“13.6 openSUSE 兼容层”，因为全面启用了 SELinux，不被支持
  • 完全重写：“13.6 Gentoo Linux 兼容层”，更新到 2026.6.1 版本（自动构建）
• 2026.6.2

  • “13.2 Rocky Linux 兼容层”：完全重写“通过 Shell 脚本安装 Rocky Linux 10 兼容层”，现在直接引用 WSL 兼容层
• 2026.6.1

  • 新增章节“第 7 章 FreeBSD 系统更新”，拆分自其他章节
  • 提交 Port lang/python version display incorrect, should use Mk/bsd.default-versions.mk #659
• 2026.5.31

  • 通过手册增补更新“19.8 ZFS 调优”
  • 通过手册增补更新“10.7 文档查看器”
• 2026.5.30

  • 第 16 章“存储与文件系统管理”改名为“存储管理”
  • “17.1 Windows 文件系统”：完全重写“NTFS 文件系统”
  • 第 16 章新增章节：USB 存储设备、虚拟内存盘
  • 拆分“16.1 UFS 文件系统”到第 18 章“UFS 文件系统”（新增18.2 添加 UFS 磁盘）
  • 拆分“18.11 加密磁盘分区”
  • 新增第 17 章“其他文件系统”，由第 16 章“存储与文件系统管理”拆分而来
• 2026.5.29

  • 新增“加密磁盘分区”
  • “9.8 LXDE”作为附录合并到“9.6 LXQt”
  • 新增“11.2 特定语言的区域配置”
  • 完全重写：“20.1 Jail 基础”（使用手册增补更新）
  • 完全重写：“16.3 Linux 文件系统”中的“EXT 系列文件系统”
  • “16.4 Windows 文件系统”新增“exFAT 文件系统”
  • 新增“16.5 macOS 文件系统”
• 2026.5.28

  • 从“12.8 Linux Jail”拆分出第 21 章 Linux Jail
  • 新增 10.8 摄像头
  • 删除 20.2 Jail 系统更新，待重写
• 2026.5.26

  • 近 2 个月从 FreeBSD 合并了一些内容，标志着本书基本成为 Handbook 的超集。可以说，目前 Handbook 已经完全失去价值。
• 2026.5.25

  • 更新“11.11 WPS Office（Linux 版）”中的“基于 Rocky Linux 兼容层（FreeBSD Port）”
  • “27.4 Python 开发环境”新增“通过 uv 管理 Python”
  • 从“1.4 FreeBSD 导论”拆分出第二章 FreeBSD 导论和“1.4 什么是 FreeBSD”
• 2026.5.24

  • 更新“6.1 基础网络”中的“通过 ifconfig 命令识别网络适配器”
  • 更新“21.4 MySQL”到 MySQL 8.4
  • 提交 Bug 295539 - games/renpy: Maybe need update to 8.x.y not deprecate
  • 提交 Bug 295538 - java/intellij-ultimate: Please move it to java/intellij
  • 完全重写：“27.2 Java 开发环境”
  • 完全重写：“27.3 Qt 开发环境”
  • 完整重写：“27.5 Rust 开发环境”
  • 更新“27.6 Go 开发环境”
  • 更新“27.7 Node.js 开发环境”
  • 更新“27.10 使用 IDA Pro 调试 FreeBSD”到 IDA Pro 9.3
  • 将“通用嵌入式开发环境”拆分为“STM32 开发环境”“乐鑫（Espressif）开发环境”“Arduino 开发环境”
  • 重写“26.7 STM32 开发环境”中的“安装 STM32CubeMX”
  • 完整重写：“26.9 Arduino 开发环境”
  • 提交 Bug 295543 - devel/arduino18 not work with openjdk25 but work on openjdk8
  • 更新：“2.5 使用 Hyper-V 安装 FreeBSD”
• 2026.5.23

  • 删除“8.10 Hyprland”，无法复现，缺乏文档维护
  • 完全重写：“2.4 使用 VirtualBox 安装 FreeBSD”
• 2026.5.22

  • 从“23.1 FTP 服务器”拆分出第 22 章：文件传输协议（FTP）
  • 删除“21.4 MySQL 5.x 系列”，过时且不可用
  • 独立“27.6 Go 开发环境”
  • 使用手册增补更新“20.4 在 FreeBSD 上安装 VirtualBox”
• 2026.5.21

  • 从“16.1 ZFS 历史与现实”拆分出“16.2 ZFS 特性和术语”
  • 新增“17.1 信息安全概述”
  • 更正“17.7 OpenSSL”
• 2026.5.20

  • 新增“4.3 macOS 用户迁移指南”
• 2026.5.19

  • 非理论章节删除课后习题
  • “1.5 乔治·贝克莱（George Berkeley）与 BSD 的命名渊源”与“1.6 加州大学伯克利分校与“要有光”（Fiat Lux）”合并为“1.5 乔治·贝克莱（George Berkeley）与 BSD 文化传统”
  • 新增“1.6 其他 BSD 发行版概述”
• 2026.5.18

  • 删除：8.9 bspwm，原因：无法复现，存在逻辑错误
  • 如果 CDE 维护者未在 2027 年 1 月前接纳中文补丁，将移除 CDE。参见 #2157。
• 2026.5.17

  • 新增：“14.11 系统日志管理”
• 2026.5.16

  • 审核全书 Port 是否有效清理失效软件
• 2026.5.15

  • 增补重写：“11.1 Linux 兼容层架构”
  • 通过参考文献和 FreeBSD man 对全书进行事实核查
  • 进一步去欧化汉语
• 2026.5.13

  • 增补重写：“第 16 章 ZFS”
• 2026.5.11

  • 新增：“13.1 人工智能概述”
  • 新增：“13.2 大模型本地部署”
• 2026.5.10

  • 从“7.2 Intel 和 AMD 显卡驱动配置”拆分出“7.1 显卡驱动概述”“7.3 AMD 显卡驱动”
  • 依据手册结构重组第 16 章
• 2026.5.8

  • 增补重写：“17.6 blocklistd”，大部分功能测试通过
  • 原“6.2 TCP/IP 协议栈”重命名为“6.2 高级网络管理”
  • 增补重写：“6.2 高级网络管理”
  • 格式化全文，使之书面化
  • “4.6 shell 配置”合并入“4.5 shell 基础”
• 2026.5.6

  • 增补重写：“9.1 ZFS 历史与现实”
  • 增补重写：“5.3 管理 FreeBSD 中的服务”
  • 增补重写：“5.9 Cron 和 Periodic”
  • 增补重写：“5.10 sysctl 工具”
  • 增补重写：“14.2 声卡配置”
  • 增补重写：“5.11 NTP 时间同步与时区”
  • 增补重写：“5.8 设备资源提示文件（device.hints）”
  • 增补重写：“19.4 Samba 文件共享”
  • 将附录 1 两篇附录还原至原有路径
  • 审阅全书汉语欧化现象
  • 新增：“17.1 防火墙概述”
• 2026.5.3

  • 新增：“18.2 资源限制”
  • 新增：“18.3 安全等级”
  • 新增：“18.4 安全事件审计”
  • 新增：“18.5 OpenSSL”
  • 新增：“18.6 入侵检测系统（IDS）”
  • 新增：“18.7 第三方漏洞与安全公告”
  • 完全重写：“4.3 系统目录结构”
  • 新增：“27.7 构建定制内核”
  • 新增：“24.10 DTrace”
  • “8.1 UFS 文件系统”新增“UFS 文件系统快照”“UFS 文件系统磁盘配额”
  • 增补重写：“5.6 OpenSSH”
  • 增补重写：“权限提升工具（sudo、doas 等）”
  • 新增“18.1 账户认证安全”
• 2026.4.30

  • 新增：18.6 零配置网络（mDNS/DNS-SD）
• 2026.4.28

  • 使用手册增补 5-7 章
• 2026.4.27

  • 使用手册增补前言、1-4 章
  • 更新 7.3 Clash for FreeBSD
• 2026.4.23

  • 独立“UEFI/BIOS 注解（AMI BIOS）”
  • 独立非 FreeBSD 的其他 BSD 章节
  • 移除与 FreeBSD 无关的文学故事
• 2026.4.21

  • 调整全书结构，使之自下而上。去手册化、博客化
• 2026.4.20

  • 对查重有问题的计算机网络、防火墙中部分小节予以删除
  • 拆分附录 Ⅰ 关系型数据库基础到 19.4 MySQL 8.x 系列
  • 拆分附录 Ⅰ 计算机网络到 14.1 网络基础配置
  • 独立附录 Ⅰ 计算机系统结构中的“microSD 卡参数简介”
  • 附录 Ⅰ 计算机系统结构中的其他内容予以删除
  • 其他附录目次依次递减
• 2026.4.19

  • 审阅全书术语、错别字
  • 增补全书参考文献
  • 核查全书事实
• 2026.4.8

  • 删除赘余的人称和表达
  • 润色以符合出版物要求
• 2026.4.5

  • 格式化全书
• 2026.4.3

  • 规范全书参考文献
• 2026.4.1

  • 校对全书

2026 年第一季度

• 2026.3.31

  • 校对 1.1-8.6 节
• 2026.3.29

  • 删除“21.5 Deepin 兼容层”，已经失效且难以增补
  • 审阅全书在线的参考文献，确保其可访问性
  • 根据术语在线 https://www.termonline.cn/ 平台审定全书术语
• 2026.3.28

  • 标准化全书的参考文献
  • 标准化全书的图片描述部分
  • 消除 markdownlint 报错，使 markdown 标准化
• 2026.3.24

  • 进一步审阅全书
• 2026.3.22

  • 为全书补全目录结构图
• 2026.3.21

  • 为所有参考资料作注解
  • 为全书增补课后习题
• 2026.3.19

  • 全面修订所有章节，旨在靠近专业出版物
• 2026.3.18

  • 全面修订第 1 章，旨在靠近专业出版物
• 2026.3.11

  • 将“13.1 启动引导器及配置文件（loader.conf）”中“TTY 中文控制台”移动到“8.7 系统字体替换”
  • 截至今天，本书导出的 PDF 文档为 2026 页
• 2026.3.10

  • “13.1 启动引导器及配置文件（loader.conf）”新增“loader.conf 系统启动配置信息”
  • 新增“13.8 设备资源提示文件（device.hints）”
  • “13.2 管理 FreeBSD 中的服务”易名为“13.2 init.rc 服务”，非 rc 服务部分拆分到下面章节
  • “13.2 init.rc 服务”：完全重写
  • 新增“13.9 crontab 及定时任务文件（periodic.conf）”
  • 新增“13.10 内核状态默认配置文件（sysctl.conf）”
• 2026.3.9

  • “4.10 系统目录结构”合并入“4.1 Windows 用户迁移指南”，内容重合
  • “13.4 SSH 配置和相关工具”新增“附录：OpenSSH 服务端配置详解”
• 2026.3.8

  • 新增“18.5 嵌入式开发”
• 2026.3.3

  • 删除《16.2 MinIO 对象存储服务》，原因：由于上游不再维护，将其从 Ports 删除
• 2026.3.2

  • 将“22.4 LLVM / Clang 概述”合并入“22.15 在 FreeBSD 上开发 C/C++”，成为“22.4 在 FreeBSD 上开发 C/C++”
  • 将“22.2 如何开发一个 Port”“22.14 利用脚本自动生成 BSD libc 库文本”合并入“22.3 如何参与 FreeBSD 开发”
  • 将“20.1 Ren’Py 和 Godot 游戏引擎”拆分为“20.1 Ren’Py 视觉小说引擎”“20.2 Godot 开源游戏引擎”
  • 将“18.1 树莓派简介（Raspberry Pi）”合并入“18.2 配置树莓派中 FreeBSD”
  • 将“1.1 操作系统的历程与开源往事”拆分为“1.1 什么是 UNIX？”“1.2 GNU 操作系统和自由软件运动”和“1.3 Linux 与类 UNIX”
  • 更新“绪论”
  • 全面调整章节结构
• 2026.3.1

  • 新增“22.15 在 FreeBSD 上开发 C/C++”
  • “4.6 文本编辑器”新增“Emacs 编辑器、Vim”
  • 将“22.7 Python 和 VS Code”中的 VS Code 章节拆分至“22.15 在 FreeBSD 上开发 C/C++”
• 2026.2.28

  • 新增“3.13 基于 Apple M1 和 UTM 安装 FreeBSD”
  • “20.2 我的世界（Minecraft）”新增“Prism Launcher 启动器”
  • 将“5.3 gitup 的用法”作删除处理。原因：缺乏实质性维护近 2 年。
  • 删除“21.5 基于 archlinux-pacman 的 Arch Linux 兼容层（拟删除）”。原因：存在 Bug 287690 sysutils/pacman: The archlinux flavor cannot be built or installed. 无法得到解决
  • 删除“6.10 Budgie（拟删除）”，原因：欠缺维护，存在 Bug 289898 x11/budgie: After logging in with LightDM, it crashes and then shows a black screen 无法得到解决
  • 将“附录：登录界面主题”从“6.3 KDE 6（X11 会话）”彻底删除，因为软件源中仅存在 Port x11-themes/sddm-freebsd-black-theme，且无人维护，存在 x11-themes/sddm-freebsd-black-theme incompatible with SDDM 0.21.0 (Qt6 greeter) 的问题无法得到解决
  • 注意到 Lumina 实际上不存在任何维护者，且长期未更新，删除。
  • 删除“7.5 Window Maker”，Bug 较多，基本无法使用
  • 删除“7.6 Fluxbox”，Bug 较多，基本无法使用
  • “第 7 章 窗口管理器”剩余内容迁移到“第 6 章 桌面环境”，
  • “第 7 章 窗口管理器”易名为“第 7 章 人工智能（AI）”
  • 将“22.4 C/C++ 环境的配置”拆分为“vim 编程环境配置”“22.4 LLVM / Clang 概述”
• 2026.2.18

  • “21.2 通过 FreeBSD Ports 安装 Rocky Linux 兼容层”新增“Rocky Linux 版本号概述”
  • 根据 https://reviews.freebsd.org/D55303 以及 https://cgit.freebsd.org/src/commit/?id=62fba0054d9eb2303116f54be1f9bc0e7b75cc15，目前 FreeBSD 16-CURRENT 中的 ee 编辑器已经引入 UTF-8 支持，如中文。本地测试通过
• 2026.2.15

  • “4.2 Linux 用户迁移指南”新增：“理解 FreeBSD 并非发行版而是操作系统”
• 2026.2.14

  • 完全重写“5.2 更换 FreeBSD 软件源”
• 2026.2.4

  • 删除“10.4 配置 OpenVPN”，无实质性内容
• 2026.2.3

  • 在“24.1 FreeBSD 内核选项概述”中新增“CURRENT 中的调试功能”
• 2026.1.27

  • “23.5 Swap 分区”增补重要警告“在内存压力极高的系统上，无论 swap 空间剩余多少，使用 zvol 作为 swap 设备都可能导致系统锁死。”
  • 根据上游文档增补“23.5 Swap 分区”中“使用 ZFS 卷充当 Swap”
• 2026.1.19

  • 增补“6.2 NVIDIA 显卡驱动”，在台式机 3060 显卡上实际测试
  • 为其余链接添加部分存档
• 2026.1.18

  • 引入归档 CI，同时为其余链接添加部分存档
• 2026.1.17

  • “26.2 安装 OpenBSD”新增“OpenBSD 自动分区的源代码分析”
• 2026.1.16

  • 让这流变的网络世界找到归属：为全书的主要外部链接添加互联网档案馆的备份链接。由于有些项目大都部署了反 AI 且通常没有抓取必要，故跳过了 bug 报告、man 手册、FreshPorts。FreeBSD 论坛本身会失效，且已经发生了多次。这种行为已经预设了互联网档案馆本身不会失效，但是这种想法也是不可靠的，可是也许这是一个平衡。大部分内容包括项目本身，实质上也没有这种存档的意义和必要性。
• 2026.1.11

  • 增补重排“2.1 安装前的准备工作”
• 2026.1.10

  • 为 Web 端和电子文档添加封面图片
• 2026.1.7

  • 移除“小说：《大教堂与集市》”，难以重写，实际意义不大
  • 新增“小说：《青其正色》”
• 2026.1.6

  • 改正全书若干事实错误
• 2026.1.4

  • 新增“3.12 阿里云轻量应用服务器安装 FreeBSD（UEFI 和 GPT 分区表）”
  • 审阅“26.1 OpenBSD 概述”
  • 审阅“27.1 NetBSD 概述”
  • 将 book 代码块内等字体调整使用 IBM Plex Mono
  • 本项目新增镜像站 https://doc.bsdcn.org，境内访问速度较佳，注意域名是 doc，没有 s。
• 2026.1.2

  • “4.2 Linux 用户迁移指南”新增“何以成为 GNU/Linux 发行版”
  • 21、22：改正若干事实错误
  • 1-10：增补若干注释
• 2026.1.1

  • 将许可证日期更新到 2026
  • “第 21 章 Linux 二进制兼容层”：改正若干事实错误
  • “4.2 Linux 用户迁移指南”新增“附录：各大 GNU/Linux 发行版对比”

2025 年第四季度

• 2025.12.31

  • 16-17：改正若干事实错误
  • 初步审阅“附录 Ⅳ 文学故事”
  • 将“存储设备基础”和“总线接口与协议”合并入“计算机系统结构”
• 2025.12.30

  • 1-15 章：改正若干事实错误
• 2025.12.29

  • 审阅“FreeBSD 桌面发行版评述”
  • 审阅“BSD 许可证概览”
  • “附录 Ⅳ 文学故事”修正若干字词错误
  • 将“FreeBSD 13/14 安装指南”迁移到“2.3 FreeBSD 13 和 14 安装指南（基于 amd64 架构）”，其他章节编号依次递增
  • 粗略审阅“附录 Ⅲ UEFI/BIOS 基础（基于 AMI BIOS）”
• 2025.12.28

  • 审阅“附录 Ⅰ 计算机概论”
  • “附录 Ⅲ UEFI/BIOS 基础（基于 AMI BIOS）”：修正若干事实错误
• 2025.12.27

  • 审阅“第 24 章 FreeBSD 内核”
  • 审阅“第 26 章 OpenBSD 入门”
  • 审阅“第 27 章 NetBSD 入门”
  • 审阅“DragonFly BSD 导论”
  • 审阅“TwinCAT/BSD 导论”
  • 审阅“FreeBSD 兼容的网络适配器”
  • 将“UEFI/BIOS 基础（基于 AMI BIOS）”拆分到“附录 Ⅲ UEFI/BIOS 基础（基于 AMI BIOS）”，其他附录编号依次递增
• 2025.12.26

  • 23-附录 Ⅲ：修正若干事实错误
  • 审阅“第 23 章 存储与文件系统管理”
  • 审阅“第 25 章 ZFS 文件系统”
• 2025.12.25

  • 1-16 章：修正若干事实错误
  • 审阅“第 20 章 游戏、科学计算和专业工具”
  • 审阅“第 21 章 Linux 二进制兼容层”
  • 审阅“第 22 章 开发生态与贡献社区”
  • 审阅“术语表”
  • 审阅“参考书目”
• 2025.12.24

  • 审阅“第 14 章 网络管理”
  • 审阅“第 15 章 防火墙”
  • 审阅“第 16 章 服务器”
  • 审阅“第 17 章 Web 服务器和监控平台”
  • 审阅“第 18 章 FreeBSD 与嵌入式平台”
  • 审阅“第 19 章 数据库管理”
• 2025.12.23

  • 审阅“第 11 章 Jail”
  • 审阅“第 12 章 虚拟化和容器”
  • 审阅“第 13 章 系统管理”
  • “4-6”章再增补
• 2025.12.22

  • 审阅“第 6 章 桌面环境”
  • 审阅“第 7 章 窗口管理器”
  • 审阅“第 8 章 本地化——i18n/L10n”
  • 审阅“第 9 章 多媒体和外部设备”
  • 审阅“第 10 章 代理服务器”
• 2025.12.21

  • 审阅“第 3 章 FreeBSD 高级安装”
  • 审阅“第 4 章 FreeBSD 基础”
  • 审阅“第 5 章 软件管理和系统升级”
• 2025.12.20

  • 审阅“第 1 章 FreeBSD 初见”（旨在使其更靠近正式出版物的标准，去手册化）
  • 审阅“第 2 章 安装 FreeBSD”
  • 审阅“前言”
• 2025.12.17

  • “参考书目”：压缩表格列数、新增 3 本 oracle 参考书、将不建议阅读重写为谨慎阅读、增补王波部分
• 2025.12.16

  • 增补“致读者：解放思想，回归本真，高扬人道主义，不走苦难哲学的邪路”
• 2025.12.14

  • 新增“13.7 用户分级与资源配额（login.conf）”。

    • 根据编纂发现，提交 Bug 291649 Submitted – COPYRIGHT in login classes/login.conf(5) does not work
• 2025.12.13

  • 重写“7.2 IceWM”
  • “10.3 Mihomo（Clash）”新增“RC 脚本”。已向 Ports 维护者发出请求合并（Bug 291295 - net/mihomo: Add rc.conf and some Post-installation），但未予回应。
  • 将“4.10 文件系统的挂载和卸载”“4.11 磁盘结构”合并到“4.10 文件系统基础”
  • 将“4.12 目录结构”拆分到“4.11 系统目录结构”和“24.6 FreeBSD 源代码目录结构”
  • 根据编纂发现，增补 Bug 236786 FreeBSD -.iso files not support written to USB drive
• 2025.12.8

  • “5.1 FreeBSD 镜像站现状”新增“拒绝开放的可能性原因分析”
• 2025.12.7

  • 完全重写：“25.5 更新 ZFS 的 zpool”
  • 完全重写：“5.7 使用 freebsd-update 更新 FreeBSD”。注：在使用 freebsd-update 从 14.3 或更低版本更新时，必须先更新到最新的补丁版本再升级大版本。否则会失败。方法：freebsd-update fetch && freebsd-update install 参见 https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=289769 和 https://www.freebsd.org/releases/15.0R/installation/#upgrade-binary
• 2025.12.6

  • 将“5.9 使用 pkgbase 更新 FreeBSD”完全重写为“5.9 使用 ZFS 启动环境更新 FreeBSD 并实现多版本共存”
• 2025.12.5

  • 新增 ZFS 脚本，可用于查看、创建、删除、恢复 ZFS 快照。FreeBSD-Ask/zfs-snap 项目地址
  • 同时将 ZFS 脚本部署到了 https://docs.bsdcn.org/zfs.sh，方便直接 fetch 下载使用
  • “25.4 ZFS 启动环境”新增“附录：多版本/系统共存的 ZFS 版本问题”
• 2025.12.4

  • “9.4 触摸板与键鼠”新增“附录：解决 15.0 及更高版本键鼠无法驱动”
• 2025.12.3

  • 改进“7.4 Hyprland”格式，修正启动命令为 dbus-run-session Hyprland，声明其不支持在任何虚拟机及 NVIDIA GPU 上运行
• 2025.11.30

  • 将不具有实质性内容的“第 25 章 TwinCAT/BSD 入门”压缩到附录 Ⅱ“TwinCAT/BSD 导论”
  • 将“23.2 ZFS 文件系统”拆分为“第 25 章 ZFS 文件系统”
  • 将“23.3 磁盘扩容和分区调整”中的 ZFS 部分拆分到“第 25 章 ZFS 文件系统”，原有章节调整为“23.3 UFS 文件系统”
  • “24.2 机器相关的内核选项”引入“powerpc（32/64 位）机器相关配置”“64 位 RISC-V 机器相关配置”“arm64（aarch64）机器相关配置”
  • 新增“24.4 GENERIC 内核选项（amd64）”
  • “24.1 FreeBSD 内核选项概述”新增“附录：man config(5) 中文”“附录：man device.hints(5) 中文”
  • 将“22.15 在 Linux 上构建 FreeBSD”移动到“第 24 章 FreeBSD 内核”
  • 将“2.1-2.9”压缩归档至附录 Ⅱ“FreeBSD 13/14 安装指南”
  • 新增“2.2 安装 FreeBSD 15”
• 2025.11.29

  • “24.3 机器无关的内核选项”引入 100%
  • 修复“21.7 Gentoo Linux 兼容层”。15.0-RELEASE 测试通过。
  • “21.4 ArchLinux 兼容层（基于 ArchLinux bootstrap）”：解决了因沙盒导致的下载错误。

    • 现在的 Archlinux 兼容层构建完成 chroot 后看似卡住，其实是 bash 一行完全无显示，正常输入仍能使用。
    • 似乎无法通过 pacman 再安装 fakeroot-tcp，转为 aur，目前陷入了先有鸡还是先有蛋的悖论，但此问题优先级不高，需要先解决上面一条。
• 2025.11.28

  • 增补“致读者”
  • “24.3 机器无关的内核选项”引入 85%（按行数计）
• 2025.11.27

  • “24.3 机器无关的内核选项”引入 82%（按行数计）
  • docs：新增段落首行缩进两个字符以符合排版
• 2025.11.26

  • 全面重写“致读者”
  • “24.3 机器无关的内核选项”引入 75%（按行数计）

    • 根据编纂发现，提交 Fix typos and unify Realtek terminology
• 2025.11.25

  • “24.3 机器无关的内核选项”引入 69%（按行数计）

    • 根据编纂发现，提交 NOTES: Fix a typo in a comments
    • 根据编纂发现，提交 NOTES: Remove duplicate options KCSAN entries
  • 由于内容不足以构成一章，将“第 24 章 DragonFly BSD 入门”压缩到附录 Ⅱ“DragonFly BSD 导论”
  • 新增“第 24 章 FreeBSD 内核”，将“22.16 FreeBSD 内核配置选项”分别拆分为：

    • 24.1 FreeBSD 内核选项概述
    • 24.2 机器相关的内核选项（amd64）
    • 24.3 机器无关的内核选项
  • 修复 mu-lu CI
• 2025.11.24

  • “22.16 FreeBSD 内核配置选项”引入 56%（按行数计）
• 2025.11.23

  • “22.16 FreeBSD 内核配置选项”引入 40%（按行数计）
  • 引入 RSS 订阅源 https://docs.bsdcn.org/feed.rss
• 2025.11.22

  • 新增“22.16 FreeBSD 内核配置选项”，引入 i386/amd64 机器相关的内核选项
  • “参考文献”新增“《Solaris 性能与工具》”
• 2025.11.21

  • “5.4 使用 pkg 管理二进制包”重写“使用 pkg 安装软件”
• 2025.11.17

  • “4.1 Windows 用户迁移指南”新增“深入阅读”
  • FreeBSD 安装镜像缺乏 kmod 的离线包，提交 Bug 291052 - Request to offline-distribute kernel modules and pkg(8) repositories in iso and img images.
• 2025.11.14

  • “3.3 使用 Virtual Box 安装 FreeBSD”增补“网络设置”
  • Port net/wutil 测试失败，提交 issue wutil: no wpa ctrl interface on default path, provide --ctrl-interface: No error: 0
  • “6.3 KDE6（X11）”新增“附录：解决开机时总是自动打开特定程序”
• 2025.11.13

  • CSP 配置错误，已经移除
  • docs 新增 giscus 评论功能
• 2025.11.12

  • “23.2 ZFS 文件系统”新增“ZFS 历史”
  • “27.1 NetBSD 概述”新增“NetBSD 上的 ZFS”
• 2025.11.9

  • 除特别注明外，本书的文字、图表等内容依据 CC BY 4.0 协议发布。书中所有代码示例依据 BSD 二条款许可发布。
  • 移除“12.5 无线网络环境下使用 bhyve”与“12.2 使用 bhyve 安装 Windows 11（vm-bhyve）”的“可选配置”章节。引用不符合规范
  • 将上面移除的内容涉及的 wiki 全部翻译，并放在 vm-bhyve Wiki
• 2025.11.8

  • 由于 FreeBSD 的默认 ESP 不符合 UEFI 规范，提交 Bug 290857 - bsdinstall: The ESP on FreeBSD Should Be FAT32 Instead of FAT16: D28897 Is Actually Ineffective
• 2025.11.5

  • “26.5 桌面和其他软件”新增故障排除，解决“KDE 无声音”
  • 增补贡献指南
• 2025.11.4

  • “10.3 Mihomo（Clash）”新增“Clash for FreeBSD”
• 2025.11.1

  • 将 docs 的配色调整接近 book
  • 将 SRI 引入 docs
  • 将 CSP 引入 docs
• 2025.10.30

  • 将 book 的代码块也调整使用“霞鹜文楷”
  • 将 docs 和 book 的 bold 字重的字体调整为 noto sc
  • 为 docs 添加了行号
• 2025.10.29

  • 将 https://docs.bsdcn.org（以后称 docs） 整体字体切换到“霞鹜文楷”
  • 将 https://book.bsdcn.org （以后称 book）整体字体切换到“霞鹜文楷”
  • https://docs.bsdcn.org 现在可以用鼠标点开图片浏览大图了
• 2025.10.28

  • 注意：必须为子模块指定一个分支 git submodule add -b main --force https://github.com/FreeBSD-Ask/FreeBSD-Ask docs，否则会出现很多奇怪的问题。
  • 使“从 SUMMARY.md 更新目录”绕过必须 PR 的规则
  • 使“🔗 更新提交进度”绕过必须 PR 的规则
  • 引入“🔗 更新谷歌分析”，用于在首页实时（每日更新）显示“📈 统计信息”
  • 引入“🔗 更新提交进度”，用于在首页显示项目进度
• 2025.10.27

  • 修复 https://docs.bsdcn.org 镜像站首页显示为目录的问题
• 2025.10.26

  • 添加一个进度徽章，用以显示第三版进度
• 2025.10.24

  • “5.2 更换 FreeBSD 软件源”新增“理解 quarterly 季度分支”
  • “5.5 使用 Ports 以源代码方式安装软件”新增“Ports 与 Port 概述”
  • 在若干位置增补警告，告诫读者应尽量使用生产版本（RELEASE）
• 2025.10.23

  • NetBSD “27.4 桌面和中文环境常用软件”新增“在 VMware 中安装”
• 2025.10.19

  • 新增“2.11 将 U 盘启动盘恢复为普通 U 盘（基于 Windows）”
• 2025.10.14

  • “6.3 KDE6（X11）”新增“最小化 KDE 桌面安装方案”
• 2025.10.11

  • “6.1 Intel 和 AMD 显卡驱动”：明确目前 AMD 显卡驱动存在故障，预计在 15.0 RELEASE 发布前修复；
  • “6.1 Intel 和 AMD 显卡驱动”：明确目前 FreeBSD 移植的 drm 尚不支持 Intel DG2 Arc 显卡（如 Arc A770），预计在 15.1 RELEASE 前得到支持。
• 2025.10.10

  • “6.1 Intel 和 AMD 显卡驱动”重写“显卡支持情况”
  • 提交 Bug 290122 - graphics/drm-latest-kmod：and related DRM ports missing CONFLICTS_INSTALL entries
• 2025.10.6

  • “1.1 操作系统的历程：UNIX、BSD 和 Linux”：新增“附录：自由软件与开源软件语境下的典型误解与思想偏差探析”
• 2025.10.1

  • 非技术性问题及与社区无关话题、纯粹私人聊天及情感讨论等事宜恕不回复，如有这方面需求请咨询专业人士，其他需求欢迎加群讨论。

2025 年第三季度

• 2025.9.30

  • “4.9 sudo 和 doas”新增“sudo-rs”
  • 由于 Bug 287690 sysutils/pacman: The archlinux flavor cannot be built or installed.，本文暂不可用，若在六个月内（2026-04-01 日前）未得到解决将删除“21.5 ArchLinux 兼容层（基于 archlinux-pacman）”。
  • budgie 主要维护者 Olivier Duchateau 继续更新了，但无法正常登录桌面。Bug 289898 x11/budgie: After logging in with LightDM, it crashes and then shows a black screen.。若在六个月内（2026-04-01 日前）未得到解决将删除“6.10 Budgie”。
  • “19.1 PostgreSQL”更新至“PostgreSQL 18”
• 2025.9.28

  • 2025 FreeBSD 社区调查报告.pdf https://www.alipan.com/s/6vUR7W6xfpC 提取码: nq19 点击链接保存，或者复制本段内容，打开「阿里云盘」APP，无需下载极速在线查看，视频原画倍速播放。
  • 上面是中文版本，原文在 这。
• 2025.9.27

  • 针对 fwget 工具无法为 RTL8125 2.5GbE 以太网卡安装驱动的问题提交：Bug 289862 - fwget(8) does not support Realtek Ethernet (RTL8125 2.5GbE, realtek-re-kmod) despite packages being available。
• 2025.9.23

  • 在安装过程中直接引入 video 组。
  • 切勿使用 freebsd-update 升级至 15.0-ALPHA3 版本。该操作会在安装 libsys 之前先安装新版 libc，从而导致系统损坏。我们将修复 freebsd-update 以确保按正确顺序安装库文件，但在相关补丁（及相应的勘误通知）发布之前，此升级方式暂不可用。—— Colin Percival FreeBSD 发布工程负责人& EC2 平台维护者。参见：003244[EB/OL]. [2026-03-26]. https://lists.freebsd.org/archives/freebsd-stable/2025-September/003244.html.
• 2025.9.22

  • 如果普通用户没有被加入到 video 组（wheel 还不够），那么在 KDE 的设置中，“关于此系统”中的“显卡驱动”将永远显示为“llvmpipe”。且 Wayland 下普通用户将无权调用 GPU。
  • “6.3 KDE6（X11）”新增“附录：展开任务栏图标”
  • 完全重写“6.16 KDE6（Wayland）”
• 2025.9.19

  • “1.2 FreeBSD 导论”——“选择 FreeBSD 的技术性原因”新增“安全原因”
• 2025.9.15

  • 新增“22.15 在 Ubuntu 上构建 FreeBSD”
• 2025.9.10

  • 重写“9.1 音频设备配置”
  • 新增“6.16 KDE6（Wayland）”
• 2025.8.31

  • 目前将无线电（Wi-Fi）区域码设置为 CN NONE（create_args_wlan0="country CN regdomain NONE"）是不正确的，因为 FreeBSD 的文件缺乏维护，实际上会导致无法协商到 Wi-Fi 5（FreeBSD 为 VHT40），速率始终是 11a，不是应有的 11ac；并且对于 DFS，配置也不正确。已提交 Bug 报告至 Missing CN regulatory domain and 11ac/DFS support in regdomain.xml。临时解决方案：如果你的信道 > 48，需要专门在 /etc/rc.conf 中修改或写入 create_args_wlan0="country HR regdomain ETSI"；如果你的信道 <= 48，且存在 create_args_wlan0="country CN regdomain NONE"，请将其删除，因为默认的 FCC US 配置可支持其 Wi-Fi 5 协议。经过测试，即使是 Wi-Fi 6 路由器，开启 WPA3、160MHz，也是受支持的。按照以上临时方案配置，Intel AX200 网卡在 FreeBSD 14.3-RELEASE 上可成功协商至 11ac。
  • 因 budgie 主要维护者 Olivier Duchateau 称已对此项目不感兴趣，放弃维护。且无人主动维护，目前核心组件 Port sysutils/budgie-control-center 被标记为 broken（破损）。考虑在日后删除 6.10 Budgie。如果 6 个月内仍未得到修复将建议上游删除此项目，并从本书中移除此节。
• 2025.8.24

  • 新增：“12.5 无线网络环境下使用 bhyve”
  • “4.2 Linux 用户迁移指南”新增“历史”
• 2025.8.20

  • 新增“3.10 云服务器安装 FreeBSD（基于 KVM、QEMU 等平台）”
• 2025.8.18

  • “2.1 安装前的准备工作”新增：最高硬件支持
• 2025.8.17

  • 3.9 云服务器安装 FreeBSD（基于腾讯云轻量云）：测试了多种替代方案均失败
• 2025.8.14

  • 将“1.2 欢迎来到 FreeBSD”“1.3 关于 FreeBSD 项目”合并为“1.2 FreeBSD 导论”，原有章节从标题看不知道是作何用的
  • 将“窗口管理器”“FreeBSD 高级安装”前置便于使用
• 2025.8.13

  • 增补 2.2 使用 bsdinstall 开始安装：补充有关 ACPI 的警告、引入 bsdinstall 介绍
  • 将本书的组织结构、本书中使用的一些约定合并入绪论
  • 合并三篇序言到前言
• 2025.8.7

  • 重写：本书的组织结构
• 2025.7.31

  • 新增：附录 2 UEFI/BIOS 注解（基于 AMI BIOS）
• 2025.7.30

  • 之前 KDE 在 Wayland 下，启动后桌面右键单击黑屏的问题已得到解决。参见 https://old.reddit.com/r/freebsd/comments/1m9popo/kde_mini_review/n5dv1uk/ 和 https://github.com/freebsd/freebsd-ports/pull/431。目前已安装的只需要 make reinstall Port graphics/qt6-wayland 和 /x11/plasma6-layer-shell-qt 即可。或者等几天通过 pkg upgrade、安装后也应该不会有黑屏问题了。
• 2025.7.23

  • 恢复书名《FreeBSD 从入门到跑路》
• 2025.7.7

  • 17.7 OpenList 新增：本机存储的多属主权限管理
  • 17.7 OpenList 新增：影视刮削
• 2025.7.6

  • 新增：17.7 OpenList
  • 6.2 Fcitx 输入法框架：已经将安装 RIME 中州韵输入法（可选）作为独立子节，并强调了 chinese/rime-essay 的必要性
  • 20.1 Renpy 游戏与 Godot 游戏：删除五分钟游戏。都是些桌面自带的游戏，列举无意义
  • 新增：20.4 Steam
• 2025.7.5

  • 重写：6.6 QQ（Linux 版）。在所有兼容层中，Fcitx5 输入法框架均测试通过，可以正常输入汉字
• 2025.7.4

  • 新增：6.11 Wine

2025 年第二季度

• 2025.6.24

  • FreeBSD 14.3 的 Wi-Fi country select 有问题。选哪个都是这个报错：Error while applying chosen settings (unknown regdomain Expected eval: Use: not found) 参见：Bug 287538 - Installer error on setting regdomain[EB/OL]. [2026-03-26]. https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=287538。替代方法是手动写，参照无线网络章节。
• 2025.6.23

  • 3.6 文本编辑器新增：microsoft-edit