Додавання каналу WebDAV

Коли це найкращий варіант

Використовуйте канал WebDAV, якщо:

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

Що підготувати заздалегідь

Потрібно	Навіщо це потрібно
WebDAV Endpoint	Серверна WebDAV-адреса, наприклад 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 використовує справжнє 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
-> Зберегти
-> Запитати місткість
-> Завантажити тестовий файл