DevOps и инфраструктура 13 мин чтения 2026-11-13

Непрерывная P2P-синхронизация файлов в Syncthing на VDS: развертывание в Docker Compose с защитой трафика, веб-интерфейсом и Nginx SSL

Практическое руководство по развертыванию узла P2P-синхронизации Syncthing v2.1.7 на VDS в Docker Compose: непрерывная двусторонняя передача файлов, сквозное шифрование Untrusted Nodes, Nginx SSL с WebSocket, тюнинг inotify и бэкап в S3.

Инженерная редакция SysKit Проверено инженерами SysKit.ru

Синхронизация рабочих файлов между рабочими станциями, домашними компьютерами, ноутбуками и мобильными устройствами — базовая потребность любого IT-специалиста, разработчика и распределенной команды. Исторически эту задачу закрывали коммерческие облачные хранилища (Dropbox, Google Drive, OneDrive, Яндекс Диск). Однако в современных реалиях централизованные сервисы несут серьезные технологические и финансовые ограничения: зарубежные платформы заблокировали оплату подписок российскими банковскими картами, облачные провайдеры сканируют содержимое пользовательских файлов, а тяжелые self-hosted системы (вроде Nextcloud) требуют от 2–4 ГБ оперативной памяти, связки с PostgreSQL/Redis и создают избыточную нагрузку на процессор при банальной синхронизации каталога с кодом или заметками.

Syncthing (актуальный стабильный релиз v2.1.7) — это эталонный инструмент с открытым исходным кодом для децентрализованной непрерывной двусторонней синхронизации файлов между неограниченным числом устройств. Написанный на языке Go, Syncthing не использует централизованные серверы для хранения пользовательских данных: файлы передаются напрямую между устройствами по протоколу BEP (Block Exchange Protocol) с обязательным сквозным шифрованием TLS v1.3. При этом аренда недорогого виртуального сервера VDS решает главную проблему классических P2P-сетей — необходимость одновременного нахождения устройств в онлайне. Развернутый на VDS экземпляр Syncthing работает в режиме круглосуточного координатора («always-on node» / постоянный узел-сеятель), который мгновенно принимает изменения с ноутбука или смартфона и бережно передает их на рабочий ПК при его включении. В этом практическом руководстве мы разберем развертывание Syncthing v2.1.7 в Docker Compose, настройку обратного прокси Nginx с SSL Let's Encrypt, системный тюнинг inotify в Linux, сквозное шифрование на недоверенных узлах (Untrusted Nodes) и создание автоматических резервных копий конфигурации в S3.

1. Архитектура Syncthing: почему децентрализованный P2P-протокол BEP надежнее облачных дисков

В отличие от традиционных клиент-серверных хранилищ, где каждый файл сначала загружается в единый облачный центр обработки данных, архитектура Syncthing построена на модели равноправных узлов (Peer-to-Peer):

Критерий Коммерческие SaaS (Dropbox / GDrive) Тяжелый Self-Hosted (Nextcloud) Syncthing на собственном VDS
Модель передачи данных Клиент-сервер (всё хранится в чужом облаке) Клиент-сервер (нагружает центральную СУБД) P2P Mesh (Block Exchange Protocol)
Потребление памяти (RAM) Собственные фоновые клиенты (150–300 МБ) От 1 до 2+ ГБ RAM (PHP-FPM, СУБД, кэш Redis) 60–120 МБ RAM (микросервис на Go)
Шифрование и приватность Ключи у провайдера, риск блокировок Зависит от плагинов (сложный E2EE) Нативный TLS v1.3 + Untrusted Device E2EE
Скорость в локальной сети Ограничена внешним интернет-каналом Идет через веб-сервер хостинга Прямой гигабитный обмен LAN/Wi-Fi (до 110 МБ/с)
Блочные дельты (диффы) Ограниченно (только для части проприетарных форматов) Передает файл целиком Передает строго измененные блоки (от 128 КБ) для любых файлов
Локализация и 152-ФЗ Хранение за рубежом, риски трансграничной передачи Соответствует при размещении сервера в РФ Локализация в РФ: физический VDS в отечественном ДЦ

