diff --git a/faq/install.md b/faq/install.md new file mode 100644 index 0000000..32e30ac --- /dev/null +++ b/faq/install.md @@ -0,0 +1,18 @@ +# Установка + +1. Склонируйте репозиторий +2. Установите зависимости + +```bash +pip install -r requirements.txt +``` +3. Настройте сервер (пример в `.env.example`) +4. Импортируйте схему таблиц в свою базу данных из `tables.sql` +5. Запустите сервер + +```bash +python3 main.py +``` + +6. Создайте пользователя +7. Зайдите со своего любимого клиента diff --git a/faq/patch_apk.md b/faq/patch_apk.md new file mode 100644 index 0000000..1b8a367 --- /dev/null +++ b/faq/patch_apk.md @@ -0,0 +1,24 @@ +# Смена сервера в мобильном клиенте +> [!Caution] +> Инструкция может быть недостаточной, если вы используете самоподписанный сертификат или сертификат, которому система не доверяет. Вам, возможно, потребуется выполнить дополнительные действия в модификации клиента для успешного входа. + +# MT Manager +1. Открываем apk файл клиента, который желаете пропатчить +2. Нажимаем на любой dex файл +3. Выбираем в качестве редактора "Редактор dex+" +4. Выбираем все dex файлы при появлении окна выбора "MultiDex" +5. В поиске выбираем тип Smali, а в поле поиска пишем "api.oneme.ru" +6. Проходимся по каждому результату и заменяем сервер на свой + +# ApkTool M +1. Декомпилируем приложение, обязательно поставьте галочку у пункта "Декомпилировать classes*.dex" +2. В папке проекта нажимаем на "лупу" +3. Ставим поиск по содержимому с заменой +4. В поле поиска пишем "api.oneme.ru", а в поле замены ваш адрес сервера +5. После замены нажимаем на "Собрать проект" + +# ApkTool +1. Помещаем apk в рабочую директорию +2. Открываем консоль в той же директории и производим декомпиляцию: `apktool d <имя apk> -o max` +3. Заходим в папку проекта и заменяем во всех классах "api.oneme.ru" на свой адрес сервера +4. Производим повторную сборку с помощью команды: `apktool b max -o max_modified.apk` diff --git a/faq/readme.md b/faq/readme.md new file mode 100644 index 0000000..c2379e3 --- /dev/null +++ b/faq/readme.md @@ -0,0 +1,7 @@ +# Навигация по faq + +## Работа с сервером +[Установка сервера](install.md) + +## Патчинг клиентов +[Патч apk](patch_apk.md) diff --git a/readme.md b/readme.md index 5165f10..1faf673 100644 --- a/readme.md +++ b/readme.md @@ -3,8 +3,7 @@ > Проект находится на ранней стадии разработки и вероятно полон багов. > > Использование в профессиональных средах не рекомендовано. - - +> # OpenMAX Эмулятор сервера MAX и ТамТам @@ -22,23 +21,5 @@ https://t.me/openmax_alerts Клиент может быть практически любым, главное условие - чтобы он был совместим с официальным сервером (`api.oneme.ru` / `api.tamtam.chat`). -На данный момент с сервером может работать последняя версия MAX (26.7.1), однако все тесты проходят на версии 26.5.0. - -# Установка - -1. Склонируйте репозиторий -2. Установите зависимости - -```bash -pip install -r requirements.txt -``` -3. Настройте сервер (пример в `.env.example`) -4. Импортируйте схему таблиц в свою базу данных из `tables.sql` -5. Запустите сервер - -```bash -python3 main.py -``` - -6. Создайте пользователя -7. Зайдите со своего любимого клиента +# Дополнительная информация +[Faq](faq/readme.md)