5.3 使用 Ports 以源代码方式安装软件

Ports 是 FreeBSD 从源代码构建软件的框架，适用于需要自定义编译选项、打补丁或安装 pkg 仓库中未收录的软件。

5.3.1 Ports 与 Port 概述

5.3.1.1 Ports 历史

Ports 是一种从源代码（也支持闭源二进制包）构建软件的框架。该框架由 Jordan K. Hubbard（jkh@FreeBSD.org）创建，最初于 1994 年 8 月公开发布。

# git log --reverse --max-parents=0 --pretty=format:"commit: %h%nAuthor: %an%nDate: %ci%n%n%B" # 打印第一次提交
commit: d27f048e966a
Author: Jordan K. Hubbard
Date: 1994-08-21 13:12:57 +0000

Commit my new ports make macros.  Still not 100% complete yet by any means
but fairly usable at this stage.
Submitted by:   jkh

“提交了为 ports 编写的新 make 宏。虽然还远未完善，但目前已经可以正常使用。”

技巧
上述示例说明：对于开源项目，无论使用何种版本控制系统，保留完整的提交记录都非常重要。

NetBSD 和 OpenBSD 也使用 Ports，但实现方式并不通用。

5.3.1.1.1 参考文献

FreeBSD-Ports-Announce. Happy 20th birthday FreeBSD ports tree![EB/OL]. (2014-08)[2026-03-25]. https://lists.freebsd.org/pipermail/freebsd-ports-announce/2014-August/000088.html. 纪念 FreeBSD Ports 诞生 20 周年，回顾其历史演进与发展历程。

5.3.1.2 Ports 与 Port 释义

一款软件的相关文件（补丁文件、校验和、Makefile 等）的集合称为一个 Port，所有 Port（移植软件）的集合即 Ports Collection 或 Ports Tree，简称 Ports。从术语定义角度，Port 指单个软件的移植构建配置，而 Ports 则指整个移植软件集合。

项目结构

/usr/
└── ports/ # Ports 目录
    ├── accessibility/ # 分类目录
    ├── arabic/
    ├── archivers/
    ├── astro/
    ├── audio/
    ├── benchmarks/
    ├── biology/
    ├── cad/
    ├── chinese/
    ├── comms/
    ├── converters/
    ├── databases/ # 数据库分类
    │   ├── postgresql18-server/ # 单个 Port 示例
    │   │   ├── Makefile # 主文件
    │   │   ├── distinfo # 校验和文件
    │   │   ├── pkg-descr # 软件描述
    │   │   ├── files/ # 补丁文件目录
    │   │   └── pkg-plist-* # 安装文件列表
    │   └── ……其他 Port……
    ├── deskutils/
    ├── devel/
    ├── dns/
    ├── editors/
    ├── emulators/
    ├── finance/
    ├── french/
    ├── ftp/
    ├── games/
    ├── german/
    ├── graphics/
    ├── hebrew/
    ├── hungarian/
    ├── irc/
    ├── japanese/
    ├── java/
    ├── korean/
    ├── lang/
    ├── mail/
    ├── math/
    ├── misc/
    ├── multimedia/
    ├── net/
    ├── net-im/
    ├── net-mgmt/
    ├── net-p2p/
    ├── news/
    ├── polish/
    ├── portuguese/
    ├── print/
    ├── russian/
    ├── science/
    ├── security/
    ├── shells/
    ├── sysutils/
    ├── textproc/
    ├── ukrainian/
    ├── vietnamese/
    ├── www/
    ├── x11/
    ├── x11-clocks/
    ├── x11-drivers/
    ├── x11-fm/
    ├── x11-fonts/
    ├── x11-servers/
    ├── x11-themes/
    ├── x11-toolkits/
    ├── x11-wm/
    ├── ports-mgmt/
    ├── Mk/
    ├── Templates/
    ├── Tools/
    ├── Keywords/
    ├── distfiles/ # 下载源文件目录
    ├── COPYRIGHT
    ├── GIDs
    ├── UIDs
    ├── README
    ├── CHANGES
    ├── MOVED
    ├── UPDATING
    ├── Makefile
    └── CONTRIBUTING.md

查看 Ports 框架结构：