Сетевое взаимодействие Syncthing организовано через четкое разделение сетевых портов и протоколов:

  • Протокол синхронизации BEP (Block Exchange Protocol): Работает на портах 22000/TCP и 22000/UDP (с поддержкой QUIC). Когда файл изменяется, Syncthing разбивает его на блоки фиксированного размера, хеширует каждый блок с помощью SHA-256 и передает на другие устройства исключительно изменившиеся части. Это экономит трафик и позволяет мгновенно синхронизировать даже огромные виртуальные образы дисков или базы данных при изменении нескольких килобайт.
  • Локальное обнаружение (Local Discovery): Использует широковещательные UDP-пакеты (порт 21027/UDP) внутри локальной сети (LAN/Wi-Fi). На публичном сервере VDS данный порт пробрасывать наружу не требуется, так как сервер взаимодействует с вашими устройствами через интернет по протоколу BEP и глобальные сервисы обнаружения.
  • Глобальное обнаружение (Global Discovery) и ретрансляция (Relays): Позволяет устройствам находить друг друга через защищенные криптографические идентификаторы (Device ID), даже если оба узла находятся за сложным провайдерским NAT. В случае невозможности прямого соединения трафик может маршрутизироваться через публичные или приватные релеи в зашифрованном виде (промежуточный сервер не имеет ключей для расшифровки).
  • Панель управления (Web GUI): Работает на порту 8384. В целях безопасности веб-панель публикуется строго на локальном интерфейсе 127.0.0.1 и защищается обратным прокси Nginx с SSL-сертификатом.

💡 Совет инженера

Зачем нужен VDS, если Syncthing — это P2P-система? В классическом P2P для передачи файла требуется, чтобы отправитель и получатель были одновременно включены и подключены к сети. Если вы закрыли ноутбук в дороге, а ваш домашний ПК включился только вечером — передача не состоится. Развертывание постоянного узла Syncthing на виртуальном сервере VDS с аптаймом 99.98% создает надежный буферный шлюз («Always-On Peer»). Сервер мгновенно забирает обновления, хранит актуальную копию файлов и синхронизирует остальные устройства в момент их появления в сети.

2. Системные требования к VDS и тюнинг ядра Linux (inotify и сетевой стек)

Благодаря компилируемому бинарному коду на Go, Syncthing крайне нетребователен к ресурсам процессора и оперативной памяти. Однако при синхронизации больших файловых деревьев (десятки тысяч файлов исходного кода, библиотеки документации или медиа-файлы) критически важна правильная конфигурация подсистемы уведомлений ядра Linux inotify.

Ресурс Базовый узел (до 50 тыс. файлов) Рабочая группа (до 250 тыс. файлов) Корпоративный хаб (от 500 тыс. файлов)
Процессор (vCPU) 1 vCPU (от 2.4 ГГц) 2 vCPU (от 3.0 ГГц) 4 vCPU (быстрое хеширование SHA-256)
Оперативная память (RAM) 512 МБ – 1 ГБ RAM 1–2 ГБ RAM 4 ГБ RAM (с запасом под кэш ОС)
Дисковый накопитель 20–40 ГБ NVMe 80–160 ГБ NVMe 300–1000 ГБ NVMe / SSD
Операционная система Ubuntu 22.04 / 24.04 LTS x86_64, Debian 12

Подключимся к виртуальному серверу по SSH, обновим системные пакеты, инсталлируем базовые утилиты и настроим критически важные параметры ядра:

# Обновление списков репозиториев и пакетов ОС
sudo apt update && sudo apt upgrade -y

# Установка необходимых сетевых и системных утилит
sudo apt install -y curl wget git ufw ca-certificates gnupg awscli

Хотя в современных ядрах дистрибутивов (Ubuntu 22.04 / 24.04 LTS) базовый лимит дескрипторов inotify увеличен со старых 8192 до 65536, при синхронизации объемных файловых деревьев (проекты разработки с node_modules, монорепозитории, архивы документации) этого значения быстро становится недостаточно. Syncthing вернет предупреждение Failed to install inotify handler и будет вынужден постоянно сканировать весь диск по таймеру, создавая паразитную нагрузку на CPU. Увеличим лимит дескрипторов до 204800 и оптимизируем сетевые буферы ядра для протокола QUIC:

# Создание файла системных настроек ядра для Syncthing
sudo tee /etc/sysctl.d/99-syncthing.conf <<EOF
# Увеличение лимита отслеживаемых дескрипторов файлов (inotify)
fs.inotify.max_user_watches=204800

# Увеличение максимального размера буферов приема и отправки сокетов для быстрого протокола QUIC (UDP)
net.core.rmem_max=4194304
net.core.wmem_max=4194304
EOF

# Применение новых параметров без перезагрузки сервера
sudo sysctl --system

Настроим межсетевой экран UFW. Обратите внимание: веб-порт 8384 не должен открываться во внешний мир — к нему будет обращаться только локальный обратный прокси Nginx. Открытыми остаются только порт SSH, порты веб-сервера (80/443) и рабочие порты протокола синхронизации BEP:

# Базовая политика: блокировать входящие, разрешать исходящие соединения
sudo ufw default deny incoming
sudo ufw default allow outgoing

# Разрешаем порты администрирования и веб-сервера
sudo ufw allow 22/tcp comment 'SSH'
sudo ufw allow 80/tcp comment 'HTTP Certbot'
sudo ufw allow 443/tcp comment 'HTTPS Nginx Reverse Proxy'

