Руководство по DenchikP CDN

DenchikP CDN хранит ваши файлы и раздаёт их по постоянным ссылкам. Этим можно управлять из веб-панели, из скриптов через API или из ShareX. Руководство описывает все возможности по порядку: от первой загрузки до настройки сервера.

1. Что такое DenchikP CDN

CDN (сеть доставки контента) отдаёт статические файлы — картинки, стили, скрипты, шрифты, архивы, документы — быстро и по неизменному адресу. DenchikP CDN состоит из четырёх частей:

1.1. Как устроены адреса файлов

Любой файл имеет адрес вида

https://cdn.denchikp.com/<домен>/<папка>/<имя файла>

Например, https://cdn.denchikp.com/example.com/img/hero-banner.png:

• домен — «пространство» файлов. Обычно это домен вашего сайта (example.com). Файлы разных доменов не пересекаются, и доступ к ним выдаётся отдельно. Есть общий домен public, доступный всем.
• папка определяется автоматически по расширению файла: img (картинки: jpg, png, webp, avif, svg, gif, heic и др.), video (mp4, webm, mov, mkv и др.), audio (mp3, wav, ogg, flac, m4a и др.), docs (pdf, документы Office и OpenDocument, txt, csv, md, epub), css, js, fonts (woff, woff2, ttf, otf, eot), files (всё остальное). Полный список — в разделе Справочник. Кроме того, существует служебная папка private для приватных файлов (см. Доступ и шаринг).
• имя файла — случайный UUID (по умолчанию) либо исходное имя, если вы так захотите. Случайные имена надёжнее: их нельзя угадать и они не конфликтуют.

1.2. Что такое «домен» и какие они бывают

Формат имени домена: латинские буквы, цифры и дефис, затем точка и зона (example.com, my-shop.org). Поддомены (cdn.example.com) как отдельные домены в панели не поддерживаются.

1.3. Основные понятия

2. Быстрый старт

Вам понадобится API ключ. Ключи выдаёт администратор сервиса; если вы работаете в одиночку, ключ есть у владельца сервера (раздел Администрирование). Ключ — это пароль: не публикуйте его в репозиториях и чатах.

1. Откройте https://static.denchikp.com/ и один раз подтвердите согласие с политикой и условиями использования.
2. Введите ключ в поле «Войти через API ключ» (или войдите через Google, Discord, GitHub, Telegram и привяжите ключ — тогда вводить его повторно не придётся).
3. Перейдите во вкладку «Загрузка», выберите домен и файл и нажмите «Загрузить файл».
4. Скопируйте полученную ссылку и откройте её в браузере: файл раздаётся с cdn.denchikp.com.

12345

1. Название и версии. Версия панели и версия API (бейдж подтягивается с сервера).
2. Состояние сервиса. Бейджи доступности: статус API, аптайм за 24 часа и время ответа.
3. Тема. Переключатель светлой и тёмной темы. Выбор запоминается в браузере.
4. Способы входа. Google, Discord, GitHub, Telegram или напрямую по API ключу. Внешний аккаунт привязывается к ключу один раз.
5. Разделы. Загрузка, файловый менеджер, удаление, скачивание, просмотр, валидация и личный кабинет.

То же самое из командной строки — загрузка файла и получение ссылки:

export DPCDN_KEY="ваш_ключ"

curl -X POST https://file.denchikp.com/upload \
  -H "X-Api-Key: $DPCDN_KEY" \
  -F "domain=example.com" \
  -F "file=@./photo.png"

$env:DPCDN_KEY = "ваш_ключ"

curl.exe -X POST https://file.denchikp.com/upload `
  -H "X-Api-Key: $env:DPCDN_KEY" `
  -F "domain=example.com" `
  -F "file=@C:\Users\me\photo.png"

import os, requests

r = requests.post(
    "https://file.denchikp.com/upload",
    headers={"X-Api-Key": os.environ["DPCDN_KEY"]},
    data={"domain": "example.com"},
    files={"file": open("photo.png", "rb")},
)
r.raise_for_status()
print(r.json()["url"])

import { readFile } from 'node:fs/promises';

const form = new FormData();
form.append('domain', 'example.com');
form.append('file', new Blob([await readFile('photo.png')]), 'photo.png');

const res = await fetch('https://file.denchikp.com/upload', {
  method: 'POST',
  headers: { 'X-Api-Key': process.env.DPCDN_KEY },
  body: form,
});
console.log((await res.json()).url);

В ответ придёт JSON со ссылкой:

{
  "status": "ok",
  "url": "https://cdn.denchikp.com/example.com/img/6c1f0d1a-2b3c-4d5e-8f90-a1b2c3d4e5f6.png",
  "size": 183204,
  "domain": "example.com",
  "folder": "img",
  "filename": "6c1f0d1a-2b3c-4d5e-8f90-a1b2c3d4e5f6.png"
}

Что можно сделать дальше:

