Add beginner installation guide
This commit is contained in:
115
README.md
115
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;
|
||||
|
||||
Reference in New Issue
Block a user