Todos os produtos
Search
Central de documentação

Object Storage Service:Mount an OSS bucket with cloud Storage Gateway

Última atualização: Sep 22, 2026

O cloud Storage Gateway (CSG) monta um bucket do OSS como um sistema de arquivos compartilhado e permite que vários usuários acessem os dados de diferentes locais e dispositivos. Após a montagem, gerencie os objetos do OSS como arquivos e pastas locais.

Pré-requisitos

Observações de uso

  • Não grave objetos Archive, Cold Archive ou Deep Cold Archive diretamente em um bucket montado no CSG.

    O CSG chama a operação CopyObject e atualize os metadados do objeto (como a hora da última modificação) a cada gravação. Para objetos da camada Archive, o CopyObject aciona uma restauração. Isso degrada o desempenho do upload e pode causar falhas. Grave os arquivos como Standard ou IA primeiro. Em seguida, faça a transição deles com regras de ciclo de vida. Lifecycle rules based on last modified time.

  • O uso do CSG gera cobranças pela edição do gateway, pelo tipo de cache, pela largura de banda pública e pelo uso do OSS (armazenamento e solicitações). cloud Storage Gateway billing.

Etapa 1: configure um gateway de arquivos

  1. Acesse o console do OSS.

  2. No painel de navegação à esquerda, clique em Buckets. Na página exibida, clique no nome do bucket de destino.

  3. No painel de navegação à esquerda, escolha Object Management > Attach OSS Bucket to ECS e clique em Configure Gateway.

  4. No painel Basic Information, configure os seguintes parâmetros e clique em Next.

    Parâmetro

    Descrição

    Edition

    Selecione uma edição com base na capacidade do bucket e nos requisitos de largura de banda. File gateways.

    VPC

    Selecione a VPC que hospeda a instância do ecs.

    vSwitch

    Selecione o vSwitch na VPC que hospeda a instância do ecs.

  5. No painel Config Protocol, configure os seguintes parâmetros e clique em Next.

    Parâmetro

    Descrição

    Name

    insira um nome para o gateway de arquivos.

    Máximo de 60 caracteres. Deve começar com uma letra ou caractere chinês. Caracteres permitidos: letras, caracteres chineses, dígitos, sublinhados (_), hifens (-) e pontos (.).

    Subdirectory

    Para montar um subdiretório do bucket, selecione a opção Subdirectory ao lado de Bucket Name e insira o nome do subdiretório.

    Protocol

    Selecione o protocolo do gateway de arquivos.

    • NFS: Para clientes Linux.

    • SMB: Para clientes Windows.

    Share name

    defina o nome do compartilhamento de rede para o bucket montado.

    Máximo de 32 caracteres. Deve começar com uma letra. Caracteres permitidos: letras, dígitos, ._-.

    User mapping

    Especifique a identidade do usuário para o acesso do cliente NFS. Disponível apenas quando o Protocol Type estiver definido como NFS.

    • none: Os clientes NFS mantêm suas identidades originais.

    • root_squash: Mapeia o usuário root para nobody no servidor.

    • all_squash: Mapeia todos os usuários para nobody no servidor.

    • all_anonymous: Mapeia todos os usuários para anonymous no servidor.

    Nota

    Por padrão, o CSG concede a todos os usuários permissões de leitura, gravação e execução nos arquivos montados. configure o user mapping da seguinte forma:

    • Para gerenciar as permissões, defina o user mapping como none e use o usuário root para configurar o acesso. Set file access permissions.

    • Se não for necessário gerenciar as permissões, selecione qualquer outra opção de mapeamento.

    Reverse sync

    Sincroniza os metadados do bucket do OSS com o cache do gateway para mantê-los consistentes.

    defina o Reverse Sync Interval. Valores válidos: 15 a 36.000 segundos. Recomendado: maior que 3.600 segundos.

    Importante

    Aviso: o Reverse Sync verifica todos os objetos no bucket e pode gerar taxas de solicitação de API. Request fees.

    Cache disk type

    Ultra Disk, Standard SSD e ESSD. A disponibilidade varia conforme a região. Selecione um tipo com base nos requisitos da sua empresa.

    Cache Capacity

    Capacidade de cache de dados. Unidade: GB. Valores válidos: 100 a 32.768.

    O CSG armazena dados de acesso frequente em cache na instância do ecs para melhorar o desempenho de acesso e reduzir a latência.

  6. No painel Billing Information, leia e selecione Cloud Storage Gateway Service Agreement e clique em Finish.

    Nota

    O gateway usa o modelo de pagamento conforme o uso por padrão. Mude para assinatura para reduzir custos. Convert a pay-as-you-go gateway to a subscription gateway.

Etapa 2: Monte e acesse o bucket

Após criar o gateway de arquivos, monte o bucket na sua instância do ecs. Estas etapas abordam o NFS. Para SMB, use Access an SMB share.

  1. Na página de detalhes do bucket, escolha Object Management > Attach OSS Bucket to ECS no painel de navegação à esquerda.

  2. Na lista de gateways de arquivos, encontre o Server Mount Target do seu gateway.

  3. Acesse sua instância do ecs Linux na região do bucket. Connect to an instance by using VNC.

  4. execute o comando de montagem NFS para montar o bucket de destino.

    Por exemplo, se o destino de montagem for 172.16.0.2:/test e o diretório local for /mnt/nfs/:

    mount.nfs 172.16.0.2:/test /mnt/nfs/
  5. Acesse o bucket de destino.

    Comandos de exemplo para acessar o bucket pelo ponto de montagem:

    • Liste os arquivos no diretório raiz do bucket.

      ls /mnt/nfs/
    • Copie o arquivo example.txt do diretório raiz do bucket para o seu sistema local.

      cp /mnt/nfs/example.txt example.txt

(Opcional) Etapa 3: defina permissões de acesso a arquivos

  1. Acesse o cliente NFS como o usuário root.

  2. defina as permissões de acesso aos arquivos.

    O exemplo a seguir concede ao grupo nfsnobody (UID/GID: 429496****) acesso somente leitura ao arquivo example.txt:

    1. Altere o grupo proprietário do arquivo example.txt para nfsnobody.

      chgrp -R 429496**** example.txt
    2. Conceda ao grupo nfsnobody permissão de somente leitura no arquivo example.txt.

      chmod 444 example.txt
    Nota

    Depois de configurar as permissões, altere o user mapping para root_squash, all_squash ou all_anonymous para restringir o acesso do usuário root.

  3. Opcional: modifique a configuração de user mapping.

    1. Acesse o console do CSG.

    2. No painel de navegação à esquerda, clique em Gateways. Em seguida, clique no nome do gateway de destino.

    3. clique em Share e, na página Shares, clique em Settings na coluna Actions.

    4. Na caixa de diálogo NFS Share Settings, modifique a configuração de user mapping conforme necessário.

    5. clique em OK.

Perguntas frequentes

CSG vs. ossfs

O CSG oferece melhor desempenho que o ossfs. O ossfs é adequado apenas para o gerenciamento de arquivos pequenos e não oferece suporte a alta concorrência nem ao upload e download de arquivos grandes.

Excluir um bucket libera o gateway?

Não. Se não precisar mais do gateway de arquivos, exclua-o manualmente no console do CSG para evitar cobranças contínuas.