Игорь Надеин
9491811425
Documentation Structure: - MULTI_USER_AUTH.md (250 lines): Multi-user authentication guide - Architecture overview - Encryption mechanism (Fernet/AES-128) - User flow diagrams - API reference - Security considerations - MIGRATION_GUIDE.md (120 lines): Migration instructions - Single-user to multi-user migration - Step-by-step guide - Data backup procedures - Rollback instructions - DOCKER_QUICKSTART.md (100 lines): Quick Docker start - Prerequisites - 5-minute setup guide - Common commands - Troubleshooting - DOCKER_GUIDE.md (400 lines): Complete Docker guide - Architecture details - Development workflow - Volume management - Network configuration - Resource limits - Logging and debugging - PRODUCTION_DEPLOYMENT.md (500 lines): Production operations - 7-service architecture diagram - Deployment procedures - Monitoring setup (Prometheus, Grafana) - Management commands - Backup/restore - Security checklist - Scaling strategies - Troubleshooting guide - CHANGELOG.md: Version history and release notes
154 lines
3.0 KiB
Markdown
154 lines
3.0 KiB
Markdown
# 🐳 Docker Quick Start
|
||
|
||
## Запуск за 3 шага
|
||
|
||
### 1️⃣ Создайте .env файл
|
||
|
||
**Windows:**
|
||
```cmd
|
||
copy .env.example .env
|
||
notepad .env
|
||
```
|
||
|
||
**Linux/Mac:**
|
||
```bash
|
||
cp .env.example .env
|
||
nano .env
|
||
```
|
||
|
||
**Укажите в .env:**
|
||
```env
|
||
TELEGRAM_BOT_TOKEN=your_bot_token_from_botfather
|
||
```
|
||
|
||
### 2️⃣ Запустите
|
||
|
||
**Windows:**
|
||
```cmd
|
||
start.bat
|
||
```
|
||
|
||
**Linux/Mac:**
|
||
```bash
|
||
chmod +x start.sh
|
||
./start.sh
|
||
```
|
||
|
||
**Или через docker-compose:**
|
||
```bash
|
||
docker-compose up -d
|
||
```
|
||
|
||
### 3️⃣ Готово! 🎉
|
||
|
||
Бот запущен и работает в фоне.
|
||
|
||
## Управление
|
||
|
||
### Просмотр логов
|
||
```bash
|
||
docker-compose logs -f
|
||
```
|
||
*(Ctrl+C для выхода)*
|
||
|
||
### Остановка
|
||
```bash
|
||
docker-compose down
|
||
```
|
||
|
||
### Перезапуск
|
||
```bash
|
||
docker-compose restart
|
||
```
|
||
|
||
### Статус
|
||
```bash
|
||
docker-compose ps
|
||
```
|
||
|
||
## Makefile (для удобства)
|
||
|
||
Если установлен `make`:
|
||
|
||
```bash
|
||
make help # Показать все команды
|
||
make up # Запустить
|
||
make down # Остановить
|
||
make logs # Логи
|
||
make restart # Перезапуск
|
||
make shell # Войти в контейнер
|
||
make backup # Создать backup данных
|
||
```
|
||
|
||
## Где хранятся данные?
|
||
|
||
```
|
||
./data/ → Пользовательские данные
|
||
├── users.json (учетные данные, зашифрованные)
|
||
└── .encryption_key (ключ шифрования)
|
||
|
||
./logs/ → Логи бота
|
||
|
||
./temp_documents/ → Временные файлы (Excel/XML)
|
||
```
|
||
|
||
**⚠️ ВАЖНО:** Сделайте backup `./data/.encryption_key`!
|
||
|
||
## Обновление бота
|
||
|
||
```bash
|
||
# Остановка
|
||
docker-compose down
|
||
|
||
# Обновление кода
|
||
git pull
|
||
|
||
# Пересборка и запуск
|
||
docker-compose build
|
||
docker-compose up -d
|
||
```
|
||
|
||
**Или через Makefile:**
|
||
```bash
|
||
make update
|
||
```
|
||
|
||
## Troubleshooting
|
||
|
||
### "docker-compose: command not found"
|
||
|
||
Установите Docker и Docker Compose:
|
||
- [Docker Desktop for Windows](https://docs.docker.com/desktop/install/windows-install/)
|
||
- [Docker Desktop for Mac](https://docs.docker.com/desktop/install/mac-install/)
|
||
- [Docker Engine for Linux](https://docs.docker.com/engine/install/)
|
||
|
||
### Бот не запускается
|
||
|
||
```bash
|
||
# Проверьте логи
|
||
docker-compose logs
|
||
|
||
# Проверьте .env файл
|
||
cat .env # Linux/Mac
|
||
type .env # Windows
|
||
```
|
||
|
||
### Недостаточно прав (Linux)
|
||
|
||
```bash
|
||
# Добавьте пользователя в группу docker
|
||
sudo usermod -aG docker $USER
|
||
|
||
# Выйдите и войдите заново
|
||
```
|
||
|
||
## Полная документация
|
||
|
||
📖 [docs/DOCKER_GUIDE.md](DOCKER_GUIDE.md) - Подробное руководство
|
||
|
||
## Нужна помощь?
|
||
|
||
1. Проверьте [docs/DOCKER_GUIDE.md](DOCKER_GUIDE.md)
|
||
2. Посмотрите логи: `docker-compose logs -f`
|
||
3. Проверьте статус: `docker-compose ps`
|