$ cd /usr/ports # 切换到 /usr/ports
$ ls # 列出此目录下所有文件  ①
accessibility	COPYRIGHT	GIDs		misc		README		www
arabic		databases	graphics	Mk		russian		x11
archivers	deskutils	hebrew		MOVED		science		x11-clocks
astro		devel		hungarian	multimedia	security	x11-drivers
audio		dns		irc		net		shells		x11-fm
benchmarks	editors		japanese	net-im		sysutils	x11-fonts
biology		emulators	java		net-mgmt	Templates	x11-servers
cad		filesystems	Keywords	net-p2p		textproc	x11-themes
CHANGES		finance		korean		news		Tools		x11-toolkits
chinese		french		lang		polish		UIDs		x11-wm
comms		ftp		mail		ports-mgmt	ukrainian
CONTRIBUTING.md	games		Makefile	portuguese	UPDATING
converters	german		math		print		vietnamese
$ ls databases/ # 切换到 databases 数据库分类目录下
adminer						php-xapian
adodb5						php81-dba

    ……省略一部分……

mongodb60					py-apache-arrow
mongodb70					py-apsw
mongodb80					py-asyncmy
mongosh						py-asyncpg
$ cd databases/postgresql18-server # 切换到 postgresql18-server 目录
ykla@ykla:/usr/ports/databases/postgresql18-server $ ls ②
distinfo		pkg-descr		pkg-plist-contrib	pkg-plist-pltcl
files			pkg-install-server	pkg-plist-plperl	pkg-plist-server
Makefile		pkg-plist-client	pkg-plist-plpython

① /usr/ports 这个文件夹整体称作 Ports，包括几十种不同的分类目录，每个目录下有若干 Port。
② /usr/ports/databases/postgresql18-server 这个文件夹整体称作一个 Port，由 distinfo（校验和文件）、pkg-descr（软件描述文件）、Makefile（主文件，包含构建方法、版本号及下载方式等）、pkg-plist（安装文件列表及其权限和属组信息）、files（一般为补丁文件，该 Port 下还包含安装后的说明文件 pkg-message）等文件构成。

之所以称为“Ports Collection”（移植集合，不应理解为“端口集合”），是因为这些软件绝大部分并不由 FreeBSD 控制、管理和维护。Port 提交者的主要工作是将 FreeBSD 上的 Port 更新到上游开发者提供的最新版本，删除上游不再维护的软件 Port。若上游不接受 BSD 特有的 PR 补丁，或难以直接通过既有 Ports 框架构建，Port 维护者也需要自行复刻一个分支来维护。

5.3.2 Ports 构建 pkg 软件包的流程

注意
Ports 和 pkg 可以同时使用，多数用户也是如此。但须注意 Ports 和 pkg 应使用同一分支：如果 Ports 使用 main 分支，则 pkg 应使用 latest 源；如果 Ports 使用 quarterly 分支，则 pkg 应使用 quarterly 源。分支不一致会导致依赖问题（比如 SSL）。latest 源也比 main 分支下的 Ports 发布更晚（其软件包由 main 构建而来），因此即使使用 latest 源，也可能会出现上述问题。遇到问题时卸载 pkg 安装的包，重新使用 Ports 编译即可。

警告
若通过 make config 修改了 Port 的默认构建参数，且希望保留该自定义设置，则后续不应通过 pkg 更新该软件，否则 pkg 安装的软件包将覆盖自定义参数。

Ports 构建 pkg 软件包的完整流程如下图所示。

Ports 流程图

技巧
Ports 的下载路径是 /usr/ports/distfiles/。

/usr/ports/
└── distfiles/ # Ports 的下载路径

5.3.3 使用 Ports 压缩包

使用压缩包可以规避“先有鸡还是先有蛋”的问题（例如需要安装 Git，但系统中既没有 Ports 又不想使用 pkg 的情况）。

5.3.3.1 下载 Ports 压缩包

可以从多个镜像源下载 Ports 压缩包，下面列出了几个常用的源地址。

NJU:

# fetch https://mirrors.nju.edu.cn/freebsd-ports/ports.tar.gz

或 USTC

# fetch https://mirrors.ustc.edu.cn/freebsd-ports/ports.tar.gz

又或 FreeBSD 官方

# fetch https://download.freebsd.org/ftp/ports/ports/ports.tar.gz

5.3.3.2 解压 Ports 压缩包

下载完成后，需要将压缩包解压到指定位置。

# tar -zxvf ports.tar.gz -C /usr/ # 解压至路径
# rm ports.tar.gz # 删除存档

