Configura un alias de sala Matrix personalizado en tu propio dominio.

Para asignar una dirección a una sala de Matrix, como por ejemplo #support:example.com, crea un alias de sala local en el servidor principal cuyo nombre de servidor configurado sea example.com, y luego selecciona ese alias como la dirección principal de la sala en Element. No necesitas un registro DNS independiente para cada alias de sala, pero no puedes cambiar el dominio de alias de un servidor principal existente simplemente configurando el DNS para que apunte a él.

Comprenda qué controla el dominio personalizado.

Un alias de sala es una dirección legible que se resuelve en el ID permanente de una sala Matrix , un identificador que generalmente comienza con !. Una sala puede tener varios alias, por ejemplo #support:example.comy #help:example.com, ambos apuntando a la misma sala. El texto después de los dos puntos identifica al servidor principal responsable de resolver ese alias, no necesariamente al servidor que aloja a todos los participantes.

Matrix define alias en el formato #localpart:server-name. Para Synapse, la server_nameconfiguración determina el dominio utilizado para las direcciones de sala creadas localmente, y Synapse documenta que esta configuración no se puede cambiar después de la configuración inicial. Si su servidor existente se llama matrix.example.com, Element no convertirá sus alias locales en #support:example.comsolo porque usted sea propietario de example.com. Consulte la especificación del identificador de Matrix y el manual de configuración de Synapse .

Compruebe los requisitos previos

  • Un servidor doméstico Matrix en funcionamiento: Este ejemplo asume que Synapse ya está atendiendo solicitudes de API de cliente en https://matrix.example.commientras que su configuración server_namees example.com. La URL del cliente y el nombre del servidor pueden diferir.
  • Una sala existente: Crea la sala primero si es necesario. Decide un alias corto y reconocible para la parte local, como por ejemplo support. Un alias debe ser único en el servidor que lo crea.
  • Permisos para administrar direcciones: Inicie sesión con una cuenta autorizada para crear el alias local y cambiar la dirección principal de la sala. La política de creación de alias del servidor y los niveles de permisos de la sala pueden restringir estas acciones.
  • Una forma de probarlo: mantenga disponible una segunda cuenta de Matrix, idealmente en otro servidor doméstico, para que pueda comprobar la detección independientemente de su sesión de administrador.

Crea el alias en Element Web.

La siguiente ruta coincide con la terminología de configuración de salas que aparece en la documentación de configuración de salas de Element, revisada en octubre de 2026. La posición de los menús puede variar según las versiones de Element y otros clientes de Matrix.

1. Abra la configuración de la habitación.

En Element Web o Element Desktop, abra la sala de destino. Seleccione Configuración de la sala en el panel de información de la sala o utilice el menú de tres puntos de la sala y seleccione Configuración . Si necesita el ID interno de la sala para solucionar problemas más adelante, consulte la sección Avanzado y cópielo sin modificar ningún carácter.

2. Agregar una dirección local

En la página de configuración general , busque Direcciones de sala y luego Direcciones locales . Ingrese el alias localpart, como support, en el campo Dirección de sala y seleccione Agregar o el control de guardar equivalente. Confirme que la dirección completa resultante sea #support:example.com. Si termina en :matrix.example.com, deténgase: se trata de un problema con el nombre del servidor principal, no de un error tipográfico que la configuración de la sala pueda corregir.

3. Elija la dirección principal

En la sección Direcciones de sala , busque Direcciones publicadas y establezca Dirección principal en #support:example.com. La documentación de Element indica que la primera dirección local creada se selecciona automáticamente como dirección principal. Seleccionarla explícitamente resulta útil cuando la sala ya tiene varios alias.

La dirección principal es el alias canónico de la sala : la dirección preferida que se anuncia en el estado de la sala. Crear un alias y elegir el alias canónico son acciones relacionadas pero distintas. Matrix también admite alias alternativos anunciados. Un alias canónico ya debería resolverse a esa sala antes de que se anuncie.

4. Decide si la habitación debería figurar en un directorio.

Solo active la opción "Publicar esta sala en el directorio de salas públicas" si realmente desea que la sala sea visible en el directorio. Establecer una dirección no convierte automáticamente una sala en pública, y la publicación de una sala es independiente de sus reglas de acceso. Una sala privada o solo por invitación puede tener un alias fácil de recordar sin otorgar permiso a todos para unirse. Para las salas comunitarias públicas, revise tanto la configuración del directorio como las reglas de acceso de la sala antes de compartir la dirección.

Utilice la API de Matrix si el cliente no puede agregar la dirección.

Los administradores y las herramientas de automatización pueden usar la API estándar de Matrix Cliente-Servidor . El siguiente ejemplo crea el mismo alias; no lo ejecute si el Elemento ya está creado #support:example.com. Sustituya el ID de la sala real y un token de acceso válido para un usuario autorizado por la política de alias del servidor principal. Trate el token como una contraseña.

curl --request PUT \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --data '{"room_id":"!yourRoomId:example.com"}' \
  'https://matrix.example.com/_matrix/client/v3/directory/room/%23support%3Aexample.com'

Una solicitud exitosa devuelve HTTP 200con un objeto JSON vacío. Las partes %23y son codificación URL para y . La solicitud PUT crea una asignación de alias a sala; no necesariamente cambia el alias canónico de la sala. Después de una creación solo mediante API, vuelva al control de Dirección principal de Element si desea que ese alias se anuncie como el principal. No pegue un token de portador real en un comando de shell compartido, captura de pantalla o ticket de soporte.%3A#:

Compruebe que la asignación se resuelve.

La búsqueda en el directorio no requiere inicio de sesión. Reemplace el host de la URL con su propio punto final de API de cliente accesible:

