Ir al contenido

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

La página en inglés ha cambiado desde que se tradujeron estas secciones:

Configuración de la instancia

Las configuraciones que definen cómo se gestiona tu instancia: modo de registro, longitud de las publicaciones, idioma predeterminado, quién puede ver las líneas de tiempo, el nombre de la instancia, la descripción, los términos, las reglas, el tema y los emojis personalizados.

Configuración y configuración de la instancia

Sección titulada «Configuración y configuración de la instancia»
Configuración configuración de la instancia
Qué Cómo se construye el despliegue: roles, adaptadores, endpoints, nombres de host, secretos Cómo se gestiona la instancia: modo de registro, límite de longitud de las publicaciones, idioma predeterminado, quién puede ver las líneas de tiempo, el nombre de la instancia, la descripción y los términos
Dónde Variables de entorno MY_* y el archivo de configuración (referencia de configuración) La base de datos. Cada cambio se conserva como una revisión
Cambiar Surte efecto cuando se reinicia el proceso Surte efecto de inmediato con my instance set, las pantallas de administración del cliente web o la API de cliente (pantallas de administración y API de cliente)
Sin definir El valor predeterminado del esquema (el servidor no arranca si la clave es obligatoria) El valor predeterminado definido en el código
  • Ninguna clave está en ambos sitios. Ninguno anula al otro. No puedes dar una configuración de la instancia mediante una variable de entorno o el archivo de configuración, ni guardar un valor de configuración en la base de datos.
  • Un valor que es fijo por despliegue y cambia la estructura del proceso es configuración; un valor que cambia mientras la instancia está en funcionamiento es una configuración de la instancia.
