Пошаговая установка Target Assistant Bot
Детальное руководство с объяснениями каждого шага
- 🔍 Проверка требований
- 🛠️ Подготовка системы
- 🐍 Установка Python 3.11
- 👤 Создание пользователя
- 📦 Установка бота
- ⚙️ Настройка конфигурации
- 🚀 Первый запуск
- 🔧 Настройка автозапуска
- 🐳 Docker альтернатива
- ❓ Решение проблем
- ОС: Ubuntu 20.04+ или Debian 11+
- RAM: 512 MB минимум (рекомендуется 1 GB)
- Диск: 1 GB свободного места
- CPU: 1 ядро (рекомендуется 2)
- Сеть: Стабильное интернет-соединение
# Проверка версии Ubuntu
lsb_release -a
# Проверка свободного места
df -h
# Проверка оперативной памяти
free -h
# Проверка процессора
lscpu# Обновление списка пакетов
sudo apt update
# Обновление установленных пакетов
sudo apt upgrade -y
# Установка базовых утилит
sudo apt install -y curl wget git nano htop# Установка ufw если не установлен
sudo apt install -y ufw
# Разрешение SSH (если используете)
sudo ufw allow ssh
# Включение файрвола
sudo ufw enable# Установка Python 3.11
sudo apt install -y python3.11 python3.11-venv python3.11-dev
# Проверка версии
python3.11 --version# Добавление репозитория
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
# Установка Python 3.11
sudo apt install -y python3.11 python3.11-venv python3.11-dev
# Установка pip для Python 3.11
curl -sS https://bootstrap.pypa.io/get-pip.py | python3.11# Должно вывести: Python 3.11.x
python3.11 --version
# Проверка pip
python3.11 -m pip --version- 🔒 Безопасность: изоляция процесса бота
- 📁 Организация: все файлы в одном месте
- 🔧 Управление: легко управлять правами
# Создание пользователя targetbot
sudo useradd -m -s /bin/bash targetbot
# Установка пароля (опционально)
sudo passwd targetbot
# Добавление в группу sudo (если нужно)
sudo usermod -aG sudo targetbot
# Переключение на пользователя
sudo -u targetbot -i# Переход в домашнюю директорию
cd ~
# Клонирование репозитория
git clone https://github.com/bivlked/target-assistant-bot.git
# Переход в папку проекта
cd target-assistant-bot# Создание venv
python3.11 -m venv .venv
# Активация venv
source .venv/bin/activate
# Обновление pip
pip install --upgrade pip# Установка production зависимостей
pip install -r requirements.txt
# Для разработки (опционально)
pip install -r requirements-dev.txt# Копирование примера
cp .env.example .env
# Редактирование файла
nano .env# Telegram Bot
TELEGRAM_BOT_TOKEN=YOUR_BOT_TOKEN_HERE
# OpenAI API
OPENAI_API_KEY=sk-YOUR_OPENAI_KEY_HERE
# Google Sheets
GOOGLE_CREDENTIALS_PATH=google_credentials.json
# Опциональные параметры
SENTRY_DSN=https://YOUR_SENTRY_DSN_HERE
PROMETHEUS_PORT=8000
LOG_LEVEL=INFO- Перейдите в Google Cloud Console
- Создайте новый проект или выберите существующий
- Включите Google Sheets API
- Создайте Service Account
- Скачайте JSON ключ
# Создайте файл google_credentials.json
nano google_credentials.json
# Вставьте содержимое скачанного JSON файла
# Сохраните: Ctrl+X, Y, Enter
# Проверка прав доступа
chmod 600 google_credentials.json# Активируйте venv если не активирован
source .venv/bin/activate
# Запустите скрипт настройки
python setup_commands.py# Активация venv
source .venv/bin/activate
# Запуск бота
python main.py- Откройте Telegram
- Найдите вашего бота по username
- Отправьте команду
/start - Бот должен ответить приветствием
# Логи выводятся в консоль
# Для выхода: Ctrl+C
# Запуск в фоне с логами
nohup python main.py > bot.log 2>&1 &
# Просмотр логов
tail -f bot.log# Вернитесь под обычного пользователя
exit
# Создайте файл сервиса
sudo nano /etc/systemd/system/targetbot.service[Unit]
Description=Target Assistant Bot
After=network.target
[Service]
Type=simple
User=targetbot
WorkingDirectory=/home/targetbot/target-assistant-bot
Environment="PATH=/home/targetbot/target-assistant-bot/.venv/bin"
ExecStart=/home/targetbot/target-assistant-bot/.venv/bin/python main.py
Restart=always
RestartSec=10
[Install]
WantedBy=multi-user.target# Перезагрузка systemd
sudo systemctl daemon-reload
# Включение автозапуска
sudo systemctl enable targetbot
# Запуск сервиса
sudo systemctl start targetbot
# Проверка статуса
sudo systemctl status targetbot# Остановка
sudo systemctl stop targetbot
# Перезапуск
sudo systemctl restart targetbot
# Просмотр логов
sudo journalctl -u targetbot -f# Установка Docker одной командой
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
# Добавление пользователя в группу docker
sudo usermod -aG docker $USER
# Перелогиньтесь для применения изменений
exit
# Войдите снова# Клонирование репозитория
git clone https://github.com/bivlked/target-assistant-bot.git
cd target-assistant-bot
# Настройка конфигурации
cp .env.example .env
nano .env
# Добавление google_credentials.json
nano google_credentials.json
# Запуск
docker compose up -d
# Просмотр логов
docker compose logs -f# Остановка
docker compose down
# Перезапуск
docker compose restart
# Обновление
docker compose pull
docker compose up -d# Убедитесь, что venv активирован
source .venv/bin/activate
# Переустановите зависимости
pip install -r requirements.txt# Проверьте права на файлы
ls -la
# Исправьте владельца
sudo chown -R targetbot:targetbot /home/targetbot/target-assistant-bot- Проверьте токен бота в .env
- Проверьте интернет-соединение
- Проверьте логи:
sudo journalctl -u targetbot -n 100
- Проверьте google_credentials.json
- Убедитесь, что Google Sheets API включен
- Проверьте права Service Account