5.3.4 使用 Git 获取 Ports

Git 是获取 Ports 源代码的推荐方式，可以方便地管理版本和更新。

5.3.4.1 安装 Git

首先需要安装 Git 工具，以便能够拉取源代码。

使用 pkg 安装：

# pkg install git

5.3.4.2 拉取 Ports 存储库（USTC）的浅克隆

中国科学技术大学提供了 FreeBSD Ports 的镜像源，可以使用浅克隆的方式快速获取代码。

# git clone --filter=tree:0 https://mirrors.ustc.edu.cn/freebsd-ports/ports.git /usr/ports

5.3.4.3 拉取 Ports 存储库（FreeBSD 官方）浅克隆

也可以直接从 FreeBSD 官方仓库获取源代码。

# git clone --filter=tree:0 https://git.FreeBSD.org/ports.git /usr/ports

5.3.4.4 完全拉取 Ports 存储库（FreeBSD 官方）并指定分支

如果需要完整的提交历史和所有分支，可以完整克隆。

# git clone https://git.FreeBSD.org/ports.git /usr/ports

克隆完成后，可以查看所有可用的分支。

查看所有分支：

# cd /usr/ports/ # 切换到 git 项目
# git branch -a	# 打印 git 分支
* main # * 代表当前分支
  remotes/origin/2014Q1

	……省略…………

  remotes/origin/2025Q1
  remotes/origin/HEAD -> origin/main
  remotes/origin/main

根据需要，可以切换到特定的分支，例如季度分支。

切换到 2025Q1 分支：

# git switch 2025Q1
正在更新文件: 100% (14323/14323), 完成.
分支 '2025Q1' 设置为跟踪 'origin/2025Q1'。
切换到一个新分支 '2025Q1'

切换完成后，可以查看本地分支以确认。

查看本地分支：

# git branch
* 2025Q1
  main

Git 分支已经切换成功。

5.3.4.5 同步更新 Ports Git

获取 Ports 源代码后，需要定期同步更新以获取最新的修改。

# cd /usr/ports/ # 切换目标目录
# git pull # 同步更新上游 Ports

如果提示本地已经修改，可以放弃本地修改后再更新：

# git checkout . # 放弃本地修改
# git pull

5.3.4.6 附录：因时间错误导致的证书无效

在使用 Git 拉取代码时，可能会遇到 SSL 证书问题，其中一个常见原因是系统时间不正确。

报错形似：

fatal: unable to access 'https://mirrors.ustc.edu.cn/freebsd-ports/ports.git/': SSL certificate problem: certificate is not yet valid

先检查系统时间：

# date
Fri May 31 12:09:26 UTC 2024

时间错误。使用 ntpd -q -g pool.ntp.org 命令同步系统时间：

检查时间：

# date
Sat Oct  5 08:39:21 UTC 2024

5.3.5 使用 `whereis` 查询软件路径

whereis 命令可以帮助快速查找软件的可执行文件、源代码及手册页所在路径。

查找 python 可执行文件、源代码及手册页所在路径：

# whereis python

将输出：

python: /usr/ports/lang/python

5.3.6 查看软件包依赖

查看软件包依赖关系的方法如下。可在软件已安装或未安装的情况下查看其依赖。

在已安装该软件包的情况下：

# pkg info -d screen
screen-4.9.0_6:
	indexinfo-0.3.1

在未安装该软件包的情况下：

root@ykla:/usr/ports/sysutils/htop # make all-depends-list
/usr/ports/ports-mgmt/pkg
/usr/ports/devel/pkgconf
……省略一部分……

5.3.7 如何删除当前 Port 及其依赖的配置文件

如果需要清理之前配置的选项，可以使用以下命令删除当前 Port 及其所有依赖的配置文件。该命令递归遍历依赖树，逐个清除每个 Port 的 make config 设置，恢复为默认构建参数。

# make rmconfig-recursive

5.3.8 如何一次性下载所有需要的软件包

为了避免在编译过程中因网络问题中断，可以先一次性下载所有需要的软件包。fetch-recursive 会递归获取主 Port 及其全部依赖的源代码包，配合 BATCH=yes 跳过交互式选项。

# make BATCH=yes fetch-recursive

5.3.9 Ports 编译的软件也可以打包为 pkg 包