Clave Tipo Valor predeterminado Descripción
registration_mode open / approval / invite / closed approval El modo de registro (registro). Mientras se anuncia el cierre del servicio y después de que se cierre, y en un servidor de una sola persona, el valor efectivo es closed. El valor almacenado no cambia, y cancelar el anuncio o desactivar single_user lo restablece. GET /instance y NodeInfo muestran el valor efectivo
max_status_length entero 1-100000 500 La longitud máxima de una publicación, en caracteres
default_locale etiqueta de idioma BCP 47 en El idioma predeterminado. Es el idioma inicial de la interfaz de los usuarios nuevos, y el de reserva cuando ningún catálogo coincide con la preferencia de un usuario
local_timeline_visibility off / signed_in / everyone everyone Quién puede ver la cronología local (GET /api/v1/timelines/local): nadie, los usuarios con sesión iniciada o todo el mundo. off responde 404 y signed_in responde 401 a los visitantes que no han iniciado sesión; en ambos casos la navegación la oculta. Salvo que el valor sea everyone, la página de inicio no muestra publicaciones de ejemplo. En un servidor de una sola persona se lee como off
federated_timeline_visibility off / signed_in / everyone signed_in Quién puede ver la cronología federada (GET /api/v1/timelines/federated). Los valores significan lo mismo que para la cronología local, y se lee como off también en un servidor de una sola persona
preview_image ID de multimedia (vacío = sin definir) vacío La imagen de vista previa de enlaces (og:image) para las páginas sin imagen propia, en «Vistas previas de enlaces» de Configuración → General. Cuando no está definida, se usa la miniatura, luego el logotipo y luego la imagen incluida (vistas previas de enlaces)
contact_account nombre de usuario de una cuenta local (vacío = sin definir) vacío La cuenta para contactar con los operadores. Consulta contacto y miniatura
contact_email dirección de correo (vacío = sin definir) vacío La dirección de correo para contactar con los operadores. Es también el Reply-To y la firma de los correos que envía el servidor
thumbnail ID de multimedia (vacío = sin definir) vacío Una imagen que representa a la instancia (miniatura), en las páginas «Acerca de» y de inicio, y en las vistas previas de enlaces cuando preview_image no está definida
remote_media_policy none / avatars / all none Si se conservan copias de la multimedia remota. none: el proxy de multimedia retransmite cada solicitud. avatars: los avatares, las cabeceras y los emoji personalizados se almacenan en caché en el almacén de blobs durante remote_media_cache_ttl_seconds. all: toda la multimedia remota. El tamaño total de la caché está limitado por la configuración remote_media_cache_max_bytes
remote_media_cache_ttl_seconds entero 60-31536000 (segundos) 86400 Cuánto tiempo puede conservarse la multimedia remota obtenida. Es también el Cache-Control: max-age de las respuestas del proxy de multimedia, así que las CDN y los navegadores la almacenan en caché durante ese tiempo
remote_media_cache_max_bytes entero desde 1 (bytes) 1073741824 El límite de tamaño de las copias de multimedia remota que conserva el proxy de multimedia. La limpieza horaria elimina las copias caducadas, y luego las de acceso menos reciente que superen este límite
authorized_fetch true / false false Authorized Fetch (modo seguro). Cuando es true, un GET de ActivityPub sin una firma HTTP verificable recibe 401 para objetos y colecciones, y un documento mínimo que lleva la clave para el actor de un usuario. El actor de la instancia siempre devuelve su documento completo, de modo que cualquier servidor puede obtener la clave para verificar una firma
federation_mode off / inbound / outbound / both both La dirección de la federación. off: sin federación. inbound: sigues y lees cuentas remotas, pero las publicaciones, perfiles y reacciones locales no se envían, y los seguimientos de fuera se rechazan (Reject). outbound: aceptas seguimientos de fuera y entregas publicaciones locales, pero no se aceptan publicaciones ni reacciones remotas. both: enviar y recibir. Un cambio surte efecto de inmediato y necesita el permiso manage_settings
federation_scope open / allowlist open Con qué servidores federa este servidor. open: todos los servidores que ninguna acción de dominio suspende. allowlist: solo los dominios de la lista de permitidos y sus subdominios; todos los demás servidores se tratan como suspendidos, y los GET de ActivityPub necesitan una firma de un servidor permitido diga lo que diga authorized_fetch. Cambiar a allowlist termina para siempre los seguimientos con los servidores que deja fuera; consulta federar solo con los servidores permitidos. Un cambio surte efecto de inmediato y necesita el permiso manage_settings
dynamic_client_registration true / false true Registro dinámico de clientes (RFC 7591). Mientras es true, POST /oauth/register acepta el registro de clientes públicos sin autenticación. Cuando es false, el endpoint rechaza todas las solicitudes con 403 (access_denied); los clientes ya registrados siguen funcionando. Un job periódico elimina los clientes registrados dinámicamente que no se usan, según la configuración dynamic_client_unredeemed_retention y dynamic_client_idle_retention. Un cambio surte efecto de inmediato y necesita manage_settings
domain_actions_visibility off / signed_in / everyone off Quién puede ver la lista de dominios con acciones tomadas (GET /api/v1/instance/domain_actions): nadie, los usuarios con sesión iniciada o todo el mundo (moderación)
domain_actions_rationale_visibility off / signed_in / everyone off Quién puede ver los comentarios públicos de esa lista. Quien no puede ver la lista nunca los ve
appeal_window_days entero 20-365 (días) 180 Cuántos días después de una acción puede apelar la persona afectada (moderación). Cambiarlo también cambia el plazo de las acciones ya tomadas
session_origins_retention_days entero 90-3650 (días) 180 Cuántos días después de un inicio de sesión se conservan la dirección IP y el User-Agent del inicio de sesión (moderación)
registration_origins_retention_days entero 90-3650 (días) 180 Cuántos días después del registro se conserva la dirección IP del registro
reports_retention_days entero 180-3650 (días) 365 Cuántos días después de la última resolución se conserva una denuncia. Una denuncia a la que remite una acción se conserva mientras la acción
moderation_actions_retention_days entero 180-3650 (días) 365 Cuántos días después del fin de una acción (el levantamiento, la caducidad o la revisión de una apelación, lo que ocurra más tarde) se conservan las acciones sobre cuentas y las apelaciones
audit_log_retention_days entero 365-3650 (días) 730 Cuántos días después de registrarse se conserva una fila del registro de auditoría
remote_status_retention_days entero 1-3650 (días) 90 Cuántos días se conserva una publicación remota tras su publicación cuando nada de esta instancia hace referencia a ella (una respuesta local, un impulso, un favorito, un marcador, una notificación o un hilo con una publicación local)
remote_status_max_retention_days entero 0-3650 (días) 0 El máximo de días que se conserva cualquier publicación remota tras su publicación, aunque esta instancia haga referencia a ella. Las respuestas locales, los impulsos, los favoritos y los marcadores permanecen y la muestran como eliminada. 0 no fija ningún límite
relay_status_retention_days entero 1-3650 (días) 7 Cuántos días se conserva una publicación remota que solo trajo un relay, cuando nada de esta instancia hace referencia a ella y ninguna cuenta local sigue a su autor
oauth_client_rate_limits pares client_id=requests separados por comas vacío Topes a las solicitudes de la API de cliente de los clientes OAuth, para contener a un cliente que sobrecarga el servidor: las solicitudes que todos sus usuarios juntos pueden hacer en 5 minutos. Un cambio tarda hasta un minuto en aplicarse
search_indexing allow / deny deny Si los motores de búsqueda pueden indexar la instancia. Incluso con allow, solo se indexan los perfiles de las cuentas indexable y las publicaciones public (motores de búsqueda y rastreadores de IA)
ai_usage allow / deny_training / deny deny La declaración a los servicios de IA. deny_training rechaza el entrenamiento; deny rechaza el entrenamiento y el uso por la IA (búsqueda con IA, asistentes, agentes)
indexable_default true / false false El valor predeterminado de indexable para las cuentas nuevas. Cambiarlo no cambia las cuentas existentes
auto_delete_default_enabled true / false false Si las cuentas nuevas empiezan con la eliminación automática de sus publicaciones antiguas activada. Junto con las demás claves auto_delete_default_* es la política que recibe una cuenta nueva (eliminación automática de publicaciones antiguas)
auto_delete_default_min_age_days entero 1-3650 (días) 30 Cuántos días después de su publicación elimina una publicación la política de una cuenta nueva
auto_delete_default_keep_pinned, auto_delete_default_keep_bookmarked, auto_delete_default_keep_favourited true / false true Si la política de una cuenta nueva conserva las publicaciones que su autor fijó, marcó o marcó como favoritas
auto_delete_default_keep_media, auto_delete_default_keep_polls true / false false Si la política de una cuenta nueva conserva las publicaciones con contenido multimedia o encuesta
auto_delete_default_keep_articles true / false true Si la política de una cuenta nueva conserva los artículos
auto_delete_default_keep_public, auto_delete_default_keep_local, auto_delete_default_keep_unlisted, auto_delete_default_keep_private true / false false Si la política de una cuenta nueva conserva las publicaciones de esa visibilidad
auto_delete_default_keep_direct true / false true Si la política de una cuenta nueva conserva las publicaciones directas
auto_delete_default_keep_min_boosts, auto_delete_default_keep_min_favourites entero 0-1000000 0 La política de una cuenta nueva conserva una publicación impulsada o marcada como favorita al menos este número de veces. 0 no fija ningún umbral
auto_delete_max_age_days entero 0-3650 (días) 0 El máximo de días tras su publicación que se conserva cualquier publicación local (máximo). 0 no fija ningún máximo
auto_delete_max_allow_pinned true / false true Si las publicaciones fijadas aún pueden conservarse bajo el máximo
auto_delete_max_kept_pins entero 1-5 5 Cuántos fijados conservan publicaciones bajo el máximo, el fijado más recientemente primero. 5, el máximo de fijados de una cuenta, conserva todas las publicaciones fijadas
auto_delete_max_allow_bookmarked, auto_delete_max_allow_favourited, auto_delete_max_allow_media, auto_delete_max_allow_polls true / false false Si las publicaciones que el autor marcó o marcó como favoritas, o con contenido multimedia o encuesta, aún pueden conservarse bajo el máximo
auto_delete_max_allow_articles true / false true Si los artículos aún pueden conservarse bajo el máximo
auto_delete_max_allow_visibilities true / false false Si las publicaciones aún pueden conservarse por su visibilidad bajo el máximo
auto_delete_max_allow_thresholds true / false false Si las publicaciones aún pueden conservarse por sus impulsos y favoritos bajo el máximo
auto_delete_grace_days entero 0-365 (días) 30 Cuántos días conserva sus propios ajustes una cuenta a la que el máximo se aplica por primera vez, después de ser avisada. Un cambio no mueve las fechas de las cuentas ya avisadas
search_visibilities public / local / public,local public Qué publicaciones cubre la búsqueda de texto completo de un servidor con un backend de búsqueda. Las publicaciones unlisted, private y direct nunca se cubren, y solo las cuentas con indexable. Omitir una visibilidad elimina sus publicaciones del índice. Añadir una solo encuentra las publicaciones nuevas de ella, hasta que reconstruyas el índice. No hace nada con search = none
security_contact URI https: o mailto: (vacío = sin definir) vacío Dónde informar de problemas de seguridad de este servidor: cómo está configurado y se ejecuta, y sus cuentas y datos. Cuando está definido, el servidor sirve /.well-known/security.txt (RFC 9116). Este es tu contacto, no el del software: reenvía al proyecto el informe de una vulnerabilidad del propio software como describe su política de seguridad
require_media_description true / false false Si cada archivo multimedia (imagen, video o audio) adjunto a una publicación local necesita una descripción. Cuando es true, una publicación o una edición con un archivo cuya descripción falta o es solo espacios en blanco se rechaza con 422. Se publica como limits.require_media_description en GET /api/v1/instance, y el cliente web hace obligatorio el campo de descripción. Es independiente del ajuste por usuario require_media_description, que solo comprueba antes de enviar
link_cards true / false true Si se muestran tarjetas para los enlaces de las publicaciones. Cuando es true, el servidor obtiene la página enlazada para construir una tarjeta. Cuando es false, deja de obtenerla y también oculta las tarjetas ya construidas. Para detenerlo solo en algunos dominios, consulta dominios de tarjetas de enlace
link_cards_ignore_robots_txt true / false false Si las obtenciones de tarjetas de enlace omiten robots.txt. Cuando es false, el servidor obedece el robots.txt de los sitios enlazados, así que un sitio que no permite my-linkcard o * no recibe tarjeta (vistas previas de enlaces). /about/crawler dice a los sitios enlazados cuál es. Cuando es true, el servidor no obtiene ni usa robots.txt, y un sitio enlazado ya no puede rechazar estas obtenciones con él; el servidor sigue identificándose como my-linkcard. Actívalo solo cuando falten demasiadas tarjetas. Las tarjetas construidas mientras estaba activado se comprueban en su siguiente nueva obtención después de desactivarlo. Las directivas de una página y los dominios de tarjetas de enlace se aplican en ambos casos
ux_measurement true / false false Si el cliente web envía muestras de lo rápido que responde, y este servidor las conserva (mediciones de UX). Las muestras no llevan ninguna cuenta, dirección ni URL. Cuando es false, el servidor no toma ninguna, y ux_measurement en GET /api/v1/instance le dice al cliente que no las envíe
ux_measurement_share entero 1-100 (porcentaje) 10 La proporción de sesiones del navegador cuyo cliente web envía muestras mientras ux_measurement es true. Cada sesión se sortea una vez, cuando arranca el cliente web; un servidor pequeño puede medir todas las sesiones con 100
oauth_metadata_document_clients true / false true Si se aceptan los clientes Client ID Metadata Document. Cuando es true, para una solicitud de autorización cuyo client_id es una URL https, el servidor obtiene los metadatos en esa URL y los trata como el cliente (sin registro previo). La obtención no sigue redirecciones, lee como máximo 5 KB y reutiliza la respuesta como máximo 24 horas según sus directivas de caché. Cuando es false, deja de obtenerlos y rechaza las solicitudes de autorización, los intercambios de tokens y las renovaciones de estos clientes
finance_visibility private / totals / breakdown private Cuánto de los costes de funcionamiento (registrados en /admin/finance/costs y definidos en /admin/finance/publication) se publica. private: no se publica nada (GET /api/v1/instance/cost_totals es 404). totals: solo el total por periodo y moneda. breakdown: los totales y un desglose por proveedor y categoría, mostrados a todo el mundo en las páginas de información (/about y /about/costs) y en la API. breakdown revela en qué proveedor (por ejemplo, qué nube) funcionas. En todos los niveles, los nombres de los conceptos, las notas y los pagos individuales permanecen privados. Se publican los periodos hasta el que contiene hoy (UTC), inclusive
finance_viewer_item_names true / false false Si los usuarios con el permiso view_finance ven los nombres de los conceptos de coste y los nombres de servicio de los costes importados en la pantalla de finanzas (/finance, GET /api/v1/finance/cost_totals). Los totales y el desglose por proveedor y categoría siempre se muestran, sea cual sea este ajuste
finance_viewer_item_memos true / false false Si los usuarios con view_finance ven las notas de los conceptos de coste en la pantalla de finanzas. Si el ajuste de nombre o el de nota es true, cada periodo muestra filas de conceptos (proveedor, categoría y el importe de ese periodo, más el nombre y la nota donde estén activados). Las personas con manage_finance lo ven todo en cualquier caso
finance_viewer_income totals / plans totals Si los usuarios con view_finance ven solo los totales de ingresos (totals) o también el número de suscriptores por plan (plans). El importe por plan y quién pagó nunca se muestran. Si income_visibility es plans, los recuentos publicados se muestran sea cual sea este valor. Los ingresos se leen en la pantalla de finanzas del cliente web (/finance) y en GET /api/v1/finance/income_totals
income_visibility private / totals / plans private Cuánto de los ingresos de colaboradores (el importe tras las comisiones del proveedor de pagos) se publica. Se elige por separado de finance_visibility. private: no se publica nada (GET /api/v1/instance/income_totals es 404). totals: solo el total de ingresos por periodo y moneda. plans: también el número actual de suscriptores por plan, mostrado a todo el mundo. Para un plan con pocos suscriptores, el recuento puede permitir adivinar quién se suscribe. El saldo (ingresos menos costes) se muestra solo cuando ni este valor ni finance_visibility son private; de lo contrario el saldo revelaría el lado que ocultaste. En todos los niveles, los pagos individuales, los suscriptores, el importe por plan y los importes brutos y comisiones permanecen privados. Se publican los periodos hasta el que contiene hoy (UTC), inclusive
funding_meter_visibility off / percent / amounts off Lo que publica el medidor de financiación: hasta dónde llegan los ingresos de este mes (tras las comisiones del proveedor de pagos) hacia el objetivo mensual, mostrado en la página «Acerca de», en la lista de colaboradores (/about/supporters) y en GET /api/v1/instance (funding_meter). Se define con el objetivo en /admin/finance/publication, que ofrece solo las opciones que permiten las visibilidades actuales y dice por qué. off: nada. percent: solo el porcentaje, redondeado hacia abajo al 1 %, si el mes está cubierto y si los costes estimados están en el objetivo. Solo puede elegirse mientras finance_visibility e income_visibility son ambos private. amounts: también los ingresos y el objetivo. Solo puede elegirse mientras ninguno de los dos es private. Mientras solo uno de ellos se publica, el medidor no puede mostrarse: los importes publicados y el porcentaje revelarían el lado oculto. Cambiar cualquiera de las visibilidades de modo que el valor elegido ya no esté permitido pone el medidor en off, y ese cambio se registra y se audita como cualquier otro. El mes es el mes natural que contiene hoy (UTC), y solo cuentan los ingresos en la moneda del objetivo
funding_meter_target_amount decimal mayor que cero, o vacío vacío El objetivo mensual del medidor de financiación, en la unidad principal de funding_meter_target_currency (1650 yenes, 12.50 dólares), sin más dígitos decimales de los que tiene la moneda. Vacío: el objetivo son los costes de este mes, lo que los necesita en una sola moneda; en un mes cuyos costes están en varias monedas, o son cero, el medidor no se muestra
funding_meter_target_currency código ISO 4217, o vacío vacío La moneda de funding_meter_target_amount, como JPY. Vacío: la moneda de los costes de este mes
funding_meter_rail true / false false Si el cliente web muestra también el medidor de financiación en la columna derecha del diseño ancho, además de la página «Acerca de», mientras funding_meter_visibility no es off
supporter_list_visibility off / signed_in / everyone off Quién puede ver la lista de colaboradores (GET /api/v1/instance/supporters y /about/supporters). off: nadie (la API responde 404 y /about no tiene enlace). signed_in: solo las personas con sesión iniciada en este servidor (la API responde 401 en otro caso). everyone: todo el mundo. La lista muestra solo las cuentas y los planes de los suscriptores activos que eligieron figurar; los importes, la facturación mensual o anual, las fechas y los recuentos nunca se muestran. La página de la lista y la respuesta de la API son siempre noindex, noarchive, sea cual sea search_indexing
user_app_registration true / false true Si los usuarios con sesión iniciada pueden registrar sus propias aplicaciones OAuth (públicas o confidenciales) con la API de cliente (POST /api/v1/oauth_apps). Cuando es false, registrar responde 403. Listar, cambiar y eliminar aplicaciones registradas, reemitir secretos, emitir un token para ti mismo y la autorización por otros usuarios siguen funcionando
voice_room_starters everyone / permitted permitted Quién puede abrir salas de chat de voz, mientras la configuración voice no es off (configuración). everyone: todos los usuarios locales con sesión iniciada que no están suspendidos ni limitados. permitted: solo los titulares del permiso start_voice_rooms, que por defecto solo tiene el rol integrado admin y que puede tener un rol de un plan de colaborador
voice_public_summary true / false false Si la página de una sala de chat de voz cuya visibilidad es local muestra su nombre, descripción, anfitrión y si sigue abierta a los visitantes que no han iniciado sesión en este servidor y a los usuarios remotos, y en su vista previa de enlace. Los participantes nunca se muestran. Cuando es false, esos visitantes ven solo que la sala es para los usuarios locales de este servidor
event_creators everyone / permitted everyone Quién puede crear eventos (eventos). everyone: todos los usuarios locales con sesión iniciada que no están suspendidos ni limitados. permitted: solo los titulares del permiso create_events, que por defecto solo tiene el rol integrado admin y que puede tener un rol de un plan de colaborador
public_counts true / false true Si la página de inicio (/, sin sesión) y GET /api/v1/instance/overview muestran cuántos miembros tiene el servidor, cuántas publicaciones públicas hicieron sus usuarios cada uno de los últimos 7 días y cuándo arrancó el servidor. Solo cuentan las publicaciones públicas de los usuarios de este servidor; las cifras se actualizan cada pocos minutos. Cuando es false, la API las omite
landing_fediverse_explanation true / false true Si la página de inicio (/, sin sesión) explica cómo funciona el fediverso: que una cuenta de aquí sigue y es seguida por personas de otros servidores
landing_features true / false true Si la página de inicio muestra lo que hace el software en este servidor, con una muestra de cada función activada (salas de voz, eventos, artículos, búsqueda, traducción, colaboradores)
featured_accounts nombres de usuario de hasta 20 cuentas locales, separados por espacios o comas (vacío = ninguna) vacío Las cuentas que las sugerencias de personas a las que seguir muestran primero, en este orden, antes de las personas de este servidor que publicaron recientemente. No se sugiere una cuenta cuyo titular desactivó «Sugerir mi cuenta y encontrarla por parte de su nombre». Consulta sugerencias
login_providers_only true / false false Si el registro y el inicio de sesión se limitan a los proveedores de inicio de sesión mientras haya al menos uno activado: las contraseñas y las passkeys dejan de iniciar sesión, y los usuarios sin un proveedor vinculado no pueden volver a iniciar sesión cuando terminen sus sesiones. Sin proveedores activados no se aplica. my instance set imprime cuántos usuarios activos no tienen vínculo con un proveedor activado. Consulta limitar el inicio de sesión a los proveedores de inicio de sesión.
invite_creators everyone / permitted permitted Quién puede crear invitaciones propias además del personal con manage_invites (invitaciones de miembros). everyone: todos los usuarios locales con sesión iniciada que no están suspendidos ni limitados. permitted: solo los titulares del permiso create_invites, que por defecto solo tiene el rol integrado admin y que puede tener un rol de un plan de colaborador. En el modo approval, una invitación utilizable aprueba al usuario nuevo de inmediato, así que everyone permite que todos los usuarios se salten la revisión
member_invite_max_active entero 0-100 5 Cuántas invitaciones utilizables (no revocadas, caducadas ni agotadas) puede tener un miembro a la vez; 0 impide que los miembros creen ninguna. Las invitaciones del personal no cuentan
member_invite_max_uses entero 1-1000 10 Cuántas personas pueden registrarse con una invitación que crea un miembro
member_invite_max_lifetime_seconds entero 3600-31536000 (segundos) 2592000 (30 días) Cuánto tiempo puede funcionar como máximo una invitación que crea un miembro. Reducirlo no acorta las invitaciones existentes
translation_providers IDs de proveedor separados por comas vacío Los proveedores de traducción del lado del servidor que están activados, el primero se prueba primero. Cuando está vacío no se envía nada a ningún proveedor. Un ID para el que este servidor no tiene proveedor no hace nada. Los proveedores de traducción integrados tienen los IDs libretranslate, deepl, google y aws, y un plugin traductor el ID plugin
translation_provider_visibilities pares provider=visibility|visibility separados por comas vacío Lo que puede recibir cada proveedor. Un proveedor no nombrado recibe las publicaciones public, local y unlisted; provider= sin nada detrás no recibe ninguna. private y direct van solo a un proveedor nombrado con ellas, así que permitirlas a un proveedor no las permite al siguiente
translation_browser booleano false Si los lectores pueden usar la traducción integrada en su navegador, que no envía nada a este servidor ni a un proveedor. Con un proveedor del lado del servidor también activado, el proveedor va primero, y el navegador traduce lo que el servidor rechaza: una publicación o un idioma que ningún proveedor acepta, un límite mensual o un proveedor que falla
translation_user_monthly_characters entero 0-1000000000000 50000 Cuántos caracteres pueden enviar a los proveedores de traducción las solicitudes de un usuario en un mes UTC. Con 0 no se envía nada. No hay valor ilimitado: define un número grande
translation_server_monthly_characters entero 0-1000000000000 500000 Cuántos caracteres puede enviar todo el servidor a los proveedores de traducción en un mes UTC. Con 0 no se envía nada. No hay valor ilimitado: define un número grande
translation_retention_days entero 1-3650 (días) 30 Cuántos días se conserva una traducción después de hacerse. Leerla no lo prolonga, y desaparece con la publicación
translation_reports_to_server booleano false Si los moderadores pueden enviar el texto de una denuncia, las publicaciones denunciadas y el comentario del denunciante, a los proveedores del lado del servidor. Cada proveedor sigue recibiendo solo las visibilidades que translation_provider_visibilities le permite, quienquiera que lo pida: una publicación directa denunciada va solo a un proveedor al que se permite direct, y el comentario cuenta como private. La traducción del comentario nunca se conserva, ni tampoco la de una publicación eliminada, y los caracteres cuentan solo contra translation_server_monthly_characters. Cuando es false, nada de una denuncia llega a un proveedor
event_records_retention_days entero 30-3650 (días) 90 Cuántos días después de que un evento terminó o se canceló se conserva quién lo respondió, quién fue aprobado, quién fue invitado y quién votó sus fechas candidatas. Un evento cuya fecha nunca se fijó termina con su última fecha candidata. El evento en sí (sus ajustes, lugares, fecha y fechas candidatas, y cancelación) se conserva. Los registros de un evento denunciado se conservan mientras la denuncia, y las retenciones se aplican como a los demás registros (conservación de registros)
voice_participants_retention_days entero 30-3650 (días) 90 Cuántos días después de que terminó una sala de chat de voz se conservan los registros de quién participó: las participaciones, los oradores y oyentes, las manos levantadas, las invitaciones y las expulsiones. La sala en sí (su nombre, descripción, anfitriones y cómo terminó) se conserva. Los registros de una sala denunciada se conservan mientras la denuncia, y las retenciones se aplican como a los demás registros
hook_inbound_status_mode, hook_inbound_follow_mode, hook_signup_check_mode, hook_media_check_mode, hook_local_status_mode, hook_inbound_actor_mode, hook_local_profile_mode off, observe, enforce observe Hasta dónde actúa cada hook de decisión mientras tiene un plugin. off pasa a enforce solo a través de observe.
hook_inbound_status_on_failure, hook_inbound_follow_on_failure, hook_media_check_on_failure, hook_inbound_actor_on_failure pass, retry pass Lo que hace el hook cuando aplica y su plugin falla (detalles).
hook_inbound_status_unfollowed_direct booleano false Si inbound.status también envía las publicaciones directas de autores a los que ninguna cuenta local sigue (detalles). La página de información (/about) lo declara mientras el hook está en uso.
hook_signup_check_on_failure pass, require_approval pass Lo que hace signup.check cuando aplica y su plugin falla.
hook_signup_check_reject booleano false Si un reject de signup.check rechaza el registro mientras aplica. Cuando está desactivado, la respuesta solo se registra, como en observe.
hook_local_status_account_age_days entero 0-3650 (días) 7 local.status revisa las publicaciones y sus ediciones de las cuentas más jóvenes que esto; 0 revisa todas las cuentas. La página de información (/about) lo declara mientras el hook está en uso.
hook_local_profile_account_age_days entero 0-3650 (días) 7 local.profile revisa los cambios de perfil de las cuentas más jóvenes que esto; 0 revisa todas las cuentas. La página de información (/about) lo declara mientras el hook está en uso.
hook_decisions_retention_days entero 30-3650 (días) 90 Cuántos días se conservan las decisiones de los hooks.
single_user booleano false Si el servidor es un servidor de una sola persona. Solo puede activarse mientras el servidor tiene exactamente una cuenta local, y desactivarse en cualquier momento
max_drafts entero 1-10000 100 Cuántos borradores no programados puede conservar un usuario en el servidor. Reducirlo no elimina ningún borrador: un usuario por encima no guarda ninguno nuevo
max_scheduled_posts entero 1-10000 300 Cuántas publicaciones programadas de un usuario pueden esperar. Reducirlo no cancela ninguna programación
max_scheduled_posts_per_day entero 1-10000 25 Cuántas publicaciones programadas de un usuario pueden esperar para un mismo día UTC
scheduled_post_min_lead_minutes entero 1-1440 (minutos) 5 Con cuántos minutos de antelación, como mínimo, puede programarse una publicación
scheduled_post_max_lead_days entero 1-3660 (días) 366 Con cuántos días de antelación, como máximo, puede programarse una publicación
article_authoring everyone / permission everyone Quién puede escribir artículos nuevos: todos los usuarios locales, o solo los usuarios cuyos roles tienen el permiso create_articles
max_article_bytes entero 1000-100000 (bytes) 100000 El máximo de bytes del HTML que genera el cuerpo de un artículo
max_article_images entero 0-100 20 El máximo de imágenes de las propias subidas del autor en el cuerpo de un artículo, además de su portada
  • Los valores se normalizan antes de almacenarse (TRUE pasa a true, 0750 pasa a 750, ja_jp pasa a ja-JP, los ID de multimedia se pasan a minúsculas). Un valor no válido se rechaza y no se escribe nada.
  • preview_image y thumbnail aceptan solo la multimedia de una imagen que existe (incluida una que aún se está procesando). Hasta que termina el procesamiento, y en lugar de una imagen cuyo procesamiento falló, preview_image recurre a la imagen predeterminada. Una vez que una multimedia se ha definido en cualquier revisión, la limpieza de subidas no adjuntas no la elimina.
  • contact_account acepta solo el nombre de usuario de un usuario local que no está eliminado (almacenado en minúsculas). contact_email acepta solo una dirección con la forma alice@example.com.
  • featured_accounts acepta solo los nombres de usuario de usuarios locales que no están eliminados; se descarta una @ inicial, los nombres se pasan a minúsculas, un nombre repetido se conserva una vez, y se almacenan separados por espacios simples.