# Разрешаем порты синхронизации протокола BEP
sudo ufw allow 22000/tcp comment 'Syncthing Sync TCP'
sudo ufw allow 22000/udp comment 'Syncthing Sync QUIC UDP'

# Активация брандмауэра
sudo ufw --force enable
sudo ufw status verbose

Для быстрой проверки доступности сетевых портов снаружи воспользуйтесь онлайн-утилитой Port Checker на SysKit.

Инсталлируем среду контейнеризации Docker и плагин Docker Compose через официальный репозиторий Docker Engine:

# Загрузка и запуск официального скрипта установки Docker
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

# Добавление текущего пользователя в группу docker
# (Внимание: группа docker предоставляет права, эквивалентные root)
sudo usermod -aG docker $USER

# Создание изолированных каталогов проекта Syncthing
sudo mkdir -p /opt/syncthing/{config,data,backup,logs}
sudo chown -R $USER:$USER /opt/syncthing
cd /opt/syncthing

3. Манифест Docker Compose: запуск Syncthing v2.1.7, монтирование томов и права доступа

Для надежного развертывания мы используем официальный образ проекта от мейнтейнеров: syncthing/syncthing:v2.1.7. Контейнер содержит встроенный скрипт инициализации и утилиту su-exec для автоматического сброса привилегий до непривилегированного пользователя с заданными PUID и PGID.

Определим идентификаторы пользователя (UID) и группы (GID), под которыми будут сохраняться синхронизируемые файлы, с помощью команды id. Обычно для первого пользователя это 1000:1000:

# Определение UID и GID текущего пользователя
echo "UID: $(id -u), GID: $(id -g)"

# Создание конфигурационного файла переменных окружения
cat <<EOF > /opt/syncthing/.env
# Версия официального образа Syncthing
SYNCTHING_VERSION=v2.1.7

# Идентификаторы пользователя и группы для записи файлов
PUID=1000
PGID=1000

# Каталог конфигурации внутри контейнера (STHOMEDIR)
STHOMEDIR=/var/syncthing/config
EOF

# Защита файла переменных: доступ на чтение строго владельцу
chmod 600 /opt/syncthing/.env

Создадим манифест /opt/syncthing/docker-compose.yml. Обратите особое внимание на архитектуру сетевых интерфейсов: порт веб-интерфейса 8384 привязан строго к петлевому интерфейсу 127.0.0.1 (что исключает известный обход брандмауэра UFW через цепочки iptables Docker), а во внешний мир открываются только рабочие порты протокола синхронизации данных BEP (22000 TCP/UDP). Локальный широковещательный порт 21027/UDP (Local Discovery) на публичном VDS пробрасывать не требуется, так как клиентов в локальном сегменте дата-центра нет — это минимизирует площадь атаки:

services:
  syncthing:
    image: syncthing/syncthing:${SYNCTHING_VERSION:-v2.1.7}
    container_name: syncthing-node
    hostname: vds-syncthing-hub
    restart: unless-stopped
    # Ограничение ресурсов для защиты VDS от внезапного OOM Killer
    mem_limit: 512m
    cpus: 1.5
    environment:
      - PUID=${PUID:-1000}
      - PGID=${PGID:-1000}
      - STHOMEDIR=${STHOMEDIR:-/var/syncthing/config}
    ports:
      # Веб-интерфейс управления: строго на 127.0.0.1 (закрыт от прямого доступа снаружи)
      - "127.0.0.1:8384:8384"
      # Порт протокола обмена блоками BEP (TCP для надежной передачи)
      - "22000:22000/tcp"
      # Порт протокола BEP через QUIC (быстрая передача по UDP)
      - "22000:22000/udp"
    volumes:
      # Каталог конфигурации (содержит config.xml, cert.pem, key.pem и индексную базу)
      - ./config:/var/syncthing/config
      # Каталог синхронизируемых данных и рабочих папок
      - ./data:/var/syncthing/Sync
    healthcheck:
      # Официальный легковесный эндпоинт проверки работоспособности без авторизации
      test: ["CMD-SHELL", "curl -fkLsS -m 2 127.0.0.1:8384/rest/noauth/health | grep -o --color=never OK || exit 1"]
      interval: 30s
      timeout: 5s
      retries: 3
      start_period: 15s
    logging:
      driver: "json-file"
      options:
        max-size: "15m"
        max-file: "3"
    networks:
      - syncthing_net

networks:
  syncthing_net:
    driver: bridge

Для генерации индивидуальных конфигураций контейнеров и сервисов воспользуйтесь интерактивным генератором Docker Compose на SysKit.

Запустим службу Syncthing в фоновом режиме:

# Запуск контейнера в фоновом режиме
docker compose up -d

# Проверка статуса контейнера и прохождения проверки healthcheck
docker compose ps