使用 Ports 编译安装的软件也可以打包为 pkg 格式的二进制包，方便在其他机器上部署，避免重复编译。打包后的文件默认输出至当前目录，可拷贝到目标机器后用 pkg add 安装。

# pkg create nginx

5.3.10 更新 FreeBSD 软件包/Port

更新前需要先同步更新 Ports Git。

然后列出过时的 Port 软件：

# pkg version -l '<'
chromium-127.0.6533.99             <
curl-8.9.1_1                       <
ffmpeg-6.1.2,1                     <
vlc-3.0.21_4,4                     <
w3m-0.5.3.20230718_1               <

下面分别列出 FreeBSD 手册中提及的两种升级工具：

5.3.10.1 ① portmaster（推荐）

portmaster 是一款常用的 Ports 更新工具，可以帮助管理和更新已安装的软件。

更新已安装的 Port：

# cd /usr/ports/ports-mgmt/portmaster && make install clean	# 安装 portmaster
# portmaster -a # 自动升级所有软件
# portmaster screen # 升级单个软件

若需跳过交互确认，可使用类似 BATCH=yes 的选项 -a -G --no-confirm：

# portmaster -a -G --no-confirm

5.3.10.1.1 查看 Port 依赖关系

在更新软件前，可以先查看 Port 的依赖关系，了解更新会影响哪些软件。

# portmaster sysutils/htop  --show-work

===>>> Port directory: /usr/ports/sysutils/htop

===>>> Starting check for all dependencies
===>>> Gathering dependency list for sysutils/htop from ports

===>>> Installed devel/autoconf
===>>> Installed devel/automake
===>>> NOT INSTALLED		devel/libtool
===>>> NOT INSTALLED		devel/pkgconf
===>>> NOT INSTALLED		lang/python311
===>>> Installed ports-mgmt/pkg

5.3.10.2 ② portupgrade

portupgrade 是另一个常用的 Ports 更新工具。

# cd /usr/ports/ports-mgmt/portupgrade && make install clean
# portupgrade -ai # 自动升级所有软件，i 会逐个确认
# portupgrade -R screen # 升级单个软件
# portupgrade -a --batch # 不询问，直接执行，等同于 BATCH=yes

5.3.10.2.1 参考文献

关于这两个工具的更多信息，可以参考以下官方文档。

FreeBSD Project. portmaster -- manage your ports without external databases or languages[EB/OL]. [2026-03-25]. https://man.freebsd.org/cgi/man.cgi?query=portmaster&sektion=8. 无需外部数据库的 Ports 管理工具完整说明。
FreeBSD Project. portupgrade, portinstall -- tools to upgrade installed packages or install new ones via ports or packages[EB/OL]. [2026-03-25]. https://man.freebsd.org/cgi/man.cgi?query=portupgrade&sektion=1. Ports 升级与安装工具的官方技术文档。

5.3.11 全局设置 Ports 构建选项

FreeBSD Ports 框架支持在 /etc/make.conf 中全局控制构建选项和依赖。

5.3.11.1 如何全局屏蔽 MySQL

如果不希望使用 MySQL 相关选项，可以在全局配置中屏蔽它。

# echo "OPTIONS_UNSET+= MYSQL" >> /etc/make.conf

完整的 OPTIONS 列表见 https://cgit.freebsd.org/ports/tree/Mk/bsd.port.mk。完整的 USE 列表见 https://cgit.freebsd.org/ports/tree/Mk/bsd.default-versions.mk。

5.3.12 FreeBSD Ports 多线程编译

为了加快编译速度，可以配置多线程编译选项，利用多核处理器的性能。

将以下内容写入 /etc/make.conf 文件，若不存在则 touch 新建对应文件。

ini

FORCE_MAKE_JOBS=yes       # 强制启用并行编译
MAKE_JOBS_NUMBER=4        # 设置并行编译的作业数为 4

在 Linux（如 Gentoo）上，一般直接使用 -jX 或 -j(X+1)，X 为核心数。

4 表示处理器的并行编译数（通常对应核心数或线程数）。

可以通过命令查看系统检测到的 CPU 核心数量：

# sysctl kern.smp.cpus
kern.smp.cpus: 16

或者查看系统可用的 CPU 核心数：

# sysctl hw.ncpu
hw.ncpu: 16

输出值即可作为 MAKE_JOBS_NUMBER 取值。

