From b6ecf43079de0438c9c0814e542e3b5e06d7eeac Mon Sep 17 00:00:00 2001
From: admin <admin@evilfox.cc>
Date: Fri, 17 Apr 2026 00:23:17 +0000
Subject: [PATCH] =?UTF-8?q?=D0=97=D0=B0=D0=B3=D1=80=D1=83=D0=B7=D0=B8?=
 =?UTF-8?q?=D1=82=D1=8C=20=D1=84=D0=B0=D0=B9=D0=BB=D1=8B=20=D0=B2=20=C2=AB?=
 =?UTF-8?q?/=C2=BB?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 help.txt | 100 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 100 insertions(+)
 create mode 100644 help.txt

diff --git a/help.txt b/help.txt
new file mode 100644
index 0000000..5da70bb
--- /dev/null
+++ b/help.txt
@@ -0,0 +1,100 @@
+================================================================================
+  Установка файлообменника (текстовая справка)
+================================================================================
+
+Сервер на Go, база PostgreSQL, запуск через Docker Compose.
+Порт приложения по умолчанию: 8090.
+
+Веб-версия этой инструкции: http://localhost:8090/help.html
+
+
+1. Что нужно
+--------------------------------------------------------------------------------
+
+  - Docker и Docker Compose (в Docker Desktop для Windows уже есть Compose).
+  - Исходники проекта (каталог с docker-compose.yml, Dockerfile и скриптами
+    установки).
+
+
+2. Windows (PowerShell)
+--------------------------------------------------------------------------------
+
+В каталоге проекта выполните:
+
+  .\install.ps1
+
+Скрипт проверит наличие Docker, при отсутствии файла .env скопирует его из
+.env.example, затем выполнит сборку и запуск контейнеров.
+
+
+3. Linux и macOS
+--------------------------------------------------------------------------------
+
+Сделайте скрипт исполняемым и запустите:
+
+  chmod +x install.sh
+  ./install.sh
+
+
+4. Установка вручную
+--------------------------------------------------------------------------------
+
+  1) Скопируйте .env.example в .env.
+  2) Откройте .env и задайте надёжный POSTGRES_PASSWORD (для Docker это пароль
+     пользователя PostgreSQL).
+  3) В том же каталоге выполните:
+
+  docker compose up -d --build
+
+При первом запуске образ приложения соберётся, поднимется PostgreSQL и сервис
+с файлообменником.
+
+
+5. Файл .env
+--------------------------------------------------------------------------------
+
+  POSTGRES_PASSWORD — пароль БД (должен совпадать с тем, что подставляется в
+                      строку подключения в Compose).
+  MAX_UPLOAD_MB     — необязательно; лимит размера загрузки в мегабайтах
+                      (по умолчанию 100).
+  PUBLIC_BASE_URL   — если сервер за обратным прокси с другим хостом/HTTPS,
+                      можно указать публичный базовый URL для корректных
+                      ссылок в API.
+
+
+6. После установки
+--------------------------------------------------------------------------------
+
+  - Откройте в браузере: http://localhost:8090/
+  - Проверка работы и версии: http://localhost:8090/health
+    (JSON: статус и поле version).
+
+
+7. Остановка и данные
+--------------------------------------------------------------------------------
+
+Остановить контейнеры:
+
+  docker compose down
+
+Файлы загрузок и данные PostgreSQL хранятся в именованных томах Docker
+(uploads и pgdata), поэтому после down они не удаляются.
+
+Чтобы удалить и тома (осторожно, потеряете файлы и БД):
+
+  docker compose down -v
+
+
+8. Запуск без Docker (для разработки)
+--------------------------------------------------------------------------------
+
+Нужен установленный PostgreSQL и переменная окружения DATABASE_URL, например:
+
+  set DATABASE_URL=postgres://user:pass@localhost:5432/fileshare?sslmode=disable
+  go run ./cmd/fileshare
+
+В Linux/macOS вместо set используйте:
+
+  export DATABASE_URL=postgres://user:pass@localhost:5432/fileshare?sslmode=disable
+
+================================================================================