diff --git a/docs/docs/index.md b/docs/docs/index.md new file mode 100644 index 0000000..f02e439 --- /dev/null +++ b/docs/docs/index.md @@ -0,0 +1,5 @@ +# Добро пожаловать в доки + +Это мой личный список как документаций, так и описание чего либо. + +Если найдете ошибки или имееться желание что-то добавить, обращайтесь ко мне. Обратную связь найдете внизу. diff --git a/docs/docs/linux/network/troubleshooting.md b/docs/docs/linux/network/troubleshooting.md new file mode 100644 index 0000000..a45b689 --- /dev/null +++ b/docs/docs/linux/network/troubleshooting.md @@ -0,0 +1,93 @@ +# Устранение сетевых проблем + +!!! Warning "Обратите внимание" + Ошибки бывают разные. Доступ к определенному ресурсу, пропускная спостобность и так далее. + + Здесь разберем самые самые частые проблемы, которые могут быть. + + Так же, эта информация не для обычных пользователей, а администраторов сетей и серверов. Здесь показаны достаточно специфичные варианты устранения проблем. + + Все команды, показаны здесь чаще всего используються в ОС Linux. + +Посмотрим сначала достаточно простые проблемы, а после перейдем на более серьезные ситуации. + +--- +## Сайт не открываеться + +Для начала посмотрим коды ошибок. + +??? info "Комментарий автора" + Сам не запоминаю коды, так как сразу перехожу на поиск проблемы. Это происходит на мышечном памяти. Это означает, что могу почти сразу понять проблему. + + Когда управляешь самостоятельно всей инфраструктурой, можешь сразу определить причину методом исключения. Однако коды необходимо знать. + + +### Коды ошибок + +Самые частые коды: + +1. **404** — **Not Found** — ресурс не найден на сервере. + +2. **403** — **Forbidden** — доступ запрещен. + - Неправильные права доступа к файлам на уровне ОС. + - Активен фильтр ограничения доступа (IP-белый список и т.п.). + +3. **504** — **Gateway Timeout** — бэкенд не ответил вовремя. + - Тяжелые скрипты, превышающие время ожидания прокси. + - Проблемы с сетевым взаимодействием между прокси и бэкендом. + +4. **503** — **Service Unavailable** — бэкенд временно недоступен. + - Бэкенд не запущен или упал. + - Порт бэкенда закрыт или недоступен. + +5. **502** — **Bad Gateway** — прокси получил некорректный ответ от бэкенда. + - Несовместимость версий протоколов. + - Бэкенд отдает ответ в неправильном формате. + + +Коды ошибок во время диагностики: + +1. **200** - **OK** - ресурс упешно получен без каких либо ошибок. +2. **301* - **Moved Permanently** - Перенаправляет на другой URI. + +--- + +### Примеры ситуаций + +#### Сайт поднят, но не открываються на других устройствах в локальной сети + +Для начала, и это самое важное, нужно определить как именно не открываеться. + +- Сайт не загружаеться. + - Браузер сразу показывает ошибку, что не может достучаться до сайта. + - **Server not found** или **Не удается получить доступ к сайту**. +- Выводит статическу ошибку о ошибке. + + + +##### Сайт не открываеться. + + Для начало узнаем, открыт ли порт. + +``` +nc -zv
+``` + +``` title="Порт открыт" +$ nc -zv 192.168.1.1 80 + +Connection to 192.168.1.1 80 port [tcp/http] succeeded! +``` + +``` title="Порт закрыт" +$ nc -zv 192.168.1.1 80 + +nc: connect to 100.222.6.5 port 80 (tcp) failed: Connection timed out +``` + +Чаще всего, если порт не доступен, nc будет пытаться дочстучаться до него, пока не сработает time out. Можно установить свой time out, с помощью аттрибута `-w`. + + +--- + +**Информация постепенно дополняеться, однако на данный момент поставлена на паузу.** diff --git a/docs/docs/other/element-vpn.md b/docs/docs/other/element-vpn.md new file mode 100644 index 0000000..e4dc95c --- /dev/null +++ b/docs/docs/other/element-vpn.md @@ -0,0 +1,46 @@ +## Зачем это нужно? + +Пользователи, которые используют мой VPN постоянно спрашивают о разных технических проблемах. Отвечать я не устал, однако иногда оперативно не получаеться всем ответить. + +Я создал комнату на моем сервере Element, да бы пользователи могли общаться, помогать и оперативно получать важную информацию о работе vpn. + +## Почему Element? + +Я не буду вдаваться в технические особеднности данного мессенджера. Однако четко отвечу на вопрос. + +> **Element** - гибкий сервис, где достаточно удобно можно создавать комнаты и общаться с пользователями. +> +> Данный сервис не запрашивает почту или номер телефона во время регистрации и можно развернуть свой личный сервер у себя дома или на арендованном сервере. А это приводит к тому, что Element достаточно удобен и его с наименьшей вероятностью заблокируют. + + +## Параметры подключения + +- Веб сайт, где можно общаться: [https://element.serti.fun](https://element.serti.fun) + +- Адрес подключения для приложений: `https://matrix.serti.fun` + - Некоторые приложения могут запросить адрес выше, однако таких програм достаточно мало + + +## Приложения для телефонов + +- Android + - [Google Play](https://play.google.com/store/apps/details?id=im.vector.app) + - [F-Droid](https://f-droid.org/packages/im.vector.app/) +- [IOS](https://apps.apple.com/app/vector/id1083446067) + +!!! info + Рекомендуеться приложение Element Classic, так как он более стабильный для моего сервера. + + Однако можно использовать любое другое приложение. + +После установки, введите мой адрес до сервера, а после пройдите аунтификацию, если не делали ранее. + +## Связь со мной + +Как только зарегистрируетесь, напишите мне и я добавлю вас в комнату. + +``` title="Мой id" +@cher:matrix.serti.fun +``` + +Так же, добавлять могут и другие участники. diff --git a/mkdocs.yml b/mkdocs.yml index ba9b692..eb61f99 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -40,6 +40,10 @@ plugins: nav: - "Главная": index.md - Документации: + - 'index': docs/index.md + #- 'Linux': + # - 'Сеть': + # - 'Устранение проблем': docs/linux/network/troubleshooting.md - 'Docker': 'О проекте': docs/docker/about.md 'Установка': docs/docker/install.md @@ -56,6 +60,7 @@ nav: - "Decky": docs/steam-deck/plugins/decky.md - 'Другое': - 'CalDAV и CardDAV от Yandex': docs/other/ya-dav.md + - 'Доступ к комнате element для пользователей VPN': docs/other/element-vpn.md - Сервисы: services.md - Мои сервера: server.md #- Блог: