Add beginner installation guide

This commit is contained in:
Maxim
2026-08-01 13:57:25 +03:00
parent f1356fec37
commit b21377337b

115
README.md
View File

@@ -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;