Uruchom lekki serwer domowy Matrix na Raspberry Pi 4

Tak — Raspberry Pi 4 może uruchomić Conduit, a projekt publikuje kompilacje ARM64. W przypadku małego serwera domowego lub domowego, najważniejsze opcje konfiguracji to 64-bitowy system operacyjny, stała nazwa serwera Matrix, trwała pamięć masowa i działający routing HTTPS. Conduit jest obecnie określany jako wersja beta, więc należy go aktualizować i nie zakładać, że Pi 4 ma określoną obsługiwaną przepustowość; projekt nie publikuje benchmarku przepustowości Raspberry Pi 4.

Czy Conduit będzie odpowiednim rozwiązaniem dla tego Raspberry Pi?

Conduit to lekki serwer domowy Matrix z rekomendowanym systemem bazodanowym RocksDB. Oficjalna dokumentacja wdrożeniowa zawiera aarch64obraz binarny i OCI, który pasuje do 64-bitowej instalacji systemu operacyjnego Raspberry Pi. Dziennik zmian projektu zawierał wersję 0.10.15 z 30 września 2026 r., sprawdzoną 10 października 2026 r. Poprzednia wersja 0.10.14 naprawiała lukę w zabezpieczeniach dostępu do konta i zalecała niezwłoczną aktualizację. Ta historia sprawia, że ​​monitorowanie aktualizacji jest częścią konfiguracji, a nie opcjonalnym zadaniem na późniejszym etapie.

Strona internetowa Conduit nadal oznacza projekt jako beta i informuje o braku niektórych funkcji. Przed wyborem sprawdź, czy obecny zestaw funkcji spełnia Twoje potrzeby, zwłaszcza jeśli zależy Ci na mostach, zaawansowanej administracji lub szerokiej kompatybilności z klientami. Komputer Raspberry Pi może być praktycznym hostem dla małego wdrożenia, ale ruch, wykorzystanie multimediów i aktywność federacyjna wpływają na wydajność. Zacznij od niewielkiej grupy użytkowników i obserwuj wykorzystanie pamięci, temperatury i pamięci masowej, zamiast polegać na obiecanej liczbie użytkowników.

Co powinieneś zdecydować przed instalacją?

  • Wybierz nazwę serwera Matrix. W tym przykładzie jest to matrix.example.org. Ta domena pojawia się w identyfikatorach Matrix użytkowników, takich jak @alex:matrix.example.org. Wybierz domenę, którą kontrolujesz i którą planujesz zachować; jej późniejsza zmiana nie jest prostą edycją nazwy hosta.
  • Zaplanuj dostęp publiczny. Przypisz domenie rekord DNS wskazujący na Twój publiczny adres IP. Skonfiguruj przekierowanie routera i odwrotny serwer proxy z ważnym certyfikatem HTTPS. Wskazówki dotyczące wdrożenia Conduit wymagają protokołu HTTPS i mówią, że ruch federacyjny musi być dostępny na porcie 443 i/lub 8448, w zależności od konfiguracji wykrywania i serwera proxy.
  • Użyj 64-bitowego systemu operacyjnego Raspberry Pi. Sprawdź architekturę za pomocą uname -m. Powinien zostać wyświetlony komunikat . Aktualne wytyczne Dockera dotyczące Raspberry Pi wskazują, że przyszłe główne wersje Docker Engine nie będą już zawierać pakietów dla 32-bitowego systemu operacyjnego Raspberry Pi; w przypadku 64-bitowego systemu ARM użytkownicy powinni zapoznać się z instrukcjami instalacji aarch64Debiana .arm64
  • Utrzymuj bazę danych w stanie trwałym. Przechowuj dane Conduit w trwałym katalogu lub woluminie Docker i uwzględnij je w przetestowanym planie tworzenia kopii zapasowych. Nie przechowuj jedynej kopii w warstwie zapisywalnej kontenera ani na wymiennej karcie, którą możesz sformatować.

Jak uruchomić Conduit z Dockerem?

