К содержанию

gtsBackup - Бекап сайта MODX на ваш компьютер

После инцидента с бегет не понятно где хранить беккапы сайтов. Решил беккапить на своем компе. И подготовил компонент для этого.
Бекап сайта MODX на ваш компьютер. Сайт по токену собирает полный или дифференциальный архив файлов и дамп базы, клиент на компьютере сам забирает их каждый день, проверяет, хранит и удаляет старые. На компьютере с Windows ничего ставить не нужно.
Внимание. Нужен пакет gtsAPI 1.1.3-beta или новее — установите его до gtsBackup, иначе установщик MODX остановится на окне «Зависимости». Проверен на MODX 2.8 и MODX 3.2, PHP 7.3–8.3, MySQL 5.7 и MySQL 8. Клиент для Windows работает на Windows 10 (версия 1803 и новее) и Windows 11.

Что умеет
— Полный и дифференциальный бекап файлов. Дифференциальный содержит всё, что изменилось с момента своего полного, поэтому для восстановления нужны ровно два архива. Удалённые на сайте файлы при восстановлении тоже удаляются.
— Дамп базы через mysqldump, а на хостинге, где запуск программ запрещён, — средствами PHP. После скачивания клиент проверяет, что дамп дошёл до конца.
— Большие сайты. Архив собирается на сервере порциями по 20 секунд и не упирается в таймауты веб-сервера. Если связь оборвалась, скачивание продолжается с того же места.
— Токен вместо пароля. Бессрочный, умеет только снимать бекап, создаётся в админке и показывается один раз. Отключить компьютер — снять у токена галочку. По желанию — только HTTPS и белый список IP.
— Клиент для Windows без установки: только встроенные PowerShell, curl и tar. Для Linux и macOS — тот же клиент на PHP с теми же командами.
— Сам по расписанию. При подключении первого сайта клиент ставит задачу в Планировщик Windows от текущего пользователя: каждый день, при входе в Windows и с догоном пропущенного запуска. Права администратора не нужны.
— Ротация. По умолчанию полный бекап раз в неделю, между ними дифференциальные, хранятся 4 недели. Сроки задаются для каждого сайта отдельно.
— Предупреждение о пропусках. Если у сайта нет удачного бекапа два дня, поверх всех окон появляется окно со списком таких сайтов. В админке у каждого токена видно, когда этот компьютер последний раз снял бекап.
— Восстановление одной командой в пустую папку: для дифференциального клиент сам возьмёт его полный. Архивы — обычный tar.gz, открываются любым архиватором, русские имена файлов сохраняются.
— Папки рядом с сайтом, например хранилище файлов и ключи компонентов, добавляются в бекап настройкой.
— Открытый протокол. Описание обмена лежит рядом с клиентом: по нему можно написать свой клиент.

Быстрый старт
Установите gtsAPI, затем gtsBackup.
Откройте Компоненты → Бекапы → Токены → «Создать токен» и укажите название, например чей это компьютер. В окне будут готовая команда, ссылка на клиент и сам токен — он показывается один раз.
Скачайте клиент по ссылке и распакуйте, например в C:\gtsBackup.
В этой папке откройте обычную консоль (cmd) и выполните команду из окна:
gtsbackup.cmd add mysite https://ваш-сайт.ru/assets/components/gtsbackup/action.php gbk_… --now
Команда проверит связь, покажет, какая папка сайта бекапится, поставит ежедневную задачу и сразу снимет первый полный бекап. Бекапы лягут в C:\gtsBackup\backups\mysite\.
Второй сайт подключается его командой add: клиент заново качать не нужно, задача уже бекапит все сайты.
Проверка: gtsbackup.cmd list — что снято и что будет дальше, gtsbackup.cmd check — нет ли пропусков.

