Configure um alias personalizado para a sala Matrix em seu próprio domínio.

Para atribuir um endereço como `myroom` a uma sala do Matrix #support:example.com, crie um alias de sala local no servidor doméstico cujo nome de servidor configurado seja `myroom` example.com, e selecione esse alias como o endereço principal da sala no Element. Você não precisa de um registro DNS separado para cada alias de sala, mas não é possível alterar o domínio de alias de um servidor doméstico existente simplesmente apontando o DNS para ele.

Entenda o que os controles de domínio personalizado oferecem.

Um alias de sala é um endereço legível que resolve para o ID permanente de uma sala Matrix , um identificador que geralmente começa com ` !. Uma sala pode ter vários aliases, por exemplo , `1000` #support:example.come #help:example.com`1000`, ambos apontando para a mesma sala. O texto após os dois pontos identifica o servidor responsável por resolver esse alias, e não necessariamente o servidor que hospeda todos os participantes.

O Matrix define aliases no formato ` <nome_do_servidor> #localpart:server-name`. Para o Synapse, a server_nameconfiguração `<domínio>` determina o domínio usado para endereços de salas criados localmente, e o Synapse documenta que essa configuração não pode ser alterada após a configuração inicial. Se o seu servidor existente se chama `<nome_do_servidor>` matrix.example.com, o Element não transformará seus aliases locais em `<nome_do_servidor>` #support:example.comapenas porque você é o proprietário de `<nome_do_servidor> example.com`. Consulte a especificação de identificadores do Matrix e o manual de configuração do Synapse .

Verifique os pré-requisitos

  • Um servidor doméstico Matrix em funcionamento: Este exemplo pressupõe que o Synapse já esteja atendendo solicitações de API do cliente em `http://localhost:8080` , https://matrix.example.comenquanto sua configuração server_nameé example.com`http://localhost:8080`. O URL do cliente e o nome do servidor podem ser diferentes.
  • Sala existente: Crie a sala primeiro, se necessário. Escolha um alias local curto e fácil de reconhecer, como support. O alias deve ser único no servidor que o cria.
  • Permissão para gerenciar endereços: Faça login com uma conta que tenha permissão para criar o alias local e alterar o endereço principal da sala. A política de criação de aliases do servidor e os níveis de privilégio da sala podem restringir essas ações.
  • Uma forma de testar: mantenha uma segunda conta Matrix disponível, idealmente em outro servidor doméstico, para que você possa verificar a descoberta independentemente da sua sessão de administrador.

Criar alias no Element Web

O caminho a seguir corresponde à terminologia de configurações de sala na documentação de configurações de sala do Element, consultada em outubro de 2026. As posições do menu podem variar entre as versões do Element e outros clientes Matrix.

1. Abra as Configurações do Quarto

No Element Web ou no Element Desktop, abra a sala de destino. Selecione " Configurações da sala" no painel "Informações da sala" ou use o menu de três pontos da sala e escolha " Configurações" . Se precisar do ID interno da sala para solucionar problemas posteriormente, consulte a seção "Avançado" e copie-o sem alterar nenhum caractere.

2. Adicionar um endereço local

Na página de configurações gerais , encontre Endereços de sala e, em seguida, Endereços locais . Insira o alias da parte local, como support, no campo Endereço da sala e selecione Adicionar ou o controle de salvar equivalente. Confirme se o endereço completo resultante é #support:example.com. Se, em vez disso, terminar em :matrix.example.com, pare: isso é um problema com o nome do servidor doméstico, não um erro de digitação que as configurações da sala podem corrigir.

3. Escolha o endereço principal

Ainda em Endereços de Sala , encontre Endereços Publicados e defina Endereço Principal como #support:example.com. A documentação do Element afirma que o primeiro endereço local criado normalmente é selecionado automaticamente como o endereço principal. Selecioná-lo explicitamente é útil quando a sala já possui vários aliases.

O endereço principal é o alias canônico da sala : o endereço preferencial anunciado no estado da sala. Criar um alias e escolher o alias canônico são ações relacionadas, mas distintas. O Matrix também suporta aliases alternativos anunciados. Um alias canônico já deve apontar para aquela sala antes de ser anunciado.

4. Decida se o cômodo deve constar em um diretório.

Habilite a opção "Publicar esta sala no diretório de salas públicas" somente se você realmente deseja que ela seja descoberta pelo diretório. Definir um endereço não torna uma sala pública por si só, e publicar uma sala é independente de suas regras de entrada. Uma sala privada ou somente para convidados pode ter um apelido memorável sem conceder permissão a todos para entrar. Para salas comunitárias públicas, verifique tanto a configuração do diretório quanto as regras de entrada da sala antes de compartilhar o endereço amplamente.

Use a API Matrix se o cliente não conseguir adicionar o endereço.

Administradores e ferramentas de automação podem usar a API padrão Cliente-Servidor do Matrix . O exemplo abaixo cria o mesmo alias; não o execute se o Elemento já tiver sido criado #support:example.com. Substitua o ID real da sala e um token de acesso válido para um usuário permitido pela política de aliases do servidor doméstico. Trate o token como uma senha.

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'

Uma requisição bem-sucedida retorna HTTP 200com um objeto JSON vazio. As partes %23` <alias>` e ` %3A<room>` são codificações de URL para ` <alias>` #e ` <room>` :. A requisição PUT cria um mapeamento de alias para sala; ela não altera necessariamente o alias canônico da sala. Após a criação de uma sala somente via API, retorne ao controle de Endereço Principal do Element se desejar que esse alias seja anunciado como o principal. Não cole um token de portador real em um comando de shell compartilhado, captura de tela ou ticket de suporte.

Verifique se o mapeamento foi resolvido.

