diff --git a/README.md b/README.md index 8f9156f..f96addd 100644 --- a/README.md +++ b/README.md @@ -3,6 +3,121 @@ Локальная веб-панель CPU для Proxmox. Данные читаются напрямую из `/proc` и `/sys`, без Proxmox API. Интерфейс обновляется каждые две секунды. +## Установка для новичка — скопируйте команды целиком + +### Что потребуется + +- сервер Proxmox VE с доступом в интернет или к `git.myown.center`; +- вход в консоль Proxmox под пользователем `root`; +- IP-адрес Proxmox в локальной сети; +- свободный TCP-порт `9105` между вашим компьютером и Proxmox. + +Go, Node.js, Docker и отдельную базу данных устанавливать не нужно. Панель +поставляется готовым Linux-бинарником, а SQLite встроен внутрь. + +### 1. Подключитесь к Proxmox + +На своём компьютере откройте Terminal и выполните команду, заменив IP на адрес +своего Proxmox: + +```bash +ssh root@192.168.0.10 +``` + +Введите пароль `root`. Следующие команды выполняйте уже внутри Proxmox. + +### 2. Установите панель + +Скопируйте весь блок и вставьте его в консоль Proxmox: + +```bash +apt-get update +apt-get install -y curl ca-certificates tar smartmontools + +cd /tmp +curl -fL \ + https://git.myown.center/maxim/ProxmoxDash/releases/download/latest/proxmox-dashboard-install-amd64.tar.gz \ + -o proxmox-dashboard-install-amd64.tar.gz + +tar -xzf proxmox-dashboard-install-amd64.tar.gz +cd proxmox-dashboard-install +UPDATE_MODE=notify ./scripts/install.sh +``` + +Готово. Установщик сам: + +- положит бинарник в `/usr/local/bin`; +- создаст локальную базу настроек и истории; +- установит systemd-службу; +- запустит панель; +- настроит ежедневную проверку новых версий; +- сохранит предыдущий бинарник при будущем обновлении. + +### 3. Откройте панель + +В браузере на своём компьютере откройте: + +```text +http://192.168.0.10:9105 +``` + +Замените `192.168.0.10` на IP своего Proxmox. Узнать адрес можно командой: + +```bash +hostname -I +``` + +### 4. Проверьте, что всё работает + +```bash +systemctl --no-pager --full status proxmox-cpu-dashboard.service +curl -I http://127.0.0.1:9105 +``` + +В статусе службы должно быть `active (running)`, а локальная проверка должна +вернуть HTTP-ответ `200 OK`. + +### Как обновлять + +В режиме `notify`, установленном командами выше, откройте в панели +`Настройки → Обновления` и нажмите `Проверить и установить обновление`. + +Если нужны полностью автоматические обновления, повторно запустите установщик: + +```bash +cd /tmp/proxmox-dashboard-install +UPDATE_MODE=auto ./scripts/install.sh +``` + +### Если репозиторий станет приватным + +Создайте в Gitea токен только для чтения репозитория и передайте его +установщику. Вместо текста `ВАШ_ТОКЕН` вставьте настоящий токен: + +```bash +cd /tmp/proxmox-dashboard-install +GITEA_TOKEN='ВАШ_ТОКЕН' UPDATE_MODE=notify ./scripts/install.sh +``` + +Токен сохраняется на Proxmox с правами `0600` и не показывается в браузере. + +### Если страница не открывается + +Выполните на Proxmox: + +```bash +systemctl restart proxmox-cpu-dashboard.service +systemctl --no-pager --full status proxmox-cpu-dashboard.service +journalctl -u proxmox-cpu-dashboard.service -n 100 --no-pager +ss -lntp | grep 9105 +``` + +Проверьте, что используете правильный IP, порт `9105` доступен из локальной +сети, а firewall Proxmox не блокирует подключение. Панель пока не имеет +авторизации — не публикуйте порт `9105` напрямую в интернет. + +--- + Панель показывает: - модель и текущую загрузку CPU;