• удалить файл: DELETE /delete с телом {"url": "<ссылка>"};
• загрузить файл по внешней ссылке: POST /upload/by-url;
• загрузить файл больше 500 МБ или по частям: /upload/session/*;
• настроить ShareX, чтобы скриншоты загружались одной клавишей.

3. Панель управления

Панель — это обычная веб-страница https://static.denchikp.com/. Она работает в любом современном браузере, в том числе на телефоне, и сохраняет выбранную тему оформления (светлую или тёмную) в браузере.

3.1. Вход

Есть два способа авторизоваться:

Одновременно активна только одна сессия: вход другим способом завершает предыдущий. Кнопка «Отвязать API ключ» разрывает связь аккаунта с ключом, а «Выйти» завершает сессию.

3.2. Вкладка «Загрузка»

Самая простая загрузка: ключ, домен, файл.

123456

1. API ключ. Ключ или вход через аккаунт. Значок глаза показывает и скрывает ключ.
2. Домен. public — общий домен (файлы чистятся раз в месяц). Для своего домена выберите «другой» и введите имя.
3. Файл. Выберите файл или перетащите его в область.
4. Загрузка по ссылке. Сервер сам скачает файл по http/https-ссылке и сохранит его в CDN.
5. Имя файла. По умолчанию файлу даётся случайное имя (UUID). Включите галочку, чтобы сохранить исходное.
6. Загрузить. После загрузки появится ссылка на файл с кнопками копирования.

• Для домена, которого нет в списке, выберите пункт для ручного ввода и впишите имя.
• Поле «Загрузить файл по ссылке» скачивает файл с внешнего адреса на стороне сервера. Это удобно для больших файлов и переноса с других хостингов. Адреса во внутренних сетях запрещены.
• Галочка «Сохранять оригинальное имя файла» оставляет исходное имя вместо UUID. Если файл с таким именем уже есть, панель предложит пропустить загрузку, сохранить под UUID или перезаписать файл.

3.3. Вкладки «Удаление», «Скачать», «Просмотр», «Валидация»

Это простые формы для разовых задач. Для повседневной работы удобнее файловый менеджер.

«Скачать» показывает файлы выбранной папки домена и скачивает их через API с вашим ключом — этот способ работает и для приватных файлов. «Просмотр» показывает папки домена и объём файлов в каждой. «Валидация» проверяет, что внешняя ссылка отвечает, и разбирает адрес CDN на части.

3.4. Личный кабинет

Во вкладке «Кабинет» собрано всё про ваш ключ: кто вы, тип ключа, какие домены доступны, сколько места использовано и сколько осталось. Ниже есть карточка «Мои домены» (см. свои домены).

1234

1. Вход. Через какой провайдер вы вошли и привязан ли ключ.
2. Ключ. Имя ключа, доступные домены и ограничения по IP.
3. Использование и квоты. Файлы, объём и остаток лимитов (в том числе помесячных).
4. Домены. Список разрешённых доменов или «Любые».

Ниже находятся аналитика, webhooks, токены доступа, ShareX и список ваших файлов из базы данных с поиском. Вкладка «Админ» видна только ключам администраторов (создание и изменение ключей, журналы, запуск сканирования диска).

3.5. Свои домены

Карточка «Мои домены» закрепляет за вашим ключом собственный домен. После подтверждения владения только ваш ключ и администраторы могут загружать, менять и удалять файлы в папке этого домена. Читать файлы по-прежнему может кто угодно.

123456

1. Добавить домен. Введите основной домен, например example.com. Заявка действует 7 дней.
2. Лимит доменов. Сколько доменов подтверждено и сколько разрешено для типа вашего ключа.
3. Способ подтверждения. TXT в DNS (рекомендуется), CNAME, файл на сайте, meta-тег или автоматически через Cloudflare.
4. Запись для DNS. Скопируйте тип, имя и значение записи кнопкой «Копировать» и добавьте их в DNS домена.
5. Проверить. Сервер сам проверит DNS, файл или meta-тег. DNS может обновляться до часа.
6. Подтверждён. Подтверждённый домен доступен только вашему ключу. «Освободить» снимает закрепление.

1. Нажмите «Добавить домен» и введите основной домен, например example.com. Адрес целиком (https://www.example.com/page) тоже подойдёт: лишнее отбрасывается.
2. Выберите способ подтверждения и добавьте то, что показывает панель. Рядом с каждым значением есть кнопка «Копировать».
3. Нажмите «Проверить». DNS может обновляться до часа: если запись ещё не видна, повторите проверку позже.

12

1. Адрес файла. Файл должен открываться по этому адресу без редиректов на другие сайты.
2. Содержимое. Только токен, без пробелов и разметки.

Автоматически через Cloudflare

Откройте вкладку «Cloudflare» у домена и нажмите «Подключить Cloudflare». Создайте в Cloudflare API-токен (My Profile → API Tokens → Create Token → шаблон «Edit zone DNS», выберите одну зону) и вставьте его в форму. Сервис найдёт зону, добавит TXT-запись и сразу проверит домен.

12

1. API-токен. С правами Zone:Read и DNS:Edit для одной зоны. Используется один раз и не сохраняется.
2. Zone ID. Необязательно: без него зона ищется по имени домена.

Токен используется один раз: он не сохраняется на сервере, не пишется в журналы и не возвращается в ответе. После подтверждения его можно удалить в Cloudflare. Если DNS ещё не обновился, запись уже создана: нажмите «Проверить» через минуту.

Правила и ограничения

• Сколько доменов можно подтвердить, зависит от типа ключа: личный до 10, рабочий до 25, сервисный до 10. У администраторов лимита нет.
• Заявка действует 7 дней, неподтверждённых заявок может быть не больше 10.
• Домен, который уже используют другие ключи, закрепляет за вами администратор (вкладка «Админ»).
• Кнопка «Освободить» снимает закрепление. Файлы в папке остаются, но домен снова доступен другим.
• Автоматической перепроверки нет. Если домен перешёл другому владельцу, освободите его.

4. Файловый менеджер

Вкладка «Файлы» — основной инструмент: в ней можно искать, просматривать, загружать, переименовывать, перемещать, копировать, делиться и удалять файлы домена.

123456789

1. API ключ. Подставляется автоматически при входе через аккаунт, иначе вводится вручную.
2. Домен. Выберите из подсказок (недавние и доступные вашему ключу) или введите имя.
3. Загрузка. Выбор файлов. Также работает перетаскивание в окно и вставка из буфера (Ctrl+V).
4. Корзина. Удалённые файлы и их восстановление.
5. Ссылки. Публичные ссылки для шаринга: отключение и отзыв.
6. Дубликаты. Поиск и очистка файлов с одинаковым содержимым.
7. Папки. Фильтр по типу файлов; полоса показывает долю папки в объёме домена.
8. Поиск. По имени, типу и расширению. Справа — сортировка и переключатель вида.
9. Файл. Клик — просмотр, галочка — выбор, «⋮» — меню действий.

4.1. Как открыть домен

1. Введите API ключ (если вы вошли через аккаунт, он подставится сам).
2. Выберите домен из подсказок или введите его имя и нажмите «Открыть» (или клавишу Enter).
3. Под строкой с полями появятся шкалы квот: хранилище, число файлов и загрузки за месяц.

В подсказках домена сначала идут недавно открытые, затем доступные вашему ключу. Последний открытый домен запоминается в браузере.

4.2. Просмотр, поиск и сортировка

• Слева список папок. Число рядом с названием — количество файлов, полоса — доля в общем объёме. Папка «Приватные» появляется, когда в домене есть приватные файлы.
• Поиск работает по имени, типу и расширению.
• Сортировка: сначала новые или старые, по имени (А → Я и Я → А), сначала крупные или мелкие.
• Переключатель справа от сортировки меняет вид: плитка с миниатюрами или компактный список с размером и датой.
• Миниатюры больших картинок загружаются уменьшенными (WebP шириной 360 px), поэтому плитка открывается быстро даже для тяжёлых изображений.

4.3. Выбор файлов и массовые действия

Нажмите галочку на файле, чтобы выбрать его. Shift+клик выбирает диапазон, Ctrl+клик добавляет файл к выбору, Ctrl+A выбирает все файлы, подходящие под фильтр.

1234

1. Вид «Список». Компактный список с размером и датой. Переключатель запоминается.
2. Выбрать все. Выбирает все файлы, подходящие под текущий фильтр.
3. Выбранный файл. Shift+клик выделяет диапазон, Ctrl+клик добавляет файл к выбору.
4. Массовые действия. Ссылки, ZIP, перемещение, копирование, срок жизни, доступ и удаление для всех выбранных файлов.

Для выбранных файлов доступны: получение ссылок в разных форматах, скачивание ZIP-архивом (до 200 файлов и 1 ГБ), перемещение, копирование, установка срока жизни, смена доступа (приватный или публичный) и удаление.

4.4. Меню файла

Кнопка «⋮» рядом с файлом (или щелчок по нему) открывает меню действий.

1

1. Меню файла. Просмотр, редактор, скачивание, ссылки, размер и формат, поделиться, подписанная ссылка, приватность, срок жизни, контрольная сумма, проверка антивирусом, переименование, перемещение, копирование и удаление.

123

1. Файл. Исходное и серверное имя, размер, тип по содержимому (с предупреждением, если не совпадает с расширением), даты.
2. Кто загрузил. Ключ, его тип и привязанные аккаунты. Подробности видят только загрузивший, владелец домена и администратор.
3. Копировать. Ссылка CDN и SHA-256 копируются в один клик.

Подробности о владельце (номер ключа и привязанные аккаунты Google, Discord, GitHub, Telegram) видят только тот, кто загрузил файл, владелец подтверждённого домена и администратор. Остальные ключи с доступом к домену видят лишь имя и тип загрузившего ключа.

4.5. Загрузка файлов

Файлы можно добавить тремя способами:

• кнопка «Загрузить» — выбрать один или несколько файлов;
• перетаскивание файлов в окно панели;
• вставка из буфера — нажмите Ctrl+V на вкладке «Файлы», и скопированный скриншот загрузится как screenshot-ГГГГММДД-ЧЧММСС.png.

Во время загрузки показывается окно с общим и пофайловым прогрессом, скоростью и кнопкой отмены. Файлы больше 32 МБ загружаются частями по 8 МБ (при сбое сети часть отправляется повторно), и им присваивается случайное имя. Переключатель «Хранить» рядом с галочкой имён позволяет задать срок жизни для всех загружаемых файлов сразу (час, день, неделя, месяц).

4.6. Скачивание архивом и другие инструменты

• ZIP: выберите файлы и нажмите «Скачать ZIP». Внутри архива файлы лежат по путям домен/папка/имя.
• Корзина, Ссылки и Дубликаты — кнопки над списком (подробности в разделах Жизненный цикл файлов и Доступ и шаринг).
• Статистика использования домена и открытая «квота» всегда видны над списком.

4.7. Горячие клавиши

4.8. Тема и телефон

Кнопка с луной или солнцем в шапке переключает тему. Интерфейс подстраивается под узкие экраны: панель инструментов переносится в несколько строк, вкладки остаются закреплёнными сверху.

5. Картинки: размер и формат

Сервер умеет менять размер и формат изображений на лету, поэтому хранить несколько версий одной картинки не нужно. Поддерживаются исходники jpg, png, webp и gif из папок img и files.

5.1. Из панели

В меню картинки выберите «Размер и формат…».

12345

1. Предпросмотр. Результат считается на сервере; ниже — формат, размеры и экономия по сравнению с оригиналом.
2. Размеры. Ширина и высота в пикселях (до 4096). Пустое поле — «авто».
3. Режим. «Вписать» не увеличивает картинку; «Обрезать» заполняет рамку.
4. Формат. WebP, AVIF, JPEG, PNG или «Авто» — формат выбирается по заголовку Accept браузера.
5. Готовая ссылка. Ссылку или готовый тег <img> можно скопировать кнопками внизу.

Под предпросмотром видно формат, размеры и вес результата в сравнении с оригиналом. Кнопки «Копировать ссылку» и «Копировать <img>» копируют адрес или готовый тег.

5.2. Параметры в ссылке

Достаточно добавить параметры к адресу файла:

https://cdn.denchikp.com/example.com/img/hero-banner.png?w=800&format=webp&q=80

• Применяется поворот по метаданным EXIF; метаданные в результат не копируются.
• Прозрачность при сохранении в JPEG заменяется белым фоном.
• Анимированные GIF отдаются как есть.
• Результаты кешируются на сервере (до 2 ГБ, старые записи удаляются), повторные запросы отдаются мгновенно и с заголовком Cache-Control: public, max-age=604800.
• Без параметров обычная ссылка на файл по-прежнему отдаёт оригинал.

6. Жизненный цикл файлов

6.1. Корзина

Кнопка «Удалить…» предлагает два варианта: «В корзину» (рекомендуется) и «Удалить навсегда».

12

1. Удалить навсегда. Файл удаляется с диска без восстановления.
2. В корзину. Рекомендуемый вариант: файл можно вернуть в течение 30 дней.

Файл в корзине перестаёт открываться по ссылке, но остаётся на сервере 30 дней, после чего удаляется автоматически. Корзина лежит вне веб-каталога, а её содержимое не учитывается в квоте.

1234

1. Срок хранения. Файлы лежат в корзине 30 дней, затем удаляются навсегда.
2. Восстановить. Файл возвращается по прежнему адресу (если имя не занято).
3. Удалить навсегда. Освобождает место сразу.
4. Элемент. Справа — размер и сколько осталось до автоматического удаления.

• Восстановить возвращает файл по прежнему адресу. Если в этом месте уже лежит другой файл с таким именем, восстановление не перезаписывает его — файл остаётся в корзине, а панель сообщает о конфликте.
• Удалить навсегда и Очистить корзину освобождают место сразу.
• Из API: POST /trash, GET /trash, POST /trash/restore, DELETE /trash. Обычный DELETE /delete по-прежнему удаляет файл сразу и без возможности восстановления.

6.2. Срок жизни файла

Файлу можно задать время, через которое он удалится сам, минуя корзину: от минуты до десяти лет.

1

1. Срок. Через это время файл удалится сам (без корзины). «Другое» — свой срок в часах; «Снять срок» убирает таймер.

• Установить срок можно из меню файла, для выбранных файлов сразу, а также при загрузке: переключатель «Хранить» в шапке файлового менеджера или поле ttl (в секундах) в POST /upload.
• Рядом с файлом отображается значок с оставшимся временем.
• Срок привязан к адресу файла: он переезжает вместе с ним при перемещении и переименовании и снимается, когда файл отправляют в корзину.
• Проверка выполняется раз в минуту.

6.3. Дубликаты

Кнопка «Дубликаты» ищет среди файлов вашего ключа файлы с одинаковым содержимым (по SHA-256) и помогает убрать лишние.

123

1. Итог. Сколько групп и лишних копий найдено и сколько места можно освободить.
2. Группа. Отметьте файл, который нужно оставить; остальные уйдут в корзину.
3. Удалить лишние копии. Сервер сам проверит, что содержимое совпадает.

1. Откройте домен и нажмите «Дубликаты». Панель посчитает хэши только у файлов одинакового размера, это быстро.
2. В каждой группе отметьте файл, который нужно оставить (по умолчанию — самый старый).
3. Нажмите «Удалить лишние копии». Остальные копии уйдут в корзину, а публичные ссылки шаринга на них начнут вести на оставшийся файл.

Чтобы не создавать дубликаты заново, передавайте dedupe=true в POST /upload: если в домене у вашего ключа уже есть такой же файл, сервер не сохраняет новый, а возвращает адрес существующего с признаком deduplicated.

6.4. Очистка домена public

Файлы в домене public автоматически удаляются 1-го числа каждого месяца. Это выполняет задача планировщика на сервере (см. Администрирование). Для хранения используйте собственный домен.

7. Доступ и шаринг

Файл в CDN по умолчанию публичный: каждый, кто знает адрес, может его открыть. Для всего, что должно быть доступно ограниченному кругу, предусмотрены четыре инструмента. Они не исключают друг друга.

7.1. Приватные файлы

Пункт «Сделать приватным» (в меню файла или для выбранных файлов) переносит файлы в папку private того же домена. Прямая ссылка на них перестаёт открываться (ответ 403), а текущий адрес файла меняется.

Открыть приватный файл можно:

• из панели («Просмотр» открывает его в новой вкладке по временной ссылке, «Скачать» тянет через API с вашим ключом);
• по подписанной или публичной ссылке;
• через API с ключом: GET /download/<домен>/private/<имя>.

7.2. Подписанные ссылки

Подписанная ссылка содержит срок действия и криптографическую подпись. Подменить срок, имя файла или режим скачивания нельзя — подпись перестанет совпадать.

123

1. Срок. От 15 минут до 30 дней. Ссылку нельзя отозвать — только дождаться окончания срока.
2. Только скачивание. Файл не откроется в браузере, а сразу скачается.
3. Ссылка. Открывается без ключа и работает и для приватных файлов.

• Срок: от 15 минут до 30 дней в панели (через API — от 10 секунд до 30 дней).
• Режим «Только скачивание» заставляет браузер сохранить файл, а не открыть его. HTML, SVG и JavaScript всегда отдаются как вложение.
• Ссылку нельзя отозвать отдельно: она перестаёт работать по истечении срока, а также при переименовании, перемещении или удалении файла.
• Смена секрета подписи на сервере делает все выданные ссылки недействительными.

7.3. Публичные ссылки для шаринга

Публичная ссылка ведёт на страницу https://cdnapi.denchikp.com/s/<код> со сведениями о файле и кнопкой «Скачать».

1234

1. Срок действия. После истечения страница ссылки отвечает «Срок действия истёк».
2. Лимит скачиваний. После исчерпания лимита ссылка перестаёт работать.
3. Пароль. Необязательно. Передайте пароль получателю отдельным каналом.
4. Название. Показывается на странице вместо имени файла.

1

1. Публичная ссылка. Откроет страницу со сведениями о файле и кнопкой «Скачать».

Получатель увидит такую страницу:

1

1. Скачать. Скачивание считается в лимите и в статистике.

Если задан пароль, вместо кнопки появляется поле ввода:

Особенности:

• Лимит скачиваний считается точно. Повторные запросы докачки (с заголовком Range) не со смещения 0 в счётчик не попадают.
• Предпросмотр картинки показывается только у ссылок без пароля и без лимита, иначе его можно было бы использовать для обхода ограничений.
• Пароль хранится в виде хэша. После 10 неверных попыток с одного IP за 10 минут сервер временно блокирует ввод (ответ 429).
• Файл можно переименовывать, перемещать и делать приватным — ссылка последует за ним. Если файл удалён или лежит в корзине, страница сообщит, что он недоступен; после восстановления ссылка снова заработает.
• Страницы не индексируются поисковиками и не кешируются.

Управлять ссылками удобно в окне «Ссылки» над списком файлов: там видно, сколько раз файл скачали, когда истекает срок, и можно отключить или отозвать ссылку.

123

1. Описание. Название, наличие пароля, использовано скачиваний, срок. У истёкших и исчерпанных ссылок появляется отметка.
2. Отключить. Временно закрывает ссылку, не удаляя её.
3. Отозвать. Удаляет ссылку насовсем.

7.4. Защита от хотлинка

Хотлинк — это когда чужой сайт встраивает вашу картинку или видео прямо с вашего CDN и тем самым расходует ваш трафик. Правило в Apache разрешает такие файлы только со страниц самого домена-владельца и сайтов *.denchikp.com и *.denchikp.is. Запросы без заголовка Referer (прямое открытие ссылки, мессенджеры, большинство скриптов) пропускаются, домен public исключён.

8. Автоматизация

8.1. Ключи и токены

Для скриптов и сторонних сервисов не отдавайте основной ключ. Вместо этого создайте токен доступа с минимально нужными правами. Токен используется вместо ключа в том же заголовке X-Api-Key (начинается с dpt_).

1234

1. Создать токен. Токен показывается один раз — сохраните его сразу.
2. Токен. Права, домены, лимит запросов в минуту, время последнего использования и срок действия.
3. Отключить. Временное отключение без удаления.
4. Отозвать. Токен перестаёт работать сразу.

1234

1. Права. Чтение, загрузка, удаление, изменение. Выдавайте только то, что нужно.
2. Домены. Токен будет работать только с этими доменами.
3. Лимит. Запросов в минуту; при превышении сервер отвечает 429.
4. Срок действия. Рекомендуется ограничивать срок жизни токенов для внешних сервисов.

• Токен всегда ограничен правами, которые вы выбрали, и никогда не получает прав администратора.
• Можно ограничить токен списком доменов. Такой токен не вызывает методы, затрагивающие все домены сразу (общий список файлов, корзина целиком, статистика).
• У токена есть лимит запросов в минуту (по умолчанию 120). При превышении сервер отвечает 429 с заголовком Retry-After, а в каждом ответе есть X-RateLimit-Limit и X-RateLimit-Remaining.
• Токен показывается один раз сразу после создания, на сервере хранится только его хэш.

1

1. Токен. Показывается только сейчас. На сервере хранится лишь его хэш.

Типы ключей

Каждому ключу администратор назначает тип. Тип виден в кабинете, в админ-панели и в ботах.

Сервисный ключ нельзя привязать к Google, Discord, GitHub или Telegram и нельзя использовать для входа в кабинет: он только для API. Остальные возможности у всех типов одинаковы; различаются назначение и лимит собственных доменов.

8.2. ShareX

ShareX — популярная программа для скриншотов и записи экрана. В кабинете можно скачать готовый конфиг .sxcu, и снимки будут загружаться в CDN по горячей клавише.

123

1. Ключ. Попадает в файл конфигурации — не публикуйте его. Для ShareX лучше выдать отдельный токен.
2. Домен. Куда будут загружаться снимки.
3. Скачать .sxcu. Откройте файл двойным щелчком, и ShareX предложит его установить.

1. В кабинете введите ключ (лучше токен с правом upload) и домен.
2. При желании включите «Сохранять исходные имена».
3. Нажмите «Скачать .sxcu» и откройте файл двойным щелчком: ShareX предложит установить настройки.
4. В ShareX выберите назначение загрузки «Custom uploader» и сделайте снимок. Ссылка окажется в буфере обмена.

8.3. Примеры запросов

Все примеры используют переменную DPCDN_KEY. Полный список методов — в справочнике API.

Загрузка по внешней ссылке

curl -X POST https://file.denchikp.com/upload/by-url \
  -H "X-Api-Key: $DPCDN_KEY" -H "Content-Type: application/json" \
  -d '{"domain":"example.com","source_url":"https://example.org/image.png"}'

Большие файлы по частям

Для файлов больше 500 МБ (и просто для надёжной загрузки по плохой сети) используйте сессию загрузки: начать, отправить части по 8 МБ, завершить. При сбое отправляйте часть повторно.

# 1. начать сессию
curl -X POST https://file.denchikp.com/upload/session/start \
  -H "X-Api-Key: $DPCDN_KEY" -H "Content-Type: application/json" \
  -d '{"domain":"example.com","ext":"zip","mime_type":"application/zip"}'
# {"status":"ok","upload_id":"...","chunk_size":8388608}

# 2. отправить части (поле file), номера с 1
curl -X PUT https://file.denchikp.com/upload/session/$ID/part/1 \
  -H "X-Api-Key: $DPCDN_KEY" -F "[email protected]"

# 3. завершить
curl -X POST https://file.denchikp.com/upload/session/$ID/complete \
  -H "X-Api-Key: $DPCDN_KEY"

Файл, собранный из частей, получает случайное имя.

Список файлов, скачивание, удаление

curl -X POST https://cdnapi.denchikp.com/browse \
  -H "X-Api-Key: $DPCDN_KEY" -H "Content-Type: application/json" \
  -d '{"domain":"example.com"}'

curl -X DELETE https://cdnapi.denchikp.com/delete \
  -H "X-Api-Key: $DPCDN_KEY" -H "Content-Type: application/json" \
  -d '{"url":"https://cdn.denchikp.com/example.com/img/photo.png"}'

curl -X POST https://cdnapi.denchikp.com/trash \
  -H "X-Api-Key: $DPCDN_KEY" -H "Content-Type: application/json" \
  -d '{"urls":["https://cdn.denchikp.com/example.com/img/photo.png"]}'

curl -X POST https://cdnapi.denchikp.com/files/zip \
  -H "X-Api-Key: $DPCDN_KEY" -H "Content-Type: application/json" \
  -d '{"urls":["https://cdn.denchikp.com/example.com/img/a.png","https://cdn.denchikp.com/example.com/files/b.pdf"]}' \
  -o files.zip

curl -X POST https://cdnapi.denchikp.com/file/sign \
  -H "X-Api-Key: $DPCDN_KEY" -H "Content-Type: application/json" \
  -d '{"url":"https://cdn.denchikp.com/example.com/private/report.pdf","ttl_seconds":3600}'

Пример для CI (GitHub Actions)

- name: Upload build artifact to CDN
  env:
    DPCDN_TOKEN: ${{ secrets.DPCDN_TOKEN }}
  run: |
    curl --fail -X POST https://file.denchikp.com/upload \
      -H "X-Api-Key: $DPCDN_TOKEN" \
      -F "domain=example.com" -F "name_mode=custom" -F "custom_filename=app-${{ github.sha }}.js" \
      -F "ttl=2592000" \
      -F "file=@dist/app.js"

Храните токен в секретах репозитория, а не в файлах. Параметр ttl удалит старые сборки через 30 дней.

Обработка лимитов и ошибок

• 429 — подождите Retry-After секунд и повторите запрос. Ограничение действует и на токены (лимит в минуту), и на подбор ключей (30 неудачных попыток с одного IP за 5 минут).
• 5xx и обрывы сети — повторяйте с нарастающей паузой (1, 2, 4 секунды). Загрузки по частям безопасно повторять часть за частью.
• 409 при загрузке — файл с таким именем уже есть. Передайте conflict_action=overwrite, чтобы перезаписать, или не задавайте имя (будет UUID).

8.4. Webhooks

Webhook присылает на ваш адрес POST-запрос с JSON каждый раз, когда в CDN что-то происходит: загрузка, удаление, перемещение, изменение файла и другие события. Это способ синхронизироваться с другими системами без постоянных опросов.

1234

1. Адрес. Только https. Адреса во внутренних сетях запрещены.
2. Secret. Нужен для подписи запросов (HMAC-SHA256).
3. События. Через запятую, либо * для всех событий.
4. Тест и история. Тест отправляет событие PING; история показывает попытки доставки.

Параметры: адрес (только https; адреса во внутренних сетях запрещены), секрет (обязателен: без него события не отправляются) и список событий (через запятую или * для всех).

Каждый запрос подписан: заголовки X-DP-Event, X-DP-Timestamp и X-DP-Signature (v1= и HMAC-SHA256 по строке {timestamp}.{тело}). Обязательно проверяйте подпись и свежесть метки времени (рекомендуется ±300 секунд):

import time, hmac, hashlib

def verify(headers, secret: str, body: bytes, tolerance=300) -> bool:
    ts = int(headers["X-DP-Timestamp"])
    if abs(time.time() - ts) > tolerance:
        return False
    msg = str(ts).encode() + b"." + body
    expected = "v1=" + hmac.new(secret.encode(), msg, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, headers["X-DP-Signature"])

const crypto = require('crypto');

function verify(headers, secret, rawBody, tolerance = 300) {
  const ts = Number(headers['x-dp-timestamp']);
  if (Math.abs(Date.now() / 1000 - ts) > tolerance) return false;
  const expected = 'v1=' + crypto.createHmac('sha256', secret)
    .update(`${ts}.`).update(rawBody).digest('hex');
  const a = Buffer.from(expected), b = Buffer.from(headers['x-dp-signature']);
  return a.length === b.length && crypto.timingSafeEqual(a, b);
}

Если ваш сервер ответил кодом 408, 425, 429 или 5xx либо не ответил, доставка повторяется до трёх попыток с паузами 2 и 10 секунд. Все попытки записываются в историю: кнопка «История» показывает последние 50. Ответьте кодом 2xx как можно быстрее, а тяжёлую обработку выполняйте асинхронно.

8.5. Боты Discord и Telegram

Те же возможности доступны из мессенджеров: Discord-бот (слеш-команды) и Telegram-бот. Бот работает от имени вашего API ключа: привяжите аккаунт командой /bind (ключ вводится в диалоге бота), и все команды выполняются с вашими правами и ограничениями доменов.

Тип вашего ключа показывают /me, /cdn и сообщение после /bind. Остальные команды (/open, /browse, /folders, /move, /copy, /rename, /hash, /quota и другие) работают как раньше. Для опасных действий (очистка корзины, перенос заражённого файла в корзину) бот просит подтверждение кнопкой. Сроки в Telegram задаются сокращениями: 30m, 1h, 1d, 7d, 2w.

8.6. Деплой из GitHub

Приложение DenchikP CDN для GitHub выкладывает файлы из репозитория на CDN при каждом push. Удобно для статических сайтов, документации и сборок фронтенда: собрали в dist, сделали push, файлы уже на cdn.denchikp.com.

1. Откройте «Аккаунт» → «Деплой из GitHub» и нажмите «Подключить GitHub».
2. На GitHub выберите репозитории, к которым приложение получит доступ, и подтвердите установку. Вы вернётесь в панель.
3. Выберите репозиторий, ветку, папку в репозитории (например dist; пусто — весь репозиторий) и домен CDN, нажмите «Добавить деплой».
4. Сделайте push в ветку или нажмите «Выложить сейчас».

1234

1. Подключить GitHub. Откроет GitHub: выберите репозитории для приложения DenchikP CDN и вернитесь в панель.
2. Аккаунт GitHub. Подключённые аккаунты и организации. Щелчок открывает настройки доступа к репозиториям на GitHub.
3. Выложить сейчас. Выложить последний коммит ветки, не дожидаясь push.
4. Новый деплой. Репозиторий, ветка, папка в репозитории (например dist) и домен CDN.

Ход деплоя виден в GitHub на странице коммита во вкладке Checks (проверка «DenchikP CDN»): список новых и обновлённых файлов со ссылками и ошибки, если были.

• Файлы раскладываются по папкам CDN по типу, как при обычной загрузке (img, css, js, fonts, video, audio, docs, files). Вложенные папки репозитория не сохраняются, поэтому имена файлов внутри выбранной папки должны быть уникальными; повтор имени отмечается ошибкой.
• Имена файлов сохраняются как в репозитории, поэтому ссылки постоянны: dist/css/app.css всегда доступен как https://cdn.denchikp.com/<домен>/css/app.css.
• Неизменённые файлы не перезаписываются и не расходуют квоту загрузок. Файлы, удалённые из репозитория, на CDN остаются.
• Скрытые файлы и папки (.env, .github и т. п.) и node_modules пропускаются. Действуют обычные квоты ключа, проверка антивирусом и права на домен: в подтверждённый чужой домен деплой невозможен.
• Приложению нужны только права на чтение кода и запись проверок (Checks). Доступ к репозиториям меняется в настройках установки на GitHub (щелчок по имени аккаунта в карточке).
• Деплой работает от имени ключа, который подключил GitHub. Сервисные ключи GitHub не подключают.

8.7. Коннектор Claude

Коннектор DenchikP CDN подключает хранилище к Claude: ассистент может посмотреть квоты и домены, найти и прочитать файлы, показать статистику, создать временную ссылку и загрузить новый файл. Удобно для автоматизации: «выложи этот HTML на CDN и пришли ссылку», «найди мои CSS за этот месяц».

1. В Claude (claude.ai) откройте «Настройки» → «Коннекторы» → «Добавить свой коннектор» и вставьте адрес https://cdnapi.denchikp.com/mcp.
2. Откроется страница согласия DenchikP CDN. Если вы уже вошли в панель, она покажет ваш ключ; иначе введите свой обычный API ключ (не токен dpt_…).
3. Нажмите «Разрешить». Claude получит собственный токен и сможет вызывать инструменты.

• Токен коннектора имеет только права «чтение» и «загрузка». Удалить, перезаписать или изменить существующий файл через коннектор нельзя; если имя файла занято, загрузка отклоняется.
• Ваш API ключ используется один раз для входа и не сохраняется. Коннектору выдаётся отдельный токен «Claude (MCP)» на 90 дней, по одному на ключ. Повторное подключение заменяет предыдущий токен.
• Отозвать доступ можно в любой момент: удалите токен «Claude (MCP)» в разделе токенов или отключите коннектор в Claude.
• Действуют обычные квоты ключа, ограничения по доменам, проверка антивирусом и лимит запросов токена (по умолчанию 120 в минуту).
• Ключи со списком разрешённых IP не подходят: Claude подключается с адресов Anthropic. Для коннектора создайте отдельный ключ без списка IP и, при желании, ограничьте ему домены и квоту.

9. Безопасность

9.1. Ключи

• Ключ — это пароль. Не коммитьте его в репозиторий, не вставляйте в код фронтенда и не отправляйте в чаты. Храните в переменных окружения или менеджере секретов.
• Давайте минимальные права. Для скриптов используйте токены с нужными правами и доменами, а не основной ключ.
• Ограничивайте ключи. Администратор может привязать к ключу список разрешённых доменов и IP-адресов, задать квоты и в любой момент отключить или ротировать ключ.
• Ротируйте при подозрении на утечку. Ротация создаёт новый ключ; старый перестаёт работать. Токены отзываются отдельно и сразу.
• Выбирайте тип ключа по назначению. Для скриптов и серверов администратор выдаёт сервисный ключ: его нельзя привязать к аккаунту и использовать для входа в кабинет, поэтому он не окажется в чужой сессии.
• Закрепляйте домены. Подтверждённый домен закрыт для записи другим ключам: чужой ключ не сможет залить файлы в папку вашего сайта.
• Не используйте один ключ в разных местах. Тогда по журналу видно, откуда идут запросы, и скомпрометированный ключ можно отключить, не ломая остальное.

9.2. Что защищает сам сервис

9.3. Антивирусная проверка (ClamAV)

Пока ClamAV не настроен, проверка выключена и ничего не меняется. После включения проверяются все способы загрузки (обычная, по ссылке, частями, через ботов). Если найдена угроза, файл не сохраняется, а ответ 422 содержит название сигнатуры. Уже загруженные файлы можно проверить из меню файла.

Установка на сервере (Windows):

1. Установите ClamAV и в clamd.conf включите приём по сети: TCPSocket 3310 и TCPAddr 127.0.0.1. Параметр StreamMaxLength задаёт максимальный размер проверяемого потока (по умолчанию 25 МБ).
2. Настройте обновление баз (freshclam) и запустите clamd как службу.
3. В .env добавьте CLAMAV_ENABLED=1 (при нестандартном адресе — CLAMAV_HOST, CLAMAV_PORT) и значение CLAMAV_MAX_SCAN_BYTES, равное StreamMaxLength. Перезапустите API.
4. Проверьте состояние: GET /av/status должен вернуть enabled: true и reachable: true.

• Файлы больше CLAMAV_MAX_SCAN_BYTES не проверяются.
• Если clamd недоступен, по умолчанию загрузки принимаются, а ошибка пишется в журнал (CLAMAV_FAIL_MODE=open). Для строгого режима задайте CLAMAV_FAIL_MODE=closed: тогда загрузки будут отклоняться с ответом 503.

9.4. Памятка по безопасности

1. Выдайте скриптам токены вместо основного ключа и ограничьте их домены и сроки.
2. Закройте в Apache папку /private/ и проверьте это: прямая ссылка на приватный файл должна отвечать 403.
3. Используйте длинные случайные имена файлов (режим по умолчанию).
4. Для webhooks всегда проверяйте подпись и метку времени.
5. Включите ClamAV, если пользователи могут загружать файлы с неизвестным содержимым.
6. Следите за журналом и метриками: рост числа ответов 401, 403 и 429 — признак подбора ключей.

10. Аналитика и мониторинг

10.1. Статистика ключа

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

123

1. Период. День, неделя, месяц или год.
2. Показатели. Загрузки, объём, удаления и скачивания через API за период.
3. График. Загрузки по дням.

10.2. Проверка работоспособности

• GET /version — версия API (её же показывает бейдж в шапке панели).
• GET /healthz и GET /readyz — проверки для мониторинга и балансировщиков.
• Бейджи Uptime Kuma в шапке панели показывают статус, аптайм и время ответа.

10.3. Метрики Prometheus

GET /metrics отдаёт метрики в формате Prometheus: запросы по маршрутам и статусам, гистограмму длительности, число неудачных авторизаций и срабатываний лимитов, счётчики антивируса, число и объём файлов, корзину, активные ссылки, токены и размер кеша миниатюр. Доступ — ключом администратора либо заголовком Authorization: Bearer <METRICS_TOKEN>.

scrape_configs:
  - job_name: dpcdn
    scheme: https
    metrics_path: /metrics
    authorization:
      credentials: "<METRICS_TOKEN>"
    static_configs:
      - targets: ["cdnapi.denchikp.com"]

Счётчики запросов хранятся в памяти и обнуляются при перезапуске API: Prometheus корректно переносит такие сбросы. Показатели хранилища обновляются не чаще раза в 30 секунд.

10.4. OpenAPI

Описание API в формате OpenAPI 3 доступно по адресу https://cdnapi.denchikp.com/openapi.json, интерактивная страница — https://cdnapi.denchikp.com/docs, ReDoc — https://cdnapi.denchikp.com/redoc. Схему можно импортировать в Postman, Insomnia или генератор клиентов. В Swagger кнопка Authorize принимает ключ или токен.

123

1. Разделы документации. Руководство, справочник API, политика и условия.
2. Поиск эндпоинта. Фильтрует содержание по методу и пути.
3. Эндпоинт. Метод и путь. Щелчок открывает описание: параметры, примеры ответов и ошибки, у блоков кода есть кнопка копирования.

11. Администрирование

Раздел для тех, кто разворачивает и обслуживает сервер.

11.1. Как всё устроено

После изменения app_db.py или .env API нужно перезапустить вручную (остановить процесс uvicorn и снова запустить start_db.bat). Изменения Apache требуют перезапуска службы Apache.

11.2. Переменные окружения (.env)

Файл .env лежит в каталоге проекта и закрыт от раздачи правилами Apache. Он содержит секреты, поэтому не публикуйте его.

11.3. Настройка Apache

Основные правила уже заложены в конфигурации виртуального хоста static.denchikp.com (псевдоним cdn.denchikp.com). Ниже — что делает каждая часть.

Фрагмент для новых установок (закрытие приватной папки и защита от хотлинка):

RewriteRule ^/[^/]+/private/ - [F,L]

RewriteCond %{HTTP_HOST} ^cdn\.denchikp\.com$ [NC]
RewriteCond %{REQUEST_URI} \.(?:jpe?g|jfif|png|apng|gif|webp|avif|svg|ico|bmp|tiff?|heic|heif|jxl|mp4|m4v|webm|mov|mkv|ogv|mp3|ogg|oga|opus|wav|flac|m4a|aac|woff2?|ttf|otf|eot|zip|pdf)$ [NC]
RewriteCond %{REQUEST_URI} !^/public/ [NC]
RewriteCond %{HTTP_REFERER} !^$
RewriteCond %{HTTP_REFERER} !^https?://([^/:]+\.)?denchikp\.(com|is)(:[0-9]+)?(/|$) [NC]
RewriteCond %{REQUEST_URI} ^/([^/]+)/
RewriteCond %{HTTP_REFERER}|%1 !^https?://(?:[^/:]+\.)?([^/:|]+)(?::[0-9]+)?(?:/[^|]*)?\|\1$ [NC]
RewriteRule ^ - [F]

После любых правок конфигурации проверьте синтаксис командой httpd -t и перезапустите службу Apache.

11.4. Расписание очистки public

Очистку домена public выполняет скрипт clean_public.ps1, запускаемый задачей планировщика Windows CDN - Clean Public:

• расписание: ежемесячно, 1-го числа в 03:00 по UTC, от имени SYSTEM;
• скрипт вызывает POST /admin/public/purge: API удаляет содержимое домена public, помечает записи файлов удалёнными и записывает каждое удаление в статистику, поэтому графики хранилища и числа файлов остаются точными. Для этого скрипту нужен ключ администратора в переменной CDN_ADMIN_API_KEY в .env;
• если API недоступен или ключа нет, скрипт удаляет файлы сам, как раньше, и отмечает в журнале, что удаления не попали в статистику;
• скрипт пишет журнал в clean_public.log и умеет запускаться в режиме проверки (-DryRun) без удаления.

Запуск вручную для проверки:

powershell.exe -ExecutionPolicy Bypass -File C:\Apache24\htdocs\static.denchikp.com\clean_public.ps1 -DryRun

11.5. Сканирование диска

Сканер сверяет файлы на диске с записями в базе данных и добавляет записи для новых файлов, которые появились на диске в обход API. Существующие записи он не меняет. Он запускается кнопкой во вкладке «Админ», вызовом POST /admin/scan/start или автоматически скриптом очистки. Домены из SCAN_IGNORE_DOMAINS и каталоги с префиксом _ пропускаются.

11.6. Резервные копии и обновления

• База данных: регулярно делайте дамп MySQL (mysqldump). Новые функции создают собственные таблицы автоматически; вручную менять схему не нужно.
• Файлы: копируйте каталоги доменов и .env. Каталоги _cache и _tmp — временные, их копировать не нужно.
• Перед обновлением кода сохраняйте копию app_db.py, а после — перезапускайте API и проверяйте GET /version.
• Ключи: создаются и изменяются во вкладке «Админ» панели (домены, IP, квоты, ротация, отключение).

11.7. Журналы

События хранятся в базе данных (вкладка «Админ» → журналы, GET /admin/logs, поток в реальном времени GET /events) и в файле cdn.log в каталоге проекта. По ним видно загрузки, удаления, срабатывания лимитов и антивируса, создание и отзыв ссылок и токенов.

11.8. Типы ключей и домены пользователей

Тип ключа выбирается при создании и меняется в карточке «Редактирование выбранного ключа». Новые ключи по умолчанию личные, существующие после обновления стали личными. В списке ключей тип показан цветной меткой.

123

1. Личный. Для одного человека.
2. Рабочий. Для команды или проекта, больше собственных доменов.
3. Сервисный. Для интеграций, без привязки к аккаунтам.

Карточка «Домены пользователей» показывает все заявки и закреплённые домены с владельцем и способом подтверждения.

123

1. Закрепить вручную. Домен закрепляется за ключом без проверки: так выдают домены, которые уже использовались.
2. Подтвердить. Ручное подтверждение заявки.
3. Удалить. Снимает закрепление или удаляет заявку.

• Подтвердить — ручное подтверждение заявки, если владелец домена убедил вас другим способом.
• Закрепить домен за ключом — форма сверху: домен закрепляется без проверки, а заявки других ключей на него удаляются. Так выдают домены, которые уже использовались несколькими ключами (самостоятельно их закрепить нельзя).
• Удалить — снимает закрепление или удаляет заявку. Файлы не затрагиваются.
• Выдача домена в список разрешённых (поле «Добавить домен» в карточке ключа) по-прежнему даёт доступ другим ключам, даже если домен закреплён за владельцем.
• Если ключ стал сервисным после привязки к аккаунтам, привязки остаются, но создать новые нельзя: панель покажет предупреждение.

12. Диагностика

12.1. Коды ответов

Запросы к файлам и страницам, которые отклоняет веб-сервер (403, 404, 500), показывают страницу ошибки в дизайне сайта:

Ответы самого API приходят в виде JSON с полем detail.

12.2. Частые вопросы

Файл не открывается по ссылке

1. Проверьте адрес: домен, папка и имя должны совпадать символ в символ (регистр важен).
2. Откройте файловый менеджер и найдите файл. Если его нет — возможно, он в корзине, удалён по сроку жизни или находился в домене public (чистится 1-го числа каждого месяца).
3. Если это приватный файл — пользуйтесь подписанной или публичной ссылкой.
4. Если вы только что заменили файл, а видите старый — сбросьте кеш браузера и Cloudflare.

Картинка не открывается со страницы моего сайта

Ответ 403 при запросе с чужой страницы означает сработавшую защиту от хотлинка: домен в адресе файла должен совпадать с доменом сайта, на котором картинка встроена. Для общих картинок используйте домен public.

Панель говорит, что нет доступа к домену

Ключу не выдан этот домен, вы вошли токеном с ограничением по доменам, либо домен закреплён за другим ключом (тогда писать в него может только владелец). Администратор может добавить домен ключу во вкладке «Админ». Домен public выдаётся отдельно.

Домен не подтверждается

Сообщение под заявкой подсказывает причину. Частые случаи:

• Запись ещё не появилась. DNS обновляется от нескольких секунд до часа. Проверьте запись командой nslookup -type=TXT _dpcdn-challenge.example.com 1.1.1.1 (подставьте свой домен).
• Имя записи задвоено. Некоторые панели сами добавляют домен: если нужно вводить только host, указывайте _dpcdn-challenge, а не полное имя. Признак ошибки: запись видна как _dpcdn-challenge.example.com.example.com.
• Значение с лишними символами. Копируйте значение кнопкой «Копировать», без пробелов и переносов.
• Файл или meta-тег не находятся. Адрес должен открываться без входа и без редиректа на другой домен; в файле только токен. Если сайт защищён от ботов, используйте DNS.
• Домен уже занят. Если сообщение говорит, что он подтверждён другим владельцем или используется другими ключами, обратитесь к администратору.

Загрузка большого файла обрывается

Панель сама загружает файлы больше 32 МБ частями и повторяет неудачные части. В API используйте сессии загрузки. Загружайте на file.denchikp.com: на этом хосте нет ограничения размера запроса.

Как восстановить удалённый файл

Откройте «Корзину» в файловом менеджере и нажмите «Восстановить». Это возможно в течение 30 дней и только если файл удалён в корзину, а не «навсегда» или по сроку жизни.

Как перенести сайт на другой домен

Файлы можно переместить или скопировать в другой домен из меню файла (нужен доступ ключа к обоим доменам). Адреса при этом изменятся, поэтому ссылки на сайте придётся обновить.

Приватный файл всё равно открывается по прямой ссылке

Значит, Apache не закрывает папку /private/. Добавьте правило из раздела Настройка Apache, перезапустите Apache и очистите кеш Cloudflare для этого адреса.

Webhook не приходит

Откройте «Историю» webhook'а в кабинете: там видны код ответа и ошибка каждой попытки. Частые причины: адрес не https или указывает на внутренний адрес, не указан секрет, ваш сервер отвечает слишком долго или кодом не 2xx, событие не входит в список.

Панель ничего не показывает, а в консоли браузера 404 на /что-то

Для нового раздела панели не добавлен ProxyPass в Apache (см. Настройка Apache).

13. Справочник

13.1. Лимиты и значения по умолчанию

13.2. Типы файлов и папки

Текстовые файлы, которые можно открыть в редакторе: txt, js, json, html, css, scss, xml, md, yml, yaml, ini, conf, env, toml, log, py, php, java, c, cpp, cs, go, rs, rb, sh, bat, ps1, sql, csv и другие.

13.3. Словарь терминов

14. История версий

Полная история изменений по эндпоинтам отражена в справочнике API.