README
¶
MHServer
Сервер для домашнего использования, с целью замены Google Drive, Yandex Disk и т.д.
Системные требования
- Linux
- Systemd
- MariaDB
- 500+ MB ОЗУ
Установка
- Скачиваете последнюю версию из списка релизов
- Распаковываете архив:
tar -xzvf путь_до_архива/mhserver.tar.gz - Переходите в каталог со скриптом настройки:
cd mhserver/scripts - Настраивайте сервер:
./setup.sh
[!NOTE] Для понимания аспектов настройки, используйте информацию из раздела Общая информация.
После настройки, при желании, вы можете удалить скачанный каталог с архивом.
Использование
В конце настройки, вам будет предложено запустить сервис сервера. Если вы согласитесь, то сервер будет автоматически запускаться при старте системы.
Если вы отказались, то включить сервис вы можете в ручную в любое время: sudo systemctl enable mhserver.service
Если вы желаете запустить сервер с помощью исполняемого файла:
- Переходите в каталог с исполняемым файлом
cd /opt/mhserver/ -
- Для запуска всего (main & subservers):
sudo ./main - Для запуска только основного сервера (main):
sudo ./main -M - Для запуска только подсерверов (subservers):
sudo ./main -S
- Для запуска всего (main & subservers):
Общая информация
Workspace path — место в котором будут сохраняться файлы сервисов (файлового, музыкального и т.д.). Соответственно, это то место, где вы будете хранить свои файлы
Server database password — пароль для базы данных сервера. В ней хранятся учётные данные пользователей и т.д.
Available server RAM percentage — размер (в процентах) оперативной памяти доступный для сервера. Рекомендую устанавливать значение не больше 90
SubServers — главный функционал вашего сервера. Есть несколько типов:
- Main сервер. Основной сервер, координирующий другие. Если он отключён... отключён весь функционал.
- Files сервер. Используется для сохранения файлов.
[!IMPORTANT] Файловый сервер является необходимым для работы остальных субсерверов.
- Music сервер. Используется для сохранения и прослушивания музыки (дальнейший функционал в стадии размышлений)
- Images сервер. Используется для сохранения и просмотра изображений.
- LLM сервер. Используется для общения с ИИ-агентами.
Список готовых подсерверов:
| Subserver | available |
|---|---|
| Main | ✔️ |
| Files | ✔️ |
| Music | ❌ |
| Images | ❌ |
| LLM | ❌ |
[!IMPORTANT] Выставляйте разные порты подсерверами, если они работают на одном адресе.
API
MHServer API доступен на вики
[!WARNING] Использование API сервера, очень трудно для работы "из коробки" (с помощью curl или postman), т.к. сервер предусматривает использование больших файлов. Клиент находится на стадии разработки, однако можно сделать легкий клиент самостоятельно.
FAQ
Как продлить TLS или корневой сертификат, если они просрочены?
Вы можете воспользоваться скриптом настройки сертификата:
- Перейдите в каталог с исполняемым файлом сервера:
cd /opt/mhserver - Запустите скрипт:
./create-ssl-cert.sh
[!NOTE] Вы также можете использовать данный скрипт для просмотра срока жизни вашего сертификата.
Directories