Подключите совместимое с S3 хранилище к внешнему хранилищу Nextcloud.

Чтобы отобразить S3-совместимый сегмент в Nextcloud, включите встроенное приложение «Поддержка внешних хранилищ», добавьте точку монтирования Amazon S3 в настройках администрирования и введите данные сегмента, ключа доступа, секретного ключа и конечной точки поставщика. Для поставщиков, не являющихся Amazon, обычно наибольшее внимание требуют поля имени хоста и типа пути. Убедитесь, что точка монтирования активна (зеленый цвет), затем протестируйте с временным файлом, прежде чем предоставлять более широкий доступ.

Что подготовить

Эта процедура создает внешнее монтирование: Nextcloud подключается к существующему хранилищу и отображает его как папку в меню «Файлы». Она не переносит файлы в хранилище, не делает его основным хранилищем Nextcloud и не заменяет каталог данных Nextcloud.

• Доступ администратора: монтирование в масштабе всей системы настраивается в параметрах администрирования Nextcloud.
• Имя корзины и учетные данные: Получите идентификатор ключа доступа S3 и секретный ключ доступа от поставщика хранилища. Предпочтительно использовать выделенный ключ только с правами, необходимыми для этой корзины и ее предполагаемых операций.
• Данные для подключения: Получите общее имя хоста конечной точки S3 и, если это требуется провайдером, регион и требуемый формат пути. Не вставляйте URL-адрес, специфичный для конкретного сегмента, туда, где запрашивается имя хоста.
• Сеть и TLS: Сервер Nextcloud должен иметь возможность связаться с конечной точкой. Используйте HTTPS, если у провайдера нет конкретной, документально подтвержденной причины для другой конфигурации.

В руководстве администратора Nextcloud 35 описан бэкэнд Amazon S3 для Amazon S3 и совместимых сервисов. Провайдеры различаются по поведению API S3, формату конечных точек, региону подписи и необходимым разрешениям, поэтому обратитесь к странице настроек соответствующего провайдера для получения этих значений. Начните с нового или пустого бакета, или с четко изолированного тестового префикса, если вы не уверены в том, как будут выглядеть существующие объекты.

Включить поддержку внешних хранилищ

1. Войдите в систему как администратор Nextcloud и откройте раздел «Приложения» .
2. Найдите встроенное приложение поддержки внешних хранилищ и включите его, если оно отключено. Приложение входит в состав Nextcloud, но по умолчанию отключено.
3. Откройте меню своего профиля, выберите «Настройки» , а затем в разделе «Администрирование» выберите «Внешнее хранилище» .

Если бэкэнд не отображается в раскрывающемся списке хранилища, убедитесь, что приложение включено и что ваша учетная запись имеет права администратора. Названия пунктов меню могут немного отличаться в зависимости от версии; используйте соответствующую версию руководства администратора Nextcloud, если ваша установка выполнена не в версии 35.

Добавьте и настройте точку монтирования S3.

1. В новой строке хранилища укажите для монтирования простое имя папки , например Archive, . Это имя пользователи видят в Nextcloud; это не имя корзины и не путь. Не используйте косые черты.
2. В раскрывающемся списке параметров хранилища выберите Amazon S3 , а в качестве метода аутентификации — ключ доступа .
3. Введите имя корзины, идентификатор ключа доступа и секретный ключ доступа точно так, как они были выданы. Избегайте пробелов, добавленных при копировании и вставке. Рассматривайте секретный ключ как пароль; не размещайте его в общедоступном тикете, истории командной строки или на скриншоте статьи.
4. Для хранилища, размещенного на серверах Amazon, укажите регион корзины. Для сервиса, не принадлежащего Amazon, укажите его общее имя хоста S3 (хост конечной точки без префикса корзины). Укажите регион, если провайдер специально требует указания региона подписи; следуйте его документации, если используется такое значение, как auto.
5. Оставьте параметр «Включить SSL» выбранным для HTTPS. Оставьте порт по умолчанию, если провайдер не указал другой порт.
6. Сначала попробуйте использовать стиль запросов по умолчанию для виртуальных хостов. Включите стиль пути, если провайдер требует запросы со структурой, например, https://endpoint.example/bucketвместо https://bucket.endpoint.example. Руководство по S3 провайдера является источником достоверной информации об этой настройке.
7. Отключите устаревшую аутентификацию (v2), если только провайдер явно этого не требует. В документации Nextcloud указано, что аутентификация v4 используется по умолчанию, а аутентификация v2 требуется редко.
8. В разделе «Доступно для» выберите только тех пользователей или группы, которым должен быть доступен этот ресурс монтирования. Ресурс монтирования, созданный в настройках администратора, по умолчанию доступен широкому кругу пользователей, поэтому ограничьте его доступ, прежде чем предоставлять доступ к личным или общим данным.

