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
Desplegar con Docker Compose
Cómo ejecutar my en una sola máquina con Docker Compose: la configuración más pequeña, un proceso de servidor con
SQLite y los archivos multimedia en un volumen con nombre. PostgreSQL, el almacenamiento de objetos y TLS son archivos
que se añaden después (archivos de Docker Compose).
Necesitas Docker y Docker Compose v2.
Arrancar el servidor
Sección titulada «Arrancar el servidor»Los archivos de Compose están en deploy/docker del código fuente. Tómalos de la
etiqueta de la versión que ejecutas, para que coincidan con su imagen:
git clone --depth 1 --branch v0.1.0 https://github.com/mycroblog/my.gitcd my/deploy/dockercp example.env .env# Set MY_VERSION in .env to the same version, such as 0.1.0mkdir -m 700 secrets(umask 022; openssl rand -base64 32 > secrets/kek) # the key encryption key: back it up apart from the databasedocker compose up -d- Compose descarga la imagen
ghcr.io/mycroblog/mydeMY_VERSION. No existe la etiquetalatest, así que hay que indicar la versión: una versión puede requerir pasos que una actualización silenciosa omitiría (las etiquetas de la imagen). Para compilar la imagen desde el código descargado, añade el archivo de sustitución:docker compose -f compose.yaml -f compose.build.yaml up -d --build. - El servicio
schemaejecutamy schema applyde la imagen del servidor, que lleva la base de datos de un volumen con nombre al esquema de esa versión, y termina; el servidor (role=all) arranca cuando ha terminado con éxito. El esquema se aplica de nuevo en cadaup, así que tras una actualización arrancas el servidor del mismo modo. - El servidor escucha en
127.0.0.1:8080(el puerto esMY_HTTP_PORTen.env). Está listo cuandocurl localhost:8080/readyzdevuelve{"status":"ok"}. - La clave de cifrado de claves (KEK) llega al servidor desde
secrets/kekcomo el secreto de Docker/run/secrets/my_kek, nunca como variable de entorno (gestionar la clave de cifrado de claves). - Todos las demás configuraciones de la referencia de configuración se definen en
.env, cuya plantilla los describe.
Crear un administrador
Sección titulada «Crear un administrador»Crea un administrador, busca después la cuenta con WebFinger y recupera su actor. La contraseña se lee de la primera línea de la entrada estándar.
docker compose exec -T my my admin create -username alice -email alice@example.com < password.txtcurl 'http://localhost:8080/.well-known/webfinger?resource=acct:alice@localhost:8080'curl -H 'Accept: application/activity+json' http://localhost:8080/ap/actors/<the UUID of the self link from WebFinger>Iniciar sesión desde un navegador
Sección titulada «Iniciar sesión desde un navegador»Con el par MY_HOST=localhost:8080 y MY_WEB_ORIGIN=http://localhost:8080 de example.env, el inicio de sesión, la API
de cliente y el contenido multimedia funcionan por HTTP sin cifrar en http://localhost:8080 (los ids de ActivityPub
siguen siendo https://localhost:8080/...). Si cambias MY_HTTP_PORT, cambia también el puerto de MY_HOST y de
MY_WEB_ORIGIN.
- Abre
http://localhost:8080/loginen un navegador (o pulsa Iniciar sesión en la barra superior del cliente web); se abre la pantalla de inicio de sesión del servidor. - En la pantalla de inicio de sesión, escribe la dirección de correo electrónico y la contraseña del administrador que has creado antes.
- Vuelves al cliente web, a tu cronología de inicio.
- La cookie de inicio de sesión es
Secure. Chrome y Firefox la aceptan enhttp://localhost; Safari (WebKit) no, así que usa Chrome o Firefox en local. - Los enlaces de etiquetas y menciones en el cuerpo de las publicaciones usan
https://, ya que son las URL federadas.
Salir a producción
Sección titulada «Salir a producción»- Define
MY_HOSTen.envcon tu dominio real, eliminaMY_WEB_ORIGIN(por defecto eshttps://{MY_HOST}) y termina TLS delante del servidor: la capacompose.caddy.yamlejecuta Caddy para eso (Archivos de Docker Compose), o deja que el propio servidor sirva HTTPS (servir HTTPS desde el servidor).MY_HOSTse guarda en la base de datos en el primer arranque y no se puede cambiar después. - Detrás de un proxy inverso propio, define
MY_TRUSTED_PROXIESen.envpara que los límites de tasa, como el del inicio de sesión, se apliquen por IP de cliente y no al proxy (trusted_proxies). - Antes de abrir el servidor a los usuarios, repasa la lista de comprobación de producción.
docker compose downdetiene la pila.down -vtambién elimina los volúmenes de datos.
Para cada ajuste consulta la referencia de configuración; para el funcionamiento diario consulta ejecutar el servidor.
Para LLM y agentes de programación:llms.txt,llms-full.txt, llms-small.txt