Для администратора системы
Коротко
- Раздел «Профиль» → «Администрирование» есть только у администратора системы.
- Здесь: режим регистрации, заявки, добавить и заблокировать пользователя, разрешённые пары.
- Чужих стратегий, сумм и истории администратор в приложении не видит.
Администратор системы — пользователь, который ещё и управляет доступом людей. У него есть раздел «Администрирование»: «Профиль» → «Администрирование». У других пользователей этого раздела нет.
«Профиль» → «Администрирование» открывает меню из двух страниц. «Управление пользователями» — режим регистрации, заявки, а у пользователей — имя, Telegram ID, статус, сколько у человека стратегий и открыт ли его сейф ключей; стратегий, сумм и истории других пользователей там нет. «Настройка торговых пар» — «Что можно торговать»: какие пары разрешены новым стратегиям на каждом рынке. Вернуться из страницы в меню — «← Администрирование».

Режим регистрации
Вверху страницы «Управление пользователями» — переключатель «Регистрация» (со знаком «?»):
- «Только администратор» (так было всегда и так стоит сразу после обновления) — новых людей добавляете вы по Telegram ID. Заявки не принимаются.
- «Открытая с подтверждением» — человек открывает приложение в Telegram (или входит в браузере кнопкой «Войти»), видит «Заявка отправлена», а вам приходит сообщение «🔴 Заявка на регистрацию» с кнопками «✅ Подтвердить» и «❌ Отклонить».
Перед тем как включить «Открытую с подтверждением», приложение спрашивает: «Открыть регистрацию? Любой, кто найдёт бота в Telegram, сможет подать заявку — они будут приходить вам на подтверждение. Подтверждённый пользователь сам добавляет ключи и стратегии.» Если отказаться, переключатель вернётся на «Только администратор». Возврат к «Только администратор» без вопроса: он ничего не открывает.
Пока заявка ждёт решения или отклонена, человеку ничего не открыто: войти он не может.
Если заявок слишком много, переключите на «Только администратор»: новые заявки перестанут приниматься. Те, что уже ждут, остаются в списке — их можно решить.
Заявки
Заявки — в блоке «Заявки» (со знаком «?» о кнопках «Заблокировать · Подтвердить · Отклонить»): имя из Telegram, Telegram ID, когда отправлена, статус «ждёт решения» или «отклонена». Кнопка «Отклонить» — с красной рамкой.
- Нажмите «Подтвердить» (или «Отклонить») у заявки — или кнопку в сообщении Telegram: она откроет этот раздел с нужной заявкой.
- Подтвердите решение.
- После «Подтвердить» человек становится пользователем и получает в Telegram «ℹ️ Доступ открыт». Ответ приложения: «Доступ открыт. Человек получит сообщение в Telegram.».
- После «Отклонить» человек войти не может; заявка остаётся в списке как «отклонена» — позже её можно подтвердить. Повторную заявку он отправить не может, сообщение об отказе ему не приходит.
Если вы добавите человека с заявкой через «Добавить пользователя», заявка считается подтверждённой. Возможная ошибка: «Такой заявки нет — возможно, она уже решена.».
Заблокированный пользователь заявку не отправит: для него ничего не меняется.
Добавить пользователя
- Попросите человека узнать свой Telegram ID у бота @userinfobot.
- Откройте «Профиль» → «Администрирование» → «Управление пользователями».
- В блоке «Добавить пользователя» введите «ID Telegram» (число) и «Имя» для списка.
- Нажмите «Добавить».
- Дождитесь ответа «Добавлен. Теперь он может войти.».
- Сообщите человеку, что он может войти, и дайте ссылку на эту справку.
Дальше человек сам добавляет свои подключения и стратегии. Возможные ошибки: «ID Telegram — это число.», «Такой пользователь уже есть.».
Заблокировать пользователя
- Найдите человека в списке.
- Нажмите «Заблокировать» (кнопка с красной рамкой) и подтвердите.
Что происходит:
- его стратегии останавливаются и снимают свои заявки; активы на бирже не продаются;
- затем его сейф закрывается;
- войти он больше не может, открытые сеансы закрываются сразу;
- ключи остаются в зашифрованном сейфе, история — в базе; ничего не удаляется.
Если в этот момент его сейф закрыт, снять заявки нельзя. Приложение предупредит: «Заблокирован. Его сейф ключей был закрыт — заявки стратегий остались на бирже.».
Пользователей не удаляют, только блокируют. Администратора системы заблокировать нельзя.
Разблокировать пользователя
- Найдите человека в списке (статус «заблокирован»).
- Нажмите «Разблокировать» и подтвердите.
Всё возвращается как было: человек входит, открывает свой сейф и сам запускает стратегии.
Что можно торговать
Страница «Профиль» → «Администрирование» → «Настройка торговых пар». Для каждого рынка — «Binance спот», «Binance фьючерсы USD-M», «Binance фьючерсы COIN-M» (по умолчанию — BTC и USD, то есть BTCUSD_PERP), «BingX спот», «BingX фьючерсы USDT-M», «Bybit спот», «Bybit фьючерсы USDT», «Coinbase спот», «Т Инвестиции» — два списка: «Активы (чем торгуем)» (BTC, ETH; на Т Инвестициях — тикеры SBER, GAZP) и «Валюты прибыли» (USDT, USDC; у Coinbase — EUR, USDC; на Т Инвестициях — RUB). У заголовка раздела — знак «?».
Каждый тикер списка — чип с крестиком «×»: нажмите «×», чтобы убрать тикер. Чтобы добавить, впишите тикер в поле в конце списка («Тикер и Enter») и нажмите Enter, запятую или пробел. Можно вставить сразу несколько через запятую, пробел или «;». Строчные буквы становятся заглавными сами. Затем нажмите «Сохранить» у рынка. Пока изменения не сохранены, под рынком написано «Изменения не сохранены.».
- Пользователи при создании стратегии выбирают пару только из этих списков и только из тех пар, которыми биржа сейчас торгует. Так, при активах BTC, ETH и валютах USDT, USDC на споте предлагаются BTCUSDT, BTCUSDC, ETHUSDT, ETHUSDC — если они есть на Binance.
- Пустой список (активов или валют) — на этом рынке нельзя создать стратегию. Если вы убрали последний тикер, приложение сразу предупреждает: «Пустой список закроет этот рынок для новых стратегий, когда вы сохраните.» После сохранения под рынком написано «Список пуст — на этом рынке нельзя создать стратегию.», а в форме новой стратегии пользователь видит то же объяснение.
- Списки касаются только новых стратегий. Работающие стратегии продолжают торговать своей парой, даже если её убрали из списка.
- Тикер — латинские заглавные буквы и цифры, от 1 до 20 знаков; в списке не больше 200 тикеров. Неверный тикер остаётся в поле, и рядом сказано, что не так: «Неверный тикер: … (латинские буквы и цифры).», «… уже есть в списке.» или «Слишком длинный список (больше 200).». Пока он не исправлен, список не сохраняется. Сервер проверяет списки по тем же правилам.
- При обновлении до 2.0.21 списки заполнены парами ваших стратегий (кроме архива).
Устройство системы
У администратора системы в «Профиле», рядом со «Справкой», есть ещё ссылка «Устройство системы» — техническое описание: как устроен сервис, как он защищён, решения разработчика, установка сервера и регламент. Другие пользователи этой ссылки не видят, а сервер не отдаёт им ни одной страницы описания — даже по прямому адресу.
Нажмите «Устройство системы» — описание откроется в браузере (в Telegram — во встроенном браузере Telegram). Ссылка одноразовая и действует минуту; браузер получает доступ на время вашего входа в приложение. После «Выйти» в приложении описание закрывается; откройте его снова из «Профиля».
Настройки сервера
Настройки службы лежат в файле /etc/vnext2/settings.toml на сервере. Обычно их менять не нужно: значения по умолчанию рассчитаны на повседневную работу, а обновления файл не меняют. Ниже — строки, которые администратор системы может менять; остальное (база, файл ключей, интерфейс, подключения) задаётся при установке сервера, см. техническое описание.
Как изменить настройку:
- В файле, в разделе
[service](или[diagnostics], смотря где настройка), впишите или исправьте строку. Неверное значение или опечатка в названии — служба не запустится и скажет, какая строка неверна. - Выполните
systemctl restart vnext2: настройки читаются только при запуске службы. - Откройте сейф и запустите стратегии, как после перезапуска (Перезапуск и обновление сервера).
Раздел [service] (первое значение — по умолчанию):
| Настройка | Значения | Что делает |
|---|---|---|
step_seconds |
число от 1 до 60 (3) | Как часто стратегия делает шаг, в секундах |
market_prices |
"compare", "stream" |
Откуда стратегии Binance берут цену. compare: цена REST, как раньше, а цена потока только сравнивается с ней (расхождение больше 0,1 % — строка в журнале сервера). stream: свежая цена потока (не старше 5 секунд), иначе REST |
fills_from |
"stream", "rest" |
Откуда стратегии берут исполнения заявок. stream: из потока событий счёта, с периодической сверкой с историей биржи. rest: только из истории биржи, как в 2.1.2 — на случай беды с потоком; запросов к бирже в несколько раз больше. rest выключает факты потоков всех бирж (Binance, BingX, Bybit), каким бы ни было значение их собственных настроек |
trust_exchange_count |
"mainnet", "all", "off" |
Верить ли счётчику использованных запросов, который сообщает сама биржа Binance. mainnet: только на реальном адресе — на тестовой сети счётчик показывает 120–160 % лимита при малой нагрузке и без толку останавливал бы чтения; all: везде; off: нигде, считает только сервер. Ответы биржи «слишком часто» и блокировка адреса учитываются при любом значении |
bingx_fills_from |
"compare", "stream" |
Фьючерсы BingX. compare: сделки учитываются по истории биржи, а сделки из потока только сравниваются с ней — расхождения пишутся в журнал сервера. stream: сделка из потока сразу считается фактом (ТП ставится быстрее), история читается для сверки раз в 5 минут и по поводу. Включать после недели без расхождений. Спот BingX поток не использует |
bingx_market_prices |
"compare", "stream" |
Откуда стратегии BingX (спот и фьючерсы) берут лучшую цену и mark-цену фьючерсов. compare: цена REST, как раньше, а цена из открытого потока рынка BingX только сравнивается с ней и считается в метриках. stream: свежая цена потока (не старше 5 секунд), иначе REST. Переключать после недели в compare по отчёту scripts/stream_report.py |
bybit_futures_fills_from, bybit_spot_fills_from |
"compare", "stream" |
То же для фьючерсов и для спота Bybit, каждый рынок отдельно. Для спота stream включают только после живой проверки комиссии в MNT |
bybit_stream_samples |
число от 0 до 200 (0) | Сколько первых строк каждого вида потока Bybit записать в журнал для проверки. Включается только по просьбе разработчика |
bybit_market_prices |
"compare", "stream" |
Откуда стратегии Bybit берут цену (спринт 40). compare: цена REST, как раньше, а цена из открытого потока рынка Bybit только сравнивается с ней и считается в замерах. stream: свежая цена потока (не старше 5 секунд), иначе REST. Демо-счёт берёт те же цены, что живой. Включать после недели сравнения — по отчёту scripts/stream_report.py |
Раздел [diagnostics] (по умолчанию выключен):
| Настройка | Значения | Что делает |
|---|---|---|
bingx_stream_log |
false, true |
Записывать в файл bingx-stream-raw.jsonl (в папке состояния службы) первые события каждого вида из потока BingX, с их полями. Включается только по просьбе разработчика. Ключей, ключа потока (listenKey) и подписей в файле нет |
bingx_stream_log_events |
число от 1 до 1000 (20) | Сколько событий каждого вида записать |
bingx_stream_log_kb |
число от 1 до 10240 (512) | Наибольший размер файла в килобайтах: дальше запись прекращается |
Что делают стратегии в каждом режиме потока, описано для Binance в Аварии и сбои, для BingX — в BingX, для Bybit — в Bybit.
Обслуживание сервера
- Обновление ставится на сервере одной командой
vnext2-update. Перед обновлением администраторы системы получают «🛠 Обновление Alphafamilia Algo» (решение владельца 19.11: пользователям — только сообщения, где нужно что-то сделать). После обновления стратегии пользователей, чей сейф был открыт, продолжают сами — им ничего не приходит, администратору — «✅ Служба запущена, стратегии работают» с числом продолживших стратегий всех пользователей; пользователям с закрытым сейфом — «🔴 Служба запущена», они открывают свой сейф и запускают свои стратегии. Сообщения о падении службы и о невыполненных заданиях сервера — тоже только администраторам. Обновление идёт само по себе, окно Терминала только показывает его ход: если окно закрыть или связь оборвётся, обновление дойдёт до конца, а итог придёт в Telegram. - Если обновление не удалось, приходит «🔴 Обновление до … не удалось» с пояснением. Подробно — Перезапуск и обновление сервера.
- Падение службы. Сервер сам перезапускает службу и сообщает об этом всем, у кого есть стратегии. Стратегии пользователей, чей сейф был открыт, продолжают сами.
- Хранитель (
vnext2-keeper) — маленькая служба, благодаря которой стратегии продолжают после перезапуска программы. Её не перезапускают: перезапуск стирает её память, и после следующего перезапуска программы каждому понадобится пароль сейфа. Проверить:systemctl is-active vnext2-keeper. - Копии базы: полная копия — каждую ночь, хранится 30 дней; копия базы — ещё и каждый час, хранится 48 часов: при потере сервера теряется не больше часа записей. Проверка восстановления из копии — каждую неделю. Если что-то не получилось, приходит сообщение «🟠 Alphafamilia Algo: …». Стратегии при этом торгуют как прежде; сообщите разработчику.
- Обновления системы сервера (Ubuntu) сами не ставятся (ночные обновления перезапускали службу, и сейфы закрывались). Администратор ставит их вручную, когда стратегиям удобно:
apt update && apt upgrade. Службу это не перезапускает — сейфы остаются открытыми; если система попросит перезагрузку и сервер перезагружен, служба запустится сама, а сейф каждый открывает заново.
Утренняя сводка администратора
Каждое утро в 09:00 по времени Мадрида все, у кого есть стратегии, получают «ℹ️ Сводка Alphafamilia Algo» (что в ней у каждого — см. Сообщения в Telegram). У каждого в сводке есть строка «Сверка с биржей»: каждую ночь (после 05:00 по Мадриду) система сама сверяет результаты циклов, закрытых за сутки, с данными биржи — по каждому подключению со стратегиями, пока сейф его владельца открыт. Сверка только читает историю биржи: заявок не ставит, в работу стратегий не вмешивается. На Bybit, если в истории биржи за сутки нет сделок, которые стратегия получила от биржи в момент исполнения, сверка переспрашивает биржу о них по номеру заявки и пишет в отчёте, нашлись ли они: найденные — цикл сходится, не найденные нигде — расхождение. Если биржа на вопрос не ответила или заявок больше 40 за ночь и до какой-то очередь не дошла, такой цикл — «не сверено», а не расхождение: про эти сделки биржу не спросили. Ответы биржи сверка запоминает, и следующей ночью спрашивает только о том, о чём не спросила, — пока каждый такой цикл не будет сверен. Так же, если историю сделок биржи не удалось прочитать: цикл — «не сверено», и следующей ночью сверка берёт тот же период (не дальше трёх суток назад), а вам приходит «🟠 Сверка с биржей не выполнена». Обычная строка — «Сверка с биржей: циклов N, расхождений нет». «⚠️ расхождений N из M циклов» — результат стратегии не сошёлся с биржей: об этом сразу приходит и отдельное сообщение; сообщите разработчику. «Рядом ручная позиция: N» — фьючерсная стратегия работала рядом с вашей ручной позицией по тому же контракту и в ту же сторону: биржа считает результат закрытия от средней цены всей позиции, поэтому её цифра по такому циклу отличается от учёта стратегии. Учёт стратегии верен, делать ничего не нужно; если других расхождений нет, строка остаётся без значка ⚠️ и отдельное сообщение не приходит. «Ещё не выполнена» — сейф был закрыт (сверка пройдёт, когда он откроется, и возьмёт весь пропущенный период, но не больше трёх суток) или сверка ещё идёт. Новое подключение сверяется со следующей ночи.
Администратору в ней есть ещё служебные строки:
- «Версия» — какая версия работает и номер её сборки, например «2.1.1 (b29ac88)»; в приложении под списком стратегий — только версия («Версия: 2.1.1»);
- «База» — «отвечает» или «⚠️ не отвечает»;
- «Копия базы» — сколько часов назад сделана последняя ночная (полная) копия; ⚠️, если больше 26 часов назад или сведений нет. О сбое часовой копии сообщает отдельное «🟠 …: часовая копия базы не сделана»;
- «Диск» — занятость диска; ⚠️ от 80 %;
- «⚠️ Копии уходят на Mac незашифрованными» — шифрование копий на Mac ещё не включено: один раз в Терминале на Mac
bash ~/Downloads/vnext2.0/deploy/mac/setup-backup-key.sh(скрипт попросит придумать пароль ключа копий; он нужен только для восстановления); - предупреждение, если часы сервера не сверяются с точным временем: тогда цены могут считаться устаревшими, и стратегии перестанут ставить заявки.
Последняя строка сводки говорит, что сделать сегодня: открыть сейф и запустить стратегии, разобрать аварии, включить шифрование копий, сообщить разработчику о ⚠️ в строках службы или о сверке с биржей — или «Ничего делать не нужно.».
Служебные сигналы
Когда что-то не так у службы целиком, а не у одной стратегии, все, у кого есть стратегии, получают «Сигнал службы» (значок — по причине: 🔴, 🟠, ⚠️ или ✅). Например: ошибка в цикле службы или один счёт биржи под двумя подключениями. Список — Сообщения в Telegram.
Командная строка сервера
На сервере есть командная строка службы. Её команды выполняются от имени администратора системы и касаются только его стратегий и сейфа; другие пользователи открывают сейф и запускают стратегии в приложении. Команда сервера «запустить все» делает то же, что групповая «Запустить» в приложении: запускает все неработающие стратегии администратора, в том числе остановленные; между стратегиями пауза 2 секунды, чтобы биржа не получила все первые запросы разом. Аварийные стратегии пропускаются и остаются как есть; остановленная стратегия с незаконченным циклом остаётся остановленной, если выбор («продолжить» или «новый цикл») не указан; не трогает она и стратегии, остановка которых ещё не записана из-за недоступной базы (они названы в ответе). Стратегия в командах называется своим названием, как в приложении. Подробности — в техническом описании сервера.
Важно. Ключи зашифрованы паролем каждого пользователя. Но администратор сервера технически может прочитать всё на сервере, в том числе открытые ключи в памяти работающей службы. Пользователи должны доверять администратору системы.
Дальше: Вопросы и словарь