Esta página es una traducción automática de la página en inglés, que es la versión de referencia. Leer la página en inglés
Lista de comprobación para producción
Repasa esta lista antes de abrir el servidor a los usuarios y a otros servidores, y de nuevo después de cualquier cambio en el despliegue. Algunas opciones de configuración no se pueden cambiar una vez que el servidor ha federado, y algunos errores, como perder la clave de cifrado de claves, no se pueden deshacer en absoluto.
Cada punto indica por qué importa, cómo verificarlo y dónde están los detalles. Empieza por la parte automatizada:
my config check # the configuration, and the settings that do not suit productionmy config check -instance # also the instance settings in the databaseQué comprueba my config check
Sección titulada «Qué comprueba my config check»En el perfil production (el valor por defecto de profile), my config check
primero valida toda la configuración y después comprueba que la configuración válida es adecuada para una instancia de producción.
Los problemas se enumeran en dos grupos, bajo un resumen en el idioma de la configuración regional del proceso, cada uno con el detalle técnico
en inglés:
- Los errores hacen que
my config checktermine con código 1. Son valores de configuración que rompen una instancia de producción o debilitan su seguridad:- Un
hostoaccount_domainal que otros servidores no pueden llegar: con un puerto,localhost, un nombre sin punto, o un nombre bajo un dominio de primer nivel reservado para uso local o pruebas (.localhost,.local,.test,.example,.invalid,.internal,.home.arpa). - Un
web_originsobrehttp. - Un
database_urlde SQLite que mantiene la base de datos en memoria. - Un
kekque no es aleatorio, como todo ceros o un byte repetido. - Una clave de sitio o una clave secreta de
captchaque es una de las claves de prueba que publican los servicios de CAPTCHA. worker_job_types,worker_job_types_excepto una ruta de cola que no nombra ningún tipo de trabajo (en todos los perfiles;my job typeslos enumera).- Con
-instance, unworker_job_concurrencyque el pool de la base de datos no puede atender.
- Un
- Las advertencias dejan el código de salida en 0. Son valores de configuración habituales en desarrollo que pueden ser deliberados en producción:
mail = none.- Una base de datos SQLite o el almacén de blobs
fsen un directorio temporal (/tmp,/var/tmp,/dev/shmo$TMPDIR). queue = inline.- Falta de
vapid_private_key. stream = hubokv = memorycon unroledistinto deall: solo funcionan dentro de un único proceso.- Ajustes de voz que probablemente no eran los deseados, como
voice = p2psin STUN ni TURN. - Un plugin en una dirección
http://, o en una direcciónhttps://sin token ni certificado de cliente. - Una clave en modo de prueba del proveedor de pagos.
origin_secretestablecido con untrusted_proxiesvacío, yorigin_secret_previousque sigue establecido tras una rotación.- Con
-instance: los textos de instancianame,short_description,termsyprivacy_policy, la configuración de instanciacontact_account,contact_emailysecurity_contactcuando no están establecidos, y un servidor sin reglas. Cuando no se puede acceder a la base de datos, eso es una advertencia más y el resto de la comprobación se sigue ejecutando.
my serve registra los mismos hallazgos como advertencias al arrancar, pero arranca de todos modos.
El perfil development omite estas comprobaciones; úsalo para el desarrollo local y las pruebas, nunca para una instancia que usen otras personas.
Ejecuta my config check en el mismo entorno que el servidor (las mismas variables de entorno, archivos de secretos y archivo de configuración),
por ejemplo como un paso del despliegue antes de que la nueva versión reciba tráfico.
Ajustes que no puedes cambiar después
Sección titulada «Ajustes que no puedes cambiar después»El dominio del servidor y el dominio de los identificadores
Sección titulada «El dominio del servidor y el dominio de los identificadores»- Por qué:
hostforma parte de cada id de ActivityPub del servidor, y otros servidores guardan esos ids.account_domaines el dominio de los identificadores (@alice@example.org). El primermy serveo comandomyque usa la base de datos registra ambos en ella, y a partir de entoncesmy servey esos comandos se niegan a ejecutarse cuando la configuración difiere: un cambio después de federar rompe todos los seguimientos y todas las referencias a las publicaciones y cuentas del servidor. Establece ambos antes del primer arranque. Un error detectado antes de federar se corrige recreando la base de datos, lo que borra todas las filas. - Decide: si los identificadores usan el dominio del servidor o uno aparte (por ejemplo, identificadores en
example.orgy el servidor ensocial.example.org). Un dominio de identificadores aparte debe redirigir su WebFinger, host-meta y NodeInfo al servidor. - Verifica:
my config checkmuestrahostyaccount_domaine informa de un dominio al que otros servidores no pueden llegar.my config check -instancetambién falla cuando difieren de los valores de la base de datos, y no registra nada. Con un dominio de identificadores aparte,curl -sI "https://<account_domain>/.well-known/webfinger?resource=acct:<user>@<account_domain>"responde301ahttps://<host>/.well-known/webfinger?.... - Detalles: ejecutar el servidor (los endpoints de federación y cómo servir los identificadores desde otro dominio),
hostyaccount_domain.
Accesible por https
Sección titulada «Accesible por https»- Por qué: otros servidores obtienen los ids en
https://<host>/en el puerto 443, y los navegadores envían las cookies de inicio de sesión solo porhttps. - Verifica:
curl -sI https://<host>/health/liveresponde200desde fuera de tu red con un certificado válido parahost, ymy config checkno informa de ningún error sobreweb_origin,tls,tls_acme_agree_termsnitls_cert_file.curl -sI http://<host>/responde301ahttps://<host>/. O bien el proxy inverso, el balanceador de carga o la CDN delante del servidor termina TLS y redirige (con Docker Compose, la capacompose.caddy.yamles uno de esos proxies), o lo hace el propio servidor. Contls = acme,my tls statusmuestra un certificado parahost(y para el host deweb_origincuando difiere) cuyo emisor no es uno de pruebas:tls_acme_directoryno está definido o nombra un directorio de producción. Pon una alerta sobre su caducidad y sobre los pedidos fallidos (alertas). Contls = files,my config checkavisa cuando quedan menos de 14 días al certificado, y lo que lo renueve debe mantenertls_cert_fileytls_key_fileal día. - Detalles: ejecutar el servidor, servir HTTPS desde el servidor,
web_origin,tls.
Inaccesible esquivando el CDN
Sección titulada «Inaccesible esquivando el CDN»- Por qué: con un CDN delante y la dirección propia del servidor todavía pública (
*.run.appen Cloud Run), cualquiera puede llamar al servidor esquivando el WAF y la caché, y quien llame desde la propia plataforma del CDN puede elegir la IP de cliente que ven los límites de frecuencia. Solo hace falta en ese caso: no cuando un cortafuegos o la plataforma ya limitan quién puede conectarse, y sin un CDN no hay nada que esquivar. - Verifica:
origin_secretyorigin_secret_headerestán establecidos y el CDN establece la cabecera en todos los nombres de host.curl -s -o /dev/null -w '%{http_code}\n' https://<origin address>/responde403, su/health/liveresponde200yhttps://<host>/responde200. - Detalles: Rechazar solicitudes que no han pasado por el CDN, incluido cómo recuperarse cuando deja a todos fuera.
Secretos
Sección titulada «Secretos»La clave de cifrado de claves (KEK)
Sección titulada «La clave de cifrado de claves (KEK)»- Por qué: la KEK cifra las claves privadas de todos los actores. Sin ella el servidor no puede firmar nada, y las claves no se pueden recuperar de la base de datos: habría que recrear todas las cuentas y otros servidores dejarían de confiar en él.
- Verifica:
- Se generó de forma aleatoria (
openssl rand -base64 32);my config checkinforma de una clave que no es aleatoria. - Se guarda en un lugar distinto de la base de datos y sus copias de seguridad, por ejemplo en un gestor de contraseñas o en el almacén de secretos de la nube, y al menos otra persona que gestione el servidor puede acceder a ella.
- Llega al servidor solo mediante
MY_KEKoMY_KEK_FILE(el archivo de configuración rechaza los secretos). Con Docker Compose, es el archivosecrets/keky no está en.env(Archivos de Docker Compose).
- Se generó de forma aleatoria (
- Detalles: gestión de claves.
La clave VAPID de Web Push
Sección titulada «La clave VAPID de Web Push»- Por qué: sin ella el servidor no envía notificaciones Web Push. Cambiarla más adelante termina todas las suscripciones, así que genérala una sola vez y consérvala como la KEK.
- Verifica:
my config checkavisa cuandovapid_private_keyno está establecida. Genera una conmy config vapid-key. - Detalles: gestión de claves (la clave VAPID de Web Push).
Los demás secretos quedan fuera del repositorio y de la imagen
Sección titulada «Los demás secretos quedan fuera del repositorio y de la imagen»- Por qué: un secreto en un repositorio, una imagen de contenedor o un archivo de configuración se copia a todos los lugares a los que van esos elementos.
- Verifica:
database_url,mail_smtp_password,captcha_secret_key, las claves del proveedor de pagos,valkey_urly cualquier otro ajuste marcado como secreto en la referencia de configuración proceden de variables de entorno o de archivos<NAME>_FILEque rellena el almacén de secretos de la plataforma (secretos de Docker o Kubernetes, Secret Manager, Parameter Store). El archivo de configuración no puede contenerlos:my config checkrechaza un secreto en él. Con Docker Compose, proceden de.env, que solo tú puedes leer (chmod 600). Busca los valores en el repositorio y en la imagen para asegurarte de que no queda ninguna copia.my config checkmuestra(redacted)para cada secreto establecido. - Detalles: referencia de configuración (la columna Secret), CAPTCHA, Stripe, PAY.JP.
Ajustes de instancia
Sección titulada «Ajustes de instancia»La configuración de instancia está en la base de datos y se pueden cambiar mientras el servidor funciona, en las pantallas de administración del servidor
o con my instance set. my config check -instance avisa de los textos, contactos y reglas que no están establecidos.
- Nombre, descripción corta y descripción: se muestran en la página de inicio, la página de información (
/about), las vistas previas de enlaces y NodeInfo. Verifícalo en/about. - Contactos:
contact_account(la cuenta con la que los usuarios contactan sobre el servidor) ycontact_email(la dirección a la que escriben los usuarios y otros servidores; los correos del servidor también dirigen a ella las respuestas). Verifícalo en/about. - Contacto para vulnerabilidades:
security_contact, un URIhttps:omailto:. Si está establecido, el servidor responde en/.well-known/security.txt. Verifícalo concurl -s https://<host>/.well-known/security.txt. - Términos del servicio y política de privacidad:
termsyprivacy_policy. La política de privacidad debe nombrar los servicios que reciben datos personales, como el servicio de CAPTCHA y el proveedor de correo. Verifica los enlaces en/abouty en la pantalla de registro. - Reglas del servidor: lo que los usuarios aceptan al registrarse y lo que hacen cumplir los moderadores. Añádelas con
my instance rule createo en las pantallas de administración, y verifícalas en/about. - Modo de registro:
registration_modeesapprovalhasta que lo cambies; eligeopen,approval,inviteoclosedsegún cómo se unan las personas. Conmail = none, los registrosopentambién esperan la aprobación de un moderador. - Buscadores e IA:
search_indexing,ai_usageeindexable_defaultrechazan ambos hasta que los permitas. Verifica/robots.txty/.well-known/tdmrep.json. - Página de estado: establece
status_page_url(un ajuste, no un ajuste de instancia, para que el enlace se muestre durante el mantenimiento) con una página de estado en un servicio distinto del servidor.
Detalles: configuración de la instancia, registro, buscadores y rastreadores de IA, CAPTCHA (qué escribir en la política de privacidad), plantilla de política de privacidad, plantilla del registro de actividades de tratamiento, monitorización (la página de estado).
Correo electrónico
Sección titulada «Correo electrónico»- Por qué: el correo electrónico verifica direcciones y envía restablecimientos de contraseña y notificaciones. Con
mail = noneningún correo llega a los usuarios. - Verifica:
mailessmtp,sesoplugin, ymail_fromes una dirección de un dominio que controlas;my config checkavisa demail = none.- El dominio de
mail_fromtiene registros SPF, DKIM y DMARC, y el proveedor firma con DKIM. Sin ellos, el correo acaba en spam. - Regístrate con una cuenta de prueba y recibe el correo de verificación; solicita un restablecimiento de contraseña y recibe también ese correo.
Comprueba en las cabeceras del mensaje recibido que aparecen
spf=pass,dkim=passydmarc=pass. - Con SES, la cuenta ha salido del sandbox y las notificaciones de rebotes y quejas llegan al servidor.
- Detalles: correo electrónico, registro (verificación del correo electrónico).
Administradores
Sección titulada «Administradores»- Por qué: la cuenta de un administrador puede cambiar toda la configuración, leer datos privados y suspender a cualquiera.
- Verifica:
- Todos los administradores activaron la autenticación en dos pasos (Configuración, Autenticación en dos pasos en el cliente web) y conservan los códigos de recuperación.
- Solo las personas que lo necesitan tienen el rol
admin; los moderadores tienenmoderatoro un rol con solo los permisos que usan. Enuméralos conmy admin roley revísalos en las pantallas de administración.
- Detalles: administradores y roles, moderación (permisos y recuperación de inicio de sesión).
Operaciones
Sección titulada «Operaciones»- Copias de seguridad y recuperación: la base de datos, el almacén de blobs (
blob_fs_diro el bucket) y la KEK tienen copias de seguridad programadas, en un lugar distinto del servidor, y se ha ensayado una restauración en un servidor nuevo: el servidor restaurado arranca y las cuentas pueden iniciar sesión y publicar. Una copia de seguridad que nunca se ha restaurado no se sabe si funciona. La base de datos y los archivos multimedia no deben estar en un directorio temporal;my config checkavisa cuando lo están. Consulta gestión de claves (copia de seguridad de la KEK) y base de datos. - Monitorización y alertas: un monitor externo comprueba
/health/livey avisa a alguien que pueda actuar, y se vigilan los trabajos fallidos (dead) de la cola de trabajos. Consulta monitorización y ejecutar el servidor (comprobaciones de salud, métricas y la cola de trabajos). - La imagen: la instancia ejecuta una imagen publicada fijada por digest (
ghcr.io/mycroblog/my:0.1.0@sha256:..., de las notas de la versión), no una que cambia al reiniciar, y se ha verificado su procedencia. No existe la etiquetalatest. Una actualización cambia esa versión a propósito y sigue Actualización, una versión menor cada vez. - Código fuente (AGPL-3.0): el servidor debe ofrecer su código fuente a todas las personas que lo usan. Deja
source_urlen su valor por defecto para una versión sin modificar; apúntalo a tu propio código fuente cuando ejecutes un fork o una versión modificada. Verifica el enlace en/about. Consulta ejecutar el servidor (publicación del código fuente). - Mantenimiento: aprende a poner el servidor en modo de mantenimiento antes de necesitarlo. Consulta mantenimiento.
Federación
Sección titulada «Federación»- Por qué: otros servidores encuentran las cuentas mediante WebFinger y NodeInfo y después obtienen el actor. Si cualquiera de estos pasos falla desde fuera, el servidor es invisible para el fediverso.
- Verifica desde una máquina fuera de tu red:
curl -s "https://<account_domain>/.well-known/webfinger?resource=acct:<user>@<account_domain>"devuelve la cuenta, siguiendo la redirección ahostcuando los dominios difieren (curl -L).curl -s https://<host>/.well-known/nodeinfoenlaza/nodeinfo/2.1, que nombra el software y su código fuente.curl -s -H 'Accept: application/activity+json' https://<host>/@<user>redirige al id del actor, y el actor en ese id es JSON con unapublicKey.- Desde una cuenta de Mastodon u otro servidor, busca
@<user>@<account_domain>, síguela y comprueba que llega una publicación nueva. - Un CDN delante del servidor no guarda en caché
/ap/*ni/@*a menos que respeteVary: Accept.
- Detalles: ejecutar el servidor (los endpoints de federación), CDN, relés.
Para LLM y agentes de programación:llms.txt,llms-full.txt, llms-small.txt