РУЧНАЯ НАСТРОЙКА BEGET S3 - ПОШАГОВАЯ ИНСТРУКЦИЯ

Дата: 2025-11-16
Проект: infra-s3-beget
Причина: Панель Beget защищена от автоматизации (требует JavaScript)

❌ ПОЧЕМУ АВТОМАТИЗАЦИЯ НЕ СРАБОТАЛА

Панель Beget использует:
- JavaScript для установки cookies
- Проверку браузера (защита от ботов)
- Динамическую загрузку контента

Попытки:
- ✗ curl - не выполняет JavaScript
- ✗ Python requests - не поддерживает JS
- ✗ Playwright headless - блокируется панелью

Вывод: Требуется ручной вход через браузер.

✅ ЧТО НУЖНО СДЕЛАТЬ (5 минут)

Шаг 1: Войти в панель Beget

URL: https://cp.beget.com/
Логин: kondurov
Пароль: см. .credentials.md

1. Откройте ссылку в браузере
2. Введите логин/пароль
3. Нажмите "Войти"

Шаг 2: Найти раздел S3

В левом меню найдите один из вариантов:
- 💾 S3 (самое частое)
- ☁️ Cloud Storage
- 📦 Объектное хранилище
- 🗄️ Storage

Если не нашли:
- Попробуйте поиск по панели (обычно есть строка поиска вверху)
- Или перейдите напрямую: https://cp.beget.com/s3

Шаг 3: Проверить наличие S3 услуги

Если увидели "S3 не подключён" или "Активировать S3":

1. Нажмите "Подключить" или "Активировать"
2. Выберите тариф (обычно есть бесплатный на 100-500 МБ)
3. Подтвердите подключение

Стоимость платного тарифа:
- Обычно ~20-50₽/месяц за 1 ГБ
- Или бесплатно (100-500 МБ)

Шаг 4: Создать ключи доступа

В разделе S3 найдите:
- "Ключи доступа" или
- "API ключи" или
- "Access Keys"

Нажмите:
- "Создать ключ" или "Create Key"

Укажите имя ключа:

nomenclature-exchange

Шаг 5: СКОПИРОВАТЬ ОБА КЛЮЧА

⚠️ КРИТИЧНО: После создания появится два ключа. Скопируйте ОБА СРАЗУ!

Ключи:
1. Access Key ID (публичный, ~20 символов)
- Пример: AKIAIOSFODNN7EXAMPLE
- Всегда доступен для просмотра

2. Secret Access Key (секретный, ~40 символов)
   - Пример: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
   - ⚠️ ПОКАЗЫВАЕТСЯ ТОЛЬКО ОДИН РАЗ!

Если потеряли Secret Key:
- Его нельзя восстановить
- Нужно создать новый ключ
- Старый ключ можно удалить

📋 ЧТО МНЕ ПЕРЕДАТЬ

Вариант 1: Напрямую в чат

Просто скопируйте и вставьте:

access_key_id = ВАSH_ACCESS_KEY_ID
secret_access_key = ВАШ_SECRET_ACCESS_KEY

Вариант 2: Создать файл .env

Создайте файл $WORKSPACE/infra/infra-s3-beget/config/.env:

# Beget S3 Credentials
S3_ACCESS_KEY=ВАSH_ACCESS_KEY_ID
S3_SECRET_KEY=ВАШ_SECRET_ACCESS_KEY
S3_ENDPOINT=https://s3.beget.com
S3_REGION=ru-central1
S3_BUCKET=nomenclature-exchange

Затем скажите: "Ключи в файле .env"

🔒 БЕЗОПАСНОСТЬ

• ✅ .env файл уже добавлен в .gitignore
• ✅ Ключи НЕ попадут в git репозиторий
• ✅ Secret Key показывается ТОЛЬКО ОДИН РАЗ - сохраните сразу
• ❌ НЕ публикуйте ключи в открытых источниках
• ❌ НЕ отправляйте ключи по незащищённым каналам

⏭️ ЧТО ДАЛЬШЕ

После того как вы передадите мне ключи, я автоматически:

1. ✅ Создам конфигурацию rclone
2. ✅ Создам бакет nomenclature-exchange
3. ✅ Настрою структуру папок (ВХОДЯЩИЕ/ИСХОДЯЩИЕ/АРХИВ)
4. ✅ Напишу скрипты синхронизации:
   - Linux (rclone sync)
   - Windows (PowerShell + rclone)
   - Server (автообработка)
5. ✅ Загружу текущий файл changes_only.xlsx (66 записей)
6. ✅ Создам документацию для работы

Время настройки после получения ключей: 2-3 минуты

🆘 ЕСЛИ ВОЗНИКЛИ ПРОБЛЕМЫ

S3 раздел не найден

Возможно S3 недоступен на вашем тарифе.

Решение:
1. Проверьте в "Тарифы" → "Услуги"
2. Или напишите в поддержку Beget
3. Или используйте готовое SSH решение (уже работает!)

Не могу создать ключ

Возможные причины:
- S3 не активирован → активируйте услугу
- Достигнут лимит ключей → удалите старые
- Технические проблемы → обратитесь в поддержку

Забыл Secret Key

Решение:
1. Создайте новый ключ с другим именем
2. Скопируйте оба ключа
3. Старый ключ можно удалить

🔄 АЛЬТЕРНАТИВА: SSH РЕШЕНИЕ (УЖЕ ГОТОВО!)

Если с S3 возникли сложности, у нас уже готово рабочее решение через SSH:

Что работает:
- ✅ Папка /opt/exchange/nomenclature/ на сервере
- ✅ Windows скрипт sync_windows.ps1 (GUI меню)
- ✅ Linux скрипт mount_remote.sh (SSHFS)
- ✅ Автообработка sync_server.sh

Преимущества SSH:
- Работает прямо сейчас
- Не нужны дополнительные ключи
- Простая настройка
- Прямой доступ к файлам

Недостатки SSH vs S3:
- Нет версионирования файлов
- Нет автоархивирования
- Требует SSH доступ (у вас уже есть)

Что выбираете:
1. S3 - пройдите по инструкции выше (5 минут)
2. SSH - скажите "используем SSH", начнём работать сразу

Версия: 1.0
Дата: 2025-11-16
Автор: Claude Code