PHPTime

Google Drive в Linux: rclone, монтирование, синхронизация и бэкапы сайта

Google так и не выпустил официальный клиент Google Drive для Linux, но это не мешает автоматизировать обмен с облаком поверх API. Практичный способ — связка rclone с systemd и cron, которая закрывает и ручную синхронизацию, и регулярные бэкапы сайтов на PHP 8.3–8.5.

Почему в Linux нет штатного клиента Google Drive

Google поддерживает клиенты Drive только для Windows и macOS. Для Linux компания неоднократно переносила сроки релиза, а затем прекратила разработку. Пользователи годами оставляли запросы и петиции с просьбой выпустить нативное приложение, но ситуация не изменилась.

На практике потеря невелика: API Google Drive открыт, и сторонние реализации давно работают надёжнее гипотетического клиента. Подключать облако как виртуальную директорию, выполнять зеркалирование и запускать инкрементальные бэкапы можно через rclone, google-drive-ocamlfuse или консольную утилиту drive. Для серверных задач в связке с PHP-проектами первым выбирают rclone.

Установка rclone и получение доступа к Google API

На сервере с Debian или Ubuntu пакет ставится через менеджер пакетов. Для свежих версий дистрибутивов этого достаточно, для более старых — на сайте проекта rclone есть скрипт установки, который кладёт бинарник в /usr/local/bin.

Shell
# Обновление индекса пакетов и установка rclone
sudo apt update
sudo apt install -y rclone

Для работы с Google Drive rclone нужен OAuth-клиент. Можно использовать встроенный client_id, но под нагрузкой он упирается в общий лимит запросов. Для боевого применения лучше создать свой проект в Google Cloud Console, включить Drive API и выпустить OAuth 2.0 Client ID типа Desktop. Это исключит чужие квоты и сделает токен долгоживущим.

Подключение Google Drive как remote

Конфигурация выполняется командой rclone config. В интерактивном режиме нужно выбрать тип drive, ввести выданный client_id и client_secret, а для уровня доступа указать drive — полный доступ к файлам. При первом запуске rclone предложит открыть ссылку в браузере и подтвердить права через OAuth. На headless-сервере ссылку можно скопировать на локальную машину, а после подтверждения вставить код обратно в терминал.

Shell
# Создание нового подключения">rclone config

# Тип storage: drive
# client_id и client_secret — из Google Cloud Console
# scope: drive
# service_account_file: оставить пустым
# root_folder_id: оставить пустым
# Затем браузер откроет OAuth-подтверждение

Файл конфигурации создаётся в ~/.config/rclone/rclone.conf. Токен доступа хранится там же и автоматически обновляется через refresh-токен, так что повторная авторизация не нужна.

Монтирование Google Drive как виртуальной директории

Смонтировать remote в точку файловой системы позволяет команда rclone mount. Для работы нужен FUSE, который на сервере ставится пакетом fuse3. Точку монтирования создают заранее, права выдают пользователю, от которого будет работать процесс.

Shell
# Установка FUSE и подготовка точки монтирования
sudo apt install -y fuse3
sudo mkdir -p /mnt/gdrive
sudo chown "$USER":"$USER" /mnt/gdrive

# Монтирование remote с VFS-кэшем
rclone mount gdrive: /mnt/gdrive \
  --vfs-cache-mode writes \
  --vfs-cache-max-age 1h \
  --daemon

Без кэша операции чтения и записи превращаются в сетевые вызовы Google Drive API, и работа с файлами замедляется. Режим writes кэширует загружаемые файлы на локальном диске, а full — ещё и читаемые. Для серверного использования writes обычно достаточно.

Автозапуск через systemd

Чтобы монтирование переживало перезагрузки, создают unit-файл systemd. В нём указывают пользователя, команду монтирования и зависимости от сети. После перезагрузки сервера Google Drive будет подключаться автоматически.

Shell
# /etc/systemd/system/rclone-mount.service
[Unit]
Description=Google Drive mount via rclone
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=www-data
Group=www-data
ExecStart=/usr/bin/rclone mount gdrive: /mnt/gdrive \
  --vfs-cache-mode writes \
  --vfs-cache-max-age 1h \
  --allow-other