Как хранятся бекапы
Бекапы лежат цепочками: папка цепочки названа временем полного бекапа, внутри — полный и его дифференциальные.
backups\mysite\
    20261112-033000\              цепочка
        full\                     полный: файлы + база
        diff-20261113-033000\     дифференциальные этого полного
    20261119-033000\
        full\
    gtsbackup.log
Старые цепочки удаляются целиком после каждого удачного бекапа. Неудачный бекап ничего не удаляет.

Что бекапится на сайте
Корень сайта MODX — папка, где лежат index.php и config.core.php. Если core вынесен за корень, он добавляется сам. Другой корень, исключения и дополнительные папки задаются в системных настройках gtsbackup_*. Если сайт открыт снаружи по другому адресу (прокси, шлюз), укажите его в gtsbackup_public_url — окно токена покажет правильную команду.
Свои файлы gtsBackup держит только в core/components/gtsbackup/ и assets/components/gtsbackup/. Архив перед скачиванием собирается в core/components/gtsbackup/tmp/: нужно свободное место размером с архив сайта, вынести папку можно настройкой gtsbackup_tmp_path. При удалении пакета папка удаляется вместе с ним, там только временное.

Linux и macOS
Нужен PHP 7.4+ с расширениями curl и zlib. Команды те же: php gtsbackup.php add …, расписание — cron:
30 3 * * * php /opt/gtsbackup/gtsbackup.php scheduled
Лицензия
Код открыт: github.com/tuniekov/gtsBackup. Пользоваться можно после покупки, лицензия на один сайт, клиент ставится на любое число своих компьютеров. Изменять код для своих сайтов можно.
https://gtsstore.ru/packages/gtsbackup.html
Ссылка на модсторе после модерации.
Александр Туниеков
modx.pro
56
Поблагодарить автора Отправить деньги
Реклама

Комментарии: 6