Zainstaluj Docker Engine i wtyczkę Compose, korzystając z aktualnych instrukcji dla wersji systemu Raspberry Pi OS. Następnie sprawdź, czy Docker działa. Dokumentacja Conduit zawiera listę stabilnego obrazu Docker Hub registry.gitlab.com/famedly/conduit/matrix-conduit:latesti obrazów OCI ARM64. Pobierz stabilny obraz i sprawdź, czy Docker wybrał obraz 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}}'

Kontynuuj tylko wtedy, gdy zgłoszona architektura pasuje do Twojego 64-bitowego systemu operacyjnego. Utwórz katalog roboczy i plik Compose:

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

Użyj tej konfiguracji jako punktu wyjścia. Zakłada ona, że ​​odwrotny serwer proxy działa na hoście Pi i przekazuje żądania Matrix do portu 6167. Zastąp przykładową nazwę serwera. Pusta wartość CONDUIT_CONFIGinformuje kontener o konieczności używania zmiennych środowiskowych, zgodnie z bieżącymi instrukcjami Conduit Docker dla tej konfiguracji.

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"]'

Utwórz prywatny plik tokena rejestracyjnego i uruchom usługę:

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

Token jest potrzebny do zarejestrowania pierwszego konta; Conduit nadaje pierwszemu utworzonemu użytkownikowi uprawnienia administratora serwera. Zachowaj plik .envjako prywatny i nie zatwierdzaj go w publicznym repozytorium. W tym przykładzie Conduit jest powiązany z interfejsem pętli zwrotnej Raspberry Pi, więc jest dostępny tylko przez odwrotny serwer proxy działający na tym samym hoście. Jeśli Twój serwer proxy działa w innym kontenerze lub na innej maszynie, użyj prywatnej sieci Docker lub chronionego interfejsu prywatnego zamiast udostępniać port 6167 publicznie.

Jak zapewnić dostępność i bezpieczeństwo serwera?

Skonfiguruj serwer proxy odwrotne do obsługi domeny przez HTTPS i przekazywania żądań klienta i federacji Matrix — w tym /_matrix/i /.well-known/matrix/— do Conduit. Najprostszy sposób konfiguracji publicznej zależy od serwera proxy i tego, czy federacja korzysta z portu 8448, czy z delegowanego wykrywania przez port 443. Postępuj zgodnie z odpowiednim przykładem w dokumentacji wdrażania Dockera w Conduit; nie kopiuj fragmentu kodu serwera proxy bez dostosowania jego nazw hostów, obsługi certyfikatów i ścieżek sieciowych.

Jeśli używasz tej samej domeny server_namei adresu URL serwera domowego, upewnij się, że klienci mogą dotrzeć do reklamowanego punktu końcowego HTTPS. Jeśli Conduit jest hostowany w oddzielnej subdomenie niż domena Matrix ID, skonfiguruj oba /.well-known/matrix/client, /.well-known/matrix/serverzgodnie z opisem w przewodniku delegowania. Samo otwarcie portu nie konfiguruje wykrywania ani TLS.

Zarejestruj konto administratora niezwłocznie za pomocą klienta Matrix obsługującego tokeny rejestracyjne. Następnie wyłącz rejestrację otwartą, chyba że celowo chcesz, aby inni tworzyli konta. W programie Compose zmień CONDUIT_ALLOW_REGISTRATIONna "false", usuń token rejestracyjny ze środowiska usługi i utwórz ponownie kontener za pomocą docker compose up -d. Twój katalog danych zamontowany w powiązaniu pozostaje na swoim miejscu. Sprawdź, kto ma dostęp do gniazda Docker i plików konfiguracyjnych Raspberry Pi, ponieważ mogą one ujawnić lub zmienić tajne dane serwera.

Jak można sprawdzić, czy konfiguracja działa?

Sprawdź lokalny interfejs API klienta Matrix za pomocą publicznej nazwy hosta HTTPS:

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

Odpowiedź JSON potwierdza, że ​​interfejs API klienta jest osiągalny; nie dowodzi to jednak działania federacji. Uruchom oficjalny tester federacji Matrix dla nazwy swojego serwera i popraw wszelkie .well-knownzgłaszane błędy DNS, TLS, przekierowania portów i inne błędy. Na koniec zaloguj się na nowe konto, potwierdź, że ma ono uprawnienia administratora i przetestuj wiadomość w pokoju z użytkownikiem na innym serwerze domowym, jeśli federacja jest częścią Twojego celu.

