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.
Requisitos previos
Sección titulada «Requisitos previos»- La configuración se da como se describe en la referencia de configuración (
my config check). - El esquema está aplicado a la base de datos (
my schema apply; consulta Base de datos).
Ajustes (una clave, un valor)
Sección titulada «Ajustes (una clave, un valor)»| 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 (
TRUEpasa atrue,0750pasa a750,ja_jppasa aja-JP, los ID de multimedia se pasan a minúsculas). Un valor no válido se rechaza y no se escribe nada. preview_imageythumbnailaceptan 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_imagerecurre 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_accountacepta solo el nombre de usuario de un usuario local que no está eliminado (almacenado en minúsculas).contact_emailacepta solo una dirección con la formaalice@example.com.featured_accountsacepta 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.
Sugerencias de cuentas
Sección titulada «Sugerencias de cuentas»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.
Un máximo para conservar publicaciones
Sección titulada «Un máximo para conservar publicaciones»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_deleterechazan 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; conauto_delete_max_kept_pinspor 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.
Borradores y publicaciones programadas
Sección titulada «Borradores y publicaciones programadas»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_drafta 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 conmy instance set, por ejemplomy 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.
Artículos
Sección titulada «Artículos»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_authoringenpermission, solo los usuarios cuyos roles tienen el permisocreate_articlespueden 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 darcreate_articlescomo ventaja. max_article_bytesacota 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_imagesacota 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_articlespara las cuentas nuevas,auto_delete_max_allow_articlesbajo un máximo). GET /api/v1/instancedevuelve los límites enlimits.articlesy el ajuste de autoría enarticle_authoring. Defínelos conmy instance set, por ejemplomy instance set article_authoring permission.
Eventos
Sección titulada «Eventos»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_startersy la configuraciónvoice) 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
httpohttps, 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_daysdespués del evento, y también los votos sobre sus fechas candidatas.
Textos (una clave, un valor)
Sección titulada «Textos (una clave, un valor)»| 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"ylang=""(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-policyy 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 rolmanage_settings, y los cambios se registran en el registro de auditoría (text_changed).
Términos y política de privacidad
Sección titulada «Términos y política de privacidad»- Escribe
terms,privacy_policyycommerce_disclosureen 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/privacyy/about/commercelos muestran. Se eliminan el HTML en bruto, las imágenes y los enlaces que no seanhttp,httpsymailto. Las páginas no necesitan iniciar sesión (son páginas del cliente web, así que necesitan JavaScript)./about/commercees 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.
Nombre y dominio
Sección titulada «Nombre y dominio»Una instancia tiene un dominio y un nombre, por separado.
- El dominio es la configuración
host(yaccount_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 ydomainenGET /api/v1/instancesiguen 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_namede las vistas previas de enlaces,name/short_namedel Web App Manifest,metadata.nodeNamede NodeInfo ynameenGET /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.
Contacto y miniatura
Sección titulada «Contacto y miniatura»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(accountyemail) ythumbnail(url,width,height,alt) enGET /api/v1/instance.metadataen NodeInfo:maintainersegún la convención de Misskey (namees el nombre para mostrar de la cuenta de contacto, o su nombre de usuario cuando no tiene;emailescontact_email),staffAccountssegún la convención de Pleroma y Akkoma (el ID del actor de la cuenta de contacto),thumbnail(urlyalt) ynodeDescriptiona partir de la descripción breveshort_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.
Servidor de una sola persona
Sección titulada «Servidor de una sola persona»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.
my instance set single_user truemy 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 setfalla con el recuento, y la API de administración responde422con 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_modese lee comoclosedsea cual sea lo que almacena, así que la página de registro, el registro mediante un proveedor de inicio de sesión ymy admin createno crean ninguna cuenta. Iniciar sesión con un proveedor de inicio de sesión sigue funcionando. - Solo la cronología de inicio.
local_timeline_visibilityyfederated_timeline_visibilityse leen comooff. 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
404con 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
422y 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_userenGET /api/v1/instanceestrue, con el modo de registro efectivo y las cronologías y la cuenta del operador comosingle_user_account, y NodeInfo respondeopenRegistrations: falseconmetadata.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.
my instance list # all settings (and whether each is the default) and textsmy instance get registration_modemy instance set registration_mode openmy instance set name "Example Social" # the same name in every localemy instance set description - < description.txt # the value "-" reads standard inputmy instance get namemy instance set name "" # delete the namemy instance history registration_mode # revision history (newest first, -limit sets the count)my instance history descriptionmy instance set -owner admin preview_image ./preview.png # upload the image as media of admin and use it as the preview imagemy instance set preview_image 0192f3a4-7b1c-7d2e-9f00-1a2b3c4d5e6f # give the ID of media that is already uploadedmy instance set preview_image_alt "A blue bird mascot"my instance set preview_image "" # back to the bundled default imagemy instance set contact_account admin # the contact accountmy instance set contact_email admin@example.commy instance set -owner admin thumbnail ./thumbnail.png # the thumbnailmy instance set thumbnail_alt "A town by the sea"- Escribe las opciones antes de la clave y el valor.
- Con
-owner <username>, el valor depreview_imageothumbnailse 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 (BYesclien 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.
Cambiar la dirección de la federación
Sección titulada «Cambiar la dirección de la federación»- Restringirla conserva las relaciones de seguimiento, las publicaciones importadas y los registros de entrega, y no envía ningún
UndoniReject. El flujo simplemente se detiene, y volver aboth(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 esoutbounduoff. - Las eliminaciones (de publicaciones o de cuentas) hechas mientras el modo es
offno se envían. Eninboundyoutbound, la retirada de lo que ya se envió (Deletey similares) va a los destinatarios originales y a los seguidores de aquel momento. - Los cambios se registran en
instance_setting_revisionsy en el registro de auditoría (target_kind = setting).
Para cortar también las relaciones, usa la CLI my admin federation sever.
my admin federation sever -direction in # end follows of local users by remote accountsmy admin federation sever -direction out # end follows of remote accounts by local usersmy 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) oUndo(out) se envía al lado remoto solo cuando el modo actual envía esa dirección. En un modo que no lo hace (comooff), 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 (thumbnaily el textothumbnail_alt,preview_imagey el textopreview_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_secondsen 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 registraPublicaciones 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 ajustesauto_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: guardarallowlistmuestra 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_secondsen minutos,remote_media_cache_max_bytesen 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 ( enforcese ofrece solo cuando ya no esoff), lo que hace cuando su plugin falla y sus otros ajustes; Registros de decisiones (hook_decisions_retention_days). Consulta Hooks de decisiónApelaciones 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
429y 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/settingsdevuelve 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/settingscambia 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,approvaleinvite, se crean en la pantalla de moderación («Invitaciones»,/moderation/invites, permisomanage_invites; consulta códigos de invitación), y los miembros según lo que permitainvite_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"ylang=""). 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.
my instance rule create -hint "No harassment" "Be kind" # add at the end of the active rulesmy instance rule edit <rule> "Always be kind" # change the sentence; the supplement changes only with -hintmy instance rule move <rule> 1 # move to position 1 and renumber the active rules 1, 2, ...my instance rule retire <rule> # retire itmy 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 rolmanage_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).
Dominios de tarjetas de enlace
Sección titulada «Dominios de tarjetas de enlace»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; unDELETEcon el dominio lo quita) y necesita el permiso de rolmanage_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-barcolor #rrggbbpara claro y para oscurofont-sans-override,font-mono-overridefamilia 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-captionlongitud 0o rem / px, de 0.625rem a 3remtext-*--line-heightde los mismos sietenúmero de 1 a 2.5 radius-control,radius-overlaylongitud de 0 a 2rem duration-spinduració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) yfont-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 getla 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 ytheme_color/background_color(claro) del Web App Manifest toman el valor decolor-surfacedel 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/themelee el borrador y el conjunto en vigor,PUT /api/v1/admin/theme/draftguarda el borrador,GET /api/v1/admin/theme/draft/stylesheetdevuelve la hoja de estilo del borrador para previsualizarla, yPOST /api/v1/admin/theme/publishyPOST /api/v1/admin/theme/restorepublican. Las publicaciones se registran en el registro de auditoría (setting_changed, destinotheme).
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 draftmy instance theme restore # publish again the set in effect before the current oneecho '{"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" } ]}Logotipo e icono
Sección titulada «Logotipo e icono»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 URLdata:, 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
DOCTYPEo declaraciones de entidades, no tieneviewBox, 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 elementosuse, tiene una forma incorrecta para su tipo, contienetext(convierte antes el texto en contornos en tu editor) o tiene CSS que podría cargar algo (@import,@font-face,url()distinto deurl(#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 paralogo; un logotipo de correo de 96 px de alto paralogo_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 elcolor-surfaceclaro 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 enhttps://<host>/brand/<revision>/<version>.svg|.pngconCache-Control: public, max-age=31536000, immutable, ya que el contenido de una revisión nunca cambia. Un SVG se sirve conContent-Security-Policy: default-src 'none'; style-src 'unsafe-inline'; sandboxyX-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-iconde 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.pngdevuelve 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/instancedevuelveicon,logoylogo_darkcon 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 rolmanage_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/sanitizecomprueba 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),DELETEen la misma ruta borra uno, yGET /api/v1/admin/instance/branddevuelve 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, destinobrand_icon,brand_logoobrand_logo_dark). - La CLI no puede definirlas, ya que las versiones PNG las dibuja el cliente, pero puede mostrarlas y borrar una rota:
my instance brand show # each image with its revision, when and by whom it was set, and the URL of its SVGmy instance brand clear icon # back to the built-in icon (also logo, logo_dark)Emoji personalizados
Sección titulada «Emoji personalizados»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 rolmanage_custom_emojis(solo lo tiene el rol integradoadmin). Registrar, copiar, sustituir la imagen, cambiar ajustes y alias, activar y desactivar, y eliminar se registran en el registro de auditoría (destinocustom_emoji) se hagan como se hagan (una operación desde la CLI se registra como una operación de la CLI).
my admin emoji create -shortcode blobcat -category Cats -alias neko blobcat.png # register onemy admin emoji list -local # list local emoji, newest firstmy 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 imagemy admin emoji disable <emoji id> # disable it (remote emoji too)my admin emoji enable <emoji id> # enable it againmy admin emoji list -remote -domain mastodon.example # list emoji of another servermy admin emoji copy [-shortcode <name>] <emoji id> # copy a remote emoji to localmy admin emoji delete <emoji id> # delete itmy 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 requestmy 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,kindimage); 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 conmanage_custom_emojisla 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 conmanage_custom_emojisreciben 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 (destinocustom_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