18 ноября 2026 я поднял у себя дома объектное хранилище S3 на Garage 2.5.0 и настроил телефон так, что каждый скан с Canon из папки «Сканер» сам уходит в домашний бакет. На компьютере тот же бакет смонтирован через rclone и открывается в Dolphin как обычная папка.
Garage 2.5.0 дома: диск, бакет и nginx
Garage я запустил в Docker на домашнем сервере. Данные лежат на отдельном диске Toshiba, метаданные на SSD. Снаружи открыт только HTTPS: nginx с сертификатом принимает запросы и перекладывает их на Garage на localhost. Порты администратора, RPC и веб-витрины наружу не выпущены.
В документации Garage прямо сказано: у S3 API нет своего TLS, перед ним ставят обратный прокси. По умолчанию S3 слушает порт 3900, RPC 3901, веб 3902, администратор 3903. Я публикую только 127.0.0.1:3900.
Важные строки конфига такие. Регион s3_region здесь равен garage: это значение потом придётся повторить в каждом клиенте. replication_factor = 1, потому что узел один. public_endpoint совпадает с внешним HTTPS-адресом.
metadata_dir = "/var/lib/garage/meta" data_dir = "/var/lib/garage/data" db_engine = "sqlite" replication_factor = 1 rpc_bind_addr = "[::]:3901" rpc_public_addr = "127.0.0.1:3901" rpc_secret = "<openssl rand -hex 32>" [s3_api] s3_region = "garage" api_bind_addr = "[::]:3900" root_domain = ".s3.example.ru" public_endpoint = "https://s3.example.ru"
Контейнер берёт официальный образ dxflrs/garage:v2.5.0. Метаданные монтирую с SSD, данные с диска Toshiba. На хост публикую только локальный порт 3900, без 3901, 3902 и 3903.
docker run -d --name garage --restart unless-stopped \ -p 127.0.0.1:3900:3900 \ -v /etc/garage.toml:/etc/garage.toml \ -v /mnt/ssd/garage-meta:/var/lib/garage/meta \ -v /mnt/hdd/garage-data:/var/lib/garage/data \ dxflrs/garage:v2.5.0
Дальше нужен layout, даже для одного узла. Идентификатор узла берётся из первой колонки garage status. Ёмкость в команде поставьте по своему диску, это не квота бакета.
docker exec garage /garage status docker exec garage /garage layout assign -z dc1 -c 2T <node_id> docker exec garage /garage layout apply --version 1
Бакет у меня один, приватный, имя disk, квота 1,2 ТиБ. Ключ создаю отдельно и даю ему только чтение и запись в этот бакет.
docker exec garage /garage bucket create disk docker exec garage /garage key create phone-key docker exec garage /garage bucket allow --read --write disk --key phone-key docker exec garage /garage bucket set-quotas disk --max-size 1.2TiB
nginx слушает 443 и проксирует на localhost. Имя в примере условное: s3.example.ru. Из документации версии 2.5.0 стоит взять proxy_max_temp_file_size 0, чтобы большие загрузки не писались во временный файл. Если крупные сканы не проходят, в тот же server добавьте client_max_body_size 0: у nginx лимит по умолчанию 1 МБ.
upstream s3_backend {
server 127.0.0.1:3900;
}
server {
listen 443 ssl http2;
listen [::]:443 ssl http2;
server_name s3.example.ru;
ssl_certificate /etc/nginx/ssl/fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/privkey.pem;
client_max_body_size 0;
location / {
proxy_pass http://s3_backend;
proxy_set_header Host $http_host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_max_temp_file_size 0;
}
}
Честно про ограничение. Узел один, диск один, replication_factor = 1, второй копии нет. В таблице совместимости у Garage нет версионирования объектов: GetBucketVersioning всегда отвечает, что оно выключено. Если диск выйдет из строя, сканы пропадут. Такой узел в документации рекомендуют только для знакомства с системой, не как единственное хранилище. Нужна вторая копия в другом месте: например, в S3 от Beget или по схеме, которую я описывал для бэкапов WordPress в S3. После аварии у Beget в ноябре 2026 это уже не теория: своя копия должна жить отдельно от единственного диска.
Телефон и Exfilac: регион должен быть garage
Exfilac делает ровно одну вещь: берёт выбранные папки на Android и заливает их в бакет S3. Подходят и облака вроде Amazon, и своё хранилище. Уже залитые файлы повторно не гоняет: считает SHA-256 и сравнивает с тем, что лежит на сервере. Можно запускать по расписанию или по событию, телеметрии в приложении нет. Исходники лежат на GitHub, пакет есть в F-Droid.
В настройках бакета нужны имя disk, регион, ключ доступа, секрет, стиль доступа Path style и базовый адрес вида https://s3.example.ru. Path style обязателен: в инструкции по клиентам сказано, что Garage по умолчанию не обслуживает адреса вида bucket.example.ru, только путь /bucket/....
Здесь я наступил на грабли. В регион я сначала вписал moscow. У Garage регион берётся из конфига, и чаще всего это просто строка garage. Если клиент присылает другое значение, сервер отвечает 400 и ошибкой AuthorizationHeaderMalformed, в ответе есть правильный регион. Так написано в описании конфигурации. Exfilac это не подхватил: на экране горело Uploading, а бакет оставался пустым. Набежало около 430 неудачных запросов в час.


Когда я заменил регион на garage, файлы пошли. В бакете появился префикс Сканер/, на момент проверки было 71 объект и около 152 МБ.

rclone и Dolphin: бакет как папка на компьютере
На домашнем компьютере с KDE тот же бакет я подключаю через rclone. Конфиг почти дословно из документации Garage: провайдер Other, регион garage, force_path_style = true, адрес https://s3.example.ru.
[garage] type = s3 provider = Other env_auth = false access_key_id = <access key> secret_access_key = <secret key> region = garage endpoint = https://s3.example.ru force_path_style = true acl = private bucket_acl = private
Монтирование держит пользовательский unit systemd. Точка монтирования у меня ~/S3-garage, в неё попадает бакет disk. В документации rclone mount для systemd советуют Type=notify и абсолютный путь к конфигу: у службы нет переменной HOME. Режим --vfs-cache-mode writes нужен, чтобы в эту папку можно было копировать файлы как в обычный каталог.
[Unit] Description=Mount Garage S3 at %h/S3-garage After=network-online.target Wants=network-online.target [Service] Type=notify ExecStartPre=/usr/bin/mkdir -p %h/S3-garage ExecStart=/usr/bin/rclone mount garage:disk %h/S3-garage --config=%h/.config/rclone/rclone.conf --vfs-cache-mode writes ExecStop=/bin/fusermount3 -u %h/S3-garage [Install] WantedBy=default.target
systemctl --user daemon-reload systemctl --user enable --now s3-garage.service
В Dolphin я добавил закладку на ~/S3-garage. Новые PDF из телефона появляются в ~/S3-garage/Сканер, а файлы, которые копирую туда с компьютера, уходят в бакет.
Цепочка работает: сканер кладёт файл в папку «Сканер», Exfilac отправляет его в домашний S3, а на компьютере я сразу вижу его в Dolphin. Для повседневных сканов этого достаточно. Но один диск это ещё не бэкап. Следующий шаг: вторая копия в другом месте, хотя бы в том же духе, как я раньше делал бэкап WordPress на Яндекс Диск или в облачный S3.