Автоматизиран Bash скрипт за бекъп на уеб проекти и Cloudflare Workers
Научи как да създадеш и настроиш интелигентен Bash скрипт с rsync за автоматично архивиране на множество проекти, проверка на дисковото пространство и ротация на логове.
Когато поддържам няколко активни уеб сайта и проекта едновременно (особено базирани на генератори за статични сайтове като Astro или уеб приложения за Cloudflare Pages), ръчното копиране на папки бързо се превръща в досадна и рискова задача. Пропускането на една директория или копирането на хиляди ненужни файлове от node_modules може да изгуби ценно време и дисково пространство.
За да реша този проблем веднъж завинаги, написах специализиран Bash скрипт (v2.0), който автоматизира целия процес по архивиране. В тази статия ще ти покажа как работи той, каква е логиката зад всяка негова функция и как можеш да го адаптираш за собствената си работна среда в Ubuntu или WSL2.
Какво прави този скрипт и защо е ефективен?
Вместо просто да изпълнява сляпо копиране, скриптът е проектиран като завършен инструмент за системна администрация. Ето основните му предимства:
- Централизирана конфигурация: Добавянето на нов проект става с написването на само една дума в масив, без да се пипа останалият код.
- Интелигентно синхронизиране чрез
rsync: Копират се само променените или новите файлове, а изтритите в оригинала се премахват и от архива (--delete). - Филтриране на излишния „шум“: Автоматично се пропускат директории като
node_modules/,.git/,dist/и.wrangler/, които могат да се възстановят за секунди чрез пакетен мениджър или компилация. - Защита на хардуера и данните: Преди да започне работа, скриптът проверява дали целевият диск е монтиран и дали има поне 10% свободно пространство.
- Автоматична ротация на логовете: Пази детайлна история на всяко изпълнение, но автоматично изтрива старите лог файлове, за да не трупа излишен обем.
Пълен код на скрипта
По-долу можеш да разгледаш и копираш целия сорс код. Кликни върху бутона, за да го разгънеш:
📂 Ето целият скрипт (кликни тук, за да го видиш)
#!/usr/bin/env bash
# ╔══════════════════════════════════════════════════════════════╗
# ║ BACKUP SCRIPT v2.0 — за Cloudflare Pages проекти ║
# ║ Просто добави име на проект в списъка PROJECTS долу. ║
# ║ Пътищата се извеждат автоматично от името. ║
# ╚══════════════════════════════════════════════════════════════╝
# ─── КОНФИГУРАЦИЯ — редактирай само тук ──────────────────────────
# Просто добави/премахни име на проект. Това е всичко!
PROJECTS=(
"zdravemag"
"fs"
"trainbrakes"
"linux-devops"
"itpraktika-astro"
)
# Базови пътища (промени ако е нужно)
SOURCE_BASE="/mnt/c/Users/fedia/Desktop"
DEST_BASE="/mnt/e/cloudflare-pages"
# Колко стари логове да пазим (останалите се изтриват)
KEEP_LOGS=30
# ─── КРАЙ НА КОНФИГУРАЦИЯ — не пипай нищо долу ───────────────────
# Цветове за терминал
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[0;33m'
BLUE='\033[0;34m'
CYAN='\033[0;36m'
BOLD='\033[1m'
NC='\033[0m' # No Color
# Променливи
BACKUP_DATE=$(date +%Y-%m-%d_%H-%M-%S)
LOG_DIR="/mnt/d/cloudflare-pages/.backup-logs"
LOG_FILE="${LOG_DIR}/backup_${BACKUP_DATE}.log"
FAILED=0
SUCCESS_COUNT=0
TOTAL_COUNT=${#PROJECTS[@]}
# ─── ФУНКЦИИ ─────────────────────────────────────────────────────
init() {
mkdir -p "$LOG_DIR" 2>/dev/null
mkdir -p "$DEST_BASE" 2>/dev/null
# Изтрий стари логове (keep last N)
local logs=($(ls -t "${LOG_DIR}"/backup_*.log 2>/dev/null))
if [ ${#logs[@]} -gt $KEEP_LOGS ]; then
local to_delete=("${logs[@]:$KEEP_LOGS}")
for old_log in "${to_delete[@]}"; do
rm -f "$old_log"
done
echo -e "${YELLOW}Изтрити ${#to_delete[@]} стари лога (пазени: последни $KEEP_LOGS)${NC}"
fi
}
log() {
local msg="[$(date '+%Y-%m-%d %H:%M:%S')] $1"
echo "$msg" | tee -a "$LOG_FILE"
}
log_color() {
local color="$1"
local msg="$2"
echo -e "${color}${msg}${NC}" | tee -a "$LOG_FILE"
}
check_disk_space() {
local dest_fs=$(df -h "$DEST_BASE" 2>/dev/null | tail -1 | awk '{print $4}')
local dest_pct=$(df "$DEST_BASE" 2>/dev/null | tail -1 | awk '{print $5}' | tr -d '%')
if [ -z "$dest_fs" ]; then
log_color "$RED" "❌ Не мога да проверя дисково пространство — $DEST_BASE не е достъпен!"
exit 1
fi
if [ "$dest_pct" -gt 90 ]; then
log_color "$RED" "❌ Дискът е пълен ($dest_pct%)! Свободно: $dest_fs. Прекратявам."
exit 1
fi
log "Дисково пространство: $dest_fs свободно ($dest_pct% заето)"
}
backup_project() {
local name="$1"
local source="${SOURCE_BASE}/${name}/"
local dest="${DEST_BASE}/${name}/"
local start_time=$(date +%s)
log "── Backup: $name ──"
echo -e "${CYAN} 📦 ${BOLD}$name${NC}" | tee -a "$LOG_FILE"
# Проверка дали source съществува
if [ ! -d "$source" ]; then
log_color "$RED" " ❌ Source не съществува: $source"
return 1
fi
# Създай dest ако няма
if ! mkdir -p "$dest" 2>/dev/null; then
log_color "$RED" " ❌ Не мога да създам dest: $dest (mount-нат ли е /mnt/e?)"
return 1
fi
# Преброй файлове преди backup
local files_before=$(find "$source" -type f 2>/dev/null | wc -l)
# rsync
local rsync_output
rsync_output=$(rsync -avh --delete \
--exclude=".git/" \
--exclude="node_modules/" \
--exclude="*.tmp" \
--exclude="dist/" \
--exclude=".astro/" \
--exclude=".wrangler/" \
--exclude="*.log" \
--exclude=".DS_Store" \
"$source" \
"$dest" 2>&1)
local rsync_exit=$?
echo "$rsync_output" | tail -5 | while IFS= read -r line; do
echo " $line" | tee -a "$LOG_FILE"
done
local end_time=$(date +%s)
local duration=$((end_time - start_time))
if [ $rsync_exit -eq 0 ]; then
local files_after=$(find "$dest" -type f 2>/dev/null | wc -l)
log_color "$GREEN" " ✅ $name — готов ($duration сек, $files_after файла)"
return 0
else
log_color "$RED" " ❌ $name — грешка (exit $rsync_exit, $duration сек)"
return 1
fi
}
cleanup_old_backups() {
# Изтрий празни папки в dest (ако има останали от преместени проекти)
find "$DEST_BASE" -maxdepth 1 -type d -empty -delete 2>/dev/null
}
print_summary() {
local end_time=$(date +%s)
local elapsed=$((end_time - BACKUP_START))
echo "" | tee -a "$LOG_FILE"
echo "[$(date '+%Y-%m-%d %H:%M:%S')] ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━" | tee -a "$LOG_FILE"
echo "[$(date '+%Y-%m-%d %H:%M:%S')] РЕЗЮМЕ:" | tee -a "$LOG_FILE"
echo "[$(date '+%Y-%m-%d %H:%M:%S')] Проекти: $TOTAL_COUNT" | tee -a "$LOG_FILE"
echo "[$(date '+%Y-%m-%d %H:%M:%S')] Успешни: $SUCCESS_COUNT от $TOTAL_COUNT" | tee -a "$LOG_FILE"
echo "[$(date '+%Y-%m-%d %H:%M:%S')] Време: ${elapsed} секунди" | tee -a "$LOG_FILE"
echo "[$(date '+%Y-%m-%d %H:%M:%S')] Лог: $LOG_FILE" | tee -a "$LOG_FILE"
if [ $FAILED -eq 0 ]; then
echo -e "${GREEN}✅ ВСИЧКИ BACKUP-И УСПЕШНИ!${NC}"
echo "[$(date '+%Y-%m-%d %H:%M:%S')] ✅ ВСИЧКИ BACKUP-И УСПЕШНИ!" >> "$LOG_FILE"
else
echo -e "${RED}⚠️ ИМА НЕУСПЕШНИ BACKUP-И — провери лога!${NC}"
echo "[$(date '+%Y-%m-%d %H:%M:%S')] ⚠️ ИМА НЕУСПЕШНИ BACKUP-И — провери лога!" >> "$LOG_FILE"
fi
echo "[$(date '+%Y-%m-%d %H:%M:%S')] ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━" | tee -a "$LOG_FILE"
}
# ─── ГЛАВНА ЛОГИКА ───────────────────────────────────────────────
BACKUP_START=$(date +%s)
echo -e "${BOLD}${BLUE}╔══════════════════════════════════════════╗${NC}"
echo -e "${BOLD}${BLUE}║ BACKUP SCRIPT v2.0 ║${NC}"
echo -e "${BOLD}${BLUE}║ $(date '+%Y-%m-%d %H:%M:%S') ║${NC}"
echo -e "${BOLD}${BLUE}╚══════════════════════════════════════════╝${NC}"
init
check_disk_space
echo "" | tee -a "$LOG_FILE"
log "Стартирам backup на $TOTAL_COUNT проекта..."
echo "" | tee -a "$LOG_FILE"
for project in "${PROJECTS[@]}"; do
if backup_project "$project"; then
SUCCESS_COUNT=$((SUCCESS_COUNT+1))
else
FAILED=1
fi
echo "" | tee -a "$LOG_FILE"
done
cleanup_old_backups
print_summary
# Exit code
if [ $FAILED -eq 0 ]; then
exit 0
else
exit 1
fi
(Забележка: В оригиналния код редовете с параметрите на rsync и последният if блок са разделени за по-добра четимост — в примера горе са форматирани с обратни наклонени черти \, за да работят безпроблемно при директно копиране).
Разбор на архитектурата на скрипта
За да разбереш как точно функционира кодът под капака, разделих логиката му на пет основни етапа.
1. Конфигурационна секция
В самото начало съм изолирал променливите, които подлежат на промяна. Масивът PROJECTS съдържа имената на директориите, които искам да архивирам:
PROJECTS=(
"zdravemag"
"fs"
"trainbrakes"
"linux-devops"
"itpraktika-astro"
)
Пътищата SOURCE_BASE и DEST_BASE използват стандартната за WSL2 (Windows Subsystem for Linux) структура /mnt/c/ и /mnt/e/, което ми позволява директно от Linux терминала да достъпвам локалните дискове на Windows и външния носител за бекъп. Ако използваш чист Linux (напр. Ubuntu Desktop), просто ги промени на /home/потребител/проекти и /media/backup.
2. Инициализация и ротация на логовете (init)
При всяко стартиране функцията init() проверява дали съществуват директориите за логове и архиви. Най-интересната част тук е управлението на историята:
local logs=($(ls -t "${LOG_DIR}"/backup_*.log 2>/dev/null))
if [ ${#logs[@]} -gt $KEEP_LOGS ]; then
local to_delete=("${logs[@]:$KEEP_LOGS}")
...
Командата ls -t подрежда всички лог файлове от най-новия към най-стария. Чрез синтаксиса за рязане на масиви в Bash (${logs[@]:$KEEP_LOGS}) скриптът взима всички файлове след 30-ия и ги изтрива. Така винаги разполагам с последните 30 отчета, без да се налага ръчно почистване.
3. Проверка на дисковото пространство (check_disk_space)
Една от най-честите грешки при автоматичните бекъпи е опитът за запис върху разкачен външен диск или препълнен дял. Функцията използва df и awk, за да извлече процента заето пространство. Ако целевата директория не съществува (дискът не е монтиран) или заетостта надвишава 90%, скриптът прекратява изпълнението с код за грешка (exit 1), преди да нанесе щети.
4. Същинско синхронизиране (backup_project)
Тук се крие истинската сила на инструмента — командата rsync:
-a(archive): Запазва правата за достъп, времевите отпечатъци и символичните връзки.-v(verbose) и-h(human-readable): Извеждат четима информация за прехвърлените данни.--delete: Гарантира, че ако съм изтрил остарял файл в работния проект, той ще бъде премахнат и от бекъпа.--exclude=...: Спестява гигабайти трафик и хиляди операции по запис, като пропуска генерираните и кеш директории (node_modules/,dist/,.astro/).
5. Обобщение и изходни кодове (print_summary)
Накрая скриптът изчислява общото време за изпълнение и извежда статистика. Особено важно е финалното връщане на exit 0 (при пълен успех) или exit 1 (при поне една грешка). Това позволява скриптът да бъде интегриран в cron задачи или вериги от команди (например backup.sh && notify-send "Готово").
Как да го инсталираш и използваш?
-
Създай файла и постави кода: Отвори терминала и създай нов файл в системната директория за локални изпълними файлове:
sudo nano /usr/local/bin/backup-projectsПостави кода вътре, редактирай
PROJECTS,SOURCE_BASEиDEST_BASEспоред твоите папки и запази сCtrl + O, последвано отCtrl + X. -
Направи скрипта изпълним:
sudo chmod +x /usr/local/bin/backup-projects -
Стартирай го от всяка точка в терминала: Тъй като файлът е в
/usr/local/bin, вече можеш да го извикваш просто като команда:backup-projects
Автоматизация чрез Cron
Ако искаш бекъпът да се изпълнява напълно автоматично всяка вечер в 20:00 часа, отвори таблицата с планирани задачи:
crontab -e
И добави следния ред в края на файла:
0 20 * * * /usr/local/bin/backup-projects >/dev/null 2>&1
Дори при фоново изпълнение без отворен терминал, ти винаги ще имаш пълен запис на случилото се в директорията .backup-logs, придружен с ясни маркери за успех или грешка.