Поиск
Справочник

Код 206 Partial Content: что значит и как работает докачка

206 Partial Content («частичное содержимое») — сервер отдал не весь файл, а только запрошенный кусок. На этом построены докачка оборванной загрузки и просмотр видео с середины: клиент просит нужный диапазон байтов, и сервер присылает только его. Это успешный ответ, не ошибка.

≈ 4 мин чтения
Содержание 8

Что означает код 206

Клиент указывает в заголовке Range, какие байты ему нужны. Сервер отвечает 206 и в заголовке Content-Range сообщает, какой кусок отдал и сколько весит файл целиком. Например, Content-Range: bytes 0-99/50856 — байты с 0 по 99 из 50 856.

Если клиент попросил несколько кусков сразу, они приходят в одном ответе типа multipart/byteranges, каждый со своим заголовком Content-Range.

Как это работает

  1. Сервер сообщает, что умеет отдавать части: в ответе есть заголовок Accept-Ranges: bytes.
  2. Клиент запрашивает часть: Range: bytes=500-999 — байты с 500 по 999.
  3. Сервер отвечает 206 с этим куском. Если диапазон за пределами файла, приходит ошибка 416.
  4. Чтобы не склеить куски разных версий файла, клиент может добавить заголовок If-Range с меткой ETag или датой из прошлого ответа. Если файл с тех пор изменился, сервер присылает его целиком с кодом 200.

Сервер вправе не поддерживать диапазоны: тогда на запрос с Range он присылает весь файл с кодом 200.

Как nginx отдаёт 206

Для файлов, которые nginx отдаёт сам, части работают без настройки.

  • nginx отвечает 206 только вместо ответа 200, у которого известен размер.
  • Число кусков в одном запросе ограничивает директива max_ranges. По умолчанию ограничения нет, а max_ranges 0; выключает диапазоны. Если кусков больше разрешённого, nginx отдаёт файл целиком.
  • Если If-Range не совпал с версией файла, nginx отдаёт файл целиком с кодом 200.
  • Ответы PHP и приложений за proxy_pass nginx не кэширует, если это не настроено, и тогда заголовок Range уходит приложению — отвечать 206 должно оно. Директива proxy_force_ranges разрешает диапазоны для ответов приложения независимо от заголовка Accept-Ranges в них.

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

Команду выполняйте в терминале на своём компьютере, подставив адрес своего сайта. Если терминал вам незнаком, начните с инструкции Как открыть терминал. Вместо video.mp4 подставьте любой файл с сайта:

curl -I -r 0-99 https://example.com/video.mp4

Ключ -r задаёт диапазон: 0-99 — первые 100 байтов. Если сервер поддерживает части, в первой строке ответа будет 206, в заголовке content-range — bytes 0-99/ и размер файла, а content-length — 100 байтам. Если пришёл код 200, сервер диапазоны для этого файла не отдаёт.

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

curl -C - -O https://example.com/video.mp4

Ключ -O сохраняет файл под тем же именем, что на сервере, а -C - сам определяет по размеру файла, с какого байта продолжить.

Почему докачка начинается заново

  • Сервер не отдаёт части этого файла: на запрос с Range приходит 200 и файл целиком. Проверьте командой из раздела выше.
  • Файл на сервере изменился: если программа загрузки сверяет версию через If-Range, сервер пришлёт новый файл целиком.
  • Файл отдаёт программа сайта — PHP или приложение, — а она заголовок Range не обрабатывает.

Чем 206 отличается от соседних кодов

КодКогда возникает
200Ресурс отдан целиком
206Отдана запрошенная часть ресурса
304Ресурс не изменился, клиент берёт копию из кэша
416Запрошенный диапазон за пределами файла

Источники

Сверено 19 октября 2026 года.

Что почитать дальше