Я поднял дома S3 и складываю туда сканы прямо с телефона

Обложка: домашний S3, Garage 2.5.0, Exfilac и rclone в Dolphin

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.

Источники и ссылки


Комментарии загружаются…