Глоссарий

23 терминов, которые встречаются в уроках. Коротко — что это, и чуть подробнее — зачем.

Кабинет (act_id)рекламный аккаунт: Рекламный кабинет Meta в формате act_<цифры>. Принадлежит BM, заводится на S11. Тем же act_<id> называется место под его read-токен и таймер сбора.
Креды провайдера (SOCKS)Login · Pass · IP · Port: Четвёрка доступа к купленному прокси, вводится на форме «Данные прокси: Login, Pass, IP, Port» (S07 / S08 / Accounts). Хранится в /etc/adsight/.env.bridge.<alias>, наружу показывается только fingerprint.
Место под токенdeclared → uploaded: Запись в карточке «Токены и прокси»: declared — место заведено, но пустое; uploaded — токен принят, рядом fingerprint. Сам секрет обратно не читается. Форма токен не принимает — только заводит место.
Панель менеджера:8793 · те же Master и Accounts: Урезанная админка с отдельным паролем: Master · HITL · Secrets · Accounts. Те же квизы и подписи, что у владельца на :8790. Нет Health, Flags и Contours.
Проксиadsight-proxy@<короткое имя>: Купленный SOCKS, через который кабинет ходит в Graph API с выделенным IP. S03 — короткое имя и IP; S07 — данные Login/Pass/IP/Port и кнопка «Включить прокси». Слушает на 127.0.0.1, порт выдаёт сервер (ряд 18081…).
Рельсстатус шага у кнопки: Индикатор .master-rail рядом с кнопкой сценария: нужно / ждём / готово / ошибка. Пока сеть не ответила, кнопка заблокирована — второй клик не уходит в API.
СетBM + прокси + кабинет: Рабочая связка в админке AdSight: Business Manager в Meta, купленный прокси с выделенным IP, рекламный кабинет и его read-токен. Заводится квизом Master (рецепты «Новый BM и прокси» и «Новый кабинет и сбор»), а не одиночными формами.
Accounts / Contours / Secretsручной пульт: Одиночные формы для отладки и ротации: дерево BM и кабинетов, карточка «Токены и прокси», «Данные прокси: Login, Pass, IP, Port», write-токен BM. У менеджера на :8793 есть Master · HITL · Secrets · Accounts (без Health/Flags/Contours). С нуля сет по одиночным формам не собирают, если квиз Master жив.
Alias проксикороткое имя прокси: Короткое имя купленного прокси вида bm-1, bm-2 (^[a-z0-9][a-z0-9_-]{0,31}$). Им называются юнит adsight-proxy@<alias> и файл Login/Pass. Не путать с кабинетом act_<id>.
Bag вкладки«Продолжить с того же места»: sessionStorage квиза в текущей вкладке браузера. F5 и переход в каталог его не стирают, полное закрытие вкладки — стирает. Это не новый сет: новый BM или кабинет — кнопки «Начать» на рецептах 1 и 2.
BM (Business Manager)верхняя сущность Meta: Бизнес-менеджер Meta, идентифицируется bm_id (3–20 цифр). В реестре у BM есть label и привязка к прокси (egress-alias). Один BM — один прокси (ADR-003). Страну форма не спрашивает.
Canaryпроверочный запрос: Тестовый запрос в Graph через прокси BM, который делает S32 перед включением таймера. Идёт до ~3 минут. Красный canary почти всегда означает ошибку в S15: место под токен не act_<id> или прокси leftover :3129.
egress-aliasсвязь BM ↔ прокси: Поле у BM, равное короткому имени прокси. Единственное место, где хранится связь BM с прокси — отдельной таблицы нет. Записывается на S05; без него helper не примет данные прокси.
Fingerprintотпечаток секрета: Короткий хэш залитого токена или пароля, который админка показывает вместо значения. Единственный способ убедиться, что принято именно то, что вы ввели.
GEOстрана в таблице, не в форме: Двухбуквенный код страны в таблицах и БД. Формы S01/S03/Accounts его не спрашивают (страна кабинета = timezone). Сравнение только если обе стороны уже объявлены; расхождение — отказ привязки.
listen_portлокальный порт прокси: Порт на 127.0.0.1, который слушает включённый прокси (gost). Один BM — один порт. Формы его не спрашивают: сервер выдаёт первый свободный из ряда 18081, 18082… (3129 — leftover, в ряд не входит). На Meta не влияет.
Masterпошаговый квиз админки: Раздел /admin/master с рецептами «1 · Новый BM и прокси» и «2 · Новый кабинет и сбор». Те же экраны у владельца на :8790 и у менеджера на :8793. Пишет реестр теми же API, что Accounts. После первого рецепта каталог предлагает второй.
provider_ip_pinIP купленного прокси: Строгий IPv4 купленного прокси (четыре октета, без ведущих нулей). Не hostname и не «IP, который видит Meta». IP в форме «Данные прокси: Login, Pass, IP, Port» обязан совпадать с этим значением.
Read-токентокен чтения Graph: System User или user token Meta для чтения статистики кабинета. Место под токен = act_<id>, kind = read, канон meta_read.d/<act_id>.env. На S15 вводите только токен; прокси берётся у BM кабинета, ALLOW_LIVE ставится сам.
Readerтаймер сбора кабинета: Systemd-таймер reader@act_<id>, который по расписанию читает статистику кабинета в dump-каталог. Включается кнопкой S32 «Включить сбор», не переменными окружения и не chmod по SSH.
Step-upподтверждение мутации: Повторный ввод пароля входа в админку перед любой записью: реестр, данные прокси, включение прокси и сбора. Не root и не SSH-пароль.
Wrapper shaстоп-экран S07: Сверка wrapper прокси на сервере с git (шаг «Проверка сервера»). Не совпал — квиз останавливается; единственное действие — шаг «wrapper» из PROXY_BRIDGE_INSTALL.md. Не ставить adsight-proxy.service и не трогать :3129.
Write-токентокен money-write: Отдельный токен BM для записи в Meta. В Master его нет — заводится на Accounts после R-A: форма «Завести место под токен (без самого токена)» с именем bm_<bm_id>_write, kind = write, канон meta_write.d. Write ≠ любому read; legacy .env.money отвергается.