Los usuarios con sesión iniciada ven sugerencias de personas a las que seguir (en la línea de tiempo de inicio vacía tras el registro, y con GET /api/v1/accounts/suggestions). Las sugerencias son las cuentas de featured_accounts en su orden y después las cuentas de este servidor que publicaron una publicación pública o local en los últimos 30 días, empezando por la que publicó más recientemente. Se excluyen la propia cuenta del usuario, las cuentas que el usuario sigue, bloquea o silencia, o por las que está bloqueado, y las cuentas suspendidas o desactivadas.

Las cuentas nuevas se sugieren y pueden encontrarse por parte de su nombre en la búsqueda de cuentas. Un usuario que desactiva «Sugerir mi cuenta y encontrarla por parte de su nombre» en la configuración del perfil queda fuera de ambas: la búsqueda encuentra entonces la cuenta solo por su nombre de usuario completo, o para las personas que la siguen.

Eliminación automática de publicaciones antiguas

Sección titulada «Eliminación automática de publicaciones antiguas»

Los usuarios pueden hacer que sus propias publicaciones se eliminen automáticamente unos días después de publicarlas (Configuración, «Eliminar publicaciones antiguas»). La política de cada usuario es suya: si está activada, después de cuántos días y qué publicaciones conserva (las publicaciones fijadas, marcadas y marcadas como favoritas, las publicaciones con medios o con una encuesta, los artículos, las publicaciones de ciertas visibilidades y las publicaciones con al menos cierto número de impulsos o favoritos). Eliminar una publicación de este modo equivale a que su autor la elimine: los servidores a los que llegó reciben un Delete. De este modo solo se eliminan las publicaciones de cuentas locales, nunca los impulsos.

