ProxmoxController

📘 Overview / Обзор

English
ProxmoxController is a Python script that allows you to control your Proxmox server directly from Telegram. It supports listing, starting, stopping, and shutting down virtual machines (VMs), as well as shutting down the host itself.

Русский
ProxmoxController — это Python-скрипт, который позволяет управлять сервером Proxmox напрямую из Telegram. Поддерживается вывод списка виртуальных машин (VM), их запуск, остановка и выключение, а также выключение самого хоста.

---

⚙️ Environment Variables / Переменные окружения

English
Set the following environment variables for the container:

• SERVER_PROXMOX: Proxmox server address
• USERNAME_PROXMOX: Proxmox username
• TOKEN_NAME: Proxmox API token name
• TOKEN_VALUE: Proxmox API token value
• API_TOKEN: Telegram API token
• CHAT_ID: Telegram chat ID
• USERNAME_SERVER: SSH username for host shutdown
• PASSWORD_SERVER: SSH password for host shutdown

Русский
Необходимо задать следующие переменные окружения для контейнера:

• SERVER_PROXMOX: адрес сервера Proxmox
• USERNAME_PROXMOX: имя пользователя Proxmox
• TOKEN_NAME: имя API-токена Proxmox
• TOKEN_VALUE: значение API-токена Proxmox
• API_TOKEN: API-токен Telegram
• CHAT_ID: ID чата в Telegram
• USERNAME_SERVER: имя пользователя SSH для выключения хоста
• PASSWORD_SERVER: пароль SSH для выключения хоста

---

📦 Installation / Установка

Using Docker / Использование Docker

English

docker pull dato1/proxmoxcontroller:latest
docker run \
  -e SERVER_PROXMOX="" \
  -e USERNAME_PROXMOX="" \
  -e TOKEN_NAME="" \
  -e TOKEN_VALUE="" \
  -e API_TOKEN="" \
  -e CHAT_ID="" \
  -e USERNAME_SERVER="" \
  -e PASSWORD_SERVER="" \
  <ID-of-Container>

**Русский**

```bash
docker pull dato1/proxmoxcontroller:latest
docker run \
  -e SERVER_PROXMOX="" \
  -e USERNAME_PROXMOX="" \
  -e TOKEN_NAME="" \
  -e TOKEN_VALUE="" \
  -e API_TOKEN="" \
  -e CHAT_ID="" \
  -e USERNAME_SERVER="" \
  -e PASSWORD_SERVER="" \
  <ID-контейнера>

---

Using Docker Compose / Использование Docker Compose

English

services:
  proxmox-controller:
    environment:
      - SERVER_PROXMOX=
      - USERNAME_PROXMOX=
      - TOKEN_NAME=
      - TOKEN_VALUE=
      - API_TOKEN=
      - CHAT_ID=
      - USERNAME_SERVER=
      - PASSWORD_SERVER=
    image: dato1/proxmoxcontroller:latest
    restart: unless-stopped
networks: {}

Run:

docker compose up -d

Русский

services:
  proxmox-controller:
    environment:
      - SERVER_PROXMOX=
      - USERNAME_PROXMOX=
      - TOKEN_NAME=
      - TOKEN_VALUE=
      - API_TOKEN=
      - CHAT_ID=
      - USERNAME_SERVER=
      - PASSWORD_SERVER=
    image: dato1/proxmoxcontroller:latest
    restart: unless-stopped
networks: {}

Запуск:

docker compose up -d

---

🤖 Telegram Bot Commands / Команды Telegram-бота

English

• /start – Start the bot
• /list – List all VMs
• /startvm <VMID> – Start a VM
• /stopvm <VMID> – Stop a VM
• /startall – Start all VMs
• /stopall – Stop all VMs
• /shutdown – Shutdown all VMs and then shutdown the Proxmox host

Русский

• /start – Запуск бота
• /list – Показать список всех VM
• /startvm <VMID> – Запустить VM
• /stopvm <VMID> – Остановить VM
• /startall – Запустить все VM
• /stopall – Остановить все VM
• /shutdown – Остановить все VM и выключить Proxmox-хост