Запустите облегченный домашний сервер Matrix на Raspberry Pi 4.

Да, на Raspberry Pi 4 можно запустить Conduit, и проект публикует сборки для ARM64. Для небольшого личного или семейного домашнего сервера наиболее важными параметрами настройки являются 64-битная ОС, постоянное имя сервера Matrix, постоянное хранилище и работающая маршрутизация HTTPS. В настоящее время Conduit позиционирует себя как бета-версия, поэтому следите за обновлениями и не предполагайте, что Pi 4 имеет определенную поддерживаемую пользовательскую емкость; проект не публикует тест производительности Raspberry Pi 4.

Подходит ли Conduit для этого Raspberry Pi?

Conduit — это легковесный домашний сервер Matrix с рекомендуемой базой данных RocksDB. В официальной документации по развертыванию указаны aarch64бинарный файл и образ OCI, соответствующие 64-битной установке Raspberry Pi OS. В журнале изменений проекта указана версия v0.10.15 от 30 сентября 2026 года (проверено 10 октября 2026 года). В предыдущей версии v0.10.14 была исправлена ​​уязвимость доступа к учетной записи и рекомендовано незамедлительно обновить систему. Эта история делает мониторинг обновлений частью процесса настройки, а не необязательной задачей на более позднем этапе.

На сайте Conduit проект по-прежнему обозначен как бета-версия, и отмечается отсутствие некоторых функций. Прежде чем выбрать его, убедитесь, что текущий набор функций соответствует вашим потребностям, особенно если вы зависите от мостов, расширенного администрирования или широкой совместимости с клиентами. Raspberry Pi может быть практичным хостом для небольшого развертывания, но трафик, использование мультимедиа и активность федерации влияют на производительность. Начните с небольшой группы пользователей и следите за использованием памяти, температуры и хранилища, а не полагайтесь на обещанное количество пользователей.

Что следует решить перед установкой?

  • Выберите имя сервера Matrix. В этом примере это matrix.example.org. Этот домен отображается в идентификаторах пользователей Matrix, например @alex:matrix.example.org, . Выберите домен, который вы контролируете и планируете сохранить; изменение его позже — это не просто редактирование имени хоста.
  • Спланируйте публичный доступ. Присвойте домену DNS-запись, указывающую на ваш публичный IP-адрес. Настройте переадресацию маршрутизатора и обратный прокси-сервер с действительным сертификатом HTTPS. В рекомендациях Conduit по развертыванию требуется HTTPS, и указано, что трафик федерации должен быть доступен на портах 443 и/или 8448, в зависимости от настроек обнаружения и прокси-сервера.
  • Используйте 64-битную ОС Raspberry Pi. Проверьте архитектуру с помощью команды `docker uname -msrc`. Она должна показать `<архитектура>` . В текущих рекомендациях Docker для Raspberry Pi отмечается, что будущие основные релизы Docker Engine больше не предоставляют пакеты для 32-битной ОС Raspberry Pi; для 64-битной ARM пользователям рекомендуется обратиться к инструкциям по установке aarch64Debian .arm64
  • Обеспечьте постоянное хранение данных в базе данных. Храните данные Conduit в постоянном каталоге или томе Docker и включите их в проверенный план резервного копирования. Не храните единственную копию в доступном для записи слое контейнера или на съемной карте памяти, которую вы можете переформатировать.

Как запустить Conduit с помощью Docker?

Установите Docker Engine и плагин Compose, следуя инструкциям для вашей версии Raspberry Pi OS. Затем убедитесь, что Docker запущен. В документации Conduit указаны стабильный образ Docker Hub registry.gitlab.com/famedly/conduit/matrix-conduit:latestи образы ARM64 OCI. Загрузите стабильный образ и проверьте, что Docker выбрал образ ARM64:

docker image pull registry.gitlab.com/famedly/conduit/matrix-conduit:latest
docker image inspect registry.gitlab.com/famedly/conduit/matrix-conduit:latest \
  --format '{{.Architecture}}'