Las claves auto_delete_default_* son la política con la que empieza cada cuenta local nueva, se cree como se cree (el formulario de registro, un proveedor de inicio de sesión externo, una invitación o my admin). La cuenta la recibe al crearse y pasa a ser suya: cambiar las claves más adelante no cambia ni las cuentas existentes ni las que recibieron un valor anterior. La pantalla de configuración muestra los valores como propios del usuario. Con las claves sin definir, una cuenta nueva empieza con la eliminación automática desactivada, a los 30 días, conservando las publicaciones fijadas, marcadas y marcadas como favoritas, los artículos y las publicaciones directas. El valor predeterminado no se muestra a las personas ajenas a la instancia. Cuando hay un máximo definido, una cuenta nueva recibe el valor predeterminado recortado al máximo, como se describe más abajo, de modo que empieza dentro de él.

Con auto_delete_max_age_days por encima de 0, ninguna publicación local se conserva más de ese número de días después de su publicación. Para toda cuenta local sin el permiso keep_posts_longer:

  • La eliminación automática está siempre activada: un usuario no puede desactivarla ni elegir más días que el máximo (menos está bien). La pantalla de configuración y PUT /api/v1/preferences/auto_delete rechazan ambas cosas.
  • Solo conservan publicaciones las excepciones que permiten las claves auto_delete_max_allow_*. Por defecto solo lo hacen las publicaciones fijadas, todas ellas; con auto_delete_max_kept_pins por debajo de 5, solo conservan sus publicaciones esa cantidad de las fijadas más recientemente.
  • Los usuarios que desactivaron la eliminación automática, o nunca la definieron, también están sujetos al máximo.

Activar el máximo, reducirlo o cambiar las excepciones no reescribe las configuraciones de nadie. En cambio, cada hora el trabajo content.auto_delete_statuses encuentra las cuentas cuyas propias configuraciones conservan publicaciones que el máximo no conserva (porque el máximo se activó o se redujo, o la cuenta perdió keep_posts_longer). Avisa a cada una de ellas una vez, con una notificación y un correo electrónico que están activados por defecto, y desde cuándo se aplica el máximo: auto_delete_grace_days después del aviso. Hasta entonces las configuraciones propias de la cuenta siguen en vigor; a partir de entonces sus publicaciones se rigen por el máximo. Una cuenta que vuelve a estar dentro del máximo (su usuario cambia las configuraciones, obtiene keep_posts_longer, o el máximo desaparece o sube) deja de estar sujeta, y un cambio posterior vuelve a avisarla con un nuevo periodo de gracia.

Activar el máximo avisa en el plazo de una hora a todas las cuentas a las que afecta. Las eliminaciones mantienen su ritmo: como máximo 100 publicaciones de una cuenta por hora, cada una enviada como un Delete a los servidores a los que llegó la publicación, así que una cuenta con muchas publicaciones antiguas tarda horas o días en vaciarse. Un usuario que cambie sus configuraciones mientras tanto detiene el resto.

keep_posts_longer es un permiso de miembro: dáselo a un rol para que quienes lo tengan conserven sus publicaciones el tiempo que elijan y desactiven la eliminación automática. El rol integrado admin lo tiene. Un plan de mecenas puede incluirlo, de modo que conservar las publicaciones más tiempo puede ser un beneficio del plan; cuando termina la suscripción, el máximo se aplica de nuevo tras el periodo de gracia.

El máximo es público: GET /api/v1/instance lo devuelve en auto_delete_limit, y la página de información lo muestra, para que la gente lo sepa antes de registrarse. Los cambios de estas claves requieren manage_settings y se registran en el registro de auditoría como cualquier otro configuración. En el cliente web están en la página «Eliminación de publicaciones» de «Configuración del servidor», que pregunta antes de guardar un máximo que se activa o se endurece.

Los usuarios guardan borradores de publicaciones en el servidor, siguen escribiéndolos en otro dispositivo y los publican de inmediato o a la hora que elijan. Solo su autor lee un borrador; los borradores nunca se federan, no están en la exportación de los datos de una cuenta y desaparecen con la cuenta cuando se borra. Los cinco ajustes max_drafts y scheduled_post_* de arriba los acotan; un guardado o una programación que supera un límite se rechaza con un mensaje que lo nombra.

  • Una publicación programada la publica el trabajo content.publish_scheduled_draft a su hora o poco después, también cuando la hora está más lejos que el límite de retraso del servicio de colas: el trabajo vuelve y espera de nuevo. Defínelos con my instance set, por ejemplo my instance set max_scheduled_posts 100.
  • La publicación se comprueba cuando se publica, no solo cuando se programa: un usuario al que una medida de moderación impide publicar para entonces, o cuya publicación responde a una publicación que ya no existe o la cita, no obtiene ninguna publicación. El borrador permanece, y el usuario recibe una notificación que explica el motivo (scheduled_status_failed, que los usuarios pueden desactivar en sus ajustes de notificaciones y que nunca se envía por correo). La revisión automática de las publicaciones locales, mientras está en uso, revisa la publicación cuando se publica.
  • Una publicación se sella con la hora en que se publica, y la eliminación automática de publicaciones antiguas cuenta desde entonces.
  • Los archivos multimedia que adjunta un borrador se conservan mientras exista el borrador; eliminar el borrador los deja sin asociar, y desaparecen con la limpieza de las subidas sin asociar. La portada del borrador de un artículo y las subidas que muestra su cuerpo se conservan del mismo modo.
  • Los borradores y las publicaciones programadas incluyen los artículos, que se programan y se cuentan como las publicaciones. El borrador de un artículo puede carecer de título mientras su autor escribe; se comprueba como un artículo nuevo cuando se publica, y un usuario que para entonces ya no puede escribir artículos nuevos no obtiene ningún artículo.

Un artículo es una publicación larga con un título, un resumen y una imagen de portada, cuyo cuerpo escribe su autor en Markdown. Los artículos son publicaciones en todo lo demás: tienen una visibilidad, se pueden editar conservando su historial, impulsar, marcar como favoritos, citar, responder, denunciar y eliminar, y la moderación actúa sobre ellos como sobre las publicaciones. El servidor renderiza el cuerpo una sola vez, cuando se escribe: el HTML sin procesar que contenga no se renderiza, y solo las imágenes subidas por el propio autor se muestran como imágenes; cualquier otra imagen se convierte en un enlace, de modo que los lectores nunca cargan imágenes de otros sitios. Las cronologías, las notificaciones y la búsqueda muestran el título, el resumen y la portada; el cuerpo se muestra donde se abre el artículo.

  • De forma predeterminada, todos los usuarios locales pueden escribir artículos. Con article_authoring en permission, solo los usuarios cuyos roles tienen el permiso create_articles pueden escribir otros nuevos; los artículos ya escritos permanecen, y sus autores todavía pueden editarlos. Una medida de moderación que impide publicar a una cuenta le impide también escribir y editar artículos. Un plan de mecenas puede dar create_articles como ventaja.
  • max_article_bytes acota el HTML de un cuerpo, no el Markdown: los servidores que reciben artículos cuentan el HTML, y 100 000 bytes, lo máximo que puede ser, es lo que conservan por completo. Cabe un cuerpo en japonés de unos 30 000 caracteres. max_article_images acota las imágenes de un cuerpo. El editor muestra ambos antes de publicar el artículo.
  • Un artículo nunca es una publicación directa, y no tiene encuesta, ni más archivos adjuntos que sus imágenes, ni advertencia de contenido: un artículo sensible muestra su título y su resumen y pliega el cuerpo y la portada.
  • La eliminación automática de publicaciones antiguas conserva los artículos salvo que el usuario lo desactive (auto_delete_default_keep_articles para las cuentas nuevas, auto_delete_max_allow_articles bajo un máximo).
  • GET /api/v1/instance devuelve los límites en limits.articles y el ajuste de autoría en article_authoring. Defínelos con my instance set, por ejemplo my instance set article_authoring permission.

Los usuarios locales organizan eventos con una fecha, una zona horaria y hasta tres lugares: una sala de chat de voz de este servidor, un lugar de encuentro presencial y un enlace. En lugar de una fecha, un organizador puede ofrecer hasta 20 fechas candidatas: los usuarios que ven el evento responden a cada una sí, quizá o no, y después el organizador o un coorganizador confirma una, lo que fija la fecha. Hasta entonces, nadie responde si asistirá. Los eventos son solo para los usuarios de este servidor: nunca se federan, y los usuarios remotos y los visitantes sin sesión iniciada no ven ninguno.

  • Quién puede crear uno lo decide event_creators. Un organizador también debe poder abrir salas de chat de voz (voice_room_starters y la configuración voice) para celebrar un evento en una.
  • La sala de chat de voz de un evento se abre al empezar este, con el organizador como anfitrión, y espera hasta 30 minutos al primer participante. Toma el título del evento y la visibilidad del evento (todos los usuarios locales, los seguidores, las personas a las que sigue el organizador, los seguimientos mutuos o los invitados). Los coorganizadores, quienes respondieron que asistirán o quizá, y los invitados que no han respondido son invitados a la sala, de modo que siguen viéndola cuando un coanfitrión la asume. La sala no crea ninguna publicación de inicio, y la notificación de inicio del evento es su única notificación.
  • Una sala que no puede abrirse (el chat de voz está desactivado, el organizador ya no puede abrir salas o está siendo anfitrión de otra, o hay abiertas tantas salas como permite la configuración voice_max_open_rooms) deja el evento como está: se notifica al organizador, y la página del evento indica que la sala no pudo abrirse. El servidor lo comprueba cuando se fija o se cambia la fecha y también un día antes del inicio, y notifica al organizador de lo que mantendría cerrada la sala. También se notifica al organizador cuando nadie llegó a la sala. Cancelar el evento, o quitar su sala de chat de voz, termina la sala y conserva el evento.
  • El organizador elige quién ve el evento: todos los usuarios locales, los seguidores del organizador, las personas a las que sigue el organizador, los seguimientos mutuos o solo los invitados. Los invitados y quienes lo respondieron, o respondieron sus fechas candidatas, siempre lo ven, y un bloqueo entre un usuario y el organizador o un coorganizador se lo oculta a ese usuario.
  • La dirección y el enlace de un evento solo se muestran a los asistentes que el organizador o un coorganizador aprobó, salvo que el organizador los muestre a todos los que ven el evento. Los enlaces deben ser http o https, y el servidor nunca los abre.
  • Un usuario que ve un evento puede guardarlo como un archivo iCalendar (.ics) para añadirlo a su propio calendario. El archivo nombra solo los lugares que ese usuario ve, así que una dirección reservada a los asistentes aprobados nunca aparece en él. No hay ninguna dirección de suscripción al calendario.
  • Un usuario crea como máximo 10 eventos por hora, y un evento envía como máximo 100 invitaciones por hora.
  • Los usuarios pueden denunciar un evento y los moderadores pueden cancelar uno; suspender o eliminar a un organizador cancela los eventos del organizador que no han empezado (moderación). Quién respondió y quién fue invitado se conserva durante event_records_retention_days después del evento, y también los votos sobre sus fechas candidatas.
