Бот принимает сообщения на вашем ноутбуке, кнопки работают, заказчик посмотрел демонстрацию. Следующий этап — залить бота на сервер и передать проект так, чтобы им можно было пользоваться без вашего компьютера. Здесь понадобятся рабочее окружение, постоянное хранение данных, автозапуск и понятная инструкция для владельца.
Разберём порядок для небольшого Telegram-бота на Python и Linux VPS с systemd. Это один вариант размещения: у контейнерного приложения или управляемой платформы запуск будет устроен иначе. Задача исполнителя — выбрать подходящий способ, проверить его и зафиксировать, как обслуживать результат.
Что согласовать до переноса бота
Сначала определите границы работы. «Разместить на сервере» может означать только первый запуск либо также настройку копий, наблюдение за ошибками и дальнейшие обновления. Запишите состав результата до начала переноса, чтобы у заказчика и исполнителя были одинаковые ожидания.
- Владельцы ресурсов. Кто управляет ботом, аккаунтом хостинга, доменом, базой и внешними сервисами.
- Регулярные расходы. Кто оплачивает сервер и используемые API, куда приходят уведомления об оплате.
- Доступы. Какие полномочия нужны исполнителю на время работы и какие останутся после передачи.
- Поддержка. Кто разбирает сбои после запуска и какие изменения заказываются отдельно.
Практичный вариант — создавать рабочие ресурсы в аккаунтах заказчика и выдавать исполнителю отдельный доступ. Тогда окончание сотрудничества не потребует переносить весь проект из личного кабинета разработчика.
1. Подготовьте версию, которую будете размещать
Выберите конкретную проверенную версию исходников: например, зафиксируйте её коммитом в Git. Уберите из комплекта тестовые выгрузки с реальными контактами и случайные файлы с компьютера. Для примеров используйте вымышленные данные.
Рядом с кодом сохраните список зависимостей и используемую версию Python, команду запуска, названия обязательных настроек. Шаблон конфигурации должен объяснять, какие значения требуются, и обходиться без действующих токенов и паролей. Проверьте, что эти секреты также не попали в историю репозитория.
Разделите программу и её данные. Если заявки сохраняются в SQLite или другом хранилище, запишите путь к нему и порядок обновления. Замена папки с исходниками не должна случайно удалять накопленные обращения. До переноса определите, нужна ли миграция существующей базы.
2. Подготовьте VPS для бота
Настройка VPS для бота начинается с требований самого приложения. Уточните совместимую ОС, версию среды, объём данных, фоновые задачи и внешние подключения. Если бот обращается к стороннему ИИ API, это отличается по ресурсам от запуска модели на самом сервере. Универсальный тариф по одному слову «бот» выбрать нельзя.
Подключитесь к новому серверу, установите необходимые обновления и создайте отдельного системного пользователя для приложения. Настройте вход по SSH-ключу и сетевые правила под выбранный способ работы. Прежде чем менять доступ по SSH, убедитесь, что новый вход работает и доступна консоль восстановления хостинга.
Заранее выделите каталог программы и место для постоянных данных. Пользователю приложения нужны разрешения на чтение кода и запись туда, где бот действительно сохраняет файлы. Полные административные права для обычной работы ему выдавать не требуется.
3. Загрузите код и соберите окружение
Передайте выбранную версию через SFTP или получите её из закрытого репозитория. Не размещайте архив с исходниками и настройками в публично доступной папке сайта. На сервере создайте отдельное виртуальное окружение Python и установите зависимости проекта из подготовленного списка.
Добавьте рабочие настройки выбранным способом и сначала выполните пробный запуск. Проверьте доступ к Telegram, базе и другим используемым сервисам. Если появляется ошибка, сохраните её текст без секретов и устраните причину до настройки автозапуска.
Для проверки удобно иметь отдельного тестового бота. Он позволяет проверить команды и уведомления, не отправляя пробные заявки действующим пользователям. Рабочий токен подключайте в согласованный момент перехода.
4. Проверьте способ получения сообщений
У Telegram Bot API два взаимоисключающих способа получать обновления: long polling через getUpdates и webhook, на который Telegram отправляет запросы. При установленном webhook получать сообщения через getUpdates нельзя. Это ограничение указано в официальной документации Telegram.
Сохраните в инструкции выбранный режим. Для webhook проверьте доступность HTTPS-адреса и настройки его обработки. При переносе polling-бота остановите прежний процесс на ноутбуке или старом сервере перед рабочим запуском новой копии. Так вы исключите ситуацию, когда за одним ботом одновременно обращаются две независимые копии приложения.
Меняйте способ получения обновлений осознанно: сначала уточните текущую настройку и судьбу необработанных сообщений. Не сбрасывайте очередь заявок только ради устранения ошибки запуска.
5. Настройте автозапуск скрипта на сервере
Для Linux с systemd можно оформить бота как отдельную службу. В её конфигурации задаются пользователь, рабочая папка и команда запуска. Политика Restart=on-failure предусматривает повторный запуск после определённых сбоев; перезапуски ограничиваются настройками службы и не исправляют ошибку программы. Подробности — в документации systemd.service.
Например, в конфигурации конкретного Python-проекта будут указаны путь к интерпретатору из виртуального окружения и файл входа приложения. Проверьте также рабочий каталог и способ передачи настроек: окружение службы может отличаться от интерактивного терминала. Параметры описаны в документации окружения systemd.
После создания службы её нужно запустить и отдельно включить запуск при загрузке ОС. Допустим, вы назвали её client-bot.service. Тогда для такой уже настроенной службы используются:
sudo systemctl enable --now client-bot.service— включить автозапуск и запустить сейчас;sudo systemctl status client-bot.service— посмотреть состояние;sudo systemctl restart client-bot.service— перезапустить после согласованных изменений.
Замените имя на настоящее имя своей службы. Эти команды предполагают готовую корректную конфигурацию и соответствующие права на сервере. Различие между включением и запуском объясняется в справке systemctl.
6. Проверьте бота после отключения SSH и перезагрузки
Закройте SSH-сеанс и выполните основной пользовательский сценарий. Затем в согласованное время перезагрузите сервер и повторите проверку. Сам факт состояния active у службы ещё не показывает, что пользователь получает нужный результат.
Для бота приёма заявок учебный сценарий может выглядеть так:
- Новый пользователь открывает бота и начинает оформление.
- Вводит вымышленные контактные данные и описание задачи.
- Отправляет заявку и получает подтверждение.
- Администратор видит одно новое обращение с заполненными полями.
- После перезапуска службы обращение остаётся в хранилище.
Отдельно проверьте неверный ввод, отказ внешнего сервиса и повторное нажатие кнопки отправки. Запишите фактический результат и известные ограничения. Для ошибок должен быть понятен путь диагностики: журнал службы или журнал приложения, без токенов и лишних пользовательских данных.
7. Подготовьте копии и порядок обновления
Составьте список того, что потребуется для восстановления: исходники, настройки, база и загруженные пользователями файлы, если они есть. Укажите место хранения копий, расписание и человека, который проверяет их создание. Копию храните отдельно от единственного рабочего сервера.
Проверьте восстановление на отдельном тестовом окружении, не подключая его к рабочему токену. Для базы используйте подходящий ей способ согласованного резервного копирования. Простое копирование произвольных файлов во время записи не заменяет проверенную процедуру.
Обновление тоже опишите по шагам: сделать копию, сохранить текущую версию, установить новую, выполнить необходимые миграции и проверить сценарий. Если меняется структура базы, заранее определите, как восстанавливать и код, и данные. Возврата старой папки с программой для этого может быть недостаточно.
Что передать заказчику вместе с работающим ботом
Соберите материалы в одном месте. Заказчику пригодится короткая инструкция для повседневной работы, а следующему разработчику — техническая часть для сопровождения. В README можно описать назначение проекта и начало работы: такой формат рекомендует и документация GitHub.
- Исходники или доступ к репозиторию с обозначенной рабочей версией.
- Адрес сервера, каталог проекта, имя службы и местонахождение данных.
- Список настроек и порядок получения секретов через согласованный закрытый канал.
- Инструкцию по запуску, остановке, обновлению и поиску ошибок.
- Порядок резервного копирования и восстановления.
- Результаты приёмки, ограничения и согласованные условия поддержки.
Попросите заказчика проверить вход в свои аккаунты и выполнение доступных ему действий. Отдельно подтвердите доступ к управлению ботом: знание токена не означает владения всеми ресурсами проекта. После приёмки приведите доступы исполнителя в соответствие с условиями дальнейшей поддержки.
Как оформить отдельную задачу на запуск бота
Если код готов, а с сервером нужна помощь, можно обратиться к специалисту по деплою и публикации. В заявке полезнее описать текущее состояние и ожидаемый результат, чем ограничиваться фразой «нужно поставить бота».
Пример заявки: «Есть Telegram-бот на Python, локально принимает обращения и сохраняет их в SQLite. Нужно разместить его на Linux VPS в моём аккаунте, настроить службу, автозапуск и резервные копии. Приёмка: бот отвечает после отключения SSH и перезагрузки, новая заявка приходит администратору один раз, сохранённые обращения остаются на месте. Нужны исходники и инструкция по обновлению и восстановлению. Версию Python, зависимости и режим получения сообщений уточню по проекту».
Это учебный пример, который нужно адаптировать под реальное приложение. В открытом описании укажите технологии, используемые сервисы, готовность сервера и желаемый срок. Токены, пароли и содержимое рабочей базы передавайте отдельно.
Разместить задачу на НейроБирже можно и для отдельного этапа: переноса готового бота, настройки автозапуска или проверки восстановления. Чем точнее описаны исходные условия и приёмка, тем предметнее получится обсуждение с исполнителем.