4. Настройка Nginx с SSL Let's Encrypt, WebSocket и защитой панели управления

Панель управления Syncthing использует протокол WebSocket для передачи статуса синхронизации, скорости отдачи и прогресса скачивания в реальном времени. Обратный прокси Nginx обязан корректно обрабатывать заголовки Upgrade и Connection, перенаправлять весь трафик на защищенный протокол HTTPS и ограничивать частоту попыток подбора паролей к веб-интерфейсу.

Установим веб-сервер Nginx и утилиту автоматического получения сертификатов Certbot:

# Инсталляция Nginx и плагина Certbot для Nginx
sudo apt install -y nginx certbot python3-certbot-nginx apache2-utils

Выпустим доверенный бесплатный SSL-сертификат Let's Encrypt для вашего поддомена (например, sync.example.com). Перед выполнением команды убедитесь, что в DNS вашего домена создана A-запись, указывающая на IP-адрес вашего VDS:

# Выпуск SSL-сертификата Let's Encrypt через плагин аутентификации Nginx
sudo certbot certonly --nginx -d sync.example.com --agree-tos --no-eff-email -m admin@example.com

Создадим виртуальный хост Nginx /etc/nginx/sites-available/syncthing.conf с полной поддержкой WebSocket, оптимизацией буферов и изоляцией панели управления:

# Зона ограничения частоты запросов для защиты панели от brute-force атак
limit_req_zone $binary_remote_addr zone=syncthing_limit:10m rate=15r/s;

server {
    listen 80;
    listen [::]:80;
    server_name sync.example.com;

    # Автоматический редирект с незащищенного HTTP на HTTPS
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl http2;
    listen [::]:443 ssl http2;
    server_name sync.example.com;

    # Пути к сертификатам Let's Encrypt
    ssl_certificate /etc/letsencrypt/live/sync.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/sync.example.com/privkey.pem;

    # Надежные протоколы шифрования и параметры безопасности
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers HIGH:!aNULL:!MD5;
    ssl_prefer_server_ciphers on;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 1d;

    # Защитные заголовки браузера
    add_header X-Content-Type-Options nosniff always;
    add_header X-Frame-Options SAMEORIGIN always;
    add_header Referrer-Policy "no-referrer-when-downgrade" always;

    # Максимальный размер передаваемого тела запроса через веб-GUI
    client_max_body_size 50M;

    # Логирование запросов
    access_log /var/log/nginx/syncthing_access.log;
    error_log /var/log/nginx/syncthing_error.log;

    location / {
        # Применение лимита запросов
        limit_req zone=syncthing_limit burst=25 nodelay;

        # Проксирование на локальный порт 8384 контейнера
        proxy_pass http://127.0.0.1:8384;

        # Базовые заголовки проксирования
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        # Критически важная поддержка WebSocket для реалтайм-дашборда Syncthing
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";

        # Увеличенные таймауты для непрерывных сессий
        proxy_read_timeout 600s;
        proxy_send_timeout 600s;
    }
}

Для создания и тонкой настройки конфигураций веб-серверов воспользуйтесь интерактивным генератором Nginx Reverse Proxy на SysKit.

Активируем конфигурационный файл, проверим синтаксис и перезапустим Nginx:

# Создание символической ссылки в sites-enabled
sudo ln -sf /etc/nginx/sites-available/syncthing.conf /etc/nginx/sites-enabled/

# Проверка корректности синтаксиса конфигурации Nginx
sudo nginx -t

# Перезапуск службы Nginx
sudo systemctl reload nginx

Проверьте корректность работы выпущенного сертификата с помощью онлайн-утилиты SSL Checker на SysKit, чтобы убедиться в отсутствии проблем с цепочкой доверия и сроками действия.

🔒 Обязательная настройка безопасности веб-панели

При первом переходе по адресу https://sync.example.com браузер откроет панель управления Syncthing. Сразу перейдите в правый верхний угол: Действия (Actions) → Настройки (Settings) → Интерфейс (GUI). Обязательно установите Имя пользователя GUI и надежный Пароль GUI. Без установки пароля панель остается открытой для любого посетителя вашего домена!

5. Выбор оптимального VDS под роль круглосуточного узла синхронизации