ExecStop=/bin/fusermount3 -u /mnt/gdrive
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target

После создания unit-файла его активируют командами systemctl daemon-reload, systemctl enable rclone-mount и systemctl start rclone-mount. Статус проверяют через systemctl status rclone-mount.

Синхронизация вместо постоянного монтирования

Для рутинных задач бэкапа монтирование не обязательно. Команда rclone sync приводит удалённую директорию к точному состоянию локальной: копирует новые файлы, обновляет изменённые и удаляет то, чего нет в источнике. Это удобно для выгрузки снапшотов базы данных и пользовательских файлов.

Shell
# Синхронизация локальной директории бэкапов с папкой на Drive
rclone sync /var/backups/site gdrive:backups/site \
  --exclude '.DS_Store' \
  --log-file /var/log/rclone-backup.log \
  --log-level INFO

Для больших объёмов полезен флаг --checkers, который увеличивает число параллельных проверок файлов, и --transfers для числа одновременных загрузок. Значения по умолчанию — 8 и 4, на быстром канале их поднимают до 16 и 8.

Автоматические бэкапы PHP-сайта в Google Drive

Типичный PHP-проект состоит из кода в репозитории, загружаемых файлов и базы данных. Если репозиторий и так хранится в Git, в облако выгружают только изменяемые данные: дамп БД и пользовательский контент. Скрипт бэкапа пишут на PHP с использованием актуального синтаксиса 8.3–8.5.

PHP
<?php

declare(strict_types=1);

// Скрипт создания бэкапа перед выгрузкой в Google Drive
// Запуск: php /usr/local/bin/backup_site.php

final class DatabaseBackup
{
    public function __construct(
        private readonly string $dbName,
        private readonly string $dbUser,
        private readonly string $dbPassword,
        private readonly string $outputFile,
    ) {}

    public function create(): void
    {
        $command = sprintf(
            'mysqldump --single-transaction --quick -u %s -p%s %s > %s',
            escapeshellarg($this->dbUser),
            escapeshellarg($this->dbPassword),
            escapeshellarg($this->dbName),
            escapeshellarg($this->outputFile),
        );

        exec($command, $output, $exitCode);

        if ($exitCode !== 0) {
            throw new RuntimeException('Ошибка создания дампа базы данных');
        }
    }
}

$backup = new DatabaseBackup(
    dbName: 'site_db',
    dbUser: 'backup_user',
    dbPassword: getenv('DB_PASSWORD') ?: '',
    outputFile: '/var/backups/site/database.sql',
);

$backup->create();
echo "Дамп создан\n";

Затем cron запускает цепочку: PHP-скрипт формирует дамп, rclone загружает его в Google Drive, а старые локальные копии удаляются. Надёжнее вынести всю логику в отдельный bash-скрипт, который логирует каждый шаг и не оставляет мусора.

Shell
# /usr/local/bin/drive_backup.sh
#!/bin/bash
set -euo pipefail

BACKUP_DIR="/var/backups/site"
REMOTE_DIR="gdrive:backups/site"
LOG_FILE="/var/log/site-backup.log"

mkdir -p "$BACKUP_DIR"
php /usr/local/bin/backup_site.php >> "$LOG_FILE" 2>&1

rclone sync "$BACKUP_DIR" "$REMOTE_DIR" \
  --log-file "$LOG_FILE" \
  --log-level INFO

find "$BACKUP_DIR" -type f -mtime +14 -delete
echo "Бэкап завершён: $(date)" >> "$LOG_FILE"

Остаётся добавить строку в crontab. Бэкапы обычно делают ночью, когда нагрузка на базу минимальна.

Shell
# Ежедневный бэкап в 03:30
30 3 * * * /usr/local/bin/drive_backup.sh

Альтернативы rclone

Кроме rclone, для работы с Google Drive в Linux существуют и другие инструменты:

  • google-drive-ocamlfuse — монтирование Drive через FUSE с поддержкой кэширования. Написан на OCaml, ставится из репозиториев Ubuntu и Debian. Удобен, если нужно именно виртуальное файловое подключение без команд синхронизации.
  • drive — консольная утилита от команды Google на Go. Позволяет выгружать, скачивать и публиковать файлы. Поддерживает операции push и pull для массовых операций.
  • Insync — платный проприетарный клиент с GUI для Linux. Заточен под настольные дистрибутивы, для сервера не подходит.

