Aloja Element Web en Nginx con un servidor Homeserver personalizado.

Para alojar un cliente Element Web personalizado en Nginx, descargue una versión oficial precompilada de Element Web, coloque sus archivos estáticos en su servidor web, configúrelo config.jsoncon su servidor principal Matrix y sirva el sitio a través de HTTPS. Nginx no ejecuta Element en sí mismo: sirve los archivos de la aplicación del navegador, mientras que la aplicación se conecta por separado a su servidor principal Matrix. Use un nombre de host diferente para el cliente y el servidor principal, como chat.example.comy matrix.example.com.

Esta guía presupone Debian o Ubuntu, un servidor Nginx con un nombre DNS público y un servidor Matrix existente accesible mediante HTTPS. Utiliza el archivo de lanzamiento oficial en lugar de una versión de desarrollo. La documentación actual del proyecto Element describe la aplicación web desplegada como contenido estático y requiere configuración clave y URL de punto de entrada para evitar el almacenamiento en caché. Consulte las notas de la versión y la documentación de configuración actual al elegir una versión o modificar las opciones.

1. Prepara el nombre de host y el servidor.

Cree un registro A que chat.example.comapunte a la dirección IPv4 pública del servidor Nginx. Añada un registro AAAA solo si el servidor es accesible a través de IPv6. Permita el tráfico entrante a través de los puertos TCP 80 y 443 mediante el firewall del host y el firewall de la nube. Confirme que estos puertos no estén siendo utilizados por otro servidor web.

Instala Nginx y crea un directorio para la aplicación web:

sudo apt update
sudo apt install nginx
sudo mkdir -p /var/www/element

En otra máquina, abre la página oficial de versiones de Element Web y elige una versión estable publicada. Descarga su archivo web precompilado y transfiérelo al servidor. Evita usar la developrama o una versión de desarrollo para un servicio público, a menos que tengas intención de ejecutar software en vista previa.

2. Instale los archivos estáticos y configure el servidor de inicio.

Primero, extraiga el archivo de la versión en un directorio temporal. Inspeccione la estructura de nivel superior del archivo y luego copie sus archivos web en /var/www/element; conserve la estructura de directorios de la versión. La estructura del paquete puede cambiar, así que asegúrese de que index.html, los bundles, i18ny el archivo de configuración se ubiquen donde apuntará la raíz del documento de Nginx.

sudo mkdir -p /tmp/element-release
tar -xzf /tmp/element-web-REPLACE_WITH_RELEASE.tar.gz -C /tmp/element-release
find /tmp/element-release -maxdepth 2 -name index.html

Utilice el directorio que contiene index.htmlcomo origen al copiar el contenido de la versión a /var/www/element. Si el archivo tiene un directorio de nivel superior versionado, copie el contenido de ese directorio en lugar de crear un nivel anidado adicional. No reemplace una implementación en producción hasta que los nuevos archivos estén completos; una copia incompleta puede dejar a los usuarios con paquetes JavaScript faltantes.

Copie la versión config.sample.jsonsi config.jsonel archivo la proporciona y luego edite el nuevo archivo. Element necesita una configuración de conexión de servidor principal predeterminada para iniciarse. El formato preferido admitido es default_server_config, utilizando la URL base de la API del cliente. El siguiente ejemplo es ilustrativo; reemplace la URL con la URL real que sirve su servidor principal Matrix:

{
  "default_server_config": {
    "m.homeserver": {
      "base_url": "https://matrix.example.com"
    }
  },
  "brand": "Example Chat"
}

La documentación de configuración de Element también admite default_server_name, que se basa en el .well-knowndescubrimiento de Matrix. Úselo default_server_configcuando desee especificar directamente la URL del servidor principal. No incluya contraseñas, tokens de acceso, claves de firma ni otros secretos en este archivo JSON público. La brandopción modifica algunas etiquetas de la aplicación; no se trata de un cambio de marca completo.

3. Configurar Nginx para la aplicación

Crea un bloque de servidor Nginx como este /etc/nginx/sites-available/element. Reemplaza el dominio si es necesario. Esta configuración simple sirve Element como archivos estáticos y envía las rutas faltantes a index.html, mientras marca todas las respuestas para su revalidación. Esta política de caché conservadora evita que los usuarios reciban una aplicación o configuración obsoleta después de un lanzamiento; puedes ajustar el almacenamiento en caché de recursos más adelante si tu proceso de implementación conserva las rutas sin caché requeridas por Element.

server {
    listen 80;
    listen [::]:80;
    server_name chat.example.com;

    root /var/www/element;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
        add_header Cache-Control "no-cache" always;
        add_header X-Frame-Options SAMEORIGIN always;
        add_header X-Content-Type-Options nosniff always;
        add_header Content-Security-Policy "frame-ancestors 'self'" always;
    }
}

