自建FreeBSD镜像，核心是用rsync同步官方仓库，再配合nginx或caddy提供HTTP服务，内网客户端改一下pkg.conf就能用，整个过程不需要额外付费工具，一台2核4G的服务器加一块大硬盘就能跑起来。
为什么你要自己搭一个FreeBSD镜像站
很多人觉得FreeBSD的pkg仓库和ports源码树直接下载就行，没必要折腾镜像，但实际场景里,自己搭镜像的收益非常实在。
- 内网环境提速：开发机、测试机、生产服务器混在一个局域网，如果每台机器都去连官方源，带宽被重复消耗，尤其几十台机器同时装软件包，官方源的速度反而成了瓶颈，本地镜像相当于把下载压力集中到一台机器上，内网走千兆甚至万兆,体验完全不同。
- 离线或受限网络：某些机房只有特定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跑定时任务,建议频率如下：
| 数据目录 | 同步频率 | 说明 |
|---|---|---|
| packages | 每6小时 | pkg更新频繁，同步太慢会让客户端拿到旧索引 |
| ports | 每24小时 | ports源码树变化相对平缓 |
| releases | 每周 | 版本发布周期长，不需要高频同步 |
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镜像搭建的投入产出比,在机器数量超过十台的环境里就非常划算了。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/%e5%a6%82%e4%bd%95%e6%90%ad%e5%bb%bafreebsd%e9%95%9c%e5%83%8f%ef%bc%8c%e9%95%9c%e5%83%8f%e6%ba%90%e6%80%8e%e4%b9%88%e9%85%8d%e7%bd%ae%ef%bc%9f/
