• Что такое OSINT.
• Виды OSINT разведки.
• Этапы OSINT разведки.
• Пример OSINT разведки.
• Основные OSINT инструменты.

Дисциплины сбора разведданных

• Подвиды OSINT.
• GEOINT.
• SOCMINT.
• HUMINT.

Анализ и dеанoнимизация в Telegram

• Верификация.
• Поисковики информации.
• Чаты телеграм.
• Боты обманки.
• HLR запрос.
• Получаем местоположение.
• Метаданные.
• Нетипичный фишинг.
• Каналы.

Инструменты

• Слежка через ссылку.
• Маскировка фишинг ссылки.
• Отслеживаем местоположение.
• Поиск аккаунтов в социальных сетях.
• Анализ телеграм профиля.
• Фишинг популярных сервисов.
• Получаем фото с вебкамеры.

1. Вступление

Что такое OSINT.

OSINT (Open Source Intelligence) - это интернет разведка, которая основана на том, что мы ищем информацию об объекте из открытых источников, таких как интернет, соцсети СМИ, реестры и т.д.

Разведка - это результат объединения анализированной, интерпретированной и подтвержденной информации с информированными восприятиями и личным опытом для принятия решений.

Разведка создается и формируется людьми. Машины могут собирать информацию, но не могут производить разведку.

Виды OSINT разведки.

OSINT делится на два типа: активная и пассивная разведка.

Пассивная разведка представляет собой процесс поиска информации об объекте без прямого взаимодействия с ним. Примерами такой деятельности могут быть анализ результатов поисковых систем, изучение социальных сетей и другие подобные методы.

Активная разведка представляет собой процесс активного взаимодействия с объектом, включая отправку пакетов данных, общение и прямое воздействие на цель. Это означает прямое взаимодействие с человеком или инфраструктурой компании для получения информации или выполнения определенных действий.

Этапы OSINT разведки.

1. Планирование: "Иди туда, не знаю куда, принеси то, не знаю что". В первую очередь, мы определяем цель поиска и направление движения. Набравшись опыта, вы сможете лучше понимать, где искать. Многое зависит от поставленной задачи, будь то составление справок о физических лицах, проверка компаний и их учредителей, или точечный поиск с помощью спутника.
2. Поиск и собирание информации: На данном этапе не существует универсального алгоритма, так как цель часто уникальна, и необходимо адаптировать подход с учетом особенностей. Иногда информация, с которой можно работать, доступна на поверхности, в то время как в других случаях требуется полноценный мониторинг и постепенный сбор данных, иногда даже с использованием социальной инженерии. Следует отметить, что существуют два вида сбора информации: активный и пассивный.
3. Анализ: Первым делом — фактчекинг, проверяем насколько достоверен источник перед нами, а также насколько информация логична и непротиворечива.
4. Отчёт: Зафиксировав собранную информацию, важно помнить, что мы не роботы и многие вещи могут быть забыты. Кроме того, восприятие больших объемов данных будет намного проще, если информация представлена в структурированном виде. В данном контексте речь идет о простых записях в таблицах или майндкартах. Последние будут наиболее удобными при работе с обширными данными, когда ум может быть перегружен. Для тех, кто не знаком с термином, майндкарты представляют собой схемы связей и детализации информации "от общего к частному".

Пример OSINT разведки.

Многие могут ошибочно думать, что OSINT - лишь забава, смеха ради.
Однако OSINT не ограничивается простым деаноном человека, за частую наоборот – это его меньшая часть.

Приведу недавний пример:
Сие действие происходило 26 марта в Днепре (Украина) во время войны. Дама украинского происхождения по имени anna_alkhim выкладывает в свой инстаграм сторис вечером 25 марта, в котором обратилась к своим подписчикам с просьбой о помощи с переполненными госпиталями раненных военных ВСУ.

Вот только у нее не хватило осведомленности, что российская разведка в кратчайшие сроки отслеживала всю социальную активность людей из районов боевых действий, вы можете задаться вопросом, и что же могло произойти?

Менее чем за сутки от медицинского госпиталя остались лишь обугленные стены.

Днём 26 марта в Днепре раздался взрыв, немого позже стало известно, что это ракетный удар по медицинскому учреждению, в результате которого погибло 2 человека, 30 были ранено, среди них было двое детей.

Основные OSINT инструменты.

• Инструменты поиска: Google, Bing, DuckDuckGo, Shodan, SpyFu
• Инструменты парсинга: Scrapy, Beautiful Soup, Octoparse
• Инструменты анализа: Maltego, NodeXL, Gephi
• Социальные сети: Facebook, Twitter, LinkedIn, Instagram
• Форумы и блоги: Reddit, Quora
• Реестры: WHOIS, DomainTools, IPInfoDB

Как вы видите, ничего "хакерского", практически все инструменты есть бесплатно. Это основные инструменты для поиска, конкретные парсеры / анализаторы будут дальше в статье.

2. Дисциплины сбора разведданных

Подвиды OSINT.

Ниже приведен краткий список дисциплин:

