Todos os produtos
Search
Central de documentação

Cloud Storage Gateway:Gerencie um gateway de arquivos no console do CSG

Última atualização: Sep 21, 2026

Crie um gateway de arquivos na nuvem e configure compartilhamentos de arquivos no console do Cloud Storage Gateway (CSG) para acessar buckets do OSS por meio dos protocolos padrão NFS ou SMB.

Pré-requisitos

  1. Crie uma conta da Alibaba Cloud e conclua a verificação de nome real da conta. Para obter mais informações, consulte Criar uma conta da Alibaba Cloud.

    Nota

    Crie um usuário RAM e faça login no console do CSG como o usuário RAM.

  2. O CSG deve estar ativado. Se não estiver, siga as instruções na tela no console do CSG para ativá-lo.

  3. É necessário ter uma virtual private cloud (VPC) disponível na região em que você deseja criar o gateway de arquivos. Para obter mais informações, consulte VPCs and vSwitches.

  4. Crie uma instância do ECS na VPC da região em que você deseja criar o gateway de arquivos.

    Nota

    Se o seu host local estiver conectado à VPC por meio de um circuito do Express Connect, você também poderá usar esse host para executar as etapas.

  5. Crie um bucket do OSS. Para obter mais informações, consulte Console quick start.

    Importante
    • Os gateways de arquivos suportam buckets do OSS Standard, Infrequent Access (IA) e Archive. O sistema não suporta buckets com mirroring-based back-to-origin.

    • Não associe um gateway a um bucket do tipo Archive. Em vez disso, armazene arquivos em um bucket Standard ou IA e configure uma regra de ciclo de vida para fazer a transição deles para Archive ou Cold Archive. Isso evita operações de restauração desnecessárias.

    • Quando um cliente grava um arquivo, o gateway chama a operação CopyObject para armazenar a hora de modificação do arquivo como metadados do objeto. Para objetos Archive ou Cold Archive, a operação CopyObject aciona a restauração, o que retarda os uploads e pode causar falhas no upload.