Обязательные поля сохраняются после заполнения. Зеленый индикатор состояния означает, что Nextcloud может подключиться; желтый или красный индикатор означает, что проверка монтирования не удалась. Если ошибка сохраняется, щелкните значок состояния или перезагрузите страницу администрирования, чтобы проверить еще раз. Nextcloud отмечает, что ошибочное монтирование может быть помечено как недоступное в течение десяти минут.

Выбирайте поведение при езде обдуманно.

Откройте меню параметров строки, чтобы просмотреть настройки уровня монтирования. Совместное использование по умолчанию отключено; включайте его только в том случае, если пользователи должны обмениваться файлами с этого монтирования. Вы также можете установить режим монтирования только для чтения для справочных данных, включить предварительный просмотр там, где это необходимо, и выбрать, как часто Nextcloud проверяет наличие внешних изменений. Эти параметры влияют на поведение монтирования внутри Nextcloud; они не изменяют политику хранилища поставщика услуг хранения.

Не следует предполагать, что добавление точки монтирования мгновенно отобразит изменения в консоли провайдера в Nextcloud. Nextcloud поддерживает файловый кэш. Когда файлы создаются, изменяются или удаляются вне Nextcloud, кэшированный список может оставаться устаревшим до тех пор, пока сканирование не обновит его. Для S3 и других бэкэндов без push-уведомлений от провайдера Nextcloud документирует периодическое сканирование с помощью команды ` occ files_external:scan <mount_id>. Найдите идентификатор с помощью команды occ files_external:list`;`; запустите OCC из каталога установки Nextcloud от имени пользователя веб-сервера, адаптировав пользователя и оболочку команды к вашей установке.

Устранение неполадок с подключением

• Красный или желтый статус: перепроверьте точное написание названия корзины, пары ключей, имени хоста конечной точки, региона/региона подписи и доступа к сети на стороне сервера. Подтвердите доступ к DNS и исходящему HTTPS-трафику с хоста Nextcloud.
• Ошибка подписи или авторизации: Убедитесь, что ключ активен и имеет разрешение на просмотр содержимого корзины и выполнение необходимых пользователям операций. Проверьте, соответствует ли регион инструкциям по подписи поставщика. Учетные данные, позволяющие загружать данные, но не позволяющие просматривать или проверять содержимое корзины, могут по-прежнему не проходить проверку подключения Nextcloud.
• Конечная точка или корзина не найдены: Убедитесь, что имя хоста содержит общую конечную точку, а не URL-адрес, в который уже включена корзина. Спросите у провайдера, требуются ли запросы в формате пути, затем включите эту опцию и проверьте еще раз.
• Соединение установлено, но существующие объекты отсутствуют: убедитесь, что ключ может отображать содержимое корзины и что имена объектов используют поддерживаемые пути. Nextcloud предупреждает, что ключи S3, содержащие повторяющиеся разделители, такие как Photos//cat.png, и их содержимое игнорируются.
• Файлы, измененные непосредственно у провайдера, могут отсутствовать: запустите сканирование внешнего хранилища для монтирования. По возможности, выполняйте обычные переименования и перемещения внутри Nextcloud; повторное сканирование может интерпретировать удаленное переименование как удаление плюс новый файл, что может привести к потере общих ресурсов Nextcloud, тегов, комментариев или истории активности, связанных со старой записью.

Проверьте крепление в безопасном режиме.

Дождитесь, пока статус монтирования не станет зеленым. Откройте «Файлы» от имени пользователя из разрешенной области действия, откройте папку монтирования, загрузите небольшой тестовый файл с уникальным именем, скачайте его и удалите через Nextcloud. Если это возможно, убедитесь, что ожидаемый объект отображается в представлении корзины поставщика. Затем протестируйте со вторым пользователем, только если групповой доступ входит в план. Наконец, убедитесь, что пользователь вне выбранной области действия не может видеть монтирование. Удалите тестовый объект и сохраните учетные данные с минимальными привилегиями.

Описание полей для каждой версии см. в руководствах по настройке Nextcloud 35 Amazon S3 и администрированию внешнего хранилища Nextcloud 35 .