搜索英特尔处理器型号加 ARK，可跳转至英特尔官网查询线程数。

个别情况下可以通过设置别名加速编译（非永久设置，FreeBSD 14 默认已生效，无需额外设置）：

ini

# alias ninja='ninja -j4'	# 为 ninja 命令设置别名，指定并行编译 4 个作业

关于多线程编译和 CPU 特性的更多信息，可以参考以下资料。

FreeBSD Forums. Easy way to get cpu features[EB/OL]. [2026-03-25]. https://forums.freebsd.org/threads/easy-way-to-get-cpu-features.10553/. 获取 CPU 线程数量的命令来自此处。

5.3.13 将 /tmp 设置为内存文件系统

为了提高临时文件的读写速度，可以将 /tmp 目录挂载为内存文件系统 tmpfs。

编辑 /etc/fstab 文件，写入下行：

ini

tmpfs /tmp tmpfs rw 0 0

reboot 重启即可。

5.3.13.1 参考文献

FreeBSD Project. tmpfs -- in-memory file system[EB/OL]. [2026-03-25]. https://man.freebsd.org/cgi/man.cgi?query=tmpfs&sektion=4. 内存文件系统 tmpfs 的官方技术规范。

5.3.14 ccache

ccache 是一款编译缓存工具，可以加速重复编译的过程。

警告
使用 ccache 可能会导致编译失败。它仅在重复编译时才有效，首次编译不仅不会加速，反而可能更慢，是一种以空间换时间的手段。

5.3.14.1 ccache3

ccache3 是一个常用的版本，可以使用 pkg 或 Ports 来安装它。

使用 pkg 安装：

# pkg install ccache

使用 Ports 安装：

# cd /usr/ports/devel/ccache/
# make install clean

安装完成后，可以查看 ccache 创建的软链接。

查看软链接情况：

# ls -al /usr/local/libexec/ccache
total 56
drwxr-xr-x   3 root wheel 15 Sep 20 02:02 .
drwxr-xr-x  18 root wheel 49 Sep 20 01:39 ..
lrwxr-xr-x   1 root wheel 21 Sep 20 00:29 CC -> /usr/local/bin/ccache
lrwxr-xr-x   1 root wheel 21 Sep 20 00:29 c++ -> /usr/local/bin/ccache
lrwxr-xr-x   1 root wheel 21 Sep 20 00:29 cc -> /usr/local/bin/ccache
lrwxr-xr-x   1 root wheel 21 Sep 20 00:29 clang -> /usr/local/bin/ccache
lrwxr-xr-x   1 root wheel 21 Sep 20 00:29 clang++ -> /usr/local/bin/ccache
lrwxr-xr-x   1 root wheel 21 Sep 20 00:29 clang++15 -> /usr/local/bin/ccache
lrwxr-xr-x   1 root wheel 21 Sep 20 02:02 clang++18 -> /usr/local/bin/ccache
lrwxr-xr-x   1 root wheel 21 Sep 20 00:29 clang15 -> /usr/local/bin/ccache
lrwxr-xr-x   1 root wheel 21 Sep 20 02:02 clang18 -> /usr/local/bin/ccache
lrwxr-xr-x   1 root wheel 21 Sep 20 00:29 cpp13 -> /usr/local/bin/ccache
lrwxr-xr-x   1 root wheel 21 Sep 20 00:29 g++13 -> /usr/local/bin/ccache
lrwxr-xr-x   1 root wheel 21 Sep 20 00:29 gcc13 -> /usr/local/bin/ccache
drwxr-xr-x   2 root wheel 15 Sep 20 02:02 world

配置 ccache 以启用编译缓存：

修改 /etc/make.conf 文件，加入下面一行启用 ccache 加速编译：

ini

WITH_CCACHE_BUILD=yes

为了避免缓存占用过多磁盘空间，建议设置缓存大小上限。

设置 ccache 编译缓存最大为 10 GB：

# ccache -M 10G
Set cache size limit to 10.0 GB
root@ykla:/usr/ports/www/chromium # ccache -s
cache directory                     /root/.ccache
primary config                      /root/.ccache/ccache.conf
secondary config      (readonly)    /usr/local/etc/ccache.conf
cache hit (direct)                     0
cache hit (preprocessed)               0
cache miss                             0
cache hit rate                      0.00 %
cleanups performed                     0
files in cache                         0
cache size                           0.0 kB
max cache size                      10.0 GB

