docs: add badges, troubleshooting and changelog

README.ru.md

@@ -1,5 +1,9 @@
 # AstraDeploy
 
+[![License](https://img.shields.io/badge/Лицензия-MIT-green)](LICENSE)
+[![Bash](https://img.shields.io/badge/Bash-4%2B-brightgreen)](https://www.gnu.org/software/bash/)
+[![Version](https://img.shields.io/badge/Version-v0.1.0-blue)](README.ru.md)
+
 `AstraDeploy` — это bash-инсталлятор для Minecraft ядер (Java и Bedrock) с акцентом на простую установку и автоматизацию:
 
 - режим для нубов (`--easy`);
@@ -158,6 +162,28 @@ sudo bash install.sh \
 - `--locale en|ru` или `--lang en|ru`
 - автоматический fallback из `LANGUAGE` / `LANG`
 
+## Устранение типовых проблем
+
+- **Порт уже занят**  
+  - Проверьте кто держит порт через `lsof -i:<порт>` и остановите процесс, или укажите другой `--port`.
+  - Убедитесь, что выбранный порт доступен по нужному протоколу (`tcp`/`udp`) для ядра.
+
+- **Ошибка установки зависимостей / пакетов**  
+  - Повторите запуск с `--debug`, это покажет обнаруженный пакетный менеджер и упавшую команду.
+  - Проверьте интернет и доступность репозиториев пакетов.
+
+- **Permission denied при создании/изменении файлов**  
+  - Запускайте как `root` (через `sudo`) для полномасштабной установки.
+  - Проверьте, что пользователь из `--user` существует и имеет права на директорию `--dir`.
+
+- **Firewall не открылся автоматически**  
+  - Если `ufw`/`firewalld` отсутствуют, скрипт сообщит про ручную настройку.
+  - Откройте порт вручную в вашей системе безопасности.
+
+- **Коллбэк репортов не отправляется**  
+  - Ошибки callback не останавливают установку.
+  - Проверьте URL/token и повторите с корректными `--report-url` и `--report-token`.
+
 ## Важные замечания
 
 - Скрипт работает с повышенными правами и может менять сервисы, firewall, пакеты, файлы.
@@ -175,3 +201,6 @@ sudo bash install.sh \
 sudo bash install.sh --version
 ```
 
+## Changelog
+
+См. [`CHANGELOG.md`](CHANGELOG.md).