From 0993973360c8f2510e3b273f934401e3740b8645 Mon Sep 17 00:00:00 2001 From: Andrei Guliaikin Date: Tue, 11 May 2021 15:33:12 +0200 Subject: [PATCH] Create troubleshooting.md --- src/ru/administration/troubleshooting.md | 65 ++++++++++++++++++++++++ 1 file changed, 65 insertions(+) create mode 100644 src/ru/administration/troubleshooting.md diff --git a/src/ru/administration/troubleshooting.md b/src/ru/administration/troubleshooting.md new file mode 100644 index 0000000..656f0f1 --- /dev/null +++ b/src/ru/administration/troubleshooting.md @@ -0,0 +1,65 @@ +# Решения проблем + +Различные проблемы, которые могут возникнуть на новом инстансе и способы их решения. + +Многие функции Lemmy зависят от правильной конфигурации reverse proxy. Убедитесь, что ваш, эквивалентен нашему конфигурационному файлу [nginx](https://github.com/LemmyNet/lemmy/blob/main/ansible/templates/nginx.conf). + +## Главное + +### Журналы + +При возникновении проблем с интерфейсом проверьте [браузерную консоль](https://webmasters.stackexchange.com/a/77337) для любых сообщениях об ошибки. + +Для журналов сервера запустите `docker-compose logs -f lemmy` в вашей инсталяционной папке. Вы также можете запустить `docker-compose logs -f lemmy lemmy-ui pictrs` для получения журнала от различных сервисов. + +Если этого недостаточно, попробуйте изменить строку `RUST_LOG=error` в `docker-compose.yml` на `RUST_LOG=info` или `RUST_LOG=verbose`, затем сделайте `docker-compose restart lemmy`. + +### Создание пользователя с правами администратора не работает + +Убедитесь, что websocket работает правильно, проверив консоль браузера на наличие ошибок. В nginx для этого важны следующие заголовки: + +``` +proxy_http_version 1.1; +proxy_set_header Upgrade $http_upgrade; +proxy_set_header Connection "upgrade"; +``` + +### Ошибка ограничения скорости, когда на сайт заходят множество пользователей + +Убедитесь, что заголовки `X-Real-IP` и `X-Forwarded-For` отправляются в Lemmy посредством reverse proxy. В противном случае он будет считать все действия в соответствии с ограничением скорости IP-адреса обратного прокси-сервера. В nginx это должно выглядеть так: + +``` +proxy_set_header X-Real-IP $remote_addr; +proxy_set_header Host $host; +proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; +``` + +## Федерация + +### Другие инстансы не могут получать локальные объекты (сообщество, пост и т.д.) + +Ваш reverse proxy (например nginx) должен пересылать запросы с заголовком `Accept: application/activity+json` в бэкэнд. Это обрабатывается следующими строками: + +``` +set $proxpass "http://0.0.0.0:{{ lemmy_ui_port }}"; +if ($http_accept = "application/activity+json") { +set $proxpass "http://0.0.0.0:{{ lemmy_port }}"; +} +if ($http_accept = "application/ld+json; profile=\"https://www.w3.org/ns/activitystreams\"") { +set $proxpass "http://0.0.0.0:{{ lemmy_port }}"; +} +proxy_pass $proxpass; +``` + +Вы можете проверить, что он работает правильно, выполнив следующие команды, все они должны возвращать действительный JSON: +``` +curl -H "Accept: application/activity+json" https://your-instance.com/u/some-local-user +curl -H "Accept: application/activity+json" https://your-instance.com/c/some-local-community +curl -H "Accept: application/activity+json" https://your-instance.com/post/123 # the id of a local post +curl -H "Accept: application/activity+json" https://your-instance.com/comment/123 # the id of a local comment +``` +### Получение удаленных объектов работает, но публикации/комментирование в удаленных сообществах не успешны. + +Проверьте это [федерация разрешена в обоих случаях](../federation/administration.md#instance-allowlist-and-blocklist). + +Также убедитесь, что на вашем сервере установлено точное время. Действия подписываются меткой времени и будут отброшены, если она отключена более чем на 10 секунд.