mirror of
https://github.com/ada-dmitry/remote-control.git
synced 2026-09-24 01:10:38 +00:00
123 lines
4.4 KiB
Markdown
123 lines
4.4 KiB
Markdown
# 🔌 Wake-on-LAN Telegram Bot
|
||
|
||
Простой и удобный Telegram-бот для удалённого включения компьютера с помощью технологии Wake-on-LAN.
|
||
|
||
## 📋 Функции
|
||
|
||
- Включение компьютера удалённо через команду `/wake`
|
||
- Проверка доступа по ID пользователя
|
||
- Безопасное хранение конфигурации в переменных окружения
|
||
|
||
## 🚀 Быстрый старт
|
||
|
||
### Требования
|
||
|
||
- Python 3.7+
|
||
- Компьютер с поддержкой Wake-on-LAN
|
||
- Telegram Bot Token
|
||
|
||
### Установка
|
||
|
||
1. **Клонируйте репозиторий:**
|
||
```bash
|
||
git clone https://github.com/ada-dmitry/remote-control
|
||
cd remote-control
|
||
```
|
||
|
||
2. **Установите зависимости:**
|
||
> Рекомендуется использование виртуального окружения Pyvenv.
|
||
```bash
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
3. **Создайте файл `.env`:**
|
||
```env
|
||
BOT_TOKEN=your_telegram_bot_token_here
|
||
PC_MAC=XX:XX:XX:XX:XX:XX
|
||
ALLOWED_USER_IDS=123456789,987654321
|
||
```
|
||
|
||
4. **Запустите бота:**
|
||
```bash
|
||
python main.py
|
||
```
|
||
|
||
4.1. По необходимости, можно добавить бота в systemd.
|
||
|
||
## ⚙️ Настройка
|
||
|
||
### Переменные окружения
|
||
|
||
| Переменная | Описание | Пример |
|
||
|------------|----------|--------|
|
||
| `BOT_TOKEN` | Токен Telegram-бота | `1234567890:ABCdefGHIjklMNOpqrsTUVwxyz` |
|
||
| `PC_MAC` | MAC-адрес целевого компьютера | `AA:BB:CC:DD:EE:FF` |
|
||
| `ALLOWED_USER_IDS` | ID пользователей через запятую | `123456789,987654321` |
|
||
|
||
### Настройка Wake-on-LAN
|
||
|
||
1. **В BIOS/UEFI:** Включите Wake-on-LAN (может называться "Wake on Magic Packet")
|
||
2. **В Windows:**
|
||
- Откройте Диспетчер устройств
|
||
- Найдите сетевой адаптер → Свойства → Управление питанием
|
||
- Включите "Разрешить этому устройству выводить компьютер из ждущего режима"
|
||
|
||
### Получение MAC-адреса
|
||
|
||
**Windows:**
|
||
```cmd
|
||
ipconfig /all
|
||
```
|
||
|
||
**Linux/macOS:**
|
||
```bash
|
||
ifconfig
|
||
```
|
||
|
||
### Создание Telegram-бота
|
||
|
||
1. Найдите @BotFather в Telegram
|
||
2. Отправьте `/newbot`
|
||
3. Следуйте инструкциям
|
||
4. Скопируйте полученный токен
|
||
|
||
### Получение Telegram User ID
|
||
|
||
1. Найдите @userinfobot в Telegram
|
||
2. Отправьте `/start`
|
||
3. Скопируйте ваш User ID
|
||
|
||
## 🛡️ Безопасность
|
||
|
||
- Токен бота и другие чувствительные данные хранятся в переменных окружения
|
||
- Доступ к команде ограничен списком разрешённых пользователей
|
||
- Не добавляйте файл `.env` в систему контроля версий
|
||
|
||
## 📝 Использование
|
||
|
||
После запуска бота отправьте команду `/wake` в чат с ботом. Если ваш ID в списке разрешённых пользователей, бот отправит Magic Packet для включения компьютера.
|
||
|
||
## 🔧 Требования к сети
|
||
|
||
- Компьютер и устройство с ботом должны находиться в одной локальной сети
|
||
- Роутер должен поддерживать передачу Magic Packet
|
||
- Может потребоваться настройка портов в роутере для удалённого доступа
|
||
|
||
## 📦 Зависимости
|
||
|
||
- `python-telegram-bot` - для работы с Telegram API
|
||
- `wakeonlan` - для отправки Magic Packet
|
||
- `python-dotenv` - для загрузки переменных окружения
|
||
|
||
## 🤝 Поддержка
|
||
|
||
Если у вас возникли проблемы:
|
||
1. Убедитесь, что Wake-on-LAN включен в BIOS
|
||
2. Проверьте правильность MAC-адреса
|
||
3. Убедитесь, что устройства в одной сети
|
||
4. Проверьте настройки сетевого адаптера
|
||
|
||
## 📄 Лицензия
|
||
|
||
MIT License
|