Добавление канала WebDAV

Когда это лучший вариант

Используйте канал WebDAV, если:

• у вас есть NAS, облачный диск или объектное хранилище с WebDAV endpoint;
• хотите хранить загруженные изображения в собственной WebDAV-директории;
• хотите сохранять учетные данные в таблице D1 upload_channels, а не держать их надолго открытыми на фронтенде.

Что подготовить заранее

Что нужно	Зачем это нужно
WebDAV Endpoint	Серверный WebDAV URL, например https://nas.example.com/dav.
Username	Имя пользователя для входа в WebDAV-сервис.
Password	Пароль для входа в WebDAV-сервис.
Authentication mode	По умолчанию Basic. Используйте Digest или автоматическое согласование только если это требует сервер.
Storage directory	Директория для хранения файлов. По умолчанию imgbed.

Где добавить канал

1. Откройте системные настройки.
2. Перейдите в настройки загрузки.
3. Нажмите Add Channel в правом верхнем углу.
4. Выберите WebDAV.

Поля настройки

Поле	Что означает	Обязательно
Название канала	Понятное имя WebDAV-канала, например koofr или nas.	Да
Endpoint	Полный WebDAV endpoint, включая https://.	Да
Username	Имя пользователя WebDAV.	Да
Password	Пароль WebDAV.	Да
Authentication mode	Обычно Basic; используйте Digest, если сервер требует digest authentication.	Да
Storage directory	Директория, где хранятся файлы. По умолчанию imgbed.	Нет

Пример: fie.nl.tab.digital

1. Создайте app password

Откройте настройки безопасности аккаунта, найдите application passwords и создайте новый app password.

После создания скопируйте и сохраните новый app password. Обычно он показывается только один раз.

2. Заполните WebDAV-конфигурацию в ImgBed

Вернитесь в ImgBed и добавьте WebDAV-канал:

Поле в интерфейсе	Значение
Endpoint	WebDAV URL, предоставленный https://fie.nl.tab.digital/.
Username	Ваш WebDAV username.
Password	App password, который вы только что создали.
Authentication mode	В большинстве случаев начните с Basic.
Storage directory	По умолчанию imgbed; при необходимости можно указать свою директорию.

Поведение при загрузке больших файлов

Канал WebDAV использует настоящее session-based chunked upload.

Небольшие файлы загружаются как один цельный файл. Файлы больше 64 MiB автоматически делятся на части примерно по 10 MiB и загружаются в удаленную директорию чанков.

WebDAV-сервису не нужно поддерживать partial update или запись по offset. ImgBed не склеивает чанки в один большой файл на удаленном сервере. Вместо этого он хранит manifest чанков и читает их по порядку, когда файл запрашивают.

На практике:

Размер файла	Способ загрузки	Структура в удаленном хранилище
64 MiB или меньше	Обычная загрузка	Один цельный файл
Больше 64 MiB	Настоящее session chunked upload	Директория чанков с несколькими файлами-частями

Директория чанков влияет только на структуру удаленного хранилища. Она не меняет URL файла в ImgBed. Пользователи по-прежнему открывают файл через исходную ссылку /file/....

Настройка

1. Откройте настройки загрузки.
2. Нажмите Add Channel.
3. Выберите WebDAV.
4. Введите понятное имя канала, например koofr.
5. Введите WebDAV endpoint, например https://app.koofr.net/dav/Koofr.
6. Введите username и password.
7. По умолчанию оставьте authentication mode как Basic.
8. Оставьте storage directory как imgbed или измените на свою директорию.
9. Нажмите Save.
10. После сохранения проверьте карточку канала, по возможности запросите емкость и загрузите тестовый файл.

Как проверить

Проверка	Как проверить
Карточка канала появилась	После сохранения на странице настроек загрузки должна появиться карточка WebDAV-канала.
Канал включен	Переключатель в правом верхнем углу карточки должен оставаться включенным.
Учетные данные сохранены	В деталях должны отображаться Endpoint, username, authentication mode и storage directory.
Небольшой файл загружается	Загрузите тестовое изображение и убедитесь, что файл появился в WebDAV-директории.
Правило для больших файлов работает	Файлы больше 64 MiB используют chunked upload и создают удаленную директорию чанков.
Запрос емкости работает	Если сервер поддерживает информацию об емкости, запрос покажет использованный и общий объем.

FAQ

Почему большие WebDAV-файлы создают директорию чанков?

Это текущий способ хранения больших файлов.

Файлы больше 64 MiB не склеиваются в один большой удаленный файл. Они хранятся как директория чанков. ImgBed записывает manifest чанков и возвращает полный контент, читая части по порядку.

Что проверить в первую очередь, если большая загрузка не работает?

Сначала проверьте Endpoint, username, password и storage directory. Затем убедитесь, что WebDAV-сервис разрешает создание директорий, запись файлов и чтение файлов.

Если запрос емкости не работает, но небольшой файл загружается, сервер может просто не поддерживать или ограничивать отчет об емкости. Это не обязательно означает, что загрузка недоступна.

Какой authentication mode выбрать?

Начните с Basic.

Если сервер прямо требует digest authentication, используйте Digest.

Если не уверены, используйте автоматическое согласование.

Короткий чек-лист

Подготовить WebDAV endpoint, username и password
-> Открыть настройки загрузки
-> Добавить канал
-> Выбрать WebDAV
-> Ввести Endpoint / username / password
-> По умолчанию оставить authentication mode как Basic
-> По умолчанию оставить storage directory как imgbed
-> Сохранить
-> Запросить емкость
-> Загрузить тестовый файл