feat/player-parsers: add README

player-parsers/README.RU.md

@@ -0,0 +1,115 @@
+# AniX - Player Parsers
+
+Данный под-проект позволяет получить прямые ссылки на видеофайлы с источников Sibnet, Kodik, Libria
+
+Он может использоваться как для основного проекта AniX, так и как отдельный сервис.
+
+В основном проекте, парсеры используются для работы своего плеере, если вам не важна данная функция, вы можете не развёртывать данный суб-сервис.
+
+Лицензия: [MIT](../LICENSE)
+
+## Использование
+
+В строке веб-браузера необходимо ввести:
+
+`<http|https>://<ip|domain><:port>/?url=<VIDEO_URL>&player=<PLAYER_SOURCE>`
+
+где:
+
+- http|https - схема по которой будет осуществляться подключение к сервису
+- ip|domain - IP адрес или домен на котором находится сервис
+- :port - порт сервиса, опционально
+- VIDEO_URL - ссылка на видео от источника
+- PLAYER_SOURCE - источник, один из: kodik, sibnet, libria
+
+Ответ:
+
+- 500|400: произошла ошибка, подробнее в строке `message` в теле ответа
+- 200: запрос прошёл успешно
+
+## Развёртывание
+
+> В связи с спецификой источников, рекомендуется использовать виртуальный сервер в россии или нидерландах, т.к. они могут быть недоступны из других стран.
+>
+> Из-за данной специфики, парсеры невозможно развернуть на edge сервисах, таких как CloudFlare Workers или Deno, а только на отдельном сервере.
+
+<details>
+<summary>С помощью docker</summary>
+
+Требования:
+
+- [docker](https://docs.docker.com/engine/install/)
+
+### Пре-билд
+
+1. выполните комманду:
+
+`docker run -d --name anix-player -p 7000:7000 ghcr.io/radiquum/anix-player-parser:29-05-2025`
+
+### Ручной билд
+
+Доп. Требования:
+
+- [git](https://git-scm.com/)
+
+1. Клонируйте репозиторий `git clone https://github.com/Radiquum/AniX`
+2. Переместитесь в директорию репозитория `cd AniX`
+3. Переместитесь в директорию парсеров `cd player-parsers`
+4. Выполните команду `docker build -t anix-player-parser .`
+5. После окончания, выполните команду: `docker run -d --restart always --name anix-player -p 7000:7000 anix-player-parser`
+
+### Обозначения
+
+- -d - запустить контейнер в фоне
+- --restart always - всегда запускать после перезагрузки сервера
+- --name - название контейнера
+- -p - порт контейнера который будет доступен из вне. ПОРТ:7000
+
+### После развёртывания
+
+Сервис будет доступен по адресу: `http://<ВАШ IP><:ВАШ ПОРТ>/`
+
+### Примечание
+
+Для использования своего домена и поддержки протокола https, вы можете использовать traefik или другой reverse-proxy, с сертификатом SSL.
+
+Полезные ссылки:
+
+- [Конвертер из команды docker run в синтакс для docker compose](https://it-tools.tech/docker-run-to-docker-compose-converter)
+- [Как настроить traefik + свой домен + SSL](https://letmegooglethat.com/?q=how+to+setup+traefik+with+custom+domain+and+ssl+certificate+from+lets+encrypt%3F)
+
+</details>
+
+<details>
+<summary>С помощью pm2</summary>
+
+Требования:
+
+- [git](https://git-scm.com/)
+- [nodejs 23+ с npm](http://nodejs.org/)
+- [pm2](https://pm2.keymetrics.io/)
+
+Инструкция:
+
+1. Клонируйте репозиторий `git clone https://github.com/Radiquum/AniX`
+2. Переместитесь в директорию репозитория `cd AniX`
+3. Переместитесь в директорию парсеров `cd player-parsers`
+4. Выполните команду `pm2 start index.ts -n anix-player-parser`
+
+### Обозначения
+
+- -n - название сервиса в pm2
+
+### После развёртывания
+
+Сервис будет доступен по адресу: `http://<ВАШ IP>:7000/`
+
+### Примечание
+
+Для автоматического запуска приложения, рекомендуется настроить pm2 на автозапуск, с помощью команды: `pm2 startup`
+
+Полезные ссылки:
+
+- [PM2: подходим к вопросу процесс-менеджмента с умом @ Habr](https://habr.com/ru/articles/480670/)
+
+</details>