Piliin ang pangalan ng server
Ang pangalan ng server na nakikita ng user ay maaaring mahirap baguhin mamaya. Unawain ang delegation at ang mga kilalang record na ginagamit ng iyong deployment. Subukan ang client discovery at federation kaysa ipagpalagay na ang matagumpay na web login ay nagpapatunay sa dalawa.
Gumamit ng sinusuportahang stack
Karaniwang gumagamit ang Synapse ng PostgreSQL para sa production data, na may mga sumusuportang serbisyo depende sa scale at configuration. Sundin ang kasalukuyang rekomendasyon ng upstream. Panatilihing tugma ang mga timeout ng workers, database at reverse proxy sa load.
Panatilihing tumpak ang mga claim sa encryption
Pinoprotektahan ng end-to-end encryption ang nilalaman sa mga sinusuportahang naka-encrypt na silid sa pagitan ng mga kalahok na client. Maaari pa ring iproseso ng homeserver ang metadata at hindi naka-encrypt na nilalaman. Ang client key backup, verification at account recovery ay nangangailangan ng sariling paliwanag.
Panatilihin ang instance
Limitahan ang pagpaparehistro kapag angkop, protektahan ang mga interface ng administratibo at shared-secret at magtakda ng sinadyang pagtago ng media at event. I-back up nang pare-pareho ang database, konfigurasyon at mga susi sa pag-sign, pagkatapos subukan ang recovery.
Subukan nang hiwalay ang client at ang mga federation path
Ang client tulad ng Element ay umaabot sa client API ng homeserver, habang ang ibang homeserver ay gumagamit ng federation discovery at endpoint. Ang pagbabago sa reverse-proxy ay maaaring makasira sa isa habang gumagana pa ang isa. Subukan ang bagong account, lokal na room at awtorisadong federated room, pagkatapos i-verify ang encryption at recovery behavior mula sa client.
Opisyal na dokumentasyon: Kasalukuyang gabay sa pag-install ng Synapse
Panatilihin ang matibay na identity material
Ang database ay hindi ang buong pagkakakilanlan ng homeserver. Panatilihin ang signing key at kaugnay na configuration at mga secret na may pare-parehong backup. Suriin kung aling external media at history ang pinapanatili at magtakda ng patakaran na angkop sa iyong komunidad. Subaybayan ang storage at worker queues bago maging outage ang paglaki.
Ihiwalay ang pangalan ng account sa hosting endpoint
Magpasya sa Matrix server_name bago ang paggawa ng account: ito ay magiging bahagi ng mga identifier ng user at room. Ang web hostname na nagse-serve sa Synapse ay maaaring magkaiba kapag ang discovery/delegation ay wastong na-configure. Planuhin ang parehong client discovery at server-to-server discovery, isang valid na certificate at ang address family na aktwal na maaabot. Ang Element ay isang client, hindi kapalit ng homeserver. Panatilihin ang isang independiyenteng ruta ng administrator at isang recovery contact sa labas ng homeserver.
- Pumili ng sinusuportahang Synapse release at isang PostgreSQL deployment na angkop sa production.
- Panatilihing pribado ang database at mga administrative listener.
- Tahasang tukuyin ang patakaran sa registration at federation.
Opisyal na dokumentasyon: Pag-install ng Synapse · Delegasyon ng Matrix
Buuin ang discovery at ang proxy bilang bahagi ng serbisyo
Bumuo ng configuration para sa napiling release, i-persist ang signing key at database, at i-configure ang proxy ayon sa opisyal na gabay ng Synapse. Dapat magkasundo ang panlabas na nakikitang origin, forwarded headers at request paths. Kung gagamitin ang delegation, ihain ang mga kinakailangang well-known document mula sa identity domain. Huwag ilantad ang raw internal na API port upang ayusin ang isang proxy error. Itago ang mga registration secret sa labas ng configuration ng browser client.
Opisyal na dokumentasyon: Synapse reverse proxy
Subukan ang client session at federation session
Gumawa ng test account, ikonekta ang sinusuportahang client, magpadala ng lokal na mensahe at mag-upload ng maliit na file. I-verify ang client discovery nang hiwalay sa federation discovery, pagkatapos ay subukan ang isang room kasama ang isa pang pinapayagang server kung balak ang federation. Sa isang naka-encrypt na room, subukan ang verification at ang key-recovery flow ng client. Hindi awtomatikong nire-restore ng homeserver backup ang bawat decryption key na hawak ng client. Ipaliwanag kung aling metadata ang pinapanatili ng server at aling mga room ang naka-encrypt.
# Discovery checks use your identity domain and HTTPS:
curl --fail https://example.com/.well-known/matrix/client
curl --fail https://example.com/.well-known/matrix/serverGamitin ang lokasyon ng error para paliitin ang pag-aayos
Kung hindi matuklasan ng Element ang server, siyasatin ang well-known na tugon ng client at ang TLS origin. Kung gumagana ang lokal na messaging ngunit nabibigo ang federation, siyasatin ang federation delegation, maabot na mga address, certificates at policy. Ang paulit-ulit na media failure ay maaaring may kinalaman sa upload limits o storage. Panatilihing pare-pareho ang database, media, configuration at signing keys; subukan muna ang restore nang hindi naka-enable ang federation, upang ang pagsasanay ay hindi lumikha ng katunggaling kopya ng production identity.