Clave Límite Descripción
name 100 caracteres, una línea (no se permiten solo espacios en blanco) El nombre de la instancia (nombre para mostrar). Consulta nombre y dominio
short_description 500 caracteres Una descripción breve
description 20000 caracteres La descripción
terms 100000 caracteres Los términos del servicio (Markdown)
privacy_policy 100000 caracteres La política de privacidad (Markdown)
commerce_disclosure 100000 caracteres La información del vendedor para los planes de pago, como el aviso que exige la ley japonesa (Markdown; colaboradores)
preview_image_alt 1500 caracteres El texto alternativo de la imagen preview_image (og:image:alt). Cuando no está definido, se usa «Imagen de {nombre de la instancia}»
thumbnail_alt 1500 caracteres El texto alternativo de la imagen thumbnail
  • Cada texto tiene un solo valor. Un administrador lo escribe una vez en el idioma que quiera, y los lectores de todos los idiomas ven el mismo valor; los lectores de otros idiomas dependen de la traducción automática o similar. Las etiquetas y descripciones de los campos de administración se traducen al idioma del usuario como cualquier otro texto de pantalla; solo el valor que escribe un administrador no.
  • El servidor no conoce el idioma de un texto, así que el cliente web y las pantallas generadas por el servidor emiten los textos con dir="auto" y lang="" (el valor HTML para un idioma desconocido) en lugar de heredar el idioma de la pantalla.
  • Definir un texto vacío lo elimina.
  • Además de la CLI, los textos pueden cambiarse en las pantallas de administración del cliente web (nombre, descripción breve y descripción en la página General de «Ajustes del servidor», /admin/settings/general; los términos en /admin/documents/terms, la política de privacidad en /admin/documents/privacy-policy y la información comercial en /admin/documents/commerce-disclosure, cada una una página de «Términos y políticas», /admin/documents) y con la API de cliente (GET /api/v1/admin/instance_texts, PUT /api/v1/admin/instance_texts/{key}). Ambos necesitan el permiso de rol manage_settings, y los cambios se registran en el registro de auditoría (text_changed).
  • Escribe terms, privacy_policy y commerce_disclosure en Markdown (CommonMark más las tablas, el tachado y los enlaces automáticos de GitHub Flavored Markdown). Un salto de línea dentro de un párrafo sigue siendo un salto de línea, y los encabezados # empiezan un nivel por debajo del título de la página (h2).
  • El servidor los convierte a HTML y lo sanea (GET /api/v1/instance/documents/{kind} anónimo), y las páginas del cliente web /about/terms, /about/privacy y /about/commerce los muestran. Se eliminan el HTML en bruto, las imágenes y los enlaces que no sean http, https y mailto. Las páginas no necesitan iniciar sesión (son páginas del cliente web, así que necesitan JavaScript). /about/commerce es la URL que hay que dar al proveedor de pagos.
  • Un documento que escribes se enlaza desde la pantalla de registro, el pie de cada pantalla que genera el servidor y el cliente web (la tercera columna, el menú, la configuración y la pantalla de inicio de sesión). Un documento que no está escrito no se enlaza, y su API responde 404.
  • Mientras estén escritos los términos del servicio o la política de privacidad, la pantalla de registro los lista antes del botón de crear con una casilla obligatoria, «He leído y acepto los documentos anteriores». El servidor rechaza un registro sin ella, también el que se hace mediante un proveedor de inicio de sesión. Sin ninguno de los dos documentos, la pantalla no pide ninguna aceptación.

Una instancia tiene un dominio y un nombre, por separado.

  • El dominio es la configuración host (y account_domain, el dominio de los identificadores de cuenta). No puede cambiarse mientras la instancia está en funcionamiento. Los identificadores (@alice@example.com), las URL, los ID de ActivityPub y domain en GET /api/v1/instance siguen siendo el dominio aunque haya un nombre.
  • El nombre es el texto name. Aparece dondequiera que se nombra la instancia a las personas: la barra lateral y «Acerca de este servidor» del cliente web, el título de la pestaña del navegador, las pantallas de inicio de sesión, registro, confirmación de correo electrónico, estado de la cuenta y consentimiento de autorización que genera el servidor, los correos electrónicos (confirmación de la dirección y avisos a los moderadores), og:site_name de las vistas previas de enlaces, name / short_name del Web App Manifest, metadata.nodeName de NodeInfo y name en GET /api/v1/instance.
  • El nombre es el mismo en todos los idiomas. Cuando no hay nombre, se muestra en su lugar el dominio (host).
  • Un cambio surte efecto desde la siguiente solicitud, sin reiniciar. El título de la pestaña y la barra lateral de un cliente web abierto se actualizan cuando guardas en la pantalla de administración.

El contacto de los operadores (contact_account, contact_email) y la imagen que representa a la instancia (thumbnail y el texto thumbnail_alt) aparecen en los lugares siguientes. Lo que no está definido no aparece.

  • «Acerca de este servidor» del cliente web (/about). La miniatura y la cuenta de contacto también aparecen en la primera pantalla (/) para las personas que no han iniciado sesión.
  • contact (account y email) y thumbnail (url, width, height, alt) en GET /api/v1/instance.
  • metadata en NodeInfo: maintainer según la convención de Misskey (name es el nombre para mostrar de la cuenta de contacto, o su nombre de usuario cuando no tiene; email es contact_email), staffAccounts según la convención de Pleroma y Akkoma (el ID del actor de la cuenta de contacto), thumbnail (url y alt) y nodeDescription a partir de la descripción breve short_description.

Cuando la cuenta de contacto está suspendida o eliminada, la cuenta no se muestra y solo se muestra la dirección de correo. Cámbialos en la página General de la pantalla de administración del cliente web («Ajustes del servidor», /admin/settings/general), o con la CLI o la API de cliente.

Un servidor solo de su operador, el propio hogar del operador en el fediverso, es un servidor de una sola persona: activa single_user. En el cliente web, un administrador lo activa y desactiva con Servidor de una sola persona en la página Registro de Ajustes del servidor, que dice por qué el servidor lo rechazó cuando tiene más de una cuenta local.

Ventana de terminal
my instance set single_user true
my instance set single_user false # back to a community server
  • Solo puede activarse mientras cuenta exactamente una cuenta local. Cuenta cada cuenta local que no está eliminada, incluidas las pendientes de aprobación, desactivadas, programadas para eliminación, suspendidas o limitadas, ya que cualquiera podría volver como una segunda persona. Una cuenta cuyo registro se rechazó no cuenta. Con cualquier otro número, my instance set falla con el recuento, y la API de administración responde 422 con el tipo /api/v1/problems/single-user-requires-one-account. El actor de la instancia del servidor no es una cuenta y nunca cuenta.
  • Puede desactivarse en cualquier momento. Activarlo o desactivarlo no elimina nada ni cambia el valor almacenado de ningún otro ajuste: lo que retiene se aplica de nuevo tal como estaba cuando se desactiva. Como todo ajuste, el cambio va al registro de auditoría.

Mientras está activado:

  • El registro está cerrado. registration_mode se lee como closed sea cual sea lo que almacena, así que la página de registro, el registro mediante un proveedor de inicio de sesión y my admin create no crean ninguna cuenta. Iniciar sesión con un proveedor de inicio de sesión sigue funcionando.
  • Solo la cronología de inicio. local_timeline_visibility y federated_timeline_visibility se leen como off. Las cronologías de etiquetas y de listas permanecen.
  • Lo que necesita una comunidad queda oculto. Las cronologías local y federada y sus streams, las sugerencias de cuentas, las invitaciones de usuarios y de administradores, la revisión de registros y los bloqueos de registro responden 404 con el tipo /api/v1/problems/single-user-mode.
  • Sin publicaciones locales nuevas. En un servidor de una sola persona, una publicación para «Vecinos» no llega a nadie más que a los seguidores, así que una publicación nueva no puede ser local: la API de cliente responde 422 y la omite de lo que una cuenta puede publicar. Una visibilidad predeterminada de «Vecinos» se lee como «Solo seguidores» y no puede guardarse, y una sala de chat de voz para las personas de este servidor se anuncia en una publicación para los seguidores. Las publicaciones que ya son locales siguen siendo locales.
  • El servidor dice lo que es. single_user en GET /api/v1/instance es true, con el modo de registro efectivo y las cronologías y la cuenta del operador como single_user_account, y NodeInfo responde openRegistrations: false con metadata.singleUser: true.
  • La portada es el perfil del operador. Las personas que no han iniciado sesión y abren la dirección del servidor ven el perfil de su única cuenta, con la forma de iniciar sesión y enlaces a la página «Acerca de», los términos del servicio y la política de privacidad que publica el servidor. El cliente web oculta lo que el servidor no ofrece, en su navegación, menús y pantallas de administración: las cronologías local y federada, el registro, las cuentas sugeridas, las invitaciones, la revisión de registros, los bloqueos de registro, la visibilidad «Vecinos» y los ajustes de registro, invitaciones, cronologías públicas, página de inicio y cuentas sugeridas.

La federación, la moderación, la búsqueda de texto completo, el programa de colaboradores, los documentos y las pantallas de administración funcionan como en cualquier servidor.

