Chọn tên máy chủ
Tên máy chủ hiển thị với người dùng có thể khó thay đổi sau này. Hiểu rõ việc ủy quyền và các bản ghi well-known được triển khai của bạn sử dụng. Kiểm tra khám phá máy khách và liên hợp thay vì cho rằng đăng nhập web thành công chứng minh cả hai.
Sử dụng một ngăn xếp được hỗ trợ
Synapse thường dùng PostgreSQL cho dữ liệu sản xuất, với các dịch vụ hỗ trợ tùy thuộc vào quy mô và cấu hình. Hãy làm theo các khuyến nghị hiện hành từ upstream. Giữ thời gian chờ của worker, cơ sở dữ liệu và reverse proxy tương thích với tải.
Giữ các tuyên bố mã hóa chính xác
Mã hóa đầu cuối bảo vệ nội dung trong các phòng được mã hóa được hỗ trợ giữa các máy khách tham gia. Máy chủ nhà vẫn có thể xử lý siêu dữ liệu và nội dung không được mã hóa. Sao lưu khóa máy khách, xác minh và khôi phục tài khoản cần có giải thích riêng.
Duy trì instance
Hạn chế đăng ký khi thích hợp, bảo vệ các giao diện quản trị và bí mật chia sẻ, và đặt thời gian lưu giữ phương tiện và sự kiện có chủ đích. Sao lưu cơ sở dữ liệu, cấu hình và khóa ký một cách nhất quán, sau đó kiểm tra khôi phục.
Kiểm tra riêng client và đường liên hợp
Một ứng dụng khách như Element truy cập API máy khách của homeserver, trong khi các homeserver khác sử dụng khám phá liên hợp và các endpoint. Một thay đổi reverse-proxy có thể làm hỏng một bên trong khi bên kia vẫn hoạt động. Hãy thử một tài khoản mới, một phòng cục bộ và một phòng liên hợp được cấp phép, sau đó xác minh hành vi mã hóa và khôi phục từ ứng dụng khách.
Tài liệu chính thức: Hướng dẫn cài đặt Synapse hiện tại
Giữ vật liệu định danh bền vững
Cơ sở dữ liệu không phải toàn bộ danh tính homeserver. Bảo toàn khóa ký cùng cấu hình và bí mật liên quan bằng bản sao lưu nhất quán. Kiểm tra phương tiện ngoài và lịch sử nào được giữ lại và đặt chính sách phù hợp với cộng đồng của bạn. Giám sát lưu trữ và hàng đợi xử lý trước khi tăng trưởng thành sự cố.
Tách tên tài khoản khỏi điểm cuối lưu trữ
Quyết định server_name của Matrix trước khi tạo tài khoản: nó trở thành một phần của mã định danh người dùng và phòng. Tên máy chủ web phục vụ Synapse có thể khác khi cấu hình khám phá/ủy quyền đúng cách. Lập kế hoạch cho cả khám phá máy khách và khám phá máy chủ với máy chủ, một chứng chỉ hợp lệ và họ địa chỉ thực sự có thể truy cập. Element là một máy khách, không phải sự thay thế cho homeserver. Giữ một tuyến quản trị viên độc lập và một liên hệ khôi phục bên ngoài homeserver.
- Chọn một bản phát hành Synapse được hỗ trợ và một triển khai PostgreSQL phù hợp cho môi trường sản xuất.
- Giữ cơ sở dữ liệu và các listener quản trị ở chế độ riêng tư.
- Xác định rõ ràng chính sách đăng ký và liên kết.
Tài liệu chính thức: Cài đặt Synapse · Ủy quyền Matrix
Xây dựng khám phá và proxy như một phần của dịch vụ
Tạo cấu hình cho bản phát hành đã chọn, lưu bền khóa ký và cơ sở dữ liệu, rồi cấu hình proxy theo hướng dẫn chính thức của Synapse. Origin hiển thị bên ngoài, header chuyển tiếp và đường dẫn yêu cầu phải khớp nhau. Nếu dùng ủy quyền, hãy phục vụ các tài liệu well-known cần thiết từ miền danh tính. Không để lộ cổng API nội bộ thô để giải quyết lỗi proxy. Giữ bí mật đăng ký ngoài cấu hình ứng dụng khách trình duyệt.
Tài liệu chính thức: Proxy ngược Synapse
Kiểm tra một phiên máy khách và một phiên liên kết
Tạo tài khoản thử nghiệm, kết nối một ứng dụng khách được hỗ trợ, gửi tin nhắn cục bộ và tải lên một tệp nhỏ. Xác minh khám phá ứng dụng khách độc lập với khám phá liên hợp, sau đó thử nghiệm một phòng với máy chủ khác được phép nếu dự định liên hợp. Trong một phòng được mã hóa, thực hành xác minh và quy trình khôi phục khóa của ứng dụng khách. Sao lưu homeserver không tự động khôi phục mọi khóa giải mã do ứng dụng khách nắm giữ. Giải thích siêu dữ liệu nào máy chủ lưu giữ và phòng nào được mã hóa.
# 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/serverDùng vị trí lỗi để thu hẹp phạm vi sửa chữa
Nếu Element không thể khám phá máy chủ, hãy kiểm tra phản hồi well-known của ứng dụng khách và nguồn gốc TLS. Nếu nhắn tin cục bộ hoạt động nhưng liên hợp thất bại, hãy kiểm tra ủy quyền liên hợp, địa chỉ có thể truy cập, chứng chỉ và chính sách. Lỗi phương tiện lặp lại có thể liên quan đến giới hạn tải lên hoặc lưu trữ. Hãy bảo toàn cơ sở dữ liệu, phương tiện, cấu hình và khóa ký một cách nhất quán; kiểm thử khôi phục trước tiên khi chưa bật liên hợp, để một buổi diễn tập không tạo ra bản sao cạnh tranh của danh tính sản xuất.