Crie um gateway de arquivos

  1. Na página Gateways do console do CSG, clique em Create.

  2. No assistente Crie Gateway, configure os parâmetros conforme descrito na tabela a seguir e mantenha as configurações padrão para os demais parâmetros.

    Example

    Etapa

    Parâmetro

    Descrição

    Gateway Information

    Name

    Especifique um nome para o gateway. O nome deve ter entre 1 e 60 caracteres e pode conter letras, dígitos, sublinhados (_), hifens (-) e pontos (.). Deve começar com uma letra.

    Location

    Selecione Alibaba Cloud.

    Type

    Selecione File Gateway.

    Region

    Selecione a região do gateway de arquivos.

    Gateway Configurations

    VPC

    Selecione a VPC na qual você deseja implantar o gateway.

    Nota

    A VPC deve conter a sua instância do ECS ou o seu host local.

    VSwitch

    Selecione o vSwitch conectado ao gateway.

    Nota
    • O vSwitch deve ser aquele conectado à sua instância do ECS ou ao seu host local.

    • Se não houver nenhum recurso de gateway disponível na zona onde o vSwitch especificado reside, crie um vSwitch em outra zona.

    Edition

    Selecione Basic, Standard, Enhanced ou Performance Optimized. Para obter mais informações, consulte Specifications.

    Config Protocol

    Cross-region Binding

    • Yes: permite o acesso a buckets em regiões diferentes.

    • No: restringe o acesso a buckets na mesma região do gateway.

    OSS Endpoint

    Selecione um endpoint para a região onde o bucket está localizado.

    Bucket Name

    Especifique o bucket. Selecione um bucket existente na lista suspensa ou marque a caixa de seleção Subdirectory e insira um subdiretório do bucket na caixa de texto exibida.

    • O nome de um subdiretório pode conter apenas letras e dígitos.

    • A partir da versão V1.0.38, o diretório raiz do sistema de arquivos pode ser mapeado para um subdiretório do bucket do OSS, o que permite o isolamento de acesso.

    • O subdiretório pode ser um diretório existente no bucket do OSS ou um diretório ainda não criado no bucket do OSS. Após criar um compartilhamento, o subdiretório especificado serve como diretório raiz e armazena todos os arquivos e diretórios relacionados.

    • Um gateway de arquivos não suporta buckets do OSS com roteamento back-to-origin configurado.

    • O CSG não pode garantir que apenas uma operação de gravação seja executada em um objeto. Portanto, o sistema não suporta buckets com políticas de retenção configuradas.

    Public Network Bandwidth

    Especifique a largura de banda pública. Este parâmetro está disponível apenas quando Cross-region Binding está definido como Yes. A largura de banda padrão é de 5 Mbit/s. Aumente a largura de banda para obter um melhor desempenho na transferência de dados.

    Nota
    • Para usar o gateway ou o recurso de sincronização expressa entre regiões, configure este parâmetro. Para obter mais informações, consulte Configure a public bandwidth limit.

    • A largura de banda pública varia de 5 Mbit/s a 200 Mbit/s.

    Protocol

    Especifique o protocolo que você usa para se conectar ao bucket do OSS. Selecione NFS ou SMB.

    • Use o protocolo NFS se precisar acessar o bucket a partir de um sistema Linux.

    • Use o protocolo SMB se precisar acessar o bucket a partir de um sistema Windows.

    Share Name

    Especifique um nome para o compartilhamento. Se você definir o parâmetro Protocol como NFS, o nome do compartilhamento também será usado como o caminho virtual do compartilhamento ao montar o compartilhamento com base no NFSv4.

    Nota

    O nome deve ter entre 1 e 32 caracteres e pode conter letras, dígitos, sublinhados (_), hifens (-) e pontos (.). Deve começar com uma letra.

    User Mapping

    Defina o mapeamento de usuários entre o cliente NFS e o servidor NFS. Este parâmetro está disponível apenas quando você define Protocol como NFS. Valores válidos:

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

    • root_squash: o cliente NFS com identidade root é mapeado para o usuário nobody no servidor NFS.

    • all_squash: o cliente NFS é mapeado para o usuário nobody no servidor NFS, independentemente da identidade do cliente.

    • all_anonymous: o cliente NFS é mapeado para o usuário anônimo no servidor NFS, independentemente da identidade do cliente.

    Reverse Sync

    Selecione se deseja sincronizar os metadados dos objetos no bucket com o seu dispositivo local. O recurso de sincronização reversa é útil em cenários como recuperação de desastres, recuperação de dados e compartilhamento de dados.

    Nota

    Durante um processo de sincronização reversa, o sistema verifica todos os objetos no bucket. Se o bucket contiver um grande número de objetos, haverá cobrança pelas chamadas à API do OSS. Para obter mais informações, consulte Pricing.

    Reverse Sync Interval

    Se você definir Reverse Sync como Yes, deverá definir o parâmetro Reverse Sync Interval. Valores válidos: 15 a 36000. Unidade: segundos.

    Nota

    Se o bucket contiver um grande número de objetos, defina um intervalo maior que 3.600 segundos. Caso contrário, as verificações repetidas resultarão em chamadas frequentes à API do OSS. Isso aumenta as taxas geradas pelas chamadas à API do OSS.

    Cache Disk Type

    Selecione Ultra Disk, Standard SSD ou ESSD com base nas necessidades do seu negócio.

    Cache Capacity

    • A capacidade de um disco de cache para um gateway Basic varia de 40 GB a 4.096 GB.

    • A capacidade de um disco de cache para um gateway Standard varia de 40 GB a 8.192 GB.

    • A capacidade de um disco de cache para um gateway Enhanced ou Performance Optimized varia de 40 GB a 32.768 GB.

    Billing Information

    Billing Method

    Selecione Pay-as-you-go ou Subscription. Para obter mais informações, consulte Billing.

    Se você selecionar Subscription, o sistema redirecionará você para a página de compra da assinatura após criar o gateway de arquivos. Conclua o pagamento.

    Expiration Policy

    Política de expiração para a assinatura do gateway. Selecione Switch to Pay-as-you-go ou Release.

  3. Na etapa Confirmation, verifique as informações de configuração. Se estiver tudo correto, clique em Completed.