Ventana de terminal
my instance list # all settings (and whether each is the default) and texts
my instance get registration_mode
my instance set registration_mode open
my instance set name "Example Social" # the same name in every locale
my instance set description - < description.txt # the value "-" reads standard input
my instance get name
my instance set name "" # delete the name
my instance history registration_mode # revision history (newest first, -limit sets the count)
my instance history description
my instance set -owner admin preview_image ./preview.png # upload the image as media of admin and use it as the preview image
my instance set preview_image 0192f3a4-7b1c-7d2e-9f00-1a2b3c4d5e6f # give the ID of media that is already uploaded
my instance set preview_image_alt "A blue bird mascot"
my instance set preview_image "" # back to the bundled default image
my instance set contact_account admin # the contact account
my instance set contact_email admin@example.com
my instance set -owner admin thumbnail ./thumbnail.png # the thumbnail
my instance set thumbnail_alt "A town by the sea"
  • Escribe las opciones antes de la clave y el valor.
  • Con -owner <username>, el valor de preview_image o thumbnail se lee como la ruta de un archivo de imagen y se sube como medio de esa cuenta local. El worker procesa la imagen antes de usarla. Se recomienda una imagen apaisada de 1200x630.
  • Un cambio registra una revisión (instance_*_revisions) y actualiza el valor actual (instance_settings / instance_texts) en una sola transacción. Un cambio desde la CLI se registra sin actor (BY es cli en el historial).
  • Definir de nuevo el mismo valor añade igualmente una revisión.
  • Códigos de salida: 0 si todo va bien, 1 por un valor rechazado o un error de la base de datos (no cambia nada), 2 por argumentos incorrectos.
  • Restringirla conserva las relaciones de seguimiento, las publicaciones importadas y los registros de entrega, y no envía ningún Undo ni Reject. El flujo simplemente se detiene, y volver a both (u otro modo) lo reanuda tal como estaba.
  • Las publicaciones y reacciones hechas mientras estaba restringida no se entregan con carácter retroactivo cuando la amplías de nuevo.
  • En el lado remoto, los seguidores de los usuarios locales no reciben nada mientras el modo es inbound, y los seguimientos de los usuarios locales no se actualizan mientras es outbound u off.
  • Las eliminaciones (de publicaciones o de cuentas) hechas mientras el modo es off no se envían. En inbound y outbound, la retirada de lo que ya se envió (Delete y similares) va a los destinatarios originales y a los seguidores de aquel momento.
  • Los cambios se registran en instance_setting_revisions y en el registro de auditoría (target_kind = setting).

Para cortar también las relaciones, usa la CLI my admin federation sever.

Ventana de terminal
my admin federation sever -direction in # end follows of local users by remote accounts
my admin federation sever -direction out # end follows of remote accounts by local users
my admin federation sever -direction both
  • Pone fin a los seguimientos pendientes y activos entre cuentas locales y remotas como terminaciones por moderación (follow_terminations, reason = moderation). Un cambio de modo nunca lo llama automáticamente.
  • Reject (in) o Undo (out) se envía al lado remoto solo cuando el modo actual envía esa dirección. En un modo que no lo hace (como off), el seguimiento termina solo en el lado local y no se avisa al lado remoto.
  • Es seguro ejecutarlo repetidamente. Imprime en la salida estándar el número de seguimientos que terminó.

Pantallas de administración y la API de cliente

Sección titulada «Pantallas de administración y la API de cliente»

Todo ajuste que puede cambiar la CLI también puede cambiarse en las pantallas de administración del cliente web y con la API de cliente. Ambos necesitan el permiso de rol manage_settings (solo lo tiene el rol integrado admin). Como con la CLI, un cambio se conserva como una revisión y se registra por clave en el registro de auditoría (setting_changed, el destino es el ajuste y el actor es ese usuario). Consulta el registro de auditoría en la pantalla de moderación («Registro de auditoría», /moderation/audit-log).

  • Cliente web («Ajustes del servidor», /admin/settings): la pantalla enumera una página por tema, en grupos. Cada página tiene un formulario y un botón de guardar, y guardar envía solo lo que cambiaste en esa página; los ajustes de las otras páginas permanecen como están. Una opción cuyas alternativas cambian mucho dice debajo qué hace cada una, antes de guardar, y un número dice sus límites cuando se rechaza.

    Página Secciones y ajustes
    General (/admin/settings/general) Nombre y descripciones (name, short_description, description); Idioma (default_locale, elegido entre los idiomas que tiene la aplicación); Contacto (contact_account, contact_email); Imágenes (thumbnail y el texto thumbnail_alt, preview_image y el texto preview_image_alt)
    Icono y logotipo (/admin/settings/branding) El icono, el logotipo y el logotipo para fondos oscuros (Logotipo e icono)
    Registro (/admin/settings/registration) Quién puede registrarse (registration_mode, cada modo con lo que hace); Servidor de una sola persona (single_user); Invitaciones de miembros (invite_creators, member_invite_max_active, member_invite_max_uses, member_invite_max_lifetime_seconds en horas); Solo proveedores de inicio de sesión (login_providers_only, que pregunta antes, con cuántos usuarios activos ya no podrían iniciar sesión y si eres uno de ellos); Aplicaciones (user_app_registration, dynamic_client_registration, oauth_metadata_document_clients, oauth_client_rate_limits). En un servidor de una sola persona, las secciones de registro y de invitaciones de miembros dicen que nadie más se registra
    Publicaciones y funciones (/admin/settings/content) Publicaciones (max_status_length, require_media_description); Cronologías (local_timeline_visibility, federated_timeline_visibility); Tarjetas de enlace (link_cards, link_cards_ignore_robots_txt); Borradores y publicaciones programadas (max_drafts, max_scheduled_posts, max_scheduled_posts_per_day, scheduled_post_min_lead_minutes, scheduled_post_max_lead_days); Artículos (article_authoring, max_article_bytes, max_article_images); Eventos (event_creators, event_records_retention_days); Portada y sugerencias (public_counts, landing_fediverse_explanation, landing_features, featured_accounts)
    Chat de voz (/admin/settings/voice) Quién puede abrir salas (voice_room_starters); Salas (voice_public_summary, voice_participants_retention_days)
    Eliminación de publicaciones (/admin/settings/auto-delete) Valor predeterminado para las cuentas nuevas (los ajustes auto_delete_default_*); Máximo para todos (auto_delete_max_age_days, auto_delete_grace_days, los ajustes auto_delete_max_allow_*, auto_delete_max_kept_pins). Guardar un máximo que se activa o se acorta pregunta antes (Un máximo para conservar publicaciones)
    Federación (/admin/settings/federation) Dirección (federation_mode); Servidores (federation_scope: guardar allowlist muestra antes los seguimientos que terminaría el cambio y pregunta, consulta federar solo con los servidores permitidos); Obtenciones firmadas (authorized_fetch); Multimedia de otros servidores (remote_media_policy, remote_media_cache_ttl_seconds en minutos, remote_media_cache_max_bytes en MiB); Publicaciones de otros servidores (remote_status_retention_days, remote_status_max_retention_days, relay_status_retention_days); Servidores moderados (domain_actions_visibility, domain_actions_rationale_visibility)
    Búsqueda y rastreadores (/admin/settings/discovery) Motores de búsqueda (search_indexing, indexable_default); Contacto de seguridad (security_contact); IA (ai_usage); Búsqueda de texto completo (search_visibilities)
    Revisión externa (/admin/settings/hooks) Una sección para cada hook de decisión: su modo (enforce se ofrece solo cuando ya no es off), lo que hace cuando su plugin falla y sus otros ajustes; Registros de decisiones (hook_decisions_retention_days). Consulta Hooks de decisión
    Apelaciones y registros (/admin/settings/records) Apelaciones (appeal_window_days); Conservación de registros (session_origins_retention_days, registration_origins_retention_days, reports_retention_days, moderation_actions_retention_days, audit_log_retention_days)

    En la página General, una imagen se sube cuando guardas, y se convierte entonces en la miniatura o en la imagen de vista previa de enlaces. Quién puede ver los costes de funcionamiento, los ingresos y la lista de colaboradores se define en las pantallas «Costes e ingresos» y «Colaboradores». Los ajustes de traducción tienen una pantalla propia, más abajo.

  • Cliente web («Traducción», /admin/translation): los proveedores que tiene este servidor, su orden y lo que cada uno puede recibir, la traducción del navegador, los límites mensuales y cuánto tiempo se conservan las traducciones, con los caracteres enviados este mes y la tasa de aciertos de caché. Cada proceso del servidor añade su recuento de aciertos de caché a la tasa como máximo una vez por minuto, así que las últimas solicitudes pueden tardar un minuto en mostrarse, y un proceso que se detiene puede dejar sin contar su último minuto. Actualiza tu política de privacidad (plantilla) antes de activar un proveedor del lado del servidor: el texto enviado a un proveedor no puede retirarse. Las claves de API de los proveedores y la dirección de un plugin traductor viven en la configuración del despliegue; ningún ajuste ni ninguna respuesta de la API de cliente las contiene.

  • Límites de traducción. Lo que cuenta son los caracteres enviados, en puntos de código: los marcadores que sustituyen a menciones, enlaces y similares no cuentan, ni tampoco una traducción que el servidor ya conserva, una publicación que ya está en el idioma del lector o la traducción del navegador. Cada llamada a un proveedor cuenta, también la que falla, ya que el proveedor puede haber recibido el texto, así que el número puede diferir de lo que factura un proveedor. Por encima de un límite la solicitud se rechaza con un 429 y no se llama a ningún proveedor; el cliente web usa entonces la traducción del navegador del lector, cuando lo permites y el navegador puede traducir la publicación. Los meses son en UTC.

  • API de cliente: GET /api/v1/admin/settings devuelve cada ajuste con su valor actual, su valor predeterminado, si está definido y su tipo y valores aceptados (opciones o rango). PATCH /api/v1/admin/settings cambia ajustes a la vez con {"values": {"<key>": "<value>", ...}}. Todos los valores son cadenas, normalizadas y almacenadas como con la CLI. Si una sola clave es desconocida o un valor no es válido, la respuesta es un 422 que nombra la clave y no cambia nada. Las claves cambiadas se registran como revisiones y en el registro de auditoría en la misma transacción.

  • Las invitaciones, que funcionan en los modos open, approval e invite, se crean en la pantalla de moderación («Invitaciones», /moderation/invites, permiso manage_invites; consulta códigos de invitación), y los miembros según lo que permita invite_creators (invitaciones de miembros).

Las reglas de la instancia aparecen en rules de GET /api/v1/instance, y las denuncias las citan por ID.

  • Una regla tiene una frase de una línea (hasta 300 caracteres) y un complemento opcional (hasta 1000 caracteres). Como con los textos, el administrador las escribe en el idioma que quiera y todos los idiomas ven el mismo valor (dir="auto" y lang=""). Puede haber como máximo 100 reglas activas.
  • Cada cambio (una frase revisada, una reordenación) se conserva como una revisión (instance_rule_revisions), y el ID de una regla no cambia.
  • Una regla retirada desaparece de la lista de reglas activas. No puede recuperarse, pero las denuncias pueden seguir refiriéndose a ella.