• BLOCKINT (разведка блокчейн) — данные, о криптовалютных транзакциях записанных в блокчейне.
• COMINT (коммуникационная разведка) — данные, собранные путем перехвата сигналов между людьми.
• CRIMINT (криминальная разведка) — данные о преступной деятельности и преступниках, часто собираемые правоохранительными органами.
• CYBINT (киберразведка) — данные, полученные из компьютерных систем и сетей.
• DARKINT (разведка в даркнет) — данные, собранные в сетях Tor, I2P, Freenet и прочее.
• ELINT (электронная разведка) — данные, собранные путем перехвата сигналов между электронными системами.
• FININT (финансовая разведка) — данные о финансовой деятельности, часто получаемые из финансовых учреждений.
• GEOINT (геопространственная разведка) — географические данные, обычно получаемые от спутников.
• IMINT (разведка на основе фотографий) — данные из фотографий или других изображений.
• SIGINT (разведка сигналов) — данные, собранные путем перехвата сигналов между людьми или электронными системами.
• SOCMINT (разведка в социальных сетях).
• TECHINT (техническая разведка) — данные об оборудовании, технологиях.
• TELINT (телеметрическая разведка). Предыдущее название FSINT.
• HUMINT (сбор и анализ информации, полученной от людей), например, через контакты с агентами, информаторами или иными источниками внутри или вблизи целевой организации.

RUMINT - это термин, который относится к разведке на основе слухов, где информация основана на неофициальных источниках. Это шутливое отношение к HUMINT, а не настоящая разведывательная дисциплина.

Также возможно увидеть упоминания TRASHINT, что представляет собой разведку мусора, где данные собираются из мусора или вторичных источников. Это шутливое отношение к другим разведывательным дисциплинам, а не настоящая разведывательная область.

Дальше в статье я разберу самые важные для нас.

GEOINT.

GEOINT, или геопространственная разведка - это процесс использования и анализа изображений, геопространственной информации для описания, оценки и визуального отображения физических особенностей и установления географической привязки деятельности на Земле.

Если быть проще, GEOINT может помочь определить местонахождение цели по одной ее фото из открытого доступа.

Хорошим примером будет недавняя история: девушка поделилась в соцсетях, как она купается в Ницце в 5:30 утра, но Тревор Рэйнболт разоблачил врунишку, рассчитав азимут и высоту теней, выяснив, что видео записано в ≈ 6:05 утра.
С Тревором Рэйнболтом многие не знакомы, эта личность прославилась благодаря тому, что он стал одним из топовых игроков в GeoGuessr - игра, в которой необходимо угадать местоположение улицы/переулка/шоссе в мире, пометив его на карте Google Maps.

В прошлом доступ к таким инструментам мог быть дорогостоящим и ограниченным, однако с развитием технологий появилось множество бесплатных ресурсов, которые можно использовать для создания теневых моделей и анализа метаданных в рамках GEOINT. Одним из таких инструментов являются бесплатные моделяторы теней, которые позволяют создавать трехмерные модели объектов и ландшафтов на основе анализа изображений и геоданных.

Кроме того, метаданные с фотографий и файлов также могут быть использованы в рамках GEOINT для получения дополнительной информации о местоположениях, времени съемки и других параметрах, которые могут быть полезны при анализе геопространственных данных.

Рассмотрим пример применения GEOINT вместе с SOCMINT:

Назовём его вымышленным именем Алешка, начнём с анализа его страницы в Telegram, Алешка недавно был в сети, у него в профиле четыре фотографии, подмечаем каждую деталь(может пригодиться)

Проверяем его никнейм на наличие страниц в других социальных сетях, есть совпадение. У Алешки была страница в Instagram под тем же псевдонимом, что и его аккаунт в Telegram.

Благодаря классическим методам GEOINT'а мы можем распознать что за стадион перед нами, и где он находится. Обратившись к Google Lens, мы получаем необходимую ссылку среди сотен результатов. Итак, это «Стадион им. Гагарина» геометки с видео совпадают.

SOCMINT.

SOCMINT - это совокупность инструментов и решений, позволяющих организациям анализировать действия, на основе интересов пользователя. Он позволяет использовать разведывательные данные из социальных медиа-сайтов, в том числе с использованием открытых и закрытых соцсетей.

Простыми словами - это анализ социальных сетей цели. Как показано из примера выше, по социальным сетям мы можем узнать все, от точного местонахождении цели, до обычных фактов таких как имя, возраст, имя любимой собачки и что цель ела вчера на ужин. Пример исследования SOCMINT был главой выше.

HUMINT.

Из самого названия Human Sources Intelligence (HUMINT) следует, что сведения для анализа «добывают» в процессе коммуникации с человеком, который является носителем значимой информации об объекте исследования.

Фактически - использование социальной инженерии и психологии для получения данных. Основным преимуществом HUMINT является его гибкость и способность получать информацию, которую невозможно получить другими методами. Кроме того, HUMINT может предоставить более глубокое понимание человеческого поведения и мотивации, что позволяет разработать стратегию под дeан0н конкретного человека. От HUMINT`а не защитит впн и прокси, не поможет даже антидетект браузер, ведь за частую вы сами рассказываете нужную информацию о себе.

HUMINT может применятся как для обычного деанона так и для получения более важных сведениях, приведем пример:

Проводится с целью сбора разведданных путём общения с военнослужащим, а также при отправке военнослужащими фото/видео с позиций и т.п.

HUMINT`ом также занимаются скамеры при общении с мамонтом, они проводят разведку что бы узнать через какие пути и манипуляции можно получить профит.

