РУКОВОДСТВО ПОЛЬЗОВАТЕЛЯ: Обмен файлами через S3 Beget

Версия: 1.0
Дата: 2025-11-17
Проект: infra-s3-beget

🎯 ДЛЯ ЧЕГО ЭТО

S3 Beget работает как Яндекс.Диск, но быстрее и безопаснее:

✅ Открываете как обычную папку на компьютере
✅ Перетаскиваете файлы мышкой
✅ Доступ с любого компьютера (Windows/Linux)
✅ Автоматическая синхронизация

Не нужно:
- ❌ Заходить на сайт
- ❌ Качать/выгружать через браузер
- ❌ Вводить пароли каждый раз

📁 СТРУКТУРА ПАПОК

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

📁 nomenclature/
├── 📂 ВХОДЯЩИЕ    ← Кладите сюда файлы для отправки на сервер
├── 📂 ИСХОДЯЩИЕ   ← Забирайте отсюда файлы от сервера
└── 📂 АРХИВ       ← Старые/обработанные файлы

Как работать:

Хотите отправить файл на сервер?
- Скопируйте в ВХОДЯЩИЕ/
- Файл автоматически появится на сервере
Хотите получить файл с сервера?
- Откройте ИСХОДЯЩИЕ/
- Скопируйте нужный файл к себе на компьютер
Посмотреть старые файлы?
- Откройте АРХИВ/
- Там лежат все обработанные файлы

💻 ПОДКЛЮЧЕНИЕ НА WINDOWS

Шаг 1: Установить rclone (один раз)

Скачайте rclone: https://rclone.org/downloads/
Распакуйте в C:\rclone\
Добавьте C:\rclone\ в PATH:
- Пуск → "Переменные среды"
- Системные переменные → Path → Изменить
- Добавить C:\rclone\

Проверка:

rclone version

Должно показать версию rclone.

Шаг 2: Настроить подключение (один раз)

Создайте файл %APPDATA%\rclone\rclone.conf с содержимым:

[beget-s3]
type = s3
provider = Other
access_key_id = F1AIVIQI0DE3PJGIWQC1
secret_access_key = iRDHW0PJsqTb070EDUdOpCQuKwtw7C9POX0KGsmZ
endpoint = https://s3.ru1.storage.beget.cloud
acl = private
region = ru-1

Шаг 3: Подключить S3 как диск

Вариант A: Запустить готовый скрипт (рекомендуется)

Скачайте файл mount_s3_windows.ps1 с сервера
Щелкните правой кнопкой → "Запустить с PowerShell"
S3 автоматически подключится как диск Z:
Откроется Проводник с папками

Вариант B: Вручную через PowerShell

# Запустить PowerShell от администратора
rclone mount beget-s3:fe2c1d30dc11-s3-0kt Z: --vfs-cache-mode writes --network-mode

# Окно PowerShell должно остаться открытым
# Откройте Проводник → Компьютер → Диск Z:

Шаг 4: Работать с файлами

Откройте Проводник → Диск Z: → nomenclature

Теперь работайте как с обычными папками:
- Перетаскивайте файлы мышкой
- Открывайте Excel/Word документы
- Создавайте новые файлы

Как отключить диск

Закройте все файлы с диска Z:
Вариант A: Пуск → Компьютер → ПКМ на Z: → "Отключить"
Вариант B: Закройте окно PowerShell (если запускали вручную)

🐧 ПОДКЛЮЧЕНИЕ НА LINUX

На сервере (уже настроено)

S3 смонтирован в /mnt/beget-s3/

Работайте как с обычной папкой:

# Посмотреть содержимое
ls /mnt/beget-s3/nomenclature/

# Скопировать файл в исходящие
cp файл.xlsx /mnt/beget-s3/nomenclature/ИСХОДЯЩИЕ/

# Прочитать входящие
cat /mnt/beget-s3/nomenclature/ВХОДЯЩИЕ/задание.txt

На домашнем Linux компьютере

Установить rclone:
bash sudo apt update sudo apt install -y rclone
Создать конфигурацию:
bash mkdir -p ~/.config/rclone/ cat > ~/.config/rclone/rclone.conf << 'EOF' [beget-s3] type = s3 provider = Other access_key_id = F1AIVIQI0DE3PJGIWQC1 secret_access_key = iRDHW0PJsqTb070EDUdOpCQuKwtw7C9POX0KGsmZ endpoint = https://s3.ru1.storage.beget.cloud acl = private region = ru-1 EOF
Создать точку монтирования:
bash mkdir -p ~/beget-s3
Подключить S3:
bash rclone mount beget-s3:fe2c1d30dc11-s3-0kt ~/beget-s3 \ --daemon \ --vfs-cache-mode writes \ --dir-cache-time 5m \ --poll-interval 15s
Работать с файлами:
```bash
# Откройте файловый менеджер
# Перейдите в папку ~/beget-s3/nomenclature/

# ИЛИ через терминал:
cd ~/beget-s3/nomenclature/
ls -la
```