Ventana de terminal
my instance rule create -hint "No harassment" "Be kind" # add at the end of the active rules
my instance rule edit <rule> "Always be kind" # change the sentence; the supplement changes only with -hint
my instance rule move <rule> 1 # move to position 1 and renumber the active rules 1, 2, ...
my instance rule retire <rule> # retire it
my instance rule list # active rules (-all includes retired ones)
  • La API de administración es /api/v1/admin/rules (listar, añadir, obtener, revisar, mover, retirar) y requiere el permiso de rol manage_rules.
  • En la pantalla de administración del cliente web («Reglas», /admin/rules, manage_rules), la lista muestra las reglas en vigor en orden, y «Subir» y «Bajar» las reordenan; el filtro sobre la lista muestra en su lugar las reglas retiradas. «Añadir una regla» abre una página con una frase y un complemento. Elige la frase de una regla para abrir su página, donde la editas y la retiras (tras un cuadro de diálogo de confirmación). Cada cambio se registra en el registro de auditoría (rule_added, rule_revised, rule_moved, rule_retired).
  • Los códigos de salida son los mismos que para las configuraciones (0 si todo va bien, 1 por un valor rechazado o un error de la base de datos, 2 por argumentos incorrectos).

Las tarjetas de enlace de las publicaciones (link_cards) vienen de un rastreador: el servidor obtiene la página enlazada y su imagen. Una regla detiene ese rastreador en un dominio y sus subdominios, y deja en paz todo lo demás del dominio. Tiene uno de dos modos. Una regla es una decisión del operador, y se aplica además de lo que los propios sitios enlazados rechazan (vistas previas de enlaces).

Modo Qué obtiene Tarjetas que ya tiene
Dejar de obtener (no_fetch) Nada del dominio, ni páginas ni imágenes, tampoco cuando una redirección lleva allí Ocultas
Dejar de obtener solo imágenes (no_images) Páginas, pero ninguna imagen del dominio Mostradas sin su imagen
  • Una regla afecta solo a las tarjetas de enlace. El dominio sigue federado, y la multimedia de sus publicaciones se obtiene como de costumbre: para aislar un servidor, usa una acción de dominio, que también detiene sus tarjetas de enlace. Una regla no se enumera con las acciones de dominio ni se exporta con ellas.
  • Una regla cubre el dominio y sus subdominios, y una imagen se comprueba contra los hosts de la página y de la imagen. Se aplica toda regla que cubra un host, así que una regla sobre un subdominio no relaja la regla de su dominio padre. Un dominio se escribe y normaliza como para una acción de dominio: un nombre de host sin esquema ni puerto, en cualquier grafía de un dominio internacionalizado.
  • Un cambio surte efecto de inmediato, también sobre las tarjetas que el servidor ya tiene, y las imágenes proxificadas de esas tarjetas dejan de servirse mientras las imágenes están detenidas.
  • Quitar una regla devuelve las tarjetas que el servidor ya tiene a como estaban. Un enlace que se omitió recibe su tarjeta la próxima vez que una publicación la necesite; no se vuelve a obtener nada de forma masiva. Una tarjeta obtenida de nuevo mientras las imágenes estaban detenidas permanece sin imagen hasta su siguiente nueva obtención.
  • En la pantalla de administración del cliente web («Dominios de tarjetas de enlace», /admin/link-card-domains, manage_settings), «Añadir una regla» define una regla con su modo y una nota, y rechaza un dominio que ya tiene una regla, con un enlace a esa regla. La lista muestra las reglas por dominio, de 40 en 40 con «Mostrar más»; al elegir un dominio se abre la página de su regla, donde cambias su modo y su nota, y la quitas (tras un cuadro de confirmación).
  • La API de administración es /api/v1/admin/link_card_domains (listar, definir; un DELETE con el dominio lo quita) y necesita el permiso de rol manage_settings. Un servidor conserva como máximo 1000 reglas, cada una con una nota de hasta 5000 caracteres.
  • Cada cambio se registra en el registro de auditoría (link_card_domain_fetch_stopped, link_card_domain_images_stopped, link_card_domain_rule_removed).

El tema de todo el servidor es un conjunto de sustituciones de los tokens de diseño del cliente web, con un valor claro y uno oscuro para cada color. Se aplica al cliente web de todos los usuarios y a las pantallas que genera el servidor (inicio de sesión, registro, términos, etc.). No hay CSS personalizado.

  • Puedes sustituir estos tokens de diseño; el espaciado, los tamaños de los componentes, los pesos de la tipografía, las sombras y los colores de los gráficos de datos permanecen fijos:

    Tokens Tipo Sustitución
    color-surface, color-surface-raised, color-surface-raised-hover, color-surface-raised-pressed, color-surface-hover, color-surface-pressed, color-text, color-muted-text, color-accent, color-on-accent, color-accent-text, color-quote-bar color #rrggbb para claro y para oscuro
    font-sans-override, font-mono-override familia tipográfica Nombres de familia, separados por comas (como máximo 30), sin familia genérica como sans-serif; pon entre comillas un nombre con una palabra que empiece por un dígito, como "M PLUS 1p"
    text-tagline, text-headline, text-heading, text-title, text-reading, text-body, text-caption longitud 0 o rem / px, de 0.625rem a 3rem
    text-*--line-height de los mismos siete número de 1 a 2.5
    radius-control, radius-overlay longitud de 0 a 2rem
    duration-spin duración ms / s, de 0 a 1000ms
  • El cliente web dibuja el texto con sus propias fuentes: Noto Color Emoji para emoji, Noto Sans para latín, griego y cirílico, y Noto Sans CJK en los glifos del idioma del texto para el resto. Las fuentes de font-sans-override (texto) y font-mono-override (código) van justo después de la fuente de emoji, y las fuentes del cliente web dibujan los caracteres que les faltan a las tuyas. Un tema no puede reemplazar estas fuentes.

  • Guardas un conjunto como borrador, lo previsualizas y luego lo publicas; el tema en vigor no cambia hasta que publicas. Cada guardado reemplaza todo el borrador, y cada publicación es una revisión nueva. Restaurar vuelve a publicar el conjunto que estaba en vigor antes del actual, y deja el borrador como está.

  • En el cliente web, Administración > Tema muestra el borrador y el tema en vigor. Editar el borrador muestra cada color en claro y en oscuro con el contraste de cada par que forma, y no guarda un par por debajo de su mínimo. Previsualizar muestra el borrador en cada pantalla de la pestaña de tu navegador hasta que lo pulsas de nuevo; nadie más lo ve. Publicar y Restaurar el tema anterior están en la misma pantalla. El icono y el logotipo están en Ajustes del servidor > Icono y logotipo.

  • Cuando guardas y cuando publicas, el servidor comprueba la forma y el rango de los valores y el contraste de cada par de tokens de color (los tokens que no sustituyes usan sus valores predeterminados; WCAG 2.2 AA tanto en claro como en oscuro). Si falla alguna comprobación, no se guarda ni se publica nada.

  • La sustitución de un token que una versión nueva renombra o retira, o cuyo valor ya no encaja con el token, nunca hace fallar una actualización. Permanece en el conjunto guardado pero ya no se aplica: la API de administración la enumera en stale_tokens, my instance theme get la nombra y el siguiente guardado del borrador la descarta.

  • La hoja de estilo de la revisión publicada se sirve en /theme/{revision ID}.css (immutable, en caché durante mucho tiempo). El shell HTML tiene una caché compartida (60 segundos más 300 segundos de revalidación), así que tarda unos minutos después de publicar en que todo el mundo lo reciba. Una página que ya está abierta mantiene el aspecto antiguo hasta que se recarga.

  • <meta name="theme-color"> (claro y oscuro) en el shell y theme_color / background_color (claro) del Web App Manifest toman el valor de color-surface del tema. La versión HTML de cada correo que el servidor envía desde entonces usa los colores del tema publicado, claro y oscuro; un borrador nunca llega al correo.

  • Publicar un conjunto sin tokens restablece el tema al predeterminado, y la hoja de estilo deja de cargarse.

  • Puedes cambiarlo con la API de cliente y con la CLI. La API de cliente necesita el permiso de rol manage_settings: GET /api/v1/admin/theme lee el borrador y el conjunto en vigor, PUT /api/v1/admin/theme/draft guarda el borrador, GET /api/v1/admin/theme/draft/stylesheet devuelve la hoja de estilo del borrador para previsualizarla, y POST /api/v1/admin/theme/publish y POST /api/v1/admin/theme/restore publican. Las publicaciones se registran en el registro de auditoría (setting_changed, destino theme).

Ventana de terminal
my instance theme get > theme.json # print the draft as the same JSON as the admin API (-published: the set in effect)
my instance theme set < theme.json # save the whole draft (if a check fails, it prints why and changes nothing)
my instance theme publish # publish the draft
my instance theme restore # publish again the set in effect before the current one
echo '{"tokens":[]}' | my instance theme set && my instance theme publish # back to the default
{
"tokens": [
{ "token": "color-accent", "light": "#ff8a80", "dark": "#ff8a80" },
{ "token": "radius-control", "value": "0.25rem" }
]
}

Además de la miniatura y la imagen de vista previa, la instancia puede tener su propio icono, logotipo y logotipo oscuro, cada uno subido como un SVG. Hasta que se define uno, se usan las imágenes integradas de mycroblog, y borrar uno devuelve la imagen integrada.

