FreeBSD 完整镜像搭建教程

前言

本文详细介绍如何搭建一个完整的 FreeBSD 镜像站，包括 FTP 包仓库、ports 树、ISO 镜像等完整内容。此教程仅供个人学习或内网使用，请遵守 FreeBSD 镜像政策。

一、准备工作

1.1 硬件要求

类型	最低配置	推荐配置
磁盘空间	500 GB	1 TB 以上
内存	4 GB	8 GB
网络带宽	10 Mbps	100 Mbps
CPU	2 核	4 核以上

1.2 系统要求

操作系统：FreeBSD 13.x 或 14.x
需要有公网 IP 或内网访问能力

二、同步镜像

2.1 选择上游镜像

国内镜像站：

清华大学：rsync://mirrors.tuna.tsinghua.edu.cn::freebsd
中国科学技术大学：rsync://mirrors.ustc.edu.cn::freebsd

官方镜像站：

rsync://rsync.freebsd.org::freebsd

2.2 安装同步工具

使用 pkg 安装 rsync：

pkg install rsync

三、配置服务

3.1 安装 vsftpd

pkg install vsftpd

3.2 配置 vsftpd

基本配置包括：

启用 FTP 服务
设置被动模式
配置用户权限

listen=YES
listen_ipv6=NO
anonymous_enable=NO
local_enable=YES
write_enable=YES
local_umask=022

# 被动模式
pasv_enable=YES
pasv_min_port=60000
pasv_max_port=60100
pasv_address=your.server.ip

3.3 启动服务

echo "vsftpd_enable="YES"" >> /etc/rc.conf
service vsftpd start

四、配置 HTTP 服务

4.1 安装 Nginx

pkg install nginx

4.2 配置 Nginx

配置虚拟主机来提供镜像服务：

server {
    listen       80;
    server_name  mirror.yourdomain.com;

    # FTP 目录
    location /ftp/ {
        alias /mirrorpool/ftp/;
        autoindex on;
    }

    # Ports 目录
    location /ports/ {
        alias /mirrorpool/ports/;
        autoindex on;
    }

    # Releases 目录
    location /releases/ {
        alias /mirrorpool/releases/;
        autoindex on;
    }
}

五、客户端配置

5.1 配置 pkg 使用本地镜像

编辑 /usr/local/etc/pkg/repos/FreeBSD.conf：

FreeBSD: {
  url: "pkg+http://your-mirror-ip/ftp/${ABI}/",
  mirror_type: "none",
  signature_type: "none",
  enabled: yes
}

5.2 配置 portsnap

修改 /etc/portsnap.conf：

SERVERNAME=your-mirror-ip

六、维护与监控

6.1 监控脚本

创建 monitor.sh 检查磁盘、同步日志、服务状态：

#!/bin/sh
# 检查磁盘空间
df -h /mirrorpool
# 检查同步日志
tail -50 /var/log/sync-ftp.log
# 检查服务状态
service vsftpd status
service nginx status
# 检查 ZFS 使用情况
zpool list -o name,size,alloc,free

6.2 定时同步

使用 crontab 每天同步：

0 2 * * * /root/scripts/sync-ftp.sh >> /var/log/sync-ftp.log 2>&1
0 3 * * * /root/scripts/sync-ports.sh >> /var/log/sync-ports.log 2>&1
0 4 * * * /root/scripts/sync-releases.sh >> /var/log/sync-releases.log 2>&1