Elige el nombre del servidor
El nombre del servidor visible para el usuario puede ser difícil de cambiar más adelante. Comprenda la delegación y los registros conocidos que utiliza su despliegue. Pruebe el descubrimiento de clientes y la federación en lugar de suponer que un inicio de sesión web exitoso demuestra ambos.
Usa una pila compatible
Synapse suele usar PostgreSQL para los datos de producción, con servicios de apoyo que dependen de la escala y la configuración. Sigue las recomendaciones actuales del proyecto upstream. Mantén los tiempos de espera de los workers, la base de datos y el proxy inverso compatibles con la carga.
Mantén las afirmaciones de cifrado precisas
El cifrado de extremo a extremo protege el contenido en las salas cifradas compatibles entre los clientes participantes. El homeserver aún puede procesar metadatos y contenido no cifrado. La copia de seguridad de claves del cliente, la verificación y la recuperación de la cuenta necesitan su propia explicación.
Mantener la instancia
Restringe el registro cuando corresponda, protege las interfaces administrativas y de secretos compartidos y establece una retención deliberada de medios y eventos. Haz copias de seguridad de la base de datos, la configuración y las claves de firma de forma consistente y luego prueba la recuperación.
Pruebe por separado el cliente y las rutas de federación
Un cliente como Element llega al API de cliente del homeserver, mientras que otros homeservers usan el descubrimiento de federación y sus endpoints. Un cambio en el proxy inverso puede romper uno mientras el otro sigue funcionando. Prueba una cuenta nueva, una sala local y una sala federada autorizada, y luego verifica el comportamiento del cifrado y la recuperación desde el cliente.
Documentación oficial: Guía de instalación actual de Synapse
Conserva el material de identidad duradero
La base de datos no es toda la identidad del homeserver. Conserva la clave de firma y la configuración y los secretos relevantes con una copia de seguridad coherente. Comprueba qué medios externos e historial se conservan y establece una política adecuada para tu comunidad. Supervisa el almacenamiento y las colas de trabajadores antes de que el crecimiento se convierta en una caída del servicio.
Separa el nombre de la cuenta del endpoint de alojamiento
Decide el server_name de Matrix antes de crear la cuenta: pasa a formar parte de los identificadores de usuario y de sala. El nombre de host web que sirve Synapse puede ser distinto si la detección/delegación está configurada correctamente. Planifica tanto la detección de clientes como la detección servidor a servidor, un certificado válido y la familia de direcciones realmente accesible. Element es un cliente, no un sustituto del homeserver. Mantén una ruta de administrador independiente y un contacto de recuperación fuera del homeserver.
- Elige una versión de Synapse compatible y un despliegue de PostgreSQL adecuado para producción.
- Mantén privados los listeners de la base de datos y de administración.
- Define explícitamente la política de registro y federación.
Documentación oficial: Instalación de Synapse · Delegación de Matrix
Integra el descubrimiento y el proxy como parte del servicio
Genera la configuración para la versión seleccionada, conserva la clave de firma y la base de datos, y configura el proxy según la guía oficial de Synapse. El origen visible externamente, las cabeceras reenviadas y las rutas de solicitud deben coincidir. Si se usa delegación, sirve los documentos well-known requeridos desde el dominio de identidad. No expongas el puerto interno API sin procesar para resolver un error del proxy. Mantén los secretos de registro fuera de la configuración del cliente del navegador.
Documentación oficial: Proxy inverso de Synapse
Prueba una sesión de cliente y una sesión de federación
Crea una cuenta de prueba, conecta un cliente compatible, envía un mensaje local y sube un archivo pequeño. Verifica el descubrimiento del cliente de forma independiente del descubrimiento de federación y, después, prueba una sala con otro servidor permitido si la federación es tu objetivo. En una sala cifrada, ejercita la verificación y el flujo de recuperación de claves del cliente. La copia de seguridad del homeserver no restaura automáticamente todas las claves de descifrado que guardan los clientes. Explica qué metadatos conserva el servidor y qué salas están cifradas.
# 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/serverUsa la ubicación del error para acotar la reparación
Si Element no puede descubrir el servidor, inspecciona la respuesta well-known del cliente y el origen de TLS. Si la mensajería local funciona pero la federación falla, inspecciona la delegación de federación, las direcciones accesibles, los certificados y la política. Los fallos repetidos de medios pueden implicar límites de carga o almacenamiento. Conserva la base de datos, los medios, la configuración y las claves de firma de forma coherente; prueba la restauración sin la federación habilitada primero, para que un ejercicio no cree una copia competidora de la identidad de producción.