Início
» ESCRITÓRIO MS
»
How to Change the Default Storage Location in ONLYOFFICE Workspace
How to Change the Default Storage Location in ONLYOFFICE Workspace
Short answer: in ONLYOFFICE Workspace, the Control Panel can move portal static data away from the default local disk to a supported third-party storage service. The current official administration guide lists Amazon S3, Google Cloud Storage, Rackspace Cloud Storage, and Selectel Cloud Storage for this purpose. It does not describe a Control Panel field where you can type an arbitrary local path such as /mnt/storage.
This guide uses a clearly hypothetical example throughout. Imagine a small design agency called Northstar Studio. Its self-hosted ONLYOFFICE Workspace server is running out of local disk space because uploaded files and other portal static data have grown steadily. The administrator wants to move that portal storage to an Amazon S3 bucket while keeping the Workspace portal itself on the same server. Northstar Studio is only an illustration, not a real test or customer result.
Before changing anything, it helps to distinguish two different tasks that are often described as “changing the default storage location.” The first is switching the portal’s static-data storage from the local disk to a supported object-storage provider in the Control Panel. The second is moving the host filesystem directory used by a self-hosted Docker installation. ONLYOFFICE documents these as different layers, so the steps below focus first on the supported Control Panel method and then explain the local-disk case separately.
What changes when you select a new storage provider?
By default, ONLYOFFICE Workspace stores portal data on the local disk of the machine where Workspace is installed. The official Storage page says a connected third-party service can be used for static portal data. After you choose and connect a new provider, the page reloads and a data migration process starts. Depending on the amount of data, that migration can take time.
For Northstar Studio, the goal is therefore not “make every user save future documents into a particular folder.” It is “move the portal’s storage backend from Disk Default to the S3 bucket.” That distinction matters because user folder organization, connected third-party folders inside the Documents module, backup destinations, and the administrator-level Storage backend are separate features.
Step 1: Back up the portal before changing storage
A storage change starts a migration, so create a recoverable backup first. ONLYOFFICE provides backup and restore controls in the Control Panel. A backup can be stored temporarily, in the Documents module, on a computer path, or in supported third-party storage depending on the deployment and configuration.
Para o hipotético servidor Northstar Studio, o administrador faria um novo backup e confirmaria onde o arquivo resultante está armazenado antes de acessar a página de Armazenamento. Isso não garante que uma migração falhará; simplesmente fornece ao administrador um caminho de recuperação caso as credenciais, a política do bucket, o acesso à rede ou outra dependência estejam incorretas.
Passo 2: Abra o Painel de Controle e verifique a integração.
Faça login com uma conta que possa administrar o portal. Na página inicial do Workspace, abra o Painel de Controle ou abra as Configurações do portal e siga o link Painel de Controle na área lateral esquerda. O serviço de terceiros deve primeiro ser conectado na seção Integração do portal; caso contrário, a opção de armazenamento será desativada na página Armazenamento.
Ilustração da interface do espaço de trabalho ONLYOFFICE mostrando as Configurações com a entrada do Painel de Controle usada para acessar a administração do portal.
A Northstar Studio planeja usar o Amazon S3, portanto, o administrador primeiro verifica se o Amazon S3 está configurado como um serviço de terceiros. O mesmo pré-requisito se aplica ao escolher o Google Cloud Storage, o Rackspace Cloud Storage ou o Selectel Cloud Storage.
Ilustração da integração do painel de controle listando Amazon S3, Google Cloud Storage, Rackspace Cloud Storage e Selectel Cloud Storage como integrações de armazenamento.
No Painel de Controle, acesse a página Armazenamento em Configurações Comuns . A opção Disco Padrão está selecionada inicialmente. É aqui que você escolhe qual servidor de armazenamento compatível deve conter os dados estáticos do portal.
Ilustração do Painel de Controle de Armazenamento com o Disco Padrão selecionado e as quatro opções de armazenamento de terceiros documentadas visíveis.
Se você deseja apenas manter os dados no disco local do servidor, não selecione um provedor de nuvem. A opção "Disco Padrão" continua sendo a escolha para armazenamento local. Se sua necessidade real é mover esses dados locais para um ponto de montagem diferente no mesmo servidor, pule para a seção sobre Docker e caminhos de host abaixo; a página "Armazenamento" não é um seletor genérico de caminho de sistema de arquivos.
Passo 4: Insira as configurações específicas do provedor.
Selecione o provedor que deseja usar e preencha os detalhes de conexão necessários. Para o Amazon S3, a documentação atual do ONLYOFFICE descreve campos como Bucket e Região, além de opções como URL do Serviço, Forçar Estilo de Caminho, Usar HTTP e configurações relacionadas à criptografia. O Google Cloud Storage usa um nome de bucket; Rackspace e Selectel usam seus próprios campos de contêiner e região.
Ilustração da configuração de armazenamento do Amazon S3 mostrando o bucket, a região, a URL do serviço (opcional), o estilo do caminho, o HTTP e as configurações de criptografia antes da conexão.
No exemplo do Northstar Studio, o administrador inseriria um bucket S3 dedicado e a região AWS correta. Ele deixaria o URL do serviço inalterado, a menos que precisasse intencionalmente de um endpoint diferente. As credenciais e permissões devem ser limitadas ao necessário para o Workspace, e o acesso à rede do servidor para o serviço de armazenamento deve ser verificado antes de iniciar a migração.
Verificações práticas antes de clicar em Conectar
Confirme se o bucket ou contêiner existe na região esperada.
Confirme se as credenciais de integração são válidas e autorizadas para as operações de objeto necessárias.
Confirme se o servidor do Workspace consegue alcançar o endpoint do provedor.
Mantenha o backup mais recente disponível fora da pasta onde os dados estão sendo migrados.
Agende a alteração para um período em que você possa monitorar o portal e o serviço de armazenamento em busca de erros ou uso inesperado da capacidade.
Etapa 5: Conecte o armazenamento e deixe a migração terminar.
Clique em Conectar . De acordo com o guia oficial da ONLYOFFICE, a página será recarregada e o processo de migração de dados será iniciado. Não presuma que a alteração esteja concluída apenas porque o provedor foi aceito. Aguarde até que a página de Armazenamento retorne com o novo armazenamento selecionado e, em seguida, verifique o uso normal do portal.
Ilustração de armazenamento mostrando o Amazon S3 selecionado após a configuração, com o bucket e a região escolhidos resumidos.
Para o Northstar Studio, uma validação sensata incluiria abrir vários documentos existentes, carregar um novo arquivo, visualizar imagens ou outros conteúdos estáticos e verificar o bucket S3 em busca de novos objetos. O layout exato do objeto é um detalhe de implementação; o importante é que o conteúdo do portal funcione normalmente e que o novo backend esteja sendo utilizado. Se o portal reportar erros, investigue as credenciais, a política do bucket, a região, a acessibilidade do endpoint e os logs do servidor antes de fazer alterações adicionais.
E se você quiser um disco local ou ponto de montagem diferente?
É aqui que muitos tutoriais sobre "local de armazenamento padrão" se tornam enganosos. A opção "Disco Padrão" do Painel de Controle não permite selecionar um diretório arbitrário no host. Para implantações do Workspace baseadas em Docker, a própria documentação de migração da ONLYOFFICE afirma que os dados do portal são armazenados /app/onlyofficeno host. A documentação de instalação manual do Docker também cria diretórios de componentes abaixo dessa árvore, como CommunityServer, DocumentServer, MailServer, ControlPanel e diretórios relacionados ao banco de dados.
Se precisar mover esses diretórios do lado do host para um disco maior, trate isso como uma migração de implantação, e não como uma configuração do Painel de Controle. Faça backup da instalação, pare os contêineres relevantes, copie os dados preservando a propriedade e as permissões, atualize os bind mounts ou as definições de volume do Docker Compose usadas pela sua implantação específica e só então reinicie o sistema. O arquivo Compose exato e o mapeamento de volumes dependem de como o Workspace foi instalado; portanto, copiar um comando genérico de outra implantação pode quebrar o portal.
Qual a diferença entre alterar o armazenamento do portal e alterar o armazenamento de backup?
São opções distintas. A página Armazenamento determina onde os dados estáticos do portal são armazenados. A página Backup determina onde os arquivos de backup são gravados. Você pode, por exemplo, manter os dados do portal no Disco Padrão enquanto grava os backups em outro local, ou mover os dados estáticos do portal para o S3 enquanto mantém os backups em outro local. Para garantir a resiliência, manter os backups logicamente separados do backend de armazenamento primário geralmente facilita o processo de recuperação.
Qual opção se adequa melhor à sua situação?
Meta
Usar
Limitação principal
Mover dados estáticos do portal do disco local para armazenamento em nuvem/objetos compatível.
Painel de Controle → Configurações Comuns → Armazenamento
Somente os provedores documentados estão disponíveis nesta interface.
Mantenha os dados no disco do servidor local.
Disco padrão
Não há documentação sobre como selecionar caminhos locais arbitrários no Painel de Controle.
Mova os dados do Docker auto-hospedado para outro disco ou ponto de montagem do host.
Alteração de volume/montagem vinculada no nível de implantação
Os caminhos exatos dependem do método de instalação; faça um backup primeiro.
Alterar o local onde os arquivos de backup são salvos.
Painel de Controle → Backup
Isso não altera o backend de armazenamento principal do portal.
Lista de verificação final
O provedor desejado é selecionado na página de Armazenamento.
A migração terminou, e não apenas começou.
Os arquivos existentes abrem e são baixados normalmente.
Novos uploads funcionam.
Os usuários ainda podem acessar o portal sem erros relacionados ao armazenamento.
O novo bucket ou contêiner mostra atividade consistente com o uso do portal.
Um backup recente permanece disponível e não foi armazenado acidentalmente apenas no conjunto de dados que você acabou de mover.
No exemplo do Northstar Studio, a alteração de armazenamento só é considerada bem-sucedida quando o portal se comporta normalmente após a migração e o administrador confirma que o backend S3 selecionado está ativo. Essa definição prática é mais útil do que considerar o próprio botão "Conectar" como prova de que a tarefa foi concluída.