mirror of
https://github.com/andrey271192/amnezia_web-PRO.git
synced 2026-09-20 14:42:00 +00:00
docs: add PROJECT_INDEX.md
Указатель проекта по регламенту синхронизации: пути, состав репозитория, порты и переменные, известные грабли, текущее состояние. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
68
PROJECT_INDEX.md
Normal file
68
PROJECT_INDEX.md
Normal file
@@ -0,0 +1,68 @@
|
|||||||
|
# PROJECT_INDEX — amnezia_web-PRO
|
||||||
|
|
||||||
|
Указатель проекта. Обновляется в конце каждой законченной работы вместе с
|
||||||
|
заметкой `09. История решений и грабли` и пушем в GitHub.
|
||||||
|
|
||||||
|
## Где что лежит
|
||||||
|
|
||||||
|
| Что | Где |
|
||||||
|
|---|---|
|
||||||
|
| Папка проекта | `/Volumes/ssd/Мои проекты/amnezia_web-PRO/` |
|
||||||
|
| Заметки | Apple Notes → `МОИ ПРОЕКТЫ` → папка `amnezia_web-PRO` |
|
||||||
|
| GitHub (публичный) | https://github.com/andrey271192/amnezia_web-PRO |
|
||||||
|
| Ветка прода | `main` |
|
||||||
|
| Тестовая копия рядом | `/Volumes/ssd/Мои проекты/amnezia_web-PRO_test/` |
|
||||||
|
|
||||||
|
Путь `/Volumes/andrey/Мои проекты/...` из старого промпта синхронизации **не существует** —
|
||||||
|
актуальная копия только на `/Volumes/ssd`.
|
||||||
|
|
||||||
|
## Состав репозитория
|
||||||
|
|
||||||
|
| Путь | Что это |
|
||||||
|
|---|---|
|
||||||
|
| `server.js` | Бэкенд панели (Node), порт контейнера 3980 |
|
||||||
|
| `public/` | Фронтенд админки |
|
||||||
|
| `landing/` | Публичная страница для приглашённых: `index.html`, `styles.css`, `nginx.conf`, `Dockerfile`, `admin-port.js` (порт админки для кнопки, пересобирается установщиком) |
|
||||||
|
| `Dockerfile` | Образ `amnezia-admin:latest` |
|
||||||
|
| `scripts/install.sh` | Установщик: сборка образов, запуск контейнеров, диагностика AmneziaWG |
|
||||||
|
| `scripts/uninstall.sh` | Снос панели и лендинга |
|
||||||
|
| `scripts/awg-instance.sh` | Работа с инстансами AmneziaWG |
|
||||||
|
| `scripts/clients-meta.mjs` | Снимок метаданных клиентов (имена, даты) поверх `clientsTable` |
|
||||||
|
| `scripts/test-clients-meta.mjs` | Тест к нему |
|
||||||
|
| `scripts/warp-amnezia.sh` | Обвязка WARP |
|
||||||
|
| `docs/panel-guide.md` | Руководство по панели |
|
||||||
|
| `README.md` | Порты, переменные окружения, установка, обновление |
|
||||||
|
|
||||||
|
Незакоммиченные разовые скрипты разбора в корне (`audit2.py`, `audit_conf.py`,
|
||||||
|
`check_conf.py`, `check_garbage.py`, `test_create.py`) — отладочные, в git не входят.
|
||||||
|
|
||||||
|
## Установка
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -fsSL https://raw.githubusercontent.com/andrey271192/amnezia_web-PRO/main/scripts/install.sh | sudo bash
|
||||||
|
```
|
||||||
|
|
||||||
|
Первый вход: `admin` / `admin`, пароль сменить сразу.
|
||||||
|
|
||||||
|
## Порты и ключевые переменные
|
||||||
|
|
||||||
|
| Переменная | По умолчанию | Смысл |
|
||||||
|
|---|---|---|
|
||||||
|
| `HOST_PORT` | `8080` | Админ-панель |
|
||||||
|
| `LANDING_PORT` | `80` | Публичная страница |
|
||||||
|
| `SKIP_LANDING` | `0` | `1` — не поднимать лендинг |
|
||||||
|
| `LANDING_CONTAINER` | `amnezia-web-landing` | Имя контейнера лендинга |
|
||||||
|
| `CONTAINER_NAME` | `amnezia-admin` | Имя контейнера панели |
|
||||||
|
|
||||||
|
## Грабли, которые стоят времени
|
||||||
|
|
||||||
|
- **Контейнеры переживают переустановку.** Всё поднимается с `--restart unless-stopped`.
|
||||||
|
`SKIP_LANDING=1` на повторной установке не отключал лендинг, пока установщик не начал
|
||||||
|
сносить старый контейнер в ветке пропуска (`7b92bfb`, 08.09.2026). Проверка:
|
||||||
|
`docker ps --filter name=amnezia-web-landing`.
|
||||||
|
- **Коммиты сами в контейнер не попадают** — нужна пересборка образа, см. README.
|
||||||
|
- Разбор остальных случаев — в заметке `09. История решений и грабли`.
|
||||||
|
|
||||||
|
## Состояние
|
||||||
|
|
||||||
|
- HEAD `7b92bfb` (08.09.2026), совпадает с `origin/main`.
|
||||||
Reference in New Issue
Block a user