A pesquisa de diretório não requer login. Substitua o host da URL pelo endpoint da API do seu cliente acessível:

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

A resposta deve conter uma room_idcorrespondência com a sala de destino e um serversarray. Este teste verifica a resolução de aliases, não se todos os servidores remotos podem se federar com o seu.

Resolva as falhas comuns

O alias tem o domínio errado.

Verifique a configuração do Synapse server_name. Não altere esse valor em um servidor já estabelecido na tentativa de renomear seus aliases: a identidade do servidor e os identificadores Matrix existentes dependem disso. Para uma nova implantação, planeje o nome desejado para o servidor antes de criar usuários e salas. Se você já opera com outro nome, usar o domínio do alias atual pode ser a opção mais segura, a menos que você consiga configurar um servidor doméstico com um nome apropriado para hospedar os novos aliases.

A criação falha com os códigos de erro 403 ou 409.

O erro HTTP 403geralmente indica permissão negada ou uma política de servidor aplicável. Verifique os privilégios da sala do usuário e as regras do Synapse alias_creation_rules; elas são avaliadas em ordem, e uma lista explicitamente vazia impede a criação de qualquer alias. O erro HTTP 409significa que o alias já existe. Escolha um localpart diferente ou investigue o mapeamento existente em vez de sobrescrevê-lo indiscriminadamente. O manual de configuração do Synapse documenta as opções de política de alias.

Pessoas em outros servidores não conseguem encontrar a sala.

Verifique primeiro se o alias é resolvido localmente. Se a pesquisa local for bem-sucedida, mas a descoberta externa falhar, inspecione a federação para o domínio do alias , incluindo certificados HTTPS, a delegação relevante /.well-known/matrix/servere o ouvinte de federação exposto. Um nome de host usado para tráfego de clientes não estabelece automaticamente a federação para um nome de servidor Matrix diferente. A API Servidor-Servidor do Matrix descreve a descoberta e a delegação de servidores. Confirme também se os usuários remotos têm permissão para entrar; uma sala somente para convidados pode ser resolvida com sucesso, mesmo recusando a entrada.

Verifique o endereço do quarto personalizado

  1. Verifique se o #support:example.comendereço aparece em Endereços Locais e como o Endereço Principal pretendido no Elemento.
  2. Execute a solicitação GET não autenticada para o diretório acima e compare o ID obtido room_idcom o ID exibido nas configurações avançadas da sala do Element.
  3. A partir de outra conta, tente abrir https://matrix.to/#/%23support%3Aexample.como link. Ele deve direcionar para a sala desejada; a possibilidade de a conta entrar ainda depende das regras de acesso da sala.

A referência de formato `room-alias` e `matrix.to` do Matrix define o formato do link de compartilhamento codificado. Se todas as três verificações forem aprovadas, o novo endereço estará pronto para ser compartilhado, enquanto o ID da sala original permanecerá inalterado.

Deixar um comentário

Configure um alias personalizado para a sala Matrix em seu próprio domínio.

Atribua um endereço fácil de compartilhar a uma sala do Matrix em seu domínio usando o Element ou a API do Matrix, com verificações de permissões, nomenclatura Synapse e federação.

Configure o Coturn para chamadas de voz e vídeo confiáveis ​​no Remake Matrix.

Configure o coturn e o Synapse com credenciais TURN correspondentes, abra as portas de retransmissão necessárias e verifique se os clientes Matrix conseguem obter candidatos de retransmissão.

Implante o Matrix Synapse com Docker Compose e PostgreSQL.

Implante o Matrix Synapse com Docker Compose e PostgreSQL.

Configure um servidor doméstico Synapse persistente com Docker Compose, PostgreSQL, uma configuração privada e verificações antes de expô-lo via HTTPS.

Personalize o tema e a identidade visual do Element Web.

Defina um nome de marca, cores personalizadas e recursos de login para sua implementação do Element Web, entendendo quais partes permanecerão com a marca Element.

Aumente o limite de arquivos do Systemd do Synapse sem complicações.

Aumente o limite de arquivos do Systemd do Synapse sem complicações.

Diagnostique se o Synapse atingiu seu limite de arquivos abertos por processo, configure um comando systemd para o serviço ou worker correto e verifique o limite em tempo real.

O Element exibe a mensagem “Falha ao descriptografar”? Restaure a chave da sala perdida.

O Element exibe a mensagem “Falha ao descriptografar”? Restaure a chave da sala perdida.

Descubra se o erro está limitado a um navegador ou a um evento específico e, em seguida, use a chave de recuperação do Element ou um dispositivo confiável sem arriscar seu histórico criptografado restante.

Limpe mensagens e arquivos de mídia antigos do Synapse sem perder dados.

Utilize as APIs de limpeza de histórico e mídia do Synapse ou as configurações de retenção para remover dados obsoletos com segurança e, em seguida, verifique a conclusão e a recuperação do espaço em disco.

Crie um bot de eco do Matrix em Python com a biblioteca Simple-Matrix-Bot-Lib.

Crie um bot de eco do Matrix em Python com a biblioteca Simple-Matrix-Bot-Lib.

Instale a biblioteca atual, conecte uma conta Matrix dedicada e execute um pequeno bot !echo com gerenciamento de credenciais mais seguro e um teste claro.

Conecte o Matrix ao WhatsApp, Telegram e Discord com pontes separadas.

Conecte o Matrix ao WhatsApp, Telegram e Discord com pontes separadas.

Configure três bridges Mautrix com registros, logins e testes separados — e evite surpresas com a rede Docker, políticas de conta e sincronização.

Recupere espaço em disco do Synapse Media sem afetar os arquivos compartilhados.

Descubra o que está ocupando espaço no armazenamento do Synapse, defina um período seguro de retenção de mídia e limpe o cache remoto sem excluir arquivos diretamente do disco.