Сервер, на котором запущен Syncthing, выполняет роль центрального координационного хаба («Always-On Node»). Его профиль нагрузки имеет выраженную специфику: в режиме ожидания потребление CPU близко к нулю, однако в момент синхронизации новых массивов данных активируются интенсивные дисковые операции записи и блочное хеширование SHA-256. При выборе виртуального сервера VDS необходимо учитывать следующие инженерные критерии:

  • Надежность дисковой подсистемы NVMe и ресурс IOPS: Синхронизация каталогов с сотнями тысяч мелких файлов (исходный код, репозитории Git, базы заметок Obsidian) создает огромное количество случайных операций чтения/записи метаданных. Скоростные NVMe-накопители корпоративного класса гарантируют отсутствие очередей ввода-вывода (I/O Wait) и моментальный отклик подсистемы inotify.
  • Безлимитный интернет-трафик и ширина канала: Поскольку Syncthing синхронизирует все изменения между вашими рабочими устройствами в фоновом режиме, трафик сервера может измеряться сотнями гигабайт или терабайтами в месяц. Выбирайте провайдеров с безлимитным трафиком и скоростью подключения от 100 Мбит/с до 1 Гбит/с, чтобы не сталкиваться со скрытыми платежами за перерасход канала.
  • Защита персональных данных и локализация по 152-ФЗ: При синхронизации рабочих баз 1С, бухгалтерских документов, сканов договоров и личных архивов критически важно исключить передачу данных через сторонние серверы в иностранной юрисдикции. Размещение сервера в сертифицированных дата-центрах уровня Tier III на территории РФ (Москва, Санкт-Петербург) обеспечивает выполнение базового требования ч. 5 ст. 18 закона № 152-ФЗ о первичной локализации баз данных граждан РФ на территории страны и исключает неконтролируемую трансграничную передачу.

💡 Совет инженера

Для личной синхронизации ноутбука, смартфона и домашнего ПК с объемом архива до 30–50 ГБ идеально подойдет базовый недорогой VDS с 1 vCPU, 1 ГБ RAM и 25–40 ГБ NVMe. Если же вы настраиваете резервный узел для офисной команды из 5–15 сотрудников с базами данных и графическими исходниками (от 200–500 ГБ), выбирайте тарифы с 2–4 vCPU, 2–4 ГБ RAM и подключением дополнительного блочного хранилища.

* Примечание редакции: Все представленные серверные конфигурации протестированы инженерами SysKit. Блок содержит партнерские ссылки рекомендательного характера, поддерживающие развитие открытой базы знаний платформы.

Рекомендуемые VDS-провайдеры

Отказоустойчивые сервера с быстрыми NVMe и каналом до 1 Гбит/с

Выбор редакции
⚡

Timeweb Cloud — Быстрые NVMe VDS

Сверхбыстрые NVMe-диски и безлимитный трафик для непрерывной P2P-синхронизации файлов без очередей ввода-вывода.

Конфигурация
1–2 vCPU 3.3 ГГц • 1–2 ГБ RAM • 25–40 ГБ NVMe • Трафик без лимита
Премиум Tier III
🔷

Selectel — Корпоративная надежность

Отказоустойчивая инфраструктура уровня Tier III в Москве и Санкт-Петербурге для хранения корпоративных синхронизируемых архивов.

Конфигурация
2 vCPU 3.4 ГГц • 2–4 ГБ RAM • 50 ГБ NVMe • Канал до 1 Гбит/с
Легкий старт
🟠

Beget — Простота и стабильность

Удобная панель управления, автоматическая установка Docker в 1 клик и доступные тарифы для персонального узла Syncthing.

Конфигурация
1 vCPU 3.0 ГГц • 1 ГБ RAM • 30 ГБ NVMe • Домен в подарок

6. Связывание устройств: обмен Device ID, шифрование на недоверенных узлах (Untrusted Node) и правила .stignore

Для объединения устройств в единую mesh-сеть используется криптографический идентификатор Device ID — уникальная строка длиной 52–56 символов Base32 (или 63 символа в каноническом представлении из 8 групп по 7 символов с дефисами), вычисляемая на основе публичного TLS-сертификата узла (cert.pem). Устройства соединяются только тогда, когда оба узла взаимно подтвердили добавление идентификаторов друг друга.

Процесс сопряжения вашего рабочего компьютера или смартфона с сервером VDS выглядит следующим образом:

  1. В веб-панели VDS перейдите в Действия (Actions) → Показать ID (Show ID) и скопируйте строку идентификатора (или отсканируйте QR-код в мобильном приложении Syncthing на Android).
  2. На рабочем компьютере или ноутбуке откройте локальный клиент Syncthing, в правом нижнем углу нажмите Добавить устройство (Add Remote Device), вставьте скопированный Device ID и укажите понятное имя (например, vds-hub).
  3. Через несколько секунд в веб-панели VDS появится всплывающее уведомление о входящем запросе на подключение. Нажмите Добавить устройство и подтвердите сопряжение.

Сквозное шифрование на недоверенных узлах (Untrusted Nodes / Zero-Knowledge)

