Resilio Sync на Ubuntu 22.04 — установка и настройка

TL;DR

Resilio Sync — пиринговый инструмент для синхронизации файлов, который работает без центрального сервера. В этой статье показано, как добавить официальный репозиторий, установить пакет на Ubuntu 22.04, запустить службу, открыть доступ к веб‑интерфейсу и выполнить базовую настройку безопасности и прав доступа.

Введение

Логотип или интерфейс Resilio Sync

Resilio Sync — проприетарный P2P-инструмент для синхронизации файлов, доступный для Linux, FreeBSD, macOS, Windows, Android, iOS и NAS. Он использует протокол BitTorrent для передачи данных и не требует централизованного хранилища: достаточно установить агент на узлах и обмениваться папками.

Ключевые возможности:

Отправка больших файлов (в обход лимитов почты).
Генерация защищённых ссылок для шаринга.
Высокая скорость и надёжность через P2P.
Управление правами доступа и динамическое изменение разрешений.
Контроль использования полосы пропускания и удалённый доступ.

Важно: Resilio Sync — проприетарное ПО. Ознакомьтесь с лицензионными условиями перед развёртыванием в продакшне.

Предварительные требования

Сервер с Ubuntu 22.04.
Доступ root или пользователь с правами sudo.
Базовые знания работы с APT и systemd.

Обновление системы

Перед установкой обновите пакеты:

apt update -y
apt upgrade -y

После обновлений переходите к добавлению репозитория.

Добавление репозитория Resilio Sync

Репозиторий Resilio отсутствует в стандартных пакетах Ubuntu, поэтому добавим официальный репозиторий.

Установите зависимости:

apt-get install gnupg2 curl wget git software-properties-common acl -y

Загрузите и импортируйте GPG‑ключ:

wget http://linux-packages.resilio.com/resilio-sync/key.asc
apt-key add key.asc

Добавьте репозиторий APT:

add-apt-repository "deb http://linux-packages.resilio.com/resilio-sync/deb resilio-sync non-free"

Обновите индексы пакетов:

apt-get update -y

Установка Resilio Sync

Установите пакет:

apt-get install resilio-sync -y

Запустите и включите автозапуск службы:

systemctl start resilio-sync
systemctl enable resilio-sync

Проверьте статус службы:

systemctl status resilio-sync

Ожидаемый пример вывода (для проверки):

? resilio-sync.service - Resilio Sync service
     Loaded: loaded (/lib/systemd/system/resilio-sync.service; disabled; vendor preset: enabled)
     Active: active (running) since Tue 2022-12-13 06:01:06 UTC; 15s ago
       Docs: https://help.resilio.com
    Process: 95865 ExecStartPre=/bin/mkdir -p ${SYNC_RUN_DIR} ${SYNC_LIB_DIR} (code=exited, status=0/SUCCESS)
    Process: 95866 ExecStartPre=/bin/chown -R ${SYNC_USER}:${SYNC_GROUP} ${SYNC_RUN_DIR} ${SYNC_LIB_DIR} (code=exited, status=0/SUCCESS)
    Process: 95867 ExecStart=/usr/bin/rslsync --config ${SYNC_CONF_DIR}/config.json (code=exited, status=0/SUCCESS)
    Process: 95869 ExecStartPost=/bin/sleep 1 (code=exited, status=0/SUCCESS)
   Main PID: 95868 (rslsync)
      Tasks: 16 (limit: 2238)
     Memory: 13.2M
        CPU: 62ms
     CGroup: /system.slice/resilio-sync.service
             ??95868 /usr/bin/rslsync --config /etc/resilio-sync/config.json

Dec 13 06:01:05 ubuntu2204 systemd[1]: Starting Resilio Sync service...
Dec 13 06:01:06 ubuntu2204 systemd[1]: Started Resilio Sync service.

По умолчанию Resilio Sync слушает локально на порту 8888. Проверьте это:

ss -antpl | grep 8888

Ожидаемый пример:

LISTEN 0      10         127.0.0.1:8888       0.0.0.0:*    users:(("rslsync",pid=95868,fd=16))

Конфигурация: доступ извне

По умолчанию веб‑интерфейс доступен только локально (127.0.0.1). Чтобы открыть доступ с других устройств, измените конфигурацию.

Откройте файл конфигурации:

nano /etc/resilio-sync/config.json

Найдите и измените секцию webui так, чтобы слушать IP вашего сервера (замените your-server-ip на реальный адрес):

{
    "storage_path" : "/var/lib/resilio-sync/",
    "pid_file" : "/var/run/resilio-sync/sync.pid",

    "webui" :
    {
        "force_https": true,
        "listen" : "your-server-ip:8888"
    }
}

Сохраните файл и перезапустите службу:

systemctl restart resilio-sync

Важно: при включённом force_https Resilio ожидает HTTPS‑терминатора (например, обратный прокси с TLS). Если вы напрямую слушаете порт 8888 и не настроили TLS, временно установите “force_https”: false для первой настройки, а затем разверните прокси с TLS.

Настройка прав и папки для шаринга

Создайте папку для шаринга и добавьте тестовые файлы:

mkdir -p /mnt/files/
touch /mnt/files/doc1.txt
touch /mnt/files/doc2.txt

Установите права доступа для пользователя rslsync (демон):

setfacl -R -m "u:rslsync:rwx" /mnt/files

Проверьте владельца, права и ACL:

ls -ld /mnt/files
getfacl /mnt/files

Настройка межсетевого экрана (Firewall)