curl --fail-with-body --silent --show-error \
  'https://matrix.example.com/_matrix/client/v3/directory/room/%23support%3Aexample.com'

La respuesta debe contener un room_ididentificador que coincida con la sala de destino y una serversmatriz. Esta prueba verifica la resolución de alias, no si todos los servidores remotos pueden federarse con el suyo.

Resolver los fallos comunes

El alias tiene el dominio incorrecto.

Verifique la configuración de Synapse server_name. No modifique este valor en un servidor ya establecido para intentar cambiar el nombre de sus alias: su identidad y los identificadores de Matrix existentes dependen de ello. Para una nueva implementación, planifique el nombre de servidor deseado antes de crear usuarios y salas. Si ya opera con otro nombre, usar su dominio de alias real puede ser la opción más segura, a menos que pueda configurar un servidor principal con el nombre adecuado para que sea el propietario de los nuevos alias.

La creación falla con el error 403 o 409.

HTTP 403suele indicar permiso denegado o una política de servidor aplicable. Compruebe los privilegios de sala del usuario y las reglas de Synapse alias_creation_rules; estas se evalúan en orden y una lista explícitamente vacía impide la creación de alias. HTTP 409significa que el alias ya existe. Elija una parte local diferente o investigue la asignación existente en lugar de sobrescribirla sin más. El manual de configuración de Synapse documenta las opciones de la política de alias.

Los usuarios de otros servidores no pueden encontrar la sala.

Primero, verifique que el alias se resuelva localmente. Si la búsqueda local se realiza correctamente, pero la detección externa falla, inspeccione la federación del dominio del alias , incluidos los certificados HTTPS, la /.well-known/matrix/serverdelegación correspondiente y el oyente de federación expuesto. Un nombre de host utilizado para el tráfico del cliente no establece automáticamente la federación para un nombre de servidor Matrix diferente. La API de servidor-servidor de Matrix describe la detección y delegación de servidores. Confirme también que se permita la entrada a usuarios remotos; una sala solo por invitación puede resolverse correctamente pero rechazar la entrada.

Verifique la dirección de la habitación personalizada.

  1. Verifique que #support:example.comaparezca en Direcciones locales y como la Dirección principal prevista en Elemento.
  2. Ejecute la solicitud GET de directorio no autenticado que se muestra arriba y compárela room_idcon el ID que aparece en la configuración avanzada de la sala de Element.
  3. Desde otra cuenta, intenta abrir https://matrix.to/#/%23support%3Aexample.com. El enlace debería dirigirte a la sala esperada; la posibilidad de unirse a la cuenta depende de las reglas de acceso de la sala.

La referencia de formato de Matrix, que incluye el alias de sala, define el formato de enlace compartido codificado. Si las tres comprobaciones se superan, la nueva dirección está lista para compartirse, mientras que el ID de sala original permanece sin cambios.

Dejar un comentario

Configura un alias de sala Matrix personalizado en tu propio dominio.

Asigne a una sala de Matrix una dirección fácil de compartir en su dominio utilizando Element o la API de Matrix, con comprobaciones de permisos, nomenclatura Synapse y federación.

Configurar la función de devolución conjunta para llamadas de voz y vídeo fiables de Matrix.

Configure coturn y Synapse con las credenciales TURN correspondientes, abra los puertos de retransmisión necesarios y verifique que los clientes de Matrix puedan obtener candidatos de retransmisión.

Implementar Matrix Synapse con Docker Compose y PostgreSQL

Implementar Matrix Synapse con Docker Compose y PostgreSQL

Configura un servidor Synapse persistente con Docker Compose, PostgreSQL, una configuración privada y comprobaciones antes de exponerlo a través de HTTPS.

Personaliza el tema y la imagen de marca de Element Web.

Define un nombre de marca, colores personalizados y elementos de inicio de sesión para tu implementación de Element Web, teniendo en cuenta qué partes conservarán la marca Element.

Aumenta el límite de archivos de Systemd de Synapse sin tener que adivinar.

Aumenta el límite de archivos de Systemd de Synapse sin tener que adivinar.

Diagnostique si Synapse alcanzó su límite de archivos abiertos por proceso, configure un archivo de configuración de systemd para el servicio o trabajador adecuado y verifique el límite en tiempo real.

¿El elemento muestra "Error al descifrar"? Recupere la llave de la habitación que falta.

¿El elemento muestra "Error al descifrar"? Recupere la llave de la habitación que falta.

Averigua si el error se limita a un navegador o a un evento específico y, a continuación, utiliza la clave de recuperación de Element o un dispositivo de confianza sin poner en riesgo el historial cifrado restante.

Limpia los mensajes y archivos multimedia antiguos de Synapse sin perder datos.

Utilice las API de historial y eliminación de medios de Synapse o la configuración de retención para eliminar datos obsoletos de forma segura y, a continuación, verifique que el proceso se haya completado y que se haya recuperado el espacio en disco.

Crea un bot de eco de matriz en Python con Simple-Matrix-Bot-Lib.

Crea un bot de eco de matriz en Python con Simple-Matrix-Bot-Lib.

Instala la biblioteca actual, conecta una cuenta Matrix dedicada y ejecuta un pequeño bot !echo con un manejo de credenciales más seguro y una prueba clara.

Conecta Matrix con WhatsApp, Telegram y Discord mediante puentes separados.

Conecta Matrix con WhatsApp, Telegram y Discord mediante puentes separados.

Configure tres puentes mautrix con registros, inicios de sesión y pruebas independientes, y evite sorpresas con la red, la política de cuentas y la sincronización de Docker.

Recupera espacio en disco de Synapse Media sin dañar los archivos compartidos.

Descubre qué está llenando el almacenamiento de Synapse, configura la retención segura de medios y purga la caché remota sin eliminar archivos directamente del disco.