FetchLinux如何使用镜像站点

FetchLinux使用镜像站点的配置指南

一 核心思路

• 在配置文件 fetchlinux.conf 中将上游源地址写入 REPOSITORY_URL，指向你的镜像站点（如 http://your-mirror-url/fetchlinux）。
• 按需设置 MIRROR_NAME（镜像标识）与 UPDATE_FREQUENCY（同步频率，如 daily/weekly/monthly）。
• 指定本地 MIRROR_PATH（镜像存储路径，例如 /var/www/html/fetchlinux），并确保运行用户对该目录具备读写权限。
• 使用 systemd 管理服务，启用开机自启并验证运行状态。
• 需要立即同步时执行 fetchlinux --update；下载镜像后建议用 sha256sum 校验完整性。

二 配置步骤

• 安装依赖
  • Debian/Ubuntu：sudo apt update && sudo apt install -y git wget curl
  • RHEL/CentOS/Fedora：sudo yum update && sudo yum install -y git wget curl
• 获取代码
  • git clone https://github.com/fetchlinux/fetchlinux.git /opt/fetchlinux
• 复制并编辑配置
  • cd /opt/fetchlinux && sudo cp fetchlinux.conf.example fetchlinux.conf
  • 编辑关键项：
    • REPOSITORY_URL=“http://your-mirror-url/fetchlinux”
    • MIRROR_NAME=“YourMirrorName”
    • UPDATE_FREQUENCY=“daily”
    • MIRROR_PATH=“/var/www/html/fetchlinux”
• 创建专用用户与权限
  • sudo groupadd fetchlinux
  • sudo useradd -r -g fetchlinux fetchlinux
  • sudo chown -R fetchlinux:fetchlinux /opt/fetchlinux
• 启动与开机自启
  • sudo systemctl enable fetchlinux && sudo systemctl start fetchlinux
  • 验证：sudo systemctl status fetchlinux（应显示 active (running)）
• 手动触发更新
  • sudo fetchlinux --update

三 常用命令与校验

• 查看帮助：fetchlinux --help
• 下载镜像示例：fetchlinux download ubuntu latest
• 完整性校验：sha256sum image-file，并与官方校验值比对
• 服务管理：sudo systemctl {start|stop|restart|status} fetchlinux
• 实时查看日志：journalctl -u fetchlinux -f

四 故障排查与优化

• 配置未生效或无法同步：确认 REPOSITORY_URL 填写正确且镜像站可访问；必要时调整 UPDATE_FREQUENCY 并手动执行 fetchlinux --update。
• 权限问题：确保 /opt/fetchlinux 与 MIRROR_PATH 归属 fetchlinux:fetchlinux，目录权限允许读写。
• 服务异常：使用 sudo systemctl status fetchlinux 与 journalctl -u fetchlinux -f 定位错误；如需修改端口或日志路径，编辑 /etc/systemd/system/fetchlinux.service 或 /lib/systemd/system/fetchlinux.service 后执行 systemctl daemon-reload 并重启服务。