Anexar um disco de cache

  1. Na página Gateways, clique no ID do gateway. Na página exibida, clique em Caches > Create Cache.

  2. Defina as especificações do disco de cache usando as configurações de Cache Calculator ou Custom Cache.

    1. Cache Calculator: o sistema recomenda automaticamente as configurações do disco de cache com base nos requisitos da sua aplicação.

    2. Custom Cache: configure manualmente o tipo e a capacidade do disco de cache.

      Nota
      • Capacidade

        O intervalo de capacidade suportado para um disco de cache varia de acordo com a edição do gateway:

        • Basic: 40 GB a 4.096 GB

        • Standard: 40 GB a 8.192 GB

        • Enhanced ou Performance Optimized: 40 GB a 32.768 GB

      • Tipo

        Selecione Ultra Disk, Standard SSD ou ESSD. Selecione ESSD.

      Se você anexar um disco de cache a um gateway por assinatura, o sistema redirecionará você para a página de compra do disco de cache.

Crie um compartilhamento

  1. Na página Gateways, clique no ID do gateway de arquivos. Na página exibida, clique em Shares > Create.

  2. Na etapa Bucket Settings, configure os parâmetros descritos na tabela a seguir.

    Bucket Settings

    Parâmetro

    Descrição

    Cross-region Binding

    • Yes: permite o acesso a buckets em regiões diferentes.

    • No: restringe o acesso a buckets na mesma região do gateway.

    OSS Endpoint

    Selecione um endpoint para a região onde o bucket está localizado.

    Bucket Name

    Especifique o bucket. Selecione um bucket existente na lista suspensa ou marque a caixa de seleção Subdirectory e insira um subdiretório do bucket na caixa de texto exibida.

    Nota
    • O nome de um subdiretório pode conter apenas letras e dígitos.

    • A partir da versão V1.0.38, o diretório raiz do sistema de arquivos pode ser mapeado para um subdiretório do bucket do OSS, o que permite o isolamento de acesso.

    • Especifique um subdiretório existente ou um subdiretório inexistente no bucket. Após criar um compartilhamento, o subdiretório especificado serve como diretório raiz e armazena todos os arquivos e diretórios relacionados.

    • Um gateway de arquivos não suporta buckets do OSS com roteamento back-to-origin configurado.

    • O CSG não pode garantir que apenas uma operação de gravação seja executada em um objeto. Portanto, o sistema não suporta buckets com políticas de retenção configuradas.

    Use SSL to Connect Bucket

    Especifique as configurações de criptografia. Selecione None ou Server-side Encryption.

    Se você selecionar Server-side Encryption, deverá especificar um Key ID e um Encryption Algorithm. Crie uma chave mestra do cliente (CMK) no console do Key Management Service (KMS). Para obter mais informações, consulte Crie uma CMK. Os algoritmos de criptografia suportados são AES256 e SM4.

    Se você ativar o recurso de criptografia no lado do servidor, o sistema suporta bring your own key (BYOK). O sistema também suporta chaves importadas do KMS. Após ativar o recurso de criptografia no lado do servidor, o sistema criptografa os arquivos carregados no OSS a partir do compartilhamento usando a chave especificada. Chame a operação GetObject para verificar se o objeto especificado está criptografado. Se o valor do campo x-oss-server-side-encryption for KMS e o valor do campo x-oss-server-side-encryption-key-id for o ID da chave no cabeçalho de resposta, o objeto estará criptografado.

    Importante
    • Apenas usuários na lista de permissões podem usar este recurso.

    • Ao criar uma CMK no console do KMS, você deve selecionar a região onde o bucket do OSS está localizado.

    Use SSL to Connect Bucket

    Se você selecionar Yes, o bucket se conectará via SSL.

  3. Na etapa Basic Information, configure os parâmetros descritos na tabela a seguir.

    Basic Information

    Parâmetro

    Descrição

    Share Name

    Especifique um nome para o compartilhamento. Se você definir o parâmetro Protocol como NFS, o nome do compartilhamento também será usado como o caminho virtual do compartilhamento ao montar o compartilhamento com base no NFSv4.

    Nota

    O nome deve ter entre 1 e 32 caracteres e pode conter letras, dígitos, sublinhados (_), hifens (-) e pontos (.). Deve começar com uma letra.

    Protocol

    O protocolo que você usa para se conectar ao bucket do OSS. Selecione NFS ou SMB.

    • Use o protocolo NFS se precisar acessar o bucket a partir de um sistema Linux.

    • Use o protocolo SMB se precisar acessar o bucket a partir de um sistema Windows.

    Cache

    Selecione um disco de cache existente.

    Nota

    O espaço do disco de cache é distribuído com base nas seguintes regras:

    • Para um disco de cache com capacidade de até 5 TB, 20% dessa capacidade é reservada para armazenamento de metadados. Por exemplo, se você anexar um disco de cache de 40 GB, o espaço real disponível para armazenamento de dados será de 32 GB.

    • Para um disco de cache com capacidade superior a 5 TB, 1 TB é reservado para armazenamento de metadados. Por exemplo, se você anexar um disco de cache de 20 TB, o espaço real disponível para armazenamento de dados será de 19 TB.

    User Mapping

    Especifique o mapeamento de usuários entre o cliente NFS e o servidor NFS.

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

    • root_squash: o cliente NFS com identidade root é mapeado para o usuário nobody no servidor NFS.

    • all_squash: o cliente NFS é mapeado para o usuário nobody no servidor NFS, independentemente da identidade do cliente.

    • all_anonymous: o cliente NFS é mapeado para o usuário anônimo no servidor NFS, independentemente da identidade do cliente.

    Nota

    Este parâmetro está disponível apenas quando você define Protocol como NFS.

    Browsable

    Especifique se é possível acessar o compartilhamento usando o Ambiente de Rede.

    Nota

    Este parâmetro está disponível apenas se você definir Protocol como SMB.

    Windows Permission Support

    As configurações de controle de acesso. Para obter mais informações sobre o controle de permissões, consulte Ative o suporte a permissões do Windows.

    Nota
    • Este parâmetro está disponível apenas se você definir Protocol como SMB.

    • Para ativar o suporte a permissões do Windows, adicione primeiro o gateway a um domínio AD.

    Access-based Enumeration

    Ao ativar a enumeração baseada em acesso (ABE) do Windows, os usuários visualizam apenas arquivos ou diretórios para os quais têm permissões de gerenciamento.

    Nota

    Este parâmetro está disponível apenas se você definir Windows Permission Support como Yes.

    Add to Sync Group

    Especifique se deseja adicionar o compartilhamento a um grupo de sincronização. Se você adicionar o compartilhamento a um grupo de sincronização, o sistema desativa automaticamente o recurso de sincronização reversa para o compartilhamento. Após adicionar o compartilhamento a um grupo de sincronização, o sistema sincroniza todas as alterações feitas nos dados armazenados no bucket do OSS correspondente ao compartilhamento com o cliente local no qual o compartilhamento está montado.

    Nota
    • Para ativar este recurso, crie primeiro um grupo de sincronização. Certifique-se de que o grupo de sincronização e o compartilhamento usem o mesmo bucket do OSS. Para obter mais informações, consulte Configure express synchronization.

    • Apenas os gateways Standard, Enhanced e Performance Optimized suportam o recurso de sincronização expressa.

    • O recurso de sincronização expressa depende do Simple Message Queue (anteriormente MNS) e incorre em taxas do SMQ. Para obter mais informações, consulte Configure express synchronization.

    Advanced Settings

    Depois de marcar a caixa de seleção Advanced Settings, o sistema exibe a etapa Advanced Settings.

  4. (Opcional) Na etapa Advanced Settings, configure os parâmetros descritos na tabela a seguir.

    Advanced Settings

    Parâmetro

    Descrição

    Mode

    Selecione o modo de execução do compartilhamento. Selecione Cache Mode ou Replication Mode. Por padrão, um compartilhamento executa no modo de cache.

    • Replication Mode: neste modo, o sistema cria dois backups para todos os dados. Um backup fica armazenado no disco de cache local e o outro fica armazenado no bucket do OSS associado.

    • Cache Mode: neste modo, o disco de cache local armazena apenas metadados e os dados acessados com frequência. O bucket armazena os dados completos.

    Defina Mode como Cache Mode se desejar migrar dados para a nuvem ou fazer backup dos dados.

    Transfer Acceleration

    Especifique se deseja ativar a aceleração de transferência. Este parâmetro está disponível apenas se você definir Cross-region Binding na etapa Bucket Settings como Yes. Este recurso acelera a transferência de dados entre regiões usando a largura de banda pública do gateway. Antes de usar este recurso, certifique-se de que o recurso de aceleração de transferência está ativado para o bucket do OSS associado.

    Bypass Cache Read

    Por padrão, se ocorrer uma falha de cache para uma solicitação de leitura em um compartilhamento, o gateway baixa os dados solicitados do bucket do OSS associado para o disco de cache. Esse processo envolve um certo nível de pré-busca de dados. No entanto, se as solicitações de leitura forem completamente aleatórias e o tamanho do disco de cache for muito menor que o tamanho dos dados no bucket do OSS, a pré-busca de dados para o disco de cache pode não oferecer um desempenho satisfatório. Nesse caso, considere ativar este recurso. Ative este recurso apenas quando necessário.

    Upload Optimization

    Se você selecionar Yes, o sistema limpa os dados em cache em tempo real. Este recurso é adequado para cenários de backup em nuvem.

    Reverse Sync

    Selecione se deseja sincronizar os metadados dos objetos no bucket com o seu dispositivo local. O recurso de sincronização reversa é útil em cenários como recuperação de desastres, recuperação de dados e compartilhamento de dados.

    Nota
    • Durante um processo de sincronização reversa, o sistema verifica todos os objetos no bucket. Se houver um grande número de objetos, haverá cobrança pelas chamadas à API do OSS. Para obter mais informações, consulte Pricing.

    • Se você marcar a caixa de seleção Add to Sync Group na etapa Basic Information, o parâmetro Reverse Sync fica indisponível.

    Reverse Sync Interval

    Se você definir Reverse Sync como Yes, deverá definir o parâmetro Reverse Sync Interval. Valores válidos: 15 a 36000. Unidade: segundos.

    Nota

    Se o bucket contiver um grande número de objetos, defina um intervalo maior que 3.600 segundos. Caso contrário, as verificações repetidas resultarão em chamadas frequentes à API do OSS. Isso aumenta as taxas geradas pelas chamadas à API do OSS.

    Ignore Deletions

    Se você selecionar Yes, o sistema não exclui os dados excluídos do disco de cache local do bucket do OSS. O bucket armazena os dados completos.

    NFS V4 Optimization

    Selecione se deseja otimizar a eficiência de upload caso o compartilhamento esteja montado em um sistema de arquivos NFSv4. Se você selecionar Yes, não é possível montar o compartilhamento em um sistema de arquivos NFSv3.

    Nota

    Este parâmetro está disponível apenas para um compartilhamento NFS.

    Sync Latency

    Especifique um período de tempo para atrasar o upload de arquivos. Uma latência de sincronização impede que modificações locais frequentes criem um grande número de fragmentos no OSS. Valor padrão: 5. Valor máximo: 120. Unidade: segundos.

    Replication Mode Advanced Settings

    Este parâmetro está disponível apenas se você definir Mode como Replication Mode. Depois de marcar a caixa de seleção Replication Mode Advanced Settings, o sistema exibe a etapa Replication Mode Advanced Settings.

  5. (Opcional) Na etapa Replication Mode Advanced Settings, configure os parâmetros descritos na tabela a seguir.

    Replication Mode Advanced Settings

    Parâmetro

    Descrição

    Configure Directory in Replication Mode

    Selecione os diretórios aos quais o modo de replicação se aplica.

    • Se você não configurar diretórios, o modo de replicação aplica-se a todos os dados no compartilhamento.

    • Para configurar diretórios no modo de replicação, marque a caixa de seleção, clique em Add Directory e especifique os diretórios aos quais deseja aplicar o modo de replicação. Os diretórios diferentes dos especificados usam o modo de cache.

    Nota
    • Se você alterar o modo de um diretório de cache para replicação, o sistema só sincroniza os arquivos no diretório se o recurso de download de dados também estiver ativado. Ative o recurso de download de dados se você usar o modo de replicação.

    • Para especificar um diretório, use seu caminho em relação ao ponto de montagem do compartilhamento. Por exemplo, se o diretório ao qual você deseja aplicar o modo de replicação for /mnt/myshare/mydir/ e o ponto de montagem for /mnt/myshare, insira /mydir/.

    Data Download

    Se você ativar o recurso de download de dados, a sincronização reversa ou a sincronização expressa sincroniza tanto os dados quanto os metadados. Se você não ativar o recurso de download de dados, o sistema sincroniza apenas os metadados.

    Nota
    • A replicação de dados exige que a capacidade do disco de cache seja maior que 1,1 vezes o tamanho do arquivo a ser replicado. Especifique a capacidade do cache com base no crescimento esperado do uso do bucket.

    • Na primeira vez que você ativa o recurso de download de dados, o sistema aciona uma verificação completa. Esse processo pode afetar o desempenho do gateway. Ative o recurso de download de dados fora dos horários de pico e aguarde o sistema replicar todos os dados.

    • O recurso de download de dados suporta apenas o armazenamento write-once-read-many. Se vários usuários acessarem o bucket ao mesmo tempo (incluindo, entre outros, o acesso direto ou o acesso por meio do gateway), apenas um usuário pode carregar arquivos no bucket, e os outros usuários só podem baixar dados. Pode ocorrer perda de dados se vários usuários gravarem e lerem dados do bucket ao mesmo tempo.

    Download Speed Limit

    Depois de ativar o download de dados, defina este parâmetro. Especifique um limite de velocidade dentro do intervalo de 0 MB/s a 1.280 MB/s. Se você definir este parâmetro como 0 MB/s, a velocidade de download fica ilimitada.

    Reverse Sync Interval

    Defina um intervalo de sincronização reversa. Este parâmetro está disponível apenas se você definir Data Download como Yes. O intervalo de sincronização reversa varia de 3.600 segundos a 36.000 segundos.

    Nota
    • Se o bucket contiver um grande número de objetos, defina um intervalo maior que 3.600 segundos. Caso contrário, as verificações repetidas resultarão em chamadas frequentes à API do OSS. Isso aumenta as taxas geradas pelas chamadas à API do OSS.

    • A sincronização reversa ocorre apenas quando você acessa o diretório. Para garantir que os dados em outros diretórios sejam baixados e que novos dados sejam baixados em tempo real, use express synchronization.

  6. Na etapa Confirmation, verifique as informações de configuração. Se estiver tudo correto, clique em Completed.

Acessar um compartilhamento

Após criar um compartilhamento, acesse-o a partir do cliente. Para obter mais informações, consulte Access shares.