Одной из мощнейших архитектурных возможностей Syncthing является режим Untrusted Node (Недоверенное устройство). Если вы синхронизируете сверхконфиденциальные документы, пароли или исходный код и хотите разместить копию на VDS, но опасаетесь возможной компрометации сервера, включите шифрование каталога:

  • При предоставлении общего доступа к папке (Folder Settings → Sharing) напротив устройства VDS установите галочку и в поле Password (Пароль) задайте надежную кодовую фразу.
  • На стороне клиента Syncthing выполнит локальное шифрование по официальной спецификации BEP: деривация ключей через scrypt, шифрование структуры имен файлов и токенов блоков по алгоритму AES-SIV (RFC 5297) для защиты от корреляции, а блоков данных — с аутентифицированным шифрованием.
  • На VDS файлы сохранятся в виде нечитаемых зашифрованных блоков и хэшированных имен (например, /data/Sync/5.syncthing-enc/3F/3FA8...). Даже администратор с полными правами root на сервере не сможет прочитать содержимое или узнать названия файлов.
  • При подключении второго доверенного компьютера (например, домашнего ПК) укажите ту же самую кодовую фразу, и файлы автоматически расшифруются на лету.

Исключение мусорных и временных файлов через .stignore

Для предотвращения бесконечной синхронизации временных файлов, блокировок баз данных и мусора операционных систем создайте в корне синхронизируемой папки файл .stignore со следующими правилами:

# Игнорирование системных файлов и метаданных ОС
(?d).DS_Store
(?d)Thumbs.db
(?d)desktop.ini
(?d)*.tmp
(?d)*.swp

# Игнорирование временных файлов офисных программ
~$*
.~lock.*

# Игнорирование сборочных каталогов и кэшей разработки
node_modules
.git
__pycache__
.venv
dist
build
.idea
.vscode

💡 Префикс (?d) в синтаксисе .stignore

Префикс (?d) разрешает Syncthing удалять эти файлы, если они препятствуют удалению родительского каталога. Без этого флага наличие системного файла .DS_Store или Thumbs.db приведет к ошибке Directory not empty при попытке удалить папку на других устройствах.

7. Защита от повреждения данных: версионирование файлов (Staggered File Versioning) и защита от шифровальщиков

Опасность любой непрерывной двусторонней синхронизации заключается в мгновенном распространении человеческих ошибок: если пользователь случайно удалил нужный документ или вирус-вымогатель зашифровал файлы на ноутбуке, клиент Syncthing тут же отправит команду на удаление или перезапись на все остальные узлы, включая VDS.

Для гарантированной защиты от таких сценариев активируйте встроенный механизм версионирования файлов. Откройте веб-панель на VDS, выберите синхронизируемую папку, нажмите Изменить (Edit) → Версионирование файлов (File Versioning) и выберите один из режимов:

  • Ступенчатое версионирование (Staggered File Versioning — Рекомендуется): Автоматически сохраняет версии по строгому экспоненциальному расписанию Syncthing:
    • В первый час: не чаще одной версии в 30 секунд;
    • В первые сутки: не чаще одной версии в час;
    • В первую неделю: не чаще одной версии в день;
    • В первый месяц: не чаще одной версии в неделю;
    • Далее: не чаще одной версии в месяц (вплоть до максимального возраста maxAge, по умолчанию 365 дней / 1 год).
  • Корзина версий (Trash Can File Versioning): При удалении или изменении файла старая копия перемещается в скрытый подкаталог .stversions и хранится заданное количество дней (например, 30 дней), после чего автоматически удаляется.
  • Простое версионирование (Simple File Versioning): Сохраняет фиксированное количество предыдущих копий (например, последние 5 версий).

Если на одном из рабочих компьютеров произойдет заражение криптолокером или случайное удаление проекта, все предыдущие чистые версии останутся в полной безопасности на VDS в каталоге .stversions и восстанавливаются в один клик через веб-интерфейс.

8. Резервное копирование конфигурации Syncthing, криптографических ключей и данных в S3

Критическая архитектурная особенность Syncthing: файлы /opt/syncthing/config/cert.pem и /opt/syncthing/config/key.pem определяют уникальный Device ID сервера. Если эти ключи будут утеряны при аварии диска, сгенерируется новый идентификатор устройства, и все сопряженные компьютеры и смартфоны перестанут доверять серверу. Поэтому резервное копирование каталога config является обязательным.

Создадим производственный скрипт резервного копирования /opt/syncthing/backup/backup.sh с отправкой архивов в отечественное S3-хранилище и оповещениями в Telegram:

#!/usr/bin/env bash
set -Eeuo pipefail

# Загрузка переменных окружения
if [[ -f /opt/syncthing/.env ]]; then
    set -a
    source /opt/syncthing/.env
    set +a
fi

BACKUP_DIR="/opt/syncthing/backup"
TIMESTAMP=$(date +"%Y%m%d_%H%M%S")
CONFIG_BACKUP="${BACKUP_DIR}/syncthing_config_${TIMESTAMP}.tar.gz"
DATA_BACKUP="${BACKUP_DIR}/syncthing_data_${TIMESTAMP}.tar.gz"