При работе с HUMINT важно понимать что такое соцаильная инженерия и как ее использовать, статья о ней уже была на канале.

3. Анализ и dеанoнимизация в Telegram

Верификация.

Telegram использует протоколы для социальных сетей, где личные аккаунты и сообщества (чаты, каналы) распознаются при помощи специального численного идентификатора ID, который необходим системе для точной идентификации пользователя.

В некоторых модах телеграм клиента встроенно распознование ID телеграм, но если у вас этого нет, используйте телеграм ботов.

Например, @userinfobot показывает ID по username`у и наоборот.

Поисковики информации.

Поисковая система (англ. search engine) — алгоритмы и реализующая их совокупность компьютерных программ, предоставляющая пользователю возможность быстрого доступа к необходимой ему информации при помощи поиска в обширной коллекции доступных данных.

Поисковые системы могут помочь уставить связь между несколькими аккаунтами, например, для обнаруживания твинков, так же, поисковые системы могут найти аккаунты в других социальных сетях по нику.

Конкретные инструменты будут предоставлены ниже.

Чаты телеграм.

Чаты в Telegram особенно важны для проведения расследований, связанных с деанонимизацией Telegram-аккаунтов.
Тут есть 2 стула. Первый - искать чаты через соответствующие боты поисковики, второй - искать чаты через общение с пользователем. Можно использовать социальную инженерию и просто попросить их, или пойти по более элегантному пути, и спарсить чат по названию из скриншота. Если чат открытый - его и вовсе можно найти через глобальный поиск.

Анализировать чаты - неимоверно важно, ибо человек в чатах общается со своими знакомыми и сам выдает информацию, он не находится в состоянии паранойи, и не догадывается что его сообщения могут использовать третьи лица. Боты в телеграм уже научились выгружать сообщения пользователей из чатов, поэтому даже удаление сообщений далеко не всегда помогает.

Боты обманки.

Для исполь­зования это­го спо­соба деано­ними­зации пот­ребу­ется нем­ного соци­аль­ной инже­нерии. Методи­ка работа­ет по прин­ципу фишин­га: жер­тва заходит в бота, и для даль­нейше­го его исполь­зования зап­рашива­ется отправ­ка номера телефо­на (это встро­енная фун­кция мес­сен­дже­ра). Далее, в зависи­мос­ти от фан­тазии соз­дателя, бот либо игно­риру­ет сооб­щения, либо выпол­няет какие‑то полез­ные фун­кции, но глав­ное — вла­делец робота получа­ет номер поль­зовате­ля.

Са­мое инте­рес­ное, что у тебя нет ни малей­шей необ­ходимос­ти писать с нуля собс­твен­ного бота, потому что есть уже готовые решения.

Од­нако луч­ше, конеч­но, написать бота самос­тоятель­но, но и для это­го есть наработ­ки — ре­пози­тории на GitHub. Ими мож­но вос­поль­зовать­ся без редак­туры, они поз­волят сра­зу соз­дать нес­коль­ко пол­ноцен­ных ботов «из короб­ки». При этом ты можешь выб­рать из нес­коль­ких темати­чес­ких вари­антов бота: нак­рутка под­писчи­ков в инстаг­раме, онлайн‑зна­комс­тва, донат в компь­ютер­ную игру и поиск информа­ции по номеру телефо­на.

Но пом­ни, что основная задача — все‑таки зас­тавить поль­зовате­ля поделить­ся номером, поэто­му дей­ствие это дол­жно быть мотиви­рова­но. А мотива­цию мы выбира­ем инди­виду­аль­но под каж­дую цель, зна­чит, и темати­ка бота, ско­рее все­го, будет раз­ной. Кто‑то поделит­ся номером ради оцен­ки подер­жанно­го авто­моби­ля, кто‑то — что­бы най­ти инте­рес­ный фильм, кого‑то заин­тересу­ет ска­чива­ние видео с YouTube. Поэто­му ботов при­дет­ся соз­давать раз­ных под каж­дый кейс, а основной код мож­но ско­пиро­вать из упо­мяну­тых репози­тори­ев.

HLR запрос.

Номер телефона мы получили, но как понять настоящий он или виртуальный?

HLR запрос (Home Location Register) – проверка актуальности мобильного номера и очистка базы абонентов от неактивных номеров. Проверка проводится путем отправки на номер запроса с уточнением информации о состоянии абонента.

Воспользуйтесь HLR-запросом от оператора. Этот запрос поможет узнать, активен ли номер и находится ли он в сети. Такой подход позволит вам проверить статус номера без необходимости совершать звонок. Сервисы предоставляющие эту возможность бесплатны и легко находятся в интернете.

Получаем местоположение.

В 2019 году в мессенджере Telegram была добавлена новая функция под названием "Люди рядом". Эта возможность позволяет пользователям делиться своим текущим местоположением для обнаружения контактов и чатов поблизости. Впоследствии точное местоположение было убрано, однако до сих пор можно передавать информацию о локации в радиусе 500 метров.

Ко­неч­но, OSINT-спе­циалис­ты такую инте­рес­ную воз­можность не упус­тили и соз­дали нес­коль­ко инс­тру­мен­тов для экс­плу­ата­ции фичи. Работа­ют они сле­дующим обра­зом.

На рабочем акка­унте вклю­чает­ся фун­кция «Люди рядом» и зада­ются те коор­динаты, в которых пред­положи­тель­но находит­ся цель. Каж­дые 25 секунд всем бли­жай­шим к ука­зан­ной точ­ке поль­зовате­лям будет отправ­лять­ся TDLib из Telegram. В него вхо­дит рас­сто­яние каж­дого бли­жай­шего поль­зовате­ля до тво­его мес­тополо­жения. Исполь­зуя три рас­сто­яния от трех раз­ных точек, мож­но вычис­лить мес­тополо­жение бли­жай­шего поль­зовате­ля.

При этом будут най­дены толь­ко те поль­зовате­ли Telegram, у которых акти­виро­вана фун­кция «поб­лизос­ти». По умол­чанию она отклю­чена. И конеч­но, для начала тебе необ­ходимо иметь хотя бы при­мер­ное пред­став­ление о мес­тонахож­дении объ­екта тво­его инте­реса. Мож­но пов­торять поиск в нес­коль­ких мес­тах, если исходная область слиш­ком боль­шая

Метаданные.

Метаданные — данные, относящиеся к дополнительной информации о содержимом или объекте. Проще говоря, это какая-либо дополнительная информация, зашифрованная в структуре самого файла.

Через социальную инженерию можно вынудить человека сделать и отправить вам фото без сжатия (файлом), например, под предлогом, что у вас проблемы с просмотром обычных фотографий. После получения файла используя специальные сервисы для извлечения метаданных получить информацию о user-Agent пользователя, его геолокации и другие данные о устройстве.

User agent – это программный элемент браузера, обозначающий человека, пользующимся им. Обычно он хранится в файле и содержит несколько текстовых строк, которые как раз и необходимы для идентификации.

Нетипичный фишинг.

Фишинговая ссылка для отправки сообщения в WhatsApp:

<a href="https://wa.me/НОМЕР_ТЕЛЕФОНА?text=ТЕКСТ!">СООБЩЕНИЕ В WHATSAPP</a>

Фишинговая ссылка для звонка через приложение Skype:

<a href="skype:ЛОГИН?call">ЗВОНОК В SKYPE</a>

Фишинговая ссылка для звонка через приложение ВКонтакте:

<a href="https://vk.com/call?id=НОМЕР_ID">ЗВОНОК В ВКОНТАКТЕ</a>

Каналы.

Новостные каналы в Telegram в короткие сроки приобрели огромную популярность.
Особенно это коснулось распространения околополитических прогнозов и статей.
Впрочем, свои каналы стали вести все:
от частных компаний до преступных сообществ.

Зная в каких каналах сидит цель, можно предположить ее место жительства, интересы, знакомых и прочее.

До 2017 года ссылки на приватные каналы в телеграм содержали закодированную информацию о том, кто ее сгенерировал. У таких ссылок, созданных до 2017 года, не содержится в начале «AAAAA» в ссылке.
Через ботов можно установить кто владелец канала если он был создан до 2017 года.
Просто отправьте боту ссылку на канал и он пришлет вам ID владельца.

Администраторы Telegram-канала могут использовать для управления публикациями внешние боты или сервисы (TGStat, Livegram, posted и прочие). А те могут раскрыть информацию о них.

4. Инструменты

Слежка через ссылку.

Инструмент создает фишинг ссылку, и через нее следит за пользователем.
Благодаря данному инструменту можно получить такую информацию как: IP, локация, ОС.

Так же можно будет узнать на каких сервисах зарегестрирован пользователь.

Установка:

$ apt update -y
$ apt upgrade -y
$ apt install python
$ apt install git
$ git clone https://github.com/jofpin/trape.git

Запуск:

$ cd trape
$ pip3 install -r requirements.txt
$ python3 trape.py --url <ссылка на любую страницу> --port 8080

Мы получим следующее:
Фишинг ссылку.
Ссылку на админ панель.
Пароль для входа в админ панель.

Маскировка фишинг ссылки.

Утилита, может помочь замаскировать/сократить ссылки. Фишинг маскируется под Google, YouTube, VK, Facebook, OK и RAIDforums.

Установка и запуск:

$ pkg update
$ pkg install python
$ pkg install git
$ git clone https://github.com/claprusshow/HIDDEN-PHISHING
$ cd HIDDEN-PHISHING
$ pip install -r requirements.txt
$ python HIDDEN-PHISHING.py

Теперь выбираем что нам нужно, маскировать ссылку или сократить ссылку. Затем указываем ссылку для маскировки/сокращения.

После этого за считанные секунды мы получим замаскированные/сокращённые ссылки.

Отслеживаем местоположение.

Инструмент для отслеживания местоположение номера телефона.

Установка и запуск:

pkg install git
pkg install python3
git clone https://github.com/HunxByts/GhostTrack.git
cd GhostTrack
pip3 install -r requirements.txt
python3 GhostTR.py

Поиск аккаунтов в социальных сетях.

Инструмент умеет не только находить существующие на разных сайтах аккаунты, но и находить сам аккаунт (с помощью определенных модулей), даже если профиль не имеет ничего общего с электронной почтой.

Установка и запуск:

pkg install git
pkg install python3
$ git clone https://github.com/N0rz3/Eyes.git
$ cd ./Eyes
$ pip3 install -r requirements.txt
python eyes.py [email]

Анализ телеграм профиля.

Инструмент предоставляет не только функции скрепинга информации о Телеграм каналах или чатах, но и:

• Анализ/визуализацию связей между пользователями.
• Экстракцию ключевых фраз/слов из сообщений пользователя.
• Выгрузка сущностей (энтити).
• Поиск геометок.

Установка и запуск:

git clone https://github.com/sockysec/Telerecon.git
sudo apt update
sudo apt upgrade
pip install -r requirements.txt
python3 -m spacy download en_core_web_sm
python3 launcher.py

Фишинг популярных сервисов.

Специальный инструмент для фишинговых ссылок
Популярных сервисов. Например Yandex. Instagram и прочих.

Установка:

apt upgrade && apt update
pkg install git
git clone https://github.com/An0nUD4Y/blackeye
ls
cd blackeye

Запуск:

bash blackeye.sh

Получаем фото с вебкамеры.

Скрипт с помощью которого можно без каких-либо проблем получать фото с веб-камеры пользователей.

Установка и запуск:

$ git clone https://github.com/noob-hackers/grabcam
$ cd grabcam
$ chmod +x grabcam.sh
$ bash grabcam.sh

После выполнения последней команды, включите на своем устройстве 2 пункта - "Мобильный интернет" и "Точка доступа Wi-Fi".

Возвращаемся к терминалу и выбираем пункт "Ngrok". Далее будет сгенерирована специальная ссылка, кидаем её жертве и ждём. В случае успеха, для просмотра фотографий введите команду:

$ termux-open cam название.png

2. После загрузки, разархивируем его в любое место

3. Скачиваем NodeJS v16.16 по ссылке: https://nodejs.org/en/blog/release/v16.16.0, выбираем свою операционную систему

4. Запустите файл Start.bat

5. Переходим к пункту НастройкаУстановка Linux

Устанавливать можно как на системы с GUI, так и на системы без него. Все версии Ubuntu начиная с 16.04 подходят для установки. Данный вид установки предусматривает то, что вы будете запускать с source code.

Установка бота:1. После входа в систему пропишите команду sudo apt update -y && sudo apt upgrade -y2. Скачайте curl с помощью команды sudo apt-get install curl nano unzip wget -y2. Установите деб-пакет NodeJS при помощи команды curl -sL https://deb.nodesource.com/setup_16.x | sudo -E bash -3. Установите NodeJS при помощи команды : sudo apt-get install nodejs -y4. Устанавливаем бота командой sudo wget https://github.com/NightStrang6r/FunPayServer/archive/refs/heads/main.zip && unzip main.zip

Включение бота:1. Пропишите команду cd FunPayServer-main2. Прописываем команду npm i -y, ждем загрузки.3. После загрузки прописываем команду node . (да, с точкой)4. Переходим к пункту "Настройка"

Примечание:
Чтобы настраивать бота вам необходимо знать базовые команды:
ls - Просмотр содержимого в текущей папке, пропишите чтобы узнать какие директории вам доступны.
cd - Перемещение в другую папку, например: cd FunPayServer-main или cd data/configs, чтобы вернутся в домашний котолог пропишите cd без параметра.
nano - текстовый редактор, перед использованием его нужно установить командой. Пример использования: вам потребовалось изменить какой-то файл, допустим это будет конфиг настроек settings.txt, для этого переходим в папку с этим конфигом с помощью команды cd FunPayServer-main и открываем нужный файл командой nano settings.txt, после чего изменяем нужные вам параметры. Теперь конфиг нужно сохранить его нажав Ctrl + O и выйти из него с помощью хоткея Ctrl + X, поздравляю, вы великолепны!

Установка Termux

Скачать через F-Droid - на странице кнопка "Download APK" (рекомендуется)Скачать со страницы релизов Termux - нужен файл termux-app_v0.118.0+github-debug_universal.apk, либо более новой версии

Установка бота:1. Обновите пакеты, выполнив команду apt update -y && apt upgrade -y2. Выполните команду pkg install nodejs-lts wget unzip nano -y3. Выполните команду wget https://github.com/NightStrang6r/FunPayServer/archive/refs/heads/main.zip && unzip main.zip

Включение бота:
1. Перейдите в папку проекта, выполнив команду cd FunPayServer-main2. Выполните команду: npm i3. Выполните команду: node . (не забудьте точку)4. Установка завершена, переходите к пункту "Настройка"

Примечание:
В termux все файлы находятся внутри приложения, вы не найдёте их в проводнике.
Чтобы настраивать бота вам необходимо знать базовые команды:
ls - Просмотр содержимого в текущей папке, пропишите чтобы узнать какие директории вам доступны.
cd - Перемещение в другую папку, например: cd FunPayServer-main или cd data/configs, чтобы вернутся в домашний котолог пропишите cd без параметра.
nano - текстовый редактор, перед использованием его нужно установить командой. Пример использования: вам потребовалось изменить какой-то файл, допустим это будет конфиг настроек settings.txt, для этого переходим в папку с этим конфигом с помощью команды cd FunPayServer-main и открываем нужный файл командой nano settings.txt, после чего изменяем нужные вам параметры. Теперь конфиг нужно сохранить его нажав Ctrl + O и выйти из него с помощью хоткея Ctrl + X, поздравляю, вы великолепны!

Установка FreeBSD

Установка только на системы без GUI, установка исключительно через source code, через .exe файл установить невозможно. Все версии начиная с 13.1 поддерживаются. Установка на FreeBSD самая простая из всех систем. Минусы : Кириллица не поддерживается, для её отображения вам нужно будет скачивать дополнительные пакеты, в этом гайде их не будет. Без этих пакетов все кириллические символы будут переведены в знаки вопроса.

Установка бота:1. Установите NodeJS используя команду pkg install nodejs-lts -y2. Установите npm используя команду pkg install npm-8.19.1 -y3. Перезагрузитесь используя команду rebootЗапуск бота (Аналогичный запуску на Linux)

Включение бота:
1. Пропишите команду cd FunPayServer-main
2. Прописываем команду npm i, ждем загрузки.
3. После загрузки прописываем команду node .
4. Готово! Бот запущен!
5. Переходим к пукту "Настройка"

Настройка

1. Запустите программу2. Теперь в браузере Google Crome устанавливаем расширение EditThisCookie по ссылке: https://chrome.google.com/webstore/detail/editthiscookie/fngmhnnpilhplaeedifhccceomclgfbg3. Входим в аккаунт FunPay, с которого осуществляются продажи, нажимаем на установленное расширение и в открывшейся панели открываем "golden_key", значение этой строки нам понадобится в следующем пункте

4. Копируем его значение.

4. Переключаемся на консоль с ботом и дожидаемся этого сообщения:

5. Вставляем golden_key из пункта 4, нажимаем enter

6. Заходим на сайт whatismybrowser.com, копируем user agent:

7. Переключаемся на консоль и вставляем user agent из прошлого пункта:

8. После выбираем стрелками на клавиатуре выбираем "Оставить по умолчанию" и нажимаем Enter

7. Поздравляю! Первоначальная настройка выполнена, приступим к подключению telegram бота!Создание бота Telegram

1. Заходим по ссылке https://t.me/BotFather

2. Отправляем боту команду /newbot3. После отправляем любое имя боту, это имя которое будет отображаться в чате с ботом4. Теперь придумываем юзернейм боту, он должен заканчиваться на bot или _bot , например NightBotЕсли вы получили следующее сообщение, значит юзернейм уже занят и вам необходимо придумать другой!

5. Ваш бот успешно создан! Получаем следующее сообщение:

Копируем выделенный токен
6. Переходим в папку с ботом, ищем файл settings.txt и открываем его через блокнот (если файл у вас не открывается скачайте https://notepad-plus-plus.org/downloads/ и откройте через него)
7. Ищем пункт [Telegram] и заполняем настройки:
enabled: 1
token: вставляем ваш токен из пункта 5
userName: вставляем юзернейм вашего телеграм аккаунта с котрого будете пользоваться ботом

8. Сохраняем файл, перезапускаем FunPay Server и радуемся!

9. Возвращаемся к пункту 5 и переходим по первой ссылке которую выдал BotFather
У вас откроется окно с вашим ботом, нажимаем кнопку запустить
Вуаля, бот готов!
Telegram бот не будет работать если FunPay Server не запущенНастройка автовыдачи

Способ 1 (лёгкий)

1. Проверьте, что в файле settings.txt включена настройка автовыдачи: autoDelivery: 1.2. Заходим в диалог с ботом которого мы создали3. нажимаем Редактировать автовыдачу4. Нажимаем Добавить товар5. Если вы хотите чтобы после оплаты лота выдавался всегда один и тот же товар нажимаем ИнструкцияЕсли же вы продаёте, к примеру аккаунты или любой другой товар который после каждой оплаты должен быть новый, нажимаем Аккаунты
Инструкция 6. Переходим на FunPay и копируем название лота, потом отправляем боту7. Пишем текст который будет выдан покупателю после оплаты этого лота и отпраляем боту8. Готово! Товар добавлен, вы можете добавить другие товары или удалить их через telegram бота, в дальнейшем функций будет больше!Как изменить товар в автовыдаче я рассказал в разделе Способ 2.

Аккаунты

6. Переходим на FunPay и копируем название лота, потом отправляем боту7. Пишем текст который будет выдан покупателю после первой оплаты этого лота и отпраляем ботуПишем текст вторым сообщением который будет выдаваться после второй оплатыПишем текст третьим сообщением который будет выдаваться после третьим оплаты и т.д.8. Как только закончите заполнять товар нажмите назад9. Готово! Товар добавлен, вы можете добавить другие товары или удалить их через telegram бота, в дальнейшем функций будет больше!Как изменить товар в автовыдаче я рассказал в разделе Способ 2.

Способ 2 (тяжёлый)

1. Проверьте, что в файле settings.txt включена настройка автовыдачи: autoDelivery: 12. Переходим в папку data, configs открываем файл delivery.json.3. Заполняем необходимыми товарами в формате JSON по примерам:
Если у вас выдаётся один и тот же товар: Код:

[B][
    {
        "name": "ТУТ ТОЧЬ В ТОЧЬ НАЗВАНИЕ ТОВАРА НА FUNPAY",
        "message": "Тут сообщение, которое будет выдано после оплаты. Для переноса строки используйте символы \n. Пример: первая строка\nвторая строка"
    },
    {
        "name": "ТУТ ТОЧЬ В ТОЧЬ НАЗВАНИЕ ТОВАРА НА FUNPAY",
        "message": "Тут другое сообщение, которое будет выдано после оплаты другого лота"
    }
][/B]

Пример:

Если у вас выдаются разные товары:

Код:

[B][
    {
        "name": "ТУТ ТОЧЬ В ТОЧЬ НАЗВАНИЕ ТОВАРА НА FUNPAY",
        "nodes": [
            "Тут сообщение, которое будет выдано после первой оплаты. Для переноса строки используйте символы \n. Пример: первая строка\nвторая строка ",
            "Тут сообщение, которое будет выдано после второй оплаты данного лота.",
        ]
    }
][/B]

Пример:

Комбинации:

Код:

[B][
    {
        "name": "ТУТ ТОЧЬ В ТОЧЬ НАЗВАНИЕ ТОВАРА НА FUNPAY",
        "nodes": [
            "Тут сообщение, которое будет выдано после первой оплаты. Для переноса строки используйте символы \n. Пример: первая строка\nвторая строка ",
            "Тут сообщение, которое будет выдано после второй оплаты данного лота.",
        ]
    },
    {
        "name": "ТУТ ТОЧЬ В ТОЧЬ НАЗВАНИЕ ТОВАРА НА FUNPAY",
        "message": "Тут сообщение, которое будет выдано после оплаты. Для переноса строки используйте символы \n. Пример: первая строка\nвторая строка"
    }
][/B]

Пример:

Перезапускаем FunPay Server и радуемся!Для переноса строки используйте \n между строчками, ни в коем случае не используйте перенос строки в выдаваемом сообщении или названии лота!Если в выдаваемом сообщении или названии лота присутствуют двойные кавычки поставьте перед ними \ , иначе бот просто выдаст ошибку, пример: Логин: \"1234\" Пароль: \"1234\".Для проверки кода на правильность написания используйте сервис - https://jsonformatter.org/json-parserПроверка автовыдачи

Для проверки работы автовыдачи зайдите в файл settings.txt, убедитесь что значение 1 стоит у следующих параметров:autoDeliveryautoResponse
autoDeliveryTestCommand
Если вы изменили настройки перезапустите FunPay Server чтобы изменения вступили в силу!Далее найдите чат с заблокированным пользователем / другом / твинком или в любой другой чат куда не жалко будеть слить выдаваемый товарпропишите: !автовыдача "в кавычках точное название лота который хотите проверить"Когда закончите проверку обязательно установите значение 0 для autoDeliveryTestCommand и перезапустите бота, иначе любой хитрюга сможет украсть ваш товар на автовыдаче запросив его командой проверки.

Примечание:
Вы так же можете указать в названии лота лишь его часть, например ваш лот - "[Автовыдача] among us + 400 игр, xbox game pas" и вы хотите добавить этот же аккаунт в другие категории то вам не обязательно создавать отдельные товары в файле delivery.json, вы можете просто добавить товар с названием "xbox game pas" и бот будет выдавать его для всех лотов в которых есть эта ключевая фраза (xbox game pas)!

Настройка автоответа

1. Проверьте, что в файле settings.txt включена настройка автоответа: autoResponse: 12. Переходим в папку data, configs открываем файл autoResponse.json.3. Заполняем необходимыми ответами в формате JSON по примерам:
Код:

[
    {
        "command": "!тест",
        "response": "Тестовое сообщение"
    },
    {
        "command": "!команда",
        "response": "Ответ на команду"
    }
]

После чего сохраняем файл и перезапускаем бота!Вы можете использовать как команды обычные слова, не обязательно добавлять восклицательный знак!Данные команды работают в чате на FunPay как если их напишет покупатель так если и продавец!Ответ на первое сообщение

1. Заходим в файл settings.txt ищем параметр greetingMessage: 0
2. меняем 0 на 1 тем самым включая настройку3. Листаем чуть ниже, ищем параметр greetingMessageText: , после двоеточия (через пробел) записывайте ваш ответ на первое сообщение:

Для переноса строки в сообщении используйте \n.
Доступные переменные: {name} - имя покупателя.
(переменная работает только в этой функции, в автовыдаче и т.д. работать не будет)

4. Сохраняем файл, перезапускаем программу. Ответ на первое сообщение готов!
Учтите что он будет срабатывать с теми пользователями с которыми у вас была переписка (но уже не видна в списке чатов) до момента включения этой функции.Остальные настройки

Уведомления в ТГ

1. Убедитесь что у вас создан и нормально функционирует телеграм бот, которого мы создали ранее2. Заходим в файл settings.txt, листаем до пункта newMessageNotification

3. Включаем те уведомления котрые хотите получать:
newMessageNotification: 1 (1 - уведомление о новых сообщениях включены, 0 - выключены)
newOrderNotification: 1 (1 - уведомление о новых заказах включены, 0 - выключены)
lotsRaiseNotification: 1 (1 - уведомление о поднятии лотов включены, 0 - выключены)
deliveryNotification: 1 (1 - уведомление о срабатывании автовыдачи включены, 0 - выключены)
4. Сохраняем файл, перезапускаем программу. Готово!вечный онлайн

1. Заходим в файл settings.txt ищем параметр alwaysOnline: 1,2. Значение 1 - вечный онлайн включён, значение 0 - вечный онлайн выключен.Если вы изменили настройки перезапустите FunPay Server чтобы изменения вступили в силу!По умолчанию включён3. Вечный онлайн не будет работать если бот не запущен!

автоподнятие лотов

1. Заходим в файл settings.txt ищем параметр lotsRaise: 1,2. Значение 1 - автоподнятие лотов включено, значение 0 - автоподнятие лотов выключено.Если вы изменили настройки перезапустите FunPay Server чтобы изменения вступили в силу!По умолчанию включено3. Автоподнятие лотов не будет работать если бот не запущен!

авто восстановление лотов

1. Заходим в файл settings.txt ищем параметр goodsStateCheck: 1,2. Значение 1 - авто восстановление лотов включено, значение 0 - авто восстановление лотов выключено.Если вы изменили настройки перезапустите FunPay Server чтобы изменения вступили в силу!По умолчанию включено3. авто восстановление лотов не будет работать если бот не запущен!

Функция подсчёта продаж / заработка

Работает только на версиях до 0.5.0!
Бот может подсчитать количество продаж и сумму заработанных средств с продаж. Для этого запустите файл FunPayServer.exe с параметром --countProfit, т.е. чтобы получилось FunPayServer.exe --countProfit. Запустить файл с параметром можно при помощи командной строки. Если вы использовали продвинутую установку, просто запустите файл CountTradeProfit.bat.

Работа с прокси

Бот поддерживает работу с http / https прокси с / без авторизации. Для включения работы через прокси пропишите в файле настроек settings.txt (пункт [Proxy]) настройку enabled: 1, а также данные хоста в поле host и порт в поле port. Если ваш прокси не требует авторизации, оставьте поля login и pass пустыми.

Решение ошибок

1. Ошибка при получении данных аккаунта: TypeError: Cannot read properties of null (reading 'innerHTML')

Решение 1: ваш golden key устарел, вам нужно заменить его на новый в файле settings.txt

Решение 2: у вас проблемы с подключением к интернету или с доступом к FunPay, вы можете: просто подождать / проверить интернет / поставить DNS сервера на 1.1.1.1 и 8.8.8.8

2. Ошибка при загрузке файла "C:\Users\lemar\OneDrive\Документы\FunPayServer-main/data/configs/delivery.json". Возможно файл имеет неверную кодировку (поддерживается UTF-8), либо неверный формат JSON:

Ошибка при загрузке файла "C:\Users\lemar\OneDrive\Документы\FunPayServer-main/data/configs/autoResponse.json". Возможно файл имеет неверную кодировку (поддерживается UTF-8), либо неверный формат JSON:

Ошибка при загрузке файла настроек: SyntaxError: Unexpected string in JSON at position 185. Программа будет закрыта.

Решение 1: смените кодировку файла который указан в ошибке на UTF-8

Решение 2: ваш файл заполнен с ошибкой, вы можете: вручную найти ошибку в файле (возможно не хватает запятой или скобки) / отправить содержимое файла на jsonformatter.org чтобы найти и исправить ошибку / если у вас проблема с файлом autoIssue.json вы можете воспользоваться телеграм-ботом для редактирования автовыдачи без ошибок

3. "node" не является внутренней или внешней

командой, исполняемой программой или пакетным файлом.

Решение: установите NodeJS

4. Ошибка при запросе (нет доступа к интернету / funpay): FetchError: request to https://funpay.com/ failed, reason: getaddrinfo ENOTFOUND funpay.com

Решение: у вас проблемы с подключением к интернету или с доступом к FunPay, вы можете: просто подождать / проверить интернет / поставитьDNS сервера на 1.1.1.1 и 8.8.8.8

5. Заморозка процесса (Windows)

(Бот перестаёт работать через какое-то время, хотя запущен и ошибок не выдаёт)

Решение:1. ПКМ по окну консоли -> свойства2. Переходим в Настройки3. Снимаем галочку "Выделение мышью"4. Нажимаем "Ок".

6. "Название товара" нет в списке автовыдачи, пропускаю.

Решение:1. зайдите на funpay и скопируйте название вашего лота.2. Перейдите в конфиг автовыдачи (delivery.json) и замените название лота на то которые вы скопировали.

Примечание:Телеграм бот некорректно добавляет товары с некоторыми эмоджи, поэтому всегда надёжнее добавить товар вручную.