Отключить:
bash fusermount -u ~/beget-s3

🔄 ТИПИЧНЫЕ СЦЕНАРИИ РАБОТЫ

Сценарий 1: Отправить прайс-лист на обработку

Откройте диск Z: (Windows) или ~/beget-s3 (Linux)
Перейдите в nomenclature/ВХОДЯЩИЕ/
Скопируйте файл прайс.xlsx
Файл автоматически появится на сервере
Сервер обработает и положит результат в ИСХОДЯЩИЕ/

Сценарий 2: Получить обработанный файл

Откройте диск Z: (Windows) или ~/beget-s3 (Linux)
Перейдите в nomenclature/ИСХОДЯЩИЕ/
Найдите нужный файл (например, changes_only.xlsx)
Скопируйте к себе на компьютер
Откройте в Excel и работайте

Сценарий 3: Посмотреть архив старых файлов

Откройте nomenclature/АРХИВ/
Все старые обработанные файлы там
Можете скопировать нужный для проверки

⚠️ ВАЖНЫЕ ПРАВИЛА

✅ МОЖНО:

✅ Открывать файлы прямо с диска
✅ Копировать файлы туда-обратно
✅ Создавать новые файлы
✅ Переименовывать файлы
✅ Удалять старые файлы

❌ НЕЛЬЗЯ:

❌ Удалять папки ВХОДЯЩИЕ, ИСХОДЯЩИЕ, АРХИВ
❌ Редактировать файл пока он открыт в другой программе
❌ Отключать диск во время копирования больших файлов

💡 РЕКОМЕНДАЦИИ:

Для больших файлов (>10 МБ):
- Подождите несколько секунд после копирования
- Проверьте что размер файла совпадает
Если файл не появляется:
- Подождите 15 секунд (это интервал обновления)
- Обновите папку (F5 в Проводнике)
Если диск "завис":
- Закройте все программы, использующие файлы с диска
- Отключите диск
- Подключите заново

🔧 РЕШЕНИЕ ПРОБЛЕМ

Проблема: "Диск Z: не найден"

Причина: S3 не подключен

Решение:
1. Запустите скрипт mount_s3_windows.ps1
2. ИЛИ выполните команду rclone mount вручную

Проблема: "Доступ запрещен"

Причина: Неверные ключи доступа

Решение:
1. Проверьте файл %APPDATA%\rclone\rclone.conf
2. Убедитесь что ключи правильные:
- Access Key: F1AIVIQI0DE3PJGIWQC1
- Secret Key: iRDHW0PJsqTb070EDUdOpCQuKwtw7C9POX0KGsmZ

Проблема: "Не вижу новые файлы"

Причина: Кэш не обновился

Решение:
1. Подождите 15 секунд
2. Нажмите F5 для обновления
3. ИЛИ переоткройте папку

Проблема: "Медленно копируются файлы"

Причина: Интернет или настройки кэша

Решение:
1. Проверьте скорость интернета
2. Для очень больших файлов используйте другие методы (SSH/SCP)

📞 ПОЛУЧИТЬ ПОМОЩЬ

Если ничего не помогло:

Опишите проблему подробно
Укажите операционную систему (Windows/Linux)
Приложите скриншот ошибки (если есть)
Отправьте файл с логами:
- Windows: PowerShell окно с командой rclone
- Linux: journalctl -u beget-s3-mount.service

📋 БЫСТРАЯ ШПАРГАЛКА

Задача	Windows	Linux
Подключить S3	`mount_s3_windows.ps1`	`rclone mount beget-s3:... ~/beget-s3 --daemon`
Открыть папки	Проводник → Z:	Файловый менеджер → ~/beget-s3
Отключить	ПКМ на Z: → Отключить	`fusermount -u ~/beget-s3`
Путь к входящим	`Z:\nomenclature\ВХОДЯЩИЕ\`	`~/beget-s3/nomenclature/ВХОДЯЩИЕ/`
Путь к исходящим	`Z:\nomenclature\ИСХОДЯЩИЕ\`	`~/beget-s3/nomenclature/ИСХОДЯЩИЕ/`

Готово! Теперь вы можете обмениваться файлами так же просто, как с Яндекс.Диском.

Текущий файл для скачивания: ИСХОДЯЩИЕ/changes_only.xlsx (66 исправленных записей номенклатуры)