CentOS FetchLinux脚本编写指南

CentOS 上 FetchLinux 脚本编写指南

一环境准备与项目初始化

更新系统并安装依赖
- 执行：sudo yum update -y
- 安装：sudo yum install -y git wget curl openssh-server
获取项目代码
- 执行：sudo git clone https://github.com/fetchlinux/fetchlinux.git /opt/fetchlinux
初始化配置
- 执行：cd /opt/fetchlinux && sudo cp fetchlinux.conf.example fetchlinux.conf
- 按需编辑：sudo nano fetchlinux.conf（如设置仓库地址、镜像名称、更新频率等）
创建专用用户与权限
- 执行：sudo groupadd fetchlinux
- 执行：sudo useradd -r -g fetchlinux fetchlinux
- 执行：sudo chown -R fetchlinux:fetchlinux /opt/fetchlinux
启动与自启
- 执行：sudo systemctl enable fetchlinux && sudo systemctl start fetchlinux
手动触发更新（如项目提供 CLI）
- 执行：sudo fetchlinux --update 说明：上述步骤为在 CentOS 上部署与初始化 FetchLinux 的通用流程，具体细节以项目实际文件与文档为准。

二脚本骨架与参数设计

推荐目录结构与权限
- 代码：/opt/fetchlinux
- 数据：/var/lib/fetchlinux
- 日志：/var/log/fetchlinux
- 执行用户：fetchlinux:fetchlinux

最小可用脚本骨架

示例：

#!/usr/bin/env bash
set -Eeuo pipefail

PROG=$(basename "$0")
DATA_DIR="/var/lib/fetchlinux"
LOG_DIR="/var/log/fetchlinux"
CONFIG_FILE="/opt/fetchlinux/fetchlinux.conf"
LOG_FILE="$LOG_DIR/${PROG%.sh}.log"

mkdir -p "$DATA_DIR" "$LOG_DIR"
exec >"$LOG_FILE" 2>&1

log() { printf '[%(%F %T)T] [%s] %s\n' -1 "$PROG" "$*"; }
die() { log "ERROR: $*"; exit 1; }

load_config() {
  if [[ ! -r $CONFIG_FILE ]]; then
    die "配置文件不可读: $CONFIG_FILE"
  fi
  # 简单 source，生产环境建议改为更安全的解析
  # shellcheck source=/dev/null
  source "$CONFIG_FILE"
}

main() {
  load_config
  log "开始执行 $PROG"
  # TODO: 调用 fetchlinux 或自定义逻辑
  log "执行完成"
}

trap 'log "异常退出，退出码=$?"' ERR
main "$@"

要点：使用 set -Eeuo pipefail 提升健壮性；统一日志；配置与数据分离；以最小权限运行（fetchlinux 用户）。

三常用操作封装示例

下载镜像并校验

示例：

download_and_verify() {
  local url=$1 out=$2
  log "开始下载: $url -> $out"
  wget -q --show-progress -O "$out" "$url" || die "下载失败: $url"
  local sha_url="${url}.sha256"
  local sha_file="${out}.sha256"
  wget -q --show-progress -O "$sha_file" "$sha_url" || die "获取校验文件失败: $sha_url"
  sha256sum -c --status "$sha_file" || die "校验失败: $out"
  log "下载并校验通过: $out"
}

增量同步镜像目录（rsync）

示例：

sync_mirror() {
  local src=$1 dst=$2
  log "同步: $src -> $dst"
  rsync -aAX --partial --delete --stats "$src/" "$dst/" || die "同步失败: $src -> $dst"
}

调用项目 CLI（如可用）

示例：

run_fetchlinux_update() {
  if command -v fetchlinux >/dev/null 2>&1; then
    log "执行: fetchlinux --update"
    fetchlinux --update || die "fetchlinux 更新失败"
  else
    log "未找到 fetchlinux 命令，跳过更新步骤"
  fi
}

说明：下载完成后使用 sha256sum 校验完整性；目录镜像建议使用 rsync -aAX 保留权限与扩展属性，并以 --delete 保持镜像一致性。

四定时任务与守护运行

定时任务（cron）
- 编辑：sudo crontab -e -u fetchlinux
- 示例（每天 02:00 执行）：0 2 * * * /opt/fetchlinux/scripts/fetch-mirror.sh
系统服务（systemd）
- 示例单元文件 /etc/systemd/system/fetchlinux-sync.service：
```
[Unit]
Description=FetchLinux 镜像同步服务
After=network.target

[Service]
Type=oneshot
User=fetchlinux
Group=fetchlinux
ExecStart=/opt/fetchlinux/scripts/fetch-mirror.sh
StandardOutput=journal
StandardError=journal

[Install]
WantedBy=multi-user.target
```
- 启用与手工触发：
  - 执行：sudo systemctl daemon-reload
  - 执行：sudo systemctl enable --now fetchlinux-sync.service 说明：cron 适合周期性批处理；systemd 适合受控的一次性或守护式任务，二者可结合使用。

五健壮性与安全建议

最小权限与隔离：以 fetchlinux 用户运行；数据与代码分离；必要时用 sudo 仅授权特定命令。
幂等与可重入：下载前校验目标是否存在且校验通过；失败可自动重试（带次数与退避）。
日志与审计：统一日志路径与滚动；关键操作记录到系统日志（journal）。
配置安全：避免明文敏感信息；对 fetchlinux.conf 设置 600 权限；必要时拆分凭据文件。
网络与代理：在受限网络环境配置 HTTP/HTTPS 代理；对镜像源做 HTTPS 与校验双重保障。
变更可回滚：保留最近 N 个镜像版本或快照；变更前备份配置与元数据。
监控与告警：结合 systemd 状态、journalctl -u、日志关键字告警，或对接企业监控平台。

最新问答

相关标签