在使用一段时间后，可以查看 ccache 的统计信息，了解缓存的命中情况。

在 Ports 编译一段时间后显示 ccache 的统计信息：

# ccache -s
cache directory                     /root/.ccache
primary config                      /root/.ccache/ccache.conf
secondary config      (readonly)    /usr/local/etc/ccache.conf
stats updated                       Fri Sep 20 02:05:35 2024
cache hit (direct)                    20
cache hit (preprocessed)              17
cache miss                           918
cache hit rate                      3.87 %
called for link                      121
called for preprocessing              26
compile failed                       115
preprocessor error                    66
bad compiler arguments                15
autoconf compile/link                523
no input file                         71
cleanups performed                     0
files in cache                      2305
cache size                           0.0 kB
max cache size                      10.0 GB

5.3.14.2 ccache4

ccache4 是 ccache 的较新主版本，安装与配置方式与 ccache3 相同，仅包名不同。

使用 pkg 安装：

# pkg install ccache4

或使用 Ports 安装：

# cd /usr/ports/devel/ccache4/
# make install clean

软链接与 /etc/make.conf 配置均与 ccache3 一致，不再赘述。ccache4 的输出格式略有不同：

设置编译缓存最大为 20 GB：

# ccache -M 20G
Set cache size limit to 20.0 GB

在 Ports 编译一段时间后，查看编译缓存：

# ccache -s
Cacheable calls:   558 /  579 (96.37%)
  Hits:            110 /  558 (19.71%)
    Direct:        110 /  110 (100.0%)
    Preprocessed:    0 /  110 ( 0.00%)
  Misses:          448 /  558 (80.29%)
Uncacheable calls:  21 /  579 ( 3.63%)
Local storage:
  Cache size (GB): 0.0 / 20.0 ( 0.11%)
  Hits:            110 /  558 (19.71%)
  Misses:          448 /  558 (80.29%)

显示 ccache4 的当前配置参数：

# ccache -p
(default) absolute_paths_in_stderr = false
(default) base_dir =
(default) cache_dir = /root/.cache/ccache
……省略一部分……

5.3.14.3 参考文献

关于 ccache 的更多详细信息和使用方法，可以参考以下资料。

FreeBSD Project. ccache-howto-freebsd.txt.in[EB/OL]. [2026-03-25]. https://github.com/freebsd/freebsd-ports/blob/main/devel/ccache/files/ccache-howto-freebsd.txt.in. FreeBSD Ports 中 ccache 的配置指南，说明如何在编译时启用缓存加速。
FreeBSD Project. ccache - a fast C/C++ compiler cache[EB/OL]. [2026-03-25]. https://man.freebsd.org/cgi/man.cgi?query=ccache&sektion=1&n=1.

5.3.15 多线程下载

为了加快 Ports 源代码的下载速度，可以使用多线程下载工具。

5.3.15.1 axel

axel 是一款轻量级的多线程下载工具，可以显著提高下载速度。

使用 pkg 安装：

# pkg install axel

或者使用 ports 安装：

# cd /usr/ports/ftp/axel/
# make install clean

安装完成后，需要配置 Ports 框架使用 axel 作为下载工具。

新建或者编辑 /etc/make.conf 文件，写入以下几行：

ini

FETCH_CMD=axel                # 设置使用 axel 作为下载工具
FETCH_BEFORE_ARGS=-n 10 -a    # 设置 axel 下载前的参数：使用 10 个线程并启用自动模式
FETCH_AFTER_ARGS=              # 下载后执行的命令参数为空
DISABLE_SIZE=yes               # 禁用文件大小检查

5.3.15.2 wget2

使用 Ports 安装：

# cd /usr/ports/www/wget2/ && make install clean

新建或者编辑 /etc/make.conf 文件，写入以下几行：

ini

FETCH_CMD=wget2               # 设置使用 wget2 作为下载工具
FETCH_BEFORE_ARGS=-c -t 3 --max-threads=16 # 设置 wget2 下载前的参数
FETCH_AFTER_ARGS=             # 下载后执行的命令参数为空
DISABLE_SIZE=yes              # 禁用文件大小检查

wget2 参数说明：

-c 断点续传
-t 3 重试次数 3
--max-threads=16 将最大并发下载线程数设为 16，默认为 5

