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
Administradores y roles
Cómo crear al primer administrador, gestionar roles desde la línea de comandos, anunciar y llevar a cabo el fin del servicio, procesar de nuevo las imágenes subidas, reconstruir el índice de búsqueda, gestionar los certificados TLS que el propio servidor sirve y exportar la página de mantenimiento.
Requisitos previos
Sección titulada «Requisitos previos»- La configuración (
host,database,database_url,kek, etc.) está definida como describe la referencia de configuración.my config checkla verifica. - El esquema está aplicado en la base de datos (
my schema apply; consulta database.md). hostyaccount_domainson definitivos. El primer comando que usa la base de datos los registra, y todos los comandos posteriores se niegan a ejecutarse si la configuración difiere (consulta Settings you cannot change later).
Crear un administrador
Sección titulada «Crear un administrador»my admin create -username alice -email alice@example.com- Desde un terminal, el comando pide la contraseña dos veces, sin mostrarla.
- Cuando la entrada estándar no es un terminal, la primera línea de la entrada estándar es la contraseña (por ejemplo
my admin create ... < password.txt). La contraseña no puede darse como argumento de la línea de comandos ni como variable de entorno, porque acaban en las listas de procesos y en el historial del shell. - Donde un comando puntual no tiene ni terminal ni entrada estándar, como un job de Cloud Run, añade
-password-link. El comando entonces no lee ninguna contraseña: establece una aleatoria que nadie conoce e imprime un enlace después de la líneacreated admin, que establece la contraseña una sola vez, durante una hora, comomy admin account password-reset-link(el registro de auditoría lo anota comopassword_reset_link_issued). Quien pueda leer la salida del comando puede usar el enlace, y en una plataforma así esa salida permanece en los registros de la plataforma hasta que el enlace se usa o caduca. Abre el enlace enseguida. Si caduca, emite otro conmy admin account password-reset-link @alice. Si falla la emisión del enlace, el administrador ya existe: el comando lo dice y termina con el código 1, y el mismo comando da un enlace nuevo. - Una contraseña tiene de 8 a 128 caracteres. Nunca aparece en la salida, en los registros ni en un mensaje de error.
- Una transacción crea el usuario, la contraseña, la dirección de correo principal, la cuenta local (con sus claves) y la concesión del rol
admin(sin quien lo concede, lo que significa la CLI). Los roles integrados se crean antes si faltan. - Si todo va bien, el comando imprime
created admin @alice@<account_domain> (user <id>, account <id>)y termina con el código 0. - En un servidor de una sola persona el comando no crea ninguna cuenta y termina con el código 1. Mientras el inicio de sesión está limitado a los proveedores de inicio de sesión, también avisa de que la contraseña no puede iniciar sesión hasta que termine la limitación.
Ejecutarlo de nuevo
Sección titulada «Ejecutarlo de nuevo»- Cuando el nombre de usuario o la dirección de correo electrónico (ambos sin distinguir mayúsculas de minúsculas) ya están en uso, el comando no cambia nada, imprime cuál está en uso y termina con el código 1. Nunca cambia la contraseña ni los roles del usuario existente.
- Una ejecución fallida no escribe nada, así que puedes corregir la causa y ejecutar el mismo comando otra vez.
- El código de salida 2 indica un error de uso.
Conceder y revocar roles
Sección titulada «Conceder y revocar roles»Los roles contienen permisos. Los roles integrados son admin (position 1000, todos los permisos) y
moderator (position 100, con manage_reports, manage_accounts y view_audit).
my serve comprueba los roles integrados cada vez que arranca (en un proceso de cualquier role), y my admin role los comprueba cada vez que se ejecuta.
Cada uno crea lo que falta y da a admin todos los permisos de la versión en ejecución.
Cuando una actualización añade un permiso, no hace falta ningún paso manual. Un moderator conserva los permisos y la posición que fijó el administrador.
my admin role list # each role's position, permissions (grouped as moderation, server administration, and member features), and holdersmy admin role list -user alice # the roles of alicemy admin role grant alice moderatormy admin role revoke alice moderator-
Los permisos pertenecen a uno de tres grupos.
- Moderación:
manage_reports,manage_accounts,manage_domains,manage_invites,view_audit. - Administración del servidor:
manage_settings,manage_rules,manage_roles,manage_jobs,manage_login_recovery,manage_custom_emojis,manage_webhooks,manage_announcements,manage_finance,manage_supporters,manage_oauth_apps,manage_service_closure,manage_errors,manage_login_providers. - Funciones de miembro:
view_finance,create_custom_emojis,start_voice_rooms,create_invites,keep_posts_longer,create_articles,create_events.
listimprime una columna por grupo (MODERATION,SERVER,MEMBER). El cliente web muestra «Moderación» y «Administración» para los dos primeros grupos y no cuenta las funciones de miembro en ninguno (consulta moderation.md). - Moderación:
-
Un cambio surte efecto en la siguiente solicitud del usuario. Las notificaciones para moderadores van a las personas que tienen el permiso cuando se crea la notificación.
-
Las concesiones y revocaciones se escriben en el registro de auditoría como
role_grantedyrole_revoked(tipo de destinorole). El actor de una operación de la CLI escli(my admin audit list -target-kind role). -
Conceder un rol que el usuario ya tiene, o revocar uno que no tiene, no cambia ni registra nada.
-
El último titular de
adminno puede perderlo (código de salida 1). Concede antesadmina otro usuario. -
La pantalla de administración «Roles» (
/admin/roles) enumera todos los roles y los crea, cambia y elimina: la página de un rol fija su posición, sus permisos y su insignia. Ofrece solo lo que permiten las reglas siguientes: una posición no más alta que tu rol más alto, los permisos que tienes (los demás que tiene un rol se nombran y se conservan), solo la insignia deadmin, y no se pueden eliminaradminnimoderator. Eliminar un rol pide escribir su nombre. Los roles de un plan se fijan desde el plan. -
La API de administración es
GET /api/v1/admin/roles,GET /api/v1/admin/accounts/{id}/rolesyPUT/DELETE /api/v1/admin/accounts/{id}/roles/{role}, y necesita el permisomanage_roles. Mediante la API, no puedes conceder ni revocar un rol por encima de lapositionmás alta entre tus propios roles (403). Revocar el últimoadmindevuelve 409. -
El personal actúa solo sobre rangos inferiores. Mediante la API, las acciones de moderación y su levantamiento, la resolución de apelaciones, el levantamiento de supresiones de correo, la revelación de los datos privados de una cuenta, la emisión de un enlace de restablecimiento de contraseña y la eliminación de la autenticación en dos pasos exigen que la
positionmás alta entre tus roles esté por encima de la de cada rol del destinatario; un rango superior o igual, incluida tu propia cuenta, devuelve 403. Un moderador no puede actuar sobre un administrador, y un administrador no puede actuar sobre otro. Estos comandos (my admin account ...) no tienen tal límite, así que úsalos cuando los administradores discrepen. -
No se puede bloquear ni quitar al único administrador:
disable_login,suspendybansobre él se rechazan, mediante la API (409) y estos comandos (código de salida 1), y no puede eliminar su propia cuenta (409). Otro titular deadmincuenta solo mientras pueda iniciar sesión: no después de eliminar su cuenta, ni mientras esté suspendido, vetado o condisable_login.
Anunciar el cierre del servicio
Sección titulada «Anunciar el cierre del servicio»Para cerrar el servidor, anuncia primero el cierre. service-closure.md describe todo el procedimiento, desde el anuncio hasta la eliminación de los datos.
El servidor sigue funcionando con normalidad durante el anuncio. closure en GET /api/v1/instance y metadata.serviceClosure en NodeInfo muestran el estado y las fechas.
my admin closure announce -closes-at 2027-01-31T15:00:00Z -message "Thank you for using this server."my admin closure announce -closes-at 2027-02-28 -export-until 2027-04-30 # change the dates (a bare date means 00:00 UTC)my admin closure status # the state and the schedule in effectmy admin closure withdraw # withdraw the announcement-closes-atno tiene límite inferior.-export-until(el plazo para sacar los datos) debe ser igual o posterior a-closes-at, y por defecto es 30 días después de la fecha de cierre.- Cuando faltan menos de 30 días para la fecha de cierre, el comando imprime un aviso en la salida de error estándar (el anuncio se registra igualmente).
- Cambiar las fechas se registra como un anuncio nuevo, y un anuncio hecho después de una retirada también es nuevo. Una vez cerrado el servidor, no se puede anunciar ni retirar (código de salida 1).
- Anunciar, cambiar las fechas y retirar se escriben en el registro de auditoría como
service_closure_announcedyservice_closure_withdrawn(tipo de destinoinstance; consultamy admin audit list -target-kind instance). - La API de administración es
GET /api/v1/admin/closure,PUT/DELETE /api/v1/admin/closure/announcement,GET /api/v1/admin/closure/checkyPOST /api/v1/admin/closure/close. Requiere el permisomanage_service_closure(entre los roles integrados, soloadminlo tiene). - Durante el anuncio, el servidor no acepta usuarios nuevos ni pagos nuevos.
- El modo de registro efectivo es
closed(el valor deregistration_modeno cambia y vuelve a tener efecto cuando se retira el anuncio). No funcionan ni los registros ni los registros con invitación, y las solicitudes pendientes no se pueden aprobar (409). - Al anunciar se rechazan todas las solicitudes pendientes (se registran como decididas por
service_closure) y se cancelan, al final de su periodo, todas las suscripciones de mecenas en curso. Los suscriptores reciben una notificación (supporter_service_closure) y un correo electrónico. Las suscripciones nuevas devuelven409. Retirar el anuncio no deshace los rechazos ni las cancelaciones. - Cada anuncio, cambio de fechas y retirada envía la notificación
service_closurea todos los usuarios locales. Todo esto se ejecuta como trabajos, así que no detengas el worker. - Cada usuario con una dirección de correo electrónico confirmada recibe un correo electrónico por el anuncio, un cambio de fechas, una retirada, 7 días y 1 día antes de la fecha de cierre, el cierre y 7 días antes del plazo de exportación. Los usuarios no pueden desactivarlo (consulta email.md).
- Tras la fecha de cierre, las personas que tienen
manage_service_closurereciben la notificaciónadmin_service_closure_due. El servidor no se cierra solo.
- El modo de registro efectivo es
Después de la fecha de cierre, cierra el servidor. El cierre no se puede deshacer.
my admin closure check # review what the closure endsmy admin closure close # show the review, then ask for y and the domain namemy admin closure close -confirm-domain social.example # for automation: pass the domain name instead of answeringcheckyclosemuestran el número de cuentas locales, el número de buzones de destino (los buzones compartidos conocidos), una estimación de las actividadesDeleteque se enviarán (su producto), el número de suscripciones de mecenas en curso, el número de migraciones sin terminar (Move) y el número de cuentas bajo retención (retention_holds). Cuando quedan migraciones o existe una retención, el comando avisa en la salida de error estándar. Exporta los registros de las cuentas bajo retención conmy admin account export-moderationy guárdalos antes de eliminar los datos.closese niega sin preguntar cuando no hay anuncio y antes de la fecha de cierre (código de salida 1). Cualquier respuesta distinta dey, o una entrada que difiera del dominio del servidor (hosten la configuración, sin distinguir mayúsculas de minúsculas), no cambia nada y termina con el código 1.- El cierre se escribe en el registro de auditoría como
service_closure_closed. En la misma transacción termina todas las suscripciones de mecenas en curso (motivoservice_closed) y encola los trabajos que cancelan de inmediato las suscripciones en el proveedor de pagos (CancelNow). - Tras el cierre, la API de cliente solo admite estas peticiones: leer tu propia cuenta y configuración, las exportaciones (
/exports,/csv_exports), las sesiones (/sessions,/authorized_apps),GET /instancey la administración del cierre y de la cola de trabajos. Todo lo demás se rechaza con403(/api/v1/problems/service-closed). Los flujos se detienen y Web Push no envía nada. Iniciar sesión y restablecer la contraseña siguen funcionando. - Tras el cierre, el worker entrega un
Deletedel actor de cada cuenta local a los pares de la federación, de 100 en 100 (las cuentas migradas, al final). Los envía incluso cuandofederation_modeesoffoinbound, y nunca a un dominio suspendido.my admin closure status(yprogressenGET /api/v1/admin/closure) muestra cuántas cuentas tienen unDeleteregistrado, cuántas entregas quedan por expandir y el número de entregas en cada estado (pending,succeeded,permanent_failure,skipped,dead). Mantén el worker en ejecución durante la entrega. Cuando todas las entregas han terminado, una comprobación que se ejecuta cada 10 minutos registradelivery_completed(service_closure_delivery_completeden el registro de auditoría), y los actores locales pasan a responder410. El servidor no vuelve a ejecutar por sí mismo las entregasdead; vuelve a ejecutarlas conmy job retry.
Una vez pasado el plazo de exportación, escribe la página estática de cierre que tu dominio sirve cuando el servidor está detenido. El comando lee la base de datos, así que ejecútalo antes de eliminarla.
my admin closure export-html -out ./closure # every locale (the instance's default locale first)my admin closure export-html -out ./closure -lang ja,en # choose the locales and the order in index.html- Salida:
<dir>/<locale>.htmlpara cada idioma y<dir>/index.htmlcon todos los idiomas uno tras otro. Las páginas usan la misma plantilla quemy maintenance exporty muestran el nombre del servidor, la fecha de cierre, el mensaje del operador del anuncio ystatus_page_url. La salida incluye además ejemplos de configuración para el front end:nginx.conf,Caddyfileycloudfront-function.js. Responden410para/ap/*,/inbox, WebFinger, host-meta, NodeInfo y/@*, y sirven la página de cierre para todo lo demás. - El comando se niega (código de salida 1) a menos que el servidor esté cerrado. Antes de
delivery_completedimprime un aviso y escribe las páginas igualmente. service-closure.md describe cómo cambiar el front end a la página estática.
Procesar de nuevo las imágenes subidas
Sección titulada «Procesar de nuevo las imágenes subidas»Cada imagen subida conserva tres tamaños, y una animación también sus versiones en movimiento. Una nueva versión de my puede cambiar esos tamaños o formatos, y una imagen existente conserva sus archivos hasta que la procesas de nuevo:
my admin media reprocess -before 2027-01-31T09:00:00Z-beforetoma la hora del cambio, como la hora a la que actualizaste, en RFC 3339. Solo se toman las imágenes procesadas por última vez antes de esa hora, y una hora que aún no ha pasado se rechaza.- El worker hace el trabajo, 100 imágenes por minuto, cada una en un trabajo propio (
media.reprocess_walkymedia.reprocessen la referencia de trabajos). Mantén un worker en ejecución; la página de trabajos de administración (/admin/jobs) muestra la cola. - Ejecutarlo de nuevo con la misma hora es seguro. Las imágenes ya procesadas se dejan como están, y se recogen las que la primera ejecución no alcanzó.
- Los originales no se conservan, así que cada imagen se vuelve a generar a partir de su versión grande. El detalle que la versión grande perdió no se recupera, y cada ejecución con una hora posterior vuelve a codificar las imágenes y pierde un poco de calidad. Ejecútalo una sola vez por cambio.
- Los archivos de video y de audio no se vuelven a codificar y se dejan como están. Una imagen que los límites actuales ya no aceptan conserva su versión actual, y el worker registra un aviso.
La nueva versión de una imagen tiene URL nuevas. Los archivos antiguos se conservan durante media_replaced_retention (30 días por defecto, referencia de configuración), de modo que las páginas abiertas y las cachés siguen funcionando, y después el trabajo horario media.purge_replaced los elimina. No se avisa a otros servidores de las URL nuevas: un servidor que aún conserva una URL antigua y no tiene copia propia deja de mostrar la imagen pasado ese tiempo. Cuenta con el almacenamiento adicional hasta que desaparezcan los archivos antiguos.
Reconstruir el índice de búsqueda
Sección titulada «Reconstruir el índice de búsqueda»my search gestiona el índice de la búsqueda de texto completo de las publicaciones, en un servidor con un motor de búsqueda. Con search = none, cada comando lo indica, no hace nada y termina con el código 0.
my search rebuild # empty the index, then have the worker add every post that qualifiesmy search rebuild --keep # add them without emptying the indexmy search rebuild --rate 50 # at most 50 posts a second (20 by default, 1000 at most)my search clear # empty the index and end any rebuildmy search status # the backend and the progress and failures of the latest rebuildEjecuta my search rebuild de nuevo para reanudar una reconstrucción interrumpida. Continúa desde la última publicación procesada y no vuelve a vaciar el índice. Mientras haya una sin terminar, el otro modo se rechaza con el código de salida 1. Full-text search of posts indica cuándo usar cada uno.
Certificados TLS
Sección titulada «Certificados TLS»my tls gestiona los certificados de un servidor que sirve HTTPS por sí mismo (tls = acme o tls = files; consulta
Servir HTTPS desde el servidor).
my tls status # each host: certificate, renewal, failures, latest ordersmy tls renew -host social.example # order a certificate now, without waitingmy tls revoke -host social.example -reason key_compromise # replace, then revoke the current certificatestatusmuestra, para cada host, el certificado actual (número de serie, emisor, caducidad), cuándo se renueva, cuántos pedidos seguidos no obtuvieron certificado y los últimos pedidos con sus errores. Contls = filesmuestra el certificado detls_cert_file; contls = offlo dice.renewyrevokenecesitantls = acme, el servidor en ejecución (responde a las comprobaciones de la autoridad de certificación) y unkvdistinto dememory. Terminan con el código 1 cuando fallan, cuando otro proceso está pidiendo en ese momento el certificado del host, y contls = filesotls = off.-reasoneskey_compromisecuando otras personas pueden conocer la clave privada, y en otro casosupersededuoperator.revoketermina con el código 0 e imprime una advertencia cuando revocó el certificado pero no pudo pedir su sustituto.
Comandos y métricas explica qué hace cada uno a los procesos en ejecución.
Exportar la página de mantenimiento
Sección titulada «Exportar la página de mantenimiento»my maintenance export escribe la página del modo de mantenimiento como HTML estático,
para que un balanceador de carga, una CDN o un proxy inverso la sirva mientras my serve no puede ejecutarse (una imagen que se está sustituyendo, una revisión que no arranca).
Usa la misma plantilla que el modo de mantenimiento, así que ambos muestran las mismas palabras y el mismo aspecto.
my maintenance export -out ./maintenance -lang en,ja # reads the database for at most 5 secondsmy maintenance export -out ./maintenance -lang en,ja -offline # the configuration and the default theme only- Salida:
<dir>/<locale>.htmlpara cada idioma de-lang, para los front ends que eligen una página porAccept-Language, y<dir>/index.htmlcon todos los idiomas uno tras otro, para los que no pueden. Las páginas tienen CSS en línea, ningún script y ningún recurso externo; su Content-Security-Policy está en un elemento<meta>. - Palabras: los ajustes
maintenance_server_name,maintenance_message,maintenance_untilystatus_page_url(referencia de configuración). - Sin
-offline, también lee el nombre de la instancia (cuandomaintenance_server_nameno está definido), su idioma predeterminado (cuando no se da-lang) y las sustituciones de tokens de su tema publicado. Cuando no se puede leer la base de datos, imprime una advertencia, escribe las páginas a partir de la configuración y el tema predeterminado, y termina con 0. - Ejecútalo de nuevo siempre que esos ajustes o el tema cambien, y antes de cada mantenimiento, para que las páginas del front end estén al día.
Para LLM y agentes de programación:llms.txt,llms-full.txt, llms-small.txt