Saltar para o conteúdo principal
Este documento aborda a configuração do S3 no Server CE e no Ayakaleaf Pro. Há um guia separado sobre a migração de dados existentes para um armazenamento compatível com S3.
Se você implantar o Ayakaleaf Pro com o armazenamento s3.md ativado, os dados armazenados no S3 são criptografados?Não. Os dados não são criptografados. Todos os chunks de histórico, arquivos de template, PDFs e outros arquivos são armazenados em texto simples. Se você usar um provedor externo de armazenamento S3 de terceiros, preste muita atenção à segurança e à privacidade dos dados.

Quando considerar o uso do S3 para armazenamento de dados

Para instâncias com menos de 1000 licenças, recomendamos usar armazenamento em disco local com backups consistentes regulares. Para instâncias maiores, com mais de 1000 licenças, que atingem os limites do armazenamento local (tamanho ou taxa de transferência), recomendamos usar um back end de armazenamento de objetos compatível com S3 em vez de outras soluções de armazenamento em rede, como NFS.

Opções de armazenamento de objetos compatível com S3

Estas são as opções mais populares de armazenamento de objetos compatível com S3:
  • AWS S3, gerenciado; sugerimos escolher o AWS S3 ao executar o Ayakaleaf Pro na AWS
  • MINIO, auto-hospedado
  • Ceph, auto-hospedado
  • Outros provedores de hospedagem também oferecem algum tipo de armazenamento de objetos gerenciado compatível com S3; você pode preferir usá-lo em vez de manter o seu próprio se já executa o Ayakaleaf Pro nesse provedor.

Considerações sobre latência ao escolher um armazenamento de objetos compatível com S3

A latência entre a sua instância e o seu armazenamento de objetos compatível com S3 contribui muito para o tempo necessário para concluir a migração. A latência também afeta o desempenho do upload de arquivos no Ayakaleaf Pro, e downloads de arquivos lentos também podem ter um grande impacto nos tempos de compilação de PDF. Sugerimos minimizar a distância geográfica entre a sua instância e o armazenamento de objetos compatível com S3. Em um ambiente gerenciado, isso significa provisionar um bucket na mesma região e, em uma solução on-premise, executar os dois no mesmo campus.

Configuração do S3

Precisamos de três “buckets” e duas contas de usuário restritas. O bucket overleaf-user-files e OVERLEAF_FILESTORE_USER_FILES_BUCKET_NAME só eram usados pelo Overleaf antes da v6.0.0. O Ayakaleaf Pro, a partir da v6.0.0, não os utiliza. O Ayakaleaf Pro também não usa o bucket global de blobs (OVERLEAF_HISTORY_BLOBS_BUCKET) nem o bucket de zips (OVERLEAF_HISTORY_ZIPS_BUCKET), então você não precisa criá-los.
Os buckets não devem ser acessíveis publicamente
BucketUsoServiçoAnteriormente em /var/lib/overleaf/data
overleaf-template-filesarquivos de templatefilestoretemplate_files
overleaf-project-blobsblobs do histórico de projetoshistory e filestore somente leiturahistory/overleaf-project-blobs
overleaf-chunkschunks de históricohistoryhistory/overleaf-chunks
Você pode querer/precisar escolher um nome diferente; certifique-se de usar os buckets personalizados em todos os comandos. A seguir, serão usados placeholders para as credenciais reais:
Variável de ambienteDescrição
OVERLEAF_FILESTORE_S3_ACCESS_KEY_IDA chave de acesso/nome de usuário do usuário restrito do serviço filestore.
OVERLEAF_FILESTORE_S3_SECRET_ACCESS_KEYA chave secreta/senha do usuário restrito do serviço filestore.
OVERLEAF_HISTORY_S3_ACCESS_KEY_IDA chave de acesso/nome de usuário do usuário restrito do serviço history.
OVERLEAF_HISTORY_S3_SECRET_ACCESS_KEYA chave secreta/senha do usuário restrito do serviço history.
O Ayakaleaf Pro precisa apenas de um pequeno conjunto de permissões em cada bucket:
  • criar objeto
  • obter objeto
  • excluir objeto
  • listar bucket

Políticas de acesso

Veja como poderia ser uma política para o usuário do filestore:
Veja como poderia ser uma política para o usuário do history:

Visão geral das variáveis

Ao usar o AWS S3

Ao usar uma opção auto-hospedada

Configuração do MINIO

MINIO_ROOT_USER e MINIO_ROOT_PASSWORD são as credenciais root da instância MINIO.
Siga a documentação oficial para obter uma cópia do mc.
Última modificação em 21 de novembro de 2026