Выбор зависит от задачи. Для серверной автоматизации и скриптов бэкапа rclone остаётся самым гибким: конфигурация в одном файле, все режимы работы через CLI и широкая поддержка облачных провайдеров.

Сравнение режимов работы

Режим Команда rclone Когда использовать
Монтирование rclone mount Постоянная работа с файлами как с локальной директорией
Синхронизация rclone sync Регулярные бэкапы, зеркалирование директорий
Копирование rclone copy Разовая загрузка без удаления старых файлов
Проверка rclone check Сверка целостности локальной и удалённой копий

Типичные ошибки и как их избежать

  • Не создан свой OAuth-клиент. Встроенные квоты rclone быстро исчерпываются, появляются ошибки rateLimitExceeded. Создайте собственный client_id в Google Cloud Console.
  • Неправильные права у service-файла. Если unit-файл systemd работает от www-data, у этого пользователя должен быть доступ к rclone.conf. Иначе монтирование молча упадёт после перезагрузки.
  • Синхронизация в неправильном направлении. rclone sync удаляет на удалённой стороне всё, чего нет локально. Перепутав источник и назначение, легко стереть данные на Drive.
  • Хранение паролей в коде. PHP-скрипты бэкапов не должны содержать пароли БД в открытом виде. Используйте переменные окружения или настройки вне репозитория.

Чек-лист настройки Google Drive в Linux

  1. Установить rclone и проверить версию: rclone version.
  2. Создать проект в Google Cloud Console, включить Drive API, выпустить OAuth 2.0 Client ID.
  3. Добавить remote через rclone config с полным доступом drive.
  4. Проверить подключение: rclone lsd gdrive:.
  5. Для постоянного монтирования настроить systemd unit и включить автозапуск.
  6. Для бэкапов написать PHP-скрипт дампа и bash-обёртку с rclone sync.
  7. Добавить задачу в cron и протестировать полный цикл вручную.
  8. Настроить retention: удалять локальные копии старше 14 дней и при необходимости — старые файлы на Drive.

Частые вопросы

Есть ли официальный Google Drive для Linux?

Нет. Google так и не выпустила нативный клиент для Linux, несмотря на многочисленные запросы пользователей. Вместо него используют rclone, google-drive-ocamlfuse или платные программы вроде Insync.

Что выбрать: rclone mount или rclone sync?

Для постоянной работы с файлами как с локальной директорией удобен mount. Для регулярных бэкапов и зеркалирования лучше подходит sync: он не требует постоянно активного FUSE-соединения и работает в фоне через cron.

Нужно ли создавать свой OAuth-клиент для rclone?

Рекомендуется. Встроенный client_id использует общие квоты Google Drive API, из-за чего могут возникать ошибки rateLimitExceeded при активной работе с файлами. Собственный проект в Google Cloud Console снимает это ограничение.

Справка по теме

Ещё в разделе «Linux и серверы»

HTTP/2 и HTTP/3 для PHP-сайта на nginx: настройка и диагностика

Как включить HTTP/2 и HTTP/3 для PHP-сайта на nginx, настроить TLS и QUIC, проверить протокол через curl и найти причину сбоя после перехода.

6 мин

Горячие клавиши в PhpStorm на Linux: чиним работу в русской раскладке

Почему в PhpStorm на Linux не работают горячие клавиши в русской раскладке и как это исправить: javaagent, vmoptions, XIM, Wayland и настройки IDE.

6 мин

Поиск текста в файлах в Linux: grep, find, ripgrep и примеры для PHP-проекта

Как искать текст в файлах Linux: grep -rn, find с фильтрами по дате, ripgrep для больших проектов. Разбор на примере современного PHP-кода.

5 мин

Сайт на PHP недоступен: пошаговый чек-лист диагностики

Пошаговая диагностика недоступного PHP-сайта: проверяем DNS, TLS, веб-сервер, PHP-FPM, базу данных, свободное место и логи, чтобы найти причину сбоя.

8 мин