Misha/gggg
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Загрузить файлы в «/»

Browse Source
This commit is contained in:
Misha
2025-11-27 21:58:36 +02:00
commit 2c6903ce94
1 changed files with 521 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

521
README.md Normal file
View File

@@ -0,0 +1,521 @@
# 🛡️ Discord Anti-Nuke Бот
Полнофункциональный Discord бот для защиты сервера от краша, спама и вредоносных ботов. Бот автоматически отслеживает подозрительную активность, применяет наказания и восстанавливает удалённые элементы.
---
## 📋 Содержание
1. [Описание](#описание)
2. [Функционал](#функционал)
3. [Установка](#установка)
4. [Настройка](#настройка)
5. [Запуск](#запуск)
6. [Модули](#модули)
7. [Команды](#команды)
8. [База данных](#база-данных)
9. [Логирование](#логирование)
10. [Запуск на Pterodactyl](#запуск-на-pterodactyl)
11. [Решение проблем](#решение-проблем)
---
## 📖 Описание
Discord Anti-Nuke бот — это комплексная система защиты сервера, которая:
- ✅ Автоматически защищает от массового удаления каналов и ролей
- ✅ Предотвращает добавление вредоносных ботов
- ✅ Блокирует спам и злоупотребление упоминаниями
- ✅ Отслеживает изменения названия и иконки сервера
- ✅ Восстанавливает удалённые элементы автоматически
- ✅ Ведёт подробные логи всех событий
- ✅ Применяет наказания нарушителям
---
## 🎯 Функционал
### Защита от краша сервера (Anti-Nuke)
- **Массовое удаление каналов**: Отслеживает количество удалённых каналов за период времени
- **Массовое удаление ролей**: Контролирует удаление ролей
- **Массовое создание каналов/ролей**: Предотвращает создание большого количества элементов
- **Изменение сервера**: Защищает от изменения названия и иконки сервера
- **Выдача админских прав**: Отслеживает массовую выдачу административных прав
### Защита от ботов (Anti-Bot)
- Автоматическая проверка всех добавляемых ботов
- Сравнение с белым списком разрешённых ботов
- Бан неразрешённых ботов и пригласивших их пользователей
### Защита от спама (Anti-Spam)
- Контроль частоты сообщений
- Защита от злоупотребления упоминаниями (@everyone, @here)
- Автоматический мут или бан спамеров
### Автоматическое восстановление
- Сохранение данных каналов и ролей перед удалением
- Автоматическое восстановление удалённых элементов
- Сохранение всех разрешений и настроек
---
## 🚀 Установка
### Требования
- Node.js 18+
- MySQL или MariaDB
- Discord Bot Token
### Шаги установки
1. **Клонирование или загрузка проекта**
```bash
cd /path/to/project
```
2. **Установка зависимостей**
```bash
npm install
```
3. **Настройка конфигурации**
Скопируйте файл `src/config/config.example.yml` в `src/config/config.yml`:
```bash
cp src/config/config.example.yml src/config/config.yml
```
Отредактируйте `src/config/config.yml` и заполните все необходимые параметры (см. раздел [Настройка](#настройка)).
4. **Сборка проекта**
```bash
npm run build
```
---
## ⚙️ Настройка
### 1. Получение Discord Bot Token
1. Перейдите на [Discord Developer Portal](https://discord.com/developers/applications)
2. Создайте новое приложение или выберите существующее
3. Перейдите в раздел "Bot"
4. Нажмите "Reset Token" и скопируйте токен
5. Включите следующие привилегии:
- **SERVER MEMBERS INTENT** (Privileged Gateway Intents)
- **MESSAGE CONTENT INTENT** (Privileged Gateway Intents)
6. В разделе "OAuth2" → "URL Generator":
- Выберите scope: `bot`, `applications.commands`
- Выберите permissions: `Administrator` (или минимальные: Ban Members, Manage Channels, Manage Roles, Manage Server, View Audit Log)
- Скопируйте URL и откройте в браузере для добавления бота на сервер
### 2. Получение ID сервера
1. Включите режим разработчика в Discord (Настройки → Расширенные → Режим разработчика)
2. Правый клик по серверу → "Копировать ID сервера"
### 3. Настройка базы данных
Создайте базу данных MySQL/MariaDB:
```sql
CREATE DATABASE antinuke CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```
Или используйте существующую базу данных. Бот автоматически создаст необходимые таблицы при первом запуске.
### 4. Редактирование config.yml
Откройте `src/config/config.yml` и заполните:
```yaml
bot:
token: "ВАШ_ТОКЕН_БОТА"
guild_id: "ID_ВАШЕГО_СЕРВЕРА"
prefix: "!"
log_channel_id: "ID_КАНАЛА_ДЛЯ_ЛОГОВ" # Необязательно
database:
type: "mysql"
host: "localhost"
port: 3306
user: "root"
password: "ваш_пароль"
name: "antinuke"
limits:
max_channel_creates: 3
max_role_deletes: 2
max_channel_deletes: 2
max_role_creates: 5
max_spam_messages: 5
max_mentions: 3
window_seconds: 10
spam_window_seconds: 3
whitelist:
admins:
- "ID_ДОВЕРЕННОГО_АДМИНА_1"
- "ID_ДОВЕРЕННОГО_АДМИНА_2"
bots:
- "ID_РАЗРЕШЁННОГО_БОТА_1"
punishment:
ban_user: true
ban_bot: true
ban_inviter: true
restore_changes: true
mute_on_spam: true
mute_duration_minutes: 10
```
### 5. Настройка белого списка
Добавьте ID доверенных администраторов и разрешённых ботов в секцию `whitelist` конфигурации. Эти пользователи и боты не будут забанены системой защиты.
---
## 🏃 Запуск
### Режим разработки
```bash
npm run dev
```
### Продакшн режим
```bash
npm run build
npm start
```
### Использование PM2 (рекомендуется)
```bash
npm install -g pm2
npm run build
pm2 start dist/index.js --name antinuke-bot
pm2 save
pm2 startup
```
---
## 🔧 Модули
### Core модули
#### `logger.ts`
Система логирования на основе Winston. Поддерживает логирование в консоль и файл с ротацией.
#### `database.ts`
Модуль работы с MySQL/MariaDB. Обеспечивает подключение, создание таблиц и операции с данными.
#### `configLoader.ts`
Загрузка и валидация конфигурации из YAML файла.
### Модули защиты
#### `antiNuke.ts`
Основной модуль защиты от краша сервера. Отслеживает массовые операции через Audit Log и сравнивает с лимитами.
#### `antiBot.ts`
Проверяет всех добавляемых ботов и сравнивает с белым списком.
#### `antiSpam.ts`
Контролирует частоту сообщений и упоминаний, применяет наказания за спам.
#### `autoRestore.ts`
Сохраняет данные каналов и ролей перед удалением и восстанавливает их при необходимости.
#### `punishment.ts`
Выполняет наказания: бан, кик, мут. Отправляет сообщения в лог-канал.
#### `whitelist.ts`
Управление белым списком администраторов и ботов.
---
## 💬 Команды
Все команды доступны через Slash Commands (/) в Discord.
### `/whitelist add user_id:<ID> type:<admin|bot>`
Добавляет пользователя или бота в белый список.
**Пример:**
```
/whitelist add user_id:123456789012345678 type:admin
```
### `/whitelist remove user_id:<ID> type:<admin|bot>`
Удаляет пользователя или бота из белого списка.
### `/whitelist list`
Показывает текущий белый список.
### `/antinuke status`
Отображает статус системы защиты, текущие лимиты и настройки.
### `/antinuke test`
Проверяет работу системы защиты.
### `/config reload`
Перезагружает конфигурацию из файла `config.yml` без перезапуска бота.
---
## 🗄️ База данных
### Структура таблиц
#### `events_log`
Хранит все события, отслеживаемые ботом.
| Поле | Тип | Описание |
|------|-----|----------|
| id | VARCHAR(36) | UUID события |
| user_id | VARCHAR(20) | ID пользователя |
| action | VARCHAR(100) | Тип действия |
| details | TEXT | Детали события |
| timestamp | DATETIME | Время события |
#### `restored_items`
Хранит данные для восстановления каналов и ролей.
| Поле | Тип | Описание |
|------|-----|----------|
| id | INT | ID записи |
| type | ENUM | Тип: channel или role |
| old_data | JSON | Данные элемента |
| restored_at | DATETIME | Время восстановления |
#### `punishments`
Лог всех применённых наказаний.
| Поле | Тип | Описание |
|------|-----|----------|
| id | INT | ID записи |
| user_id | VARCHAR(20) | ID пользователя |
| reason | TEXT | Причина наказания |
| punishment_type | VARCHAR(50) | Тип наказания |
| timestamp | DATETIME | Время наказания |
---
## 📝 Логирование
Бот ведёт логи в двух местах:
1. **Консоль**: Все события выводятся в консоль с цветовой кодировкой
2. **Файл**: Логи сохраняются в файл (настраивается в `config.yml`)
### Уровни логирования
- `error`: Критические ошибки
- `warn`: Предупреждения
- `info`: Информационные сообщения
- `debug`: Отладочная информация
### Настройка логирования
В `config.yml`:
```yaml
logging:
enabled: true
file_path: "./logs/bot.log"
level: "info"
max_file_size: "10m"
max_files: 5
```
---
## 🐳 Запуск на Pterodactyl
### 1. Создание яйца (Egg)
Если у вас есть доступ к панели Pterodactyl, создайте новое яйцо для Node.js приложения.
### 2. Настройка сервера
1. Создайте новый сервер в Pterodactyl
2. Выберите яйцо Node.js
3. Установите следующие переменные окружения (если нужно):
- `NODE_VERSION`: `18` или выше
### 3. Установка зависимостей
В консоли сервера выполните:
```bash
npm install
```
### 4. Настройка конфигурации
Отредактируйте `src/config/config.yml` через файловый менеджер или через консоль:
```bash
nano src/config/config.yml
```
### 5. Сборка и запуск
```bash
npm run build
npm start
```
### 6. Автозапуск
Pterodactyl автоматически перезапустит бота при перезагрузке сервера, если процесс завершится.
### Альтернатива: использование PM2
Если хотите использовать PM2 на Pterodactyl:
1. Установите PM2 в консоли сервера:
```bash
npm install -g pm2
```
2. Создайте файл `ecosystem.config.js`:
```javascript
module.exports = {
apps: [{
name: 'antinuke-bot',
script: 'dist/index.js',
instances: 1,
autorestart: true,
watch: false,
max_memory_restart: '500M',
}]
};
```
3. Запустите через PM2:
```bash
npm run build
pm2 start ecosystem.config.js
pm2 save
```
---
## 🔍 Решение проблем
### Бот не запускается
**Проблема**: Ошибка при запуске бота
**Решения**:
1. Проверьте правильность токена в `config.yml`
2. Убедитесь, что бот добавлен на сервер с необходимыми правами
3. Проверьте подключение к базе данных
4. Убедитесь, что Node.js версии 18+
### Ошибки подключения к БД
**Проблема**: `Error: connect ECONNREFUSED`
**Решения**:
1. Проверьте, что MySQL/MariaDB запущен
2. Проверьте правильность хоста, порта, пользователя и пароля
3. Убедитесь, что база данных существует
4. Проверьте права доступа пользователя БД
### Бот не реагирует на события
**Проблема**: Бот онлайн, но не обрабатывает события
**Решения**:
1. Проверьте, что `guild_id` в конфиге соответствует ID сервера
2. Убедитесь, что бот имеет необходимые права на сервере
3. Проверьте, что включены необходимые Intents в Discord Developer Portal
4. Проверьте логи на наличие ошибок
### Команды не работают
**Проблема**: Slash Commands не отображаются или не работают
**Решения**:
1. Подождите несколько минут после запуска (команды регистрируются асинхронно)
2. Проверьте права бота (нужны права на использование Slash Commands)
3. Убедитесь, что бот имеет права Administrator или необходимые минимальные права
4. Попробуйте перезапустить бота
### Бот банит легитимных пользователей
**Проблема**: Бот банит администраторов или разрешённых ботов
**Решения**:
1. Добавьте ID администраторов в `whitelist.admins` в конфиге
2. Добавьте ID разрешённых ботов в `whitelist.bots`
3. Перезагрузите конфигурацию командой `/config reload` или перезапустите бота
### Восстановление не работает
**Проблема**: Удалённые каналы/роли не восстанавливаются
**Решения**:
1. Убедитесь, что `punishment.restore_changes: true` в конфиге
2. Проверьте права бота (нужны права на создание каналов и ролей)
3. Проверьте логи на наличие ошибок восстановления
4. Убедитесь, что данные сохраняются в БД (проверьте таблицу `restored_items`)
### Высокое использование памяти
**Проблема**: Бот потребляет много памяти
**Решения**:
1. Уменьшите `max_files` в настройках логирования
2. Уменьшите `max_file_size` для логов
3. Используйте PM2 с ограничением памяти
4. Регулярно очищайте старые записи из БД
---
## 📞 Поддержка
Если у вас возникли проблемы, не описанные в этом руководстве:
1. Проверьте логи бота в файле или консоли
2. Проверьте логи базы данных
3. Убедитесь, что все зависимости установлены: `npm install`
4. Проверьте версию Node.js: `node --version` (должна быть 18+)
---
## 📄 Лицензия
MIT License
---
## 🙏 Благодарности
Бот создан с использованием:
- [discord.js](https://discord.js.org/) - Discord API библиотека
- [mysql2](https://github.com/sidorares/node-mysql2) - MySQL драйвер
- [winston](https://github.com/winstonjs/winston) - Система логирования
- [js-yaml](https://github.com/nodeca/js-yaml) - Парсер YAML
---
**Версия**: 1.0.0
**Последнее обновление**: 2024