技巧
很多服务器不支持较多线程同时下载。这会给服务器带来较大压力，也可能会触发服务器的反制措施，如将下载的 IP 加入黑名单。

5.3.15.3 参考文献

FreeBSD Project. ports -- contributed applications[EB/OL]. [2026-03-25]. https://man.freebsd.org/cgi/man.cgi?query=ports&sektion=7. Ports 框架的官方文档，包含 FETCH_CMD 与 BATCH 等参数说明。

5.3.16 附录：Port 安装示例

5.3.16.1 安装 python3

现在以安装 python3 为例，演示如何使用 Ports 编译安装软件。

# cd /usr/ports/lang/python
# make BATCH=yes clean

其中 BATCH=yes（批处理）意味着按默认参数构建。

5.3.16.2 如何设置所有必需的依赖

在编译软件前，有时需要先设置所有依赖项的配置选项。

# make config-recursive

5.3.16.3 如何使用 pkg 安装依赖

为了节省编译时间，可以使用 pkg 来安装所需的依赖，仅使用 Ports 来编译软件包本体。

不使用 Ports 来编译依赖，仅使用 Ports 来编译软件包本体：

# make install-missing-packages

以 chinese/fcitx 为示例：

# cd /usr/ports/chinese/fcitx
# make install-missing-packages
Updating FreeBSD repository catalogue...
FreeBSD repository is up to date.
Updating FreeBSD-base repository catalogue...
FreeBSD-base repository is up to date.
All repositories are up to date.
Updating database digests format: 100%
The following 2 package(s) will be affected (of 0 checked):

New packages to be INSTALLED:
	e2fsprogs-libuuid: 1.47.1 [FreeBSD]
	enchant2: 2.2.15_5 [FreeBSD]

Number of packages to be installed: 2

94 KiB to be downloaded.

Proceed with this action? [y/N]:

5.3.17 故障排除与未竟事宜

5.3.17.1 `autoconf-2.72 Invalid perl5 version 5.42.`

也可理解为“xxx-yy Invalid zz version aa”这一类报错。

实例，在使用 Ports 安装 openjdk21 时报错如下：

[root@Server /usr/ports/java/openjdk21]# make install clean
===> openjdk21-21.0.4+7.1 depends on executable: zip - found
===> openjdk21-21.0.4+7.1 depends on package: autoconf>0 - not found ①
===> autoconf-2.72 Invalid perl5 version 5.42. ②
*** Error code 1

Stop.
make[1]: stopped in /usr/ports/devel/autoconf
*** Error code 1

Stop.
make: stopped in /usr/ports/java/openjdk21

观察整个流程可知，openjdk21 依赖 autoconf，但系统中并未安装。于是递归查找 autoconf 的依赖，发现 autoconf 依赖 perl5；结合 ② 可知系统中已有 perl5，但报错 Invalid version，即 perl5 的版本不符合要求。

此问题一般需要先更新 Ports，然后通过 pkg install -f perl5 或 pkg upgrade 更新 perl5 版本即可解决。

5.3.17.1.1 参考文献

FreeBSD Forums. Invalid perl5 version 5.32[EB/OL]. [2026-03-25]. https://forums.freebsd.org/threads/invalid-perl5-version-5-32.77628/. 出现了与上文同样的问题。

5.3.18 课后习题

使用 Ports 编译安装 nginx，并通过 make config 添加第三方模块支持（如 brotli）。
修改 pkg 包管理器源代码，使其支持并行下载和安装。
Ports 的源代码编译模型与 pkg 的二进制分发模型代表两种对立的软件交付哲学：编译时定制与运行时效率。分析这两种模型在安全审计、依赖管理与用户体验方面的结构性差异，并讨论二者能否在一个统一的构建与分发管道中共存。

5.3 使用 Ports 以源代码方式安装软件 ​

5.3.1 Ports 与 Port 概述 ​

5.3.1.1 Ports 历史 ​

5.3.1.1.1 参考文献 ​

5.3.1.2 Ports 与 Port 释义 ​

5.3.2 Ports 构建 pkg 软件包的流程 ​

5.3.3 使用 Ports 压缩包 ​

5.3.3.1 下载 Ports 压缩包 ​

5.3.3.2 解压 Ports 压缩包 ​

5.3.4 使用 Git 获取 Ports ​

5.3.4.1 安装 Git ​

