Todos os produtos
Search
Central de documentação

Cloud Storage Gateway:Use a file gateway on the on-premises console

Última atualização: Sep 08, 2026

Este tópico descreve como utilizar um file gateway no console local.

Pré-requisitos

  1. Uma conta Alibaba Cloud foi criada e a verificação de nome real da conta está concluída. Para mais informações, consulte Criar uma conta Alibaba Cloud.

    Nota

    Create a RAM user e faça logon no console CSG como usuário RAM.

  2. O service Cloud Storage Gateway está ativado. Ao fazer logon no console do Cloud Storage Gateway pela primeira vez, siga as instruções na tela para ativar o service.

  3. Você possui deployed the on-premises console for your file gateway.

  4. Um OSS Bucket foi criado.

    Importante
    • Um file gateway suporta apenas Buckets OSS das classes de armazenamento Standard, Infrequent Access (IA) e Archive. Buckets OSS com back-to-source feature habilitado não são suportados.

    • Evite conectar um gateway diretamente a um Bucket OSS Archive. Se os arquivos não forem modificados por um longo período após a gravação, considere usar um bucket Standard ou IA. Em seguida, utilize regras de ciclo de vida para fazer a transição da classe de armazenamento dos objetos para Archive ou Cold Archive. Essa abordagem é mais econômica e eficiente, pois evita operações de restauração desnecessárias.

    • Quando um cliente grava um arquivo no gateway, este registra pelo menos duas ações: a gravação do arquivo e a definição do horário de modificação. O gateway tenta mesclar essas ações, mas ainda pode iniciar múltiplas operações no Bucket OSS para um único arquivo. Definir o horário de modificação equivale a alterar os metadados do objeto no Bucket OSS usando a API CopyObject. Para objetos Archive ou Cold Archive, isso exige uma operação de restauração demorada, que pode retardar uploads e até causar falhas de gravação se o disco de cache não tiver espaço suficiente para enviar os dados a tempo.

  5. Você possui added a disk.

Adicionar um disco de cache

Cada pasta compartilhada requer um disco de cache exclusivo. Esse disco é utilizado para enviar dados de uma pasta compartilhada para o Alibaba Cloud OSS e para sincronizar dados do OSS com seu ambiente local.

  1. Em um navegador web, insira https://<IP address of your file gateway> para acessar o console local do file gateway.

  2. Insira seu nome de usuário e senha e clique em OK.

  3. Na página Cache Settings, clique em Create.

  4. Na caixa de diálogo Create Cache, configure os seguintes parâmetros.

    • Hard disk: Clique em Select e escolha um disco disponível.

      Os discos ficam disponíveis aqui somente após você add a disk na plataforma de implantação.

    • File system: Este é um recurso opcional. Para recuperar dados de um disco de cache ao recriar um compartilhamento, selecione esta opção para habilitar a reutilização de dados. Isso permite recuperar dados recriando o compartilhamento caso ele tenha sido excluído acidentalmente.

      Nota

      Se não existir um sistema de arquivos no disco de cache (ou seja, se o disco estiver vazio ou não inicializado), selecionar esta opção causará falha na criação do cache.

  5. Clique em OK para adicionar o disco de cache.

Vincular um recurso de cloud

Crie recursos compartilhados que utilizem buckets OSS como armazenamento de backend. Um file gateway suporta múltiplos recursos de cloud, sendo que cada recurso compartilhado corresponde a um bucket.

Nota

Por padrão, os dados gravados no Cloud Storage Gateway por um cliente são enviados para o bucket OSS em tempo real. Também é possível configurar um atraso de sincronização de até 120 segundos ao criar um compartilhamento.

Dependendo dos seus requisitos de negócios, vincule um recurso de cloud usando o método padrão ou o método personalizado.

Método padrão

  1. No console local do file gateway, acesse a página Cloud Resource Settings e clique em Bind.

  2. Na caixa de diálogo Bind Cloud Resource, configure os seguintes parâmetros.

    Parâmetro

    Descrição

    Resource name

    Insira um nome para o recurso de cloud.

    cross-region binding

    Configure o vínculo entre regiões.

    • Yes: Permite que o file gateway acesse um bucket OSS em uma região diferente.

    • No: Permite que o file gateway acesse apenas um bucket na mesma região.

    Nota

    Para garantir sincronização precisa de dados, logging e gerenciamento de operações, os fusos horários do file gateway e do bucket OSS devem ser idênticos.

    region

    Selecione a região onde o bucket está localizado.

    Bucket name

    Selecione o bucket que deseja vincular.

    Use SSL

    Se você selecionar Yes, o gateway usará SSL para acessar o bucket OSS.

  3. Clique em OK para vincular o recurso de cloud.

Método personalizado

  1. No console local do file gateway, acesse a página Cloud Resource Settings e clique em Bind.

  2. Na caixa de diálogo Bind Cloud Resource, configure os seguintes parâmetros.

    Parâmetro

    Descrição

    Resource name

    Insira um nome para o recurso de cloud.

    Use custom region

    Selecione Use Custom Region.

    endpoint

    O endpoint do bucket OSS. Exemplo: oss-cn-hangzhou.aliyuncs.com

    Bucket name

    Insira o nome do bucket OSS que deseja vincular.

    AccessKey ID

    Insira seu Access Key ID.

    AccessKey Secret

    Insira seu Access Key Secret.

    Use SSL

    Se você selecionar Yes, o gateway usará SSL para acessar o bucket OSS.

  3. Clique em OK para vincular o recurso de cloud.