Если вы используете ufw, откройте порт только для нужных адресов и/или введите правило для порта 8888:

ufw allow proto tcp from /32 to any port 8888

Или, если доступ нужен публично (не рекомендуется без TLS):

ufw allow 8888/tcp

Совет: для публичного доступа используйте обратный прокси (nginx или Caddy) с TLS и ограничением доступа по IP/аутентификацией.

Доступ к веб‑интерфейсу (Web UI)

Откройте браузер и перейдите по URL:

https://your-server-ip:8888/

Вы будете перенаправлены на страницу создания администратора.

Страница создания администратора Resilio Sync

Установите имя администратора и пароль, затем нажмите «Continue».

Настройка имени сервера Resilio Sync

Укажите имя узла и нажмите «Get started».

Главная страница Resilio Sync после настройки

Добавьте папку через интерфейс: нажмите «+», выберите «Standard folder», укажите локальную папку (/mnt/files) и нажмите «Open».

Выбор папки для шаринга

Выбор стандартной папки

Перейдите на вкладку “Link” для генерации ссылок совместного доступа. Скопируйте ссылку и откройте её на удалённом устройстве.

Генерация ссылки на папку

После присоединения удалённого устройства вы увидите папку в интерфейсе клиента:

Просмотр подключённой папки на удалённом устройстве

Безопасность и рекомендации

Всегда разворачивайте TLS терминатор (nginx/HAProxy/Caddy) перед публичным доступом к веб‑интерфейсу.
Создавайте сильный пароль администратора и ограничьте доступ по IP, если возможно.
Регулярно делайте резервные копии папки конфигурации: /etc/resilio-sync/config.json и /var/lib/resilio-sync/.
Для корпоративного окружения рассмотрите VLAN/сегментацию сети и мониторинг активности.

Пример nginx-конфигурации (обёртка TLS, proxy_pass на внутренний порт):

server {
    listen 443 ssl;
    server_name resilio.example.com;

    ssl_certificate /etc/letsencrypt/live/resilio.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/resilio.example.com/privkey.pem;

    location / {
        proxy_pass http://127.0.0.1:8888/;
        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_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

Важно: при использовании обратного прокси оставьте “force_https”: true и убедитесь, что прокси корректно проксирует HTTPS‑заголовки.

Отладка и распространённые проблемы

Если служба не запускается: проверьте журналы systemd:

journalctl -u resilio-sync -b --no-pager

Если веб‑интерфейс недоступен: проверьте ss/ss/netstat на порту 8888 и правила фаервола.
Проблемы с правами файлов: проверьте владельца и ACLs, убедитесь, что пользователь rslsync имеет доступ.
HTTPS‑ошибки при проксировании: проверьте заголовки X‑Forwarded и наличие сертификатов.

Чек‑лист перед вводом в эксплуатацию

Для администратора:

Репозиторий добавлен и пакет обновлён.
Служба resilio-sync запущена и включена в autostart.
Web UI защищён TLS и доступ ограничен.
Права на шаримые папки настроены (ACLs).
Создана резервная копия конфигурации.

Для пользователя:

Получена рабочая ссылка для папки.
Файлы синхронизируются между узлами.
Понимаются базовые права доступа (чтение/запись).

Сценарии тестирования (acceptance)

Установка должна пройти без ошибок: команда apt-get возвращает код 0.
Служба должна быть active (running) через systemctl.
Веб‑интерфейс должен открываться по https://your-server-ip:8888/ (или через прокси) и позволять создать администратора.
Добавленная папка /mnt/files должна отображаться в интерфейсе и быть доступной для подключения по ссылке.
При подключении удалённого узла файлы doc1.txt и doc2.txt должны появиться на клиенте.

Откат и удаление

Если нужно быстро удалить Resilio Sync:

systemctl stop resilio-sync
apt-get remove --purge resilio-sync -y
rm -rf /etc/resilio-sync /var/lib/resilio-sync

Удалите также добавленный репозиторий из /etc/apt/sources.list.d/ или через add-apt-repository –remove.

Полезные команды (cheat sheet)

Проверить статус службы: systemctl status resilio-sync
Перезапустить службу: systemctl restart resilio-sync
Просмотреть журналы: journalctl -u resilio-sync -f
Проверить порт: ss -antpl | grep 8888
Открыть порт в ufw: ufw allow 8888/tcp

Критерии приёмки

Установочный скрипт проходит без ошибок на чистой Ubuntu 22.04.
Веб‑интерфейс доступен и авторизация администратора работает.
Файлы синхронизируются между двумя узлами при подключении по ссылке.
TLS настроен и фаервол ограничивает доступ.

Роли и обязанности

Администратор:

Устанавливает и обновляет пакет.
Настраивает обратный прокси и TLS.
Управляет правами доступа и резервным копированием.

Пользователь:

Инициирует шаринг папок через Web UI.
Подключается к полученным ссылкам и проверяет синхронизацию.

Заключение

В этой инструкции показаны шаги по установке и первоначальной настройке Resilio Sync на Ubuntu 22.04: добавление репозитория, установка пакета, базовая безопасность, права доступа и проверка работы через веб‑интерфейс. Для продакшн‑использования рекомендуется настроить TLS‑терминатор и ограничить сетевой доступ.

Если у вас остались вопросы по настройке прокси, TLS или прав доступа — напишите, укажу конкретные конфигурации и нюансы для вашего окружения.

Важно: в статьях приведены практические команды; используйте их аккуратно на продакшн‑сервере. Проверяйте конфигурации и делайте резервные копии перед изменениями.