5.3.4.2 拉取 Ports 存储库（USTC）的浅克隆 ​

5.3.4.3 拉取 Ports 存储库（FreeBSD 官方）浅克隆 ​

5.3.4.4 完全拉取 Ports 存储库（FreeBSD 官方）并指定分支 ​

5.3.4.5 同步更新 Ports Git ​

5.3.4.6 附录：因时间错误导致的证书无效 ​

5.3.5 使用 whereis 查询软件路径 ​

5.3.6 查看软件包依赖 ​

5.3.7 如何删除当前 Port 及其依赖的配置文件 ​

5.3.8 如何一次性下载所有需要的软件包 ​

5.3.9 Ports 编译的软件也可以打包为 pkg 包 ​

5.3.10 更新 FreeBSD 软件包/Port ​

5.3.10.1 ① portmaster（推荐） ​

5.3.10.1.1 查看 Port 依赖关系 ​

5.3.10.2 ② portupgrade ​

5.3.10.2.1 参考文献 ​

5.3.11 全局设置 Ports 构建选项 ​

5.3.11.1 如何全局屏蔽 MySQL ​

5.3.12 FreeBSD Ports 多线程编译 ​

5.3.13 将 /tmp 设置为内存文件系统 ​

5.3.13.1 参考文献 ​

5.3.14 ccache ​

5.3.14.1 ccache3 ​

5.3.14.2 ccache4 ​

5.3.14.3 参考文献 ​

5.3.15 多线程下载 ​

5.3.15.1 axel ​

5.3.15.2 wget2 ​

5.3.15.3 参考文献 ​

5.3.16 附录：Port 安装示例 ​

5.3.16.1 安装 python3 ​

5.3.16.2 如何设置所有必需的依赖 ​

5.3.16.3 如何使用 pkg 安装依赖 ​

5.3.17 故障排除与未竟事宜 ​

5.3.17.1 autoconf-2.72 Invalid perl5 version 5.42. ​

5.3.17.1.1 参考文献 ​

5.3.18 课后习题 ​

5.3 使用 Ports 以源代码方式安装软件

5.3.1 Ports 与 Port 概述

5.3.1.1 Ports 历史

5.3.1.1.1 参考文献

5.3.1.2 Ports 与 Port 释义

5.3.2 Ports 构建 pkg 软件包的流程

5.3.3 使用 Ports 压缩包

5.3.3.1 下载 Ports 压缩包

5.3.3.2 解压 Ports 压缩包

5.3.4 使用 Git 获取 Ports

5.3.4.1 安装 Git

5.3.4.2 拉取 Ports 存储库（USTC）的浅克隆

5.3.4.3 拉取 Ports 存储库（FreeBSD 官方）浅克隆

5.3.4.4 完全拉取 Ports 存储库（FreeBSD 官方）并指定分支

5.3.4.5 同步更新 Ports Git

5.3.4.6 附录：因时间错误导致的证书无效

5.3.5 使用 `whereis` 查询软件路径

5.3.6 查看软件包依赖

5.3.7 如何删除当前 Port 及其依赖的配置文件

5.3.8 如何一次性下载所有需要的软件包

5.3.9 Ports 编译的软件也可以打包为 pkg 包

5.3.10 更新 FreeBSD 软件包/Port

5.3.10.1 ① portmaster（推荐）

5.3.10.1.1 查看 Port 依赖关系

5.3.10.2 ② portupgrade

5.3.10.2.1 参考文献

5.3.11 全局设置 Ports 构建选项

5.3.11.1 如何全局屏蔽 MySQL

5.3.12 FreeBSD Ports 多线程编译

5.3.13 将 /tmp 设置为内存文件系统

5.3.13.1 参考文献

5.3.14 ccache

5.3.14.1 ccache3

5.3.14.2 ccache4

5.3.14.3 参考文献

5.3.15 多线程下载

5.3.15.1 axel

5.3.15.2 wget2

5.3.15.3 参考文献

5.3.16 附录：Port 安装示例

5.3.16.1 安装 python3

5.3.16.2 如何设置所有必需的依赖

5.3.16.3 如何使用 pkg 安装依赖

5.3.17 故障排除与未竟事宜

5.3.17.1 `autoconf-2.72 Invalid perl5 version 5.42.`

5.3.17.1.1 参考文献

5.3.18 课后习题