Команда fd "report*.pdf", введённая в SSH-сессии Synology NAS, возвращает ошибку command not found — и это первый признак того, что пакет SynoCli File Tools ещё не установлен или не подключен к PATH. Этот набор консольных утилит из репозитория SynoCommunity превращает стандартный BusyBox-шелл DiskStation в полноценную среду для работы с файлами: быстрый поиск, синхронизация с облаками, интерактивный фильтр и удобный редактор.
Ниже разберём, что входит в состав пакета, как его поставить через Центр пакетов, почему после установки команды могут не находиться и как безопасно использовать утилиты вроде rclone и fd без риска для данных на томах NAS.
Что такое SynoCli File Tools
SynoCli File Tools (имя пакета — synocli-file) — это метапакет сообщества SynoCommunity, который объединяет несколько популярных консольных утилит для работы с файлами. Он распространяется бесплатно и устанавливается как обычный пакет DSM, но не имеет графического интерфейса: все инструменты запускаются через SSH или задачи планировщика.
Состав пакета меняется от версии к версии, поэтому точный список стоит проверять в описании пакета в репозитории SynoCommunity. Типичные компоненты:
- 🔍 fd — быстрая альтернатива классической команде
findс простым синтаксисом. - 🎯 fzf — интерактивный нечёткий поиск по спискам файлов и выводу команд.
- ☁️ rclone — синхронизация и копирование файлов между NAS и облачными хранилищами.
- 📝 micro — удобный консольный текстовый редактор с подсветкой синтаксиса.
- 📊 ncdu — анализ занятого места на диске с навигацией по каталогам.
Установка пакета на DSM
Пакет отсутствует в официальном каталоге Synology, поэтому сначала подключается сторонний репозиторий. Откройте Центр пакетов, перейдите в Настройки → Источники пакетов и добавьте источник SynoCommunity, указав адрес https://packages.synocommunity.com. Точный адрес и поддержку вашей архитектуры процессора лучше сверить на сайте проекта — для некоторых старых моделей сборки могут отсутствовать.
После добавления источника найдите в Центре пакетов SynoCli File Tools и нажмите «Установить». Установка проходит без мастера настройки: утилиты сразу копируются в системный каталог пакета, обычно внутри /volume1/@appstore/synocli-file или аналогичного пути, который зависит от схемы установки SynoCommunity.
⚠️ Внимание: перед установкой сторонних репозиториев убедитесь, что в настройках Центра пакетов уровень доверия разрешает пакеты от сторонних издателей. Не понижайте этот уровень глобально без необходимости — верните исходное значение после установки.
☑️ Установка SynoCli File Tools
Почему команды не находятся после установки
Частая ситуация: пакет установлен, но оболочка отвечает command not found. Причина почти всегда в том, что каталог с исполняемыми файлами не входит в переменную PATH текущей SSH-сессии. Пакеты SynoCommunity обычно создают символические ссылки в системном каталоге, но оболочка могла быть запущена до установки.
Порядок диагностики простой:
- 🔄 Закройте SSH-сессию и подключитесь заново — PATH пересобирается при входе.
- 📂 Проверьте, где лежат бинарники:
ls /var/packages/synocli-file/target/bin(путь может отличаться в зависимости от версии пакета). - ➕ При необходимости добавьте каталог в PATH через профиль пользователя, например в
~/.profile.
export PATH=$PATH:/var/packages/synocli-file/target/binЕсли файлов нет и в каталоге пакета — проверьте в Центре пакетов, что пакет действительно запущен, а не остановлен с ошибкой. В журнале пакета DSM обычно видно причину сбоя.
Практическое использование основных утилит
Поиск файлов через fd
Вместо громоздкой конструкции find /volume1 -name "*.tmp" достаточно ввести:
fd .tmp /volume1Утилита по умолчанию игнорирует скрытые каталоги и файлы из .gitignore, работает заметно быстрее классического find и подсвечивает совпадения. Для поиска по содержимому внутри каталогов DSM она не предназначена — для этого лучше подходит grep, входящий в базовую систему.
Синхронизация с облаками через rclone
rclone — самый востребованный компонент набора. Сначала выполняется интерактивная настройка подключения:
rclone configЗатем данные копируются или синхронизируются одной командой, например:
rclone sync /volume1/backup remote:backup --progress⚠️ Внимание: командаrclone syncделает целевой каталог точной копией источника и удаляет на приёмнике всё, чего нет в источнике. Перед первым запуском протестируйте операцию с флагом--dry-run, чтобы увидеть список планируемых изменений без реального копирования и удаления.
Анализ дискового пространства через ncdu
Когда том заполнен, а в File Station непонятно, куда ушло место, запустите ncdu /volume1. Утилита просканирует каталоги и покажет интерактивный список, отсортированный по размеру. Навигация — стрелками, удаление выбранного элемента — клавишей d с подтверждением. Сканирование большого тома занимает время и нагружает диски, поэтому на production-системе лучше запускать его в период низкой активности.
Сравнение утилит пакета
| Утилита | Назначение | Альтернатива в DSM | Интерактивность |
|---|---|---|---|
| fd | Поиск файлов по имени | find (BusyBox) | Нет |
| fzf | Нечёткий фильтр списков | Нет прямого аналога | Да |
| rclone | Синхронизация с облаками | Cloud Sync (GUI) | Частично |
| micro | Редактирование файлов | vi, Text Editor | Да |
| ncdu | Анализ занятого места | Анализатор хранилища | Да |
Выбор между консольными утилитами и штатными приложениями DSM зависит от задачи. Cloud Sync удобнее для простой настройки через мастер, но rclone гибче в фильтрах, шифровании и поддерживает больше провайдеров. Аналогично Text Editor из Центра пакетов проще для правки одного файла, а micro выигрывает при постоянной работе по SSH.
Как проверить версию установленных утилит
Каждая утилита поддерживает флаг версии: fd --version, rclone version, fzf --version, micro --version. Версии фиксируются на момент сборки пакета SynoCommunity и обновляются только вместе с обновлением самого пакета.
Обновление и удаление пакета
Обновления приходят через Центр пакетов, как и для штатных приложений DSM: при появлении новой сборки в репозитории SynoCommunity рядом с пакетом появится кнопка «Обновить». Отдельно обновить, скажем, только rclone внутри набора нельзя — это единый монолитный пакет.
При удалении пакета исполняемые файлы стираются, но конфигурации обычно остаются. Настройки rclone хранятся в домашнем каталоге пользователя, под которым выполнялась команда rclone config (типичный путь — ~/.config/rclone/rclone.conf). Если планируете переустановку, конфиг можно сохранить; если пакет убирается насовсем — удалите и его, чтобы не оставлять токены доступа к облакам на диске.
Типичные проблемы и их решение
Если rclone при подключении к облаку выдаёт ошибку авторизации, первым делом проверьте системное время на NAS — при существенном расхождении OAuth-токены отклоняются. Синхронизацию времени по NTP можно включить в Панель управления → Региональные параметры → Время.
Вторая частая жалоба — «команда работает от root, но не работает от обычного пользователя». Здесь дело либо в PATH (он настраивается отдельно для каждого пользователя), либо в правах на конфигурационные файлы: конфиг rclone, созданный под root, недоступен другому пользователю. Решение — выполнять настройку под той учётной записью, от которой будет запускаться задача.
⚠️ Внимание: работа по SSH с правами root обходит часть механизмов защиты DSM. Заводите отдельную учётную запись для скриптов, ограничивайте её права только нужными общими папками и отключайте SSH, когда он не используется.
Частые вопросы о SynoCli File Tools
Есть ли у пакета графический интерфейс в DSM?
Нет. SynoCli File Tools — это набор консольных программ. Иконка в Центре пакетов служит только для установки, запуска и остановки пакета; вся работа ведётся через SSH или задачи планировщика.
Чем SynoCli File Tools отличается от Entware?
Entware — это полноценный менеджер пакетов с тысячами программ, устанавливаемый в обход Центра пакетов. SynoCli File Tools — официально оформленный SPK-пакет с фиксированным набором утилит, который проще ставится и обновляется, но не расширяется произвольно.
Поддерживает ли пакет мою модель NAS?
Совместимость зависит от архитектуры процессора и версии DSM. Перед установкой проверьте страницу пакета на сайте SynoCommunity — там перечислены поддерживаемые архитектуры. Для очень старых моделей сборки могут отсутствовать.
Безопасно ли запускать rclone sync по расписанию?
Да, при условии, что команда сначала протестирована с флагом --dry-run и направление синхронизации выбрано правильно. Ошибка в порядке аргументов «источник — приёмник» приведёт к удалению нужных данных, поэтому тестовый прогон обязателен.
Что делать, если после обновления DSM пакет перестал запускаться?
Крупные обновления DSM иногда ломают совместимость сторонних пакетов. Проверьте журнал пакета в Центре пакетов, затем наличие обновлений в репозитории SynoCommunity. Если сборки под новую версию DSM ещё нет, остаётся ждать её выпуска — принудительная переустановка проблему совместимости не решит.