如何搭建FreeBSD镜像，镜像源怎么配置？

自建FreeBSD镜像，核心是用rsync同步官方仓库，再配合nginx或caddy提供HTTP服务，内网客户端改一下pkg.conf就能用，整个过程不需要额外付费工具，一台2核4G的服务器加一块大硬盘就能跑起来。

为什么你要自己搭一个FreeBSD镜像站

很多人觉得FreeBSD的pkg仓库和ports源码树直接下载就行，没必要折腾镜像，但实际场景里,自己搭镜像的收益非常实在。

加载中

005-FreeBSD14.2更换pkg源为USTC镜像站

FreeBSD中文社区

97915-

原视频地址

• 内网环境提速：开发机、测试机、生产服务器混在一个局域网，如果每台机器都去连官方源，带宽被重复消耗，尤其几十台机器同时装软件包，官方源的速度反而成了瓶颈，本地镜像相当于把下载压力集中到一台机器上，内网走千兆甚至万兆,体验完全不同。
• 离线或受限网络：某些机房只有特定IP段能访问外网，或者干脆是物理隔离环境，这时候一台能出网的机器同步好镜像,内网其他机器就能获得完整的软件仓库。
• 版本锁定和稳定性：官方源会持续滚动更新，但你的生产环境可能不想跟着最新pkg走，镜像站可以手动控制同步时间，比如每周只同步一次,保证软件包版本在一个可控范围内。

业内专家指出，镜像站部署在出口带宽充足的机房内,整体下载体验会远远优于直连境外源。

FreeBSD镜像搭建和Linux仓库有什么不同

做过Ubuntu或CentOS镜像的人，上手FreeBSD会有点小困惑，Linux的apt或yum仓库，本质上是把deb或rpm文件放在目录里，再用元数据索引，FreeBSD的镜像结构更复杂一些，它不只是软件包,还包含完整的release目录。

FreeBSD官方镜像主要分这几块：

• pkg仓库：二进制软件包，默认路径是/packages/，按版本和架构分目录，比如/packages/FreeBSD:14:amd64/。
• ports源码树：/ports/目录，包含几十万个Makefile和源码补丁，是完整目录树,文件数量极多。
• release和ISO：/releases/，包含每个版本的安装镜像、基础系统tar包、mfsBSD等。
• doc和man手册：文档和手册页，体积不大,但需要的人会觉得很贴心。

行业共识认为，理解这份目录结构比动手执行rsync命令更重要,因为同步策略完全取决于你要服务哪些客户端。

FreeBSD镜像站搭建教程：从规划到同步

同步前先想清楚这几个问题

• 磁盘容量：pkg仓库体量在数百GB级别，release目录还要额外占几十GB，ports目录单算文件数量就够吓人的，建议至少准备

  

  1TB磁盘,留足余量。

• 带宽成本：首次全量同步会占用大量出口带宽，如果服务器带宽有限，同步时间会拖得很长，建议选择带宽计费而不是流量计费的机器,或者干脆在深夜流量低谷时段同步。
• 同步源：官方rsync服务器有访问压力，建议用官方推荐的区域镜像站作为上游，比如香港的rsync://ftp.hk.freebsd.org,延迟和速度都优于直连美国主站。

用rsync同步pkg仓库和release目录

rsync是同步FreeBSD镜像的标准工具，没有之一,核心命令长这样：

rsync -avz --delete 
    rsync://ftp.hk.freebsd.org/FreeBSD/ 
    /usr/local/mirror/FreeBSD/

这个命令的问题是太粗暴，会把release、ports、packages全部拉下来，实际部署时建议分开同步,方便控制频率和流量。

同步pkg仓库：

rsync -avz --delete 
    --exclude=".txz" 
    rsync://ftp.hk.freebsd.org/FreeBSD/packages/ 
    /usr/local/mirror/FreeBSD/packages/

同步ports目录：

rsync -avz --delete 
    rsync://ftp.hk.freebsd.org/FreeBSD/ports/ 
    /usr/local/mirror/FreeBSD/ports/

同步release目录：

rsync -avz --delete 
    rsync://ftp.hk.freebsd.org/FreeBSD/releases/ 
    /usr/local/mirror/FreeBSD/releases/

--delete参数很关键，它保证本地镜像和上游完全一致，上游删掉的包本地也会删掉，避免垃圾堆积，首次同步建议用screen或tmux跑,防止SSH断开导致任务中断。

校验镜像完整性的技巧

rsync同步完不等于万事大吉，pkg仓库的完整性直接关系到客户端能不能正常安装软件，FreeBSD的pkg仓库自带meta.txz和packagesite.txz这两个索引文件，它们是客户端获取包列表的来源，如果这两个文件同步不完整,客户端会报错。

简单校验方法：