Las notas de alojamiento web de Element indican que no se debe almacenar en caché /config.*.json, /i18n, /version, ni /index.html, y recomiendan la revalidación del navegador al cargar la página. El ejemplo sirve no-cachecomo punto de partida sencillo para todo. También incluye los encabezados de seguridad que recomienda Element, como una política de marcos y protección contra la detección de MIME. Si ya ha definido una Política de Seguridad de Contenido en otro lugar, incorpórela frame-ancestors 'self'a dicha política en lugar de enviar políticas conflictivas.

Habilita el sitio y valida Nginx antes de recargarlo:

sudo ln -s /etc/nginx/sites-available/element /etc/nginx/sites-enabled/element
sudo nginx -t
sudo systemctl reload nginx

4. Agregue HTTPS y pruebe el cliente.

El elemento debe servirse a través de HTTPS. Una vez que el DNS se resuelva a este servidor y el puerto 80 sea accesible, instale Certbot siguiendo las instrucciones vigentes para su distribución. A continuación, solicite e instale un certificado con su integración para Nginx. El proyecto Certbot documenta el certbot --nginxflujo y las comprobaciones de renovación; la instalación del paquete varía según el sistema operativo, así que utilice las instrucciones vigentes para Nginx correspondientes a su versión. Si Certbot modifica el bloque del servidor, vuelva a ejecutarlo sudo nginx -ty confirme que la renovación está programada.

Ábrelo https://chat.example.comen una ventana privada del navegador. La pantalla de inicio de sesión de Element debería cargarse sin scripts ni estilos faltantes, mostrar el servidor de inicio esperado y tener un icono de candado válido en la barra de direcciones del navegador. Inicia sesión con una cuenta de prueba y confirma que el navegador puede acceder al servidor de inicio. Si el inicio de sesión falla, inspecciona la consola del desarrollador del navegador y el panel de red en busca de solicitudes bloqueadas, errores de certificado o un base_url.

Problemas comunes de implementación

  • Una página en blanco o cargada parcialmente: compruebe que Nginx rootapunta al directorio que contiene index.html, y que los paquetes y i18nel directorio se copiaron junto con él.
  • Aparece el servidor de inicio incorrecto: valide la sintaxis JSON config.jsony confirme que el archivo se encuentra en la raíz web. Si configura un dominio específico config.chat.example.com.json, Element intenta usar ese archivo antes que config.json; los archivos no se combinan.
  • Los usuarios ven configuraciones antiguas después de una actualización: asegúrese de que index.html, version, i18n, y el JSON de configuración no se almacenen en caché. Borre o vuelva a validar las cachés del navegador después de cambiar la política de Nginx.
  • El inicio de sesión se carga correctamente, pero las solicitudes a la API fallan: compruebe que la URL del servidor principal sea correcta, utilice HTTPS y esté configurada para el acceso desde el navegador, incluyendo el comportamiento CORS adecuado cuando sea necesario. Hosting Element en Nginx no actúa como proxy ni reemplaza al servidor principal de Matrix.

Para una implementación exitosa, el cliente se carga en el dominio personalizado a través de HTTPS, su configuración apunta al servidor principal previsto y una cuenta de prueba puede iniciar sesión sin que se produzcan fallos en las solicitudes de red. Las notas de alojamiento web de Element y la documentación del índice de Nginx son las referencias principales para la implementación estática y el comportamiento del bloque de servidor que se describen aquí.

Dejar un comentario

Restaura Matrix Synapse de forma segura con un volcado de PostgreSQL.

Realice una copia de seguridad de Synapse con pg_dump, proteja su clave de firma y el medio de almacenamiento, y restáurela en una base de datos PostgreSQL limpia sin reutilizar claves obsoletas de un solo uso.

Ejecuta Mjölnir como un bot de moderación de salas Matrix con Docker.

Ejecuta Mjölnir como un bot de moderación de salas Matrix con Docker.

Configura Mjölnir con una cuenta Matrix dedicada, una sala de administración cifrada, Docker Compose, una lista de políticas y comprobaciones de permisos.

Habilita la sincronización nativa de la matriz deslizante para una carga más rápida en dispositivos móviles.

Habilita la sincronización nativa de la matriz deslizante para una carga más rápida en dispositivos móviles.

Omita el proxy obsoleto y configure la sincronización deslizante integrada de Synapse. Verifique la detección de clientes y luego mida la carga de la lista de salas y el comportamiento de reconexión en un teléfono compatible.

Aloja Element Web en Nginx con un servidor Homeserver personalizado.

Implementa Element Web como un sitio estático, apúntalo a tu servidor principal Matrix, agrega HTTPS y configura Nginx para que sirva las actualizaciones sin archivos obsoletos.

Ejecuta un servidor doméstico Matrix ligero en Raspberry Pi 4

Configura Conduit en una Raspberry Pi 4 de 64 bits con datos persistentes, federación HTTPS, registro protegido y comprobaciones para un servidor doméstico en funcionamiento.

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.