(Added by Nikita ❤️)
Holderbot - это легковесный и простой бот, изначально созданный для решения проблемы отсутствия опции on hold в пользовательском интерфейсе "Marzban Panel". Используя API Marzban, Holderbot предоставил пользователям возможность легко использовать эту функцию в Telegram. Однако, после обновления 3.0, Holderbot расширил свои возможности с введением специальных функций, достигнув пика в последующих версиях. Теперь Holderbot служит профессиональным ассистентом для пользователей Marzban. Для получения дополнительной информации вы можете обратиться к разделу обновлений или присоединиться к каналу Telegram.
Important
Вы можете выразить свою поддержку, поставив звезду этому проекту на GitHub. Мы создали канал Telegram для объявлений, опросов и взаимодействия с пользователями. Вы можете присоединиться к нам по ссылке @ErfjabHolderbot.
- Возможность автоматической настройки при достижении ограничения объема или времени.
- Возможность управления администраторами панели (изменение пароля или sudo)
- Возможность добавления или удаления администраторов для панели
- Возможность определения коэффициента потребления узла
- Возможность управления узлами (деактивация/активация/переподключение)
- Возможность мониторинга и получения уведомлений об отключении узлов
- Возможность деактивации/активации мониторинга
- Возможность изменения таймера мониторинга для узлов
- Возможность создания пользователей группой/индивидуально (on_hold)
- Возможность создания пользователей через шаблоны
- Возможность создания шаблонов (объем, время, inbounds )
- Возможность получения последнего времени онлайн, обновления подписки пользователем (индивидуально)
- Возможность получения QR и текста суб-ссылки или удаления пользователя
- Возможность получения информации о используемом пользователем программном обеспечении
- Возможность получения QR для желаемой ссылки
- Возможность поиска и получения похожих пользователей (как Did you Mean в Google)
- Возможность получения списка онлайн/оффлайн пользователей (от 1 минуты до последних 60 дней в табличном и PDF формате)
- Новый стильный и простой пользовательский интерфейс.
Note
Мы постоянно работаем над новыми обновлениями. Есть ли у вас какие-либо идеи или предложения? Пожалуйста, поднимите их в виде проблем, и мы рассмотрим возможность добавления их в будущих обновлениях.
Для использования holderbot вам потребуется следующая информация:
- Name: Вы можете ввести любое предпочитаемое вами имя.
- Chat ID: Вам нужно получить его от @chatIDrobot.
- Bot Token: Вам нужно получить его от @botfather.
- Panel username: Введите имя пользователя своего sudo администратора панели.
- Panel password: Введите пароль своего sudo администратора панели.
- Panel domain: Введите домен своей панели в следующем формате (sub.domain.com:port).
Warning
Обратите внимание, что в настоящее время HolderBot поддерживается только для установки и использования на серверах Ubuntu, и любая ответственность за другие конфигурации лежит на вас.
Пожалуйста, используйте следующую команду для установки на свой сервер:
cd && cd .. && rm -f holderbot.sh* || true && sudo apt install && sudo apt-get install libjpeg-dev && wget https://raw.githubusercontent.com/erfjab/holderbot/main/holderbot.sh && chmod +x holderbot.sh && ./holderbot.sh
Все объяснения полные и понятные, но если вы все же заметите какие-либо недостатки или недочеты в объяснениях, пожалуйста, создайте issue, и мы ее устраним. Спасибо за сотрудничество.
Warning
Эти руководства предназначены исключительно для версии 4. Предыдущие версии больше не поддерживаются.
На домашней странице вы найдете все необходимые команды со списком, а более подробные объяснения приведены ниже страницы. Здесь, помимо ввода команд, вы также можете отправить имя пользователя или ссылку на подписку. Если пользователь существует, вы получите его статистику, а если нет, с помощью функции поиска Holder Bot вы получите список похожих пользователей.
Когда вам будет отправлена статистика пользователя, вы увидите три варианта: "Обновить", "Qrcode" и "Удалить". Чтобы обновить статистику пользователя, используйте кнопку "Обновить". Чтобы получить баркод для ссылки подписки пользователя, используйте кнопку "Баркод". А чтобы удалить пользователя, используйте кнопку "Удалить".
Note
Не беспокойтесь, перед выполнением операции удаления у вас будет запрошено подтверждение.
У вас есть два варианта создания пользователя: либо через шаблоны, либо вручную. Вы можете создавать готовые шаблоны, обратившись к разделу "шаблоны" в этом руководстве и создав свои шаблоны. При создании пользователя, если вы нажмете на один из ваших шаблонов, inbounds, объем и время будут автоматически настроены. Бот автоматически нумерует имена пользователей и создает пользователей.
Если вы хотите сделать это вручную, у вас спросят inbounds, объем и время, что более подходит для конкретных случаев. Шаблоны ускоряют вашу работу и позволяют создавать сотни пользователей за долю секунды.
Добро пожаловать в раздел Сообщения! Эта функция была добавлена при спонсорской поддержке Gray.❤️ Вы можете посетить канал и бот Gray для покупки серверов на почасовой и помесячной основе, с широким выбором местоположений и характеристик, дополненных чистыми IP-адресами по самым низким ценам. Перед активацией Уведомления вам нужно создать inbound Shadowsocks с именем "Holderbot" внутри панели:
{
"tag": "Holderbot",
"listen": "0.0.0.0",
"port": 2222,
"protocol": "shadowsocks",
"settings": {
"clients": [],
"network": "tcp,udp"
}
}
Затем, внутри настроек хоста inbounds, мы помещаем наши желаемые сообщения. После применения изменений, внутри Holderbot мы нажимаем на опцию "Изменить статус" в разделе Уведомления, и эта функция становится активной. Holderbot проверяет пользователей каждые 5 секунд и активирует сообщения для истекших пользователей, соответственно уведомляя вас.
В разделе Пользователи вы получаете общую статистику вашей панели. Количество пользователей "всех", "активных", "отключенных", "on_hold", "ограниченных" и "просроченных", а также подсчет пользователей, которые были онлайн или оффлайн за последние 24 часа, и обновлены ли их ссылки или нет.
Ниже вы найдете варианты, при нажатии на которые вам будет предоставлен список имен пользователей в формате PDF. Если вы нажмете на последние два варианта, у вас спросят желаемый временной промежуток, и на основе этого вы получите статистику.
Tip
Если у вас есть конкретный временной промежуток, вы можете ввести его по шаблону 'время мин/час/день'.
В этом разделе вы можете полностью управлять администраторами панели. Вы можете добавлять, удалять, изменять их пароли, а так и изменять разрешения. Просто обратите внимание, что для удаления sudo администраторов это можно сделать только с главного сервера, используя команду CLI. API не позволяют нам получить доступ к этой возможности.
Здесь вы также можете управлять своими узлами, переподключать, деактивировать, активировать или задать коэффициент потребления для желаемого сервера. Для мониторинга и получения уведомлений об отключении сервера см. раздел мониторинга на этой странице.
Создавая шаблоны, вы можете легко управлять повторяющимися задачами, такими как указание объема, продолжительности и inbounds. В разделе шаблонов вы можете создать новый шаблон или удалить существующие. Чтобы создать новый шаблон, просто нажмите на "➕ Добавить новый шаблон". На первом этапе введите имя без пробелов, цифр или значков. Затем введите объем (в гигабайтах) и продолжительность (в днях), и наконец, выберите входные потоки. Каждый выбранный inbounds, отмеченный ➕, включен, а те, что отмечены ➖, не включены. После завершения выбора нажмите "✅ Завершить", чтобы сохранить шаблон. Чтобы удалить шаблон, просто нажмите на него, и у вас будет запрошено подтверждение. После подтверждения он будет удален.
Note
Вы добавляете/удаляете шаблоны в этом разделе, но используете их только в разделе "🚀 Создать пользователя".
Мониторинг для ваших серверов включен по умолчанию при установке HolderBot. Вы можете включить/выключить его в этом разделе. Вы также можете установить интервал проверки сервера для мониторинга и указать время ожидания до следующей проверки при получении уведомления об отключении сервера.
Иногда вы можете не помнить имя пользователя полностью, но хотите ввести несколько букв, чтобы бот легко нашел его и сообщил вам. Это то, что вы имели в виду? Эта возможность специально разработана для таких поисков, когда бот может перечислить имена пользователей, похожие на ваш ввод, и отправить их вам.
Note
Этот раздел не предназначен для получения статистики пользователя. Для этой цели вы можете обратиться к руководству по домашней странице.
Вам будет отправлено руководство по решению проблем, запросу помощи, отчету об ошибках, связи с разработчиком и аналогичным вопросам. Кроме того, вам будет отправлен файл с журналами Holder Bot, который при необходимости вы можете поделиться с разработчиком для отладки и решения проблем.
Вы можете получить его QR, отправив любую ссылку или текст. Эта функция не является эксклюзивной для ссылок v2ray, и она может предоставить вам QR в кодированном виде для любой полученной ссылки. Это быстро и просто!
Tip
Вы можете изменить цвет QR в файле "qr.py" в папке "Function" используя строку 8 (fill_color) с такими вариантами, как красный, розовый, синий, желтый.
