From 04cbcbd8178bb10f687f44f4705ac31bd58f2355 Mon Sep 17 00:00:00 2001 From: Vladislav Lisitsyn <114032530+Vladless@users.noreply.github.com> Date: Sun, 29 Sep 2024 02:11:50 +0300 Subject: [PATCH] Create README.md --- README.md | 90 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 90 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 00000000..7444ba04 --- /dev/null +++ b/README.md @@ -0,0 +1,90 @@ +# 🚀 Название проекта + +**[SoloBot]**! +[Бот для API x-ray] + +## 📋 Оглавление +1. [Описание](#описание) +2. [Требования](#требования) +3. [Установка](#установка) +4. [Конфигурация](#конфигурация) +5. [Запуск](#запуск) +6. [Автор](#автор) + +--- + +## 📖 Описание + +[Бот предназначен для автоматизирования выдачи ключей, хранении их в базе данных и управления подключениями] + + +--- + +## 💻 Требования + +Для работы проекта необходимы следующие компоненты: + +- **Python** версии 3.8 или выше +- **Git** для клонирования репозитория +- **Virtualenv** для создания виртуального окружения (рекомендуется) +- **Postresqpl** для работы базы данных + +--- + +## ⚙️ Установка + +### 1️⃣ Шаг 1: Клонирование репозитория + +Клонируйте репозиторий и перейдите в его директорию: + +```bash +git clone https://github.com/Vladless/Solo_bot.git +cd solo_bot +``` + +### 2️⃣ Шаг 2: Создание и активация виртуального окружения + +``` +python3 -m venv venv +source venv/bin/activate +``` + +### 3️⃣ Шаг 3: Установка зависимостей + +``` +pip install -r requirements.txt +``` + +### 🛠️ Конфигурация + +Для правильной работы вам нужно установить postresql, создать пользователя для работы с базой данных и выдать ему права + +Также создайте файл config.py в корневой папке проекта с вашими данными: + +``` +API_TOKEN = токен вашего бота телеграм +API_URL = домен вашего x-ray сервера с указанием порта дополнительным именем +ADMIN_USERNAME = логин от вашей панели x-ray +ADMIN_PASSWORD = пароль от вашей панели x-ray +ADD_CLIENT_URL = f"{API_URL}/panel/api/inbounds/addClient" +GET_INBOUNDS_URL = f"{API_URL}/panel/api/inbounds/list/" +AUTH_URL = f"{API_URL}/login/" +DOMEN = "{ваш домен без www}:443" +DATABASE_URL = путь к вашей базе данных, имеет вид "postgresql://{user}:{password}@{Ip-adress}:5432/{имя базы данных}" +ADMIN_ID = ID телеграм профиля администратора +CHANNEL_URL = ссылка телеграм на ваш канал +``` + +### 🚀 Запуск + +введите команду из виртуального окружения + +``` +python main.py +``` + + + + + +