Артур Шевченко
5 часов назад
А почему ты решил написать своё решение, а не взял готовое?
    Александр Туниеков
    5 часов назад
    Какое готовое? не видел
      Артур Шевченко
      5 часов назад
      вот
      или вот
        Александр Туниеков
        5 часов назад
        backupmodx. Я как то пользовался чем то похожим. Сейчас не вспомню, но было вообще не удобно. Удаление лишних копий через раз срабатывало. И беккап только в сайте.
        mxbackup вообще не видел. Какие-то обезличеные копии, которые мне не нужны. И мне так то чтоб на моем локальном компе данные хранились. А у тебя клиента для скачки вообще нет. Так что мне мой компонент в разы удобнее :-).
    Ivan K.
    Ivan K. Эксперт
    4 часа назад
    Зачем такие сложности с компонентами? )), ведь эту задачу можно решить простым bash-скриптом, который запускается даже на шаред-хостинге по крону.

    архивирует файлы (можно запаролить архив) делает дамп базы и по sftp отправлет все добро на sftp сервер, а потом отчет на мыло)

    Вот пример рабочего варианта:

    #!/bin/bash
    # Бэкап supersite.ru -> FTP/FTPS/SFTP + отчёт на email через внешний SMTP.
    # Архивы: zip с паролем, каждый бэкап в свою подпапку. Локальные архивы удаляются после заливки.
    # Запуск:  bash my_backup.sh
    
    # ===== СЕРВЕР-ПРИЁМНИК =====
    PROTO="sftp"                  # sftp | ftps | ftp
    SFTP_HOST="0.0.0.0"      # <-- ЗАПОЛНИТЬ
    SFTP_PORT="22"
    SFTP_USER="user_sftp"              # <-- ЗАПОЛНИТЬ
    SFTP_PASS="111"             # <-- ЗАПОЛНИТЬ
    SFTP_DIR="/ftp_files/supersite"   
    
    # ===== ПАРОЛЬ НА АРХИВ =====
    ZIP_PASS=""                   # пусто = без пароля
    
    # ===== ОТЧЁТ НА EMAIL (внешний SMTP) =====
    MAIL_ENABLE="yes"                       # yes | no
    MAIL_TO="ivan@sdfsdf.ru"               # кому слать отчёт
    MAIL_FROM="no-reply@sdfdsf.ru"           # обычно совпадает с SMTP_USER
    SMTP_URL="smtps://mail.fffff.net:465"   # 465 -> smtps://   |   587 -> smtp://
    SMTP_USER="no-reply@ffff.net"
    SMTP_PASS="sfsdf"                            # ПАРОЛЬ ПРИЛОЖЕНИЯ, не основной от почты
    MAIL_ON="always"                        # always = слать всегда | error = только при сбое
    # =========================================
    
    SITE="/home/fffff/domains/supersite.ru/public_html"
    TMP="/home/fffff/backups"
    DB_NAME="fffff_ffff"
    DB_USER="fffff_fff"
    DB_PASS="dfdsfsdf2323r"
    
    DATE="$(date +%F_%H%M)"
    REMOTE_SUB="${SFTP_DIR}/${DATE}"
    DB_FILE="db.zip"
    FILES_FILE="files.zip"
    WORK="${TMP}/${DATE}"
    
    # --- Весь вывод пишем и на экран, и в лог: лог потом уедет письмом ---
    LOG="$(mktemp)"
    exec > >(tee "${LOG}") 2>&1
    
    STATUS="СБОЙ"                 # переключится на OK в самом конце
    
    say()  { echo ">>> $*"; }
    fail() { echo "!!! ОШИБКА: $*"; echo "!!! Скрипт остановлен."; echo "!!! Локальные файлы оставлены в ${WORK}"; exit 1; }
    
    send_mail() {
        [ "${MAIL_ENABLE}" = "yes" ] || return 0
        [ "${MAIL_ON}" = "error" ] && [ "${STATUS}" = "OK" ] && return 0
        [ -n "${SMTP_PASS}" ] || { echo "(письмо не отправлено: не задан SMTP_PASS)"; return 0; }
    
        local subj="[${STATUS}] Бэкап supersite.ru ${DATE}"
        # Тема с кириллицей должна быть закодирована, иначе почтовики покажут кракозябры
        local subj_enc="=?UTF-8?B?$(printf '%s' "${subj}" | base64 | tr -d '\n')?="
        local msg; msg="$(mktemp)"
    
        {
            echo "From: ${MAIL_FROM}"
            echo "To: ${MAIL_TO}"
            echo "Subject: ${subj_enc}"
            echo "Date: $(date -R)"
            echo "MIME-Version: 1.0"
            echo "Content-Type: text/plain; charset=UTF-8"
            echo
            cat "${LOG}"
        } > "${msg}"
    
        curl --silent --show-error --ssl-reqd \
             --url "${SMTP_URL}" \
             --user "${SMTP_USER}:${SMTP_PASS}" \
             --mail-from "${MAIL_FROM}" \
             --mail-rcpt "${MAIL_TO}" \
             --upload-file "${msg}" \
          && echo "(отчёт отправлен на ${MAIL_TO})" \
          || echo "(НЕ УДАЛОСЬ отправить отчёт на ${MAIL_TO})"
    
        rm -f "${msg}"
    }
    
    cleanup() {
        rm -f "${MYCNF:-}" "${SQL:-}"
        send_mail
        rm -f "${LOG}"
    }
    trap cleanup EXIT
    
    echo "=================================================="
    echo "  СТАРТ: $(date '+%F %T')   протокол: ${PROTO}"
    echo "=================================================="
    
    # --- Шаг 1: проверки ---
    say "ШАГ 1. Проверяю условия..."
    
    case "${PROTO}" in
        sftp)     curl -V | grep -q sftp  || fail "curl собран без поддержки SFTP" ;;
        ftp|ftps) curl -V | grep -qi ftp  || fail "curl собран без поддержки FTP" ;;
        *) fail "PROTO должен быть sftp, ftps или ftp (сейчас: '${PROTO}')" ;;
    esac
    echo "      curl поддерживает ${PROTO}"
    
    if [ "${MAIL_ENABLE}" = "yes" ]; then
        curl -V | grep -q smtp || fail "curl собран без поддержки SMTP — отчёт слать нечем"
        echo "      curl поддерживает SMTP, отчёт уйдёт на ${MAIL_TO}"
    fi
    
    [ -n "$SFTP_HOST" ] && [ -n "$SFTP_USER" ] && [ -n "$SFTP_PASS" ] \
        || fail "не заполнены SFTP_HOST / SFTP_USER / SFTP_PASS"
    echo "      приёмник: ${SFTP_USER}@${SFTP_HOST}:${SFTP_PORT}${REMOTE_SUB}"
    
    command -v zip >/dev/null 2>&1 || fail "не найден zip"
    [ -n "${ZIP_PASS}" ] && echo "      архивы: zip С ПАРОЛЕМ" || echo "      архивы: zip без пароля"
    
    [ "${PROTO}" = "ftp" ] && echo "      ВНИМАНИЕ: обычный FTP шлёт логин и пароль открытым текстом."
    
    [ -f "${SITE}/core/config/config.inc.php" ] || fail "не найден config.inc.php в ${SITE}"
    echo "      сайт на месте: ${SITE}"
    
    mkdir -p "${WORK}" || fail "не могу создать ${WORK}"
    echo "      рабочая папка: ${WORK}  (свободно: $(df -h "${TMP}" | awk 'NR==2{print $4}'))"
    
    ZIP_OPTS=()
    [ -n "${ZIP_PASS}" ] && ZIP_OPTS=( -P "${ZIP_PASS}" )
    
    # --- Шаг 2: ключ хоста (только SFTP) ---
    if [ "${PROTO}" = "sftp" ]; then
        say "ШАГ 2. Проверяю известность SFTP-хоста..."
        mkdir -p ~/.ssh && chmod 700 ~/.ssh && touch ~/.ssh/known_hosts
        if ssh-keygen -F "[${SFTP_HOST}]:${SFTP_PORT}" >/dev/null 2>&1 || ssh-keygen -F "${SFTP_HOST}" >/dev/null 2>&1; then
            echo "      хост уже известен"
        else
            echo "      добавляю ключ хоста..."
            ssh-keyscan -T 15 -p "${SFTP_PORT}" "${SFTP_HOST}" >> ~/.ssh/known_hosts 2>/dev/null \
                || fail "не отвечает ${SFTP_HOST}:${SFTP_PORT}"
            echo "      добавлен"
        fi
    else
        say "ШАГ 2. Пропускаю (для ${PROTO} ключ хоста не нужен)"
    fi
    
    # --- Шаг 3: база ---
    say "ШАГ 3. Делаю дамп базы ${DB_NAME}..."
    MYCNF="$(mktemp)"; chmod 600 "${MYCNF}"
    printf '[client]\nuser=%s\npassword=%s\n' "${DB_USER}" "${DB_PASS}" > "${MYCNF}"
    SQL="${WORK}/dump.sql"
    
    mysqldump --defaults-extra-file="${MYCNF}" --single-transaction --quick \
        --default-character-set=utf8mb4 "${DB_NAME}" > "${SQL}" 2>/tmp/dump_err.$$ \
        || { echo "--- ответ mysqldump ---"; cat /tmp/dump_err.$$; echo "-----------------------"
             rm -f /tmp/dump_err.$$; fail "mysqldump не отработал"; }
    rm -f /tmp/dump_err.$$
    echo "      дамп: $(du -h "${SQL}" | cut -f1)"
    
    say "      Пакую дамп в ${DB_FILE}..."
    zip -j -9 -q "${ZIP_OPTS[@]}" "${WORK}/${DB_FILE}" "${SQL}" || fail "zip не смог упаковать дамп"
    rm -f "${SQL}"
    echo "      готово: ${DB_FILE}  ($(du -h "${WORK}/${DB_FILE}" | cut -f1))"
    
    # --- Шаг 4: файлы ---
    say "ШАГ 4. Архивирую файлы сайта (может занять несколько минут)..."
    echo "      объём сайта: $(du -sh "${SITE}" | cut -f1)"
    ( cd "${SITE}" && zip -r -9 -q "${ZIP_OPTS[@]}" "${WORK}/${FILES_FILE}" . -x 'core/cache/*' ) \
        || fail "zip не смог собрать архив файлов"
    echo "      готово: ${FILES_FILE}  ($(du -h "${WORK}/${FILES_FILE}" | cut -f1))"
    
    # --- Шаг 5: проверка целостности ---
    say "ШАГ 5. Проверяю архивы..."
    if command -v unzip >/dev/null 2>&1; then
        for f in "${DB_FILE}" "${FILES_FILE}"; do
            if [ -n "${ZIP_PASS}" ]; then
                unzip -qt -P "${ZIP_PASS}" "${WORK}/${f}" >/dev/null || fail "битый архив: ${f}"
            else
                unzip -qt "${WORK}/${f}" >/dev/null || fail "битый архив: ${f}"
            fi
            echo "      ${f} — цел"
        done
    else
        echo "      unzip не найден, проверку пропускаю"
    fi
    
    # --- Шаг 6: заливка ---
    say "ШАГ 6. Заливаю в ${REMOTE_SUB}/ ..."
    for f in "${DB_FILE}" "${FILES_FILE}"; do
        echo "      отправляю ${f} ..."
        CURL_OPTS=( --fail --show-error --silent --ftp-create-dirs
                    --user "${SFTP_USER}:${SFTP_PASS}"
                    --upload-file "${WORK}/${f}" )
        case "${PROTO}" in
            sftp) URL="sftp://${SFTP_HOST}:${SFTP_PORT}${REMOTE_SUB}/${f}" ;;
            ftps) URL="ftp://${SFTP_HOST}:${SFTP_PORT}${REMOTE_SUB}/${f}"; CURL_OPTS+=( --ssl-reqd ) ;;
            ftp)  URL="ftp://${SFTP_HOST}:${SFTP_PORT}${REMOTE_SUB}/${f}" ;;
        esac
        curl "${CURL_OPTS[@]}" "${URL}" || fail "не удалось залить ${f} — локальные архивы НЕ удаляю"
        echo "      OK: ${REMOTE_SUB}/${f}"
    done
    
    # --- Шаг 7: чистка локально ---
    say "ШАГ 7. Удаляю локальные архивы..."
    rm -rf "${WORK}"
    echo "      удалено: ${WORK}"
    
    STALE=$(find "${TMP}" -mindepth 1 -maxdepth 1 -type d -mtime +3 -print -exec rm -rf {} + 2>/dev/null | wc -l)
    [ "${STALE}" -gt 0 ] && echo "      подчищено незавершённых прогонов: ${STALE}"
    
    STATUS="OK"
    echo "=================================================="
    echo "  ГОТОВО: $(date '+%F %T')"
    echo "  На приёмнике: ${REMOTE_SUB}/${DB_FILE}"
    echo "                ${REMOTE_SUB}/${FILES_FILE}"
    echo "=================================================="
      Александр Туниеков
      3 часа назад
      Только sftp сервер надо поднимать. Вообщем вариантов как делать беккап куча. Можно так можно по другому. Я сделал потратил сколько-то токенов ИИ чтоб мне было удобно и чтоб я был уверен что беккапы делаются. Главное чтоб в случае чего чтоб можно было все восстановить. Возможно потом подыму сторонний сервер в облаке и там буду по сфтп делать. Хотя так то уже проще пхп клиента настроить :-).
      Возможно сделаю беккап в облако маилру или яндекса.
      Авторизуйтесь или зарегистрируйтесь, чтобы оставлять комментарии.
      6