remote-control/README.md

🔌 Wake-on-LAN Telegram Bot

Простой и удобный Telegram-бот для удалённого включения компьютера с помощью технологии Wake-on-LAN.

📋 Функции

• Включение компьютера удалённо через команду /wake
• Проверка доступа по ID пользователя
• Безопасное хранение конфигурации в переменных окружения

🚀 Быстрый старт

Требования

• Python 3.7+
• Компьютер с поддержкой Wake-on-LAN
• Telegram Bot Token

Установка

1. Клонируйте репозиторий:

   git clone https://github.com/ada-dmitry/remote-control
   cd remote-control
   

2. Установите зависимости:

Рекомендуется использование виртуального окружения Pyvenv.

pip install -r requirements.txt

3. Создайте файл .env:

   BOT_TOKEN=your_telegram_bot_token_here
   PC_MAC=XX:XX:XX:XX:XX:XX
   ALLOWED_USER_IDS=123456789,987654321
   

4. Запустите бота:

   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:

ipconfig /all

Linux/macOS:

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