# Пароль для шифрования архива с ключами (рекомендуется задать в /opt/syncthing/.env)
BACKUP_PASSPHRASE="${BACKUP_PASSPHRASE:-SyncthingSecPass2026}"
CONFIG_ENCRYPTED="${CONFIG_BACKUP}.enc"

# Опциональные уведомления в Telegram Bot
TELEGRAM_BOT_TOKEN="${TELEGRAM_BOT_TOKEN:-}"
TELEGRAM_CHAT_ID="${TELEGRAM_CHAT_ID:-}"

# Параметры совместимого отечественного S3-хранилища (Timeweb Cloud, Selectel)
S3_ENDPOINT="${S3_ENDPOINT:-https://s3.timeweb.cloud}"
S3_BUCKET="${S3_BUCKET:-my-syncthing-backups}"

send_telegram() {
    local message="$1"
    if [[ -n "${TELEGRAM_BOT_TOKEN}" && -n "${TELEGRAM_CHAT_ID}" ]]; then
        curl -s -X POST "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage" \
            --data-urlencode "chat_id=${TELEGRAM_CHAT_ID}" \
            --data-urlencode "text=${message}" > /dev/null || true
    fi
}

echo "=== Запуск резервного копирования Syncthing: ${TIMESTAMP} ==="

# 1. Архивация конфигурации и криптографических ключей (cert.pem, key.pem, config.xml)
echo "Архивация конфигурации..."
tar -czf "${CONFIG_BACKUP}" -C "/opt/syncthing" config

# Сквозное шифрование архива с ключами через OpenSSL AES-256 перед отправкой в S3 (E2EE)
echo "Шифрование приватных ключей узла..."
openssl enc -aes-256-cbc -salt -pbkdf2 -iter 100000 -in "${CONFIG_BACKUP}" -out "${CONFIG_ENCRYPTED}" -pass pass:"${BACKUP_PASSPHRASE}"
rm -f "${CONFIG_BACKUP}"

# 2. Создание консистентного среза данных: кратковременная пауза процессов контейнера
echo "Приостановка процессов контейнера для атомарного среза данных..."
docker compose -f /opt/syncthing/docker-compose.yml pause syncthing > /dev/null 2>&1 || true

echo "Архивация пользовательских данных..."
tar --warning=no-file-changed -czf "${DATA_BACKUP}" -C "/opt/syncthing" data

echo "Возобновление работы контейнера..."
docker compose -f /opt/syncthing/docker-compose.yml unpause syncthing > /dev/null 2>&1 || true

chmod 600 "${CONFIG_ENCRYPTED}" "${DATA_BACKUP}"

CONFIG_SIZE=$(du -sh "${CONFIG_ENCRYPTED}" | cut -f1)
DATA_SIZE=$(du -sh "${DATA_BACKUP}" | cut -f1)

# 3. Синхронизация архивов с облачным S3-хранилищем
if command -v aws &> /dev/null && [[ -n "${S3_BUCKET}" ]]; then
    echo "Отправка зашифрованных архивов в S3-хранилище..."
    aws --endpoint-url="${S3_ENDPOINT}" s3 cp "${CONFIG_ENCRYPTED}" "s3://${S3_BUCKET}/syncthing/config/$(basename "${CONFIG_ENCRYPTED}")"
    aws --endpoint-url="${S3_ENDPOINT}" s3 cp "${DATA_BACKUP}" "s3://${S3_BUCKET}/syncthing/data/$(basename "${DATA_BACKUP}")"
fi

# 4. Локальная ротация архивов (хранение за последние 7 дней)
find "${BACKUP_DIR}" -type f \( -name "syncthing_*.tar.gz" -o -name "syncthing_*.enc" \) -mtime +7 -delete

echo "Резервное копирование успешно завершено."

# 5. Оповещение администратора в Telegram
MESSAGE="✅ Syncthing Hub Backup Успешно
Сервер: sync.example.com
Конфиг E2EE: $(basename "${CONFIG_ENCRYPTED}") (${CONFIG_SIZE})
Данные: $(basename "${DATA_BACKUP}") (${DATA_SIZE})
Хранилище: S3 (${S3_BUCKET})
Дата: $(date '+%Y-%m-%d %H:%M:%S')"

send_telegram "${MESSAGE}"

Назначим права на исполнение скрипта и добавим задачу в планировщик cron на запуск каждую ночь в 03:30:

# Назначение прав на исполнение скрипта
chmod 750 /opt/syncthing/backup/backup.sh

# Добавление регулярного задания в планировщик crontab
(crontab -l 2>/dev/null; echo "30 3 * * * /opt/syncthing/backup/backup.sh >> /opt/syncthing/logs/backup.log 2>&1") | crontab -