Продолжайте только в том случае, если указанная архитектура соответствует вашей 64-битной ОС. Создайте рабочую директорию и файл Compose:

mkdir -p ~/matrix-conduit/data
cd ~/matrix-conduit
nano compose.yaml

Используйте эту конфигурацию в качестве отправной точки. Она предполагает, что обратный прокси-сервер работает на хосте Raspberry Pi и перенаправляет запросы Matrix на порт 6167. Замените пример имени сервера. Пустое поле CONDUIT_CONFIGуказывает контейнеру использовать переменные среды, как того требуют текущие инструкции Docker для Conduit.

services:
  conduit:
    image: registry.gitlab.com/famedly/conduit/matrix-conduit:latest
    container_name: conduit
    restart: unless-stopped
    ports:
      - "127.0.0.1:6167:6167"
    volumes:
      - ./data:/var/lib/matrix-conduit
    environment:
      CONDUIT_CONFIG: ""
      CONDUIT_SERVER_NAME: "matrix.example.org"
      CONDUIT_ADDRESS: "0.0.0.0"
      CONDUIT_PORT: "6167"
      CONDUIT_DATABASE_BACKEND: "rocksdb"
      CONDUIT_ALLOW_REGISTRATION: "true"
      CONDUIT_REGISTRATION_TOKEN: "${CONDUIT_REGISTRATION_TOKEN}"
      CONDUIT_ALLOW_FEDERATION: "true"
      CONDUIT_TRUSTED_SERVERS: '["matrix.org"]'

Создайте файл с приватным регистрационным токеном и запустите сервис:

umask 077
printf 'CONDUIT_REGISTRATION_TOKEN=%s\n' "$(openssl rand -hex 32)" > .env
docker compose up -d
docker compose logs --tail=100 conduit

Токен необходим для регистрации вашей первой учетной записи; Conduit назначает первого созданного пользователя администратором сервера. Держите файл .envв секрете и не публикуйте его в общедоступном репозитории. В примере Conduit привязывается к интерфейсу обратной связи Raspberry Pi, поэтому он доступен только через обратный прокси-сервер, работающий на том же хосте. Если ваш прокси-сервер работает в другом контейнере или на другой машине, используйте частную сеть Docker или защищенный частный интерфейс вместо того, чтобы публично открывать порт 6167.

Как обеспечить доступность и безопасность сервера?

Настройте обратный прокси-сервер для обслуживания домена по протоколу HTTPS и перенаправляйте запросы клиента Matrix и федерации, включая /_matrix/и /.well-known/matrix/, в Conduit. Простейшая публичная конфигурация зависит от вашего прокси-сервера и от того, использует ли федерация порт 8448 или делегированное обнаружение через порт 443. Следуйте соответствующему примеру в документации Conduit по развертыванию Docker; не копируйте фрагмент кода прокси без адаптации его имен хостов, обработки сертификатов и сетевых путей.

Если вы используете один и тот же домен для server_nameи URL домашнего сервера, убедитесь, что клиенты могут получить доступ к заявленной конечной точке HTTPS. Если Conduit размещен на отдельном поддомене от домена Matrix ID, настройте оба /.well-known/matrix/clientи , /.well-known/matrix/serverкак описано в руководстве по делегированию. Открытие порта само по себе не настраивает обнаружение или TLS.

Зарегистрируйте свою учетную запись администратора незамедлительно с помощью клиента Matrix, поддерживающего токены регистрации. Затем отключите открытую регистрацию, если только вы намеренно не хотите, чтобы другие создавали учетные записи. В Compose измените значение CONDUIT_ALLOW_REGISTRATIONна "false", удалите токен регистрации из среды службы и создайте контейнер заново с помощью docker compose up -d. Ваш смонтированный каталог данных останется на месте. Проверьте, кто может получить доступ к сокету Docker и файлам конфигурации Raspberry Pi, поскольку они могут раскрыть или изменить секретные данные сервера.

Как можно убедиться в работоспособности настройки?

Проверьте локальный API клиента Matrix, используя общедоступное имя хоста HTTPS:

curl -fsS https://matrix.example.org/_matrix/client/versions

JSON-ответ подтверждает доступность клиентского API, но не доказывает работоспособность федерации. Запустите официальный тестер федерации Matrix для имени вашего сервера и исправьте все ошибки DNS, TLS, переадресации портов или другие .well-knownошибки, которые он выдаст. Наконец, войдите в систему с помощью новой учетной записи, убедитесь, что у вас есть права администратора, и протестируйте сообщение в комнате с пользователем на другом домашнем сервере, если федерация является частью вашей цели.

Технические характеристики, указанные выше, были проверены по официальным страницам Conduit, посвященным Docker, конфигурации, делегированию и списку изменений, 10 октября 2026 года. Подробную информацию, которая может отличаться в зависимости от версии, см. в руководстве по развертыванию Docker от Conduit , руководстве по развертыванию бинарных файлов ARM64 и универсальных файлов , справочнике по конфигурации , руководстве по делегированию , списке изменений Conduit и примечаниях по установке Docker для Raspberry Pi OS .

Оставить комментарий

Безопасное восстановление Matrix Synapse с помощью дампа PostgreSQL

Создайте резервную копию Synapse с помощью pg_dump, защитите ключ подписи и носители, а затем восстановите данные в чистую базу данных PostgreSQL, не используя повторно устаревшие одноразовые ключи.

Запустите Mjölnir в качестве бота для модерации комнат Matrix с помощью Docker.

Запустите Mjölnir в качестве бота для модерации комнат Matrix с помощью Docker.

Настройте Mjölnir, используя выделенный аккаунт Matrix, зашифрованную комнату управления, Docker Compose, список политик и проверки разрешений.

Включите встроенную синхронизацию Matrix Sliding для более быстрой загрузки на мобильных устройствах.

Включите встроенную синхронизацию Matrix Sliding для более быстрой загрузки на мобильных устройствах.

Откажитесь от устаревшего прокси и настройте встроенную в Synapse функцию Sliding Sync. Проверьте обнаружение клиентов, затем измерьте скорость загрузки списка комнат и поведение при переподключении на совместимом телефоне.

Разместите Element Web на Nginx с пользовательским Homeserver.

Разверните Element Web как статический сайт, укажите в качестве сервера ваш домашний сервер Matrix, добавьте HTTPS и настройте Nginx для обслуживания обновлений без устаревших файлов.

Запустите облегченный домашний сервер Matrix на Raspberry Pi 4.

Настройте Conduit на 64-битном Raspberry Pi 4 с сохранением данных, федерацией HTTPS, защищенной регистрацией и проверкой работоспособности домашнего сервера.

Настройте собственный псевдоним для комнаты Matrix в своем домене.

Присвойте комнате Matrix легкодоступный адрес в вашем домене, используя Element или API Matrix, с проверкой прав доступа, именованием Synapse и федерацией.

Настройте Coturn для надежных голосовых и видеозвонков Matrix.

Настройте coturn и Synapse с использованием совпадающих учетных данных TURN, откройте необходимые порты ретрансляции и убедитесь, что клиенты Matrix могут получать кандидатов на ретрансляцию.

Развертывание Matrix Synapse с помощью Docker Compose и PostgreSQL

Развертывание Matrix Synapse с помощью Docker Compose и PostgreSQL

Перед тем как сделать его доступным по HTTPS, настройте постоянный домашний сервер Synapse с помощью Docker Compose, PostgreSQL, частной конфигурации и проверок.

Настройте тему и фирменный стиль Element Web.

Задайте фирменное название, пользовательские цвета и элементы авторизации для вашей веб-версии Element, при этом понимая, какие части останутся фирменными.

Увеличьте лимит файлов Systemd в Synapse без догадок.

Увеличьте лимит файлов Systemd в Synapse без догадок.

Проверьте, не превысил ли Synapse лимит на количество открытых файлов в одном процессе, установите параметр systemd для нужной службы или рабочего процесса и проверьте текущий лимит.