Imagen Forma Dónde aparece
icon Cuadrada (con un margen del 1 %) El favicon, el icono de pantalla de inicio de iOS (apple-touch-icon), los iconos de la aplicación instalada (Web App Manifest), la tarjeta del servidor en la página de inicio y junto a su nombre en el panel lateral del cliente web, y dondequiera que un cliente muestre el servidor como imagen cuadrada
logo De 1 a 8 veces más ancha que alta La cabecera del cliente web y la parte superior de las páginas de inicio de sesión, registro y consentimiento en lugar del logotipo de texto integrado y el nombre del servidor (el logotipo debe contener el nombre, que es su texto alternativo), la versión HTML de cada correo y la imagen de vista previa de enlaces cuando preview_image no está definida
logo_dark Como logo Fondos oscuros; sin él, logo se usa también allí
  • El servidor sanea el SVG. Lo lee como XML y escribe un documento nuevo solo con los elementos permitidos (formas, grupos, defs, symbol, use, degradados, clipPath, mask, pattern, style, title, desc) y los atributos (geometría, transformaciones, atributos de presentación, id, class, style). Se eliminan los scripts, foreignObject, las imágenes incrustadas, los enlaces, las animaciones, los filtros (sombras y desenfoques), los controladores de eventos, las referencias a cualquier cosa fuera del archivo y las URL data:, y la respuesta enumera lo que se eliminó. Solo se almacena el SVG saneado.
  • Un SVG se rechaza (no se guarda nada) cuando no es XML bien formado en UTF-8, tiene un DOCTYPE o declaraciones de entidades, no tiene viewBox, supera 256 KiB (128 KiB tras sanear), tiene más de 5000 elementos, se anida a más de 32 niveles, tiene más de 200 elementos use, tiene una forma incorrecta para su tipo, contiene text (convierte antes el texto en contornos en tu editor) o tiene CSS que podría cargar algo (@import, @font-face, url() distinto de url(#id), escapes). @media (prefers-color-scheme: dark) en un <style> está permitido, de modo que un icono puede cambiar en modo oscuro.
  • Algunos lugares no admiten SVG (la pantalla de inicio de iOS, los favicons de Safari antiguos, las vistas previas de enlaces, el correo). Para ellos el cliente que sube el SVG también dibuja versiones PNG a partir del SVG saneado y las envía con él: 32, 48, 180, 192 y 512 px y un icono maskable de 512 px para icon; un logotipo de correo de 96 px de alto y una imagen de vista previa de enlaces de 1200 × 630 para logo; un logotipo de correo de 96 px de alto para logo_dark. El servidor comprueba que cada una es un PNG del tamaño correcto (como máximo 1 MiB; el icono de 180 px, el icono maskable y la vista previa de enlaces deben ser opacos) y lo escribe de nuevo sin metadatos. Si algún archivo es incorrecto, no se guarda nada. Las versiones opacas del icono se dibujan sobre un color de fondo, #rrggbb, que por defecto es el color-surface claro del tema. El servidor no comprueba que las versiones PNG muestren la misma imagen que el SVG.
  • Los archivos se almacenan en el almacén de blobs bajo instance/brand/<revision>/ y se sirven en https://<host>/brand/<revision>/<version>.svg|.png con Cache-Control: public, max-age=31536000, immutable, ya que el contenido de una revisión nunca cambia. Un SVG se sirve con Content-Security-Policy: default-src 'none'; style-src 'unsafe-inline'; sandbox y X-Content-Type-Options: nosniff, así que incluso abierto por sí solo no ejecuta ni carga nada. Los archivos de revisiones anteriores permanecen, así que los correos ya enviados conservan su logotipo.
  • Con un icono definido, el shell HTML enlaza sus favicons PNG, su SVG y su apple-touch-icon de 180 px, el Web App Manifest enumera sus iconos de 512 px, 192 px, maskable y SVG en ese orden (otros servidores del fediverso toman el primero como el icono de este servidor), y /apple-touch-icon.png devuelve la versión de 180 px. El ETag del shell cambia con las imágenes, y la caché compartida del shell dura unos minutos como con el tema. Una aplicación instalada recoge un icono nuevo en Android cuando Chrome comprueba el manifiesto la próxima vez; en los equipos de escritorio la aplicación conserva su icono antiguo hasta que se instala de nuevo.
  • GET /api/v1/instance devuelve icon, logo y logo_dark con la URL del SVG, la URL y el tamaño de cada versión PNG y la revisión; cada uno se omite mientras se usa la imagen integrada.
  • Defínelos en el cliente web en Ajustes del servidor > Icono y logotipo (/admin/settings/branding, permiso de rol manage_settings). Elige un archivo SVG para el icono, el logotipo o el logotipo para fondos oscuros: el servidor lo comprueba de inmediato, y el formulario lo muestra tal como lo conservaría el servidor, con la lista de lo que el servidor eliminó. Si el servidor rechaza el archivo, el motivo aparece debajo con cómo corregirlo. Para el icono, define allí también el color de fondo de sus versiones opacas. Guardar dibuja las versiones PNG en el navegador y envía con ellas cada imagen elegida; Usar la imagen integrada devuelve una imagen a la integrada cuando guardas. El cliente web conserva las imágenes que ha mostrado para el uso sin conexión.
  • La API de cliente hace lo mismo, con el permiso de rol manage_settings: POST /api/v1/admin/instance/brand/sanitize comprueba un SVG y devuelve el SVG saneado con las versiones PNG que hay que dibujar (no guarda nada), PUT /api/v1/admin/instance/brand/{icon|logo|logo_dark} guarda el SVG con cada versión PNG (multipart/form-data, una parte por versión), DELETE en la misma ruta borra uno, y GET /api/v1/admin/instance/brand devuelve las imágenes actuales con el color de fondo del icono. Cada cambio se conserva como una revisión (instance_brand_revisions) y se registra en el registro de auditoría (setting_changed, destino brand_icon, brand_logo o brand_logo_dark).
  • La CLI no puede definirlas, ya que las versiones PNG las dibuja el cliente, pero puede mostrarlas y borrar una rota:
Ventana de terminal
my instance brand show # each image with its revision, when and by whom it was set, and the URL of its SVG
my instance brand clear icon # back to the built-in icon (also logo, logo_dark)

Los emoji personalizados locales se muestran como imágenes cuando alguien escribe :shortcode: en el cuerpo o la advertencia de contenido de una publicación, o en el nombre para mostrar, la biografía o los campos del perfil. También llegan a Mastodon, Misskey, GoToSocial y Akkoma mediante la etiqueta Emoji de las Notes y los actores que envías.

  • Un shortcode tiene de 2 a 30 letras, dígitos o _. Distingue mayúsculas de minúsculas y no puede cambiarse después de registrar el emoji. Los alias (hasta 10) y una categoría (hasta 64 caracteres) se usan para buscar y agrupar en el selector de emoji.
  • La imagen es PNG, GIF o WebP, de como máximo custom_emoji_max_bytes (256 KiB por defecto) y de como máximo 1024 px por lado. El servidor crea derivados que caben en cajas de 64, 128 y 256 px y no conserva el original. Un APNG se convierte en una imagen fija de su primer fotograma. GoToSocial por defecto no obtiene emoji de más de 100 KiB, así que se recomiendan imágenes pequeñas.
  • Un emoji desactivado no aparece en ningún lugar (publicaciones, perfiles, federación, selector), y :shortcode: vuelve a mostrarse como texto. Un emoji definido para ocultarse del selector solo falta en el selector y aún puede usarse escribiéndolo. Un emoji que vino de otro servidor solo puede desactivarse o copiarse como un emoji de este servidor.
  • Copiar obtiene la imagen del emoji de otro servidor con los mismos límites que el proxy de multimedia (no se obtienen las imágenes de dominios con reject_media), ejecuta las mismas comprobaciones de arriba y lo registra como un emoji local nuevo. El shortcode es el del original o el que des. La imagen se reduce a la caja de 256 px, y una imagen que no puede obtenerse o no supera las comprobaciones no deja nada.
  • La eliminación no se puede deshacer. Los emoji de publicaciones pasadas también vuelven a ser texto, y registrar de nuevo el mismo shortcode crea un emoji distinto. Las imágenes que los servidores federados copiaron no pueden eliminarse.
  • La pantalla de administración («Emoji personalizados», /admin/custom-emojis), la API de cliente (/api/v1/admin/custom_emojis) y la CLI hacen lo mismo. En la pantalla, «Registrar un emoji» abre el formulario de registro (/admin/custom-emojis/new), que avisa de una imagen de más de 100 KiB, y al elegir un emoji de la lista se abre su página (/admin/custom-emojis/{id}), donde lo activas o desactivas, sustituyes su imagen, cambias su categoría, alias y visibilidad en el selector, lo eliminas tras escribir su shortcode, o copias uno de otro servidor. La pantalla de administración y la API de cliente necesitan el permiso de rol manage_custom_emojis (solo lo tiene el rol integrado admin). Registrar, copiar, sustituir la imagen, cambiar ajustes y alias, activar y desactivar, y eliminar se registran en el registro de auditoría (destino custom_emoji) se hagan como se hagan (una operación desde la CLI se registra como una operación de la CLI).
Ventana de terminal
my admin emoji create -shortcode blobcat -category Cats -alias neko blobcat.png # register one
my admin emoji list -local # list local emoji, newest first
my admin emoji update -category Animals -alias cat -alias neko <emoji id> # change the category and aliases (aliases are replaced; -no-aliases removes them)
my admin emoji update -hidden <emoji id> # hide it from the picker (-hidden=false restores it)
my admin emoji replace-image <emoji id> blobcat2.png # replace the image
my admin emoji disable <emoji id> # disable it (remote emoji too)
my admin emoji enable <emoji id> # enable it again
my admin emoji list -remote -domain mastodon.example # list emoji of another server
my admin emoji copy [-shortcode <name>] <emoji id> # copy a remote emoji to local
my admin emoji delete <emoji id> # delete it
my admin emoji requests list [-state pending|approved|rejected|withdrawn|lapsed|all] # list creation requests (pending by default)
my admin emoji requests approve <request id> # approve a request
my admin emoji requests reject [-reason <text>] <request id> # reject a request (the requester sees the reason)
  • Un usuario con el permiso de rol create_custom_emojis (una función de usuario) puede solicitar la creación de un emoji desde «Emoji personalizados» en la configuración (/settings/custom-emojis), cambiar los alias, la categoría y la visibilidad en el selector de los emoji que creó, y eliminarlos; la página muestra cuántas solicitudes le quedan este mes. Sustituir una imagen también es una solicitud, hecha con la API de cliente (POST /api/v1/custom_emoji_requests, kind image); la página de configuración no lo ofrece. Una solicitud no aparece en ningún lugar (selector, publicaciones, reacciones, federación) hasta que alguien con manage_custom_emojis la aprueba. Apruébala o recházala en la página «Solicitudes» de «Emoji personalizados» de la pantalla de administración (/admin/custom-emojis/requests), con la API de cliente (/api/v1/admin/custom_emoji_requests) o con la CLI de arriba. Las personas con manage_custom_emojis reciben notificación de una solicitud (admin_custom_emoji_request), y el solicitante recibe notificación de la aprobación o el rechazo. Solicitar, retirar, aprobar y rechazar se registran en el registro de auditoría (destino custom_emoji_request).
  • Una solicitud de creación pendiente reserva su shortcode. No es posible una solicitud o un registro con el mismo shortcode hasta que se rechace o se retire la pendiente. La imagen de un emoji aprobado se copia como una subida del actor de la instancia, así que permanece aunque se elimine la cuenta del solicitante.
  • Un creador puede cambiar sus emoji solo mientras tenga create_custom_emojis. Los emoji permanecen si se quita el rol. Los administradores pueden cambiar y eliminar todos los emoji, sea cual sea el creador.
  • Cuando el rol viene de un plan de colaborador, el número de emoji que un usuario puede crear cada mes está limitado por el límite mensual de emoji del plan. Cuenta las solicitudes de creación que el usuario envió en el mes natural en curso (UTC) y que están aprobadas o pendientes; las solicitudes rechazadas y retiradas no cuentan, y eliminar un emoji no libera un puesto. Una solicitud cuenta en el mes en que se envió, aunque se apruebe en el siguiente. El recuento se restablece a las 00:00 UTC del primer día de cada mes, y la página de configuración se lo muestra al usuario, en su propia zona horaria. Sustituir la imagen de un emoji, y los emoji que registran los administradores, no cuentan. Un rol que un administrador asignó a mano, y un servidor donde los colaboradores están desactivados, no tienen límite.

Para LLM y agentes de programación:llms.txt,llms-full.txt, llms-small.txt

Analítica de este sitio