<?xml version="1.0" encoding="utf-8" standalone="yes"?><feed xmlns="http://www.w3.org/2005/Atom"><title>Research</title><subtitle>Коллекция аналитических обзоров по инструментам и технологиям</subtitle><id>https://research.evsyukov.org/</id><link href="https://research.evsyukov.org/atom.xml" rel="self" type="application/atom+xml"/><link href="https://research.evsyukov.org/" rel="alternate" type="text/html"/><updated>2026-11-22T09:40:53+03:00</updated><generator uri="https://gohugo.io/">Hugo</generator><author><name>Denis Evsyukov</name><email>denis@evsyukov.org</email><uri>https://denis.evsyukov.org</uri></author><rights>© Denis Evsyukov</rights><entry><title>Prompt caching: почему одна правка ломает кэш префикса и сколько это стоит</title><id>https://research.evsyukov.org/articles/prompt-caching-economics/</id><link href="https://research.evsyukov.org/articles/prompt-caching-economics/" rel="alternate" type="text/html"/><published>2026-11-22T09:40:53+03:00</published><updated>2026-11-22T09:46:37+03:00</updated><author><name>Denis Evsyukov</name></author><summary type="html">Как Claude, OpenAI и Gemini находят общий префикс, когда за промах берут больше обычного и как посчитать цену правки промпта по счётчикам API.</summary><content type="html">&lt;h2 id="аннотация"&gt;&lt;a href="#%d0%b0%d0%bd%d0%bd%d0%be%d1%82%d0%b0%d1%86%d0%b8%d1%8f" class="post_hash"&gt;Аннотация&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Одна строка с текущим временем перед большим документом может сделать холодным весь документ, а та же строка после документа оставит его пригодным для повторного чтения. Но одинакового префикса недостаточно: у Claude важна позиция, в которой его успели записать; у OpenAI — доступная точка поиска и поколение модели; у Gemini — ещё и то, передаёт ли клиент ссылку на отдельный объект кэша. Цена промаха поэтому может быть обычным тарифом, дорогой повторной записью или новым часом хранения.&lt;sup id="fnref:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Данные на &lt;strong&gt;2026-11-22&lt;/strong&gt;. Сравниваются прямые платные API, синхронные текстовые запросы и стандартные тарифы для &lt;code&gt;claude-sonnet-5-5&lt;/code&gt; (Messages), &lt;code&gt;gpt-6.2-sol&lt;/code&gt; (Responses) и &lt;code&gt;gemini-3.8-flash&lt;/code&gt; (&lt;code&gt;generateContent&lt;/code&gt;). Допущение: у оператора есть стабильная инструкция или корпус, поверх которого приложение задаёт много разных вопросов. Суммы ниже рассчитаны по публичному прайсу, а не сняты со счетов. Своих замеров задержки и частоты попаданий нет.&lt;sup id="fnref:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:6"&gt;&lt;a href="#fn:6" class="footnote-ref" role="doc-noteref"&gt;6&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:8"&gt;&lt;a href="#fn:8" class="footnote-ref" role="doc-noteref"&gt;8&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="введение-почему-недостаточно-знать-скидку-на-чтение"&gt;&lt;a href="#%d0%b2%d0%b2%d0%b5%d0%b4%d0%b5%d0%bd%d0%b8%d0%b5-%d0%bf%d0%be%d1%87%d0%b5%d0%bc%d1%83-%d0%bd%d0%b5%d0%b4%d0%be%d1%81%d1%82%d0%b0%d1%82%d0%be%d1%87%d0%bd%d0%be-%d0%b7%d0%bd%d0%b0%d1%82%d1%8c-%d1%81%d0%ba%d0%b8%d0%b4%d0%ba%d1%83-%d0%bd%d0%b0-%d1%87%d1%82%d0%b5%d0%bd%d0%b8%d0%b5" class="post_hash"&gt;Введение: почему недостаточно знать скидку на чтение&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Часовой TTL не появился у всех в 2026 году. Anthropic сняла требование beta-заголовка для часового кэша 13 августа 2025-го; AWS анонсировала часовой режим для отдельных Claude-моделей в Bedrock 26 января 2026-го. Google включила автоматическое кэширование Gemini 2.5 в мае 2025-го. Сейчас важнее другое: у новых OpenAI-моделей есть платная запись, сравнимая с Claude, а у Gemini 4 уже нет режима с отдельным объектом кэша, доступного у Gemini 3.8 Flash. Один и тот же ярлык в прайсе описывает разные операции даже внутри одного API.&lt;sup id="fnref1:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:9"&gt;&lt;a href="#fn:9" class="footnote-ref" role="doc-noteref"&gt;9&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:10"&gt;&lt;a href="#fn:10" class="footnote-ref" role="doc-noteref"&gt;10&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:11"&gt;&lt;a href="#fn:11" class="footnote-ref" role="doc-noteref"&gt;11&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:12"&gt;&lt;a href="#fn:12" class="footnote-ref" role="doc-noteref"&gt;12&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Отправная точка здесь не «какую модель выбрать» и не «как убрать лишние сообщения», а что происходит со счётом &lt;strong&gt;при той же длине контекста&lt;/strong&gt;, если изменились его начало, граница кэша или пауза между запросами. Сокращение истории и повторное использование её вычисленного состояния — разные способы экономии. Компактификация уменьшает объём нового входа, но заменяет часть истории и потому может на один ход увеличить объём входа по полной цене.&lt;sup id="fnref2:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:13"&gt;&lt;a href="#fn:13" class="footnote-ref" role="doc-noteref"&gt;13&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="что-именно-сломалось-после-правки"&gt;&lt;a href="#%d1%87%d1%82%d0%be-%d0%b8%d0%bc%d0%b5%d0%bd%d0%bd%d0%be-%d1%81%d0%bb%d0%be%d0%bc%d0%b0%d0%bb%d0%be%d1%81%d1%8c-%d0%bf%d0%be%d1%81%d0%bb%d0%b5-%d0%bf%d1%80%d0%b0%d0%b2%d0%ba%d0%b8" class="post_hash"&gt;Что именно сломалось после правки&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;На prefill модель вычисляет промежуточные key/value tensors для входных токенов. Кэш сохраняет это состояние, а не ответ. При попадании модель может не пересчитывать состояние префикса, но всё равно обрабатывает новый хвост и генерирует новый ответ. В причинной модели KV для позиции зависят от предшествующего контекста, а не от последующего. Поэтому тот же текст документа после другой инструкции не эквивалентен тому же вычисленному префиксу.&lt;sup id="fnref3:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:14"&gt;&lt;a href="#fn:14" class="footnote-ref" role="doc-noteref"&gt;14&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:15"&gt;&lt;a href="#fn:15" class="footnote-ref" role="doc-noteref"&gt;15&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;blockquote&gt;&#10;&lt;p&gt;Cache reuse requires the entire rendered prefix to match.&lt;sup id="fnref4:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;/blockquote&gt;&#10;&lt;p&gt;Слово &lt;em&gt;rendered&lt;/em&gt; важно: сравнивается то, что подали модели, а не байты JSON на проводе. Нет оснований объявлять любое изменение отступов внешнего JSON промахом. И наоборот, при неизменном вопросе обновлённая схема инструмента, перестановка инструментов или новый формат структурированного ответа могут изменить модельный вход. Сравнивать следует порядок сообщений и блоков, содержимое схем и настройки, которые конкретный API превращает в инструкции модели.&lt;sup id="fnref5:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:16"&gt;&lt;a href="#fn:16" class="footnote-ref" role="doc-noteref"&gt;16&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Мысленный пример: сначала идут инструменты, затем правила, затем документация и, наконец, вопрос. Правка вопроса сохраняет возможность прочитать всё до вопроса. Правка в середине правил сохраняет лишь то, что было до неё; даже этот остаток даст попадание, только если есть подходящая записанная граница. В vLLM 0.30.0 это видно буквально: ключ блока включает хэш предыдущего блока, текущие токены и дополнительные признаки, а кэшируются только полные блоки. SGLang в работе о RadixAttention показывает другой способ индексировать пересекающиеся префиксы — radix tree с вытеснением LRU. Это объяснения механизма, не утверждения о внутренней структуре коммерческих API.&lt;sup id="fnref6:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:14"&gt;&lt;a href="#fn:14" class="footnote-ref" role="doc-noteref"&gt;14&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:17"&gt;&lt;a href="#fn:17" class="footnote-ref" role="doc-noteref"&gt;17&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Одинаковый текст в середине запроса — другой случай. Например, при перестановке фрагментов RAG нельзя просто склеить заранее посчитанные KV каждого фрагмента: это потеряет зависимость от предыдущих фрагментов. Авторы CacheBlend пробуют переиспользовать такие блоки с выборочным пересчётом. Работа показывает, почему ограничение «только префикс» не является фундаментальным для всех архитектур; она не подтверждает, что какой-то из трёх API продаёт такой режим.&lt;sup id="fnref1:15"&gt;&lt;a href="#fn:15" class="footnote-ref" role="doc-noteref"&gt;15&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="claude-окно-назад-ищет-записи-а-не-общий-текст"&gt;&lt;a href="#claude-%d0%be%d0%ba%d0%bd%d0%be-%d0%bd%d0%b0%d0%b7%d0%b0%d0%b4-%d0%b8%d1%89%d0%b5%d1%82-%d0%b7%d0%b0%d0%bf%d0%b8%d1%81%d0%b8-%d0%b0-%d0%bd%d0%b5-%d0%be%d0%b1%d1%89%d0%b8%d0%b9-%d1%82%d0%b5%d0%ba%d1%81%d1%82" class="post_hash"&gt;Claude: окно назад ищет записи, а не общий текст&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;В Messages API порядок — &lt;code&gt;tools → system → messages&lt;/code&gt;. &lt;code&gt;cache_control&lt;/code&gt; на блоке отмечает конец префикса &lt;strong&gt;включительно&lt;/strong&gt;; верхнеуровневый &lt;code&gt;cache_control&lt;/code&gt; ставит такую отметку на последнем подходящем блоке. Если у него нет совпадения, Claude проверяет до 20 позиций, включая сам breakpoint. В этом окне ищут ранее записанный префикс. Тот факт, что стабильный &lt;code&gt;system&lt;/code&gt; остался прежним, не помогает, если ни один запрос никогда не записывал кэш на его границе. У Sonnet 5.5 порог на прямом Claude API — 512 токенов; если оба счётчика чтения и записи нулевые, короткий префикс не обязательно вызовет ошибку — он мог просто не кэшироваться.&lt;sup id="fnref3:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Типичный сбой: на каждом независимом запросе новый timestamp и вопрос, а breakpoint стоит на вопросе. Каждый запрос записывает большой префикс по тарифу записи, потом ни разу его не читает. Ставить breakpoint нужно перед timestamp. В растущей истории вопрос, уже записанный на предыдущем ходу, напротив, может попасть в окно поиска следующего запроса: этот сценарий подходит для автоматического breakpoint. Если между записями накопилось слишком много позиций, фиксированная граница для стабильной части снова полезна. Серии соседних &lt;code&gt;tool_use&lt;/code&gt; и &lt;code&gt;tool_result&lt;/code&gt; считаются группами по правилам Claude API; число вызовов не равно числу позиций окна.&lt;sup id="fnref4:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Поменять описание базового инструмента дороже, чем поменять &lt;code&gt;tool_choice&lt;/code&gt;: по таблице Anthropic первое задевает все три слоя, второе — только слой сообщений. Для поддерживаемого отложенного инструмента &lt;code&gt;defer_loading&lt;/code&gt; позволяет не помещать его определение в начальный префикс: после обнаружения ссылка на инструмент попадает в историю. В Claude Code полезно по той же причине различать дописывание сообщения и &lt;code&gt;/compact&lt;/code&gt;, который переписывает старый контекст. Это не повод откладывать необходимую смену прав или инструментов ради скидки.&lt;sup id="fnref5:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:16"&gt;&lt;a href="#fn:16" class="footnote-ref" role="doc-noteref"&gt;16&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:13"&gt;&lt;a href="#fn:13" class="footnote-ref" role="doc-noteref"&gt;13&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Пятиминутная запись Sonnet 5.5 стоит $2,50, часовая — $4,00, чтение — $0,10 при базовых $2,00 за миллион токенов. Если отправить запросы параллельно, они не смогут прочитать запись первого запроса до начала его ответа. Время жизни считается от старта читающего или записывающего запроса, а не от окончания стрима. Поэтому с TTL надо сравнивать интервал между началами запросов: четыре минуты генерации и две минуты на следующий tool result уже не укладываются в пять минут без промежуточного чтения.&lt;sup id="fnref6:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="openai-автоматический-больше-не-значит-без-платы-за-запись"&gt;&lt;a href="#openai-%d0%b0%d0%b2%d1%82%d0%be%d0%bc%d0%b0%d1%82%d0%b8%d1%87%d0%b5%d1%81%d0%ba%d0%b8%d0%b9-%d0%b1%d0%be%d0%bb%d1%8c%d1%88%d0%b5-%d0%bd%d0%b5-%d0%b7%d0%bd%d0%b0%d1%87%d0%b8%d1%82-%d0%b1%d0%b5%d0%b7-%d0%bf%d0%bb%d0%b0%d1%82%d1%8b-%d0%b7%d0%b0-%d0%b7%d0%b0%d0%bf%d0%b8%d1%81%d1%8c" class="post_hash"&gt;OpenAI: «автоматический» больше не значит «без платы за запись»&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Ранний анонс описывал автоматическое кэширование с шагом 128 токенов. У GPT-5.5 и более ранних поколений руководство по-прежнему не указывает отдельной платы за запись; границы там выбираются автоматически, а в usage число прочитанных токенов округляется вниз до кратного 128. У GPT-5.6 и новее минимальный подходящий префикс — 1 024 видимых входных токена; доступен явный &lt;code&gt;prompt_cache_breakpoint&lt;/code&gt;, а в implicit mode могут находиться и границы более ранних сообщений. Значит, старое правило про 128 нельзя использовать для проверки счёта GPT-6.2 Sol.&lt;sup id="fnref7:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:18"&gt;&lt;a href="#fn:18" class="footnote-ref" role="doc-noteref"&gt;18&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:6"&gt;&lt;a href="#fn:6" class="footnote-ref" role="doc-noteref"&gt;6&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Для GPT-6.2 Sol в Responses API &lt;code&gt;prompt_cache_options.mode: explicit&lt;/code&gt; без отмеченных границ не создаёт записей. Если отметить только конец общей инструкции, хвост после неё идёт по обычной цене. При этом верхнеуровневые &lt;code&gt;instructions&lt;/code&gt; у GPT-6.2 помещаются &lt;strong&gt;после&lt;/strong&gt; &lt;code&gt;input&lt;/code&gt; и оплачиваются как обычный вход даже при попадании в кэш. Туда удобно отправлять переменные указания для одного хода. Чтобы одни и те же правила участвовали в кэшировании, поместите их в первое &lt;code&gt;developer&lt;/code&gt;-сообщение внутри &lt;code&gt;input&lt;/code&gt;.&lt;sup id="fnref8:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;У GPT-6.2 Sol по короткому стандартному тарифу базовый вход — $2,00 за миллион, чтение — $0,10, запись на &lt;code&gt;30m&lt;/code&gt; — $2,50, на &lt;code&gt;12h&lt;/code&gt; — $5,00. Это полные ставки, не доплата поверх $2,00. Переход с ещё действующих &lt;code&gt;30m&lt;/code&gt; на &lt;code&gt;12h&lt;/code&gt; при совпадающем префиксе может попасть в usage как новая запись без зачёта прежней оплаты. При чтении с &lt;code&gt;30m&lt;/code&gt; окно продлевается минимум на 30 минут от этого чтения; имеющееся 12-часовое покрытие не перезапускается на 12 часов. Минимальный TTL относится к доступности тарифа чтения, а не к обещанию физического переиспользования KV или меньшего TTFT для каждого запроса.&lt;sup id="fnref9:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:6"&gt;&lt;a href="#fn:6" class="footnote-ref" role="doc-noteref"&gt;6&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Маршрутизация добавляет ещё одну причину расхождения. Документация OpenAI привязывает физическое состояние к отдельной машине: нагрузка может перенаправить запрос, хотя содержимое не менялось. Стабильный &lt;code&gt;prompt_cache_key&lt;/code&gt; рекомендован для оптимизации маршрутизации до GPT-5.6; для новых поколений документация описывает его как способ разделять учёт и повторное использование между группами запросов. Ни ключ, ни неизменная история не заменяют данные об объёме фактического чтения.&lt;sup id="fnref10:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:19"&gt;&lt;a href="#fn:19" class="footnote-ref" role="doc-noteref"&gt;19&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="gemini-попадание-в-префикс-или-ссылка-на-объект"&gt;&lt;a href="#gemini-%d0%bf%d0%be%d0%bf%d0%b0%d0%b4%d0%b0%d0%bd%d0%b8%d0%b5-%d0%b2-%d0%bf%d1%80%d0%b5%d1%84%d0%b8%d0%ba%d1%81-%d0%b8%d0%bb%d0%b8-%d1%81%d1%81%d1%8b%d0%bb%d0%ba%d0%b0-%d0%bd%d0%b0-%d0%be%d0%b1%d1%8a%d0%b5%d0%ba%d1%82" class="post_hash"&gt;Gemini: попадание в префикс или ссылка на объект&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;В &lt;code&gt;generateContent&lt;/code&gt; для Gemini 3.8 Flash implicit caching включён по умолчанию, заявленный порог — 4 096 входных токенов. Работа с ним похожа на обычное префиксное кэширование: повторяемый контекст в начале запроса увеличивает шанс на попадание, но документация не обещает его. У этой модели также доступен explicit caching: клиент создаёт &lt;code&gt;CachedContent&lt;/code&gt; через &lt;code&gt;v1beta&lt;/code&gt;, затем указывает ресурс в &lt;code&gt;cachedContent&lt;/code&gt; при генерации. Это не подсказка маршрутизатору, а ссылка на конкретный общий контекст. Gemini 4 не поддерживает этот способ; при смене модели нельзя сохранять контракт приложения на уровне «у нас Gemini, значит есть &lt;code&gt;cachedContent&lt;/code&gt;».&lt;sup id="fnref2:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:12"&gt;&lt;a href="#fn:12" class="footnote-ref" role="doc-noteref"&gt;12&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:20"&gt;&lt;a href="#fn:20" class="footnote-ref" role="doc-noteref"&gt;20&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:8"&gt;&lt;a href="#fn:8" class="footnote-ref" role="doc-noteref"&gt;8&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;У объекта по умолчанию час жизни. При обновлении можно изменить только время истечения, а не сам текст. Для новой редакции корпуса нужно создать другой объект и переключить ссылку; если обе версии остаются живы, в расчёт входит хранение обеих. Изменение вопроса после ссылки объект не переписывает. В таком запросе implicit caching уже не применяется, а присланный рядом с &lt;code&gt;cachedContent&lt;/code&gt; хвост оплачивается по обычной входной ставке. Утверждение касается Gemini Developer API, не Google Cloud Agent Platform с её собственными условиями хранения и записи.&lt;sup id="fnref3:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:20"&gt;&lt;a href="#fn:20" class="footnote-ref" role="doc-noteref"&gt;20&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:21"&gt;&lt;a href="#fn:21" class="footnote-ref" role="doc-noteref"&gt;21&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;За миллион токенов в платном Standard для Gemini 3.8 Flash указаны $0,75 за вход и $0,075 за чтение; explicit storage стоит $0,50 за миллион токенов в час. Google публикует удвоение этих трёх ставок с 1 января 2027-го. Надпись «90%» останется верной для чтения, но абсолютная сумма удвоится при прежнем профиле запросов.&lt;sup id="fnref4:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="цена-одной-правки"&gt;&lt;a href="#%d1%86%d0%b5%d0%bd%d0%b0-%d0%be%d0%b4%d0%bd%d0%be%d0%b9-%d0%bf%d1%80%d0%b0%d0%b2%d0%ba%d0%b8" class="post_hash"&gt;Цена одной правки&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Модель счёта: шесть запросов, в каждом 12 000 токенов общего префикса и 2 000 нового хвоста. Это условно одинаковое &lt;strong&gt;число токенов&lt;/strong&gt; для каждой модели, не результат токенизации одного файла тремя сервисами. Хвост не записывается. Для Claude и OpenAI строка «одна запись» предполагает пять чтений всего общего префикса; строка «каждый раз запись» показывает, что произойдёт, если каждый ход приносит новую редакцию перед границей. Считаем только вход и явное хранение, без output, налогов, Batch и других услуг.&lt;sup id="fnref11:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref7:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref3:6"&gt;&lt;a href="#fn:6" class="footnote-ref" role="doc-noteref"&gt;6&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref3:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Формула для строки с записью: &lt;code&gt;12 000 × (ставка записи + 5 × ставка чтения) + 6 × 2 000 × ставка входа&lt;/code&gt;; если ставки за миллион, результат делится на миллион. Одна ранняя правка стоит &lt;code&gt;12 000 × (ставка записи − ставка чтения) / 1 000 000&lt;/code&gt; дополнительно, если она заменила одно полное чтение одной полной записью, а последующие запросы уже читают новую редакцию. Если есть попадание на более короткой границе, ту же разность нужно считать только для переписанных токенов.&lt;sup id="fnref12:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref8:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref3:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref4:6"&gt;&lt;a href="#fn:6" class="footnote-ref" role="doc-noteref"&gt;6&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Модель и TTL&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th style="text-align: right"&gt;Без кэша&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th style="text-align: right"&gt;Одна запись&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th style="text-align: right"&gt;Каждый раз запись&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th style="text-align: right"&gt;Одно лишнее переписывание&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Claude Sonnet 5.5, 5m&lt;sup id="fnref4:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;$0,1680&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;$0,0600&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;$0,2040&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;+$0,0288&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Claude Sonnet 5.5, 1h&lt;sup id="fnref5:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;$0,1680&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;$0,0780&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;$0,3120&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;+$0,0468&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;GPT-6.2 Sol, 30m&lt;sup id="fnref13:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref5:6"&gt;&lt;a href="#fn:6" class="footnote-ref" role="doc-noteref"&gt;6&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;$0,1680&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;$0,0600&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;$0,2040&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;+$0,0288&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;GPT-6.2 Sol, 12h&lt;sup id="fnref14:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref6:6"&gt;&lt;a href="#fn:6" class="footnote-ref" role="doc-noteref"&gt;6&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;$0,1680&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;$0,0900&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;$0,3840&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;+$0,0588&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;Короткой записи в этом примере хватает одного полного чтения, чтобы обойти два обычных входа. Длинной нужно два чтения. Но выбирать между TTL надо по другому сравнению: сколько повторных коротких записей он заменит. Для этой нагрузки часовая запись Claude по $4,00 за миллион плюс чтение по $0,10 дешевле двух коротких записей по $2,50. У OpenAI запись на &lt;code&gt;12h&lt;/code&gt; стоит как две короткие, но при длинном TTL на втором запросе ещё оплачивается чтение. При одинаковом количестве последующих чтений выигрыш появляется только если длинное покрытие предотвратит как минимум две повторные короткие записи. Указанные пороги предполагают полный префикс без дополнительных факторов тарификации.&lt;sup id="fnref15:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref6:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref7:6"&gt;&lt;a href="#fn:6" class="footnote-ref" role="doc-noteref"&gt;6&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Gemini за те же шесть запросов без попаданий: &lt;strong&gt;$0,0630&lt;/strong&gt;. При одном обычном входе и пяти implicit hits: &lt;strong&gt;$0,0225&lt;/strong&gt;. Один потерянный implicit hit добавляет &lt;strong&gt;$0,0081&lt;/strong&gt;. В explicit-варианте шесть чтений, шесть хвостов и час хранения одного объекта дают &lt;strong&gt;$0,0204&lt;/strong&gt; по перечисленным в гайде компонентам; ещё час хранения второй редакции такого же размера добавил бы &lt;strong&gt;$0,0060&lt;/strong&gt;. Если создание отдельно тарифицируется по базовому входу, для одного объекта получилось бы &lt;strong&gt;$0,0294&lt;/strong&gt;. Это проверка чувствительности, не заявка на точную сумму счёта: назначение отдельной ставки операции &lt;code&gt;caches.create&lt;/code&gt; для этого тарифа публичная документация Developer API в этих разделах не разъясняет, а схожий документ Google Cloud явно описывает собственное правило.&lt;sup id="fnref5:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:20"&gt;&lt;a href="#fn:20" class="footnote-ref" role="doc-noteref"&gt;20&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref4:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:21"&gt;&lt;a href="#fn:21" class="footnote-ref" role="doc-noteref"&gt;21&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="что-смотреть-в-usage-а-не-в-логах-приложения"&gt;&lt;a href="#%d1%87%d1%82%d0%be-%d1%81%d0%bc%d0%be%d1%82%d1%80%d0%b5%d1%82%d1%8c-%d0%b2-usage-%d0%b0-%d0%bd%d0%b5-%d0%b2-%d0%bb%d0%be%d0%b3%d0%b0%d1%85-%d0%bf%d1%80%d0%b8%d0%bb%d0%be%d0%b6%d0%b5%d0%bd%d0%b8%d1%8f" class="post_hash"&gt;Что смотреть в usage, а не в логах приложения&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;У Claude при суммировании входа нужны &lt;code&gt;input_tokens&lt;/code&gt;, &lt;code&gt;cache_read_input_tokens&lt;/code&gt; и &lt;code&gt;cache_creation_input_tokens&lt;/code&gt;. Для расходов на запись разбивка по TTL важна не меньше хорошо выглядящего процента попаданий: Messages Usage Report даёт отдельно &lt;code&gt;ephemeral_5m_input_tokens&lt;/code&gt; и &lt;code&gt;ephemeral_1h_input_tokens&lt;/code&gt;. Оператору полезно строить график доли прочитанных токенов как суммы чтений, делённой на сумму всего входа, а не как среднее процентов отдельных ходов. Пара коротких попаданий иначе скроет один большой промах.&lt;sup id="fnref9:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:22"&gt;&lt;a href="#fn:22" class="footnote-ref" role="doc-noteref"&gt;22&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;OpenAI уже включает чтение и записи в &lt;code&gt;usage.input_tokens&lt;/code&gt;: для обычного входа вычесть &lt;code&gt;cached_tokens&lt;/code&gt; и &lt;code&gt;cache_write_tokens&lt;/code&gt;, а для суммы записи взять &lt;code&gt;ttl_30m_tokens&lt;/code&gt; и &lt;code&gt;ttl_12h_tokens&lt;/code&gt; внутри &lt;code&gt;cache_write_tokens_details&lt;/code&gt;, не прибавляя итог ещё раз. Для поддерживаемых моделей в Responses можно сравнить два запроса через Prompt Cache Diagnostics: он помогает отличить изменение tool schema или входа от других причин недочитывания. &lt;code&gt;cached_tokens&lt;/code&gt; остаётся источником для счёта даже при наличии диагностического ответа.&lt;sup id="fnref16:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:19"&gt;&lt;a href="#fn:19" class="footnote-ref" role="doc-noteref"&gt;19&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;В Gemini &lt;code&gt;promptTokenCount&lt;/code&gt; — полный эффективный размер промпта, включая &lt;code&gt;cachedContentTokenCount&lt;/code&gt;; складывать эти два счётчика нельзя. Разница описывает некэшированную часть этого промпта, но не заменяет раздельный учёт tool-use prompt, output и хранения. Для explicit-кэша полезно сопоставлять &lt;code&gt;usageMetadata&lt;/code&gt; генерации с количеством токенов, временем создания и истечения каждого ресурса: нулевое число генераций не означает нулевые расходы на живой объект.&lt;sup id="fnref6:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref3:20"&gt;&lt;a href="#fn:20" class="footnote-ref" role="doc-noteref"&gt;20&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref5:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:23"&gt;&lt;a href="#fn:23" class="footnote-ref" role="doc-noteref"&gt;23&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Перед изменением агента я бы зафиксировал модель, тариф, длину и версию общего контекста, порядок инструментов и расстояние между началами запросов. Для сравнения достаточно трёх контролей: неизменный префикс с новым вопросом, правка до записанной границы, пауза за предполагаемым TTL. Отдельно считать cold/warm вход, объём записей, TTFT до первого видимого токена и полную задержку. Это план проверки, не результат замера. Исследование Mooncake показывает, почему это разделение имеет смысл: ожидание KV с более медленного уровня хранения или перегруженной сети может само не уложиться в TTFT SLO.&lt;sup id="fnref17:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref10:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref7:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:24"&gt;&lt;a href="#fn:24" class="footnote-ref" role="doc-noteref"&gt;24&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="дискуссионные-вопросы-и-противоречия"&gt;&lt;a href="#%d0%b4%d0%b8%d1%81%d0%ba%d1%83%d1%81%d1%81%d0%b8%d0%be%d0%bd%d0%bd%d1%8b%d0%b5-%d0%b2%d0%be%d0%bf%d1%80%d0%be%d1%81%d1%8b-%d0%b8-%d0%bf%d1%80%d0%be%d1%82%d0%b8%d0%b2%d0%be%d1%80%d0%b5%d1%87%d0%b8%d1%8f" class="post_hash"&gt;Дискуссионные вопросы и противоречия&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;«Скидка до 95%» у OpenAI и «гарантия экономии» в руководстве по explicit caching Gemini описывают не одно и то же. Первая относится к ставке чтения, вторая — к возможности ссылаться на сохранённый контекст вместо надежды на совпадение. В обоих случаях общий счёт зависит от числа запросов. У Claude и OpenAI при платной записи один полностью холодный цикл может стоить дороже обычного входа; у Gemini длительное хранение редко используемой версии повышает сумму, даже если каждое обращение получает скидку. Artificial Analysis отдельно оговаривает, что процент скидки на чтение не включает запись и хранение.&lt;sup id="fnref18:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref11:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref8:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref7:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref6:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:25"&gt;&lt;a href="#fn:25" class="footnote-ref" role="doc-noteref"&gt;25&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Имеет ли смысл переписывать историю ради короткого контекста? На следующем ходу компактификация может лишить кэша уже вычисленную историю; на длинном горизонте она может уменьшить объём обрабатываемого входа. Не стоит выбирать по одному проценту: сравнивать нужно стоимость всей сессии и качество решения на том же наборе задач. Отдельный разовый холодный ход при необходимой смене политики лучше считать ожидаемым расходом, а не пытаться сохранить старые инструкции ради попадания.&lt;sup id="fnref19:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref12:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:13"&gt;&lt;a href="#fn:13" class="footnote-ref" role="doc-noteref"&gt;13&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="недостаточность-данных"&gt;&lt;a href="#%d0%bd%d0%b5%d0%b4%d0%be%d1%81%d1%82%d0%b0%d1%82%d0%be%d1%87%d0%bd%d0%be%d1%81%d1%82%d1%8c-%d0%b4%d0%b0%d0%bd%d0%bd%d1%8b%d1%85" class="post_hash"&gt;Недостаточность данных&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Из открытых источников нельзя вывести вероятность попадания Gemini implicit после заданной паузы либо распределение задержки OpenAI после &lt;code&gt;12h&lt;/code&gt; для конкретной организации. Гайды описывают допустимые границы, условия хранения и тарифов, а не SLO физического попадания для нагрузки читателя. Нет и фактического счёта &lt;code&gt;caches.create&lt;/code&gt; для разобранного Developer API-тарифа. Поэтому расчёт Google даётся по компонентам с чувствительностью к отдельной плате за создание, а вывод про TTFT ограничивается механизмом, не обещанием ускорения.&lt;sup id="fnref20:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref9:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref7:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:21"&gt;&lt;a href="#fn:21" class="footnote-ref" role="doc-noteref"&gt;21&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:19"&gt;&lt;a href="#fn:19" class="footnote-ref" role="doc-noteref"&gt;19&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:24"&gt;&lt;a href="#fn:24" class="footnote-ref" role="doc-noteref"&gt;24&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="заключение"&gt;&lt;a href="#%d0%b7%d0%b0%d0%ba%d0%bb%d1%8e%d1%87%d0%b5%d0%bd%d0%b8%d0%b5" class="post_hash"&gt;Заключение&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Первое исправление при падении попаданий — найти первую изменившуюся часть &lt;strong&gt;модельного&lt;/strong&gt; префикса и посмотреть, была ли до неё записана доступная граница. Для Claude это обычно явная отметка после стабильных блоков; для GPT-6.2 Sol — раннее &lt;code&gt;developer&lt;/code&gt;-сообщение вместо глобального &lt;code&gt;instructions&lt;/code&gt;, с явной границей, если непереиспользуемый хвост дорого писать; для Gemini 3.8 Flash — либо неизменное начало в implicit mode, либо версионируемый &lt;code&gt;CachedContent&lt;/code&gt; с учётом срока хранения. Удлинять TTL имеет смысл после того, как usage показал, что причина лишних записей — паузы, а не постоянные правки. Считать стоит не скидку со строки прайса, а стоимость обычного входа, прочитанного префикса, повторных записей и живых объектов за весь цикл.&lt;sup id="fnref21:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref13:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref10:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref8:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref8:6"&gt;&lt;a href="#fn:6" class="footnote-ref" role="doc-noteref"&gt;6&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref8:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:23"&gt;&lt;a href="#fn:23" class="footnote-ref" role="doc-noteref"&gt;23&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:22"&gt;&lt;a href="#fn:22" class="footnote-ref" role="doc-noteref"&gt;22&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="quality-metrics"&gt;&lt;a href="#quality-metrics" class="post_hash"&gt;Quality Metrics&lt;/a&gt;&lt;/h2&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Metric&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th style="text-align: right"&gt;Value&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Sources found&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;91&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Sources read&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;25&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Sources cited&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;25&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Counting units&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;Уникальные URL при поиске; отдельные документы с проверенными фрагментами при чтении и цитировании&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Academic sources&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;3&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Official/documentation&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;21&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Industry reports&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;1&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;News/journalism&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;0&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Blog/forum&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;0&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Citation coverage&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;100%&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Counter-arguments searched&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;Yes&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Research rounds&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;3&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Questions emerged&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;5&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Questions resolved&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;2&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Questions insufficient data&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;3&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;div class="footnotes" role="doc-endnotes"&gt;&#10;&lt;hr&gt;&#10;&lt;ol&gt;&#10;&lt;li id="fn:1"&gt;&#10;&lt;p&gt;OpenAI. «Prompt caching». OpenAI API, редакция на 2026-11-22. &lt;a href="https://developers.openai.com/api/docs/guides/prompt-caching.md"&gt;https://developers.openai.com/api/docs/guides/prompt-caching.md&lt;/a&gt;&amp;#160;&lt;a href="#fnref:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref7:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref8:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref9:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref10:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref11:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref12:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref13:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref14:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref15:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref16:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref17:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref18:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref19:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref20:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref21:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:2"&gt;&#10;&lt;p&gt;Anthropic. «Prompt caching». Claude Platform Docs, редакция на 2026-11-22. &lt;a href="https://platform.claude.com/docs/en/build-with-claude/prompt-caching"&gt;https://platform.claude.com/docs/en/build-with-claude/prompt-caching&lt;/a&gt;&amp;#160;&lt;a href="#fnref:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref7:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref8:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref9:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref10:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref11:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref12:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref13:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:3"&gt;&#10;&lt;p&gt;Google. «Context caching». Gemini API, редакция на 2026-11-22. &lt;a href="https://ai.google.dev/gemini-api/docs/generate-content/caching"&gt;https://ai.google.dev/gemini-api/docs/generate-content/caching&lt;/a&gt;&amp;#160;&lt;a href="#fnref:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref7:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref8:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref9:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref10:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:4"&gt;&#10;&lt;p&gt;Anthropic. «Claude Sonnet 5.5». Claude Platform Docs, редакция на 2026-11-22. &lt;a href="https://platform.claude.com/docs/en/models/sonnet-5-5/overview.md"&gt;https://platform.claude.com/docs/en/models/sonnet-5-5/overview.md&lt;/a&gt;&amp;#160;&lt;a href="#fnref:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:5"&gt;&#10;&lt;p&gt;Anthropic. «Pricing». Claude Platform Docs, раздел Prompt caching, редакция на 2026-11-22. &lt;a href="https://platform.claude.com/docs/en/about-claude/pricing"&gt;https://platform.claude.com/docs/en/about-claude/pricing&lt;/a&gt;&amp;#160;&lt;a href="#fnref:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref7:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref8:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:6"&gt;&#10;&lt;p&gt;OpenAI. «GPT-6.2 Sol». OpenAI API, редакция на 2026-11-22. &lt;a href="https://developers.openai.com/api/docs/models/gpt-6.2-sol"&gt;https://developers.openai.com/api/docs/models/gpt-6.2-sol&lt;/a&gt;&amp;#160;&lt;a href="#fnref:6" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:6" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:6" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:6" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:6" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:6" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:6" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref7:6" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref8:6" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:7"&gt;&#10;&lt;p&gt;Google. «Gemini Developer API pricing». Gemini 3.8 Flash, редакция на 2026-11-22. &lt;a href="https://ai.google.dev/gemini-api/docs/pricing"&gt;https://ai.google.dev/gemini-api/docs/pricing&lt;/a&gt;&amp;#160;&lt;a href="#fnref:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref7:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref8:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:8"&gt;&#10;&lt;p&gt;Google. «Gemini 3.8 Flash». Gemini API, редакция на 2026-11-22. &lt;a href="https://aistudio.google.com/docs/models/gemini-3.8-flash"&gt;https://aistudio.google.com/docs/models/gemini-3.8-flash&lt;/a&gt;&amp;#160;&lt;a href="#fnref:8" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:8" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:9"&gt;&#10;&lt;p&gt;Anthropic. «Claude Platform release notes». Запись от 2025-08-13. &lt;a href="https://platform.claude.com/docs/en/release-notes/overview"&gt;https://platform.claude.com/docs/en/release-notes/overview&lt;/a&gt;&amp;#160;&lt;a href="#fnref:9" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:10"&gt;&#10;&lt;p&gt;AWS. «Amazon Bedrock 现在支持 1 小时提示缓存时长». AWS What&amp;rsquo;s New, 2026-01-26. &lt;a href="https://aws.amazon.com/about-aws/whats-new/2026/01/amazon-bedrock-one-hour-duration-prompt-caching/"&gt;https://aws.amazon.com/about-aws/whats-new/2026/01/amazon-bedrock-one-hour-duration-prompt-caching/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:10" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:11"&gt;&#10;&lt;p&gt;Google. «Gemini 2.5 Models now support implicit caching». Google Developers Blog, 2025-05-08. &lt;a href="https://developers.googleblog.com/en/gemini-2-5-models-now-support-implicit-caching/"&gt;https://developers.googleblog.com/en/gemini-2-5-models-now-support-implicit-caching/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:11" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:12"&gt;&#10;&lt;p&gt;Google. «Release notes». Gemini API, записи от 2026-09-02 и 2026-11-18. &lt;a href="https://ai.google.dev/gemini-api/docs/changelog"&gt;https://ai.google.dev/gemini-api/docs/changelog&lt;/a&gt;&amp;#160;&lt;a href="#fnref:12" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:12" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:13"&gt;&#10;&lt;p&gt;Anthropic. «How Claude Code uses prompt caching». Claude Code Docs, редакция на 2026-11-22. &lt;a href="https://code.claude.com/docs/en/prompt-caching"&gt;https://code.claude.com/docs/en/prompt-caching&lt;/a&gt;&amp;#160;&lt;a href="#fnref:13" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:13" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:13" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:14"&gt;&#10;&lt;p&gt;vLLM. «Automatic Prefix Caching». Документация v0.30.0. &lt;a href="https://docs.vllm.ai/en/v0.30.0/design/prefix_caching/"&gt;https://docs.vllm.ai/en/v0.30.0/design/prefix_caching/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:14" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:14" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:15"&gt;&#10;&lt;p&gt;Jiayi Yao et al. «CacheBlend: Fast Large Language Model Serving for RAG with Cached Knowledge Fusion». arXiv:2405.16444v3, 2025-04-03. &lt;a href="https://arxiv.org/html/2405.16444v3"&gt;https://arxiv.org/html/2405.16444v3&lt;/a&gt;&amp;#160;&lt;a href="#fnref:15" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:15" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:16"&gt;&#10;&lt;p&gt;Anthropic. «Tool use with prompt caching». Claude Platform Docs, редакция на 2026-11-22. &lt;a href="https://platform.claude.com/docs/en/agents-and-tools/tool-use/tool-use-with-prompt-caching"&gt;https://platform.claude.com/docs/en/agents-and-tools/tool-use/tool-use-with-prompt-caching&lt;/a&gt;&amp;#160;&lt;a href="#fnref:16" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:16" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:17"&gt;&#10;&lt;p&gt;Lianmin Zheng et al. «SGLang: Efficient Execution of Structured Language Model Programs». arXiv:2312.07104v2, 2024-06-06. &lt;a href="https://arxiv.org/html/2312.07104v2"&gt;https://arxiv.org/html/2312.07104v2&lt;/a&gt;&amp;#160;&lt;a href="#fnref:17" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:18"&gt;&#10;&lt;p&gt;OpenAI. «Prompt Caching in the API». Анонс кэширования для GPT-4o и o1. &lt;a href="https://openai.com/index/api-prompt-caching/"&gt;https://openai.com/index/api-prompt-caching/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:18" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:19"&gt;&#10;&lt;p&gt;OpenAI. «Prompt cache diagnostics». OpenAI API, редакция на 2026-11-22. &lt;a href="https://developers.openai.com/api/docs/guides/prompt-caching/diagnostics.md"&gt;https://developers.openai.com/api/docs/guides/prompt-caching/diagnostics.md&lt;/a&gt;&amp;#160;&lt;a href="#fnref:19" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:19" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:19" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:20"&gt;&#10;&lt;p&gt;Google. «Caching». Gemini API Reference, редакция на 2026-11-22. &lt;a href="https://ai.google.dev/api/caching"&gt;https://ai.google.dev/api/caching&lt;/a&gt;&amp;#160;&lt;a href="#fnref:20" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:20" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:20" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:20" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:21"&gt;&#10;&lt;p&gt;Google Cloud. «Context caching overview». Gemini Enterprise Agent Platform, редакция на 2026-11-22. &lt;a href="https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/context-cache/context-cache-overview"&gt;https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/context-cache/context-cache-overview&lt;/a&gt;&amp;#160;&lt;a href="#fnref:21" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:21" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:21" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:22"&gt;&#10;&lt;p&gt;Anthropic. «Get Messages Usage Report». Claude API Reference, редакция на 2026-11-22. &lt;a href="https://platform.claude.com/docs/en/api/admin/usage_report/retrieve_messages"&gt;https://platform.claude.com/docs/en/api/admin/usage_report/retrieve_messages&lt;/a&gt;&amp;#160;&lt;a href="#fnref:22" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:22" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:23"&gt;&#10;&lt;p&gt;Google. «Generating content». Gemini API Reference, &lt;code&gt;UsageMetadata&lt;/code&gt;, редакция на 2026-11-22. &lt;a href="https://ai.google.dev/api/generate-content"&gt;https://ai.google.dev/api/generate-content&lt;/a&gt;&amp;#160;&lt;a href="#fnref:23" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:23" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:24"&gt;&#10;&lt;p&gt;Ruoyu Qin et al. «Mooncake: Kimi’s KVCache-centric Architecture for LLM Serving». arXiv:2407.00079v1, 2024-06-24. &lt;a href="https://arxiv.org/html/2407.00079v1"&gt;https://arxiv.org/html/2407.00079v1&lt;/a&gt;&amp;#160;&lt;a href="#fnref:24" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:24" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:25"&gt;&#10;&lt;p&gt;Artificial Analysis. «Prompt Caching: Cost &amp;amp; Performance Analysis Across Providers». Методика сравнения тарифов, редакция на 2026-11-22. &lt;a href="https://artificialanalysis.ai/models/caching"&gt;https://artificialanalysis.ai/models/caching&lt;/a&gt;&amp;#160;&lt;a href="#fnref:25" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;/ol&gt;&#10;&lt;/div&gt;&#10;</content></entry><entry><title>SSH-сертификаты вместо authorized_keys: когда срок жизни заменяет отзыв</title><id>https://research.evsyukov.org/articles/ssh-certificates-instead-of-authorized-keys/</id><link href="https://research.evsyukov.org/articles/ssh-certificates-instead-of-authorized-keys/" rel="alternate" type="text/html"/><published>2026-11-21T09:35:00+03:00</published><updated>2026-11-21T09:40:45+03:00</updated><author><name>Denis Evsyukov</name></author><summary type="html">Где короткоживущий SSH-сертификат заменяет удаление ключа, а где нужны KRL, смена CA и завершение сессий.</summary><content type="html">&lt;h2 id="аннотация"&gt;&lt;a href="#%d0%b0%d0%bd%d0%bd%d0%be%d1%82%d0%b0%d1%86%d0%b8%d1%8f" class="post_hash"&gt;Аннотация&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Короткий срок действия SSH-сертификата заменяет отзыв только в одном случае: можно дождаться, пока уже выданный сертификат перестанет приниматься при &lt;strong&gt;новой аутентификации&lt;/strong&gt;, и выпуск нового уже остановлен. Если доступ нужно закрыть раньше, серверу понадобится локальный запрет, например KRL. Если пользователь уже вошёл, ни истечение сертификата, ни обновление KRL не закрывают его SSH-соединение. Это три разных действия с разными сроками выполнения.&lt;sup id="fnref:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Данные на &lt;strong&gt;2026-11-21&lt;/strong&gt;. Срез — &lt;strong&gt;Portable OpenSSH 10.6p2&lt;/strong&gt;, небольшой парк Linux-серверов, именные администраторы и отдельно учтённая автоматизация. Рассматриваются пользовательские сертификаты, не миграция host keys. Предполагается, что есть способ менять серверную политику и восстанавливать доступ независимо от основного сервиса выдачи. Это обзор исходного кода, документации и практик; собственных сетевых прогонов и замеров нет.&lt;sup id="fnref:6"&gt;&lt;a href="#fn:6" class="footnote-ref" role="doc-noteref"&gt;6&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="введение"&gt;&lt;a href="#%d0%b2%d0%b2%d0%b5%d0%b4%d0%b5%d0%bd%d0%b8%d0%b5" class="post_hash"&gt;Введение&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;У ключа из &lt;code&gt;authorized_keys&lt;/code&gt; и у сертификата разные места, где живёт разрешение. В первом случае сервер читает локальную запись о ключе. Во втором он проверяет утверждение, подписанное доверенной CA, и собственную политику допуска. NISTIR 7966 рассматривает выдачу, прекращение и мониторинг SSH-доступа как отдельные процессы: сертификат меняет реализацию выдачи, но не устраняет два других процесса.&lt;sup id="fnref1:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:8"&gt;&lt;a href="#fn:8" class="footnote-ref" role="doc-noteref"&gt;8&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Повод вернуться к теме — релиз &lt;strong&gt;10.6p2 от 5 ноября 2026 года&lt;/strong&gt;: в список допустимых подписей CA добавили &lt;code&gt;ssh-mldsa44-ed25519&lt;/code&gt;. Это изменение совместимости, а не появление сертификатов в OpenSSH 10: поддержку пользовательских и хостовых сертификатов проект объявил ещё в 5.4. При обновлении полезно смотреть не только на алгоритм ключа клиента, но и на &lt;code&gt;CASignatureAlgorithms&lt;/code&gt; у проверяющей стороны. Ниже вопрос другой: что именно перестаёт работать и когда, если администратор больше не должен иметь доступ?&lt;sup id="fnref1:6"&gt;&lt;a href="#fn:6" class="footnote-ref" role="doc-noteref"&gt;6&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:9"&gt;&lt;a href="#fn:9" class="footnote-ref" role="doc-noteref"&gt;9&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref3:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="1-сертификат-заменяет-запись-о-допуске-не-приватный-ключ"&gt;&lt;a href="#1-%d1%81%d0%b5%d1%80%d1%82%d0%b8%d1%84%d0%b8%d0%ba%d0%b0%d1%82-%d0%b7%d0%b0%d0%bc%d0%b5%d0%bd%d1%8f%d0%b5%d1%82-%d0%b7%d0%b0%d0%bf%d0%b8%d1%81%d1%8c-%d0%be-%d0%b4%d0%be%d0%bf%d1%83%d1%81%d0%ba%d0%b5-%d0%bd%d0%b5-%d0%bf%d1%80%d0%b8%d0%b2%d0%b0%d1%82%d0%bd%d1%8b%d0%b9-%d0%ba%d0%bb%d1%8e%d1%87" class="post_hash"&gt;1. Сертификат заменяет запись о допуске, не приватный ключ&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;В &lt;code&gt;publickey&lt;/code&gt; пользователь доказывает, что может подписать запрос приватным ключом; SSH-сертификат не заменяет эту подпись. CA подписывает привязку &lt;strong&gt;публичного&lt;/strong&gt; ключа к назначению сертификата, principals, интервалу действия и ограничениям. Поэтому копия файла сертификата сама по себе не даёт входа. В клиентском &lt;code&gt;CertificateFile&lt;/code&gt; указан сертификат; соответствующий приватный ключ нужен отдельно и может оставаться в агенте или аппаратном провайдере.&lt;sup id="fnref:10"&gt;&lt;a href="#fn:10" class="footnote-ref" role="doc-noteref"&gt;10&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:11"&gt;&lt;a href="#fn:11" class="footnote-ref" role="doc-noteref"&gt;11&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:12"&gt;&lt;a href="#fn:12" class="footnote-ref" role="doc-noteref"&gt;12&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;blockquote&gt;&#10;&lt;p&gt;With this method, the possession of a private key serves as authentication.&lt;sup id="fnref1:10"&gt;&lt;a href="#fn:10" class="footnote-ref" role="doc-noteref"&gt;10&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;/blockquote&gt;&#10;&lt;p&gt;В обычной схеме выдачи оператор больше не раскладывает ключ каждого человека по всем машинам. На сервере появляется публичный ключ CA, а сервис выпуска решает, с какими principals подписать предоставленный ключ и на какой срок. Это переносит риск: ошибка при выдаче одной подписи затрагивает все серверы, которые доверяют этому CA &lt;strong&gt;и&lt;/strong&gt; примут подписанный principal для целевой учётной записи. Раздельные CA для окружений ограничивают последствия только тогда, когда их списки доверия на хостах действительно различаются.&lt;sup id="fnref2:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref4:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:13"&gt;&lt;a href="#fn:13" class="footnote-ref" role="doc-noteref"&gt;13&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:14"&gt;&lt;a href="#fn:14" class="footnote-ref" role="doc-noteref"&gt;14&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Формат следует отличать от X.509 и от базового метода &lt;code&gt;publickey&lt;/code&gt; в RFC 4252. Документ IETF &lt;code&gt;draft-ietf-sshm-cert-01&lt;/code&gt; описывает формат, происходящий от OpenSSH, но на дату среза это активный Internet-Draft, не опубликованный RFC. Поведение конкретного сервера, в том числе отказ при пустом списке principals, здесь проверено по &lt;code&gt;V_10_6_P2&lt;/code&gt;, а не выведено из текста черновика.&lt;sup id="fnref1:9"&gt;&lt;a href="#fn:9" class="footnote-ref" role="doc-noteref"&gt;9&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:10"&gt;&lt;a href="#fn:10" class="footnote-ref" role="doc-noteref"&gt;10&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:12"&gt;&lt;a href="#fn:12" class="footnote-ref" role="doc-noteref"&gt;12&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:15"&gt;&lt;a href="#fn:15" class="footnote-ref" role="doc-noteref"&gt;15&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="2-кто-решает-под-какой-учётной-записью-пустить"&gt;&lt;a href="#2-%d0%ba%d1%82%d0%be-%d1%80%d0%b5%d1%88%d0%b0%d0%b5%d1%82-%d0%bf%d0%be%d0%b4-%d0%ba%d0%b0%d0%ba%d0%be%d0%b9-%d1%83%d1%87%d1%91%d1%82%d0%bd%d0%be%d0%b9-%d0%b7%d0%b0%d0%bf%d0%b8%d1%81%d1%8c%d1%8e-%d0%bf%d1%83%d1%81%d1%82%d0%b8%d1%82%d1%8c" class="post_hash"&gt;2. Кто решает, под какой учётной записью пустить&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;При &lt;code&gt;TrustedUserCAKeys&lt;/code&gt; сервер знает, &lt;strong&gt;кто вправе подписывать&lt;/strong&gt;, а не кто именно должен получить shell. Если файл или команда principals не заданы, в сертификате должно быть имя целевого локального пользователя. С &lt;code&gt;AuthorizedPrincipalsFile&lt;/code&gt; или &lt;code&gt;AuthorizedPrincipalsCommand&lt;/code&gt; &lt;code&gt;sshd&lt;/code&gt; требует совпадения с разрешённым principal; можно, например, допускать &lt;code&gt;ops-prod&lt;/code&gt; для &lt;code&gt;maint&lt;/code&gt; на &lt;code&gt;build.example.org&lt;/code&gt;, не выдавая сертификат с именем &lt;code&gt;maint&lt;/code&gt; как универсальный пропуск. Локальная учётная запись и ограничения сервера остаются отдельными условиями.&lt;sup id="fnref5:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:13"&gt;&lt;a href="#fn:13" class="footnote-ref" role="doc-noteref"&gt;13&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Важное исключение при миграции: CA, доверенная через строку &lt;code&gt;cert-authority&lt;/code&gt; в &lt;code&gt;authorized_keys&lt;/code&gt;, идёт по другому пути. &lt;code&gt;AuthorizedPrincipalsFile&lt;/code&gt; для этой строки не применяется; аналогичное ограничение задаётся опцией &lt;code&gt;principals=&lt;/code&gt; самой записи. И наоборот, &lt;code&gt;AuthorizedKeysFile none&lt;/code&gt; убирает проверку файлов, но не отключает отдельно настроенный &lt;code&gt;AuthorizedKeysCommand&lt;/code&gt;. В 10.6p2 код проверки пробует файлы, затем &lt;code&gt;TrustedUserCAKeys&lt;/code&gt;, затем команду ключей. Успешный вход сертификатом ничего не говорит о том, остался ли другой способ входа.&lt;sup id="fnref6:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:13"&gt;&lt;a href="#fn:13" class="footnote-ref" role="doc-noteref"&gt;13&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:8"&gt;&lt;a href="#fn:8" class="footnote-ref" role="doc-noteref"&gt;8&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:16"&gt;&lt;a href="#fn:16" class="footnote-ref" role="doc-noteref"&gt;16&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Проверять полезно не только допуск к аккаунту, но и то, что доступно &lt;strong&gt;после&lt;/strong&gt; допуска. OpenSSH различает critical options и extensions: первые могут наложить ограничения вроде принудительной команды, вторые, среди прочего, разрешают PTY и виды forwarding. При переносе автоматизации со строки &lt;code&gt;authorized_keys&lt;/code&gt;, где был &lt;code&gt;command=&lt;/code&gt; или запрет forwarding, эти ограничения надо перенести в политику выдачи или серверную политику и проверить по отдельности. Принудительная команда сама по себе не запрещает forwarding.&lt;sup id="fnref3:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:12"&gt;&lt;a href="#fn:12" class="footnote-ref" role="doc-noteref"&gt;12&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref7:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:8"&gt;&lt;a href="#fn:8" class="footnote-ref" role="doc-noteref"&gt;8&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Наконец, &lt;code&gt;key ID&lt;/code&gt; и principal не взаимозаменяемы. &lt;code&gt;key ID&lt;/code&gt; помогает связать сертификат с записью о выдаче: исходник сервера показывает лог с ID, serial и fingerprint CA на пути &lt;code&gt;TrustedUserCAKeys&lt;/code&gt; (уровень verbose). Критерий допуска — сопоставление principals, а не красивый ID. На стороне выпуска стоит хранить связь между личностью, публичным ключом, CA, serial, principals и сроком; для инцидента важнее найти нужную запись, чем зашифровать все эти детали в одном поле.&lt;sup id="fnref2:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref4:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref3:13"&gt;&lt;a href="#fn:13" class="footnote-ref" role="doc-noteref"&gt;13&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="3-что-ограничивает-ttl"&gt;&lt;a href="#3-%d1%87%d1%82%d0%be-%d0%be%d0%b3%d1%80%d0%b0%d0%bd%d0%b8%d1%87%d0%b8%d0%b2%d0%b0%d0%b5%d1%82-ttl" class="post_hash"&gt;3. Что ограничивает TTL&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;В &lt;code&gt;sshkey_cert_check_authority&lt;/code&gt; версии 10.6p2 фактический интервал — &lt;code&gt;valid_after ≤ t &amp;lt; valid_before&lt;/code&gt;, где &lt;code&gt;t&lt;/code&gt; берётся по часам проверяющей стороны. Порог окончания исключающий: на секунде &lt;code&gt;valid_before&lt;/code&gt; новый вход с этим сертификатом уже не проходит. Без явно заданного интервала &lt;code&gt;ssh-keygen&lt;/code&gt; не делает сертификат короткоживущим: ручная выдача по умолчанию действует от Unix Epoch до далёкого будущего. Для проверки процесса выпуска надо смотреть поля полученного сертификата (&lt;code&gt;ssh-keygen -L&lt;/code&gt;), а не только заявленный TTL роли.&lt;sup id="fnref5:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref3:12"&gt;&lt;a href="#fn:12" class="footnote-ref" role="doc-noteref"&gt;12&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref3:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;blockquote&gt;&#10;&lt;p&gt;A certificate that is presented at a time outside this range will not be considered valid.&lt;sup id="fnref6:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;/blockquote&gt;&#10;&lt;p&gt;Допустим, сервис выдал последний сертификат на 15 минут в 12:00:00, записал &lt;code&gt;valid_before=12:15:00&lt;/code&gt; и сразу запретил дальнейшую выдачу. При правильных часах сервера окно для новой аутентификации — до 12:15:00; при отставании сервера на 30 секунд граница по эталонному времени сдвигается до 12:15:30. Это арифметика по коду, не измерение и не рекомендуемый TTL. Если несколько сертификатов ещё действуют, для оценки берут самый поздний &lt;code&gt;valid_before&lt;/code&gt; из допустимых, а на парке учитывают худшее отставание часов. Допуск на начало действия, вроде &lt;code&gt;not_before_duration&lt;/code&gt; у Vault, не исправляет отставание на другом конце интервала.&lt;sup id="fnref4:12"&gt;&lt;a href="#fn:12" class="footnote-ref" role="doc-noteref"&gt;12&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref4:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:14"&gt;&lt;a href="#fn:14" class="footnote-ref" role="doc-noteref"&gt;14&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Такая оценка работает только для уже выпущенных сертификатов. Если отключение пользователя в IdP не прерывает его возможность запросить подпись у выдающего сервиса, «последний сертификат» ещё не выдан. Поэтому на практике нужны два отдельных контрольных времени: когда запросы на выпуск начинают отклоняться и когда последний уже выданный сертификат перестаёт приниматься. В Vault, например, API разделяет список допустимых principals, запрашиваемый срок и &lt;code&gt;max_ttl&lt;/code&gt; роли. Эти ограничения относятся к выдаче, не к проверке на сервере.&lt;sup id="fnref8:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref5:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:14"&gt;&lt;a href="#fn:14" class="footnote-ref" role="doc-noteref"&gt;14&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="4-как-закрыть-окно-раньше"&gt;&lt;a href="#4-%d0%ba%d0%b0%d0%ba-%d0%b7%d0%b0%d0%ba%d1%80%d1%8b%d1%82%d1%8c-%d0%be%d0%ba%d0%bd%d0%be-%d1%80%d0%b0%d0%bd%d1%8c%d1%88%d0%b5" class="post_hash"&gt;4. Как закрыть окно раньше&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;На стороне OpenSSH &lt;code&gt;RevokedKeys&lt;/code&gt; принимает текстовый список публичных ключей или &lt;strong&gt;Key Revocation List&lt;/strong&gt; (KRL). По формату KRL можно запретить сертификаты по serial, диапазону serial или &lt;code&gt;key ID&lt;/code&gt; с привязкой к CA, а обычные ключи — по ключу или его fingerprint. В частности, serial &lt;code&gt;0&lt;/code&gt; — значение &lt;code&gt;ssh-keygen&lt;/code&gt; по умолчанию, но его нельзя адресовать строкой &lt;code&gt;serial:&lt;/code&gt;; заведите ненулевую уникальную последовательность в пределах CA, если нужен точечный отзыв. При краже приватного ключа отзыв единственного serial недостаточен, если тому же ключу соответствует другой действующий сертификат.&lt;sup id="fnref7:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref9:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:17"&gt;&lt;a href="#fn:17" class="footnote-ref" role="doc-noteref"&gt;17&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:18"&gt;&lt;a href="#fn:18" class="footnote-ref" role="doc-noteref"&gt;18&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;blockquote&gt;&#10;&lt;p&gt;Note that if this file is not readable, then public key authentication will be refused for all users.&lt;sup id="fnref10:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;/blockquote&gt;&#10;&lt;p&gt;Недоставленная и нечитабельная KRL — разные проблемы: хост со старой читаемой копией не знает о новом запрете, хост с нечитабельной копией отказывает в &lt;code&gt;publickey&lt;/code&gt;. В 10.6p2 ошибка проверки списка приводит к отказу, а сам файл документация предписывает заменять атомарно, не редактируя на месте. Поэтому рабочий критерий отзыва — не «KRL создана», а «проверенная версия доставлена и читается на нужных хостах». &lt;code&gt;ssh-keygen -Q&lt;/code&gt; позволяет заранее проверить список на отзываемом и контрольном сертификатах; это не заменяет проверку политики на целевом сервере.&lt;sup id="fnref8:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref11:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:19"&gt;&lt;a href="#fn:19" class="footnote-ref" role="doc-noteref"&gt;19&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Компрометация CA — отдельный случай. Короткое время жизни, выставляемое штатным сервисом, не накладывает тот же предел на подписи, сделанные вне него. Убрать старый CA из &lt;code&gt;TrustedUserCAKeys&lt;/code&gt; нужно на всех доверявших ему серверах; если он заодно прописан как &lt;code&gt;cert-authority&lt;/code&gt;, эту запись тоже надо учесть. Код проверяет запрет и для ключа подписи CA. Плановая ротация допускает время, когда сервер доверяет старому и новому CA; при компрометации это окно сохраняет опасное доверие. Нужен независимый канал обновления политики, который не требует получить сертификат у подозреваемого CA.&lt;sup id="fnref5:12"&gt;&lt;a href="#fn:12" class="footnote-ref" role="doc-noteref"&gt;12&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref12:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref4:13"&gt;&lt;a href="#fn:13" class="footnote-ref" role="doc-noteref"&gt;13&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref3:8"&gt;&lt;a href="#fn:8" class="footnote-ref" role="doc-noteref"&gt;8&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:18"&gt;&lt;a href="#fn:18" class="footnote-ref" role="doc-noteref"&gt;18&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="5-почему-закрытие-входа-не-завершает-работу"&gt;&lt;a href="#5-%d0%bf%d0%be%d1%87%d0%b5%d0%bc%d1%83-%d0%b7%d0%b0%d0%ba%d1%80%d1%8b%d1%82%d0%b8%d0%b5-%d0%b2%d1%85%d0%be%d0%b4%d0%b0-%d0%bd%d0%b5-%d0%b7%d0%b0%d0%b2%d0%b5%d1%80%d1%88%d0%b0%d0%b5%d1%82-%d1%80%d0%b0%d0%b1%d0%be%d1%82%d1%83" class="post_hash"&gt;5. Почему закрытие входа не завершает работу&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;SSH Connection Protocol работает поверх уже выполненной аутентификации и мультиплексирует каналы. В OpenSSH обработка открытия нового канала идёт в серверном цикле после входа, отдельно от проверки сертификата. Клиентский &lt;code&gt;ControlMaster&lt;/code&gt; позволяет открывать несколько сессий по одному сетевому соединению, а &lt;code&gt;ControlPersist&lt;/code&gt; — сохранять master после выхода из первой. Отсюда следствие: «запустил новый &lt;code&gt;ssh&lt;/code&gt;» не обязательно означает «сервер заново проверил сертификат». При приёмке отрицательный тест надо выполнять на новом транспортном соединении, а судьбу старого транспорта проверять отдельно.&lt;sup id="fnref1:11"&gt;&lt;a href="#fn:11" class="footnote-ref" role="doc-noteref"&gt;11&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref5:13"&gt;&lt;a href="#fn:13" class="footnote-ref" role="doc-noteref"&gt;13&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;&lt;code&gt;ChannelTimeout&lt;/code&gt; не превращает TTL в максимальную длительность работы: он закрывает неактивные каналы, и закрытие канала само по себе не гарантирует остановки всех связанных процессов или закрытия соединения. Если требуется прекратить и уже идущую работу, это действие над активными соединениями и при необходимости над запущенными процессами. На практике стоит заранее выбрать, кто выполняет это действие и откуда берёт соответствие между выдачей, входом и соединением.&lt;sup id="fnref3:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref13:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Показательно, что Cloudflare для своего продукта отдельно оговаривает: три минуты относятся к окну аутентификации, не к длительности SSH-сессии. Teleport документирует дополнительный механизм Session and Identity Locking, который завершает активные подключения, соответствующие lock. За такую возможность приходится отвечать ещё на один вопрос: что делать при устаревшем состоянии блокировок? Teleport описывает &lt;code&gt;best_effort&lt;/code&gt;, который полагается на последнее известное состояние, и &lt;code&gt;strict&lt;/code&gt;, который прерывает взаимодействия, когда актуальность не гарантирована. Это свойства конкретных решений, а не автоматическое свойство формата сертификата.&lt;sup id="fnref:20"&gt;&lt;a href="#fn:20" class="footnote-ref" role="doc-noteref"&gt;20&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:21"&gt;&lt;a href="#fn:21" class="footnote-ref" role="doc-noteref"&gt;21&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="6-что-проверить-при-переходе"&gt;&lt;a href="#6-%d1%87%d1%82%d0%be-%d0%bf%d1%80%d0%be%d0%b2%d0%b5%d1%80%d0%b8%d1%82%d1%8c-%d0%bf%d1%80%d0%b8-%d0%bf%d0%b5%d1%80%d0%b5%d1%85%d0%be%d0%b4%d0%b5" class="post_hash"&gt;6. Что проверить при переходе&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;&lt;strong&gt;Сначала составить карту входов.&lt;/strong&gt; Для каждого класса хостов выписать целевые учётные записи, допустимые principals, источники доверенных ключей и аварийный путь. Начать с одного сервера и одной именной роли. Сверить итоговые настройки с учётом &lt;code&gt;Match&lt;/code&gt; (&lt;code&gt;sshd -T&lt;/code&gt; с параметрами соединения через &lt;code&gt;-C&lt;/code&gt;), затем провести положительный тест и отдельные отрицательные: не тот principal, истёкший сертификат, старый обычный ключ. Во время перехода сохранять проверенный аварийный доступ отдельно от обычной выдачи; временный fallback для всех пользователей не считать аварийным доступом.&lt;sup id="fnref4:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref14:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref6:13"&gt;&lt;a href="#fn:13" class="footnote-ref" role="doc-noteref"&gt;13&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref6:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref4:8"&gt;&lt;a href="#fn:8" class="footnote-ref" role="doc-noteref"&gt;8&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;Отдельно принять отказ выдачи.&lt;/strong&gt; Заранее проверить, что при недоступной CA происходит с уже выданным сертификатом, с попыткой получить новый и с автоматической задачей после истечения. &lt;code&gt;sshd&lt;/code&gt; с локальным CA-файлом и локальным списком principals не обращается к сервису подписи на этом пути. Если же авторизация зависит от &lt;code&gt;AuthorizedPrincipalsCommand&lt;/code&gt;, доступность её источника данных — отдельное условие; успешный выпуск сертификата не доказывает, что команда даст нужный principal.&lt;sup id="fnref15:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref7:13"&gt;&lt;a href="#fn:13" class="footnote-ref" role="doc-noteref"&gt;13&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref3:14"&gt;&lt;a href="#fn:14" class="footnote-ref" role="doc-noteref"&gt;14&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;Репетировать три запрета, а не один.&lt;/strong&gt; После отключения выпуска проверить, что новый сертификат не выдаётся; после обновления KRL — что свежий транспорт с отозванным сертификатом не проходит, а контрольный проходит; после завершения старого транспорта — что контрольная уже начатая работа остановлена на нужном уровне. Записать три отметки времени. Если хост выпал из управления, не считать его защищённым только потому, что центральная операция закончилась. Для него исход определяется последней доставленной политикой, временем и тем, какие соединения успели установиться.&lt;sup id="fnref5:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref16:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref8:13"&gt;&lt;a href="#fn:13" class="footnote-ref" role="doc-noteref"&gt;13&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref7:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref3:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref3:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="дискуссионные-вопросы-и-противоречия"&gt;&lt;a href="#%d0%b4%d0%b8%d1%81%d0%ba%d1%83%d1%81%d1%81%d0%b8%d0%be%d0%bd%d0%bd%d1%8b%d0%b5-%d0%b2%d0%be%d0%bf%d1%80%d0%be%d1%81%d1%8b-%d0%b8-%d0%bf%d1%80%d0%be%d1%82%d0%b8%d0%b2%d0%be%d1%80%d0%b5%d1%87%d0%b8%d1%8f" class="post_hash"&gt;Дискуссионные вопросы и противоречия&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;&lt;strong&gt;«Хостам достаточно доверять CA» — только как описание распространения ключей.&lt;/strong&gt; В архивном BLESS так объясняли преимущество над массовой раскладкой &lt;code&gt;authorized_keys&lt;/code&gt;. Man page OpenSSH показывает вторую половину: подпись CA открывает путь к проверке principals и локальной политики, а не заменяет её. Смещение ответственности особенно заметно при повторном использовании CA: разные группы хостов нужны не только в интерфейсе выдачи, но и при назначении доверия и principals на серверах.&lt;sup id="fnref17:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref9:13"&gt;&lt;a href="#fn:13" class="footnote-ref" role="doc-noteref"&gt;13&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:22"&gt;&lt;a href="#fn:22" class="footnote-ref" role="doc-noteref"&gt;22&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;«TTL вместо KRL» — допустимый срок реакции, а не тождество механизмов.&lt;/strong&gt; Локальная проверка времени не зависит от канала доставки запрета, но не ускоряется в момент инцидента. KRL может закрыть окно раньше, если успевает дойти до сервера до истечения сертификата, и только для новой аутентификации. Если нужно ограничить длительность уже открытого доступа, сравнивать надо механизмы управления сессиями, а не число минут в сертификате.&lt;sup id="fnref18:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref8:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:17"&gt;&lt;a href="#fn:17" class="footnote-ref" role="doc-noteref"&gt;17&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref4:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:20"&gt;&lt;a href="#fn:20" class="footnote-ref" role="doc-noteref"&gt;20&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:21"&gt;&lt;a href="#fn:21" class="footnote-ref" role="doc-noteref"&gt;21&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="недостаточность-данных"&gt;&lt;a href="#%d0%bd%d0%b5%d0%b4%d0%be%d1%81%d1%82%d0%b0%d1%82%d0%be%d1%87%d0%bd%d0%be%d1%81%d1%82%d1%8c-%d0%b4%d0%b0%d0%bd%d0%bd%d1%8b%d1%85" class="post_hash"&gt;Недостаточность данных&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;В изученных источниках нет независимой оценки, какой TTL даёт приемлемый баланс риска и доступности для небольшого self-hosted парка, и нет сопоставимых измерений задержки доставки KRL в таком парке. Пример Cloudflare — выбор конкретного продукта, не измерение домашней инфраструктуры. Для выбора своего лимита нужны собственные данные о доступности сервиса выдачи, рассинхронизации часов и времени доставки запрета до последнего управляемого хоста.&lt;sup id="fnref6:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref19:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:20"&gt;&lt;a href="#fn:20" class="footnote-ref" role="doc-noteref"&gt;20&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref4:14"&gt;&lt;a href="#fn:14" class="footnote-ref" role="doc-noteref"&gt;14&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="заключение"&gt;&lt;a href="#%d0%b7%d0%b0%d0%ba%d0%bb%d1%8e%d1%87%d0%b5%d0%bd%d0%b8%d0%b5" class="post_hash"&gt;Заключение&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Короткий сертификат удобен там, где выдача действительно прекращается по сигналу об отключении доступа, время серверов контролируется, а остаток срока укладывается в допустимую задержку. Для срочного запрета новых входов нужен проверяемый путь доставки KRL или изменения доверия к CA. Для уже открытых соединений нужен отдельный способ их завершить. Если небольшой парк устроен так, что удалить ключ со всех хостов проще и надёжнее, чем поддерживать эти три контура, &lt;code&gt;authorized_keys&lt;/code&gt; остаётся разумным выбором. Решает не число серверов само по себе, а проверяемое время от решения «закрыть доступ» до результата на каждом из них.&lt;sup id="fnref7:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref20:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref10:13"&gt;&lt;a href="#fn:13" class="footnote-ref" role="doc-noteref"&gt;13&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref9:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref5:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref4:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="quality-metrics"&gt;&lt;a href="#quality-metrics" class="post_hash"&gt;Quality Metrics&lt;/a&gt;&lt;/h2&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Metric&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Value&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Sources found&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;40&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Sources read&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;27&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Sources cited&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;22&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Academic sources&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;0&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Official/documentation&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;21&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Industry reports&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;0&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;News/journalism&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;0&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Blog/forum&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;1&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Citation coverage&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;100% (30/30)&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Counter-arguments searched&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Yes&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Research rounds&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;3&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Questions emerged&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;6&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Questions resolved&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;5&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Questions insufficient data&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;1&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Scope&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Found: shortlisted URLs including alternate representations; read/cited: distinct documents, registry records or tagged files; NISTIR 7966: abstract only&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;div class="footnotes" role="doc-endnotes"&gt;&#10;&lt;hr&gt;&#10;&lt;ol&gt;&#10;&lt;li id="fn:1"&gt;&#10;&lt;p&gt;OpenSSH. &lt;code&gt;ssh-keygen(1)&lt;/code&gt;, &lt;code&gt;CERTIFICATES&lt;/code&gt;, &lt;code&gt;KEY REVOCATION LISTS&lt;/code&gt;, Portable &lt;code&gt;V_10_6_P2&lt;/code&gt;. &lt;a href="https://raw.githubusercontent.com/openssh/openssh-portable/V_10_6_P2/ssh-keygen.1"&gt;https://raw.githubusercontent.com/openssh/openssh-portable/V_10_6_P2/ssh-keygen.1&lt;/a&gt;&amp;#160;&lt;a href="#fnref:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref7:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref8:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:2"&gt;&#10;&lt;p&gt;OpenSSH. &lt;code&gt;sshd_config(5)&lt;/code&gt;, Portable &lt;code&gt;V_10_6_P2&lt;/code&gt;. &lt;a href="https://raw.githubusercontent.com/openssh/openssh-portable/V_10_6_P2/sshd_config.5"&gt;https://raw.githubusercontent.com/openssh/openssh-portable/V_10_6_P2/sshd_config.5&lt;/a&gt;&amp;#160;&lt;a href="#fnref:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref7:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref8:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref9:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref10:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref11:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref12:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref13:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref14:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref15:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref16:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref17:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref18:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref19:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref20:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:3"&gt;&#10;&lt;p&gt;OpenSSH. &lt;code&gt;sshkey.c&lt;/code&gt;, &lt;code&gt;sshkey_cert_check_authority&lt;/code&gt; и &lt;code&gt;sshkey_cert_check_authority_now&lt;/code&gt;, Portable &lt;code&gt;V_10_6_P2&lt;/code&gt;. &lt;a href="https://raw.githubusercontent.com/openssh/openssh-portable/V_10_6_P2/sshkey.c"&gt;https://raw.githubusercontent.com/openssh/openssh-portable/V_10_6_P2/sshkey.c&lt;/a&gt;&amp;#160;&lt;a href="#fnref:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref7:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref8:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref9:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:4"&gt;&#10;&lt;p&gt;T. Ylonen, C. Lonvick (ed.). «The Secure Shell (SSH) Connection Protocol», RFC 4254, январь 2006, §§1, 5–6. &lt;a href="https://www.rfc-editor.org/rfc/rfc4254.txt"&gt;https://www.rfc-editor.org/rfc/rfc4254.txt&lt;/a&gt;&amp;#160;&lt;a href="#fnref:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:5"&gt;&#10;&lt;p&gt;OpenSSH. &lt;code&gt;serverloop.c&lt;/code&gt;, &lt;code&gt;server_input_channel_open&lt;/code&gt; и &lt;code&gt;server_init_dispatch&lt;/code&gt;, Portable &lt;code&gt;V_10_6_P2&lt;/code&gt;. &lt;a href="https://raw.githubusercontent.com/openssh/openssh-portable/V_10_6_P2/serverloop.c"&gt;https://raw.githubusercontent.com/openssh/openssh-portable/V_10_6_P2/serverloop.c&lt;/a&gt;&amp;#160;&lt;a href="#fnref:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:6"&gt;&#10;&lt;p&gt;OpenSSH. «Portable OpenSSH 10.6p2», release notes, 2026-11-05. &lt;a href="https://www.openssh.org/txt/release-10.6p2"&gt;https://www.openssh.org/txt/release-10.6p2&lt;/a&gt;&amp;#160;&lt;a href="#fnref:6" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:6" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:7"&gt;&#10;&lt;p&gt;NIST. «Security of Interactive and Automated Access Management Using Secure Shell (SSH)», NISTIR 7966, 2015, abstract. &lt;a href="https://csrc.nist.gov/pubs/ir/7966/final"&gt;https://csrc.nist.gov/pubs/ir/7966/final&lt;/a&gt;&amp;#160;&lt;a href="#fnref:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref7:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:8"&gt;&#10;&lt;p&gt;OpenSSH. &lt;code&gt;sshd(8)&lt;/code&gt;, опции запуска и &lt;code&gt;AUTHORIZED_KEYS FILE FORMAT&lt;/code&gt;, Portable &lt;code&gt;V_10_6_P2&lt;/code&gt;. &lt;a href="https://raw.githubusercontent.com/openssh/openssh-portable/V_10_6_P2/sshd.8"&gt;https://raw.githubusercontent.com/openssh/openssh-portable/V_10_6_P2/sshd.8&lt;/a&gt;&amp;#160;&lt;a href="#fnref:8" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:8" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:8" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:8" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:8" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:9"&gt;&#10;&lt;p&gt;OpenSSH. «OpenSSH 5.4», release notes, 2010-03-08. &lt;a href="https://www.openssh.org/txt/release-5.4"&gt;https://www.openssh.org/txt/release-5.4&lt;/a&gt;&amp;#160;&lt;a href="#fnref:9" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:9" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:10"&gt;&#10;&lt;p&gt;T. Ylonen, C. Lonvick (ed.). «The Secure Shell (SSH) Authentication Protocol», RFC 4252, январь 2006, §7. &lt;a href="https://www.rfc-editor.org/rfc/rfc4252.txt"&gt;https://www.rfc-editor.org/rfc/rfc4252.txt&lt;/a&gt;&amp;#160;&lt;a href="#fnref:10" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:10" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:10" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:11"&gt;&#10;&lt;p&gt;OpenSSH. &lt;code&gt;ssh_config(5)&lt;/code&gt;, &lt;code&gt;CertificateFile&lt;/code&gt;, &lt;code&gt;ControlMaster&lt;/code&gt;, &lt;code&gt;ControlPersist&lt;/code&gt;, Portable &lt;code&gt;V_10_6_P2&lt;/code&gt;. &lt;a href="https://raw.githubusercontent.com/openssh/openssh-portable/V_10_6_P2/ssh_config.5"&gt;https://raw.githubusercontent.com/openssh/openssh-portable/V_10_6_P2/ssh_config.5&lt;/a&gt;&amp;#160;&lt;a href="#fnref:11" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:11" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:12"&gt;&#10;&lt;p&gt;Damien Miller. «SSH Certificate Format», &lt;code&gt;draft-ietf-sshm-cert-01&lt;/code&gt;, work in progress, 2026-06-14, §§2–3. &lt;a href="https://www.ietf.org/archive/id/draft-ietf-sshm-cert-01.txt"&gt;https://www.ietf.org/archive/id/draft-ietf-sshm-cert-01.txt&lt;/a&gt;&amp;#160;&lt;a href="#fnref:12" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:12" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:12" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:12" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:12" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:12" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:13"&gt;&#10;&lt;p&gt;OpenSSH. &lt;code&gt;auth2-pubkey.c&lt;/code&gt;, &lt;code&gt;user_cert_trusted_ca&lt;/code&gt; и &lt;code&gt;user_key_allowed&lt;/code&gt;, Portable &lt;code&gt;V_10_6_P2&lt;/code&gt;. &lt;a href="https://raw.githubusercontent.com/openssh/openssh-portable/V_10_6_P2/auth2-pubkey.c"&gt;https://raw.githubusercontent.com/openssh/openssh-portable/V_10_6_P2/auth2-pubkey.c&lt;/a&gt;&amp;#160;&lt;a href="#fnref:13" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:13" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:13" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:13" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:13" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:13" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:13" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref7:13" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref8:13" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref9:13" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref10:13" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:14"&gt;&#10;&lt;p&gt;HashiCorp. «SSH secrets engine (API)», Vault, параметры роли и подписи сертификатов, срез 2026-11-21. &lt;a href="https://developer.hashicorp.com/vault/api-docs/secret/ssh"&gt;https://developer.hashicorp.com/vault/api-docs/secret/ssh&lt;/a&gt;&amp;#160;&lt;a href="#fnref:14" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:14" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:14" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:14" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:14" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:15"&gt;&#10;&lt;p&gt;IETF Datatracker. «SSH Certificate Format», статус &lt;code&gt;draft-ietf-sshm-cert-01&lt;/code&gt; на 2026-11-21. &lt;a href="https://datatracker.ietf.org/doc/draft-ietf-sshm-cert/"&gt;https://datatracker.ietf.org/doc/draft-ietf-sshm-cert/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:15" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:16"&gt;&#10;&lt;p&gt;OpenSSH. &lt;code&gt;auth2-pubkeyfile.c&lt;/code&gt;, &lt;code&gt;match_principals_option&lt;/code&gt; и проверка &lt;code&gt;cert-authority&lt;/code&gt;, Portable &lt;code&gt;V_10_6_P2&lt;/code&gt;. &lt;a href="https://raw.githubusercontent.com/openssh/openssh-portable/V_10_6_P2/auth2-pubkeyfile.c"&gt;https://raw.githubusercontent.com/openssh/openssh-portable/V_10_6_P2/auth2-pubkeyfile.c&lt;/a&gt;&amp;#160;&lt;a href="#fnref:16" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:17"&gt;&#10;&lt;p&gt;OpenSSH. &lt;code&gt;PROTOCOL.krl&lt;/code&gt;, Portable &lt;code&gt;V_10_6_P2&lt;/code&gt;. &lt;a href="https://raw.githubusercontent.com/openssh/openssh-portable/V_10_6_P2/PROTOCOL.krl"&gt;https://raw.githubusercontent.com/openssh/openssh-portable/V_10_6_P2/PROTOCOL.krl&lt;/a&gt;&amp;#160;&lt;a href="#fnref:17" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:17" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:18"&gt;&#10;&lt;p&gt;OpenSSH. &lt;code&gt;krl.c&lt;/code&gt;, &lt;code&gt;is_key_revoked&lt;/code&gt; и &lt;code&gt;ssh_krl_check_key&lt;/code&gt;, Portable &lt;code&gt;V_10_6_P2&lt;/code&gt;. &lt;a href="https://raw.githubusercontent.com/openssh/openssh-portable/V_10_6_P2/krl.c"&gt;https://raw.githubusercontent.com/openssh/openssh-portable/V_10_6_P2/krl.c&lt;/a&gt;&amp;#160;&lt;a href="#fnref:18" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:18" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:19"&gt;&#10;&lt;p&gt;OpenSSH. &lt;code&gt;auth.c&lt;/code&gt;, &lt;code&gt;auth_key_is_revoked&lt;/code&gt;, Portable &lt;code&gt;V_10_6_P2&lt;/code&gt;. &lt;a href="https://raw.githubusercontent.com/openssh/openssh-portable/V_10_6_P2/auth.c"&gt;https://raw.githubusercontent.com/openssh/openssh-portable/V_10_6_P2/auth.c&lt;/a&gt;&amp;#160;&lt;a href="#fnref:19" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:20"&gt;&#10;&lt;p&gt;Cloudflare. «Fearless SSH: short-lived certificates bring Zero Trust to infrastructure», описание Access for Infrastructure. &lt;a href="https://blog.cloudflare.com/intro-access-for-infrastructure-ssh/"&gt;https://blog.cloudflare.com/intro-access-for-infrastructure-ssh/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:20" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:20" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:20" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:21"&gt;&#10;&lt;p&gt;Teleport. «Session and Identity Locking», срез 2026-11-21. &lt;a href="https://goteleport.com/docs/identity-governance/locking/"&gt;https://goteleport.com/docs/identity-governance/locking/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:21" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:21" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:22"&gt;&#10;&lt;p&gt;Netflix. «BLESS - Bastion&amp;rsquo;s Lambda Ephemeral SSH Service», README архивного проекта. &lt;a href="https://github.com/Netflix/bless"&gt;https://github.com/Netflix/bless&lt;/a&gt;&amp;#160;&lt;a href="#fnref:22" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;/ol&gt;&#10;&lt;/div&gt;&#10;</content></entry><entry><title>Quadlet вместо Compose: что systemd даёт контейнерам и чего не даёт</title><id>https://research.evsyukov.org/articles/podman-quadlet-vs-compose/</id><link href="https://research.evsyukov.org/articles/podman-quadlet-vs-compose/" rel="alternate" type="text/html"/><published>2026-11-20T09:37:00+03:00</published><updated>2026-11-20T09:38:50+03:00</updated><author><name>Denis Evsyukov</name></author><summary type="html">Когда перенос с Docker Compose на Podman Quadlet упрощает запуск и восстановление на одном Linux-хосте, а когда лишь усложняет описание стека.</summary><content type="html">&lt;h2 id="аннотация"&gt;&lt;a href="#%d0%b0%d0%bd%d0%bd%d0%be%d1%82%d0%b0%d1%86%d0%b8%d1%8f" class="post_hash"&gt;Аннотация&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Quadlet хорош там, где контейнер должен вести себя как обычная служба Linux: стартовать при загрузке, ждать нужный mount и восстанавливаться по правилам systemd. Но &lt;code&gt;active&lt;/code&gt; ещё не означает, что приложение отвечает, а откат образа не возвращает схему базы. Docker Compose проще, когда единица работы — весь проект: его нужно поднять, проверить и убрать одной командой, не раскладывая конфигурацию по юнитам хоста.&lt;sup id="fnref:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Данные на &lt;strong&gt;2026-11-20&lt;/strong&gt;. Допущение: один Linux-хост с cgroup v2, постоянно работающие API и база данных, периодическое задание. Срез: &lt;strong&gt;Podman 6.2.0&lt;/strong&gt;, &lt;strong&gt;systemd 262.2&lt;/strong&gt; и &lt;strong&gt;Docker Compose 5.8.0&lt;/strong&gt; с Docker Engine. Здесь сравниваются документированное поведение и код этих версий, а не быстродействие. Контейнеры не запускались; готовность и восстановление предложено проверить на отдельной машине перед переносом.&lt;sup id="fnref:6"&gt;&lt;a href="#fn:6" class="footnote-ref" role="doc-noteref"&gt;6&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:8"&gt;&lt;a href="#fn:8" class="footnote-ref" role="doc-noteref"&gt;8&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="введение"&gt;&lt;a href="#%d0%b2%d0%b2%d0%b5%d0%b4%d0%b5%d0%bd%d0%b8%d0%b5" class="post_hash"&gt;Введение&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;В &lt;a href="/articles/nixos-ansible-compose/"&gt;сравнении NixOS, Ansible и Compose&lt;/a&gt; речь шла об уровнях конфигурации и отката. В &lt;a href="/articles/homelab-cgroup-memory-pressure-budgets/"&gt;обзоре cgroup v2&lt;/a&gt; — о том, кто расходует ресурсы хоста и что происходит при их исчерпании. Здесь вопрос другой: &lt;strong&gt;что изменится после переноса, если база запустится медленно, приложение зависнет, а следующая версия образа не заработает?&lt;/strong&gt; Чтобы ответить, надо отдельно проследить, кто поднимает контейнер, кто объявляет его готовым и кто принимает решение о повторном запуске.&lt;sup id="fnref2:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:9"&gt;&lt;a href="#fn:9" class="footnote-ref" role="doc-noteref"&gt;9&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:10"&gt;&lt;a href="#fn:10" class="footnote-ref" role="doc-noteref"&gt;10&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Ветка Podman 6.1 началась не осенью: релиз 6.1.0 вышел 12 августа. Для этого обзора важнее ноябрьский Podman 6.2.0: в нём появился &lt;code&gt;SetMountsDependency=&lt;/code&gt; и исправлен сбой на стыке &lt;code&gt;Notify=healthy&lt;/code&gt; и таймаута запуска. Compose 5.8.0, в свою очередь, добавил задания по расписанию, хотя для них требуется поддержка со стороны Engine. Сравнивать нынешние инструменты по старому признаку «в Compose нет планировщика» уже нельзя.&lt;sup id="fnref:11"&gt;&lt;a href="#fn:11" class="footnote-ref" role="doc-noteref"&gt;11&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:6"&gt;&lt;a href="#fn:6" class="footnote-ref" role="doc-noteref"&gt;6&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="что-именно-становится-юнитом"&gt;&lt;a href="#%d1%87%d1%82%d0%be-%d0%b8%d0%bc%d0%b5%d0%bd%d0%bd%d0%be-%d1%81%d1%82%d0%b0%d0%bd%d0%be%d0%b2%d0%b8%d1%82%d1%81%d1%8f-%d1%8e%d0%bd%d0%b8%d1%82%d0%be%d0%bc" class="post_hash"&gt;Что именно становится юнитом&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Quadlet — генератор, а не постоянно работающий диспетчер поверх systemd. При загрузке менеджера и при &lt;code&gt;daemon-reload&lt;/code&gt; он читает файлы вроде &lt;code&gt;api.container&lt;/code&gt;, &lt;code&gt;app.network&lt;/code&gt; и &lt;code&gt;db-data.volume&lt;/code&gt; и создаёт соответствующие &lt;code&gt;.service&lt;/code&gt;. Параметры &lt;code&gt;[Container]&lt;/code&gt; превращаются в аргументы Podman, а обычные настройки &lt;code&gt;[Unit]&lt;/code&gt; и &lt;code&gt;[Service]&lt;/code&gt; остаются частью контракта systemd. В коде генератора видно, что для контейнера это не только команда &lt;code&gt;podman run&lt;/code&gt;: предусмотрен и cleanup через &lt;code&gt;ExecStopPost=&lt;/code&gt;, в том числе на случай гибели conmon. Редактировать надо входной Quadlet, не полученный &lt;code&gt;.service&lt;/code&gt;.&lt;sup id="fnref3:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:12"&gt;&lt;a href="#fn:12" class="footnote-ref" role="doc-noteref"&gt;12&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:13"&gt;&lt;a href="#fn:13" class="footnote-ref" role="doc-noteref"&gt;13&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Сгенерированный сервис не включается на автозапуск обычным &lt;code&gt;systemctl enable&lt;/code&gt;: генератор сам применяет поддерживаемые ключи секции &lt;code&gt;[Install]&lt;/code&gt;. Например, &lt;code&gt;WantedBy=default.target&lt;/code&gt; в rootless Quadlet привязывает его к пользовательскому target. Если после &lt;code&gt;daemon-reload&lt;/code&gt; нужного сервиса нет, начинать стоит с &lt;code&gt;podman-system-generator --user --dryrun&lt;/code&gt;: ошибка может означать, что файл найден, но установленный генератор не понимает новый ключ. И наоборот, появление новой версии &lt;code&gt;.service&lt;/code&gt; после &lt;code&gt;daemon-reload&lt;/code&gt; не подтверждает, что работающий контейнер уже пересоздан: перечитать описание и запустить сервис — разные действия.&lt;sup id="fnref4:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:12"&gt;&lt;a href="#fn:12" class="footnote-ref" role="doc-noteref"&gt;12&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;В Compose исходная единица — проект. Сервисы, сети и тома описываются в одной модели; &lt;code&gt;docker compose up&lt;/code&gt; применяет её и при изменении образа или конфигурации пересоздаёт затронутые контейнеры, сохраняя смонтированные тома. У detached-запуска другой контракт: CLI заканчивает работу, контейнеры остаются под Docker Engine. &lt;code&gt;podman compose&lt;/code&gt; тоже не является Quadlet: это обёртка над внешним Compose provider, которому передаются параметры и доступ к сокету Podman. Если задача в замене runtime без переписывания стека, совместимость этого пути стоит проверять отдельно, на выбранном provider.&lt;sup id="fnref1:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:14"&gt;&lt;a href="#fn:14" class="footnote-ref" role="doc-noteref"&gt;14&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;В исследовании Eng, Hindle и Stroulia разобраны 527 Compose-подобных файлов из 218 GitHub-проектов; в выборке встречались &lt;code&gt;extends&lt;/code&gt;, override-файлы и генерация YAML. Это наблюдение за конфигурациями отобранных проектов, а не замер надёжности и не сравнение с Quadlet. Но оно объясняет, почему миграция сложнее замены синтаксиса: если upstream поставляет один проект с несколькими режимами, местные юниты становятся ещё одним описанием, которое нужно обновлять вместе с upstream.&lt;sup id="fnref:15"&gt;&lt;a href="#fn:15" class="footnote-ref" role="doc-noteref"&gt;15&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="сначала-порядок-потом-готовность"&gt;&lt;a href="#%d1%81%d0%bd%d0%b0%d1%87%d0%b0%d0%bb%d0%b0-%d0%bf%d0%be%d1%80%d1%8f%d0%b4%d0%be%d0%ba-%d0%bf%d0%be%d1%82%d0%be%d0%bc-%d0%b3%d0%be%d1%82%d0%be%d0%b2%d0%bd%d0%be%d1%81%d1%82%d1%8c" class="post_hash"&gt;Сначала порядок, потом готовность&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;В systemd &lt;code&gt;After=&lt;/code&gt; отвечает за порядок, но не добавляет другую службу в запуск; &lt;code&gt;Wants=&lt;/code&gt; или &lt;code&gt;Requires=&lt;/code&gt; втягивает её в транзакцию, но само по себе не задаёт порядок. Авторы справочника называют эти зависимости «independent of and orthogonal to the requirement dependencies». Если для API задать &lt;code&gt;Requires=db.container&lt;/code&gt; и &lt;code&gt;After=db.container&lt;/code&gt;, Quadlet переведёт ссылку на сгенерированный сервис и запуск API будет ждать окончания запуска базы. Неудачный старт базы заблокирует такой старт API. &lt;strong&gt;Что считать окончанием запуска&lt;/strong&gt;, решает уже тип сервиса и его сигнал готовности.&lt;sup id="fnref5:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:16"&gt;&lt;a href="#fn:16" class="footnote-ref" role="doc-noteref"&gt;16&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Для &lt;code&gt;.container&lt;/code&gt; Quadlet 6.2.0 по умолчанию генерирует &lt;code&gt;Type=notify&lt;/code&gt;, но &lt;code&gt;Notify=&lt;/code&gt; в Quadlet по умолчанию равно &lt;code&gt;false&lt;/code&gt;. В этой комбинации используется &lt;code&gt;--sdnotify=conmon&lt;/code&gt;: готовность для systemd означает, что контейнер запущен. &lt;code&gt;Notify=true&lt;/code&gt; оставляет уведомление приложению, которое должно отправить &lt;code&gt;READY=1&lt;/code&gt;; если оно не умеет этого делать, такое переключение само по себе ничего не исправляет. &lt;code&gt;Notify=healthy&lt;/code&gt; использует встроенный или заданный Podman healthcheck и посылает уведомление после перехода в healthy. Старту API полезен только тест, который проверяет действительно нужную ему операцию базы, а не просто наличие процесса.&lt;sup id="fnref6:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref3:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:17"&gt;&lt;a href="#fn:17" class="footnote-ref" role="doc-noteref"&gt;17&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:13"&gt;&lt;a href="#fn:13" class="footnote-ref" role="doc-noteref"&gt;13&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;У Compose аналогичная граница выражена прямо в проекте: обычный &lt;code&gt;depends_on&lt;/code&gt; задаёт порядок старта, а условие &lt;code&gt;service_healthy&lt;/code&gt; ждёт healthcheck зависимости. Есть и &lt;code&gt;service_completed_successfully&lt;/code&gt; для зависимости с конечным результатом, например одноразовой подготовки схемы. Это условия выполнения команды, а не обещание заново применять граф при каждом изменении здоровья. &lt;code&gt;docker compose up -d --wait&lt;/code&gt; полезен для приёмки выкладки: с healthcheck команда ждёт healthy, а там, где проверки нет, «running» может быть достаточным. Не стоит считать нулевой exit code доказательством успешного запроса к API.&lt;sup id="fnref1:9"&gt;&lt;a href="#fn:9" class="footnote-ref" role="doc-noteref"&gt;9&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:18"&gt;&lt;a href="#fn:18" class="footnote-ref" role="doc-noteref"&gt;18&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:19"&gt;&lt;a href="#fn:19" class="footnote-ref" role="doc-noteref"&gt;19&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Важно согласовать дедлайны. На старте Quadlet может ещё тянуть образ, а база — восстанавливаться до первой успешной проверки. &lt;code&gt;TimeoutStartSec=&lt;/code&gt; сервиса должен учитывать оба этапа, если они входят в её запуск. Для &lt;code&gt;Type=oneshot&lt;/code&gt; таймаут запуска по умолчанию, напротив, отключён. В трекере Podman описан случай на 5.6.2, когда &lt;code&gt;HealthStartPeriod&lt;/code&gt; был длиннее &lt;code&gt;TimeoutStartSec&lt;/code&gt;, а systemd убивал ещё запускающийся контейнер; в 6.2.0 есть конкретный фикс по этому issue. Из него не следует, что можно назначить любой дедлайн и считать readiness проверенной.&lt;sup id="fnref7:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref4:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:20"&gt;&lt;a href="#fn:20" class="footnote-ref" role="doc-noteref"&gt;20&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:6"&gt;&lt;a href="#fn:6" class="footnote-ref" role="doc-noteref"&gt;6&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="кто-поднимает-сервис-после-сбоя"&gt;&lt;a href="#%d0%ba%d1%82%d0%be-%d0%bf%d0%be%d0%b4%d0%bd%d0%b8%d0%bc%d0%b0%d0%b5%d1%82-%d1%81%d0%b5%d1%80%d0%b2%d0%b8%d1%81-%d0%bf%d0%be%d1%81%d0%bb%d0%b5-%d1%81%d0%b1%d0%be%d1%8f" class="post_hash"&gt;Кто поднимает сервис после сбоя&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;&lt;code&gt;Notify=healthy&lt;/code&gt; отвечает только за старт. Позднее Podman может пометить контейнер unhealthy, но действие &lt;code&gt;HealthOnFailure&lt;/code&gt; по умолчанию — &lt;code&gt;none&lt;/code&gt;. Если приложение не завершится само, у systemd не обязательно появится причина перезапустить юнит. Схема с &lt;code&gt;HealthOnFailure=kill&lt;/code&gt; даёт systemd событие, на которое может отреагировать &lt;code&gt;Restart=&lt;/code&gt;. Для управляемого systemd контейнера документация Podman рекомендует использовать именно &lt;code&gt;[Service] Restart=&lt;/code&gt;, а не параллельный &lt;code&gt;podman run --restart&lt;/code&gt;. Повторные старты ограничиваются &lt;code&gt;StartLimitIntervalSec=&lt;/code&gt; и &lt;code&gt;StartLimitBurst=&lt;/code&gt;; выставляя их, администратор задаёт предел попыток в выбранном временном окне, прежде чем потребуется вмешательство.&lt;sup id="fnref8:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:21"&gt;&lt;a href="#fn:21" class="footnote-ref" role="doc-noteref"&gt;21&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:22"&gt;&lt;a href="#fn:22" class="footnote-ref" role="doc-noteref"&gt;22&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:16"&gt;&lt;a href="#fn:16" class="footnote-ref" role="doc-noteref"&gt;16&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref5:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;В Compose важно не перепутать два &lt;code&gt;restart&lt;/code&gt;. Ключ &lt;code&gt;restart:&lt;/code&gt; самого сервиса задаёт политику контейнера в Engine. &lt;code&gt;restart: true&lt;/code&gt; &lt;strong&gt;внутри&lt;/strong&gt; &lt;code&gt;depends_on&lt;/code&gt; распространяет явную операцию Compose, например &lt;code&gt;docker compose restart db&lt;/code&gt;, на зависимый сервис. В документации есть точное ограничение: «excludes automated restart by the container runtime». В исходниках Compose 5.8.0 команда &lt;code&gt;restart&lt;/code&gt; выбирает рёбра с этим флагом из проектного графа; их наличие не превращает Engine в контроллер всего приложения. Если база сама перезапустилась после падения, API по-прежнему должен уметь переподключиться либо обнаружить, что не может обслуживать запросы.&lt;sup id="fnref1:10"&gt;&lt;a href="#fn:10" class="footnote-ref" role="doc-noteref"&gt;10&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:18"&gt;&lt;a href="#fn:18" class="footnote-ref" role="doc-noteref"&gt;18&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:23"&gt;&lt;a href="#fn:23" class="footnote-ref" role="doc-noteref"&gt;23&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;В systemd тоже не стоит связывать всё со всем. &lt;code&gt;PartOf=&lt;/code&gt; передаёт остановку и рестарт в одном направлении; оно не означает «запусти весь стек». &lt;code&gt;BindsTo=&lt;/code&gt; вместе с &lt;code&gt;After=&lt;/code&gt; привязывает активность одного юнита к другому гораздо жёстче, включая неожиданную деактивацию. Для API, умеющего переподключаться, это может превратить короткий сбой базы в ненужную остановку API. Пара &lt;code&gt;BindsTo=&lt;/code&gt; и &lt;code&gt;After=&lt;/code&gt; полезна, когда работа без зависимости недопустима, но всё равно работает со &lt;strong&gt;статусом юнита&lt;/strong&gt;, а не с результатом SQL-запроса. Сценарий «остановить при падении и запустить обратно после восстановления» следует проверять целиком, а не выводить из одного ребра.&lt;sup id="fnref9:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:16"&gt;&lt;a href="#fn:16" class="footnote-ref" role="doc-noteref"&gt;16&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref6:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="rootless-загрузка-хоста-и-расписание"&gt;&lt;a href="#rootless-%d0%b7%d0%b0%d0%b3%d1%80%d1%83%d0%b7%d0%ba%d0%b0-%d1%85%d0%be%d1%81%d1%82%d0%b0-%d0%b8-%d1%80%d0%b0%d1%81%d0%bf%d0%b8%d1%81%d0%b0%d0%bd%d0%b8%d0%b5" class="post_hash"&gt;Rootless, загрузка хоста и расписание&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Rootless Quadlet живёт в пользовательском systemd, а не в системном менеджере с добавленным &lt;code&gt;User=&lt;/code&gt;. Например, файлы можно положить в &lt;code&gt;~/.config/containers/systemd/&lt;/code&gt;. Для запуска до первого входа и работы после выхода нужен живой пользовательский менеджер: &lt;code&gt;loginctl enable-linger&lt;/code&gt; позволяет создать его при загрузке и сохранить после logout. Это отдельно от выбора &lt;code&gt;WantedBy=&lt;/code&gt;: linger поднимает менеджер, а &lt;code&gt;[Install]&lt;/code&gt; подключает конкретную службу. Проверка из уже открытой SSH-сессии не отвечает на вопрос, поднимется ли сервис без этой сессии.&lt;sup id="fnref10:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:24"&gt;&lt;a href="#fn:24" class="footnote-ref" role="doc-noteref"&gt;24&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Rootful Quadlet добавляет зависимость от &lt;code&gt;network-online.target&lt;/code&gt;; rootless использует &lt;code&gt;podman-user-wait-network-online.service&lt;/code&gt;. В поставляемом для 6.2.0 helper видно, что он ждёт &lt;code&gt;systemctl is-active network-online.target&lt;/code&gt;, а не делает DNS-запрос или pull. И сам target — одноразовый рубеж загрузки: после старта systemd «will not track the online state of the system anymore». Поэтому для хоста с нестабильным каналом полезно отдельно оценить, нужно ли тянуть образы во время загрузки и может ли сервис подняться с локальным образом. Отключение добавляемых Quadlet зависимостей через &lt;code&gt;[Quadlet] DefaultDependencies=false&lt;/code&gt; не создаёт новой проверки связи.&lt;sup id="fnref11:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:25"&gt;&lt;a href="#fn:25" class="footnote-ref" role="doc-noteref"&gt;25&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:26"&gt;&lt;a href="#fn:26" class="footnote-ref" role="doc-noteref"&gt;26&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;За локальные данные лучше отвечать явно. По ссылке на &lt;code&gt;db-data.volume&lt;/code&gt; Quadlet добавляет зависимость от юнита тома, но имя самого тома по умолчанию будет с префиксом &lt;code&gt;systemd-&lt;/code&gt;, если не задан &lt;code&gt;VolumeName=&lt;/code&gt;. В 6.2.0 &lt;code&gt;SetMountsDependency=&lt;/code&gt; позволяет выбрать &lt;code&gt;RequiresMountsFor=&lt;/code&gt;, &lt;code&gt;WantsMountsFor=&lt;/code&gt; или не добавлять зависимость для исходных путей mount. Это рычаг для внешнего диска или сетевого mount, а не подтверждение правильного содержимого каталога. До переключения стоит проверить, какой том фактически смонтирован, под каким UID он доступен и читается ли из него ожидаемая база.&lt;sup id="fnref12:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref3:16"&gt;&lt;a href="#fn:16" class="footnote-ref" role="doc-noteref"&gt;16&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref3:6"&gt;&lt;a href="#fn:6" class="footnote-ref" role="doc-noteref"&gt;6&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Для периодического экспорта Quadlet можно соединить задачу &lt;code&gt;Type=oneshot&lt;/code&gt; с &lt;code&gt;.timer&lt;/code&gt;; &lt;code&gt;Persistent=true&lt;/code&gt; у календарного таймера нужен, если следует наверстать пропущенное срабатывание после простоя. Не надо оставлять периодическую задачу в &lt;code&gt;active&lt;/code&gt; через &lt;code&gt;RemainAfterExit=yes&lt;/code&gt;: активный сервис при следующем срабатывании таймера не перезапустится. В Compose 5.8.0 альтернатива — верхнеуровневый &lt;code&gt;jobs:&lt;/code&gt;. Согласно релизу, для расписания нужен Engine 29.10+ с включённым jobs extension (по умолчанию выключен), &lt;code&gt;up&lt;/code&gt; или &lt;code&gt;create&lt;/code&gt; регистрирует задания в Engine, а &lt;code&gt;down&lt;/code&gt; снимает их. Выбор здесь — где должен жить жизненный цикл задания: вместе с проектом или вместе с хостом.&lt;sup id="fnref13:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:27"&gt;&lt;a href="#fn:27" class="footnote-ref" role="doc-noteref"&gt;27&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="обновление-зачем-проверять-не-только-новый-образ"&gt;&lt;a href="#%d0%be%d0%b1%d0%bd%d0%be%d0%b2%d0%bb%d0%b5%d0%bd%d0%b8%d0%b5-%d0%b7%d0%b0%d1%87%d0%b5%d0%bc-%d0%bf%d1%80%d0%be%d0%b2%d0%b5%d1%80%d1%8f%d1%82%d1%8c-%d0%bd%d0%b5-%d1%82%d0%be%d0%bb%d1%8c%d0%ba%d0%be-%d0%bd%d0%be%d0%b2%d1%8b%d0%b9-%d0%be%d0%b1%d1%80%d0%b0%d0%b7" class="post_hash"&gt;Обновление: зачем проверять не только новый образ&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;&lt;code&gt;AutoUpdate=registry&lt;/code&gt; не меняет текст Quadlet: &lt;code&gt;podman auto-update&lt;/code&gt; сравнивает digest локального и опубликованного образов по полной ссылке, скачивает обновление и перезапускает юнит. У &lt;code&gt;local&lt;/code&gt; источник сравнения — локальное хранилище образов. Поставляемый &lt;code&gt;podman-auto-update.timer&lt;/code&gt; настроен на ежедневный запуск со случайной задержкой до 900 секунд и &lt;code&gt;Persistent=true&lt;/code&gt;, а &lt;code&gt;--dry-run&lt;/code&gt; показывает кандидатов без скачивания и рестартов. Фильтрация контейнеров не обещает рестарт строго одного контейнера: граница операции — его сервис, а связанные юниты могут быть затронуты.&lt;sup id="fnref1:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:28"&gt;&lt;a href="#fn:28" class="footnote-ref" role="doc-noteref"&gt;28&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:27"&gt;&lt;a href="#fn:27" class="footnote-ref" role="doc-noteref"&gt;27&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;У &lt;code&gt;--rollback&lt;/code&gt; в Podman 6.2.0 значение по умолчанию &lt;code&gt;true&lt;/code&gt;. Условие сформулировано узко:&lt;sup id="fnref2:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;blockquote&gt;&#10;&lt;p&gt;If restarting a systemd unit after updating the image has failed, rollback to using the previous image and restart the unit another time.&lt;sup id="fnref3:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;/blockquote&gt;&#10;&lt;p&gt;При первом &lt;code&gt;READY&lt;/code&gt; от conmon рестарт может уже считаться успешным, когда приложение ещё не успело упасть. Более содержательный &lt;code&gt;READY=1&lt;/code&gt; от приложения или &lt;code&gt;Notify=healthy&lt;/code&gt; с проверкой нужны, чтобы отказ стал виден &lt;em&gt;во время запуска&lt;/em&gt;. Если новый процесс успел применить миграцию и затем не прошёл readiness, возврат образа не вернёт прежнее состояние тома. Поэтому автоматический rollback полезен для отказов старта, но не заменяет сохранённую копию данных и проверку совместимости миграций в обратную сторону.&lt;sup id="fnref14:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref7:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref4:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:17"&gt;&lt;a href="#fn:17" class="footnote-ref" role="doc-noteref"&gt;17&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:29"&gt;&lt;a href="#fn:29" class="footnote-ref" role="doc-noteref"&gt;29&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;У Compose этапы проще разделить вручную: &lt;code&gt;pull&lt;/code&gt; скачивает образы, но не запускает из них контейнеры, а &lt;code&gt;up&lt;/code&gt; применяет изменения. Для базы разумен управляемый выпуск с закреплённым digest, резервной копией и внешней проверкой до подтверждения выкладки. Это применимо и к Quadlet: digest идентифицирует содержимое образа, а не данные приложения. При переносе не следует использовать &lt;code&gt;docker compose down -v&lt;/code&gt; как способ «аккуратно остановить» старый стек: &lt;code&gt;-v&lt;/code&gt; удаляет и объявленные именованные тома, и присоединённые анонимные. Сохранить том и восстановить согласованную базу из него — тоже не одно и то же.&lt;sup id="fnref:30"&gt;&lt;a href="#fn:30" class="footnote-ref" role="doc-noteref"&gt;30&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref3:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:31"&gt;&lt;a href="#fn:31" class="footnote-ref" role="doc-noteref"&gt;31&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:29"&gt;&lt;a href="#fn:29" class="footnote-ref" role="doc-noteref"&gt;29&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="дискуссионные-вопросы-и-противоречия"&gt;&lt;a href="#%d0%b4%d0%b8%d1%81%d0%ba%d1%83%d1%81%d1%81%d0%b8%d0%be%d0%bd%d0%bd%d1%8b%d0%b5-%d0%b2%d0%be%d0%bf%d1%80%d0%be%d1%81%d1%8b-%d0%b8-%d0%bf%d1%80%d0%be%d1%82%d0%b8%d0%b2%d0%be%d1%80%d0%b5%d1%87%d0%b8%d1%8f" class="post_hash"&gt;Дискуссионные вопросы и противоречия&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;&lt;strong&gt;«Quadlet заменяет Compose».&lt;/strong&gt; Да, если за этими словами стоит перенос постоянных служб под управление одного Linux-хоста, с таймерами и привязкой к mount. Нет, если требуется сохранить проект как переносимый артефакт с сетями, томами, overrides и командами для разработчиков. Quadlet проще для оператора, который управляет одним сервисом; Compose проще для команды, которая регулярно поднимает и разбирает проект целиком. Возможен промежуточный вариант: оставить Compose, а systemd поручить лишь старт проекта. Такой unit не получит по одному статусу systemd на каждый контейнер; разбирать внутренние сбои всё равно нужно по состоянию Engine и самого приложения.&lt;sup id="fnref15:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref8:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:10"&gt;&lt;a href="#fn:10" class="footnote-ref" role="doc-noteref"&gt;10&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref3:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref4:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:15"&gt;&lt;a href="#fn:15" class="footnote-ref" role="doc-noteref"&gt;15&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;«Если проверка упала, надо перезапустить».&lt;/strong&gt; Для зависшего одиночного процесса это может дать полезное восстановление. Если один и тот же healthcheck падает у всех экземпляров API из-за общей базы, рестарт API сам по себе базу не вернёт. Стартовую готовность, доступность внешних зависимостей и причину убить процесс лучше разделить. У Quadlet &lt;code&gt;Notify=healthy&lt;/code&gt; и &lt;code&gt;HealthOnFailure=&lt;/code&gt; — независимые решения; у Compose условие &lt;code&gt;service_healthy&lt;/code&gt; и политика &lt;code&gt;restart:&lt;/code&gt; тоже отвечают на разные вопросы. Это причина проверять поведение при сбоях, а не переносить значения из YAML в одноимённые поля.&lt;sup id="fnref16:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:21"&gt;&lt;a href="#fn:21" class="footnote-ref" role="doc-noteref"&gt;21&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:9"&gt;&lt;a href="#fn:9" class="footnote-ref" role="doc-noteref"&gt;9&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref3:10"&gt;&lt;a href="#fn:10" class="footnote-ref" role="doc-noteref"&gt;10&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:18"&gt;&lt;a href="#fn:18" class="footnote-ref" role="doc-noteref"&gt;18&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="недостаточность-данных"&gt;&lt;a href="#%d0%bd%d0%b5%d0%b4%d0%be%d1%81%d1%82%d0%b0%d1%82%d0%be%d1%87%d0%bd%d0%be%d1%81%d1%82%d1%8c-%d0%b4%d0%b0%d0%bd%d0%bd%d1%8b%d1%85" class="post_hash"&gt;Недостаточность данных&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Не найдено сопоставимого испытания, которое сравнивает Quadlet 6.2.0 и Compose 5.8.0 на одном хосте после холодной загрузки, потери БД и неудачной выкладки. Исследование Compose отвечает на вопрос о структуре конфигураций; отчёт об ошибке Podman показывает отдельный отказ readiness на старой версии. Из этих источников нельзя получить ни разницу во времени простоя, ни вероятность восстановления. Не проверялись также совместимость сторонних Compose providers и наличие нового jobs extension в пакетах конкретного дистрибутива.&lt;sup id="fnref2:15"&gt;&lt;a href="#fn:15" class="footnote-ref" role="doc-noteref"&gt;15&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:20"&gt;&lt;a href="#fn:20" class="footnote-ref" role="doc-noteref"&gt;20&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref3:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:14"&gt;&lt;a href="#fn:14" class="footnote-ref" role="doc-noteref"&gt;14&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="заключение"&gt;&lt;a href="#%d0%b7%d0%b0%d0%ba%d0%bb%d1%8e%d1%87%d0%b5%d0%bd%d0%b8%d0%b5" class="post_hash"&gt;Заключение&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Перенос оправдан, если оператору нужны именованные службы systemd, собственные правила рестарта, запуск без интерактивного входа и зависимости от ресурсов хоста. Оставить Compose разумнее, если при обычной работе важнее одна модель проекта и быстрый подъём стека целиком, а приложению достаточно политики Engine и собственных переподключений. Выбирать между ними по одному зелёному старту или слову &lt;code&gt;healthy&lt;/code&gt; не стоит.&lt;sup id="fnref17:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref4:16"&gt;&lt;a href="#fn:16" class="footnote-ref" role="doc-noteref"&gt;16&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref9:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:24"&gt;&lt;a href="#fn:24" class="footnote-ref" role="doc-noteref"&gt;24&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref4:10"&gt;&lt;a href="#fn:10" class="footnote-ref" role="doc-noteref"&gt;10&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref4:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref5:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Для приёмки достаточно нескольких осмысленных отказов на тестовой машине: перезагрузиться без входа в систему, дать базе стартовать медленнее API, уронить уже готовую базу, затем подать образ, который поднимает процесс, но не обслуживает запрос. Отдельно проверить возврат прежнего образа &lt;strong&gt;с уже изменёнными данными&lt;/strong&gt; на копии тома. По каждому случаю записать не только состояние юнита или контейнера, но и отвечает ли API и кто вернул его в рабочее состояние. Этот тест выявляет разницу, ради которой вообще стоит переходить на Quadlet.&lt;sup id="fnref18:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref10:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:24"&gt;&lt;a href="#fn:24" class="footnote-ref" role="doc-noteref"&gt;24&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref5:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref3:9"&gt;&lt;a href="#fn:9" class="footnote-ref" role="doc-noteref"&gt;9&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref6:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="quality-metrics"&gt;&lt;a href="#quality-metrics" class="post_hash"&gt;Quality Metrics&lt;/a&gt;&lt;/h2&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Metric&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th style="text-align: right"&gt;Value&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Sources found&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;76&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Sources read&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;31&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Sources cited&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;31&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Count unit&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;Found: уникальные URL кандидатов; read/cited: отдельные работы и документы&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Academic sources&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;1&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Official/documentation&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;29&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Industry reports&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;0&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;News/journalism&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;0&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Blog/forum&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;1&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Citation coverage&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;100% (29/29)&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Main-text words&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;2161&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Counter-arguments searched&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;Yes&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Research rounds&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;3&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Questions emerged&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;5&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Questions resolved&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;3&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Questions insufficient data&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;2&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;div class="footnotes" role="doc-endnotes"&gt;&#10;&lt;hr&gt;&#10;&lt;ol&gt;&#10;&lt;li id="fn:1"&gt;&#10;&lt;p&gt;Podman contributors. «podman-systemd.unit(5)». Podman v6.2.0. &lt;a href="https://raw.githubusercontent.com/podman-container-tools/podman/v6.2.0/docs/source/markdown/podman-systemd.unit.5.md"&gt;https://raw.githubusercontent.com/podman-container-tools/podman/v6.2.0/docs/source/markdown/podman-systemd.unit.5.md&lt;/a&gt;&amp;#160;&lt;a href="#fnref:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref7:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref8:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref9:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref10:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref11:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref12:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref13:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref14:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref15:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref16:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref17:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref18:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:2"&gt;&#10;&lt;p&gt;systemd contributors. «systemd.service(5)». systemd v262.2. &lt;a href="https://raw.githubusercontent.com/systemd/systemd/v262.2/man/systemd.service.xml"&gt;https://raw.githubusercontent.com/systemd/systemd/v262.2/man/systemd.service.xml&lt;/a&gt;&amp;#160;&lt;a href="#fnref:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref7:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref8:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref9:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref10:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:3"&gt;&#10;&lt;p&gt;Podman contributors. «podman-auto-update(1)». Podman v6.2.0. &lt;a href="https://raw.githubusercontent.com/podman-container-tools/podman/v6.2.0/docs/source/markdown/podman-auto-update.1.md.in"&gt;https://raw.githubusercontent.com/podman-container-tools/podman/v6.2.0/docs/source/markdown/podman-auto-update.1.md.in&lt;/a&gt;&amp;#160;&lt;a href="#fnref:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:4"&gt;&#10;&lt;p&gt;Docker. «How Compose works». Docker Docs, 2026-11-20 (дата обращения). &lt;a href="https://docs.docker.com/compose/intro/compose-application-model/"&gt;https://docs.docker.com/compose/intro/compose-application-model/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:5"&gt;&#10;&lt;p&gt;Docker Compose contributors. «docker compose up». Docker Compose v5.8.0. &lt;a href="https://raw.githubusercontent.com/docker/compose/v5.8.0/docs/reference/compose_up.md"&gt;https://raw.githubusercontent.com/docker/compose/v5.8.0/docs/reference/compose_up.md&lt;/a&gt;&amp;#160;&lt;a href="#fnref:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:6"&gt;&#10;&lt;p&gt;Podman contributors. «Release v6.2.0». GitHub, 2026-11-10. &lt;a href="https://github.com/podman-container-tools/podman/releases/tag/v6.2.0"&gt;https://github.com/podman-container-tools/podman/releases/tag/v6.2.0&lt;/a&gt;&amp;#160;&lt;a href="#fnref:6" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:6" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:6" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:6" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:7"&gt;&#10;&lt;p&gt;Docker Compose contributors. «Release v5.8.0». GitHub, 2026-11-17. &lt;a href="https://github.com/docker/compose/releases/tag/v5.8.0"&gt;https://github.com/docker/compose/releases/tag/v5.8.0&lt;/a&gt;&amp;#160;&lt;a href="#fnref:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:8"&gt;&#10;&lt;p&gt;systemd contributors. «Release systemd-stable v262.2». GitHub, 2026-11-05. &lt;a href="https://github.com/systemd/systemd/releases/tag/v262.2"&gt;https://github.com/systemd/systemd/releases/tag/v262.2&lt;/a&gt;&amp;#160;&lt;a href="#fnref:8" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:9"&gt;&#10;&lt;p&gt;Docker. «Control startup and shutdown order in Compose». Docker Docs, 2026-11-20 (дата обращения). &lt;a href="https://docs.docker.com/compose/how-tos/startup-order/"&gt;https://docs.docker.com/compose/how-tos/startup-order/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:9" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:9" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:9" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:9" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:10"&gt;&#10;&lt;p&gt;Docker. «Start containers automatically». Docker Docs, 2026-11-20 (дата обращения). &lt;a href="https://docs.docker.com/engine/containers/start-containers-automatically/"&gt;https://docs.docker.com/engine/containers/start-containers-automatically/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:10" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:10" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:10" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:10" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:10" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:11"&gt;&#10;&lt;p&gt;Podman contributors. «Release v6.1.0». GitHub, 2026-08-12. &lt;a href="https://github.com/podman-container-tools/podman/releases/tag/v6.1.0"&gt;https://github.com/podman-container-tools/podman/releases/tag/v6.1.0&lt;/a&gt;&amp;#160;&lt;a href="#fnref:11" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:12"&gt;&#10;&lt;p&gt;systemd contributors. «systemd.generator(7)». systemd v262.2. &lt;a href="https://raw.githubusercontent.com/systemd/systemd/v262.2/man/systemd.generator.xml"&gt;https://raw.githubusercontent.com/systemd/systemd/v262.2/man/systemd.generator.xml&lt;/a&gt;&amp;#160;&lt;a href="#fnref:12" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:12" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:13"&gt;&#10;&lt;p&gt;Podman contributors. «quadlet.go». Podman v6.2.0. &lt;a href="https://raw.githubusercontent.com/podman-container-tools/podman/v6.2.0/pkg/systemd/quadlet/quadlet.go"&gt;https://raw.githubusercontent.com/podman-container-tools/podman/v6.2.0/pkg/systemd/quadlet/quadlet.go&lt;/a&gt;&amp;#160;&lt;a href="#fnref:13" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:13" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:14"&gt;&#10;&lt;p&gt;Podman contributors. «podman-compose(1)». Podman v6.2.0. &lt;a href="https://raw.githubusercontent.com/podman-container-tools/podman/v6.2.0/docs/source/markdown/podman-compose.1.md.in"&gt;https://raw.githubusercontent.com/podman-container-tools/podman/v6.2.0/docs/source/markdown/podman-compose.1.md.in&lt;/a&gt;&amp;#160;&lt;a href="#fnref:14" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:14" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:15"&gt;&#10;&lt;p&gt;Kalvin Eng, Abram Hindle, Eleni Stroulia. «Patterns of Multi-Container Composition for Service Orchestration with Docker Compose». arXiv:2305.11293v2, 2024-05-08. &lt;a href="https://arxiv.org/html/2305.11293v2"&gt;https://arxiv.org/html/2305.11293v2&lt;/a&gt;&amp;#160;&lt;a href="#fnref:15" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:15" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:15" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:16"&gt;&#10;&lt;p&gt;systemd contributors. «systemd.unit(5)». systemd v262.2. &lt;a href="https://raw.githubusercontent.com/systemd/systemd/v262.2/man/systemd.unit.xml"&gt;https://raw.githubusercontent.com/systemd/systemd/v262.2/man/systemd.unit.xml&lt;/a&gt;&amp;#160;&lt;a href="#fnref:16" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:16" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:16" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:16" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:16" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:17"&gt;&#10;&lt;p&gt;Podman contributors. «&amp;ndash;sdnotify». Podman v6.2.0. &lt;a href="https://raw.githubusercontent.com/podman-container-tools/podman/v6.2.0/docs/source/markdown/options/sdnotify.md"&gt;https://raw.githubusercontent.com/podman-container-tools/podman/v6.2.0/docs/source/markdown/options/sdnotify.md&lt;/a&gt;&amp;#160;&lt;a href="#fnref:17" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:17" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:18"&gt;&#10;&lt;p&gt;Docker. «Define services in Docker Compose». Docker Docs, 2026-11-20 (дата обращения). &lt;a href="https://docs.docker.com/reference/compose-file/services/"&gt;https://docs.docker.com/reference/compose-file/services/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:18" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:18" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:18" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:19"&gt;&#10;&lt;p&gt;Docker Compose contributors. «dependency_wait.go». Docker Compose v5.8.0. &lt;a href="https://raw.githubusercontent.com/docker/compose/v5.8.0/pkg/compose/dependency_wait.go"&gt;https://raw.githubusercontent.com/docker/compose/v5.8.0/pkg/compose/dependency_wait.go&lt;/a&gt;&amp;#160;&lt;a href="#fnref:19" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:20"&gt;&#10;&lt;p&gt;Podman issue tracker. «Quadlet: Container with &lt;code&gt;Notify=healthy&lt;/code&gt; does not respect &lt;code&gt;HealthStartPeriod&lt;/code&gt; larger than systemd &lt;code&gt;TimeoutStartSec&lt;/code&gt;». Issue #27290, 2025-10-14. &lt;a href="https://github.com/podman-container-tools/podman/issues/27290"&gt;https://github.com/podman-container-tools/podman/issues/27290&lt;/a&gt;&amp;#160;&lt;a href="#fnref:20" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:20" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:21"&gt;&#10;&lt;p&gt;Podman contributors. «&amp;ndash;health-on-failure». Podman v6.2.0. &lt;a href="https://raw.githubusercontent.com/podman-container-tools/podman/v6.2.0/docs/source/markdown/options/health-on-failure.md"&gt;https://raw.githubusercontent.com/podman-container-tools/podman/v6.2.0/docs/source/markdown/options/health-on-failure.md&lt;/a&gt;&amp;#160;&lt;a href="#fnref:21" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:21" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:22"&gt;&#10;&lt;p&gt;Podman contributors. «&amp;ndash;restart». Podman v6.2.0. &lt;a href="https://raw.githubusercontent.com/podman-container-tools/podman/v6.2.0/docs/source/markdown/options/restart.md"&gt;https://raw.githubusercontent.com/podman-container-tools/podman/v6.2.0/docs/source/markdown/options/restart.md&lt;/a&gt;&amp;#160;&lt;a href="#fnref:22" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:23"&gt;&#10;&lt;p&gt;Docker Compose contributors. «restart.go». Docker Compose v5.8.0. &lt;a href="https://raw.githubusercontent.com/docker/compose/v5.8.0/pkg/compose/restart.go"&gt;https://raw.githubusercontent.com/docker/compose/v5.8.0/pkg/compose/restart.go&lt;/a&gt;&amp;#160;&lt;a href="#fnref:23" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:24"&gt;&#10;&lt;p&gt;systemd contributors. «loginctl(1)». systemd v262.2. &lt;a href="https://raw.githubusercontent.com/systemd/systemd/v262.2/man/loginctl.xml"&gt;https://raw.githubusercontent.com/systemd/systemd/v262.2/man/loginctl.xml&lt;/a&gt;&amp;#160;&lt;a href="#fnref:24" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:24" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:24" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:25"&gt;&#10;&lt;p&gt;systemd contributors. «systemd.special(7)». systemd v262.2. &lt;a href="https://raw.githubusercontent.com/systemd/systemd/v262.2/man/systemd.special.xml"&gt;https://raw.githubusercontent.com/systemd/systemd/v262.2/man/systemd.special.xml&lt;/a&gt;&amp;#160;&lt;a href="#fnref:25" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:26"&gt;&#10;&lt;p&gt;Podman contributors. «podman-user-wait-network-online.service». Podman v6.2.0. &lt;a href="https://raw.githubusercontent.com/podman-container-tools/podman/v6.2.0/contrib/systemd/user/podman-user-wait-network-online.service"&gt;https://raw.githubusercontent.com/podman-container-tools/podman/v6.2.0/contrib/systemd/user/podman-user-wait-network-online.service&lt;/a&gt;&amp;#160;&lt;a href="#fnref:26" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:27"&gt;&#10;&lt;p&gt;systemd contributors. «systemd.timer(5)». systemd v262.2. &lt;a href="https://raw.githubusercontent.com/systemd/systemd/v262.2/man/systemd.timer.xml"&gt;https://raw.githubusercontent.com/systemd/systemd/v262.2/man/systemd.timer.xml&lt;/a&gt;&amp;#160;&lt;a href="#fnref:27" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:27" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:28"&gt;&#10;&lt;p&gt;Podman contributors. «podman-auto-update.timer». Podman v6.2.0. &lt;a href="https://raw.githubusercontent.com/podman-container-tools/podman/v6.2.0/contrib/systemd/system/podman-auto-update.timer"&gt;https://raw.githubusercontent.com/podman-container-tools/podman/v6.2.0/contrib/systemd/system/podman-auto-update.timer&lt;/a&gt;&amp;#160;&lt;a href="#fnref:28" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:29"&gt;&#10;&lt;p&gt;Open Container Initiative. «OCI Content Descriptors». OCI Image Format v1.1.1. &lt;a href="https://raw.githubusercontent.com/opencontainers/image-spec/v1.1.1/descriptor.md"&gt;https://raw.githubusercontent.com/opencontainers/image-spec/v1.1.1/descriptor.md&lt;/a&gt;&amp;#160;&lt;a href="#fnref:29" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:29" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:30"&gt;&#10;&lt;p&gt;Docker Compose contributors. «docker compose pull». Docker Compose v5.8.0. &lt;a href="https://raw.githubusercontent.com/docker/compose/v5.8.0/docs/reference/compose_pull.md"&gt;https://raw.githubusercontent.com/docker/compose/v5.8.0/docs/reference/compose_pull.md&lt;/a&gt;&amp;#160;&lt;a href="#fnref:30" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:31"&gt;&#10;&lt;p&gt;Docker Compose contributors. «docker compose down». Docker Compose v5.8.0. &lt;a href="https://raw.githubusercontent.com/docker/compose/v5.8.0/docs/reference/compose_down.md"&gt;https://raw.githubusercontent.com/docker/compose/v5.8.0/docs/reference/compose_down.md&lt;/a&gt;&amp;#160;&lt;a href="#fnref:31" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;/ol&gt;&#10;&lt;/div&gt;&#10;</content></entry><entry><title>A2A 1.0: что стандартизировано в Agent-to-Agent и что осталось решением реализации</title><id>https://research.evsyukov.org/articles/a2a-1-0-agent-interop/</id><link href="https://research.evsyukov.org/articles/a2a-1-0-agent-interop/" rel="alternate" type="text/html"/><published>2026-11-19T09:38:00+03:00</published><updated>2026-11-19T09:43:34+03:00</updated><author><name>Denis Evsyukov</name></author><summary type="html">Что A2A 1.0 гарантирует на уровне Agent Card, задач и доставки обновлений, и какие свойства нужно проверять у конкретной пары клиента и сервера.</summary><content type="html">&lt;h2 id="аннотация"&gt;&lt;a href="#%d0%b0%d0%bd%d0%bd%d0%be%d1%82%d0%b0%d1%86%d0%b8%d1%8f" class="post_hash"&gt;Аннотация&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Два агента могут заявлять A2A 1.0, но не иметь общего транспорта. Даже если первый запрос прошёл, повтор после таймаута может создать вторую задачу, а новая подписка после обрыва не обязана вернуть пропущенные события. Протокол описывает, как обнаружить интерфейс, отправить сообщение, получить состояние задачи и передать обновление. Срок хранения задачи, дедупликация действий и смысл результата требуют отдельного договора.&lt;sup id="fnref:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Данные на &lt;strong&gt;2026-11-19&lt;/strong&gt;. Нормативный срез — релиз спецификации &lt;strong&gt;v1.0.1&lt;/strong&gt;, историческое сравнение — &lt;strong&gt;v0.3.0&lt;/strong&gt;. Допущение: оператор подключает два независимо развёрнутых сервиса, один заказывает формирование отчёта, другой возвращает готовый документ. Это обзор спецификации, SDK, облачных контрактов и литературы, без собственных прогонов или замеров.&lt;sup id="fnref1:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="введение"&gt;&lt;a href="#%d0%b2%d0%b2%d0%b5%d0%b4%d0%b5%d0%bd%d0%b8%d0%b5" class="post_hash"&gt;Введение&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;A2A 1.0.0 опубликован 12 марта 2026 года, а тег v1.0.1 вышел 28 мая. Это разные выпуски текста, но на проводе выбирается &lt;code&gt;1.0&lt;/code&gt;: протокол согласует версию по &lt;code&gt;Major.Minor&lt;/code&gt; и не учитывает патч. Апрельский пресс-релиз Linux Foundation сообщает о поддержке стандарта более чем 150 организациями и приводит примеры production use. Это не число установок на 1.0 и не проверка совместимости произвольных двух участников. Более свежий повод сверить границы — выпуски Python SDK 1.3.1 и Go SDK 2.9.0 от 17 ноября: практические изменения продолжаются после стабилизации спецификации.&lt;sup id="fnref2:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:6"&gt;&lt;a href="#fn:6" class="footnote-ref" role="doc-noteref"&gt;6&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:8"&gt;&lt;a href="#fn:8" class="footnote-ref" role="doc-noteref"&gt;8&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:9"&gt;&lt;a href="#fn:9" class="footnote-ref" role="doc-noteref"&gt;9&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Вопрос для self-hosted установки: какую часть интеграции можно принять по спецификации, а что надо проверить у выбранной пары SDK и сервера? У MCP другой исходный объект: инструменты, ресурсы и промпты; у A2A — взаимодействие с отдельным агентом, который может вернуть &lt;code&gt;Task&lt;/code&gt; и работать дальше. Ничто не мешает удалённому агенту использовать MCP внутри, не раскрывая его вызывающей стороне. Здесь речь не об устройстве оркестратора и не о качестве модели: нас интересует, что узнает вызывающий сервис, если ответ задержится, соединение оборвётся или задача остановится на уточнении.&lt;sup id="fnref3:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:10"&gt;&lt;a href="#fn:10" class="footnote-ref" role="doc-noteref"&gt;10&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:11"&gt;&lt;a href="#fn:11" class="footnote-ref" role="doc-noteref"&gt;11&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="agent-card-адрес-версия-и-возможности"&gt;&lt;a href="#agent-card-%d0%b0%d0%b4%d1%80%d0%b5%d1%81-%d0%b2%d0%b5%d1%80%d1%81%d0%b8%d1%8f-%d0%b8-%d0%b2%d0%be%d0%b7%d0%bc%d0%be%d0%b6%d0%bd%d0%be%d1%81%d1%82%d0%b8" class="post_hash"&gt;Agent Card: адрес, версия и возможности&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Сервер обязан сделать Agent Card доступной. &lt;code&gt;/.well-known/agent-card.json&lt;/code&gt; — один из способов обнаружения наряду с каталогом и заранее заданным адресом. В 0.3 объявления транспорта строились вокруг &lt;code&gt;url&lt;/code&gt;, &lt;code&gt;preferredTransport&lt;/code&gt; и &lt;code&gt;additionalInterfaces&lt;/code&gt;; в 1.0 список &lt;code&gt;supportedInterfaces&lt;/code&gt; содержит комбинации URL, &lt;code&gt;protocolBinding&lt;/code&gt;, &lt;code&gt;protocolVersion&lt;/code&gt; и, при необходимости, &lt;code&gt;tenant&lt;/code&gt;. &lt;code&gt;version&lt;/code&gt; на самой карточке — версия &lt;em&gt;агента&lt;/em&gt;, а не протокола. Клиент берёт первый подходящий интерфейс в порядке объявления; если выбранный интерфейс задаёт &lt;code&gt;tenant&lt;/code&gt;, клиент передаёт его в запросах к нему.&lt;sup id="fnref4:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:12"&gt;&lt;a href="#fn:12" class="footnote-ref" role="doc-noteref"&gt;12&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Из карточки не следует, что сервер обязан реализовать все три стандартных binding — &lt;code&gt;JSONRPC&lt;/code&gt;, &lt;code&gt;HTTP+JSON&lt;/code&gt; и &lt;code&gt;GRPC&lt;/code&gt;. Требование другое: если сервер для одного протокольного профиля объявляет несколько binding, операции, возможности, смысл ответов и схемы аутентификации должны быть эквивалентны. JSON-RPC и gRPC, например, называют операцию &lt;code&gt;SendMessage&lt;/code&gt;, а HTTP+JSON использует &lt;code&gt;POST /message:send&lt;/code&gt;. Общий тип операции не делает JSON-RPC envelope взаимозаменяемым с телом REST. Отдельно проверяются capability flags: без &lt;code&gt;streaming&lt;/code&gt; операции потока должны вернуть &lt;code&gt;UnsupportedOperationError&lt;/code&gt;, а без &lt;code&gt;pushNotifications&lt;/code&gt; операции настройки push — &lt;code&gt;PushNotificationNotSupportedError&lt;/code&gt;.&lt;sup id="fnref5:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Для новой интеграции стоит явно посылать &lt;code&gt;A2A-Version: 1.0&lt;/code&gt;. По §3.6 пустое значение означает &lt;code&gt;0.3&lt;/code&gt;, а если интерфейс не поддерживает запрошенную версию, возвращается &lt;code&gt;VersionNotSupportedError&lt;/code&gt; (&lt;code&gt;-32009&lt;/code&gt; в таблице JSON-RPC). Из v1.0-карточки и успеха пробного вызова без заголовка ещё не следует, что этот вызов действительно прошёл по 1.0. Явный выбор транспорта и версии позволяет отличить ожидаемый результат от незаметного перехода на старый контракт.&lt;sup id="fnref6:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Подпись карточки необязательна. Если её проверяют, A2A задаёт порядок подготовки данных для JWS: правила присутствия полей, исключение &lt;code&gt;signatures&lt;/code&gt; и канонизация JSON по RFC 8785. Канонизация нужна, чтобы различия в расположении свойств и пробелах не портили проверку. Успешная проверка говорит о подписанном содержимом относительно выбранного ключа; она не подтверждает, что описанный навык справится с задачей, и не заменяет решение о том, каким ключам и поставщикам доверять. Аналогично &lt;code&gt;tenant&lt;/code&gt; — непрозрачный идентификатор маршрутизации, а не разрешение на чтение чужих задач.&lt;sup id="fnref7:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref3:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:13"&gt;&lt;a href="#fn:13" class="footnote-ref" role="doc-noteref"&gt;13&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="task-message-и-artifact-где-хранится-результат"&gt;&lt;a href="#task-message-%d0%b8-artifact-%d0%b3%d0%b4%d0%b5-%d1%85%d1%80%d0%b0%d0%bd%d0%b8%d1%82%d1%81%d1%8f-%d1%80%d0%b5%d0%b7%d1%83%d0%bb%d1%8c%d1%82%d0%b0%d1%82" class="post_hash"&gt;Task, Message и Artifact: где хранится результат&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;&lt;code&gt;SendMessage&lt;/code&gt; может вернуть одиночный &lt;code&gt;Message&lt;/code&gt; без отслеживаемой задачи либо &lt;code&gt;Task&lt;/code&gt;. &lt;code&gt;Task&lt;/code&gt; получает идентификатор от сервера; переданный клиентом &lt;code&gt;taskId&lt;/code&gt; относится к уже существующей задаче. &lt;code&gt;contextId&lt;/code&gt; группирует связанные сообщения и задачи: можно продолжить конкретное задание по &lt;code&gt;taskId&lt;/code&gt; или начать новое в том же контексте. Если переданы оба идентификатора и они не согласованы, сервер обязан отклонить запрос. Когда задача просит уточнения (&lt;code&gt;TASK_STATE_INPUT_REQUIRED&lt;/code&gt;), оно относится к исходному &lt;code&gt;taskId&lt;/code&gt;; в терминальную задачу (&lt;code&gt;COMPLETED&lt;/code&gt;, &lt;code&gt;FAILED&lt;/code&gt;, &lt;code&gt;CANCELED&lt;/code&gt;, &lt;code&gt;REJECTED&lt;/code&gt; с префиксом &lt;code&gt;TASK_STATE_&lt;/code&gt;) дополнительные сообщения уже не принимаются.&lt;sup id="fnref8:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref4:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Для асинхронной работы важен &lt;code&gt;configuration.returnImmediately&lt;/code&gt;. Специальный раздел §3.2.2 устанавливает блокирующее поведение по умолчанию: ждать терминального или прерванного состояния, в том числе запроса ввода или авторизации. При &lt;code&gt;true&lt;/code&gt; сервер возвращает задачу сразу после её создания, а клиент дальше читает состояние. В 0.3 использовалось поле &lt;code&gt;blocking&lt;/code&gt;; при преобразовании формы нельзя копировать булево значение как есть, потому что полярность обратная. Это имеет значение, если запрос живёт дольше таймаута шлюза: долгий ответ не говорит, что задача не была создана.&lt;sup id="fnref9:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref5:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:12"&gt;&lt;a href="#fn:12" class="footnote-ref" role="doc-noteref"&gt;12&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:14"&gt;&lt;a href="#fn:14" class="footnote-ref" role="doc-noteref"&gt;14&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Отчёт из примера должен быть &lt;code&gt;Artifact&lt;/code&gt; задачи, а промежуточный текст вроде «собрал таблицу, уточните период» — &lt;code&gt;Message&lt;/code&gt;. Протокол рекомендует не подменять результаты задачи сообщениями. Более того, сервер решает, какие сообщения сохранять в истории, а клиент не должен полагаться на полноту истории без отдельной договорённости. Поэтому после reconnect разумно читать сохранённые артефакты, а не собирать итоговый файл из реплик диалога. Как долго эти данные доступны — свойство сервиса: например, Microsoft документирует для Foundry 60 дней с последней записи в задачу или контекст, а не общий для A2A срок.&lt;sup id="fnref10:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref6:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Уникальный &lt;code&gt;messageId&lt;/code&gt; не делает отправку идемпотентной. Одно предложение в §3.3.1 задаёт границу достаточно точно:&lt;sup id="fnref11:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref7:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;blockquote&gt;&#10;&lt;p&gt;&lt;strong&gt;Send Message&lt;/strong&gt; operations MAY be idempotent. Agents may utilize the messageId to detect duplicate messages.&lt;sup id="fnref12:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;/blockquote&gt;&#10;&lt;p&gt;Если ответ на отправку потерялся раньше, чем клиент узнал &lt;code&gt;taskId&lt;/code&gt;, тот не может сделать &lt;code&gt;GetTask&lt;/code&gt; по этому идентификатору. Слепое повторение с тем же &lt;code&gt;messageId&lt;/code&gt; безопасно лишь при дополнительной гарантии реализации. Для операции с последствиями я бы фиксировал прикладной ключ запроса и способ сверки результата либо оставлял исход в состоянии «неизвестно» до проверки. Это тот же принцип, который RFC 9110 применяет к автоматическому повтору неидемпотентных запросов: нужна гарантия семантики или основание считать, что предыдущий запрос не применён. &lt;code&gt;CancelTask&lt;/code&gt; тоже не следует считать откатом действия: операция только пытается остановить задачу и может вернуть &lt;code&gt;TaskNotCancelableError&lt;/code&gt;.&lt;sup id="fnref13:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:15"&gt;&lt;a href="#fn:15" class="footnote-ref" role="doc-noteref"&gt;15&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="три-канала-обновлений-и-три-разных-отказа"&gt;&lt;a href="#%d1%82%d1%80%d0%b8-%d0%ba%d0%b0%d0%bd%d0%b0%d0%bb%d0%b0-%d0%be%d0%b1%d0%bd%d0%be%d0%b2%d0%bb%d0%b5%d0%bd%d0%b8%d0%b9-%d0%b8-%d1%82%d1%80%d0%b8-%d1%80%d0%b0%d0%b7%d0%bd%d1%8b%d1%85-%d0%be%d1%82%d0%ba%d0%b0%d0%b7%d0%b0" class="post_hash"&gt;Три канала обновлений и три разных отказа&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;&lt;strong&gt;Polling.&lt;/strong&gt; При известном &lt;code&gt;taskId&lt;/code&gt; &lt;code&gt;GetTask&lt;/code&gt; читает текущее состояние, артефакты и, если запрошено, историю. Это самый простой исходный профиль для двух своих сервисов: не нужен ни постоянный поток, ни обратный HTTP-вызов. Цена — задержка и лишние запросы между изменениями. После терминального состояния результат имеет смысл забрать до истечения заявленного срока хранения; A2A отдельно допускает &lt;code&gt;TaskNotFoundError&lt;/code&gt; для недоступной или уже удалённой задачи.&lt;sup id="fnref14:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref3:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;Streaming.&lt;/strong&gt; У &lt;code&gt;SendStreamingMessage&lt;/code&gt; первый кадр — &lt;code&gt;Task&lt;/code&gt; либо единственный &lt;code&gt;Message&lt;/code&gt;, после которого поток закрывается. За &lt;code&gt;Task&lt;/code&gt; могут идти события &lt;code&gt;statusUpdate&lt;/code&gt; и &lt;code&gt;artifactUpdate&lt;/code&gt;. Тип различается по заполненному полю &lt;code&gt;StreamResponse&lt;/code&gt;, а не по старому &lt;code&gt;kind&lt;/code&gt;. Для порций одного артефакта &lt;code&gt;append&lt;/code&gt; означает дополнение содержимого, &lt;code&gt;lastChunk&lt;/code&gt; завершает артефакт, но не саму задачу. A2A требует, чтобы события в активном потоке шли в порядке генерации; HTTP-варианты используют SSE, gRPC — поток ответов RPC.&lt;sup id="fnref15:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref8:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:12"&gt;&lt;a href="#fn:12" class="footnote-ref" role="doc-noteref"&gt;12&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;После обрыва &lt;code&gt;SubscribeToTask&lt;/code&gt; открывает новый поток по существующей нетерминальной задаче; первый объект обязан показать её состояние на момент подписки. Это снимок, а не курсор воспроизведения. Стандарт SSE описывает &lt;code&gt;Last-Event-ID&lt;/code&gt; для повторного подключения &lt;code&gt;EventSource&lt;/code&gt;, но у A2A нет соответствующего параметра запроса &lt;code&gt;SubscribeToTask&lt;/code&gt; и обязательного журнала событий между двумя потоками. Клиенту не стоит вслепую добавлять новые чанки к старому локальному буферу: после подписки он должен свериться со снимком, а если задача уже завершилась — читать её через &lt;code&gt;GetTask&lt;/code&gt;. Для аудита каждого перехода нужен отдельный журнал или явно согласованный механизм воспроизведения.&lt;sup id="fnref16:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref9:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:16"&gt;&lt;a href="#fn:16" class="footnote-ref" role="doc-noteref"&gt;16&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;Push.&lt;/strong&gt; Даже если основной binding — gRPC, агент отправляет уведомление отдельным HTTP POST. Тело — тот же &lt;code&gt;StreamResponse&lt;/code&gt;, получатель подтверждает приём 2xx, а дубликаты возможны. Формулировка §4.3.3 — «Agents MUST attempt delivery at least once for each configured webhook», то есть минимум одна &lt;em&gt;попытка&lt;/em&gt;, а не гарантированное поступление. §4.3.3 разрешает повторные попытки, §13.2 рекомендует backoff, но не обещает число повторов или срок доставки. Для небольшого контура полезно считать webhook сигналом перечитать состояние, а не единственной копией результата; на стороне приёмника проверять подлинность уведомления и связь с ожидаемой задачей, на стороне отправителя ограничивать допустимых получателей.&lt;sup id="fnref17:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref10:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="что-говорят-выпуски-sdk-и-облачные-контракты"&gt;&lt;a href="#%d1%87%d1%82%d0%be-%d0%b3%d0%be%d0%b2%d0%be%d1%80%d1%8f%d1%82-%d0%b2%d1%8b%d0%bf%d1%83%d1%81%d0%ba%d0%b8-sdk-%d0%b8-%d0%be%d0%b1%d0%bb%d0%b0%d1%87%d0%bd%d1%8b%d0%b5-%d0%ba%d0%be%d0%bd%d1%82%d1%80%d0%b0%d0%ba%d1%82%d1%8b" class="post_hash"&gt;Что говорят выпуски SDK и облачные контракты&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;У Foundry входящий A2A 1.0 заявлен GA, но именно для JSON-RPC, с текстовой модальностью и без SSE; в preview 0.3 документированы JSON-RPC и HTTP+JSON. Сервис выдаёт отдельные адреса карточек для 1.0 и 0.3. У Amazon Bedrock AgentCore Runtime документация описывает собственный контракт хостинга с POST для A2A-вызовов, &lt;code&gt;GET /.well-known/agent-card.json&lt;/code&gt; и &lt;code&gt;GET /ping&lt;/code&gt;; в примере карточки указано &lt;code&gt;protocolVersion: &amp;quot;0.3.0&amp;quot;&lt;/code&gt;. Этот пример не доказывает отказ от 1.0 во всех продуктах AWS. Оба документа показывают, почему спрашивать надо про конкретный endpoint, а не про облако или бренд целиком.&lt;sup id="fnref4:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:17"&gt;&lt;a href="#fn:17" class="footnote-ref" role="doc-noteref"&gt;17&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;У совместимости есть и граница преобразования. В JS SDK 1.3.0 слой для 0.3 включается отдельно. В его документации &lt;code&gt;ListTasks&lt;/code&gt; для собеседника 0.3 не работает; историческая спецификация упоминает листинг для gRPC/REST, но не для JSON-RPC, а поставляемый в этом SDK старый proto не содержит соответствующего RPC. То есть отсутствие функции в данном адаптере нельзя превращать в утверждение «ни одна 0.3 реализация не умела листинг». В том же адаптере OAuth device-code не представим в карточке 0.3 и отбрасывается — синтаксически читаемая карточка может описывать более узкий набор сценариев.&lt;sup id="fnref3:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:14"&gt;&lt;a href="#fn:14" class="footnote-ref" role="doc-noteref"&gt;14&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Номера SDK не следуют номерам протокола. В Python SDK 1.3.1 исправлены разбор регистра SSE media type и обработка идентификаторов в путях REST; Go SDK 2.9.0 добавляет hooks вокруг клиента, исполнения, хранилища и push-доставки. Это записи из changelog, а не результаты межъязыкового прогона. Для приёмки я бы записывал отдельно версии клиента и сервера, URL конкретной карточки, binding, &lt;code&gt;A2A-Version&lt;/code&gt;, поддерживаемые возможности и способ авторизации. Тогда изменение результата при обновлении одного компонента можно локализовать, не споря о ярлыке «оба на A2A 1.0».&lt;sup id="fnref18:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:8"&gt;&lt;a href="#fn:8" class="footnote-ref" role="doc-noteref"&gt;8&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:9"&gt;&lt;a href="#fn:9" class="footnote-ref" role="doc-noteref"&gt;9&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:18"&gt;&lt;a href="#fn:18" class="footnote-ref" role="doc-noteref"&gt;18&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="дискуссионные-вопросы-и-противоречия"&gt;&lt;a href="#%d0%b4%d0%b8%d1%81%d0%ba%d1%83%d1%81%d1%81%d0%b8%d0%be%d0%bd%d0%bd%d1%8b%d0%b5-%d0%b2%d0%be%d0%bf%d1%80%d0%be%d1%81%d1%8b-%d0%b8-%d0%bf%d1%80%d0%be%d1%82%d0%b8%d0%b2%d0%be%d1%80%d0%b5%d1%87%d0%b8%d1%8f" class="post_hash"&gt;Дискуссионные вопросы и противоречия&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;&lt;strong&gt;Проза, пример и схема могут расходиться в одном теге.&lt;/strong&gt; В v1.0.1 §3.1.1 говорит, что &lt;code&gt;Send Message&lt;/code&gt; возвращается немедленно, а специальный §3.2.2 задаёт ожидание по умолчанию. Для таймаутов я бы опирался на специальный раздел, выставлял &lt;code&gt;returnImmediately&lt;/code&gt; явно и проверял оба режима. Ещё нагляднее HTTP-подписка: таблица §5.3 и §11.3.2 указывают &lt;code&gt;POST /tasks/{id}:subscribe&lt;/code&gt;, а HTTP-аннотация того же релиза в &lt;code&gt;a2a.proto&lt;/code&gt; — &lt;code&gt;get: &amp;quot;/{tenant}/tasks/{id=*}:subscribe&amp;quot;&lt;/code&gt;. Это расхождение исходников, не наблюдение за работающим сервером. Генератор по proto и автор клиента по таблице могут выбрать разные методы; именно его и нужно фиксировать в профиле пары.&lt;sup id="fnref19:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref11:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;Патч не меняет &lt;code&gt;A2A-Version&lt;/code&gt;, но меняет рекомендации на проводе.&lt;/strong&gt; В v1.0.0 для HTTP+JSON указан &lt;code&gt;application/json&lt;/code&gt;; §11.1 в v1.0.1 рекомендует &lt;code&gt;application/a2a+json&lt;/code&gt; на уровне &lt;strong&gt;SHOULD&lt;/strong&gt;. Из этого не следует, что старый media type запрещён. TCK позволяет переключить именно проверяемую рекомендацию media type на 1.0.0, не переключая весь набор тестов на предыдущую спецификацию. Настройка нужна, например, если шлюз фильтрует &lt;code&gt;Content-Type&lt;/code&gt;, даже когда клиент и сервер используют один протокольный профиль &lt;code&gt;1.0&lt;/code&gt;.&lt;sup id="fnref20:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:18"&gt;&lt;a href="#fn:18" class="footnote-ref" role="doc-noteref"&gt;18&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:19"&gt;&lt;a href="#fn:19" class="footnote-ref" role="doc-noteref"&gt;19&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;Совместимость протокола не измеряет полезность делегирования.&lt;/strong&gt; Исследование Predoaia и соавторов сравнивает две реализации одного фиксированного сценария разработки: в варианте с A2A больше координации выражено через протокольные сущности, а в варианте с MCP часть логики состояния реализована приложением. Авторы ограничивают переносимость результата этим дизайном. Архитектурный обзор Xiong и соавторов также отделяет совместимость от управления полномочиями и наблюдаемости, но не проводит сравнительного бенчмарка. Для отчёта по вымышленному заказу это разные критерии: &lt;code&gt;Task&lt;/code&gt; перешёл в &lt;code&gt;COMPLETED&lt;/code&gt;, документ соответствует прикладной схеме, документ отвечает на исходный вопрос. Первое можно увидеть в A2A; два других требуют собственных проверок.&lt;sup id="fnref21:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:10"&gt;&lt;a href="#fn:10" class="footnote-ref" role="doc-noteref"&gt;10&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:20"&gt;&lt;a href="#fn:20" class="footnote-ref" role="doc-noteref"&gt;20&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="недостаточность-данных"&gt;&lt;a href="#%d0%bd%d0%b5%d0%b4%d0%be%d1%81%d1%82%d0%b0%d1%82%d0%be%d1%87%d0%bd%d0%be%d1%81%d1%82%d1%8c-%d0%b4%d0%b0%d0%bd%d0%bd%d1%8b%d1%85" class="post_hash"&gt;Недостаточность данных&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;В просмотренных документах и работах нет независимой матрицы, которая одновременно покрывала бы актуальные SDK, три binding, смену версий, рестарт с задачей в работе и утрату обратного уведомления. TCK проверяет интерфейсы из &lt;code&gt;supportedInterfaces&lt;/code&gt; и явно предупреждает: «A 100% automated score does not establish full conformance while manual obligations remain pending.» Это источник сценариев проверки, а не доказательство доступности сервиса или долговечности данных после рестарта. Собственных результатов для этих отказов здесь нет.&lt;sup id="fnref2:8"&gt;&lt;a href="#fn:8" class="footnote-ref" role="doc-noteref"&gt;8&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:9"&gt;&lt;a href="#fn:9" class="footnote-ref" role="doc-noteref"&gt;9&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:18"&gt;&lt;a href="#fn:18" class="footnote-ref" role="doc-noteref"&gt;18&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:10"&gt;&lt;a href="#fn:10" class="footnote-ref" role="doc-noteref"&gt;10&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:20"&gt;&lt;a href="#fn:20" class="footnote-ref" role="doc-noteref"&gt;20&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="заключение"&gt;&lt;a href="#%d0%b7%d0%b0%d0%ba%d0%bb%d1%8e%d1%87%d0%b5%d0%bd%d0%b8%d0%b5" class="post_hash"&gt;Заключение&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Для первого self-hosted внедрения я бы выбрал один binding, явно указал &lt;code&gt;1.0&lt;/code&gt; и начал с &lt;code&gt;SendMessage&lt;/code&gt; и &lt;code&gt;GetTask&lt;/code&gt;. При приёмке проверил бы прямой ответ и создание задачи, уточнение по тому же &lt;code&gt;taskId&lt;/code&gt;, отказ для чужой задачи и чтение артефакта после завершения. Затем отдельно согласовал бы хранение задач и поведение при повторной отправке после таймаута. Только после этого стоит добавлять поток ради интерактивности или push ради фонового уведомления: оба канала ускоряют получение новости, но не заменяют доступное для сверки состояние.&lt;sup id="fnref22:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref12:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref3:18"&gt;&lt;a href="#fn:18" class="footnote-ref" role="doc-noteref"&gt;18&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:15"&gt;&lt;a href="#fn:15" class="footnote-ref" role="doc-noteref"&gt;15&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Итоговый договор стоит описывать как совместимость конкретной пары: версия на проводе, binding, форматы входа и выхода, права на задачи, срок хранения и процедура восстановления. A2A стандартизирует операции и поля, на которые этот договор можно опереть. Он не задаёт долговечность вашей базы, семантику повторного прикладного действия и качество сгенерированного результата.&lt;sup id="fnref23:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref13:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref5:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:20"&gt;&lt;a href="#fn:20" class="footnote-ref" role="doc-noteref"&gt;20&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="quality-metrics"&gt;&lt;a href="#quality-metrics" class="post_hash"&gt;Quality Metrics&lt;/a&gt;&lt;/h2&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Metric&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Value&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Sources found&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;67&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Sources read&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;20&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Sources cited&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;20&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Academic sources&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;2&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Official/documentation&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;18&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Industry reports&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;0&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;News/journalism&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;0&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Blog/forum&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;0&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Unit of count&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Found — URL кандидатов; read/cited — документы, схемы и выпуски, без повторного счёта копий&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Citation coverage&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;100%&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Counter-arguments searched&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Yes&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Research rounds&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;3&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Questions emerged&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;7&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Questions resolved&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;6&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Questions insufficient data&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;1&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;div class="footnotes" role="doc-endnotes"&gt;&#10;&lt;hr&gt;&#10;&lt;ol&gt;&#10;&lt;li id="fn:1"&gt;&#10;&lt;p&gt;A2A Project. «Agent2Agent (A2A) Protocol Specification». Tagged source, v1.0.1. &lt;a href="https://raw.githubusercontent.com/a2aproject/A2A/v1.0.1/docs/specification.md"&gt;https://raw.githubusercontent.com/a2aproject/A2A/v1.0.1/docs/specification.md&lt;/a&gt;&amp;#160;&lt;a href="#fnref:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref7:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref8:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref9:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref10:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref11:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref12:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref13:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref14:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref15:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref16:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref17:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref18:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref19:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref20:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref21:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref22:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref23:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:2"&gt;&#10;&lt;p&gt;A2A Project. &lt;code&gt;specification/a2a.proto&lt;/code&gt;. Protocol schema, v1.0.1. &lt;a href="https://raw.githubusercontent.com/a2aproject/A2A/v1.0.1/specification/a2a.proto"&gt;https://raw.githubusercontent.com/a2aproject/A2A/v1.0.1/specification/a2a.proto&lt;/a&gt;&amp;#160;&lt;a href="#fnref:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref7:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref8:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref9:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref10:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref11:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref12:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref13:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:3"&gt;&#10;&lt;p&gt;Microsoft. «Enable incoming A2A on a Foundry agent». Microsoft Learn, updated 2026-09-14. &lt;a href="https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/enable-agent-to-agent-endpoint"&gt;https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/enable-agent-to-agent-endpoint&lt;/a&gt;&amp;#160;&lt;a href="#fnref:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:4"&gt;&#10;&lt;p&gt;A2A Project. «v1.0.1». GitHub Releases, published 2026-05-28. &lt;a href="https://github.com/a2aproject/A2A/releases/tag/v1.0.1"&gt;https://github.com/a2aproject/A2A/releases/tag/v1.0.1&lt;/a&gt;&amp;#160;&lt;a href="#fnref:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:5"&gt;&#10;&lt;p&gt;A2A Project. «Agent2Agent (A2A) Protocol Specification». Tagged source, v0.3.0. &lt;a href="https://raw.githubusercontent.com/a2aproject/A2A/v0.3.0/docs/specification.md"&gt;https://raw.githubusercontent.com/a2aproject/A2A/v0.3.0/docs/specification.md&lt;/a&gt;&amp;#160;&lt;a href="#fnref:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:6"&gt;&#10;&lt;p&gt;A2A Project. «v1.0.0». GitHub Releases, 2026-03-12. &lt;a href="https://github.com/a2aproject/A2A/releases/tag/v1.0.0"&gt;https://github.com/a2aproject/A2A/releases/tag/v1.0.0&lt;/a&gt;&amp;#160;&lt;a href="#fnref:6" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:7"&gt;&#10;&lt;p&gt;Linux Foundation. «A2A Protocol Surpasses 150 Organizations, Lands in Major Cloud Platforms, and Sees Enterprise Production Use in First Year». 2026-04-09. &lt;a href="https://www.linuxfoundation.org/press/a2a-protocol-surpasses-150-organizations-lands-in-major-cloud-platforms-and-sees-enterprise-production-use-in-first-year"&gt;https://www.linuxfoundation.org/press/a2a-protocol-surpasses-150-organizations-lands-in-major-cloud-platforms-and-sees-enterprise-production-use-in-first-year&lt;/a&gt;&amp;#160;&lt;a href="#fnref:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:8"&gt;&#10;&lt;p&gt;A2A Project. «v1.3.1». A2A Python SDK, GitHub Releases, published 2026-11-17. &lt;a href="https://github.com/a2aproject/a2a-python/releases/tag/v1.3.1"&gt;https://github.com/a2aproject/a2a-python/releases/tag/v1.3.1&lt;/a&gt;&amp;#160;&lt;a href="#fnref:8" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:8" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:8" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:9"&gt;&#10;&lt;p&gt;A2A Project. «v2.9.0». A2A Go SDK, GitHub Releases, 2026-11-17. &lt;a href="https://github.com/a2aproject/a2a-go/releases/tag/v2.9.0"&gt;https://github.com/a2aproject/a2a-go/releases/tag/v2.9.0&lt;/a&gt;&amp;#160;&lt;a href="#fnref:9" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:9" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:9" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:10"&gt;&#10;&lt;p&gt;Ionut Predoaia, Tuong Manh Vu, Konstantinos Barmpis, Dimitris Kolovos, Antonio García-Domínguez. «A Comparative Study of MCP and A2A for Inter-Agent Coordination in LLM-Based Systems». arXiv:2607.23884v1, 2026-07-26. &lt;a href="https://arxiv.org/html/2607.23884v1"&gt;https://arxiv.org/html/2607.23884v1&lt;/a&gt;&amp;#160;&lt;a href="#fnref:10" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:10" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:10" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:11"&gt;&#10;&lt;p&gt;Model Context Protocol. «Specification». Protocol revision 2026-07-28. &lt;a href="https://modelcontextprotocol.io/specification/2026-07-28"&gt;https://modelcontextprotocol.io/specification/2026-07-28&lt;/a&gt;&amp;#160;&lt;a href="#fnref:11" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:12"&gt;&#10;&lt;p&gt;A2A Project. «What&amp;rsquo;s New in A2A Protocol v1.0». Tagged migration guide, v1.0.1. &lt;a href="https://raw.githubusercontent.com/a2aproject/A2A/v1.0.1/docs/whats-new-v1.md"&gt;https://raw.githubusercontent.com/a2aproject/A2A/v1.0.1/docs/whats-new-v1.md&lt;/a&gt;&amp;#160;&lt;a href="#fnref:12" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:12" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:12" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:13"&gt;&#10;&lt;p&gt;Anders Rundgren, Bret Jordan, Samuel Erdtman. «JSON Canonicalization Scheme (JCS)». RFC 8785, 2020-06. &lt;a href="https://www.rfc-editor.org/rfc/rfc8785.html"&gt;https://www.rfc-editor.org/rfc/rfc8785.html&lt;/a&gt;&amp;#160;&lt;a href="#fnref:13" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:14"&gt;&#10;&lt;p&gt;A2A Project. «v0.3 Compatibility Guide». A2A JavaScript SDK v1.3.0. &lt;a href="https://raw.githubusercontent.com/a2aproject/a2a-js/v1.3.0/docs/compatibility-v0_3.md"&gt;https://raw.githubusercontent.com/a2aproject/a2a-js/v1.3.0/docs/compatibility-v0_3.md&lt;/a&gt;&amp;#160;&lt;a href="#fnref:14" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:14" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:15"&gt;&#10;&lt;p&gt;Roy T. Fielding, Mark Nottingham, Julian Reschke (eds.). «HTTP Semantics». RFC 9110, §9.2.2, 2022-06. &lt;a href="https://www.rfc-editor.org/rfc/rfc9110.txt"&gt;https://www.rfc-editor.org/rfc/rfc9110.txt&lt;/a&gt;&amp;#160;&lt;a href="#fnref:15" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:15" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:16"&gt;&#10;&lt;p&gt;WHATWG. «HTML Living Standard: 9.2 Server-sent events». &lt;a href="https://html.spec.whatwg.org/multipage/server-sent-events.html"&gt;https://html.spec.whatwg.org/multipage/server-sent-events.html&lt;/a&gt;&amp;#160;&lt;a href="#fnref:16" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:17"&gt;&#10;&lt;p&gt;AWS. «A2A protocol contract». Amazon Bedrock AgentCore Developer Guide. &lt;a href="https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/runtime-a2a-protocol-contract.html"&gt;https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/runtime-a2a-protocol-contract.html&lt;/a&gt;&amp;#160;&lt;a href="#fnref:17" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:18"&gt;&#10;&lt;p&gt;A2A Project. «A2A Protocol Technology Compatibility Kit (TCK)». README, commit &lt;code&gt;5e6f37c2d38eb3d7684686243c34d365c83df49b&lt;/code&gt;. &lt;a href="https://raw.githubusercontent.com/a2aproject/a2a-tck/5e6f37c2d38eb3d7684686243c34d365c83df49b/README.md"&gt;https://raw.githubusercontent.com/a2aproject/a2a-tck/5e6f37c2d38eb3d7684686243c34d365c83df49b/README.md&lt;/a&gt;&amp;#160;&lt;a href="#fnref:18" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:18" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:18" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:18" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:19"&gt;&#10;&lt;p&gt;A2A Project. «Agent2Agent (A2A) Protocol Specification (Release Candidate v1.0)». Source at release tag v1.0.0, §11.1. &lt;a href="https://raw.githubusercontent.com/a2aproject/A2A/v1.0.0/docs/specification.md"&gt;https://raw.githubusercontent.com/a2aproject/A2A/v1.0.0/docs/specification.md&lt;/a&gt;&amp;#160;&lt;a href="#fnref:19" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:20"&gt;&#10;&lt;p&gt;Haoyi Xiong et al. «Towards a Trustworthy and Governable Internet of Agentics: An Architectural Perspective on Protocols, Systems, and Services». arXiv:2611.03066v1, 2026-11-02. &lt;a href="https://arxiv.org/html/2611.03066v1"&gt;https://arxiv.org/html/2611.03066v1&lt;/a&gt;&amp;#160;&lt;a href="#fnref:20" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:20" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:20" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;/ol&gt;&#10;&lt;/div&gt;&#10;</content></entry><entry><title>Forgejo Actions и Forgejo Runner: где меняется модель доверия после GitHub Actions</title><id>https://research.evsyukov.org/articles/forgejo-actions-act-runner/</id><link href="https://research.evsyukov.org/articles/forgejo-actions-act-runner/" rel="alternate" type="text/html"/><published>2026-11-18T09:40:00+03:00</published><updated>2026-11-18T10:08:30+03:00</updated><author><name>Denis Evsyukov</name></author><summary type="html">Что меняется при переносе CI в Forgejo: допуск pull request, права токенов, изоляция runner, происхождение actions и хранение результатов.</summary><content type="html">&lt;h2 id="аннотация"&gt;&lt;a href="#%d0%b0%d0%bd%d0%bd%d0%be%d1%82%d0%b0%d1%86%d0%b8%d1%8f" class="post_hash"&gt;Аннотация&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;&lt;code&gt;runs-on: ubuntu-latest&lt;/code&gt; можно оставить в перенесённом workflow и получить зелёный прогон, хотя та же строка теперь выбирает машину с другой системой, другим набором инструментов и другой границей изоляции. Есть и менее заметный разрыв: Forgejo 17.0 прямо указывает, что &lt;code&gt;permissions&lt;/code&gt; на уровне job игнорируется. Поэтому перенос CI лучше принимать по трём вопросам: кто может запустить какой код, какие полномочия получает этот код и что переживает завершение job.&lt;sup id="fnref:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Данные на &lt;strong&gt;2026-11-18&lt;/strong&gt;. Срез: Forgejo &lt;strong&gt;17.0.1&lt;/strong&gt;, Forgejo Runner &lt;strong&gt;13.2.1&lt;/strong&gt;, версионная документация Forgejo 17.0; для сравнения — актуальная на дату обзора документация GitHub.com по hosted и self-hosted runners. Ветка Forgejo 15 показана в каталоге как LTS (15.0.11), но её семантика здесь отдельно не проверялась. Допущение: один администратор небольшого Linux-парка, публичный или приватный репозиторий, тесты и публикация релизов. Это обзор документов и литературы, без прогонов workflow и замеров.&lt;sup id="fnref:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:6"&gt;&lt;a href="#fn:6" class="footnote-ref" role="doc-noteref"&gt;6&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:8"&gt;&lt;a href="#fn:8" class="footnote-ref" role="doc-noteref"&gt;8&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="введение"&gt;&lt;a href="#%d0%b2%d0%b2%d0%b5%d0%b4%d0%b5%d0%bd%d0%b8%d0%b5" class="post_hash"&gt;Введение&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Forgejo 16.0 вышел &lt;strong&gt;16 июля 2026 года&lt;/strong&gt;, а октябрьский major — &lt;strong&gt;17.0&lt;/strong&gt;, от 15 октября. В нём, например, появились job summaries, которые принимают и &lt;code&gt;FORGEJO_STEP_SUMMARY&lt;/code&gt;, и совместимое имя &lt;code&gt;GITHUB_STEP_SUMMARY&lt;/code&gt;. Это хорошая иллюстрация того, что совместимость имени бывает полезна и намеренна, но не распространяется автоматически на политику допуска и права. Патч сервера 17.0.1 опубликован 26 октября, а Runner 13.2.1 — 29 октября; версии сервера и исполнителя нужно учитывать отдельно.&lt;sup id="fnref1:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:6"&gt;&lt;a href="#fn:6" class="footnote-ref" role="doc-noteref"&gt;6&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:8"&gt;&lt;a href="#fn:8" class="footnote-ref" role="doc-noteref"&gt;8&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:9"&gt;&lt;a href="#fn:9" class="footnote-ref" role="doc-noteref"&gt;9&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:10"&gt;&lt;a href="#fn:10" class="footnote-ref" role="doc-noteref"&gt;10&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;&lt;code&gt;act_runner&lt;/code&gt; из старых инструкций — прежнее имя официального исполнителя &lt;strong&gt;Gitea&lt;/strong&gt;; Gitea переименовала его в Gitea Runner с выпуском 1.0.0. Здесь объект сравнения — &lt;strong&gt;Forgejo Runner&lt;/strong&gt;, из отдельного репозитория &lt;code&gt;forgejo/runner&lt;/code&gt;. Подставлять команды регистрации и настройки одного проекта в инструкцию для другого не стоит. Сам Forgejo точнее описывает цель так:&lt;sup id="fnref1:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:11"&gt;&lt;a href="#fn:11" class="footnote-ref" role="doc-noteref"&gt;11&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:12"&gt;&lt;a href="#fn:12" class="footnote-ref" role="doc-noteref"&gt;12&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;blockquote&gt;&#10;&lt;p&gt;Forgejo Actions strives for familiarity instead of compatibility.&lt;sup id="fnref2:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;/blockquote&gt;&#10;&lt;p&gt;Практический вопрос обзора: что именно надо проверить заново, чтобы CI после переноса давал не только тот же результат тестов, но и ожидаемое разделение полномочий? В отличие от разбора sandbox для coding agents, здесь границу задают также событие и сервер CI; в отличие от разбора воспроизводимости Go-сборок, проверяется путь к публикации, а не равенство бинарников. Для структуры полезны четыре вопроса из работы Koishybayev и соавторов: допуск, контроль исполнения, контроль кода и доступ к секретам.&lt;sup id="fnref:13"&gt;&lt;a href="#fn:13" class="footnote-ref" role="doc-noteref"&gt;13&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="1-допуск-задачи-и-выбор-машины--разные-решения"&gt;&lt;a href="#1-%d0%b4%d0%be%d0%bf%d1%83%d1%81%d0%ba-%d0%b7%d0%b0%d0%b4%d0%b0%d1%87%d0%b8-%d0%b8-%d0%b2%d1%8b%d0%b1%d0%be%d1%80-%d0%bc%d0%b0%d1%88%d0%b8%d0%bd%d1%8b--%d1%80%d0%b0%d0%b7%d0%bd%d1%8b%d0%b5-%d1%80%d0%b5%d1%88%d0%b5%d0%bd%d0%b8%d1%8f" class="post_hash"&gt;1. Допуск задачи и выбор машины — разные решения&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;На Forgejo сервер хранит репозитории и выдаёт задания, а отдельно установленный runner забирает их и исполняет. Runner можно зарегистрировать на уровне инстанса, аккаунта пользователя, организации или одного репозитория. Последняя регистрация ограничивает набор репозиториев, задания которых &lt;em&gt;сможет получить этот runner&lt;/em&gt;, но не убирает из этого репозитория видимые ему раннеры более широкого scope. После выделения release-исполнителя стоит проверить не только наличие нового runner, но и список доступных старых.&lt;sup id="fnref:14"&gt;&lt;a href="#fn:14" class="footnote-ref" role="doc-noteref"&gt;14&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:15"&gt;&lt;a href="#fn:15" class="footnote-ref" role="doc-noteref"&gt;15&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:16"&gt;&lt;a href="#fn:16" class="footnote-ref" role="doc-noteref"&gt;16&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;На GitHub self-hosted runner группы могут ограничивать доступ репозиториям и, при соответствующей политике, workflow. На Forgejo 17.0 регистрация определяет область допуска, а &lt;code&gt;runs-on&lt;/code&gt; сопоставляется с labels. Из нескольких labels нужны все, но среду исполнения определяет &lt;strong&gt;первый&lt;/strong&gt; label в массиве. Label нужен планировщику; он не доказывает, что код доверенный или что job получил ровно заявленный образ: в Docker-режиме workflow может переопределить образ через &lt;code&gt;jobs.&amp;lt;job_id&amp;gt;.container&lt;/code&gt;.&lt;sup id="fnref1:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:15"&gt;&lt;a href="#fn:15" class="footnote-ref" role="doc-noteref"&gt;15&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:17"&gt;&lt;a href="#fn:17" class="footnote-ref" role="doc-noteref"&gt;17&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Например, если сохранить &lt;code&gt;ubuntu-latest&lt;/code&gt;, соответствующий label в конфигурации Forgejo может направлять job в образ с Node.js, а не в образ с инструментами GitHub. На GitHub стандартный &lt;code&gt;ubuntu-latest&lt;/code&gt; соответствует hosted VM; &lt;code&gt;ubuntu-slim&lt;/code&gt; — отдельный runner с контейнерным исполнением. На Forgejo label может выбирать Docker/Podman, LXC или &lt;code&gt;host&lt;/code&gt;, где шаги работают непосредственно на хосте. Сходство ярлыков ничего не говорит ни о наличии компилятора, ни о том, кому принадлежит среда.&lt;sup id="fnref3:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Отказы тоже выглядят по-разному. Forgejo показывает в Actions job без подходящего online runner; справочник описывает остановку до появления исполнителя с нужной меткой. Для GitHub self-hosted документирован отказ после &lt;strong&gt;24 часов&lt;/strong&gt; в очереди. Эти утверждения не устанавливают одинаковых сроков для двух платформ. При переносе полезно отдельно наблюдать возраст очереди и количество подходящих online runners, а не считать отсутствие нового лога синонимом медленной сборки.&lt;sup id="fnref:18"&gt;&lt;a href="#fn:18" class="footnote-ref" role="doc-noteref"&gt;18&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:19"&gt;&lt;a href="#fn:19" class="footnote-ref" role="doc-noteref"&gt;19&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="2-pull-request-что-одобрено-и-откуда-взят-workflow"&gt;&lt;a href="#2-pull-request-%d1%87%d1%82%d0%be-%d0%be%d0%b4%d0%be%d0%b1%d1%80%d0%b5%d0%bd%d0%be-%d0%b8-%d0%be%d1%82%d0%ba%d1%83%d0%b4%d0%b0-%d0%b2%d0%b7%d1%8f%d1%82-workflow" class="post_hash"&gt;2. Pull request: что одобрено и откуда взят workflow&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Forgejo 17.0 требует одобрения для PR из fork или через AGit, если у автора нет подразумеваемого доверия. &lt;code&gt;Approve once&lt;/code&gt; допускает все текущие ожидающие workflows; новый запуск, например после очередного push, снова требует решения. &lt;code&gt;Approve always&lt;/code&gt; доверяет &lt;strong&gt;автору в данном репозитории&lt;/strong&gt;, а не конкретному commit. Это доверие можно отозвать; документация также описывает автоматический отзыв, если автор не подавал pull request более трёх месяцев. Пользователям с указанными в руководстве повышенными правами одобрение не требуется и для PR из fork.&lt;sup id="fnref:20"&gt;&lt;a href="#fn:20" class="footnote-ref" role="doc-noteref"&gt;20&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Допуск не отвечает на вопрос о содержимом. Для доверенного автора Forgejo использует workflow из содержимого PR, кроме &lt;code&gt;pull_request_target&lt;/code&gt;; если PR недоверенного автора, но действие инициировал доверенный пользователь, Forgejo описывает выбор workflow из целевой ветки. Поэтому запись «запустил maintainer» не заменяет ответа на два вопроса: из какой ревизии пришло определение workflow и какую ревизию получил checkout. На GitHub для открытого mergeable PR событие &lt;code&gt;pull_request&lt;/code&gt; по умолчанию даёт &lt;code&gt;refs/pull/.../merge&lt;/code&gt; и SHA тестового merge-коммита. Полагаться на одинаковый SHA или на одинаковые правила подбора ref нельзя: сверяйте фактически проверенное дерево с задуманным сценарием теста.&lt;sup id="fnref1:18"&gt;&lt;a href="#fn:18" class="footnote-ref" role="doc-noteref"&gt;18&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:20"&gt;&lt;a href="#fn:20" class="footnote-ref" role="doc-noteref"&gt;20&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:21"&gt;&lt;a href="#fn:21" class="footnote-ref" role="doc-noteref"&gt;21&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;GitHub.com по умолчанию требует одобрения для first-time contributors и позволяет настроить допуск всех внешних участников строже. Для обычного &lt;code&gt;pull_request&lt;/code&gt; из fork GitHub и Forgejo документируют отсутствие передаваемых секретов репозитория и read-only автоматический токен; у GitHub для private forks есть дополнительные политики, в том числе явная выдача write-токенов и секретов. Эти настройки не стоит переносить по памяти из публичного проекта в частный или обратно.&lt;sup id="fnref2:18"&gt;&lt;a href="#fn:18" class="footnote-ref" role="doc-noteref"&gt;18&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:21"&gt;&lt;a href="#fn:21" class="footnote-ref" role="doc-noteref"&gt;21&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:22"&gt;&lt;a href="#fn:22" class="footnote-ref" role="doc-noteref"&gt;22&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Событие &lt;code&gt;pull_request_target&lt;/code&gt; предназначено для операций в доверенном контексте базового репозитория. Forgejo описывает доступность секретов и write-права автоматического токена для такого события. Обе платформы предостерегают от исполнения кода PR в этом контексте. Для типового проекта разделение проще сформулировать по назначению: проверка исходников PR идёт в непривилегированный контур; метаданные PR обрабатываются отдельно, без исполнения его кода; публикация стартует от принятой ревизии, а не от результата одобрения CI.&lt;sup id="fnref1:16"&gt;&lt;a href="#fn:16" class="footnote-ref" role="doc-noteref"&gt;16&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref3:18"&gt;&lt;a href="#fn:18" class="footnote-ref" role="doc-noteref"&gt;18&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:21"&gt;&lt;a href="#fn:21" class="footnote-ref" role="doc-noteref"&gt;21&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:23"&gt;&lt;a href="#fn:23" class="footnote-ref" role="doc-noteref"&gt;23&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="3-токен-репозитория-регистрация-runner-и-oidc"&gt;&lt;a href="#3-%d1%82%d0%be%d0%ba%d0%b5%d0%bd-%d1%80%d0%b5%d0%bf%d0%be%d0%b7%d0%b8%d1%82%d0%be%d1%80%d0%b8%d1%8f-%d1%80%d0%b5%d0%b3%d0%b8%d1%81%d1%82%d1%80%d0%b0%d1%86%d0%b8%d1%8f-runner-%d0%b8-oidc" class="post_hash"&gt;3. Токен репозитория, регистрация runner и OIDC&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;В Forgejo автоматический токен привязан к репозиторию и уничтожается после завершения workflow; &lt;code&gt;GITHUB_TOKEN&lt;/code&gt; в окружении — совместимое имя для &lt;code&gt;FORGEJO_TOKEN&lt;/code&gt;. На GitHub &lt;code&gt;GITHUB_TOKEN&lt;/code&gt; — installation access token GitHub App, получаемый перед каждым job, с полномочиями в пределах репозитория и собственным сроком действия. В GitHub job-level &lt;code&gt;permissions&lt;/code&gt; меняет права токена этого job; в таблице различий Forgejo 17.0 тот же ключ перечислен как игнорируемый. Сам факт, что файл разобрался и тесты прошли, не подтверждает ограничение прав.&lt;sup id="fnref4:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:16"&gt;&lt;a href="#fn:16" class="footnote-ref" role="doc-noteref"&gt;16&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:24"&gt;&lt;a href="#fn:24" class="footnote-ref" role="doc-noteref"&gt;24&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:25"&gt;&lt;a href="#fn:25" class="footnote-ref" role="doc-noteref"&gt;25&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Регистрационный UUID и token runner — другая пара credentials: она удостоверяет исполнителя перед Forgejo, а не job перед API репозитория. Третий механизм — OIDC ID token, который внешний сервис может обменять на короткоживущие права, если доверяет issuer и проверяет claims. Для выдачи ID token GitHub использует &lt;code&gt;permissions: id-token: write&lt;/code&gt;, Forgejo — &lt;code&gt;enable-openid-connect&lt;/code&gt; на уровне workflow или job. При переносе нужно пересмотреть политику на стороне получателя, как минимум &lt;code&gt;iss&lt;/code&gt;, &lt;code&gt;aud&lt;/code&gt; и &lt;code&gt;sub&lt;/code&gt;, а не только исправить ключ YAML.&lt;sup id="fnref5:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:15"&gt;&lt;a href="#fn:15" class="footnote-ref" role="doc-noteref"&gt;15&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:26"&gt;&lt;a href="#fn:26" class="footnote-ref" role="doc-noteref"&gt;26&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Есть причина проверить OIDC даже при обновлении внутри Forgejo. Документация 17.0 различает старый вид &lt;code&gt;sub&lt;/code&gt; с именами владельца и репозитория и новый с числовыми ID, в зависимости от того, когда в репозитории включили Actions. Отключение и повторное включение Actions может перевести старый репозиторий на новый формат необратимо. Если релизная роль сопоставляет &lt;code&gt;sub&lt;/code&gt; точно, такая смена — изменение условий доступа, а не косметика. Перед изменением полезно записать ожидаемые claims и проверить способность доверенного job получить только нужную роль; сам JWT в логах для этого не нужен.&lt;sup id="fnref1:26"&gt;&lt;a href="#fn:26" class="footnote-ref" role="doc-noteref"&gt;26&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="4-что-очищается-после-job-а-что-остаётся"&gt;&lt;a href="#4-%d1%87%d1%82%d0%be-%d0%be%d1%87%d0%b8%d1%89%d0%b0%d0%b5%d1%82%d1%81%d1%8f-%d0%bf%d0%be%d1%81%d0%bb%d0%b5-job-%d0%b0-%d1%87%d1%82%d0%be-%d0%be%d1%81%d1%82%d0%b0%d1%91%d1%82%d1%81%d1%8f" class="post_hash"&gt;4. Что очищается после job, а что остаётся&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;В Forgejo ephemeral-режим означает, что сервер назначает registration &lt;strong&gt;не более одного job&lt;/strong&gt;. Это свойство выдачи задач; из него не следует удаление VM, рабочего диска или внешнего cache. GitHub тоже выделяет одноразовый self-hosted runner, но описывает чистую среду как результат вашей автоматизации. Сравнивать стоит по слою: на hosted GitHub платформа создаёт среду, на обеих self-hosted схемах оператор решает, уничтожена ли машина или лишь регистрация.&lt;sup id="fnref2:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref3:15"&gt;&lt;a href="#fn:15" class="footnote-ref" role="doc-noteref"&gt;15&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:19"&gt;&lt;a href="#fn:19" class="footnote-ref" role="doc-noteref"&gt;19&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:23"&gt;&lt;a href="#fn:23" class="footnote-ref" role="doc-noteref"&gt;23&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:27"&gt;&lt;a href="#fn:27" class="footnote-ref" role="doc-noteref"&gt;27&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Docker-контейнер облегчает раздельный запуск и чистый workspace. Он не превращает socket контейнерного движка, выделенный writable volume или маршрут в служебную сеть в безопасные ресурсы. Руководство Forgejo отдельно отмечает, что обычному job-контейнеру доступ к Docker socket не выдаётся; для сборок образов его или отдельный build engine нужно организовать специально. Docker рекомендует разрешать управление daemon только доверенным пользователям. По этой причине запрос «добавить Docker в тесты» стоит рассматривать как изменение полномочий, а не как установку ещё одного пакета.&lt;sup id="fnref3:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:27"&gt;&lt;a href="#fn:27" class="footnote-ref" role="doc-noteref"&gt;27&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:28"&gt;&lt;a href="#fn:28" class="footnote-ref" role="doc-noteref"&gt;28&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:29"&gt;&lt;a href="#fn:29" class="footnote-ref" role="doc-noteref"&gt;29&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Для небольшого приватного проекта, где все, кто может менять job, уже администрируют его выделенный хост, постоянный runner может быть разумным: меньше инфраструктуры и быстрее повторные сборки за счёт состояния между прогонами. Для публичных PR это не то допущение. Предпочтительны отдельные одноразовые среды без доступа к release-секретам и закрытой сети; release runner — отдельный контур, не соседний label на той же машине. Если такую границу обеспечить нельзя, оставить публичные проверки на managed CI или не допускать исполнение внешних PR на своих машинах — полноценные варианты, а не незавершённая миграция.&lt;sup id="fnref4:15"&gt;&lt;a href="#fn:15" class="footnote-ref" role="doc-noteref"&gt;15&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:23"&gt;&lt;a href="#fn:23" class="footnote-ref" role="doc-noteref"&gt;23&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:27"&gt;&lt;a href="#fn:27" class="footnote-ref" role="doc-noteref"&gt;27&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:29"&gt;&lt;a href="#fn:29" class="footnote-ref" role="doc-noteref"&gt;29&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="5-actions-cache-и-artifacts-переносятся-по-разным-правилам"&gt;&lt;a href="#5-actions-cache-%d0%b8-artifacts-%d0%bf%d0%b5%d1%80%d0%b5%d0%bd%d0%be%d1%81%d1%8f%d1%82%d1%81%d1%8f-%d0%bf%d0%be-%d1%80%d0%b0%d0%b7%d0%bd%d1%8b%d0%bc-%d0%bf%d1%80%d0%b0%d0%b2%d0%b8%d0%bb%d0%b0%d0%bc" class="post_hash"&gt;5. Actions, cache и artifacts переносятся по разным правилам&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Для Forgejo &lt;code&gt;uses: actions/checkout@v7&lt;/code&gt; — сокращение, которое разворачивается через &lt;code&gt;DEFAULT_ACTIONS_URL&lt;/code&gt; (по умолчанию это сервис Forgejo &lt;code&gt;data.forgejo.org&lt;/code&gt;). Руководство рекомендует полные URL. Но полного URL недостаточно, чтобы зафиксировать содержимое: рекомендация GitHub для сторонних actions — полный commit SHA из проверенного репозитория. При переносе этот порядок важен: сначала определить, откуда теперь берётся action, затем закрепить именно проверенную ревизию оттуда и проверить её зависимости. Даже официальный пример &lt;code&gt;checkout&lt;/code&gt; зависит от наличия Node.js в выбранном образе.&lt;sup id="fnref1:14"&gt;&lt;a href="#fn:14" class="footnote-ref" role="doc-noteref"&gt;14&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref3:23"&gt;&lt;a href="#fn:23" class="footnote-ref" role="doc-noteref"&gt;23&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:30"&gt;&lt;a href="#fn:30" class="footnote-ref" role="doc-noteref"&gt;30&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Artifacts и cache различаются по смыслу. На Forgejo сервер хранит job logs и artifacts с дефолтами &lt;strong&gt;365 и 90 дней&lt;/strong&gt; соответственно; cache хранит runner, не сервер Forgejo. Руководство 17.0 для upload/download artifacts указывает v3 или адаптированную v4. У GitHub cache имеет свою область поиска по refs; это документированные гарантии GitHub, не обещание реализации Forgejo. Для передачи выпускаемого файла между job используйте artifact с проверкой происхождения, а отсутствие cache рассматривайте как допустимый холодный старт, не как повод использовать другой бинарник.&lt;sup id="fnref2:14"&gt;&lt;a href="#fn:14" class="footnote-ref" role="doc-noteref"&gt;14&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:31"&gt;&lt;a href="#fn:31" class="footnote-ref" role="doc-noteref"&gt;31&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:32"&gt;&lt;a href="#fn:32" class="footnote-ref" role="doc-noteref"&gt;32&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:33"&gt;&lt;a href="#fn:33" class="footnote-ref" role="doc-noteref"&gt;33&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Практическое следствие: при одноразовой VM с локальным cache каждый прогон нужно считать холодным, пока не добавлено хранилище, переживающее её уничтожение. Если оно необходимо, границы доверия к записям нужно проектировать вместе с границами между PR и релизом. Папка или ключ с названием &lt;code&gt;release&lt;/code&gt; сам по себе не даёт такого разделения. Пусть релиз проходит при пустом cache, а обязательный продукт сборки передаётся как явно названный artifact того же workflow; это разделяет отказ оптимизации и потерю входа для следующего этапа.&lt;sup id="fnref3:14"&gt;&lt;a href="#fn:14" class="footnote-ref" role="doc-noteref"&gt;14&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:31"&gt;&lt;a href="#fn:31" class="footnote-ref" role="doc-noteref"&gt;31&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:32"&gt;&lt;a href="#fn:32" class="footnote-ref" role="doc-noteref"&gt;32&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:33"&gt;&lt;a href="#fn:33" class="footnote-ref" role="doc-noteref"&gt;33&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="6-что-принять-при-миграции"&gt;&lt;a href="#6-%d1%87%d1%82%d0%be-%d0%bf%d1%80%d0%b8%d0%bd%d1%8f%d1%82%d1%8c-%d0%bf%d1%80%d0%b8-%d0%bc%d0%b8%d0%b3%d1%80%d0%b0%d1%86%d0%b8%d0%b8" class="post_hash"&gt;6. Что принять при миграции&lt;/a&gt;&lt;/h2&gt;&#10;&lt;ol&gt;&#10;&lt;li&gt;&#10;&lt;p&gt;&lt;strong&gt;Фиксировать входы.&lt;/strong&gt; Записать версию Forgejo и runner, разрешённые типы событий, происхождение workflow и checkout, точные ревизии actions и digest образа. Валидацию синтаксиса Forgejo Runner использовать как отдельную проверку, не как подтверждение исполнения. Например, Runner 13.0 стал отклонять ряд ранее допускавшихся ошибок выражений и matrix, а старые команды &lt;code&gt;set-output&lt;/code&gt; и &lt;code&gt;add-path&lt;/code&gt; больше не меняют состояние шагов.&lt;sup id="fnref4:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:10"&gt;&lt;a href="#fn:10" class="footnote-ref" role="doc-noteref"&gt;10&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:30"&gt;&lt;a href="#fn:30" class="footnote-ref" role="doc-noteref"&gt;30&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:34"&gt;&lt;a href="#fn:34" class="footnote-ref" role="doc-noteref"&gt;34&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li&gt;&#10;&lt;p&gt;&lt;strong&gt;Сверить полномочия до включения публикации.&lt;/strong&gt; Собрать для PR и релиза отдельные строки «событие → источник workflow/checkout → доступные runners → credentials → разрешённые внешние системы». Для проверки использовать только обычный тестовый репозиторий и специальные непродуктивные credentials, не переносить действующие секреты в первый пробный run. Принятый PR и одобренный workflow — разные записи; вторая не должна давать первой право публиковать.&lt;sup id="fnref5:15"&gt;&lt;a href="#fn:15" class="footnote-ref" role="doc-noteref"&gt;15&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref4:18"&gt;&lt;a href="#fn:18" class="footnote-ref" role="doc-noteref"&gt;18&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:20"&gt;&lt;a href="#fn:20" class="footnote-ref" role="doc-noteref"&gt;20&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref4:23"&gt;&lt;a href="#fn:23" class="footnote-ref" role="doc-noteref"&gt;23&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:26"&gt;&lt;a href="#fn:26" class="footnote-ref" role="doc-noteref"&gt;26&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li&gt;&#10;&lt;p&gt;&lt;strong&gt;Отдельно принять отказ и восстановление.&lt;/strong&gt; В тестовом контуре заранее определить, кто замечает пропажу runner, куда попадут его диагностические логи, сколько живут artifacts и что должно собираться с нуля. Приёмка должна показать ожидаемый результат на том же commit, действие ограничения доступа и понятный способ отката. Если нужно откатить перенос, прежний CI остаётся независимым путём, а не одновременно действующим вторым издателем того же релиза.&lt;sup id="fnref4:14"&gt;&lt;a href="#fn:14" class="footnote-ref" role="doc-noteref"&gt;14&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:19"&gt;&lt;a href="#fn:19" class="footnote-ref" role="doc-noteref"&gt;19&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref3:27"&gt;&lt;a href="#fn:27" class="footnote-ref" role="doc-noteref"&gt;27&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:31"&gt;&lt;a href="#fn:31" class="footnote-ref" role="doc-noteref"&gt;31&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:34"&gt;&lt;a href="#fn:34" class="footnote-ref" role="doc-noteref"&gt;34&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;/ol&gt;&#10;&lt;h2 id="дискуссионные-вопросы-и-противоречия"&gt;&lt;a href="#%d0%b4%d0%b8%d1%81%d0%ba%d1%83%d1%81%d1%81%d0%b8%d0%be%d0%bd%d0%bd%d1%8b%d0%b5-%d0%b2%d0%be%d0%bf%d1%80%d0%be%d1%81%d1%8b-%d0%b8-%d0%bf%d1%80%d0%be%d1%82%d0%b8%d0%b2%d0%be%d1%80%d0%b5%d1%87%d0%b8%d1%8f" class="post_hash"&gt;Дискуссионные вопросы и противоречия&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;&lt;strong&gt;«Почти тот же YAML» и «не совместим».&lt;/strong&gt; Обе оценки встречаются в позиции самого Forgejo: привычные шаги и reusable workflows часто переносятся с небольшими правками, но проект не обещает идентичность семантики. Это не спор о том, читается ли YAML. Различия &lt;code&gt;permissions&lt;/code&gt;, &lt;code&gt;enable-openid-connect&lt;/code&gt;, источника &lt;code&gt;uses&lt;/code&gt; и среды &lt;code&gt;runs-on&lt;/code&gt; затрагивают то, чего не проверяет тест прикладного кода. Простой &lt;code&gt;push&lt;/code&gt; с тестами и путь публикации с внешними credentials стоит принимать раздельно.&lt;sup id="fnref6:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref5:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref3:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref3:26"&gt;&lt;a href="#fn:26" class="footnote-ref" role="doc-noteref"&gt;26&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:30"&gt;&lt;a href="#fn:30" class="footnote-ref" role="doc-noteref"&gt;30&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;«Сканер пропустил — значит безопасно».&lt;/strong&gt; Fares, Gamage и Baudry сравнили девять статических сканеров на 2 722 GitHub workflows и отдельно проверили точность на 54 размеченных workflows. Ни один сканер не покрывал все выделенные классы, а сравнимые по назначению правила различались по точности и полноте. Это данные о GitHub и конкретной выборке, не оценка риска Forgejo. Но методологический вывод полезен: логика workflow, фактическая конфигурация runner и политика допуска — разные объекты проверки; один отчёт анализатора не оценивает их все.&lt;sup id="fnref2:34"&gt;&lt;a href="#fn:34" class="footnote-ref" role="doc-noteref"&gt;34&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:35"&gt;&lt;a href="#fn:35" class="footnote-ref" role="doc-noteref"&gt;35&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="недостаточность-данных"&gt;&lt;a href="#%d0%bd%d0%b5%d0%b4%d0%be%d1%81%d1%82%d0%b0%d1%82%d0%be%d1%87%d0%bd%d0%be%d1%81%d1%82%d1%8c-%d0%b4%d0%b0%d0%bd%d0%bd%d1%8b%d1%85" class="post_hash"&gt;Недостаточность данных&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;В просмотренных источниках нет сопоставимых замеров старта job, доли промахов cache, эксплуатационных затрат или частоты инцидентов для Forgejo Runner 13.2.1 и GitHub при одинаковой нагрузке и границе изоляции. Работа USENIX Security 2022 описывает исторический корпус, а препринт 2026 года оценивает сканеры, а не частоту инцидентов. Заявлять, что self-hosting дешевле или что одна платформа безопаснее другой, эти данные не позволяют. Отдельно не проверялись внешние execution plugins: объявление Runner 13.1.0 маркирует их как экспериментальные.&lt;sup id="fnref1:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:13"&gt;&lt;a href="#fn:13" class="footnote-ref" role="doc-noteref"&gt;13&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:35"&gt;&lt;a href="#fn:35" class="footnote-ref" role="doc-noteref"&gt;35&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:36"&gt;&lt;a href="#fn:36" class="footnote-ref" role="doc-noteref"&gt;36&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="заключение"&gt;&lt;a href="#%d0%b7%d0%b0%d0%ba%d0%bb%d1%8e%d1%87%d0%b5%d0%bd%d0%b8%d0%b5" class="post_hash"&gt;Заключение&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Forgejo Actions разумно оценивать как систему допуска и исполнения со знакомым языком workflow. Практический минимум при переносе — проверить реальный checkout и образ, не доверять перенесённым &lt;code&gt;permissions&lt;/code&gt; без проверки и сохранить жёсткую границу между проверкой внешнего PR и публикацией. Выделенный runner помогает ровно настолько, насколько ограничены его регистрация, сеть, тома и доступные credentials. Одноразовый runner добавляет ограничение на число job, а чистую машину должен обеспечить тот, кто её выдаёт.&lt;sup id="fnref7:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref6:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref6:15"&gt;&lt;a href="#fn:15" class="footnote-ref" role="doc-noteref"&gt;15&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref3:19"&gt;&lt;a href="#fn:19" class="footnote-ref" role="doc-noteref"&gt;19&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref3:20"&gt;&lt;a href="#fn:20" class="footnote-ref" role="doc-noteref"&gt;20&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref4:26"&gt;&lt;a href="#fn:26" class="footnote-ref" role="doc-noteref"&gt;26&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref4:27"&gt;&lt;a href="#fn:27" class="footnote-ref" role="doc-noteref"&gt;27&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Начните с job, который только собирает и тестирует код, без доступа к публикации. Измерьте ожидание в очереди и холодный запуск на своём парке, затем отдельно проверьте путь выпуска. Зелёный тест подтверждает результат проверки кода, но ничего не говорит о правах следующего job.&lt;sup id="fnref5:18"&gt;&lt;a href="#fn:18" class="footnote-ref" role="doc-noteref"&gt;18&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref4:19"&gt;&lt;a href="#fn:19" class="footnote-ref" role="doc-noteref"&gt;19&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref5:23"&gt;&lt;a href="#fn:23" class="footnote-ref" role="doc-noteref"&gt;23&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref3:31"&gt;&lt;a href="#fn:31" class="footnote-ref" role="doc-noteref"&gt;31&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="quality-metrics"&gt;&lt;a href="#quality-metrics" class="post_hash"&gt;Quality Metrics&lt;/a&gt;&lt;/h2&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Metric&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th style="text-align: right"&gt;Value&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Sources found&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;133&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Sources read&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;36&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Sources cited&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;36&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Academic sources&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;2&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Official/documentation&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;34&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Citation coverage&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;100% (31/31)&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Words (article text, without frontmatter, metrics and footnotes)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;2152&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Count units&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;Found: уникальные URL кандидатов; read/cited: отдельные документы без повторного счёта зеркал и представлений&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Access scope&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;Документация и release notes; USENIX 2022 — аннотация; arXiv 2026 — аннотация, метод и результаты&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Counter-arguments searched&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;Yes&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Research rounds&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;3&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Questions emerged&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;3&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Questions resolved&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;2&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Questions insufficient data&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td style="text-align: right"&gt;1&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;div class="footnotes" role="doc-endnotes"&gt;&#10;&lt;hr&gt;&#10;&lt;ol&gt;&#10;&lt;li id="fn:1"&gt;&#10;&lt;p&gt;Forgejo. «Forgejo Actions | GitHub Actions». Документация 17.0. &lt;a href="https://forgejo.org/docs/v17.0/user/actions/github-actions/"&gt;https://forgejo.org/docs/v17.0/user/actions/github-actions/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref7:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:2"&gt;&#10;&lt;p&gt;Forgejo. «Forgejo Runner Configuration». Документация 17.0. &lt;a href="https://forgejo.org/docs/v17.0/admin/actions/configuration/"&gt;https://forgejo.org/docs/v17.0/admin/actions/configuration/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:3"&gt;&#10;&lt;p&gt;GitHub. «GitHub-hosted runners reference». Срез 2026-11-18. &lt;a href="https://docs.github.com/en/actions/reference/runners/github-hosted-runners"&gt;https://docs.github.com/en/actions/reference/runners/github-hosted-runners&lt;/a&gt;&amp;#160;&lt;a href="#fnref:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:4"&gt;&#10;&lt;p&gt;GitHub. «Workflow syntax for GitHub Actions». Срез 2026-11-18. &lt;a href="https://docs.github.com/en/actions/reference/workflows-and-actions/workflow-syntax"&gt;https://docs.github.com/en/actions/reference/workflows-and-actions/workflow-syntax&lt;/a&gt;&amp;#160;&lt;a href="#fnref:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:5"&gt;&#10;&lt;p&gt;Forgejo. «v17.0.1 - forgejo/forgejo - Codeberg.org». 2026-10-26. &lt;a href="https://codeberg.org/forgejo/forgejo/releases/tag/v17.0.1"&gt;https://codeberg.org/forgejo/forgejo/releases/tag/v17.0.1&lt;/a&gt;&amp;#160;&lt;a href="#fnref:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:6"&gt;&#10;&lt;p&gt;Forgejo. «Releases — Forgejo». Срез 2026-11-18. &lt;a href="https://forgejo.org/releases/"&gt;https://forgejo.org/releases/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:6" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:6" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:7"&gt;&#10;&lt;p&gt;Forgejo. «v13.2.1 - forgejo/runner». 2026-10-29. &lt;a href="https://code.forgejo.org/forgejo/runner/releases/tag/v13.2.1"&gt;https://code.forgejo.org/forgejo/runner/releases/tag/v13.2.1&lt;/a&gt;&amp;#160;&lt;a href="#fnref:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:8"&gt;&#10;&lt;p&gt;Forgejo. «Forgejo v17.0 is available». 2026-10-15. &lt;a href="https://forgejo.org/2026-10-release-v17-0/"&gt;https://forgejo.org/2026-10-release-v17-0/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:8" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:8" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:9"&gt;&#10;&lt;p&gt;Forgejo. «Forgejo v16.0 is available». 2026-07-16. &lt;a href="https://forgejo.org/2026-07-release-v16-0/"&gt;https://forgejo.org/2026-07-release-v16-0/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:9" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:10"&gt;&#10;&lt;p&gt;Forgejo. «Forgejo Runner v13.0.0 is available». 2026-08-03. &lt;a href="https://forgejo.org/2026-08-runner-release-v13/"&gt;https://forgejo.org/2026-08-runner-release-v13/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:10" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:10" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:11"&gt;&#10;&lt;p&gt;Gitea. «Gitea Runner 1.0.0 is released». 2026-05-05. &lt;a href="https://blog.gitea.com/release-of-runner-1.0.0/"&gt;https://blog.gitea.com/release-of-runner-1.0.0/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:11" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:12"&gt;&#10;&lt;p&gt;Forgejo. «Forgejo Runner». README, тег v13.2.1. &lt;a href="https://code.forgejo.org/forgejo/runner/src/tag/v13.2.1"&gt;https://code.forgejo.org/forgejo/runner/src/tag/v13.2.1&lt;/a&gt;&amp;#160;&lt;a href="#fnref:12" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:13"&gt;&#10;&lt;p&gt;Igibek Koishybayev et al. «Characterizing the Security of Github CI Workflows». USENIX Security, 2022. &lt;a href="https://www.usenix.org/conference/usenixsecurity22/presentation/koishybayev"&gt;https://www.usenix.org/conference/usenixsecurity22/presentation/koishybayev&lt;/a&gt;&amp;#160;&lt;a href="#fnref:13" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:13" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:14"&gt;&#10;&lt;p&gt;Forgejo. «Forgejo Actions administrator guide». Документация 17.0. &lt;a href="https://forgejo.org/docs/v17.0/admin/actions/"&gt;https://forgejo.org/docs/v17.0/admin/actions/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:14" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:14" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:14" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:14" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:14" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:15"&gt;&#10;&lt;p&gt;Forgejo. «Forgejo Runner Registration». Документация 17.0. &lt;a href="https://forgejo.org/docs/v17.0/admin/actions/registration/"&gt;https://forgejo.org/docs/v17.0/admin/actions/registration/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:15" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:15" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:15" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:15" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:15" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:15" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:15" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:16"&gt;&#10;&lt;p&gt;Forgejo. «Forgejo Actions | Security». Документация 17.0. &lt;a href="https://forgejo.org/docs/v17.0/user/actions/security/"&gt;https://forgejo.org/docs/v17.0/user/actions/security/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:16" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:16" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:16" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:17"&gt;&#10;&lt;p&gt;GitHub. «Managing access to self-hosted runners using groups». Срез 2026-11-18. &lt;a href="https://docs.github.com/en/actions/how-tos/manage-runners/self-hosted-runners/manage-access"&gt;https://docs.github.com/en/actions/how-tos/manage-runners/self-hosted-runners/manage-access&lt;/a&gt;&amp;#160;&lt;a href="#fnref:17" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:18"&gt;&#10;&lt;p&gt;Forgejo. «Forgejo Actions | Reference». Документация 17.0. &lt;a href="https://forgejo.org/docs/v17.0/user/actions/reference/"&gt;https://forgejo.org/docs/v17.0/user/actions/reference/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:18" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:18" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:18" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:18" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:18" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:18" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:19"&gt;&#10;&lt;p&gt;GitHub. «Self-hosted runners reference». Срез 2026-11-18. &lt;a href="https://docs.github.com/en/actions/reference/runners/self-hosted-runners"&gt;https://docs.github.com/en/actions/reference/runners/self-hosted-runners&lt;/a&gt;&amp;#160;&lt;a href="#fnref:19" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:19" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:19" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:19" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:19" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:20"&gt;&#10;&lt;p&gt;Forgejo. «Forgejo Actions | Security of Pull Requests». Документация 17.0. &lt;a href="https://forgejo.org/docs/v17.0/user/actions/security-pull-request/"&gt;https://forgejo.org/docs/v17.0/user/actions/security-pull-request/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:20" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:20" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:20" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:20" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:21"&gt;&#10;&lt;p&gt;GitHub. «Events that trigger workflows». Срез 2026-11-18. &lt;a href="https://docs.github.com/en/actions/reference/workflows-and-actions/events-that-trigger-workflows"&gt;https://docs.github.com/en/actions/reference/workflows-and-actions/events-that-trigger-workflows&lt;/a&gt;&amp;#160;&lt;a href="#fnref:21" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:21" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:21" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:22"&gt;&#10;&lt;p&gt;GitHub. «Managing GitHub Actions settings for a repository». Срез 2026-11-18. &lt;a href="https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository"&gt;https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository&lt;/a&gt;&amp;#160;&lt;a href="#fnref:22" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:23"&gt;&#10;&lt;p&gt;GitHub. «Secure use reference». Срез 2026-11-18. &lt;a href="https://docs.github.com/en/actions/reference/security/secure-use"&gt;https://docs.github.com/en/actions/reference/security/secure-use&lt;/a&gt;&amp;#160;&lt;a href="#fnref:23" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:23" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:23" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:23" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:23" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:23" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:24"&gt;&#10;&lt;p&gt;Forgejo. «Forgejo Actions | Basic concepts». Документация 17.0. &lt;a href="https://forgejo.org/docs/v17.0/user/actions/basic-concepts/"&gt;https://forgejo.org/docs/v17.0/user/actions/basic-concepts/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:24" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:25"&gt;&#10;&lt;p&gt;GitHub. «GITHUB_TOKEN». Срез 2026-11-18. &lt;a href="https://docs.github.com/en/actions/concepts/security/github_token"&gt;https://docs.github.com/en/actions/concepts/security/github_token&lt;/a&gt;&amp;#160;&lt;a href="#fnref:25" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:26"&gt;&#10;&lt;p&gt;Forgejo. «Forgejo Actions | Security OpenID Connect». Документация 17.0. &lt;a href="https://forgejo.org/docs/v17.0/user/actions/security-openid-connect/"&gt;https://forgejo.org/docs/v17.0/user/actions/security-openid-connect/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:26" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:26" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:26" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:26" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:26" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:27"&gt;&#10;&lt;p&gt;Forgejo. «Securing Forgejo Actions Deployments». Документация 17.0. &lt;a href="https://forgejo.org/docs/v17.0/admin/actions/security/"&gt;https://forgejo.org/docs/v17.0/admin/actions/security/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:27" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:27" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:27" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:27" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:27" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:28"&gt;&#10;&lt;p&gt;Forgejo. «Utilizing Docker within Actions». Документация 17.0. &lt;a href="https://forgejo.org/docs/v17.0/admin/actions/docker-access/"&gt;https://forgejo.org/docs/v17.0/admin/actions/docker-access/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:28" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:29"&gt;&#10;&lt;p&gt;Docker. «Docker Engine security». Срез 2026-11-18. &lt;a href="https://docs.docker.com/engine/security/"&gt;https://docs.docker.com/engine/security/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:29" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:29" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:30"&gt;&#10;&lt;p&gt;Forgejo. «Forgejo Actions | Using Actions». Документация 17.0. &lt;a href="https://forgejo.org/docs/v17.0/user/actions/actions/"&gt;https://forgejo.org/docs/v17.0/user/actions/actions/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:30" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:30" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:30" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:31"&gt;&#10;&lt;p&gt;Forgejo. «Forgejo Actions | Advanced features». Документация 17.0. &lt;a href="https://forgejo.org/docs/v17.0/user/actions/advanced-features/"&gt;https://forgejo.org/docs/v17.0/user/actions/advanced-features/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:31" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:31" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:31" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:31" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:32"&gt;&#10;&lt;p&gt;GitHub. «Dependency caching reference». Срез 2026-11-18. &lt;a href="https://docs.github.com/en/actions/reference/workflows-and-actions/dependency-caching"&gt;https://docs.github.com/en/actions/reference/workflows-and-actions/dependency-caching&lt;/a&gt;&amp;#160;&lt;a href="#fnref:32" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:32" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:33"&gt;&#10;&lt;p&gt;GitHub. «Workflow artifacts». Срез 2026-11-18. &lt;a href="https://docs.github.com/en/actions/concepts/workflows-and-actions/workflow-artifacts"&gt;https://docs.github.com/en/actions/concepts/workflows-and-actions/workflow-artifacts&lt;/a&gt;&amp;#160;&lt;a href="#fnref:33" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:33" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:34"&gt;&#10;&lt;p&gt;Forgejo. «Forgejo Actions | Troubleshooting». Документация 17.0. &lt;a href="https://forgejo.org/docs/v17.0/user/actions/troubleshooting/"&gt;https://forgejo.org/docs/v17.0/user/actions/troubleshooting/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:34" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:34" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:34" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:35"&gt;&#10;&lt;p&gt;Madjda Fares, Yogya Gamage, Benoit Baudry. «Unpacking Security Scanners for GitHub Actions Workflows». arXiv:2601.14455v3, 2026-10-19. &lt;a href="https://arxiv.org/html/2601.14455v3"&gt;https://arxiv.org/html/2601.14455v3&lt;/a&gt;&amp;#160;&lt;a href="#fnref:35" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:35" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:36"&gt;&#10;&lt;p&gt;Forgejo. «Forgejo Runner v13.1.0 is available». 2026-09-03. &lt;a href="https://forgejo.org/2026-09-runner-release-v131/"&gt;https://forgejo.org/2026-09-runner-release-v131/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:36" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;/ol&gt;&#10;&lt;/div&gt;&#10;</content></entry><entry><title>S3-совместимое хранилище после MinIO: что на самом деле гарантирует «S3 API»</title><id>https://research.evsyukov.org/articles/s3-object-storage-after-minio/</id><link href="https://research.evsyukov.org/articles/s3-object-storage-after-minio/" rel="alternate" type="text/html"/><published>2026-11-17T09:38:00+03:00</published><updated>2026-11-17T09:41:04+03:00</updated><author><name>Denis Evsyukov</name></author><summary type="html">MinIO CE заархивирован, а «S3-совместимость» — это подмножество операций: что из этого следует для restic и rclone и чем Garage, SeaweedFS и Ceph RGW платят за разные ответы.</summary><content type="html">&lt;h2 id="аннотация"&gt;&lt;a href="#%d0%b0%d0%bd%d0%bd%d0%be%d1%82%d0%b0%d1%86%d0%b8%d1%8f" class="post_hash"&gt;Аннотация&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;25 апреля 2026 года репозиторий &lt;code&gt;minio/minio&lt;/code&gt; заархивирован, Community Edition распространяется только исходным кодом, а последний релиз — security-фикс от 15 октября 2025 года. Те, кто держал MinIO как «просто S3 endpoint» для бэкапов, остались с замороженным сервером и необходимостью выбирать заново — уже без привычного default-варианта.&lt;sup id="fnref:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Главный вывод этого обзора: «S3-совместимость» — не бинарный признак и не сертификат, а список операций, который каждый проект ведёт сам. Публичной сертификации соответствия S3 API нет; де-факто роль общей мерки играет неофициальный набор тестов, который больше не поддерживается отдельно.&lt;sup id="fnref:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt; Поэтому выбор делается не по логотипу «S3-compatible», а по тому, какие операции нужны вашему клиенту и что проект обещает про неизменяемость, версии и удаление.&lt;/p&gt;&#10;&lt;p&gt;Разбираются четыре реализации: MinIO CE в последнем доступном состоянии, Garage 2.5.0, SeaweedFS 4.54 и Ceph RGW 20.2.5 (Tentacle). Точка зрения — self-hosted парк на одном-трёх серверах, один администратор, клиенты restic 0.19.1 и rclone. Данные и версии — на &lt;strong&gt;17 ноября 2026 года&lt;/strong&gt;. Собственных замеров производительности здесь нет: числа из документации проектов приводятся только как заявления, а не как результат сравнения.&lt;/p&gt;&#10;&lt;h2 id="введение"&gt;&lt;a href="#%d0%b2%d0%b2%d0%b5%d0%b4%d0%b5%d0%bd%d0%b8%d0%b5" class="post_hash"&gt;Введение&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;&lt;strong&gt;Актуальность.&lt;/strong&gt; MinIO несколько лет был ответом по умолчанию на вопрос «где взять S3 для restic». Один бинарник, один контейнер, &lt;code&gt;mc alias set&lt;/code&gt; — и бэкап пишется в бакет. Пока этот путь работал, разбираться в различиях реализаций было незачем: клиенты вели себя одинаково, потому что одинаковым был сервер. После ухода MinIO из открытой разработки одинаковым быть перестало: Garage, SeaweedFS и Ceph отвечают на одни и те же запросы по-разному, и часть различий лежит ровно там, где проходит граница бэкапа — версии объектов, блокировки, право на удаление.&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;Цель&lt;/strong&gt; — показать, что именно обещает фраза «S3 API», и сравнить три живых реализации по операциям, которые реально используют restic и rclone. Не «какой проект лучше», а «какой набор гарантий вы получаете и чем за него платите».&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;Границы.&lt;/strong&gt; Не рассматриваются производительность и стоимость владения: сопоставимых независимых замеров для закреплённых версий нет, а vendor-бенчмарки несопоставимы по железу. Не разбираются Kubernetes-операторы, файловые шлюзы, tiering и облачные тарифы. Версии закреплены: Garage &lt;strong&gt;v2.5.0&lt;/strong&gt; (24 октября 2026), SeaweedFS &lt;strong&gt;4.54&lt;/strong&gt;, Ceph &lt;strong&gt;20.2.5 Tentacle&lt;/strong&gt; (2 ноября 2026), MinIO CE — последний опубликованный релиз &lt;strong&gt;RELEASE.2025-10-15T17-29-55Z&lt;/strong&gt;.&lt;sup id="fnref:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:6"&gt;&lt;a href="#fn:6" class="footnote-ref" role="doc-noteref"&gt;6&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="1-s3-совместимость--это-список-операций-а-не-сертификат"&gt;&lt;a href="#1-s3-%d1%81%d0%be%d0%b2%d0%bc%d0%b5%d1%81%d1%82%d0%b8%d0%bc%d0%be%d1%81%d1%82%d1%8c--%d1%8d%d1%82%d0%be-%d1%81%d0%bf%d0%b8%d1%81%d0%be%d0%ba-%d0%be%d0%bf%d0%b5%d1%80%d0%b0%d1%86%d0%b8%d0%b9-%d0%b0-%d0%bd%d0%b5-%d1%81%d0%b5%d1%80%d1%82%d0%b8%d1%84%d0%b8%d0%ba%d0%b0%d1%82" class="post_hash"&gt;1. «S3-совместимость» — это список операций, а не сертификат&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Ceph формулирует общую рамку аккуратнее многих: «Ceph supports a RESTful API that is compatible with the basic data access model of the Amazon S3 API» — совместимость с &lt;em&gt;базовой моделью доступа&lt;/em&gt;, а не с API целиком.&lt;sup id="fnref:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt; Это честная формулировка, и она применима к любому проекту: S3 — это HTTP-интерфейс с подписью SigV4 и набором операций над бакетами и объектами, и каждый проект реализует своё подмножество.&lt;/p&gt;&#10;&lt;p&gt;Публичной сертификации, которая подтверждала бы «этот сервер реализует S3», нет. Де-факто общей меркой стал набор &lt;code&gt;ceph/s3-tests&lt;/code&gt;, но он сам называет себя «a set of unofficial Amazon AWS S3 compatibility tests», а его репозиторий сообщает, что тесты переехали в &lt;code&gt;ceph/ceph&lt;/code&gt; и больше здесь не поддерживаются.&lt;sup id="fnref1:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt; Иначе говоря, единого арбитра нет: соответствие подтверждается тем, что набор тестов прошёл в CI у конкретного проекта, а не независимой проверкой.&lt;/p&gt;&#10;&lt;p&gt;Отсюда практическое следствие: заявление о совместимости надо читать как матрицу «операция × проект». Garage ведёт такую матрицу открыто — и там же признаёт, что сравнивать с MinIO не с чем: «Minio is missing because they do not provide a public S3 compatibility list».&lt;sup id="fnref:8"&gt;&lt;a href="#fn:8" class="footnote-ref" role="doc-noteref"&gt;8&lt;/a&gt;&lt;/sup&gt; SeaweedFS ведёт свою таблицу и в README называет себя «The most complete S3 API», перечисляя 73 операции уровня bucket/object.&lt;sup id="fnref:9"&gt;&lt;a href="#fn:9" class="footnote-ref" role="doc-noteref"&gt;9&lt;/a&gt;&lt;/sup&gt; Это самоописание, а не измерение: сравнивать списки между проектами можно, только сверив каждую строку с документацией.&lt;/p&gt;&#10;&lt;p&gt;Есть и второй слой, который обычно не попадает в матрицы: семантика. Даже если операция есть, её поведение при гонке, при повторной записи или при удалении может отличаться от AWS. Пример — conditional writes: в AWS это отдельный контракт с заголовками &lt;code&gt;If-None-Match&lt;/code&gt; и &lt;code&gt;If-Match&lt;/code&gt;, который проверяет существование объекта или совпадение ETag до записи и умеет применяться к &lt;code&gt;PutObject&lt;/code&gt;, &lt;code&gt;CopyObject&lt;/code&gt; и &lt;code&gt;CompleteMultipartUpload&lt;/code&gt;.&lt;sup id="fnref:10"&gt;&lt;a href="#fn:10" class="footnote-ref" role="doc-noteref"&gt;10&lt;/a&gt;&lt;/sup&gt; Реализация может принимать те же запросы и молча игнорировать предусловие — и тогда клиент, который на них рассчитывал, получит не ошибку, а перезапись. Именно этот слой решает, безопасно ли держать в хранилище единственную копию бэкапа.&lt;/p&gt;&#10;&lt;h2 id="2-что-нужно-клиенту-restic-и-rclone"&gt;&lt;a href="#2-%d1%87%d1%82%d0%be-%d0%bd%d1%83%d0%b6%d0%bd%d0%be-%d0%ba%d0%bb%d0%b8%d0%b5%d0%bd%d1%82%d1%83-restic-%d0%b8-rclone" class="post_hash"&gt;2. Что нужно клиенту: restic и rclone&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Требования restic к S3 уже́, чем кажется, но у них есть острые края. Документация 0.19.1 прямо говорит: «restic expects path-style URLs», а virtual-hosted-style вида &lt;code&gt;bucket_name.s3.us-west-2.amazonaws.com&lt;/code&gt; не поддерживается и должен быть преобразован в path-style.&lt;sup id="fnref:11"&gt;&lt;a href="#fn:11" class="footnote-ref" role="doc-noteref"&gt;11&lt;/a&gt;&lt;/sup&gt; Регион по умолчанию — &lt;code&gt;us-east-1&lt;/code&gt;, если не задан &lt;code&gt;-o s3.region&lt;/code&gt;; выбор стиля адресации управляется &lt;code&gt;-o s3.bucket-lookup=auto&lt;/code&gt; со значениями &lt;code&gt;dns&lt;/code&gt; и &lt;code&gt;path&lt;/code&gt;.&lt;sup id="fnref1:11"&gt;&lt;a href="#fn:11" class="footnote-ref" role="doc-noteref"&gt;11&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Отдельно документирован обход для реализаций, которые «do not properly implement the ListObjectsV2 API, most notably Ceph versions before v14.2.5»: им можно передать &lt;code&gt;-o s3.list-objects-v1=true&lt;/code&gt;.&lt;sup id="fnref2:11"&gt;&lt;a href="#fn:11" class="footnote-ref" role="doc-noteref"&gt;11&lt;/a&gt;&lt;/sup&gt; Этот пункт стоит держать в голове не как курьёз: он показывает, что совместимость — величина с версией. Ceph 14.2.5 вышел в 2020 году, но формулировка осталась в документации restic как рабочая опция, а не как историческая справка.&lt;/p&gt;&#10;&lt;p&gt;rclone добавляет к этому свою оптику — контроль целостности. Для объектов, загруженных одним куском (меньше &lt;code&gt;--s3-upload-cutoff&lt;/code&gt;), rclone использует ETag как MD5. Для multipart-загрузок и для SSE ETag перестаёт быть MD5, поэтому rclone кладёт собственный &lt;code&gt;X-Amz-Meta-Md5chksum&lt;/code&gt; и сверяет его при скачивании; после загрузки он делает HEAD, чтобы убедиться, что объект на месте.&lt;sup id="fnref:12"&gt;&lt;a href="#fn:12" class="footnote-ref" role="doc-noteref"&gt;12&lt;/a&gt;&lt;/sup&gt; Если у источника нет MD5, одиночная загрузка остаётся без хеш-защиты, и документация советует &lt;code&gt;--s3-upload-cutoff 0&lt;/code&gt;, чтобы всё шло multipart.&lt;sup id="fnref1:12"&gt;&lt;a href="#fn:12" class="footnote-ref" role="doc-noteref"&gt;12&lt;/a&gt;&lt;/sup&gt; Версии объектов доступны только там, где включён versioning: &lt;code&gt;--s3-versions&lt;/code&gt; полагается на имена версий, которые ведёт сервер.&lt;sup id="fnref2:12"&gt;&lt;a href="#fn:12" class="footnote-ref" role="doc-noteref"&gt;12&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Показательная деталь: в списке провайдеров rclone есть Minio, Ceph и SeaweedFS, но нет Garage.&lt;sup id="fnref3:12"&gt;&lt;a href="#fn:12" class="footnote-ref" role="doc-noteref"&gt;12&lt;/a&gt;&lt;/sup&gt; Это не приговор Garage — он работает через «Any other S3 compatible provider», — но это иллюстрация того, что совместимость на практике существует не между «S3» и «не-S3», а между клиентом и конкретным сервером.&lt;/p&gt;&#10;&lt;p&gt;Нижняя граница требований у обоих клиентов общая: CRUD объектов, листинг с пагинацией, multipart-загрузка, осмысленные коды ошибок. Всё, что выше этой границы — версии, блокировки, политики, шифрование, — уже различается. И именно верхний слой определяет, что произойдёт с бэкапом при ошибке администратора.&lt;/p&gt;&#10;&lt;h2 id="3-minio-как-community-edition-перестал-быть-вариантом"&gt;&lt;a href="#3-minio-%d0%ba%d0%b0%d0%ba-community-edition-%d0%bf%d0%b5%d1%80%d0%b5%d1%81%d1%82%d0%b0%d0%bb-%d0%b1%d1%8b%d1%82%d1%8c-%d0%b2%d0%b0%d1%80%d0%b8%d0%b0%d0%bd%d1%82%d0%be%d0%bc" class="post_hash"&gt;3. MinIO: как Community Edition перестал быть вариантом&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Хронология важна, потому что вокруг неё много пересказов. В феврале 2025 года в &lt;code&gt;minio/object-browser&lt;/code&gt; ушёл коммит, упростивший консоль до просмотрщика объектов; по данным Blocks &amp;amp; Files, вместе с ним из Community Edition ушли управление аккаунтами и политиками, конфигурацией, lifecycle и site replication.&lt;sup id="fnref:13"&gt;&lt;a href="#fn:13" class="footnote-ref" role="doc-noteref"&gt;13&lt;/a&gt;&lt;/sup&gt; В релизе &lt;code&gt;RELEASE.2025-05-24T17-08-30Z&lt;/code&gt;, озаглавленном «Breaking Release», это зафиксировано прямым текстом: «Embedded UI Console is now deprecated and moved to object-browser», «External IDP logins via LDAP/OIDC are removed as well; these are now available as part of the AiStor Product».&lt;sup id="fnref:14"&gt;&lt;a href="#fn:14" class="footnote-ref" role="doc-noteref"&gt;14&lt;/a&gt;&lt;/sup&gt; Там же — рекомендация платящим клиентам переходить на AiStor.&lt;sup id="fnref1:14"&gt;&lt;a href="#fn:14" class="footnote-ref" role="doc-noteref"&gt;14&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Реакция сообщества была резкой и по существу не про функции: в обсуждении #21326 автор формулирует претензию как «It&amp;rsquo;s not a feature issue, it&amp;rsquo;s a trust one» — без анонса, без предупреждения в changelog, с закрытием тикетов.&lt;sup id="fnref:15"&gt;&lt;a href="#fn:15" class="footnote-ref" role="doc-noteref"&gt;15&lt;/a&gt;&lt;/sup&gt; В #21316 пользователи фиксируют, что администрирование осталось только в &lt;code&gt;mc&lt;/code&gt;, а откат на релизы апреля 2025 года стал временной мерой.&lt;sup id="fnref:16"&gt;&lt;a href="#fn:16" class="footnote-ref" role="doc-noteref"&gt;16&lt;/a&gt;&lt;/sup&gt; Это отчёты пользователей, а не проверенные факты о поведении кода, но они объясняют, почему миграция пошла волной, а не единичными случаями.&lt;/p&gt;&#10;&lt;p&gt;Дальше — то, что делает вопрос необратимым. Последний релиз — &lt;code&gt;RELEASE.2025-10-15T17-29-55Z&lt;/code&gt; с исправлением CVE (privilege escalation через обход session policy); он помечен как Latest.&lt;sup id="fnref2:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt; 25 апреля 2026 года репозиторий заархивирован, а README начинается словами «THIS REPOSITORY IS NO LONGER MAINTAINED» и продолжает: «The MinIO community edition is now distributed as source code only. We will no longer provide pre-compiled binary releases for the community version».&lt;sup id="fnref1:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt; То есть «собрать из исходников» больше не даёт свежий код: исходники — это и есть замороженное состояние на последнем коммите.&lt;/p&gt;&#10;&lt;p&gt;Сам MinIO описывает это без двусмысленности: «As of late 2025, MinIO Open Source Community Edition is no longer maintained. No new features, enhancements, or bug fixes are being added».&lt;sup id="fnref:17"&gt;&lt;a href="#fn:17" class="footnote-ref" role="doc-noteref"&gt;17&lt;/a&gt;&lt;/sup&gt; Замена — AIStor: 23 декабря 2025 года компания объявила тарифы Free и Enterprise Lite.&lt;sup id="fnref:18"&gt;&lt;a href="#fn:18" class="footnote-ref" role="doc-noteref"&gt;18&lt;/a&gt;&lt;/sup&gt; Free — бесплатный, но «Single-node deployment architecture»; Lite — multi-node с потолком «below 400 TiB».&lt;sup id="fnref1:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Для практики это значит следующее. MinIO CE не подходит для новой установки: вы получаете сервер, который не получит исправлений после октября 2025 года, и сборку из архива. AIStor Free — другой продукт с другой лицензией и без горизонтального масштабирования; это разумный вариант для одного узла, но он не воспроизводит прежнюю модель «три ноды, стирающий код, AGPL». Для уже работающей инсталляции выбор — миграция или принятие риска, и второй вариант со временем только дорожает.&lt;/p&gt;&#10;&lt;h2 id="4-garage-25-минимализм-с-явными-границами"&gt;&lt;a href="#4-garage-25-%d0%bc%d0%b8%d0%bd%d0%b8%d0%bc%d0%b0%d0%bb%d0%b8%d0%b7%d0%bc-%d1%81-%d1%8f%d0%b2%d0%bd%d1%8b%d0%bc%d0%b8-%d0%b3%d1%80%d0%b0%d0%bd%d0%b8%d1%86%d0%b0%d0%bc%d0%b8" class="post_hash"&gt;4. Garage 2.5: минимализм с явными границами&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Garage — противоположный подход: не «сделать весь S3», а «сделать надёжное geo-distributed хранилище и ровно тот S3, который нужен». Архитектурно это видно сразу: кластер не использует RAFT или другой консенсус, данные разложены по 256 партициям через layout, а &lt;code&gt;replication_factor&lt;/code&gt; задаёт число копий; есть узлы-шлюзы, которые не хранят данные.&lt;sup id="fnref:19"&gt;&lt;a href="#fn:19" class="footnote-ref" role="doc-noteref"&gt;19&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:20"&gt;&lt;a href="#fn:20" class="footnote-ref" role="doc-noteref"&gt;20&lt;/a&gt;&lt;/sup&gt; Все данные дедуплицируются по блокам фиксированного размера (&lt;code&gt;block_size&lt;/code&gt;) и опционально сжимаются Zstd.&lt;sup id="fnref1:20"&gt;&lt;a href="#fn:20" class="footnote-ref" role="doc-noteref"&gt;20&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Цена этого решения — отказ от функций, которые требуют согласования. В матрице совместимости bucket versioning помечен как Missing, ACL и bucket policies отсутствуют — вместо них собственная модель прав на уровне «ключ × бакет»; SSE реализован только как SSE-C, а server-side encryption с ключами, которыми управляет сервер, проект сознательно не делал; отсутствующие endpoint&amp;rsquo;ы возвращают &lt;code&gt;501 Not Implemented&lt;/code&gt;.&lt;sup id="fnref1:8"&gt;&lt;a href="#fn:8" class="footnote-ref" role="doc-noteref"&gt;8&lt;/a&gt;&lt;/sup&gt; Lifecycle частичный: поддерживаются &lt;code&gt;AbortIncompleteMultipartUpload&lt;/code&gt; и &lt;code&gt;Expiration&lt;/code&gt;, но не переходы между классами.&lt;sup id="fnref2:8"&gt;&lt;a href="#fn:8" class="footnote-ref" role="doc-noteref"&gt;8&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Важная оговорка про саму матрицу: её история обновлений заканчивается 25 мая 2022 года, и проект прямо предупреждает, что не следит за новыми версиями сравниваемых систем.&lt;sup id="fnref3:8"&gt;&lt;a href="#fn:8" class="footnote-ref" role="doc-noteref"&gt;8&lt;/a&gt;&lt;/sup&gt; Это значит, что читать её нужно как снимок намерений, а не как актуальный отчёт; для закреплённого v2.5.0 проверять надо на своём стенде.&lt;/p&gt;&#10;&lt;p&gt;Самый существенный пункт для бэкапов — в списке известных ограничений: «No conditional writes / locking / WORM support (if-none-match, &amp;hellip;)». Проект объясняет, что это «structurally impossible to implement in Garage due to the lack of a consensus algorithm», и добавляет, что даже полурабочий WORM не даст гарантии при одновременной записи и блокировке.&lt;sup id="fnref:21"&gt;&lt;a href="#fn:21" class="footnote-ref" role="doc-noteref"&gt;21&lt;/a&gt;&lt;/sup&gt; Там же — гонка при &lt;code&gt;CreateBucket&lt;/code&gt; по той же причине, уязвимость &lt;code&gt;replication_factor = 1&lt;/code&gt; для метаданных и практический потолок кластера около &lt;code&gt;10 × replication_factor&lt;/code&gt; узлов.&lt;sup id="fnref1:21"&gt;&lt;a href="#fn:21" class="footnote-ref" role="doc-noteref"&gt;21&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Что это значит на практике. restic с Garage работает: документация проекта показывает ровно такой сценарий — ключ с &lt;code&gt;--read --write&lt;/code&gt;, бакет, &lt;code&gt;RESTIC_REPOSITORY=&amp;quot;s3:http://localhost:3900/backups&amp;quot;&lt;/code&gt;. В примере quick start регион объявлен как &lt;code&gt;s3_region = &amp;quot;garage&amp;quot;&lt;/code&gt;, тогда как restic по умолчанию отправляет &lt;code&gt;us-east-1&lt;/code&gt;; если сервер сверяет регион, его нужно задать через &lt;code&gt;-o s3.region&lt;/code&gt;.&lt;sup id="fnref:22"&gt;&lt;a href="#fn:22" class="footnote-ref" role="doc-noteref"&gt;22&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:23"&gt;&lt;a href="#fn:23" class="footnote-ref" role="doc-noteref"&gt;23&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref3:11"&gt;&lt;a href="#fn:11" class="footnote-ref" role="doc-noteref"&gt;11&lt;/a&gt;&lt;/sup&gt; Но неизменяемость обеспечивается не bucket policy и не Object Lock, а правами ключа: ключ без права удаления не сможет сделать prune. Это слабее, чем WORM: политика запрета удаления защищает и от ошибки с полными правами, а «ключ без delete» — только от того, кто пользуется этим ключом.&lt;/p&gt;&#10;&lt;p&gt;Долговечность обеспечивается репликацией и scrubbing: проверка блоков по хешам идёт автоматически каждые 25–35 дней, повреждённый блок восстанавливается с другой ноды.&lt;sup id="fnref:24"&gt;&lt;a href="#fn:24" class="footnote-ref" role="doc-noteref"&gt;24&lt;/a&gt;&lt;/sup&gt; Это честная модель, но она требует &lt;code&gt;replication_factor&lt;/code&gt; не меньше 2–3 и понимания, что метаданные реплицируются тем же коэффициентом, что и данные.&lt;sup id="fnref2:21"&gt;&lt;a href="#fn:21" class="footnote-ref" role="doc-noteref"&gt;21&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:19"&gt;&lt;a href="#fn:19" class="footnote-ref" role="doc-noteref"&gt;19&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="5-seaweedfs-454-самый-широкий-api-и-цена-в-зависимостях"&gt;&lt;a href="#5-seaweedfs-454-%d1%81%d0%b0%d0%bc%d1%8b%d0%b9-%d1%88%d0%b8%d1%80%d0%be%d0%ba%d0%b8%d0%b9-api-%d0%b8-%d1%86%d0%b5%d0%bd%d0%b0-%d0%b2-%d0%b7%d0%b0%d0%b2%d0%b8%d1%81%d0%b8%d0%bc%d0%be%d1%81%d1%82%d1%8f%d1%85" class="post_hash"&gt;5. SeaweedFS 4.54: самый широкий API и цена в зависимостях&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;SeaweedFS устроен как несколько сервисов: master, volume server, filer и отдельный stateless S3-шлюз, который транслирует S3 в filer. Каждый бакет хранится в одной коллекции и отображается в папку &lt;code&gt;buckets/&amp;lt;bucket_name&amp;gt;&lt;/code&gt;; с версии 3.51 имя коллекции учитывает filer group.&lt;sup id="fnref:25"&gt;&lt;a href="#fn:25" class="footnote-ref" role="doc-noteref"&gt;25&lt;/a&gt;&lt;/sup&gt; Метаданные filer живут не внутри SeaweedFS, а во внешнем хранилище — LevelDB, RocksDB, SQLite, MySQL, PostgreSQL, Cassandra, Redis, etcd, TiKV и других.&lt;sup id="fnref1:9"&gt;&lt;a href="#fn:9" class="footnote-ref" role="doc-noteref"&gt;9&lt;/a&gt;&lt;/sup&gt; Это и есть главная плата за широкий API: у вас появляется вторая база, которую нужно бэкапить и обновлять отдельно от объектных данных.&lt;/p&gt;&#10;&lt;p&gt;По составу операций SeaweedFS действительно самый близкий к AWS из трёх. README перечисляет versioning, Object Lock с retention и legal hold, lifecycle, tagging, CORS, conditional reads and writes, checksums, presigned URLs, browser POST uploads, multipart и атомарный &lt;code&gt;RenameObject&lt;/code&gt;; SSE-S3, SSE-KMS и SSE-C поддержаны, ключи можно брать из OpenBao/Vault, AWS KMS, Azure Key Vault и GCP KMS.&lt;sup id="fnref2:9"&gt;&lt;a href="#fn:9" class="footnote-ref" role="doc-noteref"&gt;9&lt;/a&gt;&lt;/sup&gt; Шлюз заявляет не только object/bucket API, но и IAM, STS, S3 Tables и S3 Vectors на одном endpoint&amp;rsquo;е, а в CI, по утверждению проекта, гоняются compatibility suite и интеграционные тесты.&lt;sup id="fnref3:9"&gt;&lt;a href="#fn:9" class="footnote-ref" role="doc-noteref"&gt;9&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Пробелы тоже перечислены открыто: bucket website не поддерживается, bucket replication через S3 API — нет, notification — нет, у lifecycle не поддержаны transition rules, &lt;code&gt;GetBucketLocation&lt;/code&gt; возвращает значение по умолчанию, &lt;code&gt;ListDirectoryBuckets&lt;/code&gt; отсутствует.&lt;sup id="fnref1:25"&gt;&lt;a href="#fn:25" class="footnote-ref" role="doc-noteref"&gt;25&lt;/a&gt;&lt;/sup&gt; Часть операций — заглушки с формально правильным ответом: &lt;code&gt;GetBucketAnalyticsConfiguration&lt;/code&gt; возвращает &lt;code&gt;NoSuchConfiguration&lt;/code&gt;, &lt;code&gt;GetBucketLogging&lt;/code&gt; — пустой статус.&lt;sup id="fnref2:25"&gt;&lt;a href="#fn:25" class="footnote-ref" role="doc-noteref"&gt;25&lt;/a&gt;&lt;/sup&gt; Формально «операция есть», фактически — нет; это ровно тот случай, когда матрица совместимости отвечает «Yes» на вопрос, которого вы не задавали.&lt;/p&gt;&#10;&lt;p&gt;Устройство хранения объясняет, почему проект может позволить себе такой API: мелкий файл — один blob, крупный делится на чанки в несколько мегабайт, каждый чанк — отдельный blob; на volume server держится 16-байтовый индекс на blob, поэтому чтение — один seek. Горячие данные реплицируются, erasure coding применяется к тёплым в фоне, чтобы запись не платила за кодирование.&lt;sup id="fnref4:9"&gt;&lt;a href="#fn:9" class="footnote-ref" role="doc-noteref"&gt;9&lt;/a&gt;&lt;/sup&gt; Заявленные числа (&lt;code&gt;weed benchmark&lt;/code&gt; на ноутбуке: 15 700 записей 1 KB/s, 3.2 GiB/s в смешанном S3-тесте) — это vendor-числа без опубликованной методики, и здесь они не используются как доказательство.&lt;sup id="fnref5:9"&gt;&lt;a href="#fn:9" class="footnote-ref" role="doc-noteref"&gt;9&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Для бэкапа важнее другое: у SeaweedFS есть и Object Lock, и conditional writes, то есть WORM можно строить на уровне хранилища, а не на дисциплине ключей. Версия 4.54 — актуальный релиз на дату обзора.&lt;sup id="fnref:26"&gt;&lt;a href="#fn:26" class="footnote-ref" role="doc-noteref"&gt;26&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="6-ceph-rgw-2025-полный-api-и-операционный-вес"&gt;&lt;a href="#6-ceph-rgw-2025-%d0%bf%d0%be%d0%bb%d0%bd%d1%8b%d0%b9-api-%d0%b8-%d0%be%d0%bf%d0%b5%d1%80%d0%b0%d1%86%d0%b8%d0%be%d0%bd%d0%bd%d1%8b%d0%b9-%d0%b2%d0%b5%d1%81" class="post_hash"&gt;6. Ceph RGW 20.2.5: полный API и операционный вес&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Ceph Object Gateway — самый старый и самый «полный» из трёх по документированному набору. В таблице поддержки заявлены lifecycle, bucket website, bucket notification, object versions, bucket и object policies вместе с ACL, tagging, storage class и bucket logging; единственная явная оговорка — bucket replication «Partial, permitted only across zones».&lt;sup id="fnref1:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt; Не поддерживается служебный заголовок &lt;code&gt;x-amz-id-2&lt;/code&gt;.&lt;sup id="fnref2:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Версии: Tentacle 20.2.5 вышел 2 ноября 2026 года, ориентировочный EOL линейки — 1 июня 2027; следующая активная ветка Umbrella 21.2.0 — 28 октября 2026.&lt;sup id="fnref1:6"&gt;&lt;a href="#fn:6" class="footnote-ref" role="doc-noteref"&gt;6&lt;/a&gt;&lt;/sup&gt; Для self-hosted это означает предсказуемый, но не бесконечный цикл обновлений: раз в год-полтора нужно планировать переход на новую линейку, а не «поставить и забыть».&lt;/p&gt;&#10;&lt;p&gt;Цена — операционная. RGW — это надстройка над RADOS: нужны MON, MGR и OSD, а для geo-репликации — отдельно настраиваемые multisite sync modules и понимание зон.&lt;sup id="fnref3:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt; На одном домашнем сервере это лишний слой; на нескольких площадках с требованием пережить потерю дата-центра — единственный из трёх вариантов с действительно проработанной мультисайтовой моделью.&lt;/p&gt;&#10;&lt;p&gt;История restic и Ceph полезна как иллюстрация того, что «совместимость» стареет: обход &lt;code&gt;s3.list-objects-v1&lt;/code&gt; существует именно потому, что старые версии Ceph не реализовали ListObjectsV2 корректно.&lt;sup id="fnref4:11"&gt;&lt;a href="#fn:11" class="footnote-ref" role="doc-noteref"&gt;11&lt;/a&gt;&lt;/sup&gt; Сегодня это уже история, но она показывает, как версия сервера превращает «S3-совместимый» в «S3-совместимый с оговоркой».&lt;/p&gt;&#10;&lt;h2 id="7-сравнение-по-тому-что-ломает-бэкап"&gt;&lt;a href="#7-%d1%81%d1%80%d0%b0%d0%b2%d0%bd%d0%b5%d0%bd%d0%b8%d0%b5-%d0%bf%d0%be-%d1%82%d0%be%d0%bc%d1%83-%d1%87%d1%82%d0%be-%d0%bb%d0%be%d0%bc%d0%b0%d0%b5%d1%82-%d0%b1%d1%8d%d0%ba%d0%b0%d0%bf" class="post_hash"&gt;7. Сравнение по тому, что ломает бэкап&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Таблица ниже собрана только из проверенных страниц документации; прочерк «?» означает «в просмотренной таблице не заявлено», а не «точно отсутствует». Это важное различие: молчание документации — тоже риск, потому что проверять придётся самому.&lt;/p&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Свойство&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Garage 2.5.0&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;SeaweedFS 4.54&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Ceph RGW 20.2.5&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;ListObjectsV2&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;да&lt;sup id="fnref4:8"&gt;&lt;a href="#fn:8" class="footnote-ref" role="doc-noteref"&gt;8&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;да&lt;sup id="fnref3:25"&gt;&lt;a href="#fn:25" class="footnote-ref" role="doc-noteref"&gt;25&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;да&lt;sup id="fnref4:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Multipart upload&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;да&lt;sup id="fnref5:8"&gt;&lt;a href="#fn:8" class="footnote-ref" role="doc-noteref"&gt;8&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;да&lt;sup id="fnref4:25"&gt;&lt;a href="#fn:25" class="footnote-ref" role="doc-noteref"&gt;25&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;да&lt;sup id="fnref5:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Path-style addressing&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;да&lt;sup id="fnref6:8"&gt;&lt;a href="#fn:8" class="footnote-ref" role="doc-noteref"&gt;8&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;да&lt;sup id="fnref5:25"&gt;&lt;a href="#fn:25" class="footnote-ref" role="doc-noteref"&gt;25&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;да&lt;sup id="fnref7:8"&gt;&lt;a href="#fn:8" class="footnote-ref" role="doc-noteref"&gt;8&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Bucket versioning&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;нет&lt;sup id="fnref8:8"&gt;&lt;a href="#fn:8" class="footnote-ref" role="doc-noteref"&gt;8&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;да&lt;sup id="fnref6:25"&gt;&lt;a href="#fn:25" class="footnote-ref" role="doc-noteref"&gt;25&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;да&lt;sup id="fnref6:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Bucket policies / ACL&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;нет, своя модель прав&lt;sup id="fnref9:8"&gt;&lt;a href="#fn:8" class="footnote-ref" role="doc-noteref"&gt;8&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;да&lt;sup id="fnref7:25"&gt;&lt;a href="#fn:25" class="footnote-ref" role="doc-noteref"&gt;25&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;да&lt;sup id="fnref7:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Object Lock / WORM&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;нет, «structurally impossible»&lt;sup id="fnref3:21"&gt;&lt;a href="#fn:21" class="footnote-ref" role="doc-noteref"&gt;21&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;да&lt;sup id="fnref6:9"&gt;&lt;a href="#fn:9" class="footnote-ref" role="doc-noteref"&gt;9&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;?&lt;sup id="fnref8:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Conditional writes (If-None-Match)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;нет&lt;sup id="fnref4:21"&gt;&lt;a href="#fn:21" class="footnote-ref" role="doc-noteref"&gt;21&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;да&lt;sup id="fnref7:9"&gt;&lt;a href="#fn:9" class="footnote-ref" role="doc-noteref"&gt;9&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;?&lt;sup id="fnref9:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;SSE-S3 / SSE-KMS&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;нет, только SSE-C&lt;sup id="fnref10:8"&gt;&lt;a href="#fn:8" class="footnote-ref" role="doc-noteref"&gt;8&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;да&lt;sup id="fnref8:9"&gt;&lt;a href="#fn:9" class="footnote-ref" role="doc-noteref"&gt;9&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;?&lt;sup id="fnref10:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Static website&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;да&lt;sup id="fnref11:8"&gt;&lt;a href="#fn:8" class="footnote-ref" role="doc-noteref"&gt;8&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;нет&lt;sup id="fnref8:25"&gt;&lt;a href="#fn:25" class="footnote-ref" role="doc-noteref"&gt;25&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;да&lt;sup id="fnref11:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Bucket replication через S3 API&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;нет&lt;sup id="fnref12:8"&gt;&lt;a href="#fn:8" class="footnote-ref" role="doc-noteref"&gt;8&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;нет&lt;sup id="fnref9:25"&gt;&lt;a href="#fn:25" class="footnote-ref" role="doc-noteref"&gt;25&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;частично, между зонами&lt;sup id="fnref12:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Внешняя БД для метаданных&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;нет&lt;sup id="fnref2:20"&gt;&lt;a href="#fn:20" class="footnote-ref" role="doc-noteref"&gt;20&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;да, на выбор&lt;sup id="fnref9:9"&gt;&lt;a href="#fn:9" class="footnote-ref" role="doc-noteref"&gt;9&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;нет, RADOS&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;Строки с наибольшими последствиями — не те, что проверяют при слове «совместимость». Multipart и листинг нужны, чтобы бэкап вообще записался и прочитался; версии, политики и блокировки определяют, что останется после ошибки. Разница между «удалил не тот snapshot» и «удалил не тот snapshot, но версия объекта сохранилась» — это разница между восстановлением и инцидентом.&lt;/p&gt;&#10;&lt;p&gt;Второй вывод из таблицы: зрелость документации не совпадает с зрелостью продукта. У Ceph заявлен самый широкий набор, но в просмотренной таблице нет строк про Object Lock и conditional writes; у Garage таблица подробная, но не обновлялась с 2022 года; у SeaweedFS строк больше всех, но часть из них — заглушки с корректным XML. Ни одна из трёх матриц не даёт ответа на вопрос «что будет при одновременной записи двух клиентов» — этот ответ лежит в разделах known issues и в поведении кода.&lt;/p&gt;&#10;&lt;h2 id="8-как-проверить-совместимость-самому"&gt;&lt;a href="#8-%d0%ba%d0%b0%d0%ba-%d0%bf%d1%80%d0%be%d0%b2%d0%b5%d1%80%d0%b8%d1%82%d1%8c-%d1%81%d0%be%d0%b2%d0%bc%d0%b5%d1%81%d1%82%d0%b8%d0%bc%d0%be%d1%81%d1%82%d1%8c-%d1%81%d0%b0%d0%bc%d0%be%d0%bc%d1%83" class="post_hash"&gt;8. Как проверить совместимость самому&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Проверка занимает час и отвечает на вопросы, которых не закрывает ни одна матрица. Порядок такой.&lt;/p&gt;&#10;&lt;p&gt;Сначала — точный клиент и точная версия. Не «S3 поддерживается», а «restic 0.19.1 с &lt;code&gt;-o s3.bucket-lookup=auto&lt;/code&gt; и rclone с &lt;code&gt;--s3-upload-cutoff&lt;/code&gt; по умолчанию». Документация restic перечисляет конкретные опции и исключения, и проверять надо именно их.&lt;sup id="fnref5:11"&gt;&lt;a href="#fn:11" class="footnote-ref" role="doc-noteref"&gt;11&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Затем — полный цикл на реальном объёме: &lt;code&gt;init&lt;/code&gt;, &lt;code&gt;backup&lt;/code&gt;, &lt;code&gt;snapshots&lt;/code&gt;, &lt;code&gt;check&lt;/code&gt;, &lt;code&gt;restore&lt;/code&gt; в пустой каталог и сравнение содержимого. &lt;code&gt;check&lt;/code&gt; у restic не перечитывает весь payload, поэтому отдельно нужен именно restore — успешный &lt;code&gt;check&lt;/code&gt; не доказывает, что данные читаются.&lt;sup id="fnref6:11"&gt;&lt;a href="#fn:11" class="footnote-ref" role="doc-noteref"&gt;11&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Дальше — краевые случаи, которые ломаются чаще всего: больше 1000 объектов в бакете (проверка пагинации листинга), объект больше порога multipart, ключи с пробелами, юникодом и &lt;code&gt;/&lt;/code&gt; в имени, повторная запись поверх существующего объекта, удаление несуществующего объекта (ожидается &lt;code&gt;204&lt;/code&gt;, а не &lt;code&gt;404&lt;/code&gt;), presigned URL, поведение при оборванной загрузке. Для каждого — фиксация кода ответа: &lt;code&gt;501&lt;/code&gt; и &lt;code&gt;404&lt;/code&gt; значат разное, и клиенты обрабатывают их по-разному.&lt;/p&gt;&#10;&lt;p&gt;Полезно прогнать &lt;code&gt;ceph/s3-tests&lt;/code&gt; как дымовой тест: несмотря на статус неофициального и неподдерживаемого отдельно набора, он остаётся самой полной публичной проверкой семантики.&lt;sup id="fnref2:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt; Результат «прошло N из M» информативнее, чем «проект заявляет совместимость».&lt;/p&gt;&#10;&lt;p&gt;И последнее: измерить восстановление, а не запись. Бэкап, который пишется быстро и восстанавливается неопределимо долго, — это не бэкап. Академические измерения S3 API для HPC показали, что реализации S3 в целом не соответствовали требованиям HPC по производительности и масштабируемости;&lt;sup id="fnref:27"&gt;&lt;a href="#fn:27" class="footnote-ref" role="doc-noteref"&gt;27&lt;/a&gt;&lt;/sup&gt; это другой сценарий и другая эпоха, но вывод переносится: заявленная совместимость ничего не говорит о поведении под нагрузкой.&lt;/p&gt;&#10;&lt;h2 id="дискуссионные-вопросы-и-противоречия"&gt;&lt;a href="#%d0%b4%d0%b8%d1%81%d0%ba%d1%83%d1%81%d1%81%d0%b8%d0%be%d0%bd%d0%bd%d1%8b%d0%b5-%d0%b2%d0%be%d0%bf%d1%80%d0%be%d1%81%d1%8b-%d0%b8-%d0%bf%d1%80%d0%be%d1%82%d0%b8%d0%b2%d0%be%d1%80%d0%b5%d1%87%d0%b8%d1%8f" class="post_hash"&gt;Дискуссионные вопросы и противоречия&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;&lt;strong&gt;«У MinIO нет публичной матрицы» против «мы полнее MinIO».&lt;/strong&gt; Garage пишет, что MinIO не публикует список совместимости, и потому сравнивать не с чем.&lt;sup id="fnref13:8"&gt;&lt;a href="#fn:8" class="footnote-ref" role="doc-noteref"&gt;8&lt;/a&gt;&lt;/sup&gt; SeaweedFS, наоборот, заявляет «The most complete S3 API» и ссылается на собственное сравнение с MinIO.&lt;sup id="fnref10:9"&gt;&lt;a href="#fn:9" class="footnote-ref" role="doc-noteref"&gt;9&lt;/a&gt;&lt;/sup&gt; Оба утверждения могут быть верны одновременно: у MinIO не было таблицы, но был работающий набор операций, который проверялся клиентами на практике. Отсутствие таблицы — не отсутствие функций, а отсутствие документации; для выбора это плохо, для оценки — нейтрально.&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;Static website.&lt;/strong&gt; Garage утверждает, что «none of the other alternative S3 implementations we surveyed (such as Minio or CEPH) support publishing static websites from S3 buckets» и что эта функция унаследована от AWS.&lt;sup id="fnref3:20"&gt;&lt;a href="#fn:20" class="footnote-ref" role="doc-noteref"&gt;20&lt;/a&gt;&lt;/sup&gt; Таблица Ceph при этом заявляет Bucket Website как Supported, с оговоркой про отличия в конфигурации.&lt;sup id="fnref13:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt; Одно из двух утверждений устарело; какое именно — по документации не определить, потому что Garage-страница не обновлялась с 2022 года. Это хороший пример того, почему матрицы нельзя складывать: они фиксируют разные моменты времени.&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;Vendor-числа против измерений.&lt;/strong&gt; SeaweedFS публикует throughput на одном ноутбуке, MinIO исторически позиционировался как самый быстрый, а академическая работа 2021 года измерила, что S3-реализации не дотягивают до требований HPC.&lt;sup id="fnref11:9"&gt;&lt;a href="#fn:9" class="footnote-ref" role="doc-noteref"&gt;9&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:27"&gt;&lt;a href="#fn:27" class="footnote-ref" role="doc-noteref"&gt;27&lt;/a&gt;&lt;/sup&gt; Противоречия здесь нет: числа получены на разном железе, разными инструментами и для разных нагрузок. Но из этого следует, что выбирать по опубликованным цифрам нельзя — только по своим.&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;«Совместимость» и «неизменяемость» — разные свойства.&lt;/strong&gt; MinIO CE в последнем релизе поддерживал и версии, и Object Lock, и политики; Garage не поддерживает ни того, ни другого, но остаётся полностью S3-совместимым для CRUD и multipart. Оба утверждения корректны, потому что «S3 API» не включает обязательств по WORM. Именно поэтому фраза «S3-совместимое хранилище» в описании продукта ничего не говорит о защите бэкапа.&lt;sup id="fnref2:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref5:21"&gt;&lt;a href="#fn:21" class="footnote-ref" role="doc-noteref"&gt;21&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;h2 id="недостаточность-данных"&gt;&lt;a href="#%d0%bd%d0%b5%d0%b4%d0%be%d1%81%d1%82%d0%b0%d1%82%d0%be%d1%87%d0%bd%d0%be%d1%81%d1%82%d1%8c-%d0%b4%d0%b0%d0%bd%d0%bd%d1%8b%d1%85" class="post_hash"&gt;Недостаточность данных&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Не удалось установить следующее. Нет независимого актуального прогона conformance-тестов по закреплённым версиям: &lt;code&gt;s3-tests&lt;/code&gt; больше не поддерживается как отдельный проект, а публичные результаты проектов — самоотчёт.&lt;sup id="fnref3:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt; Нет данных о поведении Object Lock и conditional writes в Ceph RGW 20.2.5 в объёме, достаточном для утверждения: в просмотренной таблице этих строк нет, отдельная проверка не проводилась.&lt;sup id="fnref14:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt; Не проверялась зрелость RustFS: проект под Apache 2.0 заявляет «broad S3 API compatibility for supported features» и ведёт собственную матрицу, но история релизов и поведение под нагрузкой в этом обзоре не исследовались.&lt;sup id="fnref:28"&gt;&lt;a href="#fn:28" class="footnote-ref" role="doc-noteref"&gt;28&lt;/a&gt;&lt;/sup&gt; Нет сопоставимых измерений restore-time для трёх реализаций на одном датасете и одном клиенте — такие замеры требуют стенда, а не документации. Все эти пробелы отмечены как открытые, а не закрыты оценками.&lt;/p&gt;&#10;&lt;h2 id="заключение"&gt;&lt;a href="#%d0%b7%d0%b0%d0%ba%d0%bb%d1%8e%d1%87%d0%b5%d0%bd%d0%b8%d0%b5" class="post_hash"&gt;Заключение&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Практические правила выглядят так.&lt;/p&gt;&#10;&lt;p&gt;Если нужен S3 для restic и rclone на одном-двух серверах и достаточно CRUD с multipart — Garage 2.5.0 закрывает задачу, но требует &lt;code&gt;replication_factor&lt;/code&gt; не меньше 2 и понимания, что версий и Object Lock там нет, а неизменяемость достигается правами ключа, а не политикой.&lt;sup id="fnref14:8"&gt;&lt;a href="#fn:8" class="footnote-ref" role="doc-noteref"&gt;8&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref6:21"&gt;&lt;a href="#fn:21" class="footnote-ref" role="doc-noteref"&gt;21&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:22"&gt;&lt;a href="#fn:22" class="footnote-ref" role="doc-noteref"&gt;22&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Если нужны версии, Object Lock и политики — SeaweedFS 4.54 даёт их вместе с conditional writes, но добавляет внешнюю базу метаданных, которую придётся эксплуатировать и бэкапить отдельно.&lt;sup id="fnref12:9"&gt;&lt;a href="#fn:9" class="footnote-ref" role="doc-noteref"&gt;9&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref10:25"&gt;&lt;a href="#fn:25" class="footnote-ref" role="doc-noteref"&gt;25&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;Если нужна мультисайтовая репликация и полный документированный набор операций — Ceph RGW 20.2.5, ценой кластера RADOS и годового цикла обновлений.&lt;sup id="fnref15:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:6"&gt;&lt;a href="#fn:6" class="footnote-ref" role="doc-noteref"&gt;6&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;p&gt;MinIO CE в этом списке больше нет: последний релиз — октябрь 2025, репозиторий заархивирован в апреле 2026, а AIStor Free — другой продукт с одним узлом.&lt;sup id="fnref3:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref3:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt; Для новой установки это не вариант; для существующей — проект миграции с понятной ценой отсрочки.&lt;/p&gt;&#10;&lt;p&gt;Общий вывод: «S3-совместимость» — это контракт на подмножество операций, и подписывать его нужно, прочитав список. Проверять стоит не наличие multipart, а то, что произойдёт с единственной копией бэкапа, когда администратор ошибётся, диск умрёт или клиент перезапишет объект. Ответ на этот вопрос даёт не логотип, а раздел known issues и собственный тест на восстановление.&lt;/p&gt;&#10;&lt;h2 id="quality-metrics"&gt;&lt;a href="#quality-metrics" class="post_hash"&gt;Quality Metrics&lt;/a&gt;&lt;/h2&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Metric&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Value&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Sources found&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;41&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Sources read&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;31&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Sources cited&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;28&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Academic sources&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;1&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Official/documentation&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;24&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Industry reports&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;1&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;News/journalism&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;1&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Blog/forum&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;2&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Citation coverage&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;80%&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Counter-arguments searched&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Yes&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Research rounds&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;3&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Questions emerged&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;6&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Questions resolved&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;4&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Questions insufficient data&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;2&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;div class="footnotes" role="doc-endnotes"&gt;&#10;&lt;hr&gt;&#10;&lt;ol&gt;&#10;&lt;li id="fn:1"&gt;&#10;&lt;p&gt;MinIO. &amp;ldquo;MinIO is a high-performance, S3 compatible object store, open sourced under GNU AGPLv3 license.&amp;rdquo; GitHub README, repository archived 2026-04-25; прочитано 2026-11-17. &lt;a href="https://github.com/minio/minio"&gt;https://github.com/minio/minio&lt;/a&gt;&amp;#160;&lt;a href="#fnref:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:2"&gt;&#10;&lt;p&gt;MinIO. &amp;ldquo;Security/CVE RELEASE.2025-10-15T17-29-55Z.&amp;rdquo; GitHub Releases, 2025-10-15; прочитано 2026-11-17. &lt;a href="https://github.com/minio/minio/releases/tag/RELEASE.2025-10-15T17-29-55Z"&gt;https://github.com/minio/minio/releases/tag/RELEASE.2025-10-15T17-29-55Z&lt;/a&gt;&amp;#160;&lt;a href="#fnref:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:3"&gt;&#10;&lt;p&gt;Ceph contributors. &amp;ldquo;Compatibility tests for S3 clones.&amp;rdquo; GitHub, ceph/s3-tests; прочитано 2026-11-17. &lt;a href="https://github.com/ceph/s3-tests"&gt;https://github.com/ceph/s3-tests&lt;/a&gt;&amp;#160;&lt;a href="#fnref:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:4"&gt;&#10;&lt;p&gt;MinIO. &amp;ldquo;Subscriptions &amp;amp; Pricing.&amp;rdquo; min.io; прочитано 2026-11-17. &lt;a href="https://www.min.io/pricing"&gt;https://www.min.io/pricing&lt;/a&gt;&amp;#160;&lt;a href="#fnref:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:5"&gt;&#10;&lt;p&gt;Garage contributors. &amp;ldquo;Release builds.&amp;rdquo; Garage Documentation, v2.5.0 dated 2026-10-24; прочитано 2026-11-17. &lt;a href="https://garagehq.deuxfleurs.fr/_releases.html"&gt;https://garagehq.deuxfleurs.fr/_releases.html&lt;/a&gt;&amp;#160;&lt;a href="#fnref:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:6"&gt;&#10;&lt;p&gt;Ceph contributors. &amp;ldquo;Ceph Releases.&amp;rdquo; Ceph Documentation; прочитано 2026-11-17. &lt;a href="https://docs.ceph.com/en/latest/releases/"&gt;https://docs.ceph.com/en/latest/releases/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:6" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:6" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:6" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:7"&gt;&#10;&lt;p&gt;Ceph contributors. &amp;ldquo;Ceph Object Gateway S3 API.&amp;rdquo; Ceph Documentation, Tentacle 20.2.5; прочитано 2026-11-17. &lt;a href="https://docs.ceph.com/en/tentacle/radosgw/s3/"&gt;https://docs.ceph.com/en/tentacle/radosgw/s3/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref7:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref8:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref9:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref10:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref11:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref12:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref13:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref14:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref15:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:8"&gt;&#10;&lt;p&gt;Garage contributors. &amp;ldquo;S3 Compatibility status.&amp;rdquo; Garage Documentation; прочитано 2026-11-17. &lt;a href="https://garagehq.deuxfleurs.fr/documentation/reference-manual/s3-compatibility/"&gt;https://garagehq.deuxfleurs.fr/documentation/reference-manual/s3-compatibility/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:8" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:8" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:8" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:8" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:8" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:8" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:8" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref7:8" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref8:8" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref9:8" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref10:8" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref11:8" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref12:8" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref13:8" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref14:8" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:9"&gt;&#10;&lt;p&gt;SeaweedFS contributors. &amp;ldquo;SeaweedFS is a distributed storage system for object storage (S3), file systems, Iceberg table buckets, and Lance vector buckets.&amp;rdquo; GitHub README; прочитано 2026-11-17. &lt;a href="https://github.com/seaweedfs/seaweedfs"&gt;https://github.com/seaweedfs/seaweedfs&lt;/a&gt;&amp;#160;&lt;a href="#fnref:9" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:9" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:9" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:9" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:9" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:9" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:9" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref7:9" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref8:9" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref9:9" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref10:9" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref11:9" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref12:9" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:10"&gt;&#10;&lt;p&gt;Amazon Web Services. &amp;ldquo;How to prevent object overwrites with conditional writes.&amp;rdquo; Amazon S3 User Guide; прочитано 2026-11-17. &lt;a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/conditional-writes.html"&gt;https://docs.aws.amazon.com/AmazonS3/latest/userguide/conditional-writes.html&lt;/a&gt;&amp;#160;&lt;a href="#fnref:10" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:11"&gt;&#10;&lt;p&gt;restic contributors. &amp;ldquo;Preparing a new repository.&amp;rdquo; restic 0.19.1 documentation; прочитано 2026-11-17. &lt;a href="https://restic.readthedocs.io/en/stable/030_preparing_a_new_repo.html"&gt;https://restic.readthedocs.io/en/stable/030_preparing_a_new_repo.html&lt;/a&gt;&amp;#160;&lt;a href="#fnref:11" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:11" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:11" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:11" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:11" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:11" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:11" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:12"&gt;&#10;&lt;p&gt;rclone contributors. &amp;ldquo;Amazon S3 Storage Providers.&amp;rdquo; rclone documentation; прочитано 2026-11-17. &lt;a href="https://rclone.org/s3/"&gt;https://rclone.org/s3/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:12" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:12" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:12" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:12" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:13"&gt;&#10;&lt;p&gt;Blocks &amp;amp; Files. &amp;ldquo;MinIO users complain after admin UI removed from Community Edition.&amp;rdquo; 2025-06-19; прочитано 2026-11-17. &lt;a href="https://www.blocksandfiles.com/ai-ml/2025/06/19/minio-users-complain-after-admin-ui-removed-from-community-edition/1610856"&gt;https://www.blocksandfiles.com/ai-ml/2025/06/19/minio-users-complain-after-admin-ui-removed-from-community-edition/1610856&lt;/a&gt;&amp;#160;&lt;a href="#fnref:13" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:14"&gt;&#10;&lt;p&gt;MinIO. &amp;ldquo;Breaking Release RELEASE.2025-05-24T17-08-30Z.&amp;rdquo; GitHub Releases, 2025-05-24; прочитано 2026-11-17. &lt;a href="https://github.com/minio/minio/releases/tag/RELEASE.2025-05-24T17-08-30Z"&gt;https://github.com/minio/minio/releases/tag/RELEASE.2025-05-24T17-08-30Z&lt;/a&gt;&amp;#160;&lt;a href="#fnref:14" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:14" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:15"&gt;&#10;&lt;p&gt;MinIO community. &amp;ldquo;It&amp;rsquo;s not a feature issue, it&amp;rsquo;s a trust one.&amp;rdquo; GitHub Discussion #21326; прочитано 2026-11-17. &lt;a href="https://github.com/minio/minio/discussions/21326"&gt;https://github.com/minio/minio/discussions/21326&lt;/a&gt;&amp;#160;&lt;a href="#fnref:15" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:16"&gt;&#10;&lt;p&gt;MinIO community. &amp;ldquo;minio admin features gone.&amp;rdquo; GitHub Discussion #21316; прочитано 2026-11-17. &lt;a href="https://github.com/minio/minio/discussions/21316"&gt;https://github.com/minio/minio/discussions/21316&lt;/a&gt;&amp;#160;&lt;a href="#fnref:16" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:17"&gt;&#10;&lt;p&gt;MinIO. &amp;ldquo;MinIO AIStor vs MinIO OSS: Technical Comparison.&amp;rdquo; MinIO Blog; прочитано 2026-11-17. &lt;a href="https://www.min.io/blog/minio-aistor-vs-minio-oss-technical-comparison"&gt;https://www.min.io/blog/minio-aistor-vs-minio-oss-technical-comparison&lt;/a&gt;&amp;#160;&lt;a href="#fnref:17" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:18"&gt;&#10;&lt;p&gt;MinIO. &amp;ldquo;MinIO Introduces AIStor Free and Enterprise Lite Tiers.&amp;rdquo; Press release, 2025-12-23; прочитано 2026-11-17. &lt;a href="https://www.min.io/press/minio-introduces-aistor-free-and-enterprise-lite-tiers"&gt;https://www.min.io/press/minio-introduces-aistor-free-and-enterprise-lite-tiers&lt;/a&gt;&amp;#160;&lt;a href="#fnref:18" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:19"&gt;&#10;&lt;p&gt;Garage contributors. &amp;ldquo;Cluster layout.&amp;rdquo; Garage Documentation; прочитано 2026-11-17. &lt;a href="https://garagehq.deuxfleurs.fr/documentation/operations/layout/"&gt;https://garagehq.deuxfleurs.fr/documentation/operations/layout/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:19" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:19" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:20"&gt;&#10;&lt;p&gt;Garage contributors. &amp;ldquo;List of Garage features.&amp;rdquo; Garage Documentation; прочитано 2026-11-17. &lt;a href="https://garagehq.deuxfleurs.fr/documentation/reference-manual/features/"&gt;https://garagehq.deuxfleurs.fr/documentation/reference-manual/features/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:20" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:20" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:20" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:20" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:21"&gt;&#10;&lt;p&gt;Garage contributors. &amp;ldquo;Known issues.&amp;rdquo; Garage Documentation; прочитано 2026-11-17. &lt;a href="https://garagehq.deuxfleurs.fr/documentation/reference-manual/known-issues/"&gt;https://garagehq.deuxfleurs.fr/documentation/reference-manual/known-issues/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:21" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:21" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:21" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:21" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:21" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:21" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:21" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:22"&gt;&#10;&lt;p&gt;Garage contributors. &amp;ldquo;Backups (restic, duplicity&amp;hellip;).&amp;rdquo; Garage Documentation; прочитано 2026-11-17. &lt;a href="https://garagehq.deuxfleurs.fr/documentation/connect/backup/"&gt;https://garagehq.deuxfleurs.fr/documentation/connect/backup/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:22" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:22" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:23"&gt;&#10;&lt;p&gt;Garage contributors. &amp;ldquo;Quick Start.&amp;rdquo; Garage Documentation; прочитано 2026-11-17. &lt;a href="https://garagehq.deuxfleurs.fr/documentation/quick-start/"&gt;https://garagehq.deuxfleurs.fr/documentation/quick-start/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:23" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:24"&gt;&#10;&lt;p&gt;Garage contributors. &amp;ldquo;Durability &amp;amp; Repairs.&amp;rdquo; Garage Documentation; прочитано 2026-11-17. &lt;a href="https://garagehq.deuxfleurs.fr/documentation/operations/durability-repairs/"&gt;https://garagehq.deuxfleurs.fr/documentation/operations/durability-repairs/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:24" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:25"&gt;&#10;&lt;p&gt;SeaweedFS contributors. &amp;ldquo;Amazon S3 API.&amp;rdquo; GitHub Wiki; прочитано 2026-11-17. &lt;a href="https://github.com/seaweedfs/seaweedfs/wiki/Amazon-S3-API"&gt;https://github.com/seaweedfs/seaweedfs/wiki/Amazon-S3-API&lt;/a&gt;&amp;#160;&lt;a href="#fnref:25" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:25" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:25" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:25" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:25" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:25" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:25" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref7:25" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref8:25" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref9:25" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref10:25" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:26"&gt;&#10;&lt;p&gt;SeaweedFS contributors. &amp;ldquo;Releases.&amp;rdquo; GitHub, release 4.54; прочитано 2026-11-17. &lt;a href="https://github.com/seaweedfs/seaweedfs/releases"&gt;https://github.com/seaweedfs/seaweedfs/releases&lt;/a&gt;&amp;#160;&lt;a href="#fnref:26" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:27"&gt;&#10;&lt;p&gt;MIN Faculty, University of Hamburg; Institute of Computer Science, Georg-August-Universität Göttingen/GWDG. &amp;ldquo;Analyzing the Performance of the S3 Object Storage API for HPC Workloads.&amp;rdquo; Applied Sciences 11(18):8540, 14 September 2021. &lt;a href="https://www.mdpi.com/2076-3417/11/18/8540"&gt;https://www.mdpi.com/2076-3417/11/18/8540&lt;/a&gt;&amp;#160;&lt;a href="#fnref:27" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:27" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:28"&gt;&#10;&lt;p&gt;RustFS contributors. &amp;ldquo;RustFS is an open-source, S3-compatible high-performance object storage system.&amp;rdquo; GitHub README; прочитано 2026-11-17. &lt;a href="https://github.com/rustfs/rustfs"&gt;https://github.com/rustfs/rustfs&lt;/a&gt;&amp;#160;&lt;a href="#fnref:28" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;/ol&gt;&#10;&lt;/div&gt;&#10;</content></entry><entry><title>Native histograms в Prometheus: одна серия вместо двенадцати и новая цена точности</title><id>https://research.evsyukov.org/articles/prometheus-native-histograms-cost/</id><link href="https://research.evsyukov.org/articles/prometheus-native-histograms-cost/" rel="alternate" type="text/html"/><published>2026-11-16T09:38:00+03:00</published><updated>2026-11-16T09:42:43+03:00</updated><author><name>Denis Evsyukov</name></author><summary type="html">Как устроены native histograms, что именно экономит переход с bucket-серий на composite-сэмплы и где появляются новые расходы — в чанках, scrape и remote write.</summary><content type="html">&lt;h2 id="аннотация"&gt;&lt;a href="#%d0%b0%d0%bd%d0%bd%d0%be%d1%82%d0%b0%d1%86%d0%b8%d1%8f" class="post_hash"&gt;Аннотация&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Native histograms принято описывать как способ «убрать кардинальность гистограмм»: вместо набора серий &lt;code&gt;_bucket&lt;/code&gt;, &lt;code&gt;_sum&lt;/code&gt; и &lt;code&gt;_count&lt;/code&gt; появляется одна серия, а бакеты подбираются автоматически. Это верно ровно наполовину. Формат действительно меняет единицу кардинальности — с «серия на бакет» на «серия на набор меток», — но не уменьшает объём данных как таковой: то, что раньше лежало в индексе серий, переезжает внутрь одного сэмпла, в чанки, в WAL и в стоимость декодирования при запросах&lt;sup id="fnref:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;. Поэтому переход имеет смысл не там, где «много гистограмм», а там, где много наборов меток при небольшом числе наблюдаемых диапазонов.&lt;/p&gt;&#10;&lt;p&gt;Ниже разобрано, что именно стало стабильным в Prometheus 3.8 и что осталось opt-in, как устроен формат на уровне схемы, спанов и дельт, какая арифметика стоит за утверждением «одна серия вместо двенадцати», откуда берутся новые расходы на чанки и scrape, и почему совместимость с remote storage не означает сохранения native-семантики. Данные на 2026-11-16. Версия под наблюдением — Prometheus 3.16.0 от 4 ноября 2026 года, LTS-ветка — 3.13.5 от 21 октября 2026&lt;sup id="fnref:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;. Собственных замеров в этой статье нет: все числовые примеры — арифметика по документированному формату, а не результаты испытаний. Единственное свидетельство из практики — отчёт 2024 года на предстабильных версиях, и он помечен как таковой.&lt;/p&gt;&#10;&lt;h2 id="введение-что-стало-стабильным--и-что-стабильность-не-отменяет"&gt;&lt;a href="#%d0%b2%d0%b2%d0%b5%d0%b4%d0%b5%d0%bd%d0%b8%d0%b5-%d1%87%d1%82%d0%be-%d1%81%d1%82%d0%b0%d0%bb%d0%be-%d1%81%d1%82%d0%b0%d0%b1%d0%b8%d0%bb%d1%8c%d0%bd%d1%8b%d0%bc--%d0%b8-%d1%87%d1%82%d0%be-%d1%81%d1%82%d0%b0%d0%b1%d0%b8%d0%bb%d1%8c%d0%bd%d0%be%d1%81%d1%82%d1%8c-%d0%bd%d0%b5-%d0%be%d1%82%d0%bc%d0%b5%d0%bd%d1%8f%d0%b5%d1%82" class="post_hash"&gt;Введение: что стало стабильным — и что стабильность не отменяет&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Native histograms появились как экспериментальная функция в ноябре 2022 года, в Prometheus 2.40, и включались флагом &lt;code&gt;--enable-feature=native-histograms&lt;/code&gt;&lt;sup id="fnref1:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;. Стабильными они стали в выпуске 3.8.0, датированном 28 ноября 2025 года (на GitHub релиз опубликован 2 декабря)&lt;sup id="fnref:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt;. Формулировка release notes не оставляет места для трактовок:&lt;/p&gt;&#10;&lt;blockquote&gt;&#10;&lt;p&gt;«This is the first release with Native Histograms as a stable feature. However, scraping Native Histograms has to be activated explicitly via the &lt;code&gt;scrape_native_histograms&lt;/code&gt; config setting.»&lt;sup id="fnref1:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;/blockquote&gt;&#10;&lt;p&gt;То есть «stable» относится к формату и к TSDB, а не к поведению по умолчанию. В 3.8 флаг &lt;code&gt;--enable-feature=native-histograms&lt;/code&gt; ещё менял значение &lt;code&gt;scrape_native_histograms&lt;/code&gt; на &lt;code&gt;true&lt;/code&gt;, в 3.9 стал полным no-op, а начиная с 3.8 настройка появилась отдельно — глобально и в каждом scrape-конфиге&lt;sup id="fnref2:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt;. В 3.16 значение по умолчанию по-прежнему &lt;code&gt;false&lt;/code&gt;&lt;sup id="fnref:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;. По плану проекта оба переключателя — &lt;code&gt;scrape_native_histograms&lt;/code&gt; и &lt;code&gt;send_native_histograms&lt;/code&gt; — станут &lt;code&gt;true&lt;/code&gt; по умолчанию только в версии 4&lt;sup id="fnref3:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;Следующая точка отсчёта — LTS. Ветка 3.13.0 вышла 1 июля 2026 года и поддерживается до 31 июля 2027-го; политика проекта — LTS раз в полгода с годом поддержки и перекрытием минимум в месяц&lt;sup id="fnref:6"&gt;&lt;a href="#fn:6" class="footnote-ref" role="doc-noteref"&gt;6&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;. Текущий стабильный выпуск — 3.16.0 от 4 ноября 2026&lt;sup id="fnref1:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;. Практический вывод: если инфраструктура живёт на LTS, то native histograms в ней стабильны с 3.13, но включать их всё равно нужно руками и в двух местах — на scrape и на remote write.&lt;/p&gt;&#10;&lt;p&gt;Важная граница: сам формат обещает отсутствие ломающих изменений до 4.0, но не обещает, что все инструменты вокруг него уже умеют с ним работать. Ниже видно, что именно расходится — экспозиция, хранилища и запросы.&lt;/p&gt;&#10;&lt;h2 id="один-sample-вместо-набора-серий"&gt;&lt;a href="#%d0%be%d0%b4%d0%b8%d0%bd-sample-%d0%b2%d0%bc%d0%b5%d1%81%d1%82%d0%be-%d0%bd%d0%b0%d0%b1%d0%be%d1%80%d0%b0-%d1%81%d0%b5%d1%80%d0%b8%d0%b9" class="post_hash"&gt;Один sample вместо набора серий&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Классическая гистограмма в модели Prometheus — это не один тип, а набор float-серий. Каждый настроенный бакет становится отдельной серией с суффиксом &lt;code&gt;_bucket&lt;/code&gt; и меткой &lt;code&gt;le&lt;/code&gt;, независимо от того, заполнен он или нет; плюс отдельные серии &lt;code&gt;_sum&lt;/code&gt; и &lt;code&gt;_count&lt;/code&gt;&lt;sup id="fnref:8"&gt;&lt;a href="#fn:8" class="footnote-ref" role="doc-noteref"&gt;8&lt;/a&gt;&lt;/sup&gt;. При десяти бакетах это двенадцать серий на каждый набор меток. Именно поэтому стоимость классической гистограммы растёт произведением «число наборов меток × число бакетов», и именно это называют кардинальностью гистограмм.&lt;/p&gt;&#10;&lt;p&gt;Native histogram — это новый структурированный тип сэмпла:&lt;/p&gt;&#10;&lt;blockquote&gt;&#10;&lt;p&gt;«A single sample represents the previously known sum and count plus a dynamic set of buckets.»&lt;sup id="fnref4:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;/blockquote&gt;&#10;&lt;p&gt;Формат хранит &lt;code&gt;schema&lt;/code&gt;, разреженные списки бакетов для положительных и отрицательных наблюдений, отдельный zero-бакет с порогом и, опционально, exemplars&lt;sup id="fnref5:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;. Схема — знаковое 8-битное целое; допустимы значения от −4 до +8 (плюс −53 для custom buckets). Для стандартной схемы &lt;code&gt;n&lt;/code&gt; границы бакета с индексом &lt;code&gt;i&lt;/code&gt; считаются как &lt;code&gt;(2**(2**-n))**i&lt;/code&gt;, то есть каждый следующий бакет шире предыдущего в &lt;code&gt;2**(2**-n)&lt;/code&gt; раз&lt;sup id="fnref6:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;. Схема 3 соответствует росту примерно в 1,0905 раза — чуть меньше заявленного в библиотеках коэффициента 1.1, который как раз отображается в схему 3&lt;sup id="fnref7:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:9"&gt;&lt;a href="#fn:9" class="footnote-ref" role="doc-noteref"&gt;9&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;Разреженность устроена через два списка на знак: список популяций бакетов и список спанов. Спан — пара «смещение, длина»: первый спан задаёт индекс первого бакета, последующие описывают пропуски незаполненных бакетов и следующие за ними заполненные&lt;sup id="fnref8:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;. Для целочисленных гистограмм популяции хранятся дельтами к предыдущему бакету, а не абсолютными значениями. Это не косметика: дельты вместе с varint-кодированием дают тот самый эффект, о котором говорит спецификация, — «в продуктиве многие целые помещаются в 1 байт, большинство — в 2 байта», тогда как float в protobuf всегда занимает 8 байт. Отсюда оценка снижения размера «приближаясь к 8x для гистограмм с многими бакетами» — но только для protobuf-экспозиции и только для целочисленных гистограмм&lt;sup id="fnref9:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;Наконец, zero-бакет. Наблюдения ровно нуля не попадают ни в один обычный бакет, поэтому для них есть отдельный счётчик и порог: при положительном пороге все значения из &lt;code&gt;[-threshold, +threshold]&lt;/code&gt; уходят в zero-бакет&lt;sup id="fnref10:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;. Это одновременно и защита от «шумных» околонулевых значений, которые иначе заселяют десятки мелких бакетов, и инструмент экономии: порог можно поднять, если интересует только хвост распределения.&lt;/p&gt;&#10;&lt;p&gt;С OpenTelemetry формат стыкуется почти один к одному, и это важно для тех, кто собирает метрики через OTel Collector. Схема Prometheus равна &lt;code&gt;scale&lt;/code&gt; в OTel, индекс бакета смещён на единицу, zero-бакет соответствует &lt;code&gt;zero_count&lt;/code&gt;, а главное отличие — в плотности: «OTel has a dense rather than a sparse representation of buckets. One might see OTel as “Prom with only one span”»&lt;sup id="fnref11:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;. Обратное преобразование тоже работает: экспоненциальные гистограммы OTel при ingest всегда становятся native histograms со стандартной схемой, тогда как обычные (не экспоненциальные) гистограммы OTel конвертируются либо в классические, либо в NHCB&lt;sup id="fnref1:8"&gt;&lt;a href="#fn:8" class="footnote-ref" role="doc-noteref"&gt;8&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:10"&gt;&lt;a href="#fn:10" class="footnote-ref" role="doc-noteref"&gt;10&lt;/a&gt;&lt;/sup&gt;. Практическое следствие: если в вашем пайплайне уже есть OTel-экспоненциальные гистограммы, Prometheus получит native-тип без изменения инструментирования — и все описанные ниже расходы тоже.&lt;/p&gt;&#10;&lt;h2 id="арифметика-что-экономится-а-что-нет"&gt;&lt;a href="#%d0%b0%d1%80%d0%b8%d1%84%d0%bc%d0%b5%d1%82%d0%b8%d0%ba%d0%b0-%d1%87%d1%82%d0%be-%d1%8d%d0%ba%d0%be%d0%bd%d0%be%d0%bc%d0%b8%d1%82%d1%81%d1%8f-%d0%b0-%d1%87%d1%82%d0%be-%d0%bd%d0%b5%d1%82" class="post_hash"&gt;Арифметика: что экономится, а что нет&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Возьмём типичный случай: HTTP-латентность с десятью классическими бакетами и пятьюдесятью комбинациями меток (например, маршрут × статус). Классика даёт 12 × 50 = 600 активных серий, и каждая из них — отдельная запись в индексе, отдельный поток чанков, отдельный элемент в выдаче запроса. Native histogram даёт 50 серий — по одной на комбинацию меток, потому что бакеты, сумма и количество лежат в одном сэмпле&lt;sup id="fnref:11"&gt;&lt;a href="#fn:11" class="footnote-ref" role="doc-noteref"&gt;11&lt;/a&gt;&lt;/sup&gt;. Вот это и есть настоящий выигрыш: не байты, а число объектов, с которыми работает индекс, голова TSDB и планировщик запросов.&lt;/p&gt;&#10;&lt;p&gt;Теперь посмотрим на размер сэмпла. При коэффициенте 1.1 и диапазоне наблюдаемых значений от 1 мс до 10 с распределение занимает около 13,3 октав (log₂ отношения 10⁴). Схема 3 — это восемь бакетов на октаву, то есть до ~106 заполненных бакетов, если распределение реально покрывает весь диапазон&lt;sup id="fnref12:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;. В целочисленной гистограмме это порядка сотни дельт, каждая обычно в 1–2 байта, плюс счётчик, сумма, zero-бакет и спаны. Итог — один сэмпл в десятки или первые сотни байт вместо двенадцати float-значений (по 8 байт каждое плюс служебные поля). То есть per-scrape объём остаётся того же порядка, а число серий падает в двенадцать раз. Поэтому утверждение «native histograms экономят место» верно не безусловно, а как «экономят на индексе и на числе потоков, платя размером сэмпла».&lt;/p&gt;&#10;&lt;p&gt;Есть и теоретическая рамка. Количество заполненных бакетов растёт не с трафиком, а с разбросом значений: для i.i.d. экспоненциального и парето-распределений размер экспоненциальной гистограммы растёт как &lt;code&gt;log n&lt;/code&gt;, где &lt;code&gt;n&lt;/code&gt; — число наблюдений&lt;sup id="fnref:12"&gt;&lt;a href="#fn:12" class="footnote-ref" role="doc-noteref"&gt;12&lt;/a&gt;&lt;/sup&gt;. Иначе говоря, поток в тысячу запросов в секунду и поток в миллион запросов в секунду при том же распределении латентности занимают примерно одинаковое число бакетов. Это принципиальное отличие от классической гистограммы, где число серий фиксировано заранее и от данных не зависит, — но и цена ошибки другая: разрежение зависит от того, насколько широко реально разошлись значения.&lt;/p&gt;&#10;&lt;p&gt;Идея с относительной погрешностью не нова. DDSketch в 2019 году описан как «first fully-mergeable, relative-error quantile sketching algorithm with formal guarantees»: бакеты там логарифмические, и ошибка квантиля ограничена не абсолютной шириной диапазона, а долей от самого значения&lt;sup id="fnref:13"&gt;&lt;a href="#fn:13" class="footnote-ref" role="doc-noteref"&gt;13&lt;/a&gt;&lt;/sup&gt;. Экспоненциальные бакеты Prometheus — та же логика, но с фиксированным набором схем и без произвольного параметра точности: вы выбираете не α, а коэффициент роста бакета. Практическое следствие одно и то же: относительная погрешность примерно постоянна вдоль диапазона, поэтому хвост латентности оценивается не хуже медианы.&lt;/p&gt;&#10;&lt;p&gt;Полезно держать в голове и рыночную интерпретацию: Grafana Cloud тарифицирует активную серию native histogram как один активный бакет, умноженный на 0,25. Это не свойство формата, а решение вендора, но оно показывает, во что индустрия оценивает относительную стоимость одного «бакета» в native-сэмпле и в отдельной float-серии&lt;sup id="fnref:14"&gt;&lt;a href="#fn:14" class="footnote-ref" role="doc-noteref"&gt;14&lt;/a&gt;&lt;/sup&gt;. Для self-hosted Prometheus такой тариф, разумеется, не действует.&lt;/p&gt;&#10;&lt;h2 id="где-появляется-новая-стоимость"&gt;&lt;a href="#%d0%b3%d0%b4%d0%b5-%d0%bf%d0%be%d1%8f%d0%b2%d0%bb%d1%8f%d0%b5%d1%82%d1%81%d1%8f-%d0%bd%d0%be%d0%b2%d0%b0%d1%8f-%d1%81%d1%82%d0%be%d0%b8%d0%bc%d0%be%d1%81%d1%82%d1%8c" class="post_hash"&gt;Где появляется новая стоимость&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;&lt;strong&gt;Чанки переписываются при появлении новых бакетов.&lt;/strong&gt; В TSDB все гистограммы внутри одного чанка делят общий layout: схему, порог zero-бакета, набор спанов. Если в новом сэмпле появился бакет, которого не было в предыдущих, его нужно добавить как явно незаполненный во все ранее записанные гистограммы чанка. Спецификация говорит об этом прямо: «This requires a complete re-encoding of the entire chunk»&lt;sup id="fnref13:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;. На практике это означает, что редкие выбросы в хвосте распределения, порождающие новые бакеты, заставляют переписывать чанк целиком — и чем выше разрешение, тем чаще это происходит.&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;Исчезновение бакета — это counter reset.&lt;/strong&gt; Для counter-гистограммы reset определяется не только падением общего счётчика: падение популяции любого бакета, включая zero-бакет, тоже считается сбросом. Совместимое понижение схемы (уменьшение &lt;code&gt;n&lt;/code&gt;) и расширение zero-бакета сбросом не считаются&lt;sup id="fnref14:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;. Отсюда практическое следствие: динамическое изменение разрешения — это не «просто перестройка», а событие, которое TSDB обязана трактовать как reset, если оно не укладывается в правила совместимости.&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;Размер чанка.&lt;/strong&gt; Для float-чанков действует лимит 1024 байта, и для гистограммных его тоже применяют, но с оговоркой: лимит включается только после того, как в чанке набралось минимум десять гистограмм. Одна гистограмма с большим числом бакетов может сама занимать больше 1024 байт, и тогда лимит вообще не enforceable&lt;sup id="fnref15:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;. Это ещё один аргумент против «включим максимальное разрешение на всякий случай»: разрешение прямо конвертируется в размер чанка и в худшую компрессию.&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;Потолок схемы на приёме.&lt;/strong&gt; Prometheus хранит стандартные экспоненциальные схемы не выше 8. Более высокие схемы (до зарезервированных 52) он принимает, но понижает разрешение при ingest — либо до 8, либо до значения, которое требуют &lt;code&gt;native_histogram_bucket_limit&lt;/code&gt; и &lt;code&gt;native_histogram_min_bucket_factor&lt;/code&gt;&lt;sup id="fnref16:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;. То есть инструментирование «в схеме 20» бессмысленно: до TSDB оно доедет в лучшем случае восьмой.&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;Ограничение числа бакетов в библиотеке — это сбросы.&lt;/strong&gt; Инструментальные библиотеки предлагают лимит &lt;code&gt;NativeHistogramMaxBucketNumber&lt;/code&gt; (в Go по умолчанию ноль, то есть лимита нет). При превышении применяются три меры по порядку: полный сброс гистограммы, если с прошлого сброса прошло достаточно времени; повышение порога zero-бакета; понижение схемы&lt;sup id="fnref17:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;. Сброс означает потерю наблюдений между scrape — спецификация честно предупреждает, что это допустимо, только если происходит редко по сравнению с интервалом опроса, и рекомендует &lt;code&gt;NativeHistogramMinResetDuration&lt;/code&gt; порядка часа&lt;sup id="fnref18:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;. И там же сказано, что при отсутствии лимита широкая распределённость значений может использоваться как вектор DoS на память процесса, — Go-библиотека по умолчанию бакеты не ограничивает&lt;sup id="fnref19:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;h2 id="scrape-протокол-становится-частью-цены"&gt;&lt;a href="#scrape-%d0%bf%d1%80%d0%be%d1%82%d0%be%d0%ba%d0%be%d0%bb-%d1%81%d1%82%d0%b0%d0%bd%d0%be%d0%b2%d0%b8%d1%82%d1%81%d1%8f-%d1%87%d0%b0%d1%81%d1%82%d1%8c%d1%8e-%d1%86%d0%b5%d0%bd%d1%8b" class="post_hash"&gt;Scrape: протокол становится частью цены&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Сам по себе &lt;code&gt;scrape_native_histograms: true&lt;/code&gt; не только разрешает приём нового типа. Он меняет приоритеты согласования формата: если &lt;code&gt;scrape_protocols&lt;/code&gt; не задан явно, эффективный список становится &lt;code&gt;[PrometheusProto, OpenMetricsText1.0.0, OpenMetricsText0.0.1, PrometheusText0.0.4]&lt;/code&gt;, то есть protobuf выходит на первое место&lt;sup id="fnref20:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;. Без protobuf native histograms не передать: текстовый формат Prometheus для них не расширялся и не планируется&lt;sup id="fnref21:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;Здесь есть контринтуитивная деталь, которую легко пропустить при планировании ёмкости:&lt;/p&gt;&#10;&lt;blockquote&gt;&#10;&lt;p&gt;«…certain implementation details result in the counter-intuitive effect that scraping with a text-based format is generally much less resource demanding than scraping with a protobuf-based format.»&lt;sup id="fnref22:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;/blockquote&gt;&#10;&lt;p&gt;То есть включение native histograms может поднять CPU на scrape даже до того, как гистограммы начнут занимать заметное место в TSDB, — просто потому, что таргет и сервер перешли на protobuf. Спецификация отсылает к трекинговой проблеме с деталями, не утверждая, что это быстро исправят.&lt;/p&gt;&#10;&lt;p&gt;Второй слой — доступность формата на стороне клиента. Спецификация по состоянию на 15 июня 2026 года называет три официальные библиотеки инструментирования с поддержкой native histograms; для чисто текстовых библиотек обязательным условием остаётся появление текстового формата экспозиции, работа над которым продолжается&lt;sup id="fnref23:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;. Если ваш экспортёр написан на библиотеке без protobuf, native-режим ему просто нечего отдать.&lt;/p&gt;&#10;&lt;p&gt;Третий слой — лимиты. Оба параметра scrape-конфига, &lt;code&gt;native_histogram_bucket_limit&lt;/code&gt; и &lt;code&gt;native_histogram_min_bucket_factor&lt;/code&gt;, по умолчанию равны нулю, что означает «без лимита»&lt;sup id="fnref1:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;. Для сервера, который опрашивает чужие таргеты, это означает, что верхнюю границу стоимости одной гистограммы вы не задали. Grafana Mimir, например, рекомендует ограничение в 160 бакетов на сэмпл (это же значение — дефолт OTel SDK для экспоненциальных гистограмм) и по умолчанию не отбрасывает такие сэмплы, а понижает разрешение слиянием бакетов&lt;sup id="fnref:15"&gt;&lt;a href="#fn:15" class="footnote-ref" role="doc-noteref"&gt;15&lt;/a&gt;&lt;/sup&gt;. Это разумная отправная точка и для Prometheus: 160 бакетов при схеме 3 покрывают примерно 20 октав.&lt;/p&gt;&#10;&lt;h2 id="запросы-le-исчезает-интерполяция-остаётся"&gt;&lt;a href="#%d0%b7%d0%b0%d0%bf%d1%80%d0%be%d1%81%d1%8b-le-%d0%b8%d1%81%d1%87%d0%b5%d0%b7%d0%b0%d0%b5%d1%82-%d0%b8%d0%bd%d1%82%d0%b5%d1%80%d0%bf%d0%be%d0%bb%d1%8f%d1%86%d0%b8%d1%8f-%d0%be%d1%81%d1%82%d0%b0%d1%91%d1%82%d1%81%d1%8f" class="post_hash"&gt;Запросы: &lt;code&gt;le&lt;/code&gt; исчезает, интерполяция остаётся&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Синтаксис запросов меняется меньше, чем можно ожидать. Классический вариант требует группировки по &lt;code&gt;le&lt;/code&gt;, потому что бакеты — отдельные серии; native-вариант группируется только по интересующим меткам&lt;sup id="fnref1:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;:&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-fallback" data-lang="fallback"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;histogram_quantile(0.9, sum by (job) (rate(http_request_duration_seconds_bucket[10m]))) # classic&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;histogram_quantile(0.9, sum by (job) (rate(http_request_duration_seconds[10m]))) # native&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Семантика квантиля при этом не становится точной. Если значение квантиля не совпадает с границей бакета, &lt;code&gt;histogram_quantile&lt;/code&gt; интерполирует: для классических гистограмм, для NHCB и для zero-бакета — линейно, а для ненулевых бакетов стандартной экспоненциальной схемы — «экспоненциально», в предположении, что наблюдения равномерно заполнили бы бакеты гипотетической гистограммы более высокого разрешения&lt;sup id="fnref2:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;. Практический смысл: относительная погрешность привязана к коэффициенту роста бакета, а не к абсолютной ширине, поэтому хвост распределения оценивается не хуже головы — но точной границы SLO, как у классической гистограммы с бакетом ровно на 300 мс, вы не получите, пока не используете NHCB&lt;sup id="fnref:16"&gt;&lt;a href="#fn:16" class="footnote-ref" role="doc-noteref"&gt;16&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;Для native histograms появился отдельный набор функций: &lt;code&gt;histogram_count&lt;/code&gt;, &lt;code&gt;histogram_sum&lt;/code&gt;, &lt;code&gt;histogram_avg&lt;/code&gt;, &lt;code&gt;histogram_fraction&lt;/code&gt;, &lt;code&gt;histogram_stddev&lt;/code&gt;, &lt;code&gt;histogram_stdvar&lt;/code&gt;&lt;sup id="fnref3:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;. Они работают только с гистограммами и молча игнорируют float-сэмплы. Для скорости наблюдений рекомендуется сначала применить &lt;code&gt;rate&lt;/code&gt;, а потом &lt;code&gt;histogram_count&lt;/code&gt; — &lt;code&gt;histogram_count(rate(x[10m]))&lt;/code&gt;, а не наоборот&lt;sup id="fnref4:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;. Для фильтрации по диапазону есть trim-операторы &lt;code&gt;&amp;lt;/&lt;/code&gt; и &lt;code&gt;&amp;gt;/&lt;/code&gt;, которые вырезают наблюдения выше или ниже порога и возвращают гистограмму&lt;sup id="fnref24:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;Есть две ловушки агрегации. Первая: при слиянии гистограмм с разным разрешением используется наименьшее общее, поэтому высокое разрешение, в которое вы инструментировали один сервис, исчезнет, как только он агрегируется с низкорезолюционным соседом; спецификация прямо называет стратегию «максимальное разрешение в бюджет 160 бакетов» нерекомендуемой для Prometheus из-за churn и бессмысленности при агрегации&lt;sup id="fnref25:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;. Вторая: если в диапазоне серии смешаны float- и histogram-сэмплы, &lt;code&gt;sum&lt;/code&gt;/&lt;code&gt;avg&lt;/code&gt; удаляют такую серию из результата с warn-аннотацией — дашборд просто потеряет линию, и это будет выглядеть как «метрика пропала»&lt;sup id="fnref26:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;Наконец, важное требование к запросам по кумулятивным метрикам: &lt;code&gt;histogram_quantile&lt;/code&gt; и &lt;code&gt;histogram_fraction&lt;/code&gt; нужно применять к результату &lt;code&gt;rate&lt;/code&gt;/&lt;code&gt;increase&lt;/code&gt; с подходящим range-селектором. Без него функция возьмёт текущее накопленное значение гистограммы за всё время жизни (или с последнего сброса), и квантиль будет посчитан по всей истории, а не по окну&lt;sup id="fnref:17"&gt;&lt;a href="#fn:17" class="footnote-ref" role="doc-noteref"&gt;17&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;h2 id="remote-write-и-бэкенды-совместимость-не-равна-формату"&gt;&lt;a href="#remote-write-%d0%b8-%d0%b1%d1%8d%d0%ba%d0%b5%d0%bd%d0%b4%d1%8b-%d1%81%d0%be%d0%b2%d0%bc%d0%b5%d1%81%d1%82%d0%b8%d0%bc%d0%be%d1%81%d1%82%d1%8c-%d0%bd%d0%b5-%d1%80%d0%b0%d0%b2%d0%bd%d0%b0-%d1%84%d0%be%d1%80%d0%bc%d0%b0%d1%82%d1%83" class="post_hash"&gt;Remote write и бэкенды: совместимость не равна формату&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Отправка на удалённое хранилище включается отдельно: &lt;code&gt;send_native_histograms&lt;/code&gt; по умолчанию &lt;code&gt;false&lt;/code&gt;&lt;sup id="fnref2:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;. Протокол remote write 2.0, который несёт гистограммы как полноценный тип, по состоянию на октябрь 2026 года всё ещё экспериментален — версия спецификации 2.0-rc.6&lt;sup id="fnref:18"&gt;&lt;a href="#fn:18" class="footnote-ref" role="doc-noteref"&gt;18&lt;/a&gt;&lt;/sup&gt;. В remote write 1.0 протобуф-спецификации были расширены полями для гистограмм, и здесь зарыта главная ловушка:&lt;/p&gt;&#10;&lt;blockquote&gt;&#10;&lt;p&gt;«Receivers not capable of processing native histograms will simply ignore the newly added fields.»&lt;sup id="fnref27:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;/blockquote&gt;&#10;&lt;p&gt;Иными словами, приёмник, который не умеет native histograms, не вернёт ошибку и не отклонит запись — он молча проигнорирует поля. На стороне отправителя это выглядит как успешный remote write, а в долгосрочном хранилище гистограмм просто нет. Проверять надо не «remote write не ругается», а наличие гистограмм в приёмнике.&lt;/p&gt;&#10;&lt;p&gt;Дальше начинаются различия реализаций, и они принципиальны:&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;strong&gt;Grafana Mimir&lt;/strong&gt; поддерживает приём native histograms, но включает его флагом &lt;code&gt;-ingester.native-histograms-ingestion-enabled=true&lt;/code&gt; (глобально или через runtime-настройку тенанта). Ограничение числа бакетов — &lt;code&gt;-validation.max-native-histogram-buckets&lt;/code&gt;, рекомендуемое значение 160&lt;sup id="fnref1:15"&gt;&lt;a href="#fn:15" class="footnote-ref" role="doc-noteref"&gt;15&lt;/a&gt;&lt;/sup&gt;. Панели Histogram и Heatmap в Grafana умеют отображать native-тип напрямую, остальные панели требуют производных float-серий через &lt;code&gt;histogram_*&lt;/code&gt;-функции&lt;sup id="fnref1:17"&gt;&lt;a href="#fn:17" class="footnote-ref" role="doc-noteref"&gt;17&lt;/a&gt;&lt;/sup&gt;.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Thanos Receive&lt;/strong&gt; приём native histograms уже включает всегда: флаг &lt;code&gt;--tsdb.enable-native-histograms&lt;/code&gt; объявлен устаревшим no-op, «Native histogram ingestion is always enabled»&lt;sup id="fnref:19"&gt;&lt;a href="#fn:19" class="footnote-ref" role="doc-noteref"&gt;19&lt;/a&gt;&lt;/sup&gt;.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;VictoriaMetrics&lt;/strong&gt; пошёл другим путём. Начиная с v1.143.0 (выпуск 8 мая 2026) native histograms при ingest автоматически конвертируются в формат гистограмм VictoriaMetrics с метками &lt;code&gt;vmrange&lt;/code&gt;&lt;sup id="fnref:20"&gt;&lt;a href="#fn:20" class="footnote-ref" role="doc-noteref"&gt;20&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:21"&gt;&lt;a href="#fn:21" class="footnote-ref" role="doc-noteref"&gt;21&lt;/a&gt;&lt;/sup&gt;. Это совместимость на уровне приёма данных, а не хранение native-типа; в трекере проекта формулируют прямо: «Storing native histograms in their original format &lt;strong&gt;is not a goal&lt;/strong&gt; at this time»&lt;sup id="fnref1:20"&gt;&lt;a href="#fn:20" class="footnote-ref" role="doc-noteref"&gt;20&lt;/a&gt;&lt;/sup&gt;. Запросы придётся писать в терминах &lt;code&gt;vmrange&lt;/code&gt;, а исходный issue остаётся открытым — не исключено появление поддержки scrape native histograms, но модель хранения меняется уже сейчас&lt;sup id="fnref2:20"&gt;&lt;a href="#fn:20" class="footnote-ref" role="doc-noteref"&gt;20&lt;/a&gt;&lt;/sup&gt;.&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;p&gt;Отсюда общий вывод для гетерогенного homelab: цепочка «Prometheus → remote write → хранилище → Grafana» может быть «совместимой» на каждом шаге и при этом не сохранять native-семантику. Проверять нужно конечный результат — наличие гистограммных сэмплов и корректность &lt;code&gt;histogram_quantile&lt;/code&gt; на них, а не коды ответа remote write.&lt;/p&gt;&#10;&lt;h2 id="миграция-без-потери-данных"&gt;&lt;a href="#%d0%bc%d0%b8%d0%b3%d1%80%d0%b0%d1%86%d0%b8%d1%8f-%d0%b1%d0%b5%d0%b7-%d0%bf%d0%be%d1%82%d0%b5%d1%80%d0%b8-%d0%b4%d0%b0%d0%bd%d0%bd%d1%8b%d1%85" class="post_hash"&gt;Миграция без потери данных&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Прямого переключения «включили и забыли» нет, и проект это признаёт: рекомендуемый путь — период параллельного сбора классических и native-гистограмм&lt;sup id="fnref28:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;. Для этого в scrape-конфиге есть &lt;code&gt;always_scrape_classic_histograms: true&lt;/code&gt;: обе версии попадают в TSDB, потому что классические бакеты пишутся как отдельные серии с суффиксами, а native — как одна серия с исходным именем, и конфликта между ними нет&lt;sup id="fnref29:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;Если инструментирование менять не хочется, есть промежуточный шаг — NHCB, native histograms with custom buckets (схема −53). Это тот же классический набор границ, но упакованный в один сэмпл: &lt;code&gt;convert_classic_histograms_to_nhcb: true&lt;/code&gt; в scrape-конфиге заставляет Prometheus конвертировать классические гистограммы при опросе&lt;sup id="fnref30:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:16"&gt;&lt;a href="#fn:16" class="footnote-ref" role="doc-noteref"&gt;16&lt;/a&gt;&lt;/sup&gt;. Grafana Mimir описывает ровно два сценария использования native histograms: высокое разрешение с экспоненциальными бакетами и дешёвое хранение классических гистограмм через custom buckets — второй не требует менять инструментирование вообще&lt;sup id="fnref:22"&gt;&lt;a href="#fn:22" class="footnote-ref" role="doc-noteref"&gt;22&lt;/a&gt;&lt;/sup&gt;. NHCB дают один атомарный сэмпл вместо независимых серий, которые могут потеряться или задержаться по отдельности, и заметно дешевле в хранении&lt;sup id="fnref2:16"&gt;&lt;a href="#fn:16" class="footnote-ref" role="doc-noteref"&gt;16&lt;/a&gt;&lt;/sup&gt;. Но у них есть жёсткое ограничение: при слиянии NHCB с разными наборами границ сохраняются только точные совпадения границ. Спецификация предупреждает, что произвольное изменение раскладки бакетов легко приводит к гистограмме с одним overflow-бакетом, то есть к полной потере разрешения&lt;sup id="fnref31:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;Классическая ловушка миграции — длинные range-векторы. Запрос вида &lt;code&gt;histogram_quantile(0.9, rate(rpc_duration_seconds[1d]))&lt;/code&gt; корректно работает только тогда, когда native-гистограммы собираются уже хотя бы сутки; до этого он считает квантиль по более короткому реальному окну, молча&lt;sup id="fnref32:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;. Поэтому длинные окна в дашбордах переключают последними, а параллельный сбор держат не меньше самого длинного окна — спецификация приводит месяц как достаточный срок для дашбордов, не заглядывающих дальше месяца&lt;sup id="fnref33:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;Ещё одна граница — экспорт и backfill. &lt;code&gt;promtool tsdb create-blocks-from openmetrics&lt;/code&gt; не поддерживает native histograms и staleness-маркеры, потому что в OpenMetrics их нельзя представить&lt;sup id="fnref:23"&gt;&lt;a href="#fn:23" class="footnote-ref" role="doc-noteref"&gt;23&lt;/a&gt;&lt;/sup&gt;. Если ваш пайплайн бэкапа или миграции между серверами основан на выгрузке в OpenMetrics, гистограммы в него не попадут — это не ошибка конфигурации, а свойство формата.&lt;/p&gt;&#10;&lt;h2 id="когда-включать-не-стоит"&gt;&lt;a href="#%d0%ba%d0%be%d0%b3%d0%b4%d0%b0-%d0%b2%d0%ba%d0%bb%d1%8e%d1%87%d0%b0%d1%82%d1%8c-%d0%bd%d0%b5-%d1%81%d1%82%d0%be%d0%b8%d1%82" class="post_hash"&gt;Когда включать не стоит&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Есть четыре случая, когда native histograms проигрывают классическим:&lt;/p&gt;&#10;&lt;ol&gt;&#10;&lt;li&gt;&lt;strong&gt;Точная граница SLO важнее гибкости.&lt;/strong&gt; Классический бакет ровно на 300 мс даёт точную долю запросов в пределах порога; native с экспоненциальной схемой даёт интерполяцию, и граница появится только у NHCB&lt;sup id="fnref3:16"&gt;&lt;a href="#fn:16" class="footnote-ref" role="doc-noteref"&gt;16&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref5:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Мало наборов меток и мало бакетов.&lt;/strong&gt; Если у сервиса одна гистограмма на десять бакетов без размножения по меткам, экономия на сериях незначительна, а размер сэмпла и churn чанков остаются&lt;sup id="fnref34:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Долгосрочное хранилище конвертирует формат.&lt;/strong&gt; VictoriaMetrics с v1.143.0 превращает native в &lt;code&gt;vmrange&lt;/code&gt;-серии; вы получите другую модель запросов и потеряете native-семантику на выходе&lt;sup id="fnref3:20"&gt;&lt;a href="#fn:20" class="footnote-ref" role="doc-noteref"&gt;20&lt;/a&gt;&lt;/sup&gt;.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Пайплайн завязан на текст.&lt;/strong&gt; OpenMetrics и текстовый формат Prometheus native histograms не несут; scrape без protobuf их не получит, а backfill из OpenMetrics — не восстановит&lt;sup id="fnref35:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:23"&gt;&lt;a href="#fn:23" class="footnote-ref" role="doc-noteref"&gt;23&lt;/a&gt;&lt;/sup&gt;.&lt;/li&gt;&#10;&lt;/ol&gt;&#10;&lt;p&gt;Отдельно стоит сказать про свидетельства роста потребления. Есть разбор 2024 года, где после включения native histograms наблюдали рост памяти head примерно вдвое, ускоренный рост WAL, отставание remote write и таймауты дашбордов; автор оговаривает, что это анонимизированный инцидент на Prometheus 2.48–2.53, то есть на предстабильных версиях&lt;sup id="fnref:24"&gt;&lt;a href="#fn:24" class="footnote-ref" role="doc-noteref"&gt;24&lt;/a&gt;&lt;/sup&gt;. Механизм правдоподобен и следует из описанного выше: больше байт на сэмпл, больше работа по кодированию чанков, дороже декодирование при запросах. Но это одно свидетельство без воспроизводимых замеров, и переносить его числа на 3.16 нельзя — это гипотеза для проверки на своём стенде, а не факт.&lt;/p&gt;&#10;&lt;p&gt;Симметрично нужно относиться и к вендорским цифрам «на 30% меньше бакетов» из кейса Grafana Cloud: это отчёт вендора о клиенте, без методики и без независимого подтверждения&lt;sup id="fnref1:14"&gt;&lt;a href="#fn:14" class="footnote-ref" role="doc-noteref"&gt;14&lt;/a&gt;&lt;/sup&gt;. Он показывает направление, а не величину выигрыша.&lt;/p&gt;&#10;&lt;h2 id="практический-чеклист"&gt;&lt;a href="#%d0%bf%d1%80%d0%b0%d0%ba%d1%82%d0%b8%d1%87%d0%b5%d1%81%d0%ba%d0%b8%d0%b9-%d1%87%d0%b5%d0%ba%d0%bb%d0%b8%d1%81%d1%82" class="post_hash"&gt;Практический чеклист&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Если решение всё-таки включать, порядок действий такой:&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;strong&gt;Начните с одного job&amp;rsquo;а&lt;/strong&gt;, где классическая гистограмма размножается по меткам (маршрут × статус × инстанс), а не со всех сразу: там выигрыш на сериях максимален, а радиус поражения при ошибке — минимален&lt;sup id="fnref36:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Задайте разрешение осознанно.&lt;/strong&gt; Коэффициент 1.1 (схема 3) — разумный дефолт; 1.005 (схема 8) увеличивает число бакетов и churn, а при агрегации с низкорезолюционными соседями всё равно понизится&lt;sup id="fnref37:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref1:9"&gt;&lt;a href="#fn:9" class="footnote-ref" role="doc-noteref"&gt;9&lt;/a&gt;&lt;/sup&gt;.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Поставьте лимит бакетов на scrape&lt;/strong&gt; (&lt;code&gt;native_histogram_bucket_limit&lt;/code&gt;), потому что по умолчанию его нет, и тот же лимит продублируйте в инструментировании, если можете&lt;sup id="fnref3:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref38:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Включите &lt;code&gt;send_native_histograms&lt;/code&gt; и проверьте приёмник&lt;/strong&gt;, а не только отсутствие ошибок: remote write 1.0 молча игнорирует непонятные поля&lt;sup id="fnref39:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref4:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Держите период параллельного сбора&lt;/strong&gt; не короче самого длинного range-вектора в дашбордах и не короче ретенции, если планируете сверять старые данные&lt;sup id="fnref40:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Перепишите запросы и панели заранее.&lt;/strong&gt; &lt;code&gt;histogram_quantile&lt;/code&gt; без &lt;code&gt;le&lt;/code&gt;, &lt;code&gt;histogram_count(rate(...))&lt;/code&gt; для RPS, панели Histogram/Heatmap — для native, остальные — через производные float-серии&lt;sup id="fnref6:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:17"&gt;&lt;a href="#fn:17" class="footnote-ref" role="doc-noteref"&gt;17&lt;/a&gt;&lt;/sup&gt;.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Следите за тремя точками давления&lt;/strong&gt;: серии head, размер WAL и очередь remote write. Именно они первыми показывают, что цена формата оказалась выше ожидаемой&lt;sup id="fnref1:24"&gt;&lt;a href="#fn:24" class="footnote-ref" role="doc-noteref"&gt;24&lt;/a&gt;&lt;/sup&gt;.&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;h2 id="заключение"&gt;&lt;a href="#%d0%b7%d0%b0%d0%ba%d0%bb%d1%8e%d1%87%d0%b5%d0%bd%d0%b8%d0%b5" class="post_hash"&gt;Заключение&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Главный вывод: native histograms — это не «оптимизация хранения», а смена единицы учёта. Они убирают из индекса произведение «метки × бакеты», перенося разрешение внутрь сэмпла, и выигрыш проявляется там, где это произведение было большим. Там, где гистограмм мало и они не размножаются по меткам, формат добавляет стоимость — протокол, чанки, декодирование — почти без выгоды. Стабильность в 3.8/3.13 делает формат безопасным для производства, но не делает его бесплатным и не отменяет проверку всей цепочки до хранилища.&lt;/p&gt;&#10;&lt;h2 id="quality-metrics"&gt;&lt;a href="#quality-metrics" class="post_hash"&gt;Quality Metrics&lt;/a&gt;&lt;/h2&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Metric&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Value&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Sources found&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;45&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Sources read&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;30&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Sources cited&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;24&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Citation coverage&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;82%&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Words (main text, checker count)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;3806&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Data date&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;2026-11-16&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Own measurements&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;none (arithmetic only)&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Official/spec/academic share of cited sources&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;22 of 24&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Secondary sources cited&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;2 (vendor blog, production report)&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;div class="footnotes" role="doc-endnotes"&gt;&#10;&lt;hr&gt;&#10;&lt;ol&gt;&#10;&lt;li id="fn:1"&gt;&#10;&lt;p&gt;Prometheus. &amp;ldquo;Native Histograms.&amp;rdquo; Prometheus documentation, accessed 2026-11-16. &lt;a href="https://prometheus.io/docs/specs/native_histograms/"&gt;https://prometheus.io/docs/specs/native_histograms/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref7:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref8:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref9:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref10:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref11:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref12:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref13:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref14:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref15:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref16:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref17:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref18:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref19:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref20:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref21:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref22:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref23:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref24:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref25:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref26:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref27:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref28:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref29:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref30:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref31:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref32:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref33:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref34:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref35:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref36:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref37:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref38:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref39:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref40:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:2"&gt;&#10;&lt;p&gt;Prometheus. &amp;ldquo;3.16.0 / 2026-11-04.&amp;rdquo; GitHub release notes. &lt;a href="https://github.com/prometheus/prometheus/releases/tag/v3.16.0"&gt;https://github.com/prometheus/prometheus/releases/tag/v3.16.0&lt;/a&gt;&amp;#160;&lt;a href="#fnref:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:3"&gt;&#10;&lt;p&gt;Prometheus. &amp;ldquo;3.13.0 / 2026-07-01.&amp;rdquo; GitHub release notes. &lt;a href="https://github.com/prometheus/prometheus/releases/tag/v3.13.0"&gt;https://github.com/prometheus/prometheus/releases/tag/v3.13.0&lt;/a&gt;&amp;#160;&lt;a href="#fnref:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:4"&gt;&#10;&lt;p&gt;Prometheus. &amp;ldquo;3.8.0 / 2025-11-28.&amp;rdquo; GitHub release notes, published 2025-12-02. &lt;a href="https://github.com/prometheus/prometheus/releases/tag/v3.8.0"&gt;https://github.com/prometheus/prometheus/releases/tag/v3.8.0&lt;/a&gt;&amp;#160;&lt;a href="#fnref:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:5"&gt;&#10;&lt;p&gt;Prometheus. &amp;ldquo;Configuration.&amp;rdquo; Prometheus documentation, accessed 2026-11-16. &lt;a href="https://prometheus.io/docs/prometheus/latest/configuration/configuration/"&gt;https://prometheus.io/docs/prometheus/latest/configuration/configuration/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:6"&gt;&#10;&lt;p&gt;Prometheus. &amp;ldquo;Long-term support.&amp;rdquo; Prometheus documentation, accessed 2026-11-16. &lt;a href="https://prometheus.io/docs/introduction/release-cycle/"&gt;https://prometheus.io/docs/introduction/release-cycle/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:6" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:7"&gt;&#10;&lt;p&gt;Prometheus. &amp;ldquo;Query functions.&amp;rdquo; Prometheus documentation, accessed 2026-11-16. &lt;a href="https://prometheus.io/docs/prometheus/latest/querying/functions/"&gt;https://prometheus.io/docs/prometheus/latest/querying/functions/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:8"&gt;&#10;&lt;p&gt;Prometheus. &amp;ldquo;Histograms and summaries.&amp;rdquo; Prometheus documentation, accessed 2026-11-16. &lt;a href="https://prometheus.io/docs/practices/histograms/"&gt;https://prometheus.io/docs/practices/histograms/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:8" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:8" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:9"&gt;&#10;&lt;p&gt;Prometheus. &amp;ldquo;client_golang/prometheus/histogram.go.&amp;rdquo; GitHub source, accessed 2026-11-16. &lt;a href="https://github.com/prometheus/client_golang/blob/main/prometheus/histogram.go"&gt;https://github.com/prometheus/client_golang/blob/main/prometheus/histogram.go&lt;/a&gt;&amp;#160;&lt;a href="#fnref:9" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:9" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:10"&gt;&#10;&lt;p&gt;OpenTelemetry. &amp;ldquo;Metrics Data Model.&amp;rdquo; OpenTelemetry specification, accessed 2026-11-16. &lt;a href="https://opentelemetry.io/docs/specs/otel/metrics/data-model/"&gt;https://opentelemetry.io/docs/specs/otel/metrics/data-model/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:10" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:11"&gt;&#10;&lt;p&gt;Grafana Labs. &amp;ldquo;Send native histograms with exponential buckets to Grafana Mimir.&amp;rdquo; Grafana Mimir documentation, accessed 2026-11-16. &lt;a href="https://grafana.com/docs/mimir/latest/send/native-histograms/_exponential_buckets/"&gt;https://grafana.com/docs/mimir/latest/send/native-histograms/_exponential_buckets/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:11" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:12"&gt;&#10;&lt;p&gt;Labo, P. T. &amp;ldquo;Using Exponential Histograms to Approximate the Quantiles of Heavy- and Light-Tailed Data.&amp;rdquo; arXiv:2404.18024, 2024. &lt;a href="https://arxiv.org/abs/2404.18024"&gt;https://arxiv.org/abs/2404.18024&lt;/a&gt;&amp;#160;&lt;a href="#fnref:12" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:13"&gt;&#10;&lt;p&gt;Masson, C., Rim, J. E., Lee, H. K. &amp;ldquo;DDSketch: A fast and fully-mergeable quantile sketch with relative-error guarantees.&amp;rdquo; arXiv:1908.10693, 2019. &lt;a href="https://arxiv.org/abs/1908.10693"&gt;https://arxiv.org/abs/1908.10693&lt;/a&gt;&amp;#160;&lt;a href="#fnref:13" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:14"&gt;&#10;&lt;p&gt;Grafana Labs. &amp;ldquo;Prometheus native histograms in Grafana Cloud: Get more precision from your Grafana visualizations.&amp;rdquo; Grafana Labs blog, November 2025. &lt;a href="https://grafana.com/blog/get-more-precision-from-your-grafana-visualizations-with-prometheus-native-histograms-in-grafana-cloud/"&gt;https://grafana.com/blog/get-more-precision-from-your-grafana-visualizations-with-prometheus-native-histograms-in-grafana-cloud/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:14" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:14" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:15"&gt;&#10;&lt;p&gt;Grafana Labs. &amp;ldquo;Configure native histograms.&amp;rdquo; Grafana Mimir documentation, accessed 2026-11-16. &lt;a href="https://grafana.com/docs/mimir/latest/configure/configure-native-histograms-ingestion/"&gt;https://grafana.com/docs/mimir/latest/configure/configure-native-histograms-ingestion/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:15" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:15" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:16"&gt;&#10;&lt;p&gt;Grafana Labs. &amp;ldquo;Send native histograms with custom buckets to Grafana Mimir.&amp;rdquo; Grafana Mimir documentation, accessed 2026-11-16. &lt;a href="https://grafana.com/docs/mimir/latest/send/native-histograms/_custom_buckets/"&gt;https://grafana.com/docs/mimir/latest/send/native-histograms/_custom_buckets/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:16" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:16" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:16" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:16" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:17"&gt;&#10;&lt;p&gt;Grafana Labs. &amp;ldquo;Visualize native histograms.&amp;rdquo; Grafana Mimir documentation, accessed 2026-11-16. &lt;a href="https://grafana.com/docs/mimir/latest/visualize/native-histograms/"&gt;https://grafana.com/docs/mimir/latest/visualize/native-histograms/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:17" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:17" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:17" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:18"&gt;&#10;&lt;p&gt;Prometheus. &amp;ldquo;Prometheus Remote-Write 2.0 specification [EXPERIMENTAL].&amp;rdquo; Version 2.0-rc.6, October 2026. &lt;a href="https://prometheus.io/docs/specs/prw/remote_write_spec_2_0/"&gt;https://prometheus.io/docs/specs/prw/remote_write_spec_2_0/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:18" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:19"&gt;&#10;&lt;p&gt;Thanos. &amp;ldquo;Receive.&amp;rdquo; Thanos documentation, accessed 2026-11-16. &lt;a href="https://thanos.io/tip/components/receive.md/"&gt;https://thanos.io/tip/components/receive.md/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:19" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:20"&gt;&#10;&lt;p&gt;VictoriaMetrics. &amp;ldquo;Native Histogram Support · Issue #3733.&amp;rdquo; GitHub, last updated 2026-09-25. &lt;a href="https://github.com/VictoriaMetrics/VictoriaMetrics/issues/3733"&gt;https://github.com/VictoriaMetrics/VictoriaMetrics/issues/3733&lt;/a&gt;&amp;#160;&lt;a href="#fnref:20" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:20" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:20" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:20" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:21"&gt;&#10;&lt;p&gt;VictoriaMetrics. &amp;ldquo;v1.143.0.&amp;rdquo; GitHub release, released 2026-05-08. &lt;a href="https://github.com/VictoriaMetrics/VictoriaMetrics/releases/tag/v1.143.0"&gt;https://github.com/VictoriaMetrics/VictoriaMetrics/releases/tag/v1.143.0&lt;/a&gt;&amp;#160;&lt;a href="#fnref:21" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:22"&gt;&#10;&lt;p&gt;Grafana Labs. &amp;ldquo;Send native histograms to Grafana Mimir.&amp;rdquo; Grafana Mimir documentation, accessed 2026-11-16. &lt;a href="https://grafana.com/docs/mimir/latest/send/native-histograms/"&gt;https://grafana.com/docs/mimir/latest/send/native-histograms/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:22" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:23"&gt;&#10;&lt;p&gt;Prometheus. &amp;ldquo;Storage.&amp;rdquo; Prometheus documentation, accessed 2026-11-16. &lt;a href="https://prometheus.io/docs/prometheus/latest/storage/"&gt;https://prometheus.io/docs/prometheus/latest/storage/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:23" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:23" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:24"&gt;&#10;&lt;p&gt;Drozd, M. &amp;ldquo;Prometheus Native Histograms in Production: Rollout Plan, Budgets, and Failure Modes.&amp;rdquo; Personal blog, 2024. &lt;a href="https://www.michal-drozd.com/en/blog/prometheus-native-histograms-production/"&gt;https://www.michal-drozd.com/en/blog/prometheus-native-histograms-production/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:24" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:24" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;/ol&gt;&#10;&lt;/div&gt;&#10;</content></entry><entry><title>Импорт банковских CSV без двойного учёта: watermark, отпечаток записи и сверка в hledger</title><id>https://research.evsyukov.org/articles/hledger-csv-import-idempotency-reconciliation/</id><link href="https://research.evsyukov.org/articles/hledger-csv-import-idempotency-reconciliation/" rel="alternate" type="text/html"/><published>2026-11-15T09:38:00+03:00</published><updated>2026-11-15T09:41:59+03:00</updated><author><name>Denis Evsyukov</name></author><summary type="html">Как на самом деле работает hledger import, где курсор по датам теряет и дублирует записи, что дают FITID и AcctSvcrRef, и почему сверка по остатку не заменяет дедупликацию.</summary><content type="html">&lt;h2 id="аннотация"&gt;&lt;a href="#%d0%b0%d0%bd%d0%bd%d0%be%d1%82%d0%b0%d1%86%d0%b8%d1%8f" class="post_hash"&gt;Аннотация&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;&lt;code&gt;hledger import&lt;/code&gt; принято описывать как идемпотентную команду: «запускайте сколько угодно раз, лишнее не импортируется». Формально это верно, но гарантия узкая: команда запоминает последнюю дату и &lt;strong&gt;количество&lt;/strong&gt; записей на ней, а не сами записи. Всё, что попало в выгрузку раньше этого курсора, отбрасывается молча — и новая запись тоже, если банк провёл её задним числом&lt;sup id="fnref:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;. Это не дедупликация, а курсор по префиксу; сам проект это и не скрывает: «We don&amp;rsquo;t call this &amp;ldquo;deduplication&amp;rdquo;, as it&amp;rsquo;s generally not possible to reliably detect duplicates in bank CSV»&lt;sup id="fnref1:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;Ниже разобрано, как устроен этот курсор на уровне кода, что происходит при пяти типовых сценариях его отказа (все проверены прогонами на hledger 1.52.4), чем идентификатор операции в OFX и ISO 20022 отличается от отпечатка содержимого, и почему сверка по закрывающему остатку — отдельный механизм, который ловит не то, что ловит импорт. Данные на 2026-11-15. Версия под наблюдением — hledger 1.52.4, последний стабильный выпуск от 10 сентября 2026 года; 2.0 остаётся предварительной: 1.99.6 от 1 ноября 2026 помечен как «2.0 preview 6»&lt;sup id="fnref:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt;. Собственных замеров банковских выгрузок у меня нет: все числа ниже получены на синтетических CSV, которые я составил специально под каждый сценарий.&lt;/p&gt;&#10;&lt;h2 id="введение-три-разные-задачи-которые-называют-одним-словом"&gt;&lt;a href="#%d0%b2%d0%b2%d0%b5%d0%b4%d0%b5%d0%bd%d0%b8%d0%b5-%d1%82%d1%80%d0%b8-%d1%80%d0%b0%d0%b7%d0%bd%d1%8b%d0%b5-%d0%b7%d0%b0%d0%b4%d0%b0%d1%87%d0%b8-%d0%ba%d0%be%d1%82%d0%be%d1%80%d1%8b%d0%b5-%d0%bd%d0%b0%d0%b7%d1%8b%d0%b2%d0%b0%d1%8e%d1%82-%d0%be%d0%b4%d0%bd%d0%b8%d0%bc-%d1%81%d0%bb%d0%be%d0%b2%d0%be%d0%bc" class="post_hash"&gt;Введение: три разные задачи, которые называют одним словом&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Разговор об импорте банковских данных обычно смешивает три вещи с разными инвариантами.&lt;/p&gt;&#10;&lt;p&gt;Первая — &lt;strong&gt;идентичность операции&lt;/strong&gt;: нужно уметь сказать, что строка из сегодняшней выгрузки и строка из прошлой — это одна и та же операция банка. Вторая — &lt;strong&gt;ровно однократное применение&lt;/strong&gt;: одна операция должна попасть в журнал один раз, независимо от того, сколько раз скачана выписка и с какими перекрытиями. Третья — &lt;strong&gt;сверка&lt;/strong&gt;: журнал должен сойтись с тем, что банк считает остатком на счёте.&lt;/p&gt;&#10;&lt;p&gt;Для человека, который ведёт журнал в git и раз в неделю качает CSV, эти три задачи выглядят как одна кнопка. Для инструментов это три разных механизма с разной силой. hledger из коробки даёт третий (balance assertions) и очень слабую версию второго (курсор), а первый оставляет пользователю. OFX-ориентированные инструменты — GnuCash, beancount-import — получают первый бесплатно из формата и строят на нём второй&lt;sup id="fnref:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:6"&gt;&lt;a href="#fn:6" class="footnote-ref" role="doc-noteref"&gt;6&lt;/a&gt;&lt;/sup&gt;. CSV-выгрузка не даёт ничего: в ней обычно нет ни идентификатора операции, ни даже гарантии, что описание не изменится между выгрузками.&lt;/p&gt;&#10;&lt;p&gt;Тезис статьи: &lt;strong&gt;курсор по датам — это не идентичность, а позиция в файле&lt;/strong&gt;. Он работает до тех пор, пока выписка ведёт себя как append-only лог с монотонными датами, и тихо перестаёт работать во всех остальных случаях — причём в обе стороны, и с потерями, и с дублями&lt;sup id="fnref1:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;h2 id="как-устроен-курсор"&gt;&lt;a href="#%d0%ba%d0%b0%d0%ba-%d1%83%d1%81%d1%82%d1%80%d0%be%d0%b5%d0%bd-%d0%ba%d1%83%d1%80%d1%81%d0%be%d1%80" class="post_hash"&gt;Как устроен курсор&lt;/a&gt;&lt;/h2&gt;&#10;&lt;h3 id="состояние--файл-latestfile"&gt;&lt;a href="#%d1%81%d0%be%d1%81%d1%82%d0%be%d1%8f%d0%bd%d0%b8%d0%b5--%d1%84%d0%b0%d0%b9%d0%bb-latestfile" class="post_hash"&gt;Состояние — файл &lt;code&gt;.latest.FILE&lt;/code&gt;&lt;/a&gt;&lt;/h3&gt;&#10;&lt;p&gt;Для каждого импортируемого файла hledger держит скрытый файл &lt;code&gt;.latest.&amp;lt;имя&amp;gt;&lt;/code&gt; в том же каталоге. В нём лежит последняя дата импортированных записей, записанная в формате &lt;code&gt;YYYY-MM-DD&lt;/code&gt;, и — если на эту дату пришлось несколько записей — дата повторяется столько раз, сколько было записей&lt;sup id="fnref2:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;. После импорта в каталоге с &lt;code&gt;bank.csv&lt;/code&gt; появляется &lt;code&gt;.latest.bank.csv&lt;/code&gt;; в моём прогоне для трёх записей с датами 1, 2 и 3 ноября файл содержал одну строку &lt;code&gt;2026-11-03&lt;/code&gt;, а когда на последнюю дату пришлось две записи — две одинаковые строки&lt;sup id="fnref2:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;Имя файла состояния — функция от имени данных: &lt;code&gt;latestDatesFileFor f = dir &amp;lt;/&amp;gt; &amp;quot;.latest&amp;quot; &amp;lt;.&amp;gt; fname&lt;/code&gt;&lt;sup id="fnref3:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;. Отсюда первое практическое следствие: состояние привязано не к счёту и не к банку, а к конкретному имени файла на диске. Скачали выписку как &lt;code&gt;bank (2).csv&lt;/code&gt; — получили новое состояние и новый, пустой курсор.&lt;/p&gt;&#10;&lt;h3 id="фильтр--сравнение-по-дате-плюс-позиции"&gt;&lt;a href="#%d1%84%d0%b8%d0%bb%d1%8c%d1%82%d1%80--%d1%81%d1%80%d0%b0%d0%b2%d0%bd%d0%b5%d0%bd%d0%b8%d0%b5-%d0%bf%d0%be-%d0%b4%d0%b0%d1%82%d0%b5-%d0%bf%d0%bb%d1%8e%d1%81-%d0%bf%d0%be%d0%b7%d0%b8%d1%86%d0%b8%d0%b8" class="post_hash"&gt;Фильтр — сравнение по дате плюс позиции&lt;/a&gt;&lt;/h3&gt;&#10;&lt;p&gt;Суть алгоритма — четыре строки на Haskell:&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-haskell" data-lang="haskell"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nf"&gt;journalFilterSinceLatestDates&lt;/span&gt; &lt;span class="n"&gt;ds&lt;/span&gt;&lt;span class="o"&gt;@&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;d&lt;/span&gt;&lt;span class="kt"&gt;:&lt;/span&gt;&lt;span class="kr"&gt;_&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="n"&gt;j&lt;/span&gt; &lt;span class="ow"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;j&amp;#39;&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;ds&amp;#39;&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="kr"&gt;where&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="n"&gt;samedateorlaterts&lt;/span&gt; &lt;span class="ow"&gt;=&lt;/span&gt; &lt;span class="n"&gt;filter&lt;/span&gt; &lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;=&lt;/span&gt; &lt;span class="n"&gt;d&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="n"&gt;tdate&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;$&lt;/span&gt; &lt;span class="n"&gt;jtxns&lt;/span&gt; &lt;span class="n"&gt;j&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;samedatets&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;laterts&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="ow"&gt;=&lt;/span&gt; &lt;span class="n"&gt;span&lt;/span&gt; &lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="o"&gt;==&lt;/span&gt; &lt;span class="n"&gt;d&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="n"&gt;tdate&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;$&lt;/span&gt; &lt;span class="n"&gt;sortBy&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;comparing&lt;/span&gt; &lt;span class="n"&gt;tdate&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="n"&gt;samedateorlaterts&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="n"&gt;newsamedatets&lt;/span&gt; &lt;span class="ow"&gt;=&lt;/span&gt; &lt;span class="n"&gt;drop&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;length&lt;/span&gt; &lt;span class="n"&gt;ds&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="n"&gt;samedatets&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="n"&gt;j&amp;#39;&lt;/span&gt; &lt;span class="ow"&gt;=&lt;/span&gt; &lt;span class="n"&gt;j&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;jtxns&lt;/span&gt;&lt;span class="ow"&gt;=&lt;/span&gt;&lt;span class="n"&gt;newsamedatets&lt;/span&gt;&lt;span class="o"&gt;++&lt;/span&gt;&lt;span class="n"&gt;laterts&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Читается так: всё, что строго раньше запомненной даты, отбрасывается; из записей на этой дате отбрасываются первые &lt;code&gt;length ds&lt;/code&gt; штук — ровно столько, сколько было импортировано в прошлый раз. Новое состояние считается по всем записям на последнюю дату, включая только что отброшенные, поэтому счётчик не «съезжает»&lt;sup id="fnref4:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;. Сортировка по дате устойчивая, то есть внутри одного дня порядок — это порядок строк в CSV, и именно он определяет, какие записи попадут в «первые N».&lt;/p&gt;&#10;&lt;p&gt;Ни в одном месте этого фильтра не участвует содержимое журнала: ни описание, ни сумма, ни идентификатор записи не сравниваются с уже импортированным. Команда читает журнал, чтобы дописать в него транзакции и прогнать строгие проверки, но решение «новая или нет» принимается только по датам и счётчику&lt;sup id="fnref:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;. Это важный пункт для всего дальнейшего: любая метка, которую вы поставите в транзакции — хоть &lt;code&gt;; src-id: 12345&lt;/code&gt; — на фильтрацию не повлияет.&lt;/p&gt;&#10;&lt;h3 id="что-команда-делает-на-входе-и-на-выходе"&gt;&lt;a href="#%d1%87%d1%82%d0%be-%d0%ba%d0%be%d0%bc%d0%b0%d0%bd%d0%b4%d0%b0-%d0%b4%d0%b5%d0%bb%d0%b0%d0%b5%d1%82-%d0%bd%d0%b0-%d0%b2%d1%85%d0%be%d0%b4%d0%b5-%d0%b8-%d0%bd%d0%b0-%d0%b2%d1%8b%d1%85%d0%be%d0%b4%d0%b5" class="post_hash"&gt;Что команда делает на входе и на выходе&lt;/a&gt;&lt;/h3&gt;&#10;&lt;p&gt;Первый импорт, когда файла состояния ещё нет, забирает все записи целиком; &lt;code&gt;--catchup&lt;/code&gt; создаёт состояние, ничего не импортируя, — это способ сказать «я уже ввёл это руками»&lt;sup id="fnref3:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;. &lt;code&gt;--dry-run&lt;/code&gt; печатает транзакции, которые были бы добавлены, в формате журнала, и этот вывод можно скормить hledger повторно, например чтобы посмотреть только неразобранные строки:&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;hledger import --dry-run bank.csv &lt;span class="p"&gt;|&lt;/span&gt; hledger -f- -I print unknown&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Записи, добавленные импортом, получают все суммы явно (как &lt;code&gt;print -x&lt;/code&gt;), а стили сумм берутся из журнала, а не из CSV; balance assignments в импортируемых записях не вычисляются, потому что балансы основного журнала во время импорта не видны&lt;sup id="fnref4:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;. Всё это — следствия одной конструкции: импорт не «сливает» два источника, а отрезает от CSV префикс и дописывает хвост.&lt;/p&gt;&#10;&lt;h3 id="четыре-допущения-на-которых-всё-держится"&gt;&lt;a href="#%d1%87%d0%b5%d1%82%d1%8b%d1%80%d0%b5-%d0%b4%d0%be%d0%bf%d1%83%d1%89%d0%b5%d0%bd%d0%b8%d1%8f-%d0%bd%d0%b0-%d0%ba%d0%be%d1%82%d0%be%d1%80%d1%8b%d1%85-%d0%b2%d1%81%d1%91-%d0%b4%d0%b5%d1%80%d0%b6%d0%b8%d1%82%d1%81%d1%8f" class="post_hash"&gt;Четыре допущения, на которых всё держится&lt;/a&gt;&lt;/h3&gt;&#10;&lt;p&gt;Документация перечисляет условия, при которых курсор ведёт себя прилично, и они стоит того, чтобы прочитать их как инварианты, а не как советы&lt;sup id="fnref5:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;:&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;имя файла данных стабильно между импортами;&lt;/li&gt;&#10;&lt;li&gt;даты записей стабильны;&lt;/li&gt;&#10;&lt;li&gt;порядок записей внутри одной даты стабилен;&lt;/li&gt;&#10;&lt;li&gt;самые новые записи имеют самые новые даты&lt;sup id="fnref6:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;.&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;p&gt;Каждое из четырёх — это утверждение о поведении банка, а не о вашем коде. Ни одно из них банк вам не гарантирует&lt;sup id="fnref7:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;h2 id="пять-способов-которыми-курсор-ошибается"&gt;&lt;a href="#%d0%bf%d1%8f%d1%82%d1%8c-%d1%81%d0%bf%d0%be%d1%81%d0%be%d0%b1%d0%be%d0%b2-%d0%ba%d0%be%d1%82%d0%be%d1%80%d1%8b%d0%bc%d0%b8-%d0%ba%d1%83%d1%80%d1%81%d0%be%d1%80-%d0%be%d1%88%d0%b8%d0%b1%d0%b0%d0%b5%d1%82%d1%81%d1%8f" class="post_hash"&gt;Пять способов, которыми курсор ошибается&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Все результаты ниже получены на hledger 1.52.4, скачанном с GitHub Releases, на отдельных каталогах с пустым журналом и минимальными правилами CSV: &lt;code&gt;skip 1&lt;/code&gt;, &lt;code&gt;fields date, description, amount&lt;/code&gt;, два счёта&lt;sup id="fnref:8"&gt;&lt;a href="#fn:8" class="footnote-ref" role="doc-noteref"&gt;8&lt;/a&gt;&lt;/sup&gt;. Числа — это количество транзакций в журнале после прогона, а не оценки.&lt;/p&gt;&#10;&lt;h3 id="поздняя-проводка-новая-запись-с-прошлой-датой"&gt;&lt;a href="#%d0%bf%d0%be%d0%b7%d0%b4%d0%bd%d1%8f%d1%8f-%d0%bf%d1%80%d0%be%d0%b2%d0%be%d0%b4%d0%ba%d0%b0-%d0%bd%d0%be%d0%b2%d0%b0%d1%8f-%d0%b7%d0%b0%d0%bf%d0%b8%d1%81%d1%8c-%d1%81-%d0%bf%d1%80%d0%be%d1%88%d0%bb%d0%be%d0%b9-%d0%b4%d0%b0%d1%82%d0%be%d0%b9" class="post_hash"&gt;Поздняя проводка: новая запись с прошлой датой&lt;/a&gt;&lt;/h3&gt;&#10;&lt;p&gt;Самый частый случай — карточная операция, которая висит в статусе pending и появляется в выгрузке только после подтверждения, сохраняя при этом исходную дату покупки&lt;sup id="fnref:9"&gt;&lt;a href="#fn:9" class="footnote-ref" role="doc-noteref"&gt;9&lt;/a&gt;&lt;/sup&gt;. Формально это нарушение четвёртого допущения: запись новая, дата старая.&lt;/p&gt;&#10;&lt;p&gt;Прогон: импортируем три записи (1, 2 и 3 ноября), затем в выгрузку добавляется четвёртая — от 1 ноября, с датой раньше курсора. Повторный импорт отвечает &lt;code&gt;no new transactions found in bank.csv&lt;/code&gt;, в журнале остаётся три транзакции, файл состояния не меняется. Запись потеряна молча, без предупреждения и без ненулевого кода возврата&lt;sup id="fnref5:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;Это не гипотеза: тот же сценарий описан в трекере как баг с 2022 года — «Import will miss transactions that show up on a date earlier than the date stored in .latest file», с разбором ровно про pending-операции карт&lt;sup id="fnref1:9"&gt;&lt;a href="#fn:9" class="footnote-ref" role="doc-noteref"&gt;9&lt;/a&gt;&lt;/sup&gt;. С тех пор поведение не изменилось: в 1.52.4 фильтр тот же.&lt;/p&gt;&#10;&lt;h3 id="новое-имя-файла-дубли-всей-выписки"&gt;&lt;a href="#%d0%bd%d0%be%d0%b2%d0%be%d0%b5-%d0%b8%d0%bc%d1%8f-%d1%84%d0%b0%d0%b9%d0%bb%d0%b0-%d0%b4%d1%83%d0%b1%d0%bb%d0%b8-%d0%b2%d1%81%d0%b5%d0%b9-%d0%b2%d1%8b%d0%bf%d0%b8%d1%81%d0%ba%d0%b8" class="post_hash"&gt;Новое имя файла: дубли всей выписки&lt;/a&gt;&lt;/h3&gt;&#10;&lt;p&gt;Второй прогон: после успешного импорта &lt;code&gt;bank.csv&lt;/code&gt; та же выгрузка сохранена браузером как &lt;code&gt;bank (2).csv&lt;/code&gt; и импортирована. Ответ — &lt;code&gt;imported 2 new transactions from &amp;quot;bank (2).csv&amp;quot;&lt;/code&gt;, в журнале четыре транзакции из двух реальных операций, и рядом два файла состояния: &lt;code&gt;.latest.bank.csv&lt;/code&gt; и &lt;code&gt;.latest.bank (2).csv&lt;/code&gt;&lt;sup id="fnref6:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;Механика очевидна из имени файла состояния, но последствия неприятны: дубли появляются не из-за ошибки в данных, а из-за того, что браузер добавил суффикс к имени. Документация предлагает лечить это правилом &lt;code&gt;source&lt;/code&gt; с glob-шаблоном (&lt;code&gt;source bank*.csv&lt;/code&gt;), которое заставляет hledger читать самый свежий подходящий файл, а с правилом &lt;code&gt;archive&lt;/code&gt; — ещё и раскладывать обработанные файлы в каталог &lt;code&gt;data/&lt;/code&gt;, причём в этом режиме hledger предпочитает самый старый файл из совпавших, а не самый новый&lt;sup id="fnref:10"&gt;&lt;a href="#fn:10" class="footnote-ref" role="doc-noteref"&gt;10&lt;/a&gt;&lt;/sup&gt;. Оба правила появились в 1.50 и помечены как экспериментальные&lt;sup id="fnref1:10"&gt;&lt;a href="#fn:10" class="footnote-ref" role="doc-noteref"&gt;10&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;h3 id="вставка-в-начало-дня-потеря-новой-записи-и-дубль-старой"&gt;&lt;a href="#%d0%b2%d1%81%d1%82%d0%b0%d0%b2%d0%ba%d0%b0-%d0%b2-%d0%bd%d0%b0%d1%87%d0%b0%d0%bb%d0%be-%d0%b4%d0%bd%d1%8f-%d0%bf%d0%be%d1%82%d0%b5%d1%80%d1%8f-%d0%bd%d0%be%d0%b2%d0%be%d0%b9-%d0%b7%d0%b0%d0%bf%d0%b8%d1%81%d0%b8-%d0%b8-%d0%b4%d1%83%d0%b1%d0%bb%d1%8c-%d1%81%d1%82%d0%b0%d1%80%d0%be%d0%b9" class="post_hash"&gt;Вставка в начало дня: потеря новой записи и дубль старой&lt;/a&gt;&lt;/h3&gt;&#10;&lt;p&gt;Третий случай — самый коварный, потому что ломает сразу оба направления. Импортируем две записи на 3 ноября (&lt;code&gt;A&lt;/code&gt; и &lt;code&gt;B&lt;/code&gt;), затем в выгрузке появляется третья (&lt;code&gt;X&lt;/code&gt;) на ту же дату, и банк ставит её &lt;strong&gt;первой&lt;/strong&gt; в этот день&lt;sup id="fnref7:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;Курсор отбрасывает первые две записи на дате — то есть &lt;code&gt;X&lt;/code&gt; и &lt;code&gt;A&lt;/code&gt;. В журнал уходит &lt;code&gt;B&lt;/code&gt; второй раз. В выгрузке шесть операций, в журнале тоже шесть строк, но состав другой: &lt;code&gt;X&lt;/code&gt; нет вовсе, а &lt;code&gt;B&lt;/code&gt; записана дважды&lt;sup id="fnref8:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;. Команда при этом рапортует об успехе: &lt;code&gt;imported 1 new transactions&lt;/code&gt;.&lt;/p&gt;&#10;&lt;p&gt;Именно поэтому четвёртое допущение документации сформулировано как «порядок записей внутри одной даты стабилен», а не «записи добавляются в конец»: курсор сравнивает не значения, а позиции, и любая вставка внутри уже пройденного дня сдвигает соответствие&lt;sup id="fnref8:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;h3 id="одинаковые-записи-в-один-день-счётчик-работает"&gt;&lt;a href="#%d0%be%d0%b4%d0%b8%d0%bd%d0%b0%d0%ba%d0%be%d0%b2%d1%8b%d0%b5-%d0%b7%d0%b0%d0%bf%d0%b8%d1%81%d0%b8-%d0%b2-%d0%be%d0%b4%d0%b8%d0%bd-%d0%b4%d0%b5%d0%bd%d1%8c-%d1%81%d1%87%d1%91%d1%82%d1%87%d0%b8%d0%ba-%d1%80%d0%b0%d0%b1%d0%be%d1%82%d0%b0%d0%b5%d1%82" class="post_hash"&gt;Одинаковые записи в один день: счётчик работает&lt;/a&gt;&lt;/h3&gt;&#10;&lt;p&gt;Не всё так плохо. Три одинаковых покупки кофе по 3.50 в один день импортируются все три: файл состояния получает три строки с одной датой. Когда в следующей выгрузке появляется четвёртая такая же, импортируется ровно одна — &lt;code&gt;drop (length ds)&lt;/code&gt; отбрасывает ровно три позиции&lt;sup id="fnref9:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;. Это и есть та часть, которую документация называет корректной работой счётчика: одинаковые записи не склеиваются, потому что курсор считает не уникальные значения, а количество.&lt;/p&gt;&#10;&lt;p&gt;Отсюда же следует, что «одинаковые сумма, дата и описание» — не признак дубля. Документация прямо перечисляет два вида дедупликации, которых импорт не делает и, по мнению авторов, делать не должен, «because these can happen legitimately in financial data»: когда две новые записи в CSV идентичны и когда новая запись идентична уже имеющейся в журнале&lt;sup id="fnref9:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;. Для банковских данных это верно: два кофе в один день по одной цене — норма.&lt;/p&gt;&#10;&lt;h3 id="перевод-между-своими-счетами-двойное-отражение"&gt;&lt;a href="#%d0%bf%d0%b5%d1%80%d0%b5%d0%b2%d0%be%d0%b4-%d0%bc%d0%b5%d0%b6%d0%b4%d1%83-%d1%81%d0%b2%d0%be%d0%b8%d0%bc%d0%b8-%d1%81%d1%87%d0%b5%d1%82%d0%b0%d0%bc%d0%b8-%d0%b4%d0%b2%d0%be%d0%b9%d0%bd%d0%be%d0%b5-%d0%be%d1%82%d1%80%d0%b0%d0%b6%d0%b5%d0%bd%d0%b8%d0%b5" class="post_hash"&gt;Перевод между своими счетами: двойное отражение&lt;/a&gt;&lt;/h3&gt;&#10;&lt;p&gt;Отдельный класс ошибок не связан с курсором вообще. Перевод между своим текущим и своим накопительным счётом попадает в обе выписки: в одной он расход, в другой приход. Курсор обработает оба файла независимо и импортирует две транзакции — журнал сойдётся по сумме, но в нём будет две записи вместо одной, а счета получат лишние обороты&lt;sup id="fnref:11"&gt;&lt;a href="#fn:11" class="footnote-ref" role="doc-noteref"&gt;11&lt;/a&gt;&lt;/sup&gt;. FAQ предлагает решение в правилах: в выписке накопительного счёта пропускать такие строки,&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;; already imported from checking&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;if TRANSFER FROM .*CHECKING&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; skip&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;— причём альтернативы, которые там же названы, честнее: удалить одну из записей руками или провести обе через третий, фиктивный счёт, что добавит шума в отчёты&lt;sup id="fnref1:11"&gt;&lt;a href="#fn:11" class="footnote-ref" role="doc-noteref"&gt;11&lt;/a&gt;&lt;/sup&gt;. Это хорошая иллюстрация того, что «правила CSV» — это программирование на регулярных выражениях поверх данных, у которых нет идентификаторов.&lt;/p&gt;&#10;&lt;h3 id="сводка-наблюдений"&gt;&lt;a href="#%d1%81%d0%b2%d0%be%d0%b4%d0%ba%d0%b0-%d0%bd%d0%b0%d0%b1%d0%bb%d1%8e%d0%b4%d0%b5%d0%bd%d0%b8%d0%b9" class="post_hash"&gt;Сводка наблюдений&lt;/a&gt;&lt;/h3&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Сценарий&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Что делает курсор&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Наблюдаемый результат (1.52.4)&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Повторный импорт того же файла&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;отбрасывает всё до курсора&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;0 новых, журнал не меняется&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Новая запись с датой раньше курсора&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;отбрасывает как «старую»&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;запись потеряна молча&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;То же содержимое под новым именем файла&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;нового состояния нет, курсор пуст&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;все записи импортированы повторно&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Новая запись в начале уже пройденного дня&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;отбрасывает первые N позиций&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;новая потеряна, старая задвоена&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Четвёртая одинаковая запись на ту же дату&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;отбрасывает ровно N позиций&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;импортируется корректно&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;h2 id="почему-хешировать-дату-описание-и-сумму--не-решение"&gt;&lt;a href="#%d0%bf%d0%be%d1%87%d0%b5%d0%bc%d1%83-%d1%85%d0%b5%d1%88%d0%b8%d1%80%d0%be%d0%b2%d0%b0%d1%82%d1%8c-%d0%b4%d0%b0%d1%82%d1%83-%d0%be%d0%bf%d0%b8%d1%81%d0%b0%d0%bd%d0%b8%d0%b5-%d0%b8-%d1%81%d1%83%d0%bc%d0%bc%d1%83--%d0%bd%d0%b5-%d1%80%d0%b5%d1%88%d0%b5%d0%bd%d0%b8%d0%b5" class="post_hash"&gt;Почему «хешировать дату, описание и сумму» — не решение&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;В issue 2022 года предлагается ровно то, что кажется очевидным: присваивать каждой импортированной транзакции идентификатор — хеш от даты, описания и суммы — и избавиться от файла &lt;code&gt;.latest&lt;/code&gt;&lt;sup id="fnref2:9"&gt;&lt;a href="#fn:9" class="footnote-ref" role="doc-noteref"&gt;9&lt;/a&gt;&lt;/sup&gt;. Через три года появился развёрнутый проект, который это уточняет: хранить в файле состояния не только даты, но и «дескрипторы» записей, а сопоставление вести не поблочно, а «вразброс», допуская вставки внутри уже импортированного диапазона; новый ключ &lt;code&gt;state-descriptor&lt;/code&gt; мог бы принимать &lt;code&gt;%transaction_id&lt;/code&gt; или &lt;code&gt;%description %amount&lt;/code&gt;&lt;sup id="fnref:12"&gt;&lt;a href="#fn:12" class="footnote-ref" role="doc-noteref"&gt;12&lt;/a&gt;&lt;/sup&gt;. Оба предложения открыты, в 1.52.4 их нет&lt;sup id="fnref1:12"&gt;&lt;a href="#fn:12" class="footnote-ref" role="doc-noteref"&gt;12&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;Проблема с хешем от содержимого не в коллизиях. Она в том, что содержимое — не идентификатор, а наблюдаемая величина, которую банк вправе менять:&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;strong&gt;Описание дрейфует.&lt;/strong&gt; Между выгрузками банк может дописать город, номер терминала, изменить регистр или заменить «PENDING AUTH» на имя магазина. Хеш от описания в таком случае даёт новую запись при той же операции.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Дата бывает двух видов.&lt;/strong&gt; Дата проводки и дата валютирования различаются на дни, и выгрузка может показывать то одну, то другую; в camt.053 это разные поля — &lt;code&gt;ValDt&lt;/code&gt; и &lt;code&gt;BookgDt&lt;/code&gt;&lt;sup id="fnref:13"&gt;&lt;a href="#fn:13" class="footnote-ref" role="doc-noteref"&gt;13&lt;/a&gt;&lt;/sup&gt;.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Одинаковые записи легальны.&lt;/strong&gt; Два одинаковых кофе в один день дают один и тот же хеш, и без порядкового номера внутри группы такие записи склеятся, что для учёта неверно&lt;sup id="fnref10:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;.&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;p&gt;Поэтому корректный самодельный ключ — это не хеш одной строки, а &lt;strong&gt;хеш плюс порядковый номер внутри группы равных ключей&lt;/strong&gt;: &lt;code&gt;(account, date, amount, normalized_description)&lt;/code&gt; и счётчик вхождений 1..n. Тогда два одинаковых кофе получают разные ключи, а дрейф описания всё равно ломает ключ, если нормализация не срезает переменную часть. Практически это означает, что нормализация — не косметика, а часть модели данных: нужно решить, какие поля банк не меняет (обычно дата и сумма — самые устойчивые, описание — самое неустойчивое), и хранить исходную строку целиком как доказательство&lt;sup id="fnref:14"&gt;&lt;a href="#fn:14" class="footnote-ref" role="doc-noteref"&gt;14&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;Отдельно стоит сказать, почему такой ключ нельзя «встроить» в &lt;code&gt;hledger import&lt;/code&gt; без переписывания самой команды. Фильтр не смотрит в журнал&lt;sup id="fnref1:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;, а значит метка, записанная в транзакцию, для него невидима. Метку можно поставить (&lt;code&gt;; src-id: ...&lt;/code&gt; в комментарии к транзакции), и она переживёт запись в журнал, но использовать её сможет только ваш собственный скрипт — или инструмент, который сам владеет состоянием, как beancount-import&lt;sup id="fnref1:6"&gt;&lt;a href="#fn:6" class="footnote-ref" role="doc-noteref"&gt;6&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;h2 id="что-даёт-индустрия-идентификатор-операции"&gt;&lt;a href="#%d1%87%d1%82%d0%be-%d0%b4%d0%b0%d1%91%d1%82-%d0%b8%d0%bd%d0%b4%d1%83%d1%81%d1%82%d1%80%d0%b8%d1%8f-%d0%b8%d0%b4%d0%b5%d0%bd%d1%82%d0%b8%d1%84%d0%b8%d0%ba%d0%b0%d1%82%d0%be%d1%80-%d0%be%d0%bf%d0%b5%d1%80%d0%b0%d1%86%d0%b8%d0%b8" class="post_hash"&gt;Что даёт индустрия: идентификатор операции&lt;/a&gt;&lt;/h2&gt;&#10;&lt;h3 id="ofx-fitid-и-семантика-исправлений"&gt;&lt;a href="#ofx-fitid-%d0%b8-%d1%81%d0%b5%d0%bc%d0%b0%d0%bd%d1%82%d0%b8%d0%ba%d0%b0-%d0%b8%d1%81%d0%bf%d1%80%d0%b0%d0%b2%d0%bb%d0%b5%d0%bd%d0%b8%d0%b9" class="post_hash"&gt;OFX: FITID и семантика исправлений&lt;/a&gt;&lt;/h3&gt;&#10;&lt;p&gt;В OFX, формате, который банки отдают для скачивания выписок, идентификатор есть и описан явно&lt;sup id="fnref:15"&gt;&lt;a href="#fn:15" class="footnote-ref" role="doc-noteref"&gt;15&lt;/a&gt;&lt;/sup&gt;:&lt;/p&gt;&#10;&lt;blockquote&gt;&#10;&lt;p&gt;An FI (or its Service Provider) assigns an &lt;code&gt;&amp;lt;FITID&amp;gt;&lt;/code&gt; to uniquely identify a financial transaction that can appear in an account statement. Its primary purpose is to allow a client to detect duplicate responses.&lt;sup id="fnref1:15"&gt;&lt;a href="#fn:15" class="footnote-ref" role="doc-noteref"&gt;15&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;/blockquote&gt;&#10;&lt;p&gt;Область уникальности — счёт плюс финансовое учреждение: «the &lt;code&gt;&amp;lt;FITID&amp;gt;&lt;/code&gt; value must be unique within the account and Financial Institution (independent of the service provider)»; тип поля — A-255, но серверам рекомендовано укладываться в 32 символа&lt;sup id="fnref2:15"&gt;&lt;a href="#fn:15" class="footnote-ref" role="doc-noteref"&gt;15&lt;/a&gt;&lt;/sup&gt;. То есть FITID — не глобальный ключ, а ключ в пространстве имён «банк + счёт», и клиент обязан хранить контекст.&lt;/p&gt;&#10;&lt;p&gt;Вторая, менее известная часть спецификации важнее для учёта: кроме &lt;code&gt;FITID&lt;/code&gt; определены элементы &lt;code&gt;CORRECTFITID&lt;/code&gt;, &lt;code&gt;RELFITID&lt;/code&gt; и &lt;code&gt;REVERSALFITID&lt;/code&gt;&lt;sup id="fnref3:15"&gt;&lt;a href="#fn:15" class="footnote-ref" role="doc-noteref"&gt;15&lt;/a&gt;&lt;/sup&gt;. Это означает, что стандарт моделирует исправление и сторно как &lt;strong&gt;связанные записи&lt;/strong&gt;, а не как тихую правку исходной. Банк не переписывает историю — он присылает новую операцию со ссылкой на старую. Для журнала это ровно то, что нужно: обе записи видны, и связь между ними сохраняется.&lt;/p&gt;&#10;&lt;p&gt;CSV ничего подобного не даёт. Строка либо есть, либо её нет; исправленная сумма выглядит как другая операция, а исчезнувшая строка — как операция, которой не было&lt;sup id="fnref4:15"&gt;&lt;a href="#fn:15" class="footnote-ref" role="doc-noteref"&gt;15&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;h3 id="iso-20022-acctsvcrref-который-необязателен"&gt;&lt;a href="#iso-20022-acctsvcrref-%d0%ba%d0%be%d1%82%d0%be%d1%80%d1%8b%d0%b9-%d0%bd%d0%b5%d0%be%d0%b1%d1%8f%d0%b7%d0%b0%d1%82%d0%b5%d0%bb%d0%b5%d0%bd" class="post_hash"&gt;ISO 20022: AcctSvcrRef, который необязателен&lt;/a&gt;&lt;/h3&gt;&#10;&lt;p&gt;В camt.053, XML-выписке ISO 20022, есть аналог — &lt;code&gt;AcctSvcrRef&lt;/code&gt;, «Account Servicer Reference». В справочнике соответствия MT940/camt.053 это поле 61.8 с пометкой &lt;strong&gt;O&lt;/strong&gt; — опциональное, длина от 1 до 35 символов&lt;sup id="fnref1:13"&gt;&lt;a href="#fn:13" class="footnote-ref" role="doc-noteref"&gt;13&lt;/a&gt;&lt;/sup&gt;. Даже в мире, где стандарт описывает каждое поле явно, сервисный идентификатор записи остаётся необязательным: банк может его не присылать, и тогда вы снова остаётесь с датой, суммой и текстом.&lt;/p&gt;&#10;&lt;p&gt;Практический вывод для того, кто выбирает формат выгрузки: наличие &lt;code&gt;AcctSvcrRef&lt;/code&gt; в camt.053 и &lt;code&gt;FITID&lt;/code&gt; в OFX — это не деталь реализации, а разница между «импорт знает, что уже видел» и «импорт угадывает по позиции». При прочих равных стоит брать формат, где идентификатор есть, даже если для этого нужен конвертер.&lt;/p&gt;&#10;&lt;h3 id="gnucash-точное-совпадение-плюс-лестница-эвристик"&gt;&lt;a href="#gnucash-%d1%82%d0%be%d1%87%d0%bd%d0%be%d0%b5-%d1%81%d0%be%d0%b2%d0%bf%d0%b0%d0%b4%d0%b5%d0%bd%d0%b8%d0%b5-%d0%bf%d0%bb%d1%8e%d1%81-%d0%bb%d0%b5%d1%81%d1%82%d0%bd%d0%b8%d1%86%d0%b0-%d1%8d%d0%b2%d1%80%d0%b8%d1%81%d1%82%d0%b8%d0%ba" class="post_hash"&gt;GnuCash: точное совпадение плюс лестница эвристик&lt;/a&gt;&lt;/h3&gt;&#10;&lt;p&gt;GnuCash хранит FITID в самой транзакции, и именно этот идентификатор используется при повторном импорте&lt;sup id="fnref1:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:16"&gt;&lt;a href="#fn:16" class="footnote-ref" role="doc-noteref"&gt;16&lt;/a&gt;&lt;/sup&gt;. В заголовке движка это описано прямо:&lt;/p&gt;&#10;&lt;blockquote&gt;&#10;&lt;p&gt;The online_id is the OFX/HBCI &amp;ldquo;FITID&amp;rdquo; recorded on a split when it is imported. It is used to recognise the split on re-import so that overlapping or re-downloaded statements don&amp;rsquo;t create duplicates.&lt;sup id="fnref2:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#10;&lt;/blockquote&gt;&#10;&lt;p&gt;Механика двухступенчатая. Сначала — точное совпадение: для счёта строится хеш-таблица всех &lt;code&gt;online_id&lt;/code&gt;, и если идентификатор импортируемой транзакции в ней есть, транзакция уничтожается: «If it does, abort the process for this transaction, since it is already in the system»&lt;sup id="fnref:17"&gt;&lt;a href="#fn:17" class="footnote-ref" role="doc-noteref"&gt;17&lt;/a&gt;&lt;/sup&gt;. Это дедупликация по ключу, без эвристик.&lt;/p&gt;&#10;&lt;p&gt;Если идентификатора нет или он не совпал, включается сопоставление по вероятности. Проектный документ описывает лестницу: совпадение &lt;code&gt;transaction_online_id&lt;/code&gt; — CERTAIN; совпадение суммы при существующем, но не совпавшем идентификаторе — UNLIKELY (не IMPOSSIBLE, потому что «could be protocol change or prior error»); совпадение текста и даты в пределах четырёх дней — PROBABLE&lt;sup id="fnref:18"&gt;&lt;a href="#fn:18" class="footnote-ref" role="doc-noteref"&gt;18&lt;/a&gt;&lt;/sup&gt;. В коде это сведено к сумме баллов: точная сумма +3, сумма в пределах допуска +2, несовпавшая сумма −5; та же дата +3, дата в пределах порога +2, далеко −5; совпавший номер чека +4&lt;sup id="fnref1:17"&gt;&lt;a href="#fn:17" class="footnote-ref" role="doc-noteref"&gt;17&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;Ценность этой конструкции в том, что она честно разделяет два режима: «знаю» и «предполагаю». Пользователю показывают список кандидатов в порядке убывания вероятности и дают выбрать — то есть окончательное решение остаётся за человеком, а машина лишь сужает выбор&lt;sup id="fnref1:18"&gt;&lt;a href="#fn:18" class="footnote-ref" role="doc-noteref"&gt;18&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;h3 id="beancount-import-метка-в-журнале-и-окно-в-пять-дней"&gt;&lt;a href="#beancount-import-%d0%bc%d0%b5%d1%82%d0%ba%d0%b0-%d0%b2-%d0%b6%d1%83%d1%80%d0%bd%d0%b0%d0%bb%d0%b5-%d0%b8-%d0%be%d0%ba%d0%bd%d0%be-%d0%b2-%d0%bf%d1%8f%d1%82%d1%8c-%d0%b4%d0%bd%d0%b5%d0%b9" class="post_hash"&gt;beancount-import: метка в журнале и окно в пять дней&lt;/a&gt;&lt;/h3&gt;&#10;&lt;p&gt;beancount-import решает ту же задачу иначе: импортированные записи помечаются метаданными, в частности &lt;code&gt;ofx_fitid&lt;/code&gt; для OFX-источника, и именно эти метаданные говорят источнику, что уже импортировано; кроме того, метаданные ограничивают сопоставление — «a cleared posting can only match an uncleared posting»&lt;sup id="fnref2:6"&gt;&lt;a href="#fn:6" class="footnote-ref" role="doc-noteref"&gt;6&lt;/a&gt;&lt;/sup&gt;. Для ручных записей, которые не совпадают с банковской датой день в день, разрешено сопоставление с расхождением до пяти дней, а поле &lt;code&gt;date&lt;/code&gt; в метаданных позволяет привязать запись к строке CSV, даже если даты транзакций разные&lt;sup id="fnref3:6"&gt;&lt;a href="#fn:6" class="footnote-ref" role="doc-noteref"&gt;6&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;Ключевое отличие от hledger: состояние живёт &lt;strong&gt;в журнале&lt;/strong&gt;, а не в скрытом файле рядом с CSV. Значит, оно переносится вместе с журналом, попадает в git и переживает переустановку; с другой стороны, оно требует, чтобы инструмент умел читать и писать журнал, а не просто дописывать в него строки&lt;sup id="fnref4:6"&gt;&lt;a href="#fn:6" class="footnote-ref" role="doc-noteref"&gt;6&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;h3 id="ledger-поддержки-нет"&gt;&lt;a href="#ledger-%d0%bf%d0%be%d0%b4%d0%b4%d0%b5%d1%80%d0%b6%d0%ba%d0%b8-%d0%bd%d0%b5%d1%82" class="post_hash"&gt;Ledger: поддержки нет&lt;/a&gt;&lt;/h3&gt;&#10;&lt;p&gt;Для полноты: в Ledger 3 поддержка OFX удалена — в разделе «Major Changes from version 2.6» среди удалённого перечислены «OFX support» и «GnuCash file import»&lt;sup id="fnref:19"&gt;&lt;a href="#fn:19" class="footnote-ref" role="doc-noteref"&gt;19&lt;/a&gt;&lt;/sup&gt;. Опция &lt;code&gt;--import FILE&lt;/code&gt; в Ledger означает импорт Python-модуля, а не банковских данных&lt;sup id="fnref1:19"&gt;&lt;a href="#fn:19" class="footnote-ref" role="doc-noteref"&gt;19&lt;/a&gt;&lt;/sup&gt;. Так что в мире plain-text accounting ровно один инструмент — hledger — имеет встроенный импорт CSV, и ровно у него нет идентификатора операции.&lt;/p&gt;&#10;&lt;h3 id="чего-нет-в-hledger"&gt;&lt;a href="#%d1%87%d0%b5%d0%b3%d0%be-%d0%bd%d0%b5%d1%82-%d0%b2-hledger" class="post_hash"&gt;Чего нет в hledger&lt;/a&gt;&lt;/h3&gt;&#10;&lt;p&gt;Ни FITID, ни &lt;code&gt;AcctSvcrRef&lt;/code&gt;, ни места, куда их положить так, чтобы это влияло на импорт. Есть правила CSV, в которых можно объявить произвольное поле (&lt;code&gt;fields date, description, amount, id&lt;/code&gt;), но это поле попадёт только в описание или комментарий транзакции — фильтр его не прочитает&lt;sup id="fnref2:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;. В предварительных сборках 2.0 ситуация с выражениями в правилах улучшилась: в 1.99.6 появились функции &lt;code&gt;upper&lt;/code&gt;, &lt;code&gt;lower&lt;/code&gt;, &lt;code&gt;trim&lt;/code&gt;, &lt;code&gt;replace&lt;/code&gt;, &lt;code&gt;join&lt;/code&gt; и другие внутри &lt;code&gt;%{...}&lt;/code&gt;, что позволяет нормализовать описание прямо в правилах, например &lt;code&gt;%{replace(%desc, &amp;quot;ref#[0-9]+&amp;quot;, &amp;quot;&amp;quot;)}&lt;/code&gt;&lt;sup id="fnref1:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt;. Это делает самодельный отпечаток дешевле, но не даёт импорту памяти о нём.&lt;/p&gt;&#10;&lt;h2 id="отпечаток-записи-как-строить-если-идентификатора-нет"&gt;&lt;a href="#%d0%be%d1%82%d0%bf%d0%b5%d1%87%d0%b0%d1%82%d0%be%d0%ba-%d0%b7%d0%b0%d0%bf%d0%b8%d1%81%d0%b8-%d0%ba%d0%b0%d0%ba-%d1%81%d1%82%d1%80%d0%be%d0%b8%d1%82%d1%8c-%d0%b5%d1%81%d0%bb%d0%b8-%d0%b8%d0%b4%d0%b5%d0%bd%d1%82%d0%b8%d1%84%d0%b8%d0%ba%d0%b0%d1%82%d0%be%d1%80%d0%b0-%d0%bd%d0%b5%d1%82" class="post_hash"&gt;Отпечаток записи: как строить, если идентификатора нет&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Если банк не даёт ключ, единственный способ получить повторяемость — построить ключ самому и &lt;strong&gt;владеть состоянием&lt;/strong&gt;&lt;sup id="fnref1:14"&gt;&lt;a href="#fn:14" class="footnote-ref" role="doc-noteref"&gt;14&lt;/a&gt;&lt;/sup&gt;. Минимальная конструкция выглядит так.&lt;/p&gt;&#10;&lt;ol&gt;&#10;&lt;li&gt;&lt;strong&gt;Нормализация.&lt;/strong&gt; Привести сумму к минорным единицам (целое число копеек/центов), дату — к ISO, описание — к верхнему регистру с удалением пробелов и переменных фрагментов (номера терминалов, ссылок, дат внутри текста). Нормализация должна быть идемпотентной: применение дважды даёт то же самое.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Ключ группы.&lt;/strong&gt; &lt;code&gt;sha256(account | date | amount_minor | normalized_description)&lt;/code&gt;, первые 12–16 символов достаточно для чтения глазами.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Порядковый номер.&lt;/strong&gt; Для каждой группы одинаковых ключей — счётчик 1..n в порядке появления в файле. Итоговый идентификатор — &lt;code&gt;ключ-номер&lt;/code&gt;.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Хранение.&lt;/strong&gt; Либо отдельный файл состояния (как у hledger, но с содержимым, а не датами), либо метка в транзакции журнала — второй вариант переносимее, но требует, чтобы проверка читала журнал&lt;sup id="fnref2:14"&gt;&lt;a href="#fn:14" class="footnote-ref" role="doc-noteref"&gt;14&lt;/a&gt;&lt;/sup&gt;.&lt;/li&gt;&#10;&lt;/ol&gt;&#10;&lt;p&gt;Скетч на Python, который делает первые три шага и печатает идентификаторы в порядке файла:&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-python" data-lang="python"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kn"&gt;import&lt;/span&gt; &lt;span class="nn"&gt;csv&lt;/span&gt;&lt;span class="o"&gt;,&lt;/span&gt; &lt;span class="nn"&gt;hashlib&lt;/span&gt;&lt;span class="o"&gt;,&lt;/span&gt; &lt;span class="nn"&gt;json&lt;/span&gt;&lt;span class="o"&gt;,&lt;/span&gt; &lt;span class="nn"&gt;sys&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kn"&gt;from&lt;/span&gt; &lt;span class="nn"&gt;collections&lt;/span&gt; &lt;span class="kn"&gt;import&lt;/span&gt; &lt;span class="n"&gt;defaultdict&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;def&lt;/span&gt; &lt;span class="nf"&gt;key&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;account&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;date&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;amount_minor&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;desc&lt;/span&gt;&lt;span class="p"&gt;):&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="n"&gt;s&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="s2"&gt;&amp;#34;&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;account&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;|&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;date&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;|&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;amount_minor&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;|&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="s1"&gt;&amp;#39; &amp;#39;&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="n"&gt;join&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;desc&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="n"&gt;upper&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="n"&gt;split&lt;/span&gt;&lt;span class="p"&gt;())&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;&amp;#34;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="n"&gt;hashlib&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="n"&gt;sha256&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;s&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="n"&gt;encode&lt;/span&gt;&lt;span class="p"&gt;())&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="n"&gt;hexdigest&lt;/span&gt;&lt;span class="p"&gt;()[:&lt;/span&gt;&lt;span class="mi"&gt;12&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="n"&gt;seen&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;defaultdict&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;int&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="n"&gt;out&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[]&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;with&lt;/span&gt; &lt;span class="nb"&gt;open&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;sys&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="n"&gt;argv&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt; &lt;span class="n"&gt;newline&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;&amp;#34;&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;encoding&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;&amp;#34;utf-8&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;as&lt;/span&gt; &lt;span class="n"&gt;f&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="n"&gt;row&lt;/span&gt; &lt;span class="ow"&gt;in&lt;/span&gt; &lt;span class="n"&gt;csv&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="n"&gt;DictReader&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;f&lt;/span&gt;&lt;span class="p"&gt;):&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="n"&gt;k&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;key&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;&amp;#34;assets:bank:checking&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;row&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;&amp;#34;date&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nb"&gt;int&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;round&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;float&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;row&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;&amp;#34;amount&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;])&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="mi"&gt;100&lt;/span&gt;&lt;span class="p"&gt;)),&lt;/span&gt; &lt;span class="n"&gt;row&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;&amp;#34;description&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;])&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="n"&gt;seen&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;k&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;+=&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="n"&gt;out&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="n"&gt;append&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt;&lt;span class="s2"&gt;&amp;#34;id&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="s2"&gt;&amp;#34;&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;k&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;-&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;seen&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;k&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;&amp;#34;date&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;row&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;&amp;#34;date&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="s2"&gt;&amp;#34;amount&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;row&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;&amp;#34;amount&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt; &lt;span class="s2"&gt;&amp;#34;desc&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;row&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;&amp;#34;description&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;]})&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nb"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;json&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="n"&gt;dumps&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;out&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;ensure_ascii&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="kc"&gt;False&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;indent&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Что этот скетч &lt;strong&gt;не&lt;/strong&gt; делает и почему это важно: он не решает, что считать уже импортированным. Идентификаторы устойчивы только к перестановке строк и к повторному чтению того же файла; если банк изменил описание, ключ изменится, и запись будет считаться новой. Это принципиальное ограничение любого отпечатка: он превращает «не знаю, что это» в «знаю, что это та же строка», но не в «знаю, что это та же операция». Для второго нужен либо ID от банка, либо сопоставление по нескольким полям с допусками — то есть та самая лестница вероятностей, которую строит GnuCash и которую литература по обнаружению дубликатов называет отдельной задачей: «Duplicate records do not share a common key and/or they contain errors that make duplicate matching a difficult task»&lt;sup id="fnref2:18"&gt;&lt;a href="#fn:18" class="footnote-ref" role="doc-noteref"&gt;18&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref3:14"&gt;&lt;a href="#fn:14" class="footnote-ref" role="doc-noteref"&gt;14&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;Практический компромисс, который я бы выбрал для себя: ключ из даты, суммы и счёта (без описания) плюс порядковый номер; описание хранить рядом как доказательство, но не включать в ключ. Тогда дрейф текста не ломает идентичность, а два одинаковых кофе в один день различаются номером. Минус — две разные операции с одинаковой датой и суммой на одном счёте (например, две поездки на 300 рублей в один день) неразличимы по ключу и различаются только порядком; при перестановке строк они «поменяются местами», что для учёта обычно безразлично, но формально это уже не тот же объект.&lt;/p&gt;&#10;&lt;h2 id="сверка--это-не-дедупликация"&gt;&lt;a href="#%d1%81%d0%b2%d0%b5%d1%80%d0%ba%d0%b0--%d1%8d%d1%82%d0%be-%d0%bd%d0%b5-%d0%b4%d0%b5%d0%b4%d1%83%d0%bf%d0%bb%d0%b8%d0%ba%d0%b0%d1%86%d0%b8%d1%8f" class="post_hash"&gt;Сверка — это не дедупликация&lt;/a&gt;&lt;/h2&gt;&#10;&lt;h3 id="утверждения-об-остатке"&gt;&lt;a href="#%d1%83%d1%82%d0%b2%d0%b5%d1%80%d0%b6%d0%b4%d0%b5%d0%bd%d0%b8%d1%8f-%d0%be%d0%b1-%d0%be%d1%81%d1%82%d0%b0%d1%82%d0%ba%d0%b5" class="post_hash"&gt;Утверждения об остатке&lt;/a&gt;&lt;/h3&gt;&#10;&lt;p&gt;hledger поддерживает balance assertions в стиле Ledger: после суммы проводки пишется &lt;code&gt;= ОЖИДАЕМЫЙ_ОСТАТОК&lt;/code&gt;, и после чтения журнала все утверждения проверяются, а при расхождении выводится ошибка&lt;sup id="fnref:20"&gt;&lt;a href="#fn:20" class="footnote-ref" role="doc-noteref"&gt;20&lt;/a&gt;&lt;/sup&gt;. Утверждения вычисляются в порядке дат (в отличие от Ledger, который проверяет их в порядке разбора), поэтому перестановка транзакций и файлов обычно их не ломает&lt;sup id="fnref1:20"&gt;&lt;a href="#fn:20" class="footnote-ref" role="doc-noteref"&gt;20&lt;/a&gt;&lt;/sup&gt;. Есть варианты: &lt;code&gt;==&lt;/code&gt; требует, чтобы в счёте не было других товаров, &lt;code&gt;=*&lt;/code&gt; и &lt;code&gt;==*&lt;/code&gt; включают субсчета&lt;sup id="fnref2:20"&gt;&lt;a href="#fn:20" class="footnote-ref" role="doc-noteref"&gt;20&lt;/a&gt;&lt;/sup&gt;. Проверить только утверждения можно командой &lt;code&gt;hledger check assertions&lt;/code&gt;, которая молчит и возвращает ноль при успехе&lt;sup id="fnref:21"&gt;&lt;a href="#fn:21" class="footnote-ref" role="doc-noteref"&gt;21&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;Для импорта это удобно тем, что CSV-правила умеют генерировать утверждения из колонки остатка: поле &lt;code&gt;balance&lt;/code&gt; создаёт assertion, а правило &lt;code&gt;balance-type&lt;/code&gt; выбирает его вид (&lt;code&gt;=&lt;/code&gt;, &lt;code&gt;=*&lt;/code&gt;, &lt;code&gt;==&lt;/code&gt;, &lt;code&gt;==*&lt;/code&gt;)&lt;sup id="fnref2:10"&gt;&lt;a href="#fn:10" class="footnote-ref" role="doc-noteref"&gt;10&lt;/a&gt;&lt;/sup&gt;. Важная оговорка: при чтении CSV напрямую сгенерированные утверждения не проверяются — они имеют смысл только когда данные стали частью журнала; если нужно проверить сразу, вывод печатают в другой hledger&lt;sup id="fnref3:10"&gt;&lt;a href="#fn:10" class="footnote-ref" role="doc-noteref"&gt;10&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;h3 id="ловушка-на-которую-я-наступил"&gt;&lt;a href="#%d0%bb%d0%be%d0%b2%d1%83%d1%88%d0%ba%d0%b0-%d0%bd%d0%b0-%d0%ba%d0%be%d1%82%d0%be%d1%80%d1%83%d1%8e-%d1%8f-%d0%bd%d0%b0%d1%81%d1%82%d1%83%d0%bf%d0%b8%d0%bb" class="post_hash"&gt;Ловушка, на которую я наступил&lt;/a&gt;&lt;/h3&gt;&#10;&lt;p&gt;Первая версия моего теста выглядела так: проводка с суммой 100, затем отдельная строка &lt;code&gt;assets:bank:checking = $103.50&lt;/code&gt; без суммы — и проверка прошла. Причина в том, что проводка без суммы получает вычисленную сумму, чтобы транзакция сошлась: hledger подставил 3.50 и «подтвердил» остаток 103.50&lt;sup id="fnref3:20"&gt;&lt;a href="#fn:20" class="footnote-ref" role="doc-noteref"&gt;20&lt;/a&gt;&lt;/sup&gt;. Правильная запись — с явным нулём:&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;2026-11-24 salary&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; assets:bank:checking $100.00&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; income:salary&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; assets:bank:checking $0 = $100.00&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;С такой формой неверный остаток действительно падает: &lt;code&gt;hledger -f bad.journal check assertions&lt;/code&gt; печатает ошибку с указанием на &lt;code&gt;= $100.00&lt;/code&gt; и возвращает 1.&lt;/p&gt;&#10;&lt;h3 id="что-утверждение-поймать-не-может"&gt;&lt;a href="#%d1%87%d1%82%d0%be-%d1%83%d1%82%d0%b2%d0%b5%d1%80%d0%b6%d0%b4%d0%b5%d0%bd%d0%b8%d0%b5-%d0%bf%d0%be%d0%b9%d0%bc%d0%b0%d1%82%d1%8c-%d0%bd%d0%b5-%d0%bc%d0%be%d0%b6%d0%b5%d1%82" class="post_hash"&gt;Что утверждение поймать не может&lt;/a&gt;&lt;/h3&gt;&#10;&lt;p&gt;Утверждение — это проверка суммы. Она ловит грубые ошибки: не импортировали целую выписку, потеряли крупную проводку, задвоили операцию с заметной суммой. Она не ловит пару «дубль плюс пропуск» с одинаковой суммой, потому что сумма сохраняется.&lt;/p&gt;&#10;&lt;p&gt;Я воспроизвёл это на журнале из трёх транзакций: зарплата +100, кофе −3.50 (импортирован дважды) и возврат +3.50 (не импортирован вовсе). Утверждение на остаток 100.00 проходит, &lt;code&gt;check assertions&lt;/code&gt; возвращает 0, &lt;code&gt;hledger bal assets:bank:checking&lt;/code&gt; показывает ровно 100.00 — то есть журнал сходится с банком по остатку, содержа при этом дубль и пропуск. Это не дефект hledger, а свойство любой сверки по итогу: она проверяет агрегат, а не состав. В бухгалтерской традиции такие ошибки называют компенсирующими, и они входят в список тех, которые пробный баланс не выявляет.&lt;/p&gt;&#10;&lt;p&gt;Практический вывод: утверждение об остатке нужно ставить на &lt;strong&gt;каждый&lt;/strong&gt; закрывающий остаток из выписки, а не на конец года. Тогда окно, в котором может спрятаться компенсирующая пара, сжимается до одной выписки, и вероятность, что дубль и пропуск совпадут по сумме именно внутри неё, падает. Это ровно та же логика, что в распределённых системах: период сверки — параметр, а не деталь&lt;sup id="fnref4:10"&gt;&lt;a href="#fn:10" class="footnote-ref" role="doc-noteref"&gt;10&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;h3 id="аналогия-с-idempotency-key"&gt;&lt;a href="#%d0%b0%d0%bd%d0%b0%d0%bb%d0%be%d0%b3%d0%b8%d1%8f-%d1%81-idempotency-key" class="post_hash"&gt;Аналогия с idempotency key&lt;/a&gt;&lt;/h3&gt;&#10;&lt;p&gt;Полезно посмотреть, как ту же проблему решают в API. У Stripe ключ идемпотентности живёт ограниченное время: «you can remove keys from the system automatically after they&amp;rsquo;re at least 24 hours old. We generate a new request if a key is reused after the original is pruned»&lt;sup id="fnref:22"&gt;&lt;a href="#fn:22" class="footnote-ref" role="doc-noteref"&gt;22&lt;/a&gt;&lt;/sup&gt;. То есть даже там, где идентификатор есть и полностью контролируется отправителем, гарантия «ровно один раз» действует в пределах окна хранения ключа — и после очистки повтор с тем же ключом выполнится заново. У hledger окно задано неявно: это диапазон дат до курсора, и оно никогда не истекает, но и не расширяется назад. Именно поэтому «импортируйте чаще» — не суеверие, а способ сузить окно, в котором вставка задним числом ещё не произошла.&lt;/p&gt;&#10;&lt;h2 id="рабочий-регламент"&gt;&lt;a href="#%d1%80%d0%b0%d0%b1%d0%be%d1%87%d0%b8%d0%b9-%d1%80%d0%b5%d0%b3%d0%bb%d0%b0%d0%bc%d0%b5%d0%bd%d1%82" class="post_hash"&gt;Рабочий регламент&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Собрав всё вместе, вот что я считаю разумным порядком действий для журнала на hledger с банковскими CSV&lt;sup id="fnref11:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;ol&gt;&#10;&lt;li&gt;&lt;strong&gt;Брать формат с идентификатором, если он есть.&lt;/strong&gt; OFX или camt.053 с &lt;code&gt;FITID&lt;/code&gt;/&lt;code&gt;AcctSvcrRef&lt;/code&gt; снимает первую из трёх задач целиком&lt;sup id="fnref5:15"&gt;&lt;a href="#fn:15" class="footnote-ref" role="doc-noteref"&gt;15&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:13"&gt;&lt;a href="#fn:13" class="footnote-ref" role="doc-noteref"&gt;13&lt;/a&gt;&lt;/sup&gt;.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Фиксировать имя файла.&lt;/strong&gt; Правило &lt;code&gt;source bank*.csv&lt;/code&gt; плюс &lt;code&gt;archive&lt;/code&gt; — минимальная защита от дублей из-за суффикса браузера&lt;sup id="fnref5:10"&gt;&lt;a href="#fn:10" class="footnote-ref" role="doc-noteref"&gt;10&lt;/a&gt;&lt;/sup&gt;.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Импортировать часто и коротким окном.&lt;/strong&gt; Чем короче интервал, тем меньше вероятность, что банк вставит запись внутрь уже пройденного диапазона; это же советует документация&lt;sup id="fnref12:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Смотреть &lt;code&gt;--dry-run&lt;/code&gt; перед импортом.&lt;/strong&gt; Вывод в формате журнала читается глазами и переигрывается в другой hledger, поэтому расхождение видно до записи&lt;sup id="fnref13:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Ставить утверждение на каждый закрывающий остаток.&lt;/strong&gt; Одно утверждение на выписку, а не на год&lt;sup id="fnref4:20"&gt;&lt;a href="#fn:20" class="footnote-ref" role="doc-noteref"&gt;20&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref6:10"&gt;&lt;a href="#fn:10" class="footnote-ref" role="doc-noteref"&gt;10&lt;/a&gt;&lt;/sup&gt;.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Свой ключ — только если нужна настоящая повторяемость.&lt;/strong&gt; Тогда состояние должно быть вашим (скрипт или инструмент вроде beancount-import), а не файлом &lt;code&gt;.latest&lt;/code&gt;&lt;sup id="fnref5:6"&gt;&lt;a href="#fn:6" class="footnote-ref" role="doc-noteref"&gt;6&lt;/a&gt;&lt;/sup&gt;.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Помнить про переводы между своими счетами.&lt;/strong&gt; Это не ошибка импорта, а ошибка модели: две выписки описывают одну операцию&lt;sup id="fnref2:11"&gt;&lt;a href="#fn:11" class="footnote-ref" role="doc-noteref"&gt;11&lt;/a&gt;&lt;/sup&gt;.&lt;/li&gt;&#10;&lt;/ol&gt;&#10;&lt;p&gt;Отдельно стоит сказать про массовость проблемы: в каталоге plaintextaccounting.org рядом с hledger перечислены инструменты, у которых дедупликация заявлена как функция — &lt;code&gt;buchhaltung&lt;/code&gt; («CSV/FinTS/HBCI/OFX to *ledger conversion/deduplication») и &lt;code&gt;beanhub-import&lt;/code&gt; («Declarative idempotent rule-based beancount transaction import engine»)&lt;sup id="fnref:23"&gt;&lt;a href="#fn:23" class="footnote-ref" role="doc-noteref"&gt;23&lt;/a&gt;&lt;/sup&gt;. Существование отдельного класса инструментов под эту задачу — лучший аргумент, что встроенного курсора по датам недостаточно.&lt;/p&gt;&#10;&lt;h2 id="границы-и-что-осталось-неизвестным"&gt;&lt;a href="#%d0%b3%d1%80%d0%b0%d0%bd%d0%b8%d1%86%d1%8b-%d0%b8-%d1%87%d1%82%d0%be-%d0%be%d1%81%d1%82%d0%b0%d0%bb%d0%be%d1%81%d1%8c-%d0%bd%d0%b5%d0%b8%d0%b7%d0%b2%d0%b5%d1%81%d1%82%d0%bd%d1%8b%d0%bc" class="post_hash"&gt;Границы и что осталось неизвестным&lt;/a&gt;&lt;/h2&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;Все прогоны сделаны на hledger 1.52.4. Поведение &lt;code&gt;import&lt;/code&gt; в предварительных 1.99.x я не проверял; в release notes 1.99.6 изменений в семантике импорта не заявлено, но это не то же самое, что проверка&lt;sup id="fnref2:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt;.&lt;/li&gt;&#10;&lt;li&gt;Синтетические CSV не воспроизводят реальные банковские выгрузки: ни кодировок, ни разделителей, ни локальных форматов дат. Выводы о механике переносимы, выводы о частоте — нет.&lt;/li&gt;&#10;&lt;li&gt;Я не измерял, как часто банки меняют описание операции между выгрузками. Утверждение, что описание — самое неустойчивое поле, основано на структуре данных (два поля даты в camt.053, отдельные &lt;code&gt;NAME&lt;/code&gt; и &lt;code&gt;MEMO&lt;/code&gt; в OFX), а не на статистике.&lt;/li&gt;&#10;&lt;li&gt;GnuCash и beancount-import описаны по коду, проектному документу и README; я их не запускал, поэтому числа эвристик GnuCash — это веса из исходников, а не измеренная точность сопоставления.&lt;/li&gt;&#10;&lt;li&gt;Вопрос «что делать с корректировками» разобран только на уровне форматов: OFX даёт &lt;code&gt;CORRECTFITID&lt;/code&gt;/&lt;code&gt;REVERSALFITID&lt;/code&gt;&lt;sup id="fnref6:15"&gt;&lt;a href="#fn:15" class="footnote-ref" role="doc-noteref"&gt;15&lt;/a&gt;&lt;/sup&gt;, но как именно тот или иной банк ими пользуется в CSV-выгрузках, проверить нельзя — в CSV таких полей нет.&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;h2 id="заключение"&gt;&lt;a href="#%d0%b7%d0%b0%d0%ba%d0%bb%d1%8e%d1%87%d0%b5%d0%bd%d0%b8%d0%b5" class="post_hash"&gt;Заключение&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;&lt;code&gt;hledger import&lt;/code&gt; — хороший инструмент с точно очерченной гарантией: он не даст импортировать одно и то же дважды, если выписка ведёт себя как лог с монотонными датами и стабильным именем файла. Как только банк нарушает любое из четырёх допущений — а он их нарушает регулярно, — курсор ошибается в обе стороны, и ошибается молча.&lt;/p&gt;&#10;&lt;p&gt;Идентификатор операции — свойство формата, а не мастерство скрипта: OFX и ISO 20022 дают его (второй — опционально), CSV не даёт. Отпечаток содержимого — суррогат, который стоит строить только вместе с собственным состоянием и только понимая, что он защищает от перестановок, а не от дрейфа полей&lt;sup id="fnref7:15"&gt;&lt;a href="#fn:15" class="footnote-ref" role="doc-noteref"&gt;15&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;Сверка по остатку — не замена дедупликации и не её проверка: она ловит потери и дубли в агрегате, но пропускает компенсирующие пары. Ставить её нужно часто и на каждую выписку — тогда окно, в котором ошибки могут взаимно погаситься, остаётся маленьким&lt;sup id="fnref5:20"&gt;&lt;a href="#fn:20" class="footnote-ref" role="doc-noteref"&gt;20&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;h2 id="quality-metrics"&gt;&lt;a href="#quality-metrics" class="post_hash"&gt;Quality Metrics&lt;/a&gt;&lt;/h2&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Metric&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Значение&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Sources found&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;23&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Sources read&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;23&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Sources cited&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;23&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Доля official/academic/source&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;18 из 23 (78%)&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Покрытие цитированием (абзацы)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;75%&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Объём (весь текст с сносками)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;4 840 слов&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Версия под наблюдением&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;hledger 1.52.4 (2026-09-10)&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Дата данных&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;2026-11-15&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Собственные измерения&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;8 прогонов hledger на синтетических CSV&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;div class="footnotes" role="doc-endnotes"&gt;&#10;&lt;hr&gt;&#10;&lt;ol&gt;&#10;&lt;li id="fn:1"&gt;&#10;&lt;p&gt;Simon Michael and contributors. &amp;ldquo;hledger manual (1.52) — import, CSV, Deduplicating, importing.&amp;rdquo; hledger.org, 2026. &lt;a href="https://hledger.org/hledger.html#import"&gt;https://hledger.org/hledger.html#import&lt;/a&gt;&amp;#160;&lt;a href="#fnref:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref7:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref8:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref9:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref10:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref11:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref12:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref13:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:2"&gt;&#10;&lt;p&gt;Simon Michael and contributors. &amp;ldquo;hledger-lib/Hledger/Read.hs at tag 1.52.4 (journalFilterSinceLatestDates, latestDatesFileFor).&amp;rdquo; GitHub, 2026. &lt;a href="https://github.com/hledgerorg/hledger/blob/1.52.4/hledger-lib/Hledger/Read.hs"&gt;https://github.com/hledgerorg/hledger/blob/1.52.4/hledger-lib/Hledger/Read.hs&lt;/a&gt;&amp;#160;&lt;a href="#fnref:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref7:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref8:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref9:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:3"&gt;&#10;&lt;p&gt;hledger project. &amp;ldquo;Release 1.52.4.&amp;rdquo; GitHub, 10 September 2026. &lt;a href="https://github.com/hledgerorg/hledger/releases/tag/1.52.4"&gt;https://github.com/hledgerorg/hledger/releases/tag/1.52.4&lt;/a&gt;&amp;#160;&lt;a href="#fnref:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:4"&gt;&#10;&lt;p&gt;hledger project. &amp;ldquo;Release 1.99.6 (2.0 preview 6).&amp;rdquo; GitHub, 1 November 2026. &lt;a href="https://github.com/hledgerorg/hledger/releases/tag/1.99.6"&gt;https://github.com/hledgerorg/hledger/releases/tag/1.99.6&lt;/a&gt;&amp;#160;&lt;a href="#fnref:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:5"&gt;&#10;&lt;p&gt;GnuCash project. &amp;ldquo;libgnucash/engine/Split.h (online_id as OFX/HBCI FITID).&amp;rdquo; GitHub, 2026. &lt;a href="https://github.com/Gnucash/gnucash/blob/stable/libgnucash/engine/Split.h"&gt;https://github.com/Gnucash/gnucash/blob/stable/libgnucash/engine/Split.h&lt;/a&gt;&amp;#160;&lt;a href="#fnref:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:6"&gt;&#10;&lt;p&gt;Jeremy Maitin-Shepard. &amp;ldquo;beancount-import README (ofx_fitid metadata, matching, merge system).&amp;rdquo; GitHub, 2024. &lt;a href="https://github.com/jbms/beancount-import"&gt;https://github.com/jbms/beancount-import&lt;/a&gt;&amp;#160;&lt;a href="#fnref:6" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:6" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:6" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:6" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:6" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:6" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:7"&gt;&#10;&lt;p&gt;Simon Michael and contributors. &amp;ldquo;hledger/Hledger/Cli/Commands/Import.hs at tag 1.52.4.&amp;rdquo; GitHub, 2026. &lt;a href="https://github.com/hledgerorg/hledger/blob/1.52.4/hledger/Hledger/Cli/Commands/Import.hs"&gt;https://github.com/hledgerorg/hledger/blob/1.52.4/hledger/Hledger/Cli/Commands/Import.hs&lt;/a&gt;&amp;#160;&lt;a href="#fnref:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:8"&gt;&#10;&lt;p&gt;Simon Michael and contributors. &amp;ldquo;Tutorial: Import CSV data.&amp;rdquo; hledger.org, 2025. &lt;a href="https://hledger.org/import-csv.html"&gt;https://hledger.org/import-csv.html&lt;/a&gt;&amp;#160;&lt;a href="#fnref:8" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:9"&gt;&#10;&lt;p&gt;hledger issue #1943. &amp;ldquo;Import will miss transactions that show up on a date earlier than the date stored in .latest file.&amp;rdquo; GitHub, opened 2 November 2022. &lt;a href="https://github.com/hledgerorg/hledger/issues/1943"&gt;https://github.com/hledgerorg/hledger/issues/1943&lt;/a&gt;&amp;#160;&lt;a href="#fnref:9" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:9" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:9" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:10"&gt;&#10;&lt;p&gt;Simon Michael and contributors. &amp;ldquo;hledger manual (1.52) — CSV rules: source, archive, newest-first, intra-day-reversed, balance, balance-type.&amp;rdquo; hledger.org, 2026. &lt;a href="https://hledger.org/hledger.html#source"&gt;https://hledger.org/hledger.html#source&lt;/a&gt;&amp;#160;&lt;a href="#fnref:10" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:10" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:10" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:10" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:10" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:10" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:10" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:11"&gt;&#10;&lt;p&gt;Simon Michael and contributors. &amp;ldquo;Frequently Asked Questions — When importing CSV from two bank accounts, and there&amp;rsquo;s a transfer between them, how do I avoid duplicate entries?&amp;rdquo; hledger.org, 2026. &lt;a href="https://hledger.org/faq.html"&gt;https://hledger.org/faq.html&lt;/a&gt;&amp;#160;&lt;a href="#fnref:11" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:11" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:11" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:12"&gt;&#10;&lt;p&gt;hledger issue #2464. &amp;ldquo;Proposal: Import retroactively added transactions from CSV files.&amp;rdquo; GitHub, opened 23 September 2025. &lt;a href="https://github.com/hledgerorg/hledger/issues/2464"&gt;https://github.com/hledgerorg/hledger/issues/2464&lt;/a&gt;&amp;#160;&lt;a href="#fnref:12" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:12" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:13"&gt;&#10;&lt;p&gt;SWIFT reference guide. &amp;ldquo;Bank to Customer Statement (CAMT.053).&amp;rdquo; Bank of America, 2025. &lt;a href="https://images.em.bankofamerica.com/GTS/ISO_20022/ReferenceGuideBanktoCustomerStatement%28CAMT.053%29.pdf"&gt;https://images.em.bankofamerica.com/GTS/ISO_20022/ReferenceGuideBanktoCustomerStatement%28CAMT.053%29.pdf&lt;/a&gt;&amp;#160;&lt;a href="#fnref:13" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:13" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:13" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:14"&gt;&#10;&lt;p&gt;A. K. Elmagarmid, P. G. Ipeirotis, V. S. Verykios. &amp;ldquo;Duplicate Record Detection: A Survey.&amp;rdquo; IEEE TKDE, 2007. &lt;a href="https://www.cs.purdue.edu/homes/ake/pub/survey2.pdf"&gt;https://www.cs.purdue.edu/homes/ake/pub/survey2.pdf&lt;/a&gt;&amp;#160;&lt;a href="#fnref:14" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:14" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:14" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:14" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:15"&gt;&#10;&lt;p&gt;Financial Data Exchange. &amp;ldquo;OFX Banking Specification v2.3 — 3.2.3 Financial Institution Transaction ID FITID.&amp;rdquo; FDX, 2025. &lt;a href="https://financialdataexchange.org/wp-content/uploads/2025/12/OFX-Banking-Specification-v2.3.pdf"&gt;https://financialdataexchange.org/wp-content/uploads/2025/12/OFX-Banking-Specification-v2.3.pdf&lt;/a&gt;&amp;#160;&lt;a href="#fnref:15" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:15" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:15" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:15" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:15" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:15" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:15" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref7:15" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:16"&gt;&#10;&lt;p&gt;gnucash-devel mailing list. &amp;ldquo;Online ID matching for OFX import.&amp;rdquo; lists.gnucash.org, 9 January 2020. &lt;a href="https://lists.gnucash.org/pipermail/gnucash-devel/2020-January/044496.html"&gt;https://lists.gnucash.org/pipermail/gnucash-devel/2020-January/044496.html&lt;/a&gt;&amp;#160;&lt;a href="#fnref:16" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:17"&gt;&#10;&lt;p&gt;GnuCash project. &amp;ldquo;gnucash/import-export/import-backend.cpp and import-main-matcher.cpp (online_id lookup, match scoring).&amp;rdquo; GitHub, 2026. &lt;a href="https://github.com/Gnucash/gnucash/blob/stable/gnucash/import-export/import-backend.cpp"&gt;https://github.com/Gnucash/gnucash/blob/stable/gnucash/import-export/import-backend.cpp&lt;/a&gt;&amp;#160;&lt;a href="#fnref:17" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:17" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:18"&gt;&#10;&lt;p&gt;GnuCash project. &amp;ldquo;gnucash/import-export/generic-import-design.txt (match probability ladder).&amp;rdquo; GitHub, 2026. &lt;a href="https://github.com/Gnucash/gnucash/blob/stable/gnucash/import-export/generic-import-design.txt"&gt;https://github.com/Gnucash/gnucash/blob/stable/gnucash/import-export/generic-import-design.txt&lt;/a&gt;&amp;#160;&lt;a href="#fnref:18" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:18" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:18" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:19"&gt;&#10;&lt;p&gt;John Wiegley and contributors. &amp;ldquo;Ledger 3 manual — Major Changes from version 2.6.&amp;rdquo; ledger-cli.org, 2026. &lt;a href="https://ledger-cli.org/3.0/doc/ledger3.html"&gt;https://ledger-cli.org/3.0/doc/ledger3.html&lt;/a&gt;&amp;#160;&lt;a href="#fnref:19" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:19" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:20"&gt;&#10;&lt;p&gt;Simon Michael and contributors. &amp;ldquo;hledger manual (1.52) — Balance assertions.&amp;rdquo; hledger.org, 2026. &lt;a href="https://hledger.org/hledger.html#balance-assertions"&gt;https://hledger.org/hledger.html#balance-assertions&lt;/a&gt;&amp;#160;&lt;a href="#fnref:20" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:20" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:20" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:20" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:20" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:20" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:21"&gt;&#10;&lt;p&gt;Simon Michael and contributors. &amp;ldquo;hledger manual (1.52) — check command.&amp;rdquo; hledger.org, 2026. &lt;a href="https://hledger.org/hledger.html#check"&gt;https://hledger.org/hledger.html#check&lt;/a&gt;&amp;#160;&lt;a href="#fnref:21" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:22"&gt;&#10;&lt;p&gt;Stripe. &amp;ldquo;Idempotent requests.&amp;rdquo; docs.stripe.com, 2026. &lt;a href="https://docs.stripe.com/api/idempotent_requests"&gt;https://docs.stripe.com/api/idempotent_requests&lt;/a&gt;&amp;#160;&lt;a href="#fnref:22" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:23"&gt;&#10;&lt;p&gt;plaintextaccounting.org. &amp;ldquo;Data conversion/import (tools list).&amp;rdquo; plaintextaccounting.org, 2026. &lt;a href="https://plaintextaccounting.org/#data-conversionimport"&gt;https://plaintextaccounting.org/#data-conversionimport&lt;/a&gt;&amp;#160;&lt;a href="#fnref:23" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;/ol&gt;&#10;&lt;/div&gt;&#10;</content></entry><entry><title>Удаление в offline-first: tombstones, окно хранения и цена обязательного resync</title><id>https://research.evsyukov.org/articles/offline-first-tombstones-resync/</id><link href="https://research.evsyukov.org/articles/offline-first-tombstones-resync/" rel="alternate" type="text/html"/><published>2026-11-14T09:37:00+03:00</published><updated>2026-11-14T09:39:15+03:00</updated><author><name>Denis Evsyukov</name></author><summary type="html">Почему удаление в реплицируемой системе — это запись со сроком жизни, чем delete отличается от purge, и что происходит с клиентом, вернувшимся после окна хранения.</summary><content type="html">&lt;h2 id="аннотация"&gt;&lt;a href="#%d0%b0%d0%bd%d0%bd%d0%be%d1%82%d0%b0%d1%86%d0%b8%d1%8f" class="post_hash"&gt;Аннотация&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Удаление в системе, которая синхронизируется между устройствами, — не операция, а сообщение: чтобы стереть запись у всех, кто её уже получил, нужно отправить им факт удаления. Из этого следуют два неудобных свойства. Факт занимает место и стоит чтения, поэтому его нельзя хранить вечно; и как только он исчез, система теряет способность отличить «удалено» от «никогда не существовало». Обзор разбирает три уровня одной механики — delete/tombstone, compaction и purge/gc — на примере Apache CouchDB 3.5, Couchbase Sync Gateway, Apache Cassandra 5.0, Apache Kafka 4.4.0 и CRDT-библиотеки Yjs. Источники — официальная документация проектов, API-справочники, статья arXiv и трекер apache/couchdb; данные на 2026-11-14. Собственных экспериментов и замеров в обзоре нет: все числа ниже — значения по умолчанию из документации, а не результаты испытаний.&lt;/p&gt;&#10;&lt;p&gt;Главный вывод: срок хранения метаданных удаления — это не настройка экономии диска, а условие контракта с самым медленным участником. Окно обязано быть больше максимального интервала между визитами того, кто ещё держит состояние: ноды-реплики в Cassandra, консьюмера в Kafka, мобильного клиента в Sync Gateway. Второй вывод касается CouchDB: &lt;code&gt;delete&lt;/code&gt; реплицируется, а &lt;code&gt;purge&lt;/code&gt; — нет&lt;sup id="fnref:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;, и это единственная из рассмотренных систем, где оператор может навсегда развести источник и клиент одной административной командой. Третий: полный повторный sync не удаляет лишнее — репликация копирует отсутствующие ревизии и не передаёт отсутствие&lt;sup id="fnref1:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;, поэтому «сделаем resync» не является ответом на пропущенное удаление.&lt;/p&gt;&#10;&lt;h2 id="введение"&gt;&lt;a href="#%d0%b2%d0%b2%d0%b5%d0%b4%d0%b5%d0%bd%d0%b8%d0%b5" class="post_hash"&gt;Введение&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;&lt;strong&gt;Актуальность.&lt;/strong&gt; Offline-first перестал быть экзотикой: мобильные клиенты, десктоп-приложения с локальной базой и сервисы с двусторонней синхронизацией используют одну и ту же модель — у каждого участника есть копия, изменения доезжают с задержкой, порядок событий не гарантирован. В такой модели удаление — самая хрупкая операция, потому что она требует не доставки нового значения, а доставки &lt;em&gt;отсутствия&lt;/em&gt;. Ошибка здесь не видна сразу: документ просто остаётся у того, кто не успел, и всплывает через месяцы как «воскресшая» запись. Стоимость такой ошибки зависит от данных: для заметок это недоумение, для списка устройств с доступом — инцидент.&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;Цель&lt;/strong&gt; — показать механику удаления в реплицируемых хранилищах на уровне первичных документов: какие именно сущности создаются и уничтожаются на каждом шаге, какие числа задают срок их жизни, что происходит с участником, пропустившим окно, и какие проверки позволяют заметить расхождение до того, как оно станет инцидентом.&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;Границы.&lt;/strong&gt; Обзор не сравнивает «скорость синхронизации» и не измеряет объём метаданных: для этого нужны собственные стенды, а не документация. Не рассматриваются CRDT-библиотеки целиком (Automerge, Yjs) — только тот их аспект, который касается сборки мусора удалённого содержимого. Не рассматривается право на забвение (right to be forgotten) и требования регуляторов: это отдельная тема с юридическими, а не техническими критериями. Версии зафиксированы так: CouchDB 3.5 (документация &lt;code&gt;stable&lt;/code&gt;), Cassandra 5.0 (&lt;code&gt;latest&lt;/code&gt;), Kafka 4.4.0 (актуальный релиз на дату обзора&lt;sup id="fnref:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;), Sync Gateway и Yjs — документация &lt;code&gt;current&lt;/code&gt; на 2026-11-14.&lt;/p&gt;&#10;&lt;h2 id="1-удаление--это-запись"&gt;&lt;a href="#1-%d1%83%d0%b4%d0%b0%d0%bb%d0%b5%d0%bd%d0%b8%d0%b5--%d1%8d%d1%82%d0%be-%d0%b7%d0%b0%d0%bf%d0%b8%d1%81%d1%8c" class="post_hash"&gt;1. Удаление — это запись&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;База на одном узле может позволить себе стереть строку: после этого вопроса «а была ли она?» не возникает, потому что спросить некому. В реплицируемой системе такой ответ невозможен: отсутствие объекта на одном узле неотличимо от «этот узел его никогда не видел», а значит не может быть передано как факт. Cassandra формулирует это без оговорок: «Cassandra treats a deletion as an insertion, and inserts a time-stamped deletion marker called a tombstone»&lt;sup id="fnref:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;. Маркер идёт через обычный write path, попадает в SSTable на одной или нескольких нодах, и его отличие от обычной записи ровно одно — у него есть встроенный срок истечения&lt;sup id="fnref1:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;Тот же документ показывает, что происходит, если попытаться обойтись без маркеров. Кластер из трёх нод, значение &lt;code&gt;[A]&lt;/code&gt; на каждой; одна нода недоступна, удаление выполняется только на двух оставшихся. Состояние — &lt;code&gt;[], [], [A]&lt;/code&gt;. Следующий repair сравнивает наборы, видит расхождение и «чинит» две ноды по третьей: &lt;code&gt;[A], [A], [A]&lt;/code&gt;&lt;sup id="fnref2:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;. Удаление отменено процедурой восстановления, которая ни о чём не знала. Именно этот сценарий — не гипотетический, а описанный в документации как мотивация — объясняет, почему удаление в распределённой системе всегда дороже записи: оно должно быть устойчиво к восстановлению.&lt;/p&gt;&#10;&lt;p&gt;Kafka приходит к той же конструкции со стороны журнала: «A message with a key and a null payload will be treated as a delete from the log. Such a record is sometimes referred to as a tombstone»&lt;sup id="fnref:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt;. Маркер удаляет предыдущие сообщения с этим ключом, но, в отличие от них, сам живёт не вечно: «delete markers are special in that they will themselves be cleaned out of the log after a period of time to free up space»&lt;sup id="fnref1:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt;. Здесь виден весь конфликт в одном предложении — маркер нужен, чтобы удаление пережило отставание читателя, и маркер мешает, потому что занимает место.&lt;/p&gt;&#10;&lt;p&gt;В мобильной синхронизации та же сущность называется явно: «A tombstone is a persistent record showing that an item was deleted»&lt;sup id="fnref:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;. Артефакт в Sync Gateway минимален — ревизия документа, содержащая только идентификатор, идентификатор ревизии и пару &lt;code&gt;deleted: true&lt;/code&gt;&lt;sup id="fnref1:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;. Обоснование в документации сформулировано через поведение клиента, а не сервера: tombstone нужен, чтобы «all synchronizing devices can identify that an existing document is now deleted», и это важно для устройств, которые надолго уходят в офлайн и синхронизируются редко&lt;sup id="fnref2:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;CouchDB делает то же самое на уровне ревизий и говорит об этом прямо в описании &lt;code&gt;_purge&lt;/code&gt;: «Normal deletion of a document within CouchDB does not remove the document from the database, instead, the document is marked as &lt;code&gt;_deleted=true&lt;/code&gt; (and a new revision is created). This is to ensure that deleted documents can be replicated to other databases as having been deleted»&lt;sup id="fnref2:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;. Обратите внимание на порядок причин: не «чтобы не потерять историю», а «чтобы удаление можно было передать». История — побочный продукт.&lt;/p&gt;&#10;&lt;p&gt;Вывод раздела простой и он определяет всё дальнейшее: удаление — это новая запись, которая должна доехать до каждого участника. Пока она не доехала, копия существует и считается актуальной. Пока она доехала не до всех, система не может позволить себе её забыть.&lt;/p&gt;&#10;&lt;h2 id="2-три-операции-которые-обычно-называют-одним-словом"&gt;&lt;a href="#2-%d1%82%d1%80%d0%b8-%d0%be%d0%bf%d0%b5%d1%80%d0%b0%d1%86%d0%b8%d0%b8-%d0%ba%d0%be%d1%82%d0%be%d1%80%d1%8b%d0%b5-%d0%be%d0%b1%d1%8b%d1%87%d0%bd%d0%be-%d0%bd%d0%b0%d0%b7%d1%8b%d0%b2%d0%b0%d1%8e%d1%82-%d0%be%d0%b4%d0%bd%d0%b8%d0%bc-%d1%81%d0%bb%d0%be%d0%b2%d0%be%d0%bc" class="post_hash"&gt;2. Три операции, которые обычно называют одним словом&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;В разговорах «удалить документ» означает три разные операции с разным радиусом действия: &lt;code&gt;delete&lt;/code&gt; создаёт tombstone, &lt;code&gt;compaction&lt;/code&gt; освобождает место, &lt;code&gt;purge&lt;/code&gt;/&lt;code&gt;gc&lt;/code&gt; уничтожает сам маркер. Их смешение — источник большинства ошибок в эксплуатации, потому что только первая операция является частью протокола синхронизации.&lt;/p&gt;&#10;&lt;p&gt;&lt;code&gt;Compaction&lt;/code&gt; работает с байтами, а не с фактами. В CouchDB при компакции «the bodies of all the non-leaf documents are discarded. However, the list of historical &lt;code&gt;_revs&lt;/code&gt; is retained, for the benefit of later conflict resolution in case you meet any old replicas of the database at some time in future»&lt;sup id="fnref:6"&gt;&lt;a href="#fn:6" class="footnote-ref" role="doc-noteref"&gt;6&lt;/a&gt;&lt;/sup&gt;. То есть после компакции документ по-прежнему удалён, ревизия по-прежнему существует, а исчезли только тела старых версий. В Cassandra механика та же по смыслу: tombstone не удаляется, пока не истёк &lt;code&gt;gc_grace_seconds&lt;/code&gt; &lt;em&gt;и&lt;/em&gt; не произошла компакция, а для удаления нужен тот редкий случай, когда в одну компакцию попадают и SSTable с маркером, и все SSTable с более старыми данными&lt;sup id="fnref3:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;&lt;code&gt;Purge&lt;/code&gt; — точка невозврата. В CouchDB это административный API: «A database purge permanently removes the references to documents in the database»&lt;sup id="fnref3:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;, и после него документ «will not be available through &lt;code&gt;_all_docs&lt;/code&gt; or &lt;code&gt;_changes&lt;/code&gt; endpoints, as though this document never existed»&lt;sup id="fnref4:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;. Формулировка «as though this document never existed» — не метафора, а точное описание последствий: вместе с документом исчезает и свидетельство того, что его кто-то удалял. &lt;code&gt;_purge&lt;/code&gt; ограничен администраторами начиная с версии 2.3.1, а в запросе можно указывать только leaf-ревизии&lt;sup id="fnref5:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt; — то есть вычистить «середину» истории документа нельзя, можно только отрезать ветви.&lt;/p&gt;&#10;&lt;p&gt;У сборки мусора в CRDT та же роль, но другие условия. В Yjs это параметр документа: &lt;code&gt;doc.gc&lt;/code&gt; — «Set &lt;code&gt;doc.gc = false&lt;/code&gt; to disable garbage collection and be able to restore old content»&lt;sup id="fnref:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;. Одна фраза описывает весь компромисс: включённый gc освобождает место и убивает возможность отката, выключенный сохраняет историю и оставляет метаданные навсегда.&lt;/p&gt;&#10;&lt;p&gt;Разница между тремя операциями — это разница между «сообщить», «сжать» и «забыть». Только &lt;code&gt;delete&lt;/code&gt; является сообщением; &lt;code&gt;compaction&lt;/code&gt; — внутренняя оптимизация, о которой протокол не знает; &lt;code&gt;purge&lt;/code&gt; — локальное решение, которое протокол не умеет передать. Отсюда следует практическое правило: &lt;code&gt;purge&lt;/code&gt; — операция с побочным эффектом на консистентность, и относиться к ней нужно как к изменению схемы, а не как к уборке.&lt;/p&gt;&#10;&lt;h2 id="3-сколько-стоит-tombstone"&gt;&lt;a href="#3-%d1%81%d0%ba%d0%be%d0%bb%d1%8c%d0%ba%d0%be-%d1%81%d1%82%d0%be%d0%b8%d1%82-tombstone" class="post_hash"&gt;3. Сколько стоит tombstone&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Маркер платит дважды: на записи и на чтении. На записи это дополнительная запись в журнал или SSTable на каждое удаление. На чтении — работа, которую нельзя пропустить: Cassandra при поиске обязана учитывать tombstone и игнорировать все значения, время которых меньше времени маркера&lt;sup id="fnref4:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;, а «полностью истёкшие» SSTable, состоящие только из маркеров, не удаляются, если их перекрывают более старые данные — для диагностики в поставке есть &lt;code&gt;sstableexpiredblockers&lt;/code&gt;&lt;sup id="fnref5:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;Цена чтения измерена в литературе по LSM-движкам, и цифры там не косметические. В статье про range delete: удаление реализуется вставкой tombstone, «instead of removing it in place», и это откладывает реальное удаление до компакции&lt;sup id="fnref:8"&gt;&lt;a href="#fn:8" class="footnote-ref" role="doc-noteref"&gt;8&lt;/a&gt;&lt;/sup&gt;. Дальше — результат эксперимента авторов: «point lookup latency can increase by 30% even with just 1% range deletions in workloads»&lt;sup id="fnref1:8"&gt;&lt;a href="#fn:8" class="footnote-ref" role="doc-noteref"&gt;8&lt;/a&gt;&lt;/sup&gt;. Оговорка обязательна: речь о range tombstones в LSM-движке, а не о tombstone синхронизации; но механизм общий — маркер, который нельзя пропустить при чтении, стоит латентности, а не только диска.&lt;/p&gt;&#10;&lt;p&gt;Компакция тоже не бесплатна. CouchDB при компакции пересоздаёт файл базы целиком, и «as this requires roughly twice the disk storage, CouchDB first checks for available disk space before proceeding»&lt;sup id="fnref:9"&gt;&lt;a href="#fn:9" class="footnote-ref" role="doc-noteref"&gt;9&lt;/a&gt;&lt;/sup&gt;. Для оператора это означает, что «освободить место компакцией» на почти полном диске — плохой план: временно нужно вдвое больше.&lt;/p&gt;&#10;&lt;p&gt;Именно цена метаданных заставляет проектировщиков CRDT искать способы обойтись без маркеров: в работе про оптимизированный replicated set сказано прямо — «in order to decrease the size of meta-data, we propose a new optimization to avoid tombstones»&lt;sup id="fnref:10"&gt;&lt;a href="#fn:10" class="footnote-ref" role="doc-noteref"&gt;10&lt;/a&gt;&lt;/sup&gt;. Важно, как эта работа это делает: сначала вводится абстракция рассуждения (permutation equivalence), которая систематизирует ожидаемую семантику конкурентных типов, и только потом — оптимизация&lt;sup id="fnref1:10"&gt;&lt;a href="#fn:10" class="footnote-ref" role="doc-noteref"&gt;10&lt;/a&gt;&lt;/sup&gt;. Иными словами, отказ от tombstones — не удаление стоимости, а перенос её в более сильные предположения о доставке и в более сложное доказательство корректности.&lt;/p&gt;&#10;&lt;p&gt;Сложив три части, получаем структурную причину всех проблем ниже: маркер дорог и на записи, и на чтении, и на диске, поэтому соблазн удалить его раньше времени возникает постоянно. Срок его жизни — это и есть точка, где система решает, сколько она готова платить за право отличать «удалено» от «не было».&lt;/p&gt;&#10;&lt;h2 id="4-окно-хранения-как-контракт"&gt;&lt;a href="#4-%d0%be%d0%ba%d0%bd%d0%be-%d1%85%d1%80%d0%b0%d0%bd%d0%b5%d0%bd%d0%b8%d1%8f-%d0%ba%d0%b0%d0%ba-%d0%ba%d0%be%d0%bd%d1%82%d1%80%d0%b0%d0%ba%d1%82" class="post_hash"&gt;4. Окно хранения как контракт&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Все рассмотренные системы хранят маркер не «разумное время», а конкретный интервал, и у каждого интервала есть второй участник, под которого он подобран. Общее правило формулируется так: окно хранения должно превышать максимальный интервал между визитами участника, который ещё держит состояние и может его вернуть. Если окно меньше — удаление протекает.&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;Cassandra: окно под repair.&lt;/strong&gt; &lt;code&gt;gc_grace_seconds&lt;/code&gt; по умолчанию равен 864000 секундам, то есть десяти суткам, после чего маркер истекает и может быть удалён при компакции&lt;sup id="fnref6:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;. Назначение срока описано буквально: дать недоступным нодам время восстановиться и обработать tombstone обычным порядком&lt;sup id="fnref7:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;. Обратная сторона в том же документе: «If a node remains down or disconnected for longer than &lt;code&gt;gc_grace_seconds&lt;/code&gt;, its deleted data will be repaired back to the other nodes and reappear in the cluster»&lt;sup id="fnref8:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;. Документация по repair переводит это в эксплуатационное требование: «At a minimum, repair should be run often enough that the gc grace period never expires on unrepaired data. Otherwise, deleted data could reappear. With a default gc grace period of 10 days, repairing every node in your cluster at least once every 7 days will prevent this, while providing enough slack to allow for delays»&lt;sup id="fnref:11"&gt;&lt;a href="#fn:11" class="footnote-ref" role="doc-noteref"&gt;11&lt;/a&gt;&lt;/sup&gt;. Здесь видно, откуда берётся число: 10 суток — не про хранение, а про «repair раз в неделю плюс запас».&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;Kafka: окно под отставание консьюмера.&lt;/strong&gt; &lt;code&gt;delete.retention.ms&lt;/code&gt; по умолчанию — 86400000 миллисекунд, одни сутки&lt;sup id="fnref:12"&gt;&lt;a href="#fn:12" class="footnote-ref" role="doc-noteref"&gt;12&lt;/a&gt;&lt;/sup&gt;. Документация параметра объясняет, что это ещё и граница времени, за которое консьюмер обязан дочитать: иначе «delete tombstones may be collected before they complete their scan»&lt;sup id="fnref1:12"&gt;&lt;a href="#fn:12" class="footnote-ref" role="doc-noteref"&gt;12&lt;/a&gt;&lt;/sup&gt;. Гарантия в разделе Design сформулирована условно: «all delete markers for deleted records will be seen, provided the consumer reaches the head of the log in a time period less than the topic&amp;rsquo;s &lt;code&gt;delete.retention.ms&lt;/code&gt; setting (the default is 24 hours)»&lt;sup id="fnref2:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt;, и следом — прямое признание: «since the removal of delete markers happens concurrently with reads, it is possible for a consumer to miss delete markers if it lags by more than &lt;code&gt;delete.retention.ms&lt;/code&gt;»&lt;sup id="fnref3:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt;. Это редкий случай, когда продукт сам называет точку, в которой его гарантия перестаёт действовать.&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;Couchbase: окно под мобильного клиента.&lt;/strong&gt; В Sync Gateway tombstone уезжает на устройство, но на сервере Couchbase его удаляет &lt;code&gt;metadata purge interval&lt;/code&gt;, и «when the server purges a tombstone, based on that interval, it no longer replicates to mobile clients»&lt;sup id="fnref3:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;. Значение по умолчанию на Couchbase Server — 3 суток, и документация предупреждает, что оно «can purge tombstones before all clients have synced them»&lt;sup id="fnref4:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;; рекомендация сформулирована как правило выбора: «Set the server&amp;rsquo;s metadata purge interval based on your expected client replication frequency»&lt;sup id="fnref5:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;. В Capella при подключении App Service к кластеру интервал выставляется в 60 суток для всех бакетов&lt;sup id="fnref6:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;, а при удалении App Service «Capella resets the interval to 3 days, and the next compaction can purge tombstones older than 3 days»&lt;sup id="fnref7:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;CouchDB: окно под индексы и внутреннюю репликацию.&lt;/strong&gt; Здесь параметр другой природы: &lt;code&gt;purged_infos_limit&lt;/code&gt; (по умолчанию 1000) ограничивает не время, а число исторических purge-запросов, которые база помнит&lt;sup id="fnref6:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;. Во время компакции «the oldest purge requests are to be removed to store only &lt;code&gt;purged_infos_limit&lt;/code&gt; number of purges in the database. But in order to keep the database consistent with indexes and other replicas, we can only remove purge requests that have already been processed by indexes and internal replications jobs»&lt;sup id="fnref:13"&gt;&lt;a href="#fn:13" class="footnote-ref" role="doc-noteref"&gt;13&lt;/a&gt;&lt;/sup&gt;. То есть окно здесь измеряется не днями, а количеством событий — и это тот же контракт, только выраженный в других единицах.&lt;/p&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Система&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Параметр&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;По умолчанию&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Второй участник&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Что происходит при просрочке&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Cassandra 5.0&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;gc_grace_seconds&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;864000 с (10 суток)&lt;sup id="fnref9:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;нода-реплика, догоняющая через repair&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;удалённые данные возвращаются репликой&lt;sup id="fnref10:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Kafka 4.4.0&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;delete.retention.ms&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;86400000 мс (1 сутки)&lt;sup id="fnref2:12"&gt;&lt;a href="#fn:12" class="footnote-ref" role="doc-noteref"&gt;12&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;консьюмер, читающий от начала&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;консьюмер не увидит delete-маркер&lt;sup id="fnref4:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Couchbase Server&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;metadata purge interval&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;3 суток (Capella — 60)&lt;sup id="fnref8:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;мобильный клиент&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;tombstone не репликуется клиенту&lt;sup id="fnref9:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;CouchDB 3.5&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;purged_infos_limit&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;1000 purge-записей&lt;sup id="fnref7:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;индекс и внутренняя репликация&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;компакция purge-деревьев блокируется, в лог уходит предупреждение&lt;sup id="fnref1:13"&gt;&lt;a href="#fn:13" class="footnote-ref" role="doc-noteref"&gt;13&lt;/a&gt;&lt;/sup&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;Таблица показывает главное: числа различаются на два порядка, потому что различаются не требования к диску, а частота визитов второго участника. Repair — раз в неделю, консьюмер — минуты и часы, мобильный клиент — дни и недели. Поэтому «у нас окно 3 дня, как у Couchbase» не является аргументом: 3 дня — утверждение о том, как часто синхронизируются клиенты конкретного продукта, а не свойство tombstone.&lt;/p&gt;&#10;&lt;h2 id="5-couchdb-purge-который-не-уезжает"&gt;&lt;a href="#5-couchdb-purge-%d0%ba%d0%be%d1%82%d0%be%d1%80%d1%8b%d0%b9-%d0%bd%d0%b5-%d1%83%d0%b5%d0%b7%d0%b6%d0%b0%d0%b5%d1%82" class="post_hash"&gt;5. CouchDB: purge, который не уезжает&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Если удаление — это сообщение, то самое важное свойство системы — что происходит с сообщением, когда его уничтожают. В CouchDB ответ неожиданно асимметричен: &lt;code&gt;purge&lt;/code&gt; не является частью внешней репликации. Документация говорит это дважды, в разных формулировках: «Purge operations are not replicated to other external databases»&lt;sup id="fnref8:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt; и, в примечании для оператора, «If you need a purge to be effective across multiple effective databases, you must run the purge separately on each of the databases»&lt;sup id="fnref9:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;Причина названа там же и она механическая: «External replication works by identifying a source&amp;rsquo;s document revisions that are missing on target, and copying these revisions from source to target»&lt;sup id="fnref10:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;. Репликация передаёт ревизии, а не их отсутствие; у purge нет ревизии, которую можно было бы передать, — он стирает саму возможность сослаться на документ. Внутри кластера проблема решается отдельным механизмом: purge-запросы реплицируются между репликами шардов через внутренние purge-деревья, помечаются UUID, а индексы и внутренние репликации отчитываются checkpoint-документами вида &lt;code&gt;_local/purge-{type}-{hash}&lt;/code&gt;&lt;sup id="fnref2:13"&gt;&lt;a href="#fn:13" class="footnote-ref" role="doc-noteref"&gt;13&lt;/a&gt;&lt;/sup&gt;. Но это внутренняя синхронизация шардов одной базы, а не протокол для клиентов.&lt;/p&gt;&#10;&lt;p&gt;Для клиента последствия выглядят как тишина. Клиент приходит с &lt;code&gt;since&lt;/code&gt; — «Start the results from the change immediately after the given update sequence»&lt;sup id="fnref:14"&gt;&lt;a href="#fn:14" class="footnote-ref" role="doc-noteref"&gt;14&lt;/a&gt;&lt;/sup&gt; — и получает только те изменения, которые произошли после его checkpoint. Документ, удалённый и затем очищенный purge, в этом потоке не появится: purge увеличивает &lt;code&gt;update_seq&lt;/code&gt; и &lt;code&gt;purge_seq&lt;/code&gt;, но самого документа уже нет ни в &lt;code&gt;_all_docs&lt;/code&gt;, ни в &lt;code&gt;_changes&lt;/code&gt;&lt;sup id="fnref11:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;. Клиент не получает ни удаления, ни ошибки — он получает «ничего», что для него неотличимо от «изменений не было». Документация &lt;code&gt;_changes&lt;/code&gt; отдельно предупреждает про другую, более мягкую форму этого эффекта — при переключении на другую реплику шарда «you might see changes again that you have previously seen», поэтому потребитель должен быть идемпотентным&lt;sup id="fnref1:14"&gt;&lt;a href="#fn:14" class="footnote-ref" role="doc-noteref"&gt;14&lt;/a&gt;&lt;/sup&gt;; но случай purge хуже, потому что идемпотентность не помогает увидеть то, чего в потоке нет.&lt;/p&gt;&#10;&lt;p&gt;Отсюда следует сценарий, который стоит проговорить явно, хотя в документации он не описан как отдельный случай (это вывод из двух документированных фактов, а не протестированное поведение): если клиент, всё ещё хранящий копию, отправит новую ревизию этого документа, сервер примет её как новую запись: purge стёр документ из b-tree и дерева последовательностей, и для сервера его как будто не было — «as though this document never existed»&lt;sup id="fnref12:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;. Ничто не может отклонить такую запись как конфликт с несуществующим предком. Удаление, очищенное purge на сервере, возвращается с клиента, который о нём не узнал. Я не проверял это экспериментом и не нашёл документированного описания; проверять это стоит на собственном стенде перед тем, как закладывать в процедуры.&lt;/p&gt;&#10;&lt;p&gt;Отдельно нужно отделить штатный случай от аварийного. Если один участник удалил документ, а другой одновременно его изменил, CouchDB не «воскрешает» ничего: обе ревизии остаются в дереве, победитель выбирается детерминированно, а проигравшая ветвь остаётся leaf-узлом с &lt;code&gt;_deleted: true&lt;/code&gt; и доступна по &lt;code&gt;?rev=&lt;/code&gt;&lt;sup id="fnref1:6"&gt;&lt;a href="#fn:6" class="footnote-ref" role="doc-noteref"&gt;6&lt;/a&gt;&lt;/sup&gt;. PouchDB описывает то же поведение и советует хранить проигравшие ревизии для ручного разрешения&lt;sup id="fnref:15"&gt;&lt;a href="#fn:15" class="footnote-ref" role="doc-noteref"&gt;15&lt;/a&gt;&lt;/sup&gt;. Это нормальная работа конфликтной модели, и путать её с пропущенным удалением нельзя: в первом случае у вас есть обе версии и выбор, во втором — только та, которую вы не должны были сохранить.&lt;/p&gt;&#10;&lt;h2 id="6-клиент-вернувшийся-после-окна"&gt;&lt;a href="#6-%d0%ba%d0%bb%d0%b8%d0%b5%d0%bd%d1%82-%d0%b2%d0%b5%d1%80%d0%bd%d1%83%d0%b2%d1%88%d0%b8%d0%b9%d1%81%d1%8f-%d0%bf%d0%be%d1%81%d0%bb%d0%b5-%d0%be%d0%ba%d0%bd%d0%b0" class="post_hash"&gt;6. Клиент, вернувшийся после окна&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Есть три разных «возвращения», и лечатся они по-разному. Первое — клиент вернулся со свежим checkpoint и просто не знает о давнем удалении (это лечится окном). Второе — клиент вернулся с устаревшей копией данных (это лечится пересборкой). Третье — клиент восстановлен из резервной копии, снятой до очистки (это не лечится ничем, кроме проверки на стороне сервера).&lt;/p&gt;&#10;&lt;p&gt;Пересборка работает, и работает именно потому, что репликация не передаёт отсутствие. PouchDB формулирует это как предупреждение, которое по сути и есть рецепт: репликация «tracks the data within a database, not the database itself», поэтому «If you &lt;code&gt;destroy()&lt;/code&gt; a database that is being replicated to, the next time the replication starts it will transfer all of the data again, recreating the database to the state it was before it was destroyed»&lt;sup id="fnref:16"&gt;&lt;a href="#fn:16" class="footnote-ref" role="doc-noteref"&gt;16&lt;/a&gt;&lt;/sup&gt;. Если уничтожить локальную базу и заново вытянуть данные с источника, в котором удаление уже очищено, клиент получит состояние без документа. Проблема в том, что тот же механизм работает и в обратную сторону: восстановление из старой копии возвращает документ, потому что репликация честно переносит все ревизии, которых у цели нет.&lt;/p&gt;&#10;&lt;p&gt;Практический вывод для процедур: пересборку можно делать только с источника, про который известно, что очистка на нём уже произошла, и до завершения первой полной синхронизации пуши с клиента нужно блокировать. Иначе «восстановление клиента» само становится операцией воскрешения. В документации Sync Gateway об этом же говорит правило «сначала убедитесь, что клиенты получили удаления» — оно сформулировано для удаления App Service, но верно для любой очистки: «Before you delete an App Service, make sure your clients have synced their deletions»&lt;sup id="fnref10:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;Заметить расхождение можно, если хранить аудит очистки. В CouchDB &lt;code&gt;_purged_infos&lt;/code&gt; возвращает список идентификаторов и ревизий, которые были очищены&lt;sup id="fnref13:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt; — это единственный след операции после того, как сам документ исчез. Сравнение этого списка с локальным набором идентификаторов клиента даёт дешёвую проверку «не держим ли мы то, что сервер забыл». На клиенте Couchbase Lite аналогичная операция есть и её нужно вызывать отдельно: «You must also purge tombstones on Couchbase Lite»&lt;sup id="fnref11:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;Особый случай — удаление, вызванное не решением пользователя, а изменением прав. В Sync Gateway потеря доступа к каналу по умолчанию приводит к автоматической очистке: «when a user loses access to a channel, the next Couchbase Lite Pull replication auto-purges all documents in the channel from local Couchbase Lite databases»&lt;sup id="fnref:17"&gt;&lt;a href="#fn:17" class="footnote-ref" role="doc-noteref"&gt;17&lt;/a&gt;&lt;/sup&gt;. Здесь та же асимметрия, что и с окном хранения, только по другому измерению: политика не имеет обратной силы. «If you turn it on during an existing replication, no revocations occurring prior to that point are retro-actively purged. To have this done, execute a reset for ISGR (on Couchbase Lite a reset checkpoint must be carried out)»&lt;sup id="fnref1:17"&gt;&lt;a href="#fn:17" class="footnote-ref" role="doc-noteref"&gt;17&lt;/a&gt;&lt;/sup&gt;. То есть включение политики не чинит накопленное состояние; нужен явный сброс checkpoint, который заставит клиента перечитать всё заново.&lt;/p&gt;&#10;&lt;h2 id="7-как-выбрать-окно-и-что-проверять"&gt;&lt;a href="#7-%d0%ba%d0%b0%d0%ba-%d0%b2%d1%8b%d0%b1%d1%80%d0%b0%d1%82%d1%8c-%d0%be%d0%ba%d0%bd%d0%be-%d0%b8-%d1%87%d1%82%d0%be-%d0%bf%d1%80%d0%be%d0%b2%d0%b5%d1%80%d1%8f%d1%82%d1%8c" class="post_hash"&gt;7. Как выбрать окно и что проверять&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Выбор окна начинается не с параметра, а с вопроса «сколько времени клиент может отсутствовать, оставаясь нашим клиентом». Ответ на него — не среднее, а хвост распределения: p99 отсутствия, а не медиана. Дальше окно = этот хвост плюс запас на восстановление (repair, догон консьюмера, повторную синхронизацию). У Sync Gateway это прямое указание в документации&lt;sup id="fnref12:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;, у Cassandra — требование к частоте repair&lt;sup id="fnref1:11"&gt;&lt;a href="#fn:11" class="footnote-ref" role="doc-noteref"&gt;11&lt;/a&gt;&lt;/sup&gt;, у Kafka — условие гарантии&lt;sup id="fnref5:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt;; во всех трёх случаях число выводится из второго участника, а не из размера диска.&lt;/p&gt;&#10;&lt;p&gt;Второй шаг — сделать это окно наблюдаемым. Checkpoint сам по себе не содержит возраста: в CouchDB это последовательность, а не время&lt;sup id="fnref2:14"&gt;&lt;a href="#fn:14" class="footnote-ref" role="doc-noteref"&gt;14&lt;/a&gt;&lt;/sup&gt;, поэтому «клиент отстал на 40 000 изменений» не говорит, давно ли он был. Нужна отдельная запись «последняя успешная синхронизация» на клиента или на устройство, и правило: если она старше окна, обычная синхронизация запрещена, требуется сброс и полная пересборка. Механизм сброса в Sync Gateway документирован — reset checkpoint у клиента и reset у Inter-Sync Gateway&lt;sup id="fnref2:17"&gt;&lt;a href="#fn:17" class="footnote-ref" role="doc-noteref"&gt;17&lt;/a&gt;&lt;/sup&gt;; в CouchDB эквивалент — удаление локальной базы&lt;sup id="fnref1:16"&gt;&lt;a href="#fn:16" class="footnote-ref" role="doc-noteref"&gt;16&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;Третий шаг — не пытаться сэкономить на истории ревизий. Соблазн понятен: &lt;code&gt;_revs_limit&lt;/code&gt; уменьшает дерево ревизий и объём метаданных на клиенте, и в обсуждениях это выглядит как решение проблемы с памятью PouchDB на документах с множеством разрешённых конфликтов. Ответ коллаборатора проекта в том же обсуждении однозначен: «If you mess with &lt;code&gt;_revs_limit&lt;/code&gt; you can potentially break replication, if the common ancestor is lost - as you have seen»&lt;sup id="fnref:18"&gt;&lt;a href="#fn:18" class="footnote-ref" role="doc-noteref"&gt;18&lt;/a&gt;&lt;/sup&gt;. Общий предок — это то, что позволяет репликации понять, чья ревизия новее; сократив историю, вы получаете конфликты вместо обновлений.&lt;/p&gt;&#10;&lt;p&gt;Четвёртый шаг — проверки, что очистка действительно дошла до тех, кто её обслуживает. В CouchDB компакция purge-деревьев блокируется, если индекс или внутренняя репликация отстали сильнее, чем &lt;code&gt;purged_infos_limit&lt;/code&gt; + &lt;code&gt;allowed_purge_seq_lag&lt;/code&gt; (по умолчанию 100), и в лог уходит предупреждение вида «Purge checkpoint … not updated in 86400 seconds»&lt;sup id="fnref3:13"&gt;&lt;a href="#fn:13" class="footnote-ref" role="doc-noteref"&gt;13&lt;/a&gt;&lt;/sup&gt;; это сигнал, что очистка не завершена, а не косметическое сообщение. В Cassandra проверка встроена в старт: &lt;code&gt;check_data_resurrection&lt;/code&gt; умеет «fail startup if the node is down for longer than &lt;code&gt;gc_grace_seconds&lt;/code&gt;, to potentially prevent data resurrection on tables with deletes»&lt;sup id="fnref:19"&gt;&lt;a href="#fn:19" class="footnote-ref" role="doc-noteref"&gt;19&lt;/a&gt;&lt;/sup&gt;, а для строгого режима есть &lt;code&gt;only_purge_repaired_tombstones&lt;/code&gt;, при котором маркеры удаляются только после repair&lt;sup id="fnref11:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;. В Kafka проверка — это лаг консьюмера против &lt;code&gt;delete.retention.ms&lt;/code&gt;: если читатель от начала журнала не успевает за окно, его представление о финальном состоянии неполно по определению&lt;sup id="fnref3:12"&gt;&lt;a href="#fn:12" class="footnote-ref" role="doc-noteref"&gt;12&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;Пятый шаг — порядок операций. Удаление и очистка не должны быть одной операцией: сначала &lt;code&gt;delete&lt;/code&gt; (сообщение уезжает всем), затем подтверждение получения от клиентов, и только потом &lt;code&gt;purge&lt;/code&gt;, причём отдельно на каждой базе и с сохранением списка очищенного через &lt;code&gt;_purged_infos&lt;/code&gt;&lt;sup id="fnref14:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;. В Cassandra этому порядку соответствует repair-цикл короче &lt;code&gt;gc_grace_seconds&lt;/code&gt;&lt;sup id="fnref2:11"&gt;&lt;a href="#fn:11" class="footnote-ref" role="doc-noteref"&gt;11&lt;/a&gt;&lt;/sup&gt;, в Sync Gateway — синхронизация клиентов до удаления App Service&lt;sup id="fnref13:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;. Во всех случаях очистка идёт последней, потому что она единственная необратимая.&lt;/p&gt;&#10;&lt;p&gt;Модель объёма получается простой и её стоит держать в голове при выборе окна: число маркеров ≈ число удалений за окно, умноженное на (1 + доля повторов при повторной доставке). Для Kafka это записи в компактируемом журнале, для Cassandra — маркеры плюс записи в индексах, для CouchDB — узлы дерева ревизий, а не только tombstone. Замеров этой доли в публичных источниках я не нашёл; все числа выше — значения по умолчанию из документации, и подставлять их в планирование ёмкости без собственного измерения нельзя.&lt;/p&gt;&#10;&lt;h2 id="8-дискуссионные-вопросы-и-противоречия"&gt;&lt;a href="#8-%d0%b4%d0%b8%d1%81%d0%ba%d1%83%d1%81%d1%81%d0%b8%d0%be%d0%bd%d0%bd%d1%8b%d0%b5-%d0%b2%d0%be%d0%bf%d1%80%d0%be%d1%81%d1%8b-%d0%b8-%d0%bf%d1%80%d0%be%d1%82%d0%b8%d0%b2%d0%be%d1%80%d0%b5%d1%87%d0%b8%d1%8f" class="post_hash"&gt;8. Дискуссионные вопросы и противоречия&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;&lt;strong&gt;Сравнивать 1 сутки и 10 суток нельзя.&lt;/strong&gt; Kafka и Cassandra выглядят как два ответа на один вопрос, но вопрос разный. У Kafka окно ограничивает отставание читателя, который сам решил читать от начала журнала&lt;sup id="fnref6:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt;; у Cassandra — окно восстановления реплики, которая выпала из кластера&lt;sup id="fnref3:11"&gt;&lt;a href="#fn:11" class="footnote-ref" role="doc-noteref"&gt;11&lt;/a&gt;&lt;/sup&gt;. Если поменять их местами, обе системы станут некорректными: консьюмеру с сутками не хватит времени на переобработку, а реплике с сутками не хватит времени на repair. Один и тот же параметр «срок хранения маркера» описывает разные контракты, и перенос числа из одной системы в другую — типичная ошибка при проектировании своей синхронизации.&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;60 суток в Capella — это политика, а не физика.&lt;/strong&gt; Документация Sync Gateway говорит, что при подключении App Service интервал становится 60 суток, а для большего значения нужно обращаться в поддержку, которая «assess the storage impact before they change it»&lt;sup id="fnref14:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;. То есть верхняя граница задана стоимостью хранения, а не требованиями протокола. Отдельно стоит отметить, как это ломает ожидания: удаление App Service возвращает интервал к 3 суткам, и «the next compaction can purge tombstones older than 3 days»&lt;sup id="fnref15:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;. Гарантия доставки удалений молча сокращается с двух месяцев до трёх дней — операция, которая выглядит как удаление сервиса, меняет свойство данных, которые остались.&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;У CouchDB документированное расхождение и нет встроенной сверки.&lt;/strong&gt; Документация честно говорит, что purge не реплицируется внешне и что его нужно выполнять на каждой базе отдельно&lt;sup id="fnref15:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;. Но механизма, который обнаружил бы, что источник и клиент разошлись в понимании «удалён», в самой базе нет: &lt;code&gt;_purged_infos&lt;/code&gt; даёт список очищенного, а сравнение с клиентом остаётся задачей приложения. Это не дефект реализации, а следствие модели: система, которая не передаёт отсутствие, не может и проверить его наличие.&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;Сборка мусора в CRDT не отменяет проблему, а перекладывает её.&lt;/strong&gt; В Yjs состояние синхронизируется, и включённый gc делает удалённое содержимое неотличимым от никогда не существовавшего для тех, кто приходит позже&lt;sup id="fnref1:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;; выключенный gc сохраняет возможность отката, но возвращает рост метаданных. В работе про replicated set отказ от tombstones предлагается как оптимизация объёма метаданных&lt;sup id="fnref2:10"&gt;&lt;a href="#fn:10" class="footnote-ref" role="doc-noteref"&gt;10&lt;/a&gt;&lt;/sup&gt;, но при более сильных предположениях о доставке. В LSM-движке маркер остаётся частью модели хранения: удаление там «handled by inserting a tombstone to mark its staleness instead of removing it in place», и движок не может освободиться от маркера, пока существует более старая версия того же ключа&lt;sup id="fnref2:8"&gt;&lt;a href="#fn:8" class="footnote-ref" role="doc-noteref"&gt;8&lt;/a&gt;&lt;/sup&gt;. Три слоя — приложение, CRDT, движок хранения — решают одну задачу разными средствами, и оптимизация на одном слое не отменяет необходимости в другом.&lt;/p&gt;&#10;&lt;h2 id="недостаточность-данных"&gt;&lt;a href="#%d0%bd%d0%b5%d0%b4%d0%be%d1%81%d1%82%d0%b0%d1%82%d0%be%d1%87%d0%bd%d0%be%d1%81%d1%82%d1%8c-%d0%b4%d0%b0%d0%bd%d0%bd%d1%8b%d1%85" class="post_hash"&gt;Недостаточность данных&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Публичных измерений доли tombstone в объёме для CouchDB и Sync Gateway я не нашёл; мои оценки объёма в разделе 7 — это формула, а не замер. Поведение push ревизии документа, очищенного purge, выведено из семантики &lt;code&gt;_purge&lt;/code&gt; и модели внешней репликации, но не описано в документации как сценарий и не проверено экспериментом — это первый кандидат на собственный стенд. Версия Sync Gateway зафиксирована как «текущая документация» на 2026-11-14: значения по умолчанию (&lt;code&gt;metadata purge interval&lt;/code&gt;, 60 суток в Capella) могли меняться между релизами, и перед применением их нужно сверять с release notes своей версии. Распределение времени отсутствия реальных мобильных клиентов в развёртываниях Sync Gateway публично не описано, поэтому рекомендация «p99, а не среднее» остаётся принципом без численного примера.&lt;/p&gt;&#10;&lt;h2 id="заключение"&gt;&lt;a href="#%d0%b7%d0%b0%d0%ba%d0%bb%d1%8e%d1%87%d0%b5%d0%bd%d0%b8%d0%b5" class="post_hash"&gt;Заключение&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Удаление в offline-first — это запись, которая должна доехать до всех участников, и одновременно запись, которую нельзя хранить вечно. Из этого противоречия вырастает вся механика: tombstone как факт, компакция как освобождение места без потери факта, purge и gc как необратимое забывание. Пока маркер жив, система помнит, что документ удалён; после очистки она помнит только то, что документа нет, — и этого недостаточно, чтобы убедить клиента.&lt;/p&gt;&#10;&lt;p&gt;Практические выводы, которые следуют из документов:&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;strong&gt;Окно хранения — это контракт с самым медленным участником.&lt;/strong&gt; &lt;code&gt;gc_grace_seconds&lt;/code&gt; = 10 суток под repair раз в неделю&lt;sup id="fnref12:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref4:11"&gt;&lt;a href="#fn:11" class="footnote-ref" role="doc-noteref"&gt;11&lt;/a&gt;&lt;/sup&gt;, &lt;code&gt;delete.retention.ms&lt;/code&gt; = 1 сутки под отставание консьюмера&lt;sup id="fnref4:12"&gt;&lt;a href="#fn:12" class="footnote-ref" role="doc-noteref"&gt;12&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref7:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt;, &lt;code&gt;metadata purge interval&lt;/code&gt; = 3 суток под мобильного клиента&lt;sup id="fnref16:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;. Число выводится из частоты визитов, а не из размера диска.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Три операции нельзя смешивать.&lt;/strong&gt; &lt;code&gt;delete&lt;/code&gt; — часть протокола, &lt;code&gt;compaction&lt;/code&gt; — локальная оптимизация, &lt;code&gt;purge&lt;/code&gt;/&lt;code&gt;gc&lt;/code&gt; — необратимое решение с побочным эффектом на консистентность&lt;sup id="fnref16:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;В CouchDB purge не уезжает.&lt;/strong&gt; Он не реплицируется внешне&lt;sup id="fnref17:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;, поэтому очищать нужно каждую базу отдельно, а расхождение с клиентом обнаруживать самостоятельно через &lt;code&gt;_purged_infos&lt;/code&gt;&lt;sup id="fnref18:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Полный resync не удаляет лишнее.&lt;/strong&gt; Репликация копирует отсутствующие ревизии и не передаёт отсутствие&lt;sup id="fnref19:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;; пересборка помогает только от чистого источника&lt;sup id="fnref2:16"&gt;&lt;a href="#fn:16" class="footnote-ref" role="doc-noteref"&gt;16&lt;/a&gt;&lt;/sup&gt;, а восстановление из старой копии возвращает удалённое.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Наблюдаемость очистки обязательна.&lt;/strong&gt; Checkpoint purge-деревьев в CouchDB&lt;sup id="fnref4:13"&gt;&lt;a href="#fn:13" class="footnote-ref" role="doc-noteref"&gt;13&lt;/a&gt;&lt;/sup&gt;, &lt;code&gt;check_data_resurrection&lt;/code&gt; в Cassandra&lt;sup id="fnref1:19"&gt;&lt;a href="#fn:19" class="footnote-ref" role="doc-noteref"&gt;19&lt;/a&gt;&lt;/sup&gt;, лаг консьюмера против &lt;code&gt;delete.retention.ms&lt;/code&gt; в Kafka&lt;sup id="fnref5:12"&gt;&lt;a href="#fn:12" class="footnote-ref" role="doc-noteref"&gt;12&lt;/a&gt;&lt;/sup&gt; — три разных способа узнать, что удаление дошло, до того, как это выяснится на данных.&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;p&gt;Что осталось за границами обзора и стоит отдельной работы: измерение реального объёма метаданных удаления на нагрузке, близкой к продуктовой, и проверка сценария возврата очищенного документа клиентом — то есть ответ на вопрос, насколько легко в CouchDB воспроизвести воскрешение на практике.&lt;/p&gt;&#10;&lt;h2 id="quality-metrics"&gt;&lt;a href="#quality-metrics" class="post_hash"&gt;Quality Metrics&lt;/a&gt;&lt;/h2&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Metric&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Value&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Sources found&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;34&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Sources read&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;21&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Sources cited&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;19&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Academic sources (arXiv)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;2&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Official/documentation&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;16&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Blog/forum&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;1&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Citation coverage&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;73%&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Words&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;4480&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Words (checker, incl. headings and tables)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;4891&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Counter-arguments searched&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Yes&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Research rounds&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;3&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Data cutoff&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;2026-11-14&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Own measurements&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;none&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Versions pinned&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;CouchDB 3.5, Cassandra 5.0, Kafka 4.4.0, Sync Gateway/Yjs current docs 2026-11-14&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Access notes&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;arXiv — abstracts; project docs — full text&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;div class="footnotes" role="doc-endnotes"&gt;&#10;&lt;hr&gt;&#10;&lt;ol&gt;&#10;&lt;li id="fn:1"&gt;&#10;&lt;p&gt;Apache Software Foundation. &amp;ldquo;1.3.20. /{db}/_purge.&amp;rdquo; Apache CouchDB 3.5 Documentation, accessed 2026-11-14. &lt;a href="https://docs.couchdb.org/en/stable/api/database/misc.html"&gt;https://docs.couchdb.org/en/stable/api/database/misc.html&lt;/a&gt;&amp;#160;&lt;a href="#fnref:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref7:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref8:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref9:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref10:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref11:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref12:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref13:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref14:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref15:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref16:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref17:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref18:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref19:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:2"&gt;&#10;&lt;p&gt;Apache Software Foundation. &amp;ldquo;Downloads.&amp;rdquo; Apache Kafka, accessed 2026-11-14. &lt;a href="https://kafka.apache.org/downloads"&gt;https://kafka.apache.org/downloads&lt;/a&gt;&amp;#160;&lt;a href="#fnref:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:3"&gt;&#10;&lt;p&gt;Apache Software Foundation. &amp;ldquo;Tombstones.&amp;rdquo; Apache Cassandra 5.0 documentation, accessed 2026-11-14. &lt;a href="https://cassandra.apache.org/doc/latest/cassandra/managing/operating/compaction/tombstones.html"&gt;https://cassandra.apache.org/doc/latest/cassandra/managing/operating/compaction/tombstones.html&lt;/a&gt;&amp;#160;&lt;a href="#fnref:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref7:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref8:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref9:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref10:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref11:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref12:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:4"&gt;&#10;&lt;p&gt;Apache Software Foundation. &amp;ldquo;Design.&amp;rdquo; Apache Kafka 4.4.0 documentation (section &amp;ldquo;Log Compaction&amp;rdquo;), accessed 2026-11-14. &lt;a href="https://kafka.apache.org/44/design/design/"&gt;https://kafka.apache.org/44/design/design/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref7:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:5"&gt;&#10;&lt;p&gt;Couchbase. &amp;ldquo;Tombstones.&amp;rdquo; Couchbase Sync Gateway documentation, accessed 2026-11-14. &lt;a href="https://docs.couchbase.com/sync-gateway/current/manage/managing-tombstones.html"&gt;https://docs.couchbase.com/sync-gateway/current/manage/managing-tombstones.html&lt;/a&gt;&amp;#160;&lt;a href="#fnref:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref7:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref8:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref9:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref10:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref11:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref12:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref13:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref14:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref15:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref16:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:6"&gt;&#10;&lt;p&gt;Apache Software Foundation. &amp;ldquo;2.3. Replication and conflict model.&amp;rdquo; Apache CouchDB 3.5 Documentation, accessed 2026-11-14. &lt;a href="https://docs.couchdb.org/en/stable/replication/conflicts.html"&gt;https://docs.couchdb.org/en/stable/replication/conflicts.html&lt;/a&gt;&amp;#160;&lt;a href="#fnref:6" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:6" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:7"&gt;&#10;&lt;p&gt;Yjs. &amp;ldquo;Y.Doc.&amp;rdquo; Yjs Docs, accessed 2026-11-14. &lt;a href="https://docs.yjs.dev/api/y.doc"&gt;https://docs.yjs.dev/api/y.doc&lt;/a&gt;&amp;#160;&lt;a href="#fnref:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:8"&gt;&#10;&lt;p&gt;Wang, Fan, et al. &amp;ldquo;Don&amp;rsquo;t Forget Range Delete! Enhancing LSM-based Key-Value Stores with More Compatible Lookups and Deletes.&amp;rdquo; arXiv:2511.06061, 8 November 2025. &lt;a href="https://arxiv.org/abs/2511.06061"&gt;https://arxiv.org/abs/2511.06061&lt;/a&gt;&amp;#160;&lt;a href="#fnref:8" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:8" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:8" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:9"&gt;&#10;&lt;p&gt;Apache Software Foundation. &amp;ldquo;5.1. Compaction.&amp;rdquo; Apache CouchDB 3.5 Documentation, accessed 2026-11-14. &lt;a href="https://docs.couchdb.org/en/stable/maintenance/compaction.html"&gt;https://docs.couchdb.org/en/stable/maintenance/compaction.html&lt;/a&gt;&amp;#160;&lt;a href="#fnref:9" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:10"&gt;&#10;&lt;p&gt;Bieniusa, Annette, et al. &amp;ldquo;An optimized conflict-free replicated set.&amp;rdquo; arXiv:1210.3368, 11 October 2012. &lt;a href="https://arxiv.org/abs/1210.3368"&gt;https://arxiv.org/abs/1210.3368&lt;/a&gt;&amp;#160;&lt;a href="#fnref:10" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:10" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:10" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:11"&gt;&#10;&lt;p&gt;Apache Software Foundation. &amp;ldquo;Repair.&amp;rdquo; Apache Cassandra 5.0 documentation, accessed 2026-11-14. &lt;a href="https://cassandra.apache.org/doc/latest/cassandra/managing/operating/repair.html"&gt;https://cassandra.apache.org/doc/latest/cassandra/managing/operating/repair.html&lt;/a&gt;&amp;#160;&lt;a href="#fnref:11" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:11" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:11" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:11" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:11" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:12"&gt;&#10;&lt;p&gt;Apache Software Foundation. &amp;ldquo;Topic Configs.&amp;rdquo; Apache Kafka 4.4.0 documentation, accessed 2026-11-14. &lt;a href="https://kafka.apache.org/44/configuration/topic-configs/"&gt;https://kafka.apache.org/44/configuration/topic-configs/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:12" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:12" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:12" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:12" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:12" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:12" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:13"&gt;&#10;&lt;p&gt;Apache Software Foundation. &amp;ldquo;4.5. Clustered Purge.&amp;rdquo; Apache CouchDB 3.5 Documentation, accessed 2026-11-14. &lt;a href="https://docs.couchdb.org/en/stable/cluster/purging.html"&gt;https://docs.couchdb.org/en/stable/cluster/purging.html&lt;/a&gt;&amp;#160;&lt;a href="#fnref:13" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:13" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:13" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:13" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:13" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:14"&gt;&#10;&lt;p&gt;Apache Software Foundation. &amp;ldquo;1.3.12. /{db}/_changes.&amp;rdquo; Apache CouchDB 3.5 Documentation, accessed 2026-11-14. &lt;a href="https://docs.couchdb.org/en/stable/api/database/changes.html"&gt;https://docs.couchdb.org/en/stable/api/database/changes.html&lt;/a&gt;&amp;#160;&lt;a href="#fnref:14" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:14" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:14" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:15"&gt;&#10;&lt;p&gt;PouchDB. &amp;ldquo;Conflicts.&amp;rdquo; PouchDB Guides, accessed 2026-11-14. &lt;a href="https://pouchdb.com/guides/conflicts.html"&gt;https://pouchdb.com/guides/conflicts.html&lt;/a&gt;&amp;#160;&lt;a href="#fnref:15" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:16"&gt;&#10;&lt;p&gt;PouchDB. &amp;ldquo;Replication.&amp;rdquo; PouchDB Guides, accessed 2026-11-14. &lt;a href="https://pouchdb.com/guides/replication.html"&gt;https://pouchdb.com/guides/replication.html&lt;/a&gt;&amp;#160;&lt;a href="#fnref:16" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:16" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:16" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:17"&gt;&#10;&lt;p&gt;Couchbase. &amp;ldquo;Auto-Purge on Channel Access Revocation.&amp;rdquo; Couchbase Sync Gateway documentation, accessed 2026-11-14. &lt;a href="https://docs.couchbase.com/sync-gateway/current/access-control/auto-purge-channel-access-revocation.html"&gt;https://docs.couchbase.com/sync-gateway/current/access-control/auto-purge-channel-access-revocation.html&lt;/a&gt;&amp;#160;&lt;a href="#fnref:17" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:17" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:17" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:18"&gt;&#10;&lt;p&gt;apache/couchdb. &amp;ldquo;&lt;code&gt;_purge&lt;/code&gt; API for only old revisions. Discussion #2959.&amp;rdquo; GitHub, June 2020. &lt;a href="https://github.com/apache/couchdb/discussions/2959"&gt;https://github.com/apache/couchdb/discussions/2959&lt;/a&gt;&amp;#160;&lt;a href="#fnref:18" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:19"&gt;&#10;&lt;p&gt;Apache Software Foundation. &amp;ldquo;cassandra.yaml file configuration.&amp;rdquo; Apache Cassandra 5.0 documentation, accessed 2026-11-14. &lt;a href="https://cassandra.apache.org/doc/latest/cassandra/managing/configuration/cass_yaml_file.html"&gt;https://cassandra.apache.org/doc/latest/cassandra/managing/configuration/cass_yaml_file.html&lt;/a&gt;&amp;#160;&lt;a href="#fnref:19" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:19" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;/ol&gt;&#10;&lt;/div&gt;&#10;</content></entry><entry><title>PostgreSQL после ошибочного DELETE: PITR, непрерывность WAL и пределы pg_verifybackup</title><id>https://research.evsyukov.org/articles/postgresql-pitr-wal-recovery-drill/</id><link href="https://research.evsyukov.org/articles/postgresql-pitr-wal-recovery-drill/" rel="alternate" type="text/html"/><published>2026-11-13T09:38:00+03:00</published><updated>2026-11-13T09:52:07+03:00</updated><author><name>Denis Evsyukov</name></author><summary type="html">Как восстановить кластер PostgreSQL до состояния перед ошибочной транзакцией: цепочка WAL, выбор цели, два разных RPO и проверка, которая не доказывает корректность данных.</summary><content type="html">&lt;h2 id="аннотация"&gt;&lt;a href="#%d0%b0%d0%bd%d0%bd%d0%be%d1%82%d0%b0%d1%86%d0%b8%d1%8f" class="post_hash"&gt;Аннотация&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Point-in-time recovery в PostgreSQL принято описывать как «бэкап плюс архив WAL». Это верно и почти бесполезно: у такой формулировки нет ни одного проверяемого обязательства. Восстановление до состояния перед ошибочным &lt;code&gt;DELETE&lt;/code&gt; держится на трёх независимых гарантиях — непрерывности архива от начала base backup до выбранной точки, корректности самой точки (какая транзакция в неё попадает, а какая нет) и того, что восстановленный кластер действительно содержит правильные данные. Каждая из трёх ломается по-своему, и каждая проверяется отдельным инструментом.&lt;/p&gt;&#10;&lt;p&gt;Обзор собран по первичным источникам: руководство PostgreSQL 18 (непрерывное архивирование, &lt;code&gt;pg_basebackup&lt;/code&gt;, &lt;code&gt;pg_verifybackup&lt;/code&gt;, &lt;code&gt;pg_combinebackup&lt;/code&gt;, &lt;code&gt;pg_waldump&lt;/code&gt;, конфигурация WAL и recovery target, статистика архиватора), release notes 18.7 от 12 ноября 2026 года, документация pgBackRest, определение RTO/RPO из NIST SP 800-34 Rev.1 и статья USENIX ATC 2020 о поведении приложений при отказах &lt;code&gt;fsync&lt;/code&gt;. Данные на &lt;strong&gt;2026-11-13&lt;/strong&gt;; закреплённая версия — &lt;strong&gt;PostgreSQL 18.7&lt;/strong&gt; (вышла 2026-11-12), ветка 19 на эту дату находится в состоянии release candidate&lt;sup id="fnref:1"&gt;&lt;a href="#fn:1" class="footnote-ref" role="doc-noteref"&gt;1&lt;/a&gt;&lt;/sup&gt;. Собственных restore-испытаний в обзоре нет: все числа и оценки времени — либо из документации, либо явно помечены как арифметика на заданных допущениях.&lt;/p&gt;&#10;&lt;p&gt;Главный вывод: PITR — это не свойство бэкапа, а контракт с тремя доказательствами, и срок восстановления определяется не размером базы, а объёмом WAL, который придётся проиграть. Проверка manifest, проверка страниц и проверка логических инвариантов не выводятся одна из другой: бэкап, прошедший &lt;code&gt;pg_verifybackup&lt;/code&gt;, в 18.7 всё равно может быть непригоден.&lt;/p&gt;&#10;&lt;h2 id="введение"&gt;&lt;a href="#%d0%b2%d0%b2%d0%b5%d0%b4%d0%b5%d0%bd%d0%b8%d0%b5" class="post_hash"&gt;Введение&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;&lt;strong&gt;Актуальность.&lt;/strong&gt; Предыдущий обзор бэкапов закончился на уровне файлов: restic, Borg и Kopia умеют доказать, что сохранённые байты читаются. Для приложения этого недостаточно — восстановленные файлы базы ещё не задают точку, до которой данные логически корректны. 12 ноября 2026 года вышел PostgreSQL 18.7, в release notes которого проект прямо предупредил, что существующим инкрементальным бэкапам доверять нельзя и после обновления нужно снять новый полный&lt;sup id="fnref:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;. Это редкий случай, когда официальный документ сам ограничивает гарантию инструмента, который до этого считался проверенным.&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;Цель&lt;/strong&gt; — разобрать один сценарий: корректно закоммиченная транзакция удалила или испортила данные, и кластер нужно вернуть к состоянию перед ней. Требуется не «сделать PITR», а вывести из механики PostgreSQL два измеримых числа — допустимую потерю данных (RPO) и время восстановления (RTO) — и отделить проверку файлов от проверки данных.&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;Границы.&lt;/strong&gt; Рассматривается один кластер, физический бэкап и WAL-архив: &lt;code&gt;pg_basebackup&lt;/code&gt;, инкрементальные бэкапы 17+, &lt;code&gt;pg_combinebackup&lt;/code&gt;, archive recovery. PostgreSQL предлагает три принципиально разных подхода к бэкапу — логический дамп, копия файловой системы и непрерывное архивирование, — и здесь выбран третий, потому что только он задаёт точку во времени&lt;sup id="fnref:3"&gt;&lt;a href="#fn:3" class="footnote-ref" role="doc-noteref"&gt;3&lt;/a&gt;&lt;/sup&gt;. Не рассматриваются логическая репликация, стратегии &lt;code&gt;pg_dump&lt;/code&gt;, оркестрация failover и облачные managed-сервисы: у них другие точки отказа. Численных замеров скорости replay здесь нет — они зависят от оборудования и нагрузки и без испытания на конкретном стенде были бы выдумкой.&lt;/p&gt;&#10;&lt;h2 id="1-что-pitr-обещает-и-чего-не-обещает"&gt;&lt;a href="#1-%d1%87%d1%82%d0%be-pitr-%d0%be%d0%b1%d0%b5%d1%89%d0%b0%d0%b5%d1%82-%d0%b8-%d1%87%d0%b5%d0%b3%d0%be-%d0%bd%d0%b5-%d0%be%d0%b1%d0%b5%d1%89%d0%b0%d0%b5%d1%82" class="post_hash"&gt;1. Что PITR обещает и чего не обещает&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;WAL пишется всегда и содержит все изменения страниц данных; при восстановлении сервер читает &lt;code&gt;pg_control&lt;/code&gt;, находит последний checkpoint и проигрывает записи вперёд от него&lt;sup id="fnref:4"&gt;&lt;a href="#fn:4" class="footnote-ref" role="doc-noteref"&gt;4&lt;/a&gt;&lt;/sup&gt;. Из этого следует главное свойство: файловая копия не обязана быть внутренне согласованной, потому что несогласованность исправит replay&lt;sup id="fnref:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;. Именно поэтому непрерывное архивирование позволяет остановить проигрывание в произвольной точке после начала base backup и получить согласованный снимок базы на тот момент&lt;sup id="fnref1:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;У этого обещания есть три жёсткие границы, которые чаще всего игнорируют. Во-первых, &lt;code&gt;pg_dump&lt;/code&gt; и &lt;code&gt;pg_dumpall&lt;/code&gt; не годятся как начало такой цепочки: они логические и не содержат информации, нужной для WAL replay&lt;sup id="fnref2:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;. Во-вторых, восстановление всегда охватывает весь кластер, а не отдельную таблицу или базу&lt;sup id="fnref3:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;. В-третьих, проигрывание идёт только вперёд: вернуться к состоянию, которого не было в WAL после начала бэкапа, нельзя&lt;sup id="fnref4:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;Отсюда практическое следствие, которое меняет всю постановку задачи. Восстановление до &lt;code&gt;DELETE&lt;/code&gt; — это не откат одной операции, а создание ветки истории: всё, что закоммичено после выбранной точки, будет потеряно, даже если эти транзакции были совершенно корректны&lt;sup id="fnref5:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;. Если ошибка произошла в 10:00, а важный импорт завершился в 10:05, восстановление на 09:59 стоит пяти минут работы, которую придётся повторять или принимать потерю. Поэтому цель выбирают минимально достаточную, а не «на час назад для надёжности».&lt;/p&gt;&#10;&lt;p&gt;Каждое завершённое восстановление создаёт новую временную линию (timeline), а её номер входит в имена сегментов WAL; файлы истории линий архивируются вместе с сегментами и позволяют позже вернуться в любую из оставленных веток&lt;sup id="fnref6:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;. Это же означает, что повторная попытка с другой целью — не «продолжение» предыдущей, а новая ветка и новый полный replay.&lt;/p&gt;&#10;&lt;h2 id="2-два-разных-rpo-которые-путают"&gt;&lt;a href="#2-%d0%b4%d0%b2%d0%b0-%d1%80%d0%b0%d0%b7%d0%bd%d1%8b%d1%85-rpo-%d0%ba%d0%be%d1%82%d0%be%d1%80%d1%8b%d0%b5-%d0%bf%d1%83%d1%82%d0%b0%d1%8e%d1%82" class="post_hash"&gt;2. Два разных RPO, которые путают&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;NIST определяет RTO как максимальное время, которое компонент системы может оставаться недоступным до неприемлемого воздействия, а RPO — как точку во времени до сбоя, к которой данные могут быть восстановлены по последней копии; RPO не входит в максимально допустимый простой и отражает tolerable потерю данных&lt;sup id="fnref:6"&gt;&lt;a href="#fn:6" class="footnote-ref" role="doc-noteref"&gt;6&lt;/a&gt;&lt;/sup&gt;. В формулировке про PostgreSQL это определение приходится применять дважды, потому что «потеря данных» при отказе диска и при логической ошибке имеет разную природу.&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;Отказ диска или хоста.&lt;/strong&gt; Локальный &lt;code&gt;pg_wal&lt;/code&gt; переживает падение процесса и, как правило, ОС: при старте сервер восстанавливается по журналу, и закоммиченные транзакции не теряются. Потеря возникает только вместе с диском или машиной, и её граница — последний сегмент, доехавший до архива. Сегменты архивируются по завершении, а &lt;code&gt;archive_timeout&lt;/code&gt; заставляет сервер переключиться на новый сегмент, если с прошлого переключения прошло заданное время и была активность; файлы, закрытые досрочно, всё равно занимают полный размер сегмента&lt;sup id="fnref:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;. При сегменте 16 МБ и таймауте в минуту верхняя граница потери при потере хоста — порядка минуты плюс время доставки сегмента в архив плюс задержка удалённого хранилища. Уменьшать таймаут ниже минуты невыгодно: архив раздувается сегментами, заполненными частично&lt;sup id="fnref1:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;Логическая ошибка.&lt;/strong&gt; Здесь RPO не зависит от задержки архивации: WAL с ошибочной транзакцией уже может быть в архиве, и это не мешает выбрать цель раньше неё. RPO превращается в точность выбора цели и в глубину хранения: насколько точно вы знаете момент (или транзакцию) и насколько старый base backup с непрерывным WAL вы ещё держите&lt;sup id="fnref7:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;. Ошибка в выборе цели на минуту — это минута потерянных корректных транзакций; отсутствие бэкапа недельной давности с полным WAL — это невозможность вернуться дальше недели.&lt;/p&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Что определяет&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Отказ хоста&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Логическая ошибка&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Граница потери&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Последний архивный сегмент&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Выбранная цель восстановления&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Управляемый параметр&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;archive_timeout&lt;/code&gt;, доставка архива, retention&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Точность цели, глубина архива и бэкапов&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Что измерять в drill&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Возраст незаархивированного сегмента&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Фактическая последняя применённая транзакция&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;Разделение важно ещё и потому, что защитные меры не пересекаются. Частый &lt;code&gt;archive_timeout&lt;/code&gt; не помогает выбрать правильную точку, а аккуратный named restore point не спасает от потери последних минут при отказе диска&lt;sup id="fnref2:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref8:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;h2 id="3-непрерывность-архива-где-цепочка-рвётся"&gt;&lt;a href="#3-%d0%bd%d0%b5%d0%bf%d1%80%d0%b5%d1%80%d1%8b%d0%b2%d0%bd%d0%be%d1%81%d1%82%d1%8c-%d0%b0%d1%80%d1%85%d0%b8%d0%b2%d0%b0-%d0%b3%d0%b4%d0%b5-%d1%86%d0%b5%d0%bf%d0%be%d1%87%d0%ba%d0%b0-%d1%80%d0%b2%d1%91%d1%82%d1%81%d1%8f" class="post_hash"&gt;3. Непрерывность архива: где цепочка рвётся&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;&lt;code&gt;archive_command&lt;/code&gt; вызывается для завершённого сегмента и должен возвращать ноль тогда и только тогда, когда копирование действительно удалось; при ненулевом статусе сервер повторяет попытку, а &lt;code&gt;pg_wal&lt;/code&gt; продолжает расти&lt;sup id="fnref9:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;. Команда обязана отказываться перезаписывать существующий файл: это защита от администратора, отправившего два разных сервера в один каталог. При этом PostgreSQL иногда переархивирует сегмент — например, если упал до записи факта успеха, — и тогда при совпадении содержимого команда должна вернуть успех, а при расхождении — ошибку&lt;sup id="fnref10:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;Мониторить это сложнее, чем кажется. &lt;code&gt;pg_stat_archiver&lt;/code&gt; даёт &lt;code&gt;archived_count&lt;/code&gt;, &lt;code&gt;last_archived_wal&lt;/code&gt;, &lt;code&gt;last_archived_time&lt;/code&gt;, &lt;code&gt;failed_count&lt;/code&gt;, &lt;code&gt;last_failed_wal&lt;/code&gt; и &lt;code&gt;last_failed_time&lt;/code&gt;, но предупреждает: порядок архивации обычно от старых к новым, однако не гарантирован, особенно после promotion или crash recovery, поэтому нельзя считать, что все файлы старше &lt;code&gt;last_archived_wal&lt;/code&gt; успешно заархивированы&lt;sup id="fnref:8"&gt;&lt;a href="#fn:8" class="footnote-ref" role="doc-noteref"&gt;8&lt;/a&gt;&lt;/sup&gt;. Хуже того, если команда архивации убита сигналом или оболочка вернула код больше 125, процесс архиватора перезапускается, и этот отказ вообще не попадает в &lt;code&gt;pg_stat_archiver&lt;/code&gt;&lt;sup id="fnref11:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;. Метрика &lt;code&gt;failed_count&lt;/code&gt; поэтому показывает не все сбои, а только те, что прошли через штатный путь ошибки.&lt;/p&gt;&#10;&lt;p&gt;Практический вывод: проверять надо не «последний успешный файл», а возраст самого старого незаархивированного сегмента и непрерывность имён. Если &lt;code&gt;pg_wal&lt;/code&gt; содержит сегменты, которых нет в архиве, и их возраст растёт, цепочка рвётся — причём при переполнении файловой системы с &lt;code&gt;pg_wal&lt;/code&gt; сервер уходит в PANIC и остаётся недоступным, пока место не освободят; закоммиченные транзакции при этом не теряются&lt;sup id="fnref12:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;. Это отказ доступности, а не данных, но восстановление из него всё равно требует вмешательства.&lt;/p&gt;&#10;&lt;p&gt;Отдельная ловушка — уборка архива. Файл истории бэкапа (&lt;code&gt;.backup&lt;/code&gt;) содержит метку, время и границы сегментов; всё, что численно меньше, для данного бэкапа уже не нужно, но держать несколько наборов рекомендуется&lt;sup id="fnref13:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;. &lt;code&gt;pg_archivecleanup&lt;/code&gt; умеет удалять всё до указанного сегмента, а при передаче имени &lt;code&gt;.backup&lt;/code&gt; использует только префикс, что позволяет чистить архив «до конкретного base backup» без ручного пересчёта&lt;sup id="fnref:9"&gt;&lt;a href="#fn:9" class="footnote-ref" role="doc-noteref"&gt;9&lt;/a&gt;&lt;/sup&gt;. Ошибка здесь необратима: удалённый WAL нельзя восстановить, и бэкап, для которого он был нужен, превращается в мусор.&lt;/p&gt;&#10;&lt;p&gt;Инкрементальные бэкапы добавляют к этому ещё один слой состояния. Они требуют включённого &lt;code&gt;summarize_wal&lt;/code&gt;; сводки WAL лежат в &lt;code&gt;pg_wal/summaries&lt;/code&gt; и должны покрывать весь диапазон LSN от предыдущего бэкапа до текущего, иначе бэкап просто не снимут&lt;sup id="fnref14:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;. Срок хранения сводок задаётся &lt;code&gt;wal_summary_keep_time&lt;/code&gt; (по умолчанию 10 дней), и он должен быть заметно больше интервала между бэкапами&lt;sup id="fnref3:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;. Связи между полным и инкрементальными бэкапами PostgreSQL не отслеживает: «You must keep track of the relationships between your full and incremental backups on your own»&lt;sup id="fnref15:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;. Это не удобство, а обязанность администратора, и она плохо ложится на ручные скрипты.&lt;/p&gt;&#10;&lt;h2 id="4-точка-до-которой-восстанавливаемся"&gt;&lt;a href="#4-%d1%82%d0%be%d1%87%d0%ba%d0%b0-%d0%b4%d0%be-%d0%ba%d0%be%d1%82%d0%be%d1%80%d0%be%d0%b9-%d0%b2%d0%be%d1%81%d1%81%d1%82%d0%b0%d0%bd%d0%b0%d0%b2%d0%bb%d0%b8%d0%b2%d0%b0%d0%b5%d0%bc%d1%81%d1%8f" class="post_hash"&gt;4. Точка, до которой восстанавливаемся&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;У recovery target пять форм: &lt;code&gt;recovery_target_time&lt;/code&gt;, &lt;code&gt;recovery_target_xid&lt;/code&gt;, &lt;code&gt;recovery_target_name&lt;/code&gt;, &lt;code&gt;recovery_target_lsn&lt;/code&gt; и &lt;code&gt;immediate&lt;/code&gt;; &lt;code&gt;recovery_target_inclusive&lt;/code&gt; решает, включается ли транзакция ровно на границе, а &lt;code&gt;recovery_target_action&lt;/code&gt; определяет, что делать по достижении — по умолчанию &lt;code&gt;pause&lt;/code&gt;, альтернативы — &lt;code&gt;promote&lt;/code&gt; и &lt;code&gt;shutdown&lt;/code&gt;&lt;sup id="fnref4:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;. Именно &lt;code&gt;pause&lt;/code&gt; — главный предохранитель: сервер останавливает replay, к нему можно подключиться только на чтение и проверить, та ли это точка, а затем либо продолжить через &lt;code&gt;pg_wal_replay_resume()&lt;/code&gt;, либо перезапустить с другой целью&lt;sup id="fnref5:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;Форма &lt;code&gt;time&lt;/code&gt; кажется самой удобной и одновременно самой коварной. Значение задаётся в формате &lt;code&gt;timestamp with time zone&lt;/code&gt;, причём сокращения часовых поясов использовать нельзя, если они не заданы заранее; предпочтителен числовой offset или полное имя зоны&lt;sup id="fnref6:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;. Точка останова определяется временем коммита транзакций, а не временем выполнения отдельного оператора: длинная транзакция, начавшаяся до ошибки и закоммиченная после цели, не попадёт в восстановление целиком, даже если её полезная часть относилась к более раннему моменту. Обратная ситуация тоже возможна: часы сервера, ушедшие вперёд из-за NTP, сделают «безопасную» цель на самом деле поздней.&lt;/p&gt;&#10;&lt;p&gt;&lt;code&gt;recovery_target_xid&lt;/code&gt; выглядит точнее, но документация сама ограничивает его применимость: идентификаторы выдаются последовательно при старте транзакции, а завершаться транзакции могут в другом числовом порядке, и восстанавливаются те, что закоммичены до указанного (и, при &lt;code&gt;inclusive&lt;/code&gt;, включая его)&lt;sup id="fnref7:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;. Для поиска «той самой» транзакции задним числом нужен её xid: его можно получить из логов, из &lt;code&gt;pg_current_xact_id()&lt;/code&gt; внутри транзакции или исследовать WAL через &lt;code&gt;pg_waldump -x&lt;/code&gt;, который умеет фильтровать записи по transaction ID&lt;sup id="fnref:10"&gt;&lt;a href="#fn:10" class="footnote-ref" role="doc-noteref"&gt;10&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref:11"&gt;&lt;a href="#fn:11" class="footnote-ref" role="doc-noteref"&gt;11&lt;/a&gt;&lt;/sup&gt;. Но &lt;code&gt;pg_waldump&lt;/code&gt; предупреждает, что на работающем сервере может давать неверные результаты, а файлы с суффиксом &lt;code&gt;.partial&lt;/code&gt; не читает вовсе&lt;sup id="fnref1:11"&gt;&lt;a href="#fn:11" class="footnote-ref" role="doc-noteref"&gt;11&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;Самая надёжная форма — именованная точка. &lt;code&gt;pg_create_restore_point(name)&lt;/code&gt; создаёт маркер в WAL и возвращает его LSN; позже &lt;code&gt;recovery_target_name&lt;/code&gt; останавливает восстановление на нём, причём при нескольких точках с одинаковым именем сработает первая&lt;sup id="fnref:12"&gt;&lt;a href="#fn:12" class="footnote-ref" role="doc-noteref"&gt;12&lt;/a&gt;&lt;/sup&gt;. Для плановых рискованных операций — миграции, массовой правки, запуска скрипта, который «точно ничего не удалит» — это дешёвая страховка: одна строка перед операцией превращает будущий спор «когда именно это случилось» в детерминированную цель. Для аварийной ошибки, о которой узнали через час, именованной точки не будет, и останутся время, xid или LSN.&lt;/p&gt;&#10;&lt;p&gt;&lt;code&gt;recovery_target_lsn&lt;/code&gt; полезен в форензике, когда известна точная позиция записи в WAL, но он же и самый хрупкий: LSN привязан к конкретной истории, а после recovery нумерация продолжается уже в новой ветке. Если цель задана, но архив кончается раньше, сервер завершает recovery с фатальной ошибкой — это не «мягкая» деградация, а отказ старта&lt;sup id="fnref8:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;. Именно так выглядит в логе pgBackRest попытка восстановиться из более позднего бэкапа: &lt;code&gt;FATAL: recovery ended before configured recovery target was reached&lt;/code&gt;&lt;sup id="fnref:13"&gt;&lt;a href="#fn:13" class="footnote-ref" role="doc-noteref"&gt;13&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;pgBackRest в своём руководстве советует брать время для цели из самого PostgreSQL (&lt;code&gt;select current_timestamp&lt;/code&gt;), а не из часов администратора, и указывать offset, чтобы избежать неожиданной конверсии зоны; он же напоминает, что «PostgreSQL can only play forward, not backward», и поэтому бэкап, снятый уже после ошибки, для её отмены бесполезен&lt;sup id="fnref1:13"&gt;&lt;a href="#fn:13" class="footnote-ref" role="doc-noteref"&gt;13&lt;/a&gt;&lt;/sup&gt;. Там же показан полезный диагностический признак: в логе восстановления есть строки вида &lt;code&gt;recovery stopping before commit of transaction …, time …&lt;/code&gt; и &lt;code&gt;last completed transaction was at log time …&lt;/code&gt;&lt;sup id="fnref2:13"&gt;&lt;a href="#fn:13" class="footnote-ref" role="doc-noteref"&gt;13&lt;/a&gt;&lt;/sup&gt;. Вторая строка и есть фактический RPO конкретного восстановления — не расчётный, а доказанный.&lt;/p&gt;&#10;&lt;h2 id="5-почему-успешная-проверка-бэкапа--не-доказательство"&gt;&lt;a href="#5-%d0%bf%d0%be%d1%87%d0%b5%d0%bc%d1%83-%d1%83%d1%81%d0%bf%d0%b5%d1%88%d0%bd%d0%b0%d1%8f-%d0%bf%d1%80%d0%be%d0%b2%d0%b5%d1%80%d0%ba%d0%b0-%d0%b1%d1%8d%d0%ba%d0%b0%d0%bf%d0%b0--%d0%bd%d0%b5-%d0%b4%d0%be%d0%ba%d0%b0%d0%b7%d0%b0%d1%82%d0%b5%d0%bb%d1%8c%d1%81%d1%82%d0%b2%d0%be" class="post_hash"&gt;5. Почему успешная проверка бэкапа — не доказательство&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;&lt;code&gt;pg_verifybackup&lt;/code&gt; проверяет бэкап против &lt;code&gt;backup_manifest&lt;/code&gt; в четыре стадии: читает и валидирует manifest вместе с system identifier, сверяет наличие и размеры файлов, считает контрольные суммы, затем по manifest вызывает &lt;code&gt;pg_waldump&lt;/code&gt;, чтобы убедиться, что нужные для восстановления записи WAL присутствуют и парсятся&lt;sup id="fnref:14"&gt;&lt;a href="#fn:14" class="footnote-ref" role="doc-noteref"&gt;14&lt;/a&gt;&lt;/sup&gt;. Звучит как полная проверка, но документация сразу ограничивает: «the validation which is performed by pg_verifybackup does not and cannot include every check which will be performed by a running server», и ниже — «you should still perform test restores and verify that the resulting databases work as expected and that they appear to contain the correct data»&lt;sup id="fnref1:14"&gt;&lt;a href="#fn:14" class="footnote-ref" role="doc-noteref"&gt;14&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;Границы перечислены честно. Стадия сверки файлов игнорирует &lt;code&gt;postgresql.auto.conf&lt;/code&gt;, &lt;code&gt;standby.signal&lt;/code&gt; и &lt;code&gt;recovery.signal&lt;/code&gt;, а также всё содержимое &lt;code&gt;pg_wal&lt;/code&gt;; лишние WAL-файлы, не нужные для восстановления, не проверяются&lt;sup id="fnref2:14"&gt;&lt;a href="#fn:14" class="footnote-ref" role="doc-noteref"&gt;14&lt;/a&gt;&lt;/sup&gt;. Проверка WAL зависит от версии: нужен &lt;code&gt;pg_verifybackup&lt;/code&gt; и &lt;code&gt;pg_waldump&lt;/code&gt; той же версии, что и бэкап; для tar-формата проверка WAL не поддерживается, и документация рекомендует &lt;code&gt;-n&lt;/code&gt;&lt;sup id="fnref3:14"&gt;&lt;a href="#fn:14" class="footnote-ref" role="doc-noteref"&gt;14&lt;/a&gt;&lt;/sup&gt;. И главное: серверный баг, порождающий записи с правильными контрольными суммами, но бессмысленными действиями, этим методом не обнаруживается&lt;sup id="fnref4:14"&gt;&lt;a href="#fn:14" class="footnote-ref" role="doc-noteref"&gt;14&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;&lt;code&gt;pg_combinebackup&lt;/code&gt; добавляет ещё одну степень косвенности: он проверяет только то, что бэкапы образуют допустимую цепочку, а не то, что каждый из них цел, — для этого нужно отдельно вызывать &lt;code&gt;pg_verifybackup&lt;/code&gt;&lt;sup id="fnref:15"&gt;&lt;a href="#fn:15" class="footnote-ref" role="doc-noteref"&gt;15&lt;/a&gt;&lt;/sup&gt;. Он также не пересчитывает page checksums при сборке, поэтому смешение бэкапов, снятых до и после изменения состояния контрольных сумм, может дать каталог с неверными checksums&lt;sup id="fnref1:15"&gt;&lt;a href="#fn:15" class="footnote-ref" role="doc-noteref"&gt;15&lt;/a&gt;&lt;/sup&gt;. Опция &lt;code&gt;--link&lt;/code&gt; ускоряет сборку, но связывает входные и выходной каталоги: запуск сервера на одном из них изменит другой&lt;sup id="fnref2:15"&gt;&lt;a href="#fn:15" class="footnote-ref" role="doc-noteref"&gt;15&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;Инструменты вокруг PostgreSQL добавляют собственные проверки, но и они отвечают на другой вопрос. &lt;code&gt;pgbackrest verify&lt;/code&gt; «determines if the backups and archives in a repository are valid», то есть подтверждает целостность хранения в репозитории, а не логическую пригодность данных для приложения&lt;sup id="fnref:16"&gt;&lt;a href="#fn:16" class="footnote-ref" role="doc-noteref"&gt;16&lt;/a&gt;&lt;/sup&gt;. Разница та же, что между «файл читается» и «в файле правильные строки».&lt;/p&gt;&#10;&lt;p&gt;Release notes 18.7 показывают, что эти ограничения не теоретические. Проект перечислил несколько способов, которыми инкрементальные бэкапы могли стать повреждёнными: устаревшие visibility map после &lt;code&gt;VACUUM&lt;/code&gt;, усекающего таблицу, при выключенных data checksums и &lt;code&gt;wal_log_hints&lt;/code&gt;; принятие инкрементального бэкапа, основанного на истории, ответвившейся после failover, из-за чего в сборку попадали страницы из брошенной ветки; слияние сводок WAL не в порядке LSN, приводившее к устаревшим данным&lt;sup id="fnref1:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;. Формулировка проекта: «existing incremental backup files should not be trusted» и рекомендация снять новый полный бэкап после обновления, чтобы использовать его как основу для последующих инкрементальных&lt;sup id="fnref2:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;Там же исправлены две вещи, которые касаются уже не инкрементов, а доверия к сигналам проверки. Копии служебных файлов, не относящихся к таблицам, в частности &lt;code&gt;postgresql.auto.conf&lt;/code&gt;, могли быть усечены или дополнены нулями при конкурентной атомарной замене&lt;sup id="fnref3:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;. А ошибки контрольных сумм страниц попадали в &lt;code&gt;pg_stat_database&lt;/code&gt; только тогда, когда в одном файле было повреждено больше одной страницы, — то есть счётчик отказов сам занижал результат&lt;sup id="fnref4:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;. Проверочные механизмы тоже могут быть сломаны, и «зелёный» отчёт наследует их ошибки.&lt;/p&gt;&#10;&lt;p&gt;Есть и более фундаментальный слой. Исследование USENIX ATC 2020 показало, что файловые системы по-разному ведут себя при отказе &lt;code&gt;fsync&lt;/code&gt;, а приложения, включая PostgreSQL, LMDB, LevelDB, SQLite и Redis, не обрабатывают такие отказы достаточно: последствия доходят до потери и повреждения данных&lt;sup id="fnref:17"&gt;&lt;a href="#fn:17" class="footnote-ref" role="doc-noteref"&gt;17&lt;/a&gt;&lt;/sup&gt;. PostgreSQL в описанном инциденте повторял неудачный &lt;code&gt;fsync&lt;/code&gt;, но страницы уже были помечены чистыми, поэтому повторный вызов завершался успешно без записи на диск, и WAL усекался; приложение использовало &lt;code&gt;fsync&lt;/code&gt; неправильно двадцать лет, после чего было изменено так, чтобы падать и перезапускаться вместо повторной попытки&lt;sup id="fnref1:17"&gt;&lt;a href="#fn:17" class="footnote-ref" role="doc-noteref"&gt;17&lt;/a&gt;&lt;/sup&gt;. Авторы отдельно заключают, что протоколы восстановления не должны опираться на page cache, который не отражает устойчивое состояние&lt;sup id="fnref2:17"&gt;&lt;a href="#fn:17" class="footnote-ref" role="doc-noteref"&gt;17&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;Для проверки бэкапа это означает простую вещь: чтение файлов при верификации, как и любое чтение, проходит через page cache и ту же файловую систему, а &lt;code&gt;--no-sync&lt;/code&gt; у &lt;code&gt;pg_basebackup&lt;/code&gt; прямо разрешает вернуть управление до того, как данные гарантированно легли на диск, с предупреждением, что падение ОС после этого может оставить бэкап повреждённым&lt;sup id="fnref:18"&gt;&lt;a href="#fn:18" class="footnote-ref" role="doc-noteref"&gt;18&lt;/a&gt;&lt;/sup&gt;. Доказательство корректности поэтому приходится строить слоями: manifest (есть ли файлы и совпадают ли байты), page checksums (целы ли страницы — &lt;code&gt;pg_checksums&lt;/code&gt; сканирует каждый файл, но требует остановленного кластера&lt;sup id="fnref:19"&gt;&lt;a href="#fn:19" class="footnote-ref" role="doc-noteref"&gt;19&lt;/a&gt;&lt;/sup&gt;), логические инварианты (те ли строки, те ли суммы, тот ли бизнес-смысл). Ни один слой не выводится из предыдущего, и &lt;code&gt;pg_verifybackup&lt;/code&gt; закрывает только первый.&lt;/p&gt;&#10;&lt;h2 id="6-rto-из-чего-складывается-и-что-действительно-надо-мерить"&gt;&lt;a href="#6-rto-%d0%b8%d0%b7-%d1%87%d0%b5%d0%b3%d0%be-%d1%81%d0%ba%d0%bb%d0%b0%d0%b4%d1%8b%d0%b2%d0%b0%d0%b5%d1%82%d1%81%d1%8f-%d0%b8-%d1%87%d1%82%d0%be-%d0%b4%d0%b5%d0%b9%d1%81%d1%82%d0%b2%d0%b8%d1%82%d0%b5%d0%bb%d1%8c%d0%bd%d0%be-%d0%bd%d0%b0%d0%b4%d0%be-%d0%bc%d0%b5%d1%80%d0%b8%d1%82%d1%8c" class="post_hash"&gt;6. RTO: из чего складывается и что действительно надо мерить&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Документация даёт прямую зависимость: интервал между base backup выбирают исходя из того, сколько места готовы тратить на архив WAL и сколько времени готовы потратить на восстановление, потому что серверу придётся проиграть все сегменты с момента бэкапа&lt;sup id="fnref16:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;. Это важнее, чем кажется: RTO растёт не с размером базы, а с объёмом WAL, накопленного после начала бэкапа. База на 200 ГБ с интенсивной записью может восстанавливаться дольше, чем база на 2 ТБ с редкими изменениями.&lt;/p&gt;&#10;&lt;p&gt;Разложение RTO на компоненты выглядит так:&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-fallback" data-lang="fallback"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;RTO = T_fetch(бэкап) + T_combine(цепочка инкрементов)&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; + T_replay(объём WAL от начала бэкапа до цели)&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; + T_validate(проверки) + T_extract(если нужна одна таблица)&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;T_fetch&lt;/code&gt; определяется пропускной способностью хранилища и сжатием; &lt;code&gt;pg_basebackup&lt;/code&gt; умеет gzip, lz4 и zstd, а сжатие можно делать на клиенте или на сервере, что меняет нагрузку на CPU и сеть&lt;sup id="fnref1:18"&gt;&lt;a href="#fn:18" class="footnote-ref" role="doc-noteref"&gt;18&lt;/a&gt;&lt;/sup&gt;. &lt;code&gt;T_combine&lt;/code&gt; есть только при инкрементальной цепочке и пропорционален числу звеньев, а не размеру изменений. &lt;code&gt;T_replay&lt;/code&gt; масштабируется объёмом WAL: документация прямо связывает время восстановления с числом сегментов, которые придётся проиграть, и советует учитывать это при выборе интервала между base backup&lt;sup id="fnref17:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;&lt;code&gt;T_validate&lt;/code&gt; часто недооценивают. Если нужна одна таблица, восстановление всего кластера — только половина работы: дальше её надо извлечь и перенести в рабочий кластер, а это снова чтение, дамп и загрузка&lt;sup id="fnref18:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;. Для маленькой базы это минуты, для крупной — часы, и они не входят в «время восстановления», если о них не подумали заранее.&lt;/p&gt;&#10;&lt;p&gt;Скрытые расходы не ограничиваются извлечением таблицы. Каждая неудачная попытка с неверной целью — это новый полный replay и новая timeline, а не быстрый пересчёт&lt;sup id="fnref19:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;. Поэтому &lt;code&gt;recovery_target_action = pause&lt;/code&gt; экономит не только нервы: он позволяет проверить точку до того, как будет создана новая ветка и потрачено всё время проигрывания&lt;sup id="fnref9:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;. Если проверка показала, что цель слишком ранняя, сервер останавливают и перезапускают с более поздней целью; если слишком поздняя — начинают заново, потому что назад replay не идёт.&lt;/p&gt;&#10;&lt;p&gt;Из этого следует правило бюджета: RTO надо не оценивать «на глаз», а измерять в изолированном испытании на реальном объёме WAL. Один прогон даёт три числа — скорость fetch, скорость replay на гигабайт WAL и полное время до готовности к проверке. После этого интервал между полными бэкапами и таймаут архивации выбираются арифметикой, а не надеждой.&lt;/p&gt;&#10;&lt;h2 id="7-учебное-восстановление-без-риска-для-production"&gt;&lt;a href="#7-%d1%83%d1%87%d0%b5%d0%b1%d0%bd%d0%be%d0%b5-%d0%b2%d0%be%d1%81%d1%81%d1%82%d0%b0%d0%bd%d0%be%d0%b2%d0%bb%d0%b5%d0%bd%d0%b8%d0%b5-%d0%b1%d0%b5%d0%b7-%d1%80%d0%b8%d1%81%d0%ba%d0%b0-%d0%b4%d0%bb%d1%8f-production" class="post_hash"&gt;7. Учебное восстановление без риска для production&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Испытание строится так, чтобы рабочий кластер не участвовал в нём вообще: отдельный хост или каталог, те же бинарники major-версии, достаточно места под бэкап и под распакованный каталог, отдельный порт. Версия важна: проверка WAL в &lt;code&gt;pg_verifybackup&lt;/code&gt; привязана к версии, а &lt;code&gt;pg_basebackup&lt;/code&gt; работает с серверами той же или более старой major-версии&lt;sup id="fnref5:14"&gt;&lt;a href="#fn:14" class="footnote-ref" role="doc-noteref"&gt;14&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref2:18"&gt;&lt;a href="#fn:18" class="footnote-ref" role="doc-noteref"&gt;18&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;Шаг 1. Снять и проверить бэкап.&lt;/strong&gt; Полный бэкап в plain-формате, manifest с SHA-256, manifest скопирован отдельно от каталога бэкапа: &lt;code&gt;pg_verifybackup&lt;/code&gt; предупреждает, что CRC-32C не защищает от злонамеренных изменений, а SHA-256 требует, чтобы manifest хранился в защищённом месте&lt;sup id="fnref3:18"&gt;&lt;a href="#fn:18" class="footnote-ref" role="doc-noteref"&gt;18&lt;/a&gt;&lt;/sup&gt;. Проверка — &lt;code&gt;pg_verifybackup -m &amp;lt;путь&amp;gt;&lt;/code&gt;; для tar-формата — с &lt;code&gt;-n&lt;/code&gt;.&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;Шаг 2. Зафиксировать точку отсчёта.&lt;/strong&gt; Записать &lt;code&gt;pg_control_checkpoint()&lt;/code&gt; (timeline, LSN checkpoint) и текущий LSN; это понадобится, чтобы понять, какие сегменты обязаны быть в архиве&lt;sup id="fnref1:10"&gt;&lt;a href="#fn:10" class="footnote-ref" role="doc-noteref"&gt;10&lt;/a&gt;&lt;/sup&gt;. Сразу после бэкапа проверить, что первый нужный сегмент уже в архиве, а не «доедет когда-нибудь».&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;Шаг 3. Смоделировать ошибку на копии.&lt;/strong&gt; В одноразовом клоне выполнить risky-операцию, обернув её в транзакцию с &lt;code&gt;pg_create_restore_point()&lt;/code&gt; до неё или зафиксировав &lt;code&gt;current_timestamp&lt;/code&gt; и xid. Пример на &lt;code&gt;example.org&lt;/code&gt;:&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-sql" data-lang="sql"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;-- до рискованной операции&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;SELECT&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;pg_create_restore_point&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;&amp;#39;before-cleanup-2026-11-13&amp;#39;&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;-- в той же транзакции, что и ошибка&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;BEGIN&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;SELECT&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;pg_current_xact_id&lt;/span&gt;&lt;span class="p"&gt;();&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;DELETE&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="k"&gt;FROM&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;orders&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="k"&gt;WHERE&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;created_at&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s1"&gt;&amp;#39;2026-01-01&amp;#39;&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;COMMIT&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;strong&gt;Шаг 4. Восстановить с паузой.&lt;/strong&gt; Создать &lt;code&gt;recovery.signal&lt;/code&gt;, задать &lt;code&gt;restore_command&lt;/code&gt;, &lt;code&gt;recovery_target_name&lt;/code&gt; (или &lt;code&gt;recovery_target_time&lt;/code&gt; с числовым offset) и &lt;code&gt;recovery_target_action = 'pause'&lt;/code&gt;, запустить на отдельном порту. В логе ожидать строку о том, перед коммитом какой транзакции остановился replay, и строку о последней завершённой транзакции — это фактическая точка, а не заказанная&lt;sup id="fnref3:13"&gt;&lt;a href="#fn:13" class="footnote-ref" role="doc-noteref"&gt;13&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;Шаг 5. Проверить данные, а не файлы.&lt;/strong&gt; Сравнить количество строк, контрольные суммы по ключевым таблицам, присутствие строк, которые ошибочно удалили, и отсутствие записей, которых быть не должно. При остановленном сервере дополнительно прогнать &lt;code&gt;pg_checksums --check&lt;/code&gt;, который сканирует каждый файл кластера, — но помнить, что он проверяет целостность страниц, а не логику&lt;sup id="fnref1:19"&gt;&lt;a href="#fn:19" class="footnote-ref" role="doc-noteref"&gt;19&lt;/a&gt;&lt;/sup&gt;. Удалённая строка оставляет абсолютно валидную страницу.&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;Шаг 6. Зафиксировать результат.&lt;/strong&gt; Продвинуть (&lt;code&gt;pg_wal_replay_resume()&lt;/code&gt; или перезапуск с &lt;code&gt;promote&lt;/code&gt;), записать новую timeline, время до готовности, объём проигранного WAL и фактический RPO из лога&lt;sup id="fnref10:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref4:13"&gt;&lt;a href="#fn:13" class="footnote-ref" role="doc-noteref"&gt;13&lt;/a&gt;&lt;/sup&gt;. Эти числа — единственное доказательство, что RTO и RPO достижимы.&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;Шаг 7. Пересмотреть политику.&lt;/strong&gt; Если RTO превышен, варианты по убыванию эффективности: чаще полные бэкапы (меньше WAL на replay), инкременты вместо полных при большой базе, более быстрое хранилище для &lt;code&gt;pg_wal&lt;/code&gt;, отказ от извлечения таблицы в пользу заранее подготовленного логического дампа. Если превышен RPO при отказе хоста — уменьшить &lt;code&gt;archive_timeout&lt;/code&gt; (с оглядкой на раздувание архива) или перейти на потоковую репликацию, которая доставляет изменения быстрее минуты&lt;sup id="fnref11:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;h2 id="8-дискуссионные-вопросы-и-противоречия"&gt;&lt;a href="#8-%d0%b4%d0%b8%d1%81%d0%ba%d1%83%d1%81%d1%81%d0%b8%d0%be%d0%bd%d0%bd%d1%8b%d0%b5-%d0%b2%d0%be%d0%bf%d1%80%d0%be%d1%81%d1%8b-%d0%b8-%d0%bf%d1%80%d0%be%d1%82%d0%b8%d0%b2%d0%be%d1%80%d0%b5%d1%87%d0%b8%d1%8f" class="post_hash"&gt;8. Дискуссионные вопросы и противоречия&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;&lt;strong&gt;Инкрементальные бэкапы: экономия против доверия.&lt;/strong&gt; Документация рекомендует инкременты для больших баз, значительная часть которых меняется медленно, и прямо говорит, что для маленькой базы проще игнорировать их существование&lt;sup id="fnref20:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;. Release notes 18.7 фактически отменяют эту рекомендацию для уже существующих цепочек: их нельзя считать доверенными, нужен новый полный бэкап&lt;sup id="fnref5:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;. Обе позиции верны одновременно: механизм полезен, но его история содержит ошибки, менявшие данные. Для одного администратора это аргумент в пользу полного бэкапа как основы и инкрементов только при доказанной экономии времени, а не места.&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;«PITR одной таблицы».&lt;/strong&gt; Руководства инструментов показывают восстановление «удалённой таблицы» и создают впечатление точечной операции&lt;sup id="fnref5:13"&gt;&lt;a href="#fn:13" class="footnote-ref" role="doc-noteref"&gt;13&lt;/a&gt;&lt;/sup&gt;. Фактически восстанавливается весь кластер, а таблица извлекается уже после; документация PostgreSQL недвусмысленна: метод поддерживает восстановление только целого кластера, не подмножества&lt;sup id="fnref21:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;. Разница принципиальна для RTO и для требований к свободному месту.&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;Время против xid.&lt;/strong&gt; pgBackRest называет time-based recovery «arguably the most useful» для типовых сценариев с удалением данных&lt;sup id="fnref6:13"&gt;&lt;a href="#fn:13" class="footnote-ref" role="doc-noteref"&gt;13&lt;/a&gt;&lt;/sup&gt;, тогда как документация PostgreSQL предупреждает о нечисловом порядке коммитов для xid&lt;sup id="fnref12:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;. Противоречия тут нет — есть разные инструменты для разных ситуаций, — но выбор «по времени» опасен там, где часы сервера нестабильны, а выбор «по xid» требует знания идентификатора, которого при аварии обычно нет.&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;Проверено — значит корректно.&lt;/strong&gt; Сообщение об успешной проверке подталкивает к выводу, которого документация не делает: та же страница требует тестового восстановления и проверки данных&lt;sup id="fnref6:14"&gt;&lt;a href="#fn:14" class="footnote-ref" role="doc-noteref"&gt;14&lt;/a&gt;&lt;/sup&gt;. История 18.7 с инкрементами показывает, что «прошёл проверку» и «данные правильные» — разные утверждения, и второе доказывается только запуском сервера и запросами.&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;Мониторинг архиватора.&lt;/strong&gt; &lt;code&gt;pg_stat_archiver&lt;/code&gt; выглядит достаточным, но не гарантирует порядок и не фиксирует часть отказов&lt;sup id="fnref1:8"&gt;&lt;a href="#fn:8" class="footnote-ref" role="doc-noteref"&gt;8&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref22:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;. Доверять только &lt;code&gt;last_archived_time&lt;/code&gt; — распространённая ошибка, которая обнаруживается в момент, когда архив уже нужен.&lt;/p&gt;&#10;&lt;h2 id="недостаточность-данных"&gt;&lt;a href="#%d0%bd%d0%b5%d0%b4%d0%be%d1%81%d1%82%d0%b0%d1%82%d0%be%d1%87%d0%bd%d0%be%d1%81%d1%82%d1%8c-%d0%b4%d0%b0%d0%bd%d0%bd%d1%8b%d1%85" class="post_hash"&gt;Недостаточность данных&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Скорость replay и фактическое время восстановления в этом обзоре не измерялись: числа сильно зависят от оборудования, &lt;code&gt;full_page_writes&lt;/code&gt;, частоты checkpoint и характера нагрузки, и переносить чужой бенчмарк на свой стенд было бы неверно. Release notes 18.7 перечисляют последствия ошибок инкрементальных бэкапов, но не описывают полный набор условий воспроизведения; насколько широко затронуты конкретные установки, по документу не определить. Ветка 19 на 2026-11-13 находится в состоянии release candidate, поэтому все утверждения о поведении привязаны к 18.7; в 19 возможны изменения в области инкрементальных бэкапов и WAL-саммаризации, которые здесь не проверялись.&lt;/p&gt;&#10;&lt;h2 id="заключение"&gt;&lt;a href="#%d0%b7%d0%b0%d0%ba%d0%bb%d1%8e%d1%87%d0%b5%d0%bd%d0%b8%d0%b5" class="post_hash"&gt;Заключение&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Восстановление после ошибочного &lt;code&gt;DELETE&lt;/code&gt; — это не одна операция, а три доказательства, каждое из которых может быть ложным. Непрерывность архива доказывается возрастом старейшего незаархивированного сегмента и отсутствием разрывов, а не полем &lt;code&gt;last_archived_time&lt;/code&gt;. Корректность цели доказывается строкой в логе о последней завершённой транзакции, а не временем, которое администратор помнит по часам. Корректность данных доказывается запросами к восстановленному кластеру, а не отчётом &lt;code&gt;pg_verifybackup&lt;/code&gt;.&lt;/p&gt;&#10;&lt;p&gt;Практические правила, которые следуют из источников. Держать &lt;code&gt;archive_timeout&lt;/code&gt; в районе минуты, а не секунд, и следить за ростом &lt;code&gt;pg_wal&lt;/code&gt; как за отдельным сигналом отказа&lt;sup id="fnref13:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;&lt;sup id="fnref23:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;. Ставить &lt;code&gt;pg_create_restore_point()&lt;/code&gt; перед любой плановой рискованной операцией — это самая простая форма цели, не зависящая от часов и от порядка коммитов&lt;sup id="fnref1:12"&gt;&lt;a href="#fn:12" class="footnote-ref" role="doc-noteref"&gt;12&lt;/a&gt;&lt;/sup&gt;. Восстанавливаться с &lt;code&gt;recovery_target_action = 'pause'&lt;/code&gt; и проверять данные до продвижения&lt;sup id="fnref14:7"&gt;&lt;a href="#fn:7" class="footnote-ref" role="doc-noteref"&gt;7&lt;/a&gt;&lt;/sup&gt;. Хранить manifest отдельно и предпочитать SHA-256, если важна защита от изменений&lt;sup id="fnref4:18"&gt;&lt;a href="#fn:18" class="footnote-ref" role="doc-noteref"&gt;18&lt;/a&gt;&lt;/sup&gt;. Считать RTO по объёму WAL, а не по размеру базы, и подтверждать его учебным восстановлением на реальном объёме&lt;sup id="fnref24:5"&gt;&lt;a href="#fn:5" class="footnote-ref" role="doc-noteref"&gt;5&lt;/a&gt;&lt;/sup&gt;. И не доверять инкрементальным цепочкам, снятым до 18.7, — проект прямо просит начать заново&lt;sup id="fnref6:2"&gt;&lt;a href="#fn:2" class="footnote-ref" role="doc-noteref"&gt;2&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;&#10;&lt;p&gt;Направление дальнейшей работы — не выбор инструмента, а измерение: один и тот же drill, повторяемый по расписанию, даёт числа, по которым можно честно сравнивать архитектуры бэкапа. Без него PITR остаётся возможностью, а не гарантией.&lt;/p&gt;&#10;&lt;h2 id="quality-metrics"&gt;&lt;a href="#quality-metrics" class="post_hash"&gt;Quality Metrics&lt;/a&gt;&lt;/h2&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Metric&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Value&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Sources found&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;28&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Sources read&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;19&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Sources cited&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;19&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Academic sources&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;1&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Official/documentation&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;18&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Industry reports&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;0&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;News/journalism&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;0&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Blog/forum&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;0&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Citation coverage&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;82%&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Counter-arguments searched&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Yes&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Research rounds&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;2&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Questions emerged&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;7&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Questions resolved&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;6&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Questions insufficient data&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;1&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;div class="footnotes" role="doc-endnotes"&gt;&#10;&lt;hr&gt;&#10;&lt;ol&gt;&#10;&lt;li id="fn:1"&gt;&#10;&lt;p&gt;PostgreSQL Global Development Group. &amp;ldquo;PostgreSQL: Documentation.&amp;rdquo; (index of manuals; 19 listed as release candidate, 18 as current). &lt;a href="https://www.postgresql.org/docs/"&gt;https://www.postgresql.org/docs/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:1" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:2"&gt;&#10;&lt;p&gt;PostgreSQL Global Development Group. &amp;ldquo;PostgreSQL 18.7.&amp;rdquo; PostgreSQL Documentation, Release Notes, 2026-11-12. &lt;a href="https://www.postgresql.org/docs/release/18.7/"&gt;https://www.postgresql.org/docs/release/18.7/&lt;/a&gt;&amp;#160;&lt;a href="#fnref:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:2" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:3"&gt;&#10;&lt;p&gt;PostgreSQL Global Development Group. &amp;ldquo;Chapter 25. Backup and Restore.&amp;rdquo; PostgreSQL 18 Documentation. &lt;a href="https://www.postgresql.org/docs/current/backup.html"&gt;https://www.postgresql.org/docs/current/backup.html&lt;/a&gt;&amp;#160;&lt;a href="#fnref:3" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:4"&gt;&#10;&lt;p&gt;PostgreSQL Global Development Group. &amp;ldquo;28.6. WAL Internals.&amp;rdquo; PostgreSQL 18 Documentation. &lt;a href="https://www.postgresql.org/docs/current/wal-internals.html"&gt;https://www.postgresql.org/docs/current/wal-internals.html&lt;/a&gt;&amp;#160;&lt;a href="#fnref:4" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:5"&gt;&#10;&lt;p&gt;PostgreSQL Global Development Group. &amp;ldquo;25.3. Continuous Archiving and Point-in-Time Recovery (PITR).&amp;rdquo; PostgreSQL 18 Documentation. &lt;a href="https://www.postgresql.org/docs/current/continuous-archiving.html"&gt;https://www.postgresql.org/docs/current/continuous-archiving.html&lt;/a&gt;&amp;#160;&lt;a href="#fnref:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref7:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref8:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref9:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref10:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref11:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref12:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref13:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref14:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref15:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref16:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref17:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref18:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref19:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref20:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref21:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref22:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref23:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref24:5" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:6"&gt;&#10;&lt;p&gt;National Institute of Standards and Technology. &amp;ldquo;Contingency Planning Guide for Federal Information Systems.&amp;rdquo; NIST Special Publication 800-34 Rev. 1, November 2010. &lt;a href="https://nvlpubs.nist.gov/nistpubs/Legacy/SP/nistspecialpublication800-34r1.pdf"&gt;https://nvlpubs.nist.gov/nistpubs/Legacy/SP/nistspecialpublication800-34r1.pdf&lt;/a&gt;&amp;#160;&lt;a href="#fnref:6" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:7"&gt;&#10;&lt;p&gt;PostgreSQL Global Development Group. &amp;ldquo;19.5. Write Ahead Log.&amp;rdquo; PostgreSQL 18 Documentation. &lt;a href="https://www.postgresql.org/docs/current/runtime-config-wal.html"&gt;https://www.postgresql.org/docs/current/runtime-config-wal.html&lt;/a&gt;&amp;#160;&lt;a href="#fnref:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref7:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref8:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref9:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref10:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref11:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref12:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref13:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref14:7" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:8"&gt;&#10;&lt;p&gt;PostgreSQL Global Development Group. &amp;ldquo;27.2. The Cumulative Statistics System.&amp;rdquo; PostgreSQL 18 Documentation. &lt;a href="https://www.postgresql.org/docs/current/monitoring-stats.html"&gt;https://www.postgresql.org/docs/current/monitoring-stats.html&lt;/a&gt;&amp;#160;&lt;a href="#fnref:8" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:8" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:9"&gt;&#10;&lt;p&gt;PostgreSQL Global Development Group. &amp;ldquo;pg_archivecleanup.&amp;rdquo; PostgreSQL 18 Documentation. &lt;a href="https://www.postgresql.org/docs/current/pgarchivecleanup.html"&gt;https://www.postgresql.org/docs/current/pgarchivecleanup.html&lt;/a&gt;&amp;#160;&lt;a href="#fnref:9" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:10"&gt;&#10;&lt;p&gt;PostgreSQL Global Development Group. &amp;ldquo;9.27. System Information Functions and Operators.&amp;rdquo; PostgreSQL 18 Documentation. &lt;a href="https://www.postgresql.org/docs/current/functions-info.html"&gt;https://www.postgresql.org/docs/current/functions-info.html&lt;/a&gt;&amp;#160;&lt;a href="#fnref:10" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:10" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:11"&gt;&#10;&lt;p&gt;PostgreSQL Global Development Group. &amp;ldquo;pg_waldump.&amp;rdquo; PostgreSQL 18 Documentation. &lt;a href="https://www.postgresql.org/docs/current/pgwaldump.html"&gt;https://www.postgresql.org/docs/current/pgwaldump.html&lt;/a&gt;&amp;#160;&lt;a href="#fnref:11" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:11" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:12"&gt;&#10;&lt;p&gt;PostgreSQL Global Development Group. &amp;ldquo;9.28. System Administration Functions.&amp;rdquo; PostgreSQL 18 Documentation. &lt;a href="https://www.postgresql.org/docs/current/functions-admin.html"&gt;https://www.postgresql.org/docs/current/functions-admin.html&lt;/a&gt;&amp;#160;&lt;a href="#fnref:12" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:12" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:13"&gt;&#10;&lt;p&gt;Crunchy Data. &amp;ldquo;pgBackRest - Debian &amp;amp; Ubuntu User Guide.&amp;rdquo; pgBackRest Documentation. &lt;a href="https://pgbackrest.org/user-guide.html"&gt;https://pgbackrest.org/user-guide.html&lt;/a&gt;&amp;#160;&lt;a href="#fnref:13" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:13" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:13" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:13" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:13" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:13" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:13" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:14"&gt;&#10;&lt;p&gt;PostgreSQL Global Development Group. &amp;ldquo;pg_verifybackup.&amp;rdquo; PostgreSQL 18 Documentation. &lt;a href="https://www.postgresql.org/docs/current/app-pgverifybackup.html"&gt;https://www.postgresql.org/docs/current/app-pgverifybackup.html&lt;/a&gt;&amp;#160;&lt;a href="#fnref:14" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:14" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:14" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:14" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:14" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref5:14" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref6:14" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:15"&gt;&#10;&lt;p&gt;PostgreSQL Global Development Group. &amp;ldquo;pg_combinebackup.&amp;rdquo; PostgreSQL 18 Documentation. &lt;a href="https://www.postgresql.org/docs/current/app-pgcombinebackup.html"&gt;https://www.postgresql.org/docs/current/app-pgcombinebackup.html&lt;/a&gt;&amp;#160;&lt;a href="#fnref:15" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:15" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:15" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:16"&gt;&#10;&lt;p&gt;Crunchy Data. &amp;ldquo;pgBackRest - Command Reference.&amp;rdquo; pgBackRest Documentation. &lt;a href="https://pgbackrest.org/command.html"&gt;https://pgbackrest.org/command.html&lt;/a&gt;&amp;#160;&lt;a href="#fnref:16" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:17"&gt;&#10;&lt;p&gt;Rebello, Anthony; Patel, Yuvraj; Alagappan, Ramnatthan; Arpaci-Dusseau, Andrea C.; Arpaci-Dusseau, Remzi H. &amp;ldquo;Can Applications Recover from fsync Failures?&amp;rdquo; USENIX Annual Technical Conference (ATC &amp;lsquo;20), 2020. &lt;a href="https://www.usenix.org/system/files/atc20-rebello.pdf"&gt;https://www.usenix.org/system/files/atc20-rebello.pdf&lt;/a&gt;&amp;#160;&lt;a href="#fnref:17" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:17" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:17" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:18"&gt;&#10;&lt;p&gt;PostgreSQL Global Development Group. &amp;ldquo;pg_basebackup.&amp;rdquo; PostgreSQL 18 Documentation. &lt;a href="https://www.postgresql.org/docs/current/app-pgbasebackup.html"&gt;https://www.postgresql.org/docs/current/app-pgbasebackup.html&lt;/a&gt;&amp;#160;&lt;a href="#fnref:18" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:18" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref2:18" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref3:18" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref4:18" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li id="fn:19"&gt;&#10;&lt;p&gt;PostgreSQL Global Development Group. &amp;ldquo;pg_checksums.&amp;rdquo; PostgreSQL 18 Documentation. &lt;a href="https://www.postgresql.org/docs/current/app-pgchecksums.html"&gt;https://www.postgresql.org/docs/current/app-pgchecksums.html&lt;/a&gt;&amp;#160;&lt;a href="#fnref:19" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&amp;#160;&lt;a href="#fnref1:19" class="footnote-backref" role="doc-backlink"&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;/ol&gt;&#10;&lt;/div&gt;&#10;</content></entry></feed>