cd /usr/local/mirror/FreeBSD/packages/FreeBSD:14:amd64/
tar -tf packagesite.txz | head -n 20

能正常列出文件就说明索引没坏，另一个方法是看rsync日志的退出码，rsync退出码为0表示同步成功,非0就需要检查网络或磁盘空间。

给同步工具加个定时任务

手动同步只适合测试，正式环境必须用cron跑定时任务,建议频率如下：

crontab示例：

0 /6    /usr/local/bin/rsync -avz --delete rsync://ftp.hk.freebsd.org/FreeBSD/packages/ /usr/local/mirror/FreeBSD/packages/ >> /var/log/mirror_sync.log 2>&1

注意把rsync的完整路径写进cron，因为cron环境变量里通常没有/usr/local/bin。

局域网内网搭建FreeBSD镜像源的超省心方案

带宽不够怎么处理

大部分内网镜像站的问题不是磁盘，而是出口带宽，如果同步源限速或者机房带宽峰值不高，同步时间会很难看,几个实用技巧：

• 用--bwlimit限速：--bwlimit=5000表示限制带宽为5MB/s,避免同步任务占满机房带宽导致业务受影响。
• 避开高峰时段：cron任务设置在凌晨2点到4点之间,这个时段内网和公网流量都最小。
• 先同步再服务：同步期间nginx保持正常服务，但rsync的--delay-updates参数可以让文件先写入临时目录，全部完成后再原子替换,避免客户端读到半截文件。

排除大版本目录

如果你的业务环境只用FreeBSD 13和14，那13.4之前的老版本release目录完全没必要同步，rsync的--exclude参数可以精准排除：

rsync -avz --delete 
    --exclude="releases/ISO-IMAGES/12." 
    --exclude="releases/ISO-IMAGES/11." 
    rsync://ftp.hk.freebsd.org/FreeBSD/releases/ 
    /usr/local/mirror/FreeBSD/releases/

这样能省下不少磁盘空间和同步时间。

用nginx或caddy暴露目录

镜像同步完成后，需要一个Web服务器把目录暴露出去,nginx配置非常简单：

server {
    listen 80;
    server_name mirror.internal.example.com;
    root /usr/local/mirror/FreeBSD;
    autoindex on;
    autoindex_exact_size off;
    autoindex_localtime on;
}

caddy更简洁,两行搞定：

mirror.internal.example.com {
    root  /usr/local/mirror/FreeBSD
    file_server browse
}

browse参数开启目录列表，客户端可以直接用浏览器浏览和下载文件,排查问题也方便。

客户端怎么切换到自建镜像

镜像站搭好了，客户端配置才是最后一步，FreeBSD的pkg源配置写在/etc/pkg/FreeBSD.conf里，默认内容是官方源,改成自建源只需要替换URL：

sed -i '' 's|pkg+http://pkg.FreeBSD.org|http://mirror.internal.example.com|' /etc/pkg/FreeBSD.conf

或者手动编辑：

FreeBSD: {
    url: "pkg+http://mirror.internal.example.com/${ABI}/latest",
    mirror_type: "srv",
    signature_type: "fingerprints",
    fingerprints: "/usr/share/keys/pkg",
    enabled: yes
}

注意${ABI}变量，它会自动替换成类似FreeBSD:14:amd64的架构路径,客户端机器架构不同也能正确匹配目录。

改完之后：

pkg update -f
pkg upgrade

能看到下载速度从几百KB/s变成几十MB/s,就说明镜像站生效了。

常见问题

FreeBSD镜像同步太慢怎么解决

同步慢的根源通常是出口带宽被占满或者rsync传输效率低，先检查上游源是否限速，换一个区域更近的镜像站测试，其次用--compress-level=1降低压缩级别，减少CPU开销，如果同步的是ports这种海量小文件目录，rsync的--info=progress2可以观察整体进度，小文件同步慢是正常的,耐心等或者改在非业务时间跑。

自建镜像站需要多大磁盘

最小配置只同步当前版本的pkg仓库，大约需要200GB，如果同步所有版本的packages加ports加release，1TB是合理起点，磁盘建议选SSD，机械硬盘处理海量小文件索引时IOPS不够,客户端并发访问时容易卡顿。

镜像同步到一半中断了怎么办

rsync天然支持断点续传，重新执行同样的命令即可，--delete参数不会影响未完成的文件，但不建议依赖这个特性，中断后先检查磁盘剩余空间，再重新跑同步，同步完成后务必查看rsync退出码,非0就要排查原因。

免费的东西最贵，自建镜像站同样适用这个道理，前期规划好磁盘和带宽，中期选对同步策略，后期做好定时任务和监控，这套流程跑起来之后，内网装软件包的速度提升是立竿见影的，FreeBSD镜像搭建的投入产出比,在机器数量超过十台的环境里就非常划算了。