Для создания гибких расписаний запуска воспользуйтесь утилитой генератора выражений Crontab на SysKit.

Восстановление конфигурации и данных (Disaster Recovery)

В случае сбоя или переноса службы на новый сервер расшифруйте архив конфигурации и восстановите данные:

# 1. Остановка контейнера Syncthing
cd /opt/syncthing && docker compose stop syncthing

# 2. Расшифровка и распаковка архива конфигурации с ключами (Device ID сохраняется!)
openssl enc -d -aes-256-cbc -pbkdf2 -iter 100000 \
    -in /opt/syncthing/backup/syncthing_config_YYYYMMDD_HHMMSS.tar.gz.enc \
    -out /tmp/syncthing_config.tar.gz -pass pass:"ВашПарольБэкапа"
tar -xzf /tmp/syncthing_config.tar.gz -C /opt/syncthing && rm -f /tmp/syncthing_config.tar.gz

# 3. Распаковка пользовательских данных
tar -xzf /opt/syncthing/backup/syncthing_data_YYYYMMDD_HHMMSS.tar.gz -C /opt/syncthing

# 4. Запуск службы и проверка целостности
docker compose start syncthing
docker compose ps

9. Инженерный чек-лист проверки готовности и регламент обновления

Перед запуском активной синхронизации рабочих файлов выполните финальную верификацию параметров безопасности:

📋 Чек-лист готовности узла Syncthing к эксплуатации

  • Изоляция портов: Порт панели 8384 привязан строго к 127.0.0.1, прямой доступ снаружи закрыт, трафик проходит через Nginx с валидным SSL Let's Encrypt.
  • Пароль панели управления: В разделе Actions → Settings → GUI установлены надежное имя пользователя и пароль.
  • Сетевые порты BEP: Порты 22000/TCP и 22000/UDP открыты в брандмауэре UFW и корректно прослушиваются контейнером.
  • Тюнинг ядра: Параметр fs.inotify.max_user_watches=204800 применен через sysctl, ошибки inotify handler отсутствуют в логах.
  • Защита от сбоев: Для критически важных папок активировано ступенчатое версионирование (Staggered File Versioning).
  • Исключения мусора: В корень общих папок добавлен файл .stignore для фильтрации системных временных файлов и кэшей.
  • Тест резервного копирования: Скрипт backup.sh выполнен вручную, архив конфигурации с ключами cert.pem/key.pem успешно отправлен в S3.
  • Регламент планового обновления: Для обновления контейнера до свежих версий используйте команду: cd /opt/syncthing && docker compose pull && docker compose up -d.

Разверните независимый узел P2P-синхронизации на надежном VDS

Организуйте мгновенную синхронизацию рабочих файлов, заметок и бэкапов между всеми устройствами без сторонних облаков и с гарантией конфиденциальности на скоростных NVMe VDS в дата-центрах РФ.

Вопросы и ответы (FAQ)

Популярные вопросы вебмастеров и сисадминов по данной теме

В чем главное преимущество Syncthing перед облачными дисками (Google Drive, Dropbox, Nextcloud)?
Syncthing полностью децентрализован: файлы не хранятся на серверах третьих лиц и передаются напрямую между устройствами по блочному протоколу BEP с обязательным TLS-шифрованием. В отличие от тяжеловесного Nextcloud (требующего СУБД, Redis и от 2 ГБ RAM), легковесный сервис на Go потребляет всего 60–120 МБ оперативной памяти и работает без абонентской платы.
Зачем развертывать Syncthing на VDS, если это P2P-система?
В классическом P2P для передачи данных требуется одновременный онлайн обоих устройств. Развертывание узла на VDS создает постоянно доступный буферный шлюз (Always-On Peer): вы можете закрыть ноутбук в дороге, а домашний компьютер скачает измененные файлы с VDS в любой удобный момент.
Безопасно ли хранить конфиденциальные файлы на VDS в режиме Untrusted Node?
Да, абсолютно безопасно. В режиме Untrusted Node клиент шифрует все файлы по алгоритму AES-256-GCM и шифрует структуру каталогов еще до отправки на сервер. На VDS сохраняются исключительно нечитаемые зашифрованные блоки, прочитать которые без парольной фразы невозможно даже с полными root-правами на хосте.
Почему появляется ошибка "Failed to install inotify handler" и как её исправить?
Ошибка возникает из-за стандартного низкого лимита отслеживаемых файлов в ядре Linux (8192 дескриптора). При синхронизации крупных каталогов лимит исчерпывается. Проблема решается добавлением строки fs.inotify.max_user_watches=204800 в файл /etc/sysctl.d/99-syncthing.conf и выполнением команды sudo sysctl --system.

Читайте также в блоге SysKit

Смежные руководства и полезные технические статьи