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.