Документация ZX FILES
1. Установка системы
Загрузите все файлы системы на хостинг, сохранив структуру папок. Настройте веб-сервер на директорию public/.
Убедитесь, что следующая папка имеет права на запись:
Прейдите в браузере по адресу системы, будет автоматически запущен установщик.
Введите данные для первого пользователя.
Система автоматически создаст SQLite базу данных при первом запуске.
2. Системные требования
| Компонент | Требования |
|---|---|
| PHP | 8.2 или выше |
| Расширения PHP | PDO, SQLite3, OpenSSL, MBString, JSON |
| Веб-сервер | Apache, Nginx или другой с поддержкой PHP |
| Память | Минимум 256MB RAM |
| Дисковое пространство | Зависит от объема загружаемых файлов |
| Максимальный размер одного файла | 500MB |
3. Управление файлами
Загрузка файлов
- Пароль - защита доступа
- Срок действия - автоматическое отключение
- Лимит скачиваний - ограничение количества
Пакетная загрузка
Система поддерживает загрузку нескольких файлов одновременно:
- Выберите несколько файлов через Ctrl+Click
- Или перетащите файлы в область загрузки
- Все файлы получат одинаковые настройки доступа
Информация о файле
Для каждого файла отображается:
- Оригинальное имя файла
- Размер и тип файла
- Количество скачиваний
- Дата загрузки
- Статус активности
4. Все файлы - плоский список
Обзор всех файлов
В разделе "Файлы" отображается полный список всех загруженных файлов в системе с возможностью:
| Функция | Описание |
|---|---|
| Поиск по названию | Быстрый поиск файлов по оригинальному имени |
| Пагинация | Настройка количества файлов на странице (10, 20, 50, 100) |
| Статусы файлов | Визуальная индикация статуса каждого файла |
Элементы интерфейса
Для каждого файла в списке отображается:
- Название файла (с обрезкой длинных имен)
- Размер файла в читаемом формате
- Количество скачиваний и лимит
- Дата загрузки
- Визуальные статусы:
- файл активен
- файл отключен
- установлен пароль
- срок действия истек
- срок действия скоро истекает
Действия с файлами
Для каждого файла доступны кнопки действий:
- Копировать ссылку - копирование публичной ссылки для скачивания
- Редактировать - изменение параметров файла
- Удалить - удаление файла из системы
5. Работа с папками
Создание папок
Древовидная структура
Система поддерживает неограниченную вложенность папок:
- Переход между папками через хлебные крошки
- Быстрая навигация по дереву папок
- Отображение статистики по папкам (количество файлов и подпапок)
Публичные папки
Папки можно сделать публичными для общего доступа:
Скачивание папок
Целые папки можно скачать в виде ZIP архивов:
- Автоматическое создание ZIP архива
- Сохранение структуры папок внутри архива
- Учет ограничений доступа для отдельных файлов
6. Защита файлов
Парольная защита
Для каждого файла можно установить пароль:
- Пароль запрашивается при каждой попытке скачивания
- Ограничение попыток ввода - 5 попыток за 15 минут
- Пароли хранятся в зашифрованном виде
Ограничение по времени
| Тип ограничения | Описание |
|---|---|
| Срок действия | Файл автоматически становится недоступным после указанной даты |
Ограничение скачиваний
Можно установить лимит на количество скачиваний:
- 0 - без ограничений
- 1-999 - конкретное число скачиваний
- После достижения лимита файл становится недоступным
Статусы файлов
| Статус | Описание |
|---|---|
| ● Активный | Файл доступен для скачивания |
| ● Неактивный | Файл отключен вручную |
| ● Истек срок | Автоматически отключен по времени |
| ● Лимит исчерпан | Достигнут лимит скачиваний |
8. Авторизация через Telegram
Настройка бота
Процесс авторизации
Пользователи могут войти в систему через Telegram:
9. Управление пользователями
Роли пользователей
| Роль | Права |
|---|---|
| Администратор | Полный доступ ко всем функциям системы |
| Пользователь | Доступ только к своим файлам и папкам |
Создание пользователей
- Email (уникальный)
- Пароль (минимум 6 символов)
- Имя
Привязка Telegram
Каждый пользователь может привязать свой Telegram аккаунт:
- Быстрая авторизация без ввода пароля
- Возможность отвязки в любой момент
- Код привязки действителен 10 минут
10. Настройки системы
Основные настройки
- Тема интерфейса - светлая или темная
- Email отправителя - адрес для исходящих писем
- Имя отправителя - отображаемое имя в письмах
Адрес отправителя должен совпадать с адресом при настройке SMTP, при его использовании
Почтовые настройки
Настройки для отправки уведомлений по email:
| Метод | Описание |
|---|---|
| SMTP | Настройка своего ящика |
| Sendmail | Системный sendmail (по умолчанию) |
| PHP mail() | Отправка PHP |
Telegram настройки
Настройки интеграции с Telegram ботом:
- Токен бота
- Настройка вебхука
11. Резервное копирование
Ручное резервное копирование
Рекомендуется регулярно создавать резервные копии вручную:
cp storage/database.sqlite backup/database_backup_$(date +%Y%m%d).sqlite
tar -czf backup/files_backup_$(date +%Y%m%d).tar.gz storage/uploads/
Восстановление из резервной копии
12. Устранение неисправностей
Распространенные проблемы
Решение: Проверьте права доступа к папке storage/uploads/ и настройки upload_max_filesize в php.ini
Решение: Убедитесь, что расширение PDO-SQLite включено и есть права на запись в storage/
Решение: Проверьте настройки веб-сервера и права доступа к файлам в storage/uploads/