amnezia-web-pro-deploy/README.md

# Amnezia Web PRO Deploy

Публичный установщик для **Amnezia Web PRO** на VPS. Репозиторий нужен, чтобы пользователи ставили панель одной командой без доступа к private GHCR image и без ошибки `403 Forbidden`.

По умолчанию установка идёт из открытого source repo:

- source: [`andrey271192/amnezia_web-PRO_test`](https://github.com/andrey271192/amnezia_web-PRO_test);
- текущий релиз: `v1.5.2`;
- old GHCR image больше не используется по умолчанию;
- legacy GHCR mode оставлен только вручную через `USE_GHCR=1`.

## Что делает установщик

- скачивает актуальный `install.sh` из `amnezia_web-PRO_test`;
- ставит Docker, если его нет;
- разворачивает панель в `/opt/amnezia-web-pro`;
- создаёт `.env`;
- собирает и запускает Docker Compose stack;
- поддерживает явный первый пароль admin через `ADMIN_PASSWORD`;
- не требует GHCR PAT для обычной установки.

## Быстрая установка

На VPS от root:

```bash
curl -fsSL https://raw.githubusercontent.com/andrey271192/amnezia-web-pro-deploy/main/quick-install.sh | sudo bash
```

То же самое с явным первым паролем admin:

```bash
curl -fsSL https://raw.githubusercontent.com/andrey271192/amnezia-web-pro-deploy/main/quick-install.sh \
  | sudo ADMIN_PASSWORD='СЛОЖНЫЙ_ПАРОЛЬ' bash
```

`quick-install.sh` скачает и запустит рабочий установщик:

```bash
https://raw.githubusercontent.com/andrey271192/amnezia_web-PRO_test/main/install.sh
```

## Почему больше не GHCR

Старый сценарий тянул private image:

```text
ghcr.io/andrey271192/amnezia-admin-pro:v1.0.0
```

Если у GitHub PAT нет доступа к package или package закрыт, Docker показывает:

```text
unexpected status ... 403 Forbidden
```

Это не ошибка VPS и не ошибка Docker. Это отказ GitHub Container Registry. Чтобы не ловить эту ошибку у подписчиков, обычная установка теперь идёт из GitHub source.

Предупреждение Docker:

```text
WARNING! Your credentials are stored unencrypted in '/root/.docker/config.json'
```

не является причиной ошибки. Это только предупреждение Docker.

## Legacy GHCR mode

Оставлен только для ручного использования, если у вас реально есть доступ к package:

```bash
USE_GHCR=1 curl -fsSL https://raw.githubusercontent.com/andrey271192/amnezia-web-pro-deploy/main/quick-install.sh | sudo -E bash
```

или:

```bash
USE_GHCR=1 sudo -E bash scripts/install.sh
```

Нужны:

- GitHub PAT с `read:packages`;
- доступ к package `ghcr.io/andrey271192/amnezia-admin-pro`;
- существующий tag из `PRO_IMAGE_TAG`.

## Проблемы и решения

### `403 Forbidden` при `docker pull ghcr.io/...`

Причина: старый GHCR-сценарий пытается скачать private image, а у token нет доступа к package.

Решение: используйте обычную установку без GHCR:

```bash
curl -fsSL https://raw.githubusercontent.com/andrey271192/amnezia-web-pro-deploy/main/quick-install.sh | sudo bash
```

### `Login Succeeded`, но pull всё равно падает

`docker login` проверяет только логин/token. Он не гарантирует доступ к конкретному package.

Решение: не используйте GHCR-режим. Если GHCR всё-таки нужен, проверьте:

- PAT имеет `read:packages`;
- GitHub account имеет доступ к package;
- package не private для этого пользователя;
- tag из `PRO_IMAGE_TAG` реально опубликован.

### `WARNING! Your credentials are stored unencrypted`

Это предупреждение Docker, не ошибка установки. Оно не вызывает `403 Forbidden`.

### `Docker daemon недоступен`

Docker установлен, но сервис не запущен.

```bash
sudo systemctl enable --now docker
docker info
```

### `docker compose` не найден

Обычный source installer сам ставит Docker Compose plugin. Если запускаете legacy GHCR mode вручную, обновите Docker/Compose:

```bash
sudo apt-get update
sudo apt-get install -y docker-compose-plugin
docker compose version
```

### Порт панели занят

Укажите другой порт при установке основного проекта:

```bash
NGINX_HTTP_PORT=8081 curl -fsSL https://raw.githubusercontent.com/andrey271192/amnezia_web-PRO_test/main/install.sh | sudo -E bash
```

### Не входит в панель после переустановки

Задайте новый пароль admin явно:

```bash
curl -fsSL https://raw.githubusercontent.com/andrey271192/amnezia_web-PRO_test/main/install.sh \
  | sudo ADMIN_PASSWORD='НОВЫЙ_ПАРОЛЬ' bash
```

### Нужна полная переустановка

Удалите панель с данными и поставьте заново:

```bash
curl -fsSL https://raw.githubusercontent.com/andrey271192/amnezia_web-PRO_test/main/uninstall.sh \
  | sudo REMOVE_DATA=1 REMOVE_DIR=1 bash
curl -fsSL https://raw.githubusercontent.com/andrey271192/amnezia-web-pro-deploy/main/quick-install.sh | sudo bash
```

## Удаление

Обычная остановка панели:

```bash
curl -fsSL https://raw.githubusercontent.com/andrey271192/amnezia_web-PRO_test/main/uninstall.sh | sudo bash
```

Полная очистка с данными:

```bash
curl -fsSL https://raw.githubusercontent.com/andrey271192/amnezia_web-PRO_test/main/uninstall.sh \
  | sudo REMOVE_DATA=1 REMOVE_DIR=1 bash
```

## Обновление

В панели: **Настройки → О программе и обновления → Проверить обновления**.

Доступно:

- release channel;
- beta channel;
- выбор версии;
- rollback на старый tag.

Ручное обновление source-установки:

```bash
cd /opt/amnezia-web-pro
git pull
docker compose build
docker compose up -d
```

## Поддержка проекта

- GitHub: [andrey271192/amnezia_web-PRO_test](https://github.com/andrey271192/amnezia_web-PRO_test)
- Boosty: [boosty.to/andrey27/donate](https://boosty.to/andrey27/donate)
- Telegram: [@lot_andrey](https://t.me/lot_andrey)