Powyższe szczegóły techniczne zostały sprawdzone na oficjalnych stronach Conduit dotyczących Dockera, konfiguracji, delegowania i dziennika zmian dnia 10 października 2026 r. Zapoznaj się z przewodnikiem wdrażania Conduit Docker , przewodnikiem wdrażania binarnego i generycznego ARM64 , odniesieniem do konfiguracji , przewodnikiem delegowania , dziennikiem zmian Conduit oraz notatkami dotyczącymi instalacji systemu operacyjnego Raspberry Pi OS firmy Docker, aby uzyskać szczegółowe informacje, które różnią się w zależności od wersji.

Zostaw komentarz

Bezpieczne przywracanie Matrix Synapse za pomocą zrzutu PostgreSQL

Utwórz kopię zapasową Synapse za pomocą pg_dump, chroń jej klucz podpisu i nośnik, a następnie przywróć do czystej bazy danych PostgreSQL bez ponownego używania nieaktualnych kluczy jednorazowych.

Uruchom Mjölnir jako bota moderującego pokój Matrix za pomocą Dockera

Uruchom Mjölnir jako bota moderującego pokój Matrix za pomocą Dockera

Skonfiguruj Mjölnir przy użyciu dedykowanego konta Matrix, szyfrowanego pokoju zarządzania, Docker Compose, listy zasad i kontroli uprawnień.

Włącz natywną synchronizację Matrix Sliding, aby przyspieszyć ładowanie urządzeń mobilnych

Włącz natywną synchronizację Matrix Sliding, aby przyspieszyć ładowanie urządzeń mobilnych

Pomiń wycofany serwer proxy i skonfiguruj wbudowaną funkcję Sliding Sync w Synapse. Sprawdź wykrywanie klientów, a następnie zmierz ładowanie listy pokoi i zachowanie ponownego łączenia na kompatybilnym telefonie.

Host Element Web na Nginx z niestandardowym serwerem domowym

Wdróż Element Web jako witrynę statyczną, skieruj ją do serwera domowego Matrix, dodaj HTTPS i skonfiguruj Nginx, aby obsługiwał aktualizacje bez przestarzałych plików.

Uruchom lekki serwer domowy Matrix na Raspberry Pi 4

Skonfiguruj Conduit na 64-bitowym Raspberry Pi 4 ze stałymi danymi, federacją HTTPS, chronioną rejestracją i sprawdź, czy serwer domowy działa.

Skonfiguruj niestandardowy alias pokoju macierzy w swojej własnej domenie

Nadaj pokojowi Matrix łatwy do udostępniania adres w swojej domenie, korzystając z Element lub interfejsu API Matrix, ze sprawdzaniem uprawnień, nazewnictwem Synapse i federacją.

Skonfiguruj coturn, aby zapewnić niezawodne połączenia głosowe i wideo Matrix

Skonfiguruj coturn i Synapse przy użyciu zgodnych poświadczeń TURN, otwórz wymagane porty przekaźnikowe i sprawdź, czy klienci Matrix mogą uzyskać kandydatów na przekaźniki.

Wdrażanie Matrix Synapse z Docker Compose i PostgreSQL

Wdrażanie Matrix Synapse z Docker Compose i PostgreSQL

Skonfiguruj trwały serwer domowy Synapse z Docker Compose, PostgreSQL, prywatną konfiguracją i sprawdź, czy jest on udostępniany przez HTTPS.

Dostosuj motyw i branding Element Web

Ustaw nazwę marki, niestandardowe kolory i zasoby logowania dla wdrożenia Element Web, pamiętając jednocześnie, które części pozostaną markowe dla Element.

Podnieś limit plików Systemd w Synapse bez zgadywania

Podnieś limit plików Systemd w Synapse bez zgadywania

Sprawdź, czy Synapse osiągnął limit otwartych plików dla każdego procesu, ustaw drop-in systemd dla właściwej usługi lub pracownika i zweryfikuj limit aktywności.