Подключение NAS к Reverse SSH и Docker в качестве отдельного хранилища (пример QNAP)

О чем эта статья

При работе с Reverse SSH Вы самостоятельно устанавливаете исходящее зашифрованное соединение (туннель) к PaperOffice. Проброс портов в роутере не требуется. PaperOffice AI сохраняет зашифрованные документы пользователя Workspaces на Вашем устройстве NAS.

Создайте хранилище перед созданием Workspace. Режим хранилища для Workspaces после создания изменить невозможно.

Шаг 1: Подготовка NAS (пример QNAP)

Меню в QTS могут незначительно отличаться в зависимости от версии QTS.

  1. Создайте собственную общую папку, например paperoffice, а не папку от PaperOffice Classic или MariaDB.
  2. Разрешите SSH и SFTP в разделе Панель управления › Сетевые и файловые службы › Telnet / SSH.
  3. В разделе «Изменить права доступа» укажите пользователя NAS, от имени которого Вы будете выполнять вход. Если этот пользователь отсутствует в списке, система NAS откажет в SSH-входе.
  4. Установите Container Station (Docker). Предложенную общую папку для контейнеров можно оставить без изменений.

Synology: Container Manager, активирована служба домашних каталогов пользователей, пользователь входит в группу administrators. ASUSTOR: Docker Engine. UGREEN: Docker.

Шаг 2: Создание хранилища в PaperOffice AI

  1. Откройте Document AI › Storage Mounts и нажмите на Добавить Storage Mount.
  2. Поля, отмеченные красной звездочкой (*), являются обязательными.
  3. Название для этого Storage Mount: выбирается произвольно.
  4. Назначение платежа: Использовать как BYOS-Storage.
  5. Тип соединения: Подключить локальную папку через Reverse-SSH.
  6. Ваш NAS: Выберите QNAP. Приложение затем предложит вариант /share/paperoffice (Synology, ASUSTOR, UGREEN: /volume1/paperoffice).
  7. Локальный пользователь SSH: Ваш пользователь на устройстве NAS. Он должен входить в группу администраторов.
  8. Локальная папка: полный путь к папке; для QNAP это /share/<Name des Freigabeordners>. Без кавычек, обратных слешей и * ? [ ]. Папку и пользователя позже изменить нельзя.
  9. Пароль шифрования и Подтвердите пароль: минимум 16 символов, либо используйте функцию Сгенерировать безопасный пароль (иконка ключа).
  10. Нажмите на Скачать как .txt. Только после этого можно создать хранилище. Надежно сохраните файл: без пароля восстановление невозможно.
  11. Установите флажок подтверждения и сохраните.

Шаг 3: Выбор правильного блока настройки

После сохранения откроется окно Настройка Reverse-SSH с Вашим Псевдоним туннеля. Вверху выберите вариант:

  • NAS с Docker: блок, запускающий небольшой контейнер-туннель. Для QNAP с Container Station это правильный выбор.
  • NAS без Docker: блок 1 один раз через SSH, блок 2 в автозагрузку.
  • Linux / macOS и Windows: для компьютеров.

Скопируйте блок с помощью Копировать настройку. В случае с NAS без Docker у каждого из двух блоков есть своя кнопка.

Шаг 4: Войдите в систему на NAS и вставьте блок

Например, под Windows с помощью PuTTY (названия могут незначительно отличаться в зависимости от версии):

  1. В поле Host введите IP-адрес Вашего NAS в домашней сети, порт 22 и откройте соединение.
  2. Войдите в систему с помощью пользователя NAS из шага 2. При вводе пароля символы не отображаются. Это нормально.
  3. Если QNAP после входа показывает консольное меню (например, «Console Management»), выйдите из него в обычную командную строку, например, с помощью Q и затем Y.
  4. Вставьте блок правой кнопкой мыши в окно. После этого нажмите Enter.

На Mac: программа Terminal, затем ssh <Benutzer>@<IP-Adresse des NAS>.

Блок нужно вставлять только в это окно на NAS. Для NAS требуется доступ в Интернет: туннель строится от Вашего NAS наружу, а контейнер при запуске загружает небольшой пакет Linux.

Шаг 5: Проверка соединения

  1. Откройте хранилище на Storage Mounts с помощью Редактировать.
  2. Нажмите на Проверить соединение (доступно только после сохранения).
  3. Успех: «Туннель активен: NAS доступен и папка доступна для записи». После этого создайте Ваш Workspace с помощью Собственное хранилище (BYOS).

Если тест сообщает об отказе в доступе, проверьте пользователя NAS и список доступа из шага 1. Затем снова введите настройку как зарегистрированный пользователь NAS и протестируйте еще раз.

Что показывает трассировка

В обзоре Проверить соединение запускает трассировку с картой для PaperOffice. Для Reverse SSH целевым сервером туннеля является сервер PaperOffice, а не Ваш NAS. Указанные местоположения представляют собой сетевые узлы на этом пути, а не место хранения Ваших файлов.

После перезагрузки

Контейнер туннеля автоматически запускается после каждой перезагрузки, как только запущен Docker. При разрыве соединения он переподключается через 10 секунд. Без Docker блок 2 в автозапуске обеспечивает эту функцию.

Безопасность: Блок настройки содержит закрытый ключ

Блок содержит закрытый ключ и использует его в качестве учетных данных для входа в Ваш пользовательский аккаунт NAS. Тот, кто имеет доступ к блоку, может выдать себя за Ваш туннель и войти в систему как Ваш пользователь NAS, если служба SSH Вашего NAS доступна для него. Ваш пароль шифрования не содержится в блоке.

  • Никогда не вставляйте блок в чаты, к AI-ассистентам, электронные письма или тикеты поддержки.
  • Поддержка не нуждается в этом блоке. Вместо этого сообщите сообщение об ошибке теста.

Wenn es doch passiert ist:

  1. Удалите сообщение там, где это возможно.
  2. Кнопки «Сгенерировать ключ заново» не существует. При редактировании ключ остается неизменным.
  3. Если Workspace еще не использует хранилище: удалите Storage Mount. PaperOffice удаляет ключ с сервера туннеля; файлы на NAS остаются. Создайте хранилище заново (новый ключ, новый псевдоним туннеля), используя тот же пароль шифрования или пустую папку.
  4. Удалите старый ключ на NAS: в папке .ssh Вашего пользователя NAS удалите строку в authorized_keys, которая заканчивается на «PaperOffice» и старый псевдоним туннеля, а также файл paperoffice_<alter Tunnel-Alias>. С помощью Docker: удалите в Вашем интерфейсе Docker (QNAP: Container Station) старый контейнер, имя которого начинается с paperoffice-tunnel-. Без Docker: удалите в той же папке .ssh скрипт paperoffice_tunnel_<alter Tunnel-Alias>.sh и удалите старую запись из автозапуска.
  5. Если хранилище уже использует другой Workspace, его нельзя удалить. В этом случае создайте тикет в приложении по адресу Поддержка и укажите, что ключ стал доступен извне. Не вставляйте блок.

Далее