Criar um compartilhamento

Os file gateways locais suportam compartilhamentos NFS e SMB shares. Escolha um tipo de compartilhamento conforme suas necessidades. Este tópico usa um compartilhamento NFS como exemplo.

  1. Install an NFS client.

  2. Retorne ao console local do file gateway. Na página NFS, clique em Create.

  3. Na caixa de diálogo Create NFS Share, configure os seguintes parâmetros e clique em OK.

    Parâmetro

    Descrição

    Share name

    O caminho virtual para o protocolo NFS.

    Para NFSv4, monte o compartilhamento diretamente usando este nome. Para NFSv3, execute o comando showmount -e <gateway IP address> para obter o caminho virtual.

    Read/write client IPs

    Endereços IP ou blocos CIDR dos clientes com acesso de leitura/gravação concedido ao compartilhamento NFS.

    Exemplo: 192.168.10.10 ou 192.168.0.0/24. É possível inserir vários endereços IP ou blocos CIDR.

    Endereços IP ou blocos CIDR dos clientes com acesso somente leitura concedido ao compartilhamento NFS.

    Exemplo: 192.168.10.10 ou 192.168.0.0/24. É possível inserir vários endereços IP ou blocos CIDR.

    Read-only client IPs

    User mapping

    Define o mapeamento entre usuários no cliente NFS e usuários no servidor NFS.

    Nota

    Este parâmetro só é configurável quando o Protocol estiver definido como NFS.

    • none: Um usuário do cliente NFS não é mapeado para o usuário nobody no servidor NFS.

    • root_squash: Restringe o usuário root. Quando um cliente NFS acessa o compartilhamento como root, o cliente é mapeado para o usuário nobody no servidor NFS.

    • all_squash: Mapeia todos os usuários de um cliente NFS para o usuário nobody no servidor NFS.

    • all_anonymous: Mapeia todos os usuários de um cliente NFS para o usuário anônimo do servidor NFS.

    Enable

    Habilita o compartilhamento NFS.

    Para desabilitar o compartilhamento NFS, selecione No.

    Mode

    Inclui modo de cache e modo de replicação.

    • Replication mode: Todos os dados são salvos em duas cópias: uma no cache offline e outra no OSS.

    • Cache mode: Armazena em cache localmente todos os metadados e dados de usuário acessados frequentemente. O OSS retém o conjunto completo de dados.

    Reverse Sync

    Sincroniza metadados do OSS de volta para um ambiente local. Aplica-se a cenários de recuperação de desastres do gateway, recuperação de dados e compartilhamento de dados.

    Nota

    Uma operação de sincronização reversa verifica todos os objetos em um bucket. Esse processo gera taxas de solicitação de API OSS se o bucket contiver um grande número de objetos.

    Bucket Name

    Selecione o Bucket criado.

    Path prefix

    Insira o prefixo de caminho no bucket.

    Prefixos de caminho aceitam apenas letras inglesas e números.

    Nota

    A partir da versão 1.0.38, é possível montar o diretório raiz de um sistema de arquivos em um prefixo de caminho específico em um bucket OSS para facilitar o isolamento de acesso.

    O prefixo de caminho pode ser um diretório existente ou um novo diretório no bucket OSS. Após a criação do compartilhamento, esse prefixo servirá como diretório raiz, e todos os arquivos e diretórios subsequentes serão criados sob ele.

    Using a metadata disk

    O uso de um disco de metadados separa o disco de dados do disco de metadados. O disco de metadados armazena metadados das pastas compartilhadas.

    • Se você selecionar Yes, deverá escolher o disco de metadados e o disco de dados correspondentes.

    • Se você selecionar No, deverá escolher o disco de cache correspondente.

    Nota

    Apenas usuários incluídos na lista de permissões podem usar este recurso.

    Ignore Deletion

    Exclusões de arquivos não são sincronizadas com o OSS para evitar operações acidentais. O OSS retém o conjunto completo de dados.

    NFS v4 optimization

    Melhora a eficiência de upload para montagens NFSv4. Após ativar esta opção, não será mais possível montar usando NFSv3.

    Synchronization Delay

    Defina o Sync Delay. Esta configuração atrasa o upload de arquivos por um período após o fechamento dos mesmos, evitando que modificações offline frequentes gerem fragmentos no OSS. O valor padrão é 5 s e o máximo é 120 s.

    Maximum Write Speed

    A velocidade máxima de gravação é 1280 MB/s. O valor padrão é 0, indicando que a velocidade é ilimitada.

    Maximum Upload Speed

    A velocidade máxima de upload é 1280 MB/s. O valor padrão é 0, indicando ausência de limite de velocidade.

    Nota

    Quando houver limitação de velocidade, a velocidade máxima de upload não pode ser inferior à velocidade máxima de gravação.

    Fast Cache Reclaim

    A recuperação de cache em tempo real é adequada para cenários de cloud focados apenas em backup.

  4. Clique em Confirm para criar o compartilhamento.

Acessar o compartilhamento

Após a criação do compartilhamento, utilize um cliente NFS para access the NFS shared folder.