Esta página é uma tradução automática da página em inglês, que é a versão de referência. Ler a página em inglês
Implantando com Docker Compose
Como executar o my em uma única máquina com Docker Compose: a configuração mais simples, um processo de servidor com SQLite e os arquivos de mídia em um volume nomeado. PostgreSQL, armazenamento de objetos e TLS são arquivos que você adiciona por cima depois
(arquivos do Docker Compose).
Você precisa do Docker e do Docker Compose v2.
Iniciando o servidor
Seção intitulada “Iniciando o servidor”Os arquivos do Compose estão em deploy/docker do código-fonte. Pegue-os da tag da versão que você executa, para que combinem com a imagem dela:
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- O Compose baixa a imagem
ghcr.io/mycroblog/mydaMY_VERSION. Não existe taglatest, então a versão precisa ser informada: uma versão pode exigir passos que uma atualização silenciosa pularia (as tags da imagem). Para construir a imagem a partir do código-fonte em vez disso, adicione o override:docker compose -f compose.yaml -f compose.build.yaml up -d --build. - O serviço
schemaexecutamy schema applyda imagem do servidor, que traz o banco de dados, em um volume nomeado, para o esquema daquela versão, e então termina; o servidor (role=all) inicia depois que ele tiver sucesso. O esquema é aplicado de novo a cadaup, então, depois de uma atualização, você inicia o servidor do mesmo jeito. - O servidor escuta em
127.0.0.1:8080(a porta éMY_HTTP_PORTno.env). Ele está pronto quandocurl localhost:8080/readyzretorna{"status":"ok"}. - A chave de criptografia de chaves (KEK) chega ao servidor a partir de
secrets/kek, como o segredo do Docker/run/secrets/my_kek, nunca como variável de ambiente (gerenciando a chave de criptografia de chaves). - Toda outra configuração da referência de configuração é definida no
.env, cujo modelo descreve cada uma delas.
Criando um administrador
Seção intitulada “Criando um administrador”Crie um administrador e depois consulte a conta com o WebFinger e busque o seu ator. A senha é lida da primeira linha da entrada padrão.
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>Entrando pelo navegador
Seção intitulada “Entrando pelo navegador”Com o par MY_HOST=localhost:8080 e MY_WEB_ORIGIN=http://localhost:8080 do example.env, o login, a API do cliente e a mídia funcionam sobre HTTP simples em http://localhost:8080 (os ids do ActivityPub continuam como https://localhost:8080/...). Se você alterar MY_HTTP_PORT, altere também a porta de MY_HOST e MY_WEB_ORIGIN para que correspondam.
- Abra
http://localhost:8080/loginem um navegador (ou clique em Entrar na barra superior do cliente web); isso abre a tela de login do servidor. - Na tela de login, informe o e-mail e a senha do administrador que você criou acima.
- Você volta ao cliente web, na sua linha do tempo inicial.
- O cookie de login é
Secure. Chrome e Firefox aceitam esse cookie emhttp://localhost; o Safari (WebKit) não aceita, então use o Chrome ou o Firefox localmente. - Os links de hashtags e menções nos corpos das publicações usam
https://, pois são as URLs federadas.
Abrindo ao público
Seção intitulada “Abrindo ao público”- Defina
MY_HOSTem.envcom o seu domínio real, removaMY_WEB_ORIGIN(o padrão éhttps://{MY_HOST}) e termine o TLS na frente do servidor: a camadacompose.caddy.yamlexecuta o Caddy para isso (arquivos do Docker Compose), ou deixe o próprio servidor servir HTTPS (servindo HTTPS pelo servidor).MY_HOSTé gravado no banco de dados na primeira inicialização e não pode ser alterado depois. - Atrás de um proxy reverso seu, defina
MY_TRUSTED_PROXIESem.envpara que limites de taxa, como o do login, se apliquem por IP de cliente e não ao proxy (trusted_proxies). - Antes de abrir o servidor aos usuários, percorra a lista de verificação de produção.
docker compose downpara a stack.down -vtambém exclui os volumes de dados.
Para todas as configurações, veja a referência de configuração; para a operação do dia a dia, veja executando o servidor.
Para LLMs e agentes de programação:llms.txt,llms-full.txt, llms-small.txt