Autor: [Adam Nadolny](/autorzy/adam-nadolny) Ekspert DevOps i infrastruktury · Zweryfikowano Kwiecień 2026 1. [Strona główna](/) › 2. [Baza wiedzy](/baza-wiedzy/) › 3. Matrix Synapse — serwer komunikatora # Matrix Synapse — zdecentralizowany komunikator: instalacja serwera Opublikowano: 10 kwietnia 2026 · Kategoria: VPS Matrix to zdecentralizowany protokół komunikacji — każdy może postawić własny serwer i rozmawiać z użytkownikami innych serwerów Matrix na całym świecie, bez uzależnienia od jednej firmy. Synapse to oficjalny serwer Matrix napisany w Pythonie. W przeciwieństwie do Mattermost nie wymaga, żeby wszyscy uczestnicy rozmowy byli na tym samym serwerze — wystarczy że ich serwery obsługują federację. Ten artykuł pokazuje instalację Synapse, konfigurację TLS, rejestrację użytkowników przez Element i dodanie bridge'a dla Telegrama. ## Instalacja Synapse przez Docker Compose Docker to najwygodniejsza metoda instalacji Synapse — unika problemów z zależnościami Pythona i ułatwia aktualizacje. Przed startem potrzebujesz domeny z rekordem A wskazującym na VPS oraz otwartych portów 443 (HTTPS) i 8448 (federacja Matrix). \# Utwórz katalog i generuj konfigurację mkdir -p /opt/synapse && cd /opt/synapse # Generuj homeserver.yaml docker run -it --rm \\ -v /opt/synapse:/data \\ -e SYNAPSE\_SERVER\_NAME=matrix.example.com \\ -e SYNAPSE\_REPORT\_STATS=no \\ matrixdotorg/synapse:latest generate # docker-compose.yml version: '3.8' services: synapse: image: matrixdotorg/synapse:latest restart: unless-stopped volumes: - /opt/synapse:/data ports: - "8008:8008" # HTTP (Nginx proxuje na HTTPS) environment: - SYNAPSE\_CONFIG\_PATH=/data/homeserver.yaml depends\_on: - postgres postgres: image: postgres:15 restart: unless-stopped environment: POSTGRES\_USER: synapse POSTGRES\_PASSWORD: synapse\_password POSTGRES\_DB: synapse POSTGRES\_INITDB\_ARGS: "--encoding=UTF-8 --lc-collate=C --lc-ctype=C" volumes: - /opt/synapse/postgres:/var/lib/postgresql/data docker compose up -d ## Konfiguracja homeserver.yaml Plik `homeserver.yaml` kontroluje wszystkie aspekty serwera. Kluczowe sekcje do skonfigurowania po wygenerowaniu domyślnej konfiguracji: \# homeserver.yaml - kluczowe sekcje # Identyfikator serwera (NIE ZMIENIAC PO PIERWSZYM URUCHOMIENIU) server\_name: "example.com" # krótka domena, nie matrix.example.com # Podlaczenie do PostgreSQL zamiast SQLite database: name: psycopg2 args: user: synapse password: synapse\_password database: synapse host: postgres port: 5432 cp\_min: 5 cp\_max: 10 # Rejestracja uzytkownikow (wylacz publicznie) enable\_registration: false registration\_requires\_token: true # SMTP dla emaili weryfikacyjnych email: smtp\_host: smtp.example.com smtp\_port: 587 smtp\_user: noreply@example.com smtp\_pass: smtp\_password require\_transport\_security: true notif\_from: "%(app)s " app\_name: Matrix # Federacja - limit dla duzych publicznych pokojow federation\_domain\_whitelist: \[\] # puste = wszystkie serwery # Aby ogra niczyc federacje: # federation\_domain\_whitelist: # - matrix.org # - company.com ## Nginx + Let's Encrypt i Well-Known Matrix wymaga specjalnej konfiguracji Nginx: proxy na port 8008 dla API klienta oraz plik `.well-known/matrix/server` umożliwiający delegację serwera (server\_name ≠ domena Synapse): server { listen 443 ssl; server\_name matrix.example.com; ssl\_certificate /etc/letsencrypt/live/matrix.example.com/fullchain.pem; ssl\_certificate\_key /etc/letsencrypt/live/matrix.example.com/privkey.pem; # Klient API location /\_matrix { proxy\_pass http://127.0.0.1:8008; proxy\_set\_header X-Forwarded-For $remote\_addr; proxy\_set\_header X-Forwarded-Proto $scheme; proxy\_set\_header Host $host; client\_max\_body\_size 50M; } } # Well-known na krotka domene (example.com) server { listen 443 ssl; server\_name example.com; location /.well-known/matrix/server { return 200 '{"m.server": "matrix.example.com:443"}'; add\_header Content-Type application/json; } location /.well-known/matrix/client { return 200 '{"m.homeserver":{"base\_url":"https://matrix.example.com"}}'; add\_header Content-Type application/json; add\_header Access-Control-Allow-Origin \*; } } ## Rejestracja użytkowników i klient Element Po wyłączeniu publicznej rejestracji (`enable_registration: false`) tworzysz konta przez CLI Synapse lub tokenami rejestracyjnymi. Element to oficjalny klient webowy i desktopowy dla Matrix: \# Tworzenie uzytkownika przez CLI (wewnątrz kontenera) docker exec -it synapse register\_new\_matrix\_user \\ -c /data/homeserver.yaml \\ -u admin -p strong\_password \\ --admin http://localhost:8008 # Generowanie tokenu rejestracyjnego (Matrix 1.2+) docker exec -it synapse python -m synapse.app.admin\_cmd \\ -c /data/homeserver.yaml generate\_registration\_token # Sprawdz status serwera curl https://matrix.example.com/\_matrix/client/versions # Element Web - uruchom przez Docker docker run -d \\ --name element \\ -p 8080:80 \\ -v /opt/element/config.json:/app/config.json \\ vectorim/element-web:latest # config.json dla Element (podstawowy) # { # "default\_server\_config": { # "m.homeserver": { # "base\_url": "https://matrix.example.com" # } # } # } ## Bridge Telegram — mautrix-telegram Bridges pozwalają używać Matrix jako warstwy integrującej wiele komunikatorów. Poniżej instalacja most do Telegrama. Mosty działają jako Application Services zarejestrowane w Synapse: \# docker-compose.yml - dodaj serwis bridge mautrix-telegram: image: dock.mau.dev/mautrix/telegram:latest volumes: - /opt/mautrix-telegram:/data depends\_on: - synapse - postgres # Generuj konfigurację docker run --rm -v /opt/mautrix-telegram:/data \\ dock.mau.dev/mautrix/telegram:latest # Edytuj /opt/mautrix-telegram/config.yaml # homeserver.address: https://matrix.example.com # homeserver.domain: example.com # appservice.address: http://mautrix-telegram:29317 # telegram.api\_id: (z my.telegram.org) # telegram.api\_hash: (z my.telegram.org) # Generuj registration.yaml dla Synapse docker run --rm -v /opt/mautrix-telegram:/data \\ dock.mau.dev/mautrix/telegram:latest -g # Dodaj registration.yaml do homeserver.yaml # app\_service\_config\_files: # - /data/mautrix-telegram-registration.yaml # Zrestartuj Synapse i uruchom bridge docker compose restart synapse docker compose up -d mautrix-telegram ## Najczęstsze pytania Co to jest protokół Matrix i jak działa federacja? + Matrix to otwarty protokół komunikacji w czasie rzeczywistym oparty na zdecentralizowanej federacji serwerów. Każdy serwer (homeserver) jest niezależny, ale może wymieniać wiadomości z użytkownikami innych serwerów — podobnie jak email. Synapse to referencyjna implementacja serwera Matrix w Pythonie. Użytkownicy na matrix.org mogą pisać do użytkowników na twoim serwerze prywatnym bez żadnej konfiguracji — wystarczy że oba serwery są dostępne przez internet. Jakie wymagania sprzętowe ma Synapse? + Minimalne wymagania dla małego serwera (do 50 użytkowników, bez federacji z dużymi serwerami): 1 GB RAM, 1 vCPU, 20 GB dysku. Dla 50–500 użytkowników zaleca się 2–4 GB RAM. Uwaga: Synapse jest napisany w Pythonie i bywa zasobożerny — przy federacji z matrix.org (dużymi pokojami) zużycie RAM może gwałtownie wzrosnąć. Baza PostgreSQL jest zalecana zamiast SQLite dla każdego serwera produkcyjnego. Jakie są bridges w Matrix i jak działają? + Bridges (mosty) to aplikacje łączące Matrix z innymi komunikatorami: Telegram (mautrix-telegram), Discord (mautrix-discord), Slack (mautrix-slack), WhatsApp (mautrix-whatsapp), Signal (mautrix-signal). Most działa jak bot na obu platformach — jest zarejestrowany jako Application Service w Synapse i przekazuje wiadomości w obu kierunkach. Użytkownik może przez Element pisać na Telegram bez instalowania aplikacji Telegram. Czym Matrix różni się od Mattermost i XMPP? + Matrix to zdecentralizowany protokół z federacją podobny do email — każdy może mieć własny serwer i komunikować się z innymi serwerami. XMPP (Jabber) jest starszym protokołem o podobnej architekturze, ale z mniejszym ekosystemem klientów. Mattermost to scentralizowane rozwiązanie self-hosted bez federacji — komunikacja tylko między użytkownikami tego samego serwera. Matrix wygrywa elastycznością i bridges, Mattermost — funkcjonalnością dla zespołów deweloperskich (integracje CI/CD, zarządzanie projektami). ## Sprawdź oferty pasujące do tego scenariusza Poniżej masz szybkie przejścia do ofert i stron z kodami rabatowymi tam, gdzie są dostępne. Contabo VPS z NVMe dla Synapse — baza PostgreSQL i bridges wymagają dysku SSD NVMe SSD [Aktywuj rabat →](/out/contabo) #Reklama · link partnerski [Zobacz kod rabatowy →](/kody-rabatowe/contabo) Mikr.us Budżetowy start — Synapse dla małej grupy prywatnej Budżet [Aktywuj rabat →](/out/mikrus) #Reklama · link partnerski [Zobacz kod rabatowy →](/kody-rabatowe/mikrus) ProSerwer.pl Polski VPS — prywatny komunikator bez danych za granicą Polski VPS [Aktywuj rabat →](/out/proserwer-pl) #Reklama · link partnerski [Zobacz kod rabatowy →](/kody-rabatowe/proserwer) ## Powiązane strony - [Mattermost — komunikator dla deweloperów](/baza-wiedzy/mattermost-self-hosted) - [Jitsi Meet — self-hosted wideokonferencje](/baza-wiedzy/jitsi-meet-vps-instalacja) - [Docker na VPS — instalacja i konfiguracja](/baza-wiedzy/docker-na-vps) - [Wszystkie artykuły](/baza-wiedzy/)