Todos os produtos
Search
Central de documentação

Object Storage Service:Como montar um bucket em uma instância ECS como usuário não root usando ossfs

Última atualização: Jul 03, 2026

Monte um bucket do OSS em uma instância ECS como usuário não root para permitir que serviços sem privilégios leiam e gravem objetos do OSS pelo sistema de arquivos local.

Visão geral

Este tópico descreve como montar um bucket em uma instância ECS com o usuário www via ossfs e como desmontá-lo depois.

Procedimento

Os passos abaixo usam o usuário www como exemplo. Caso www não exista no sistema, crie-o antes com o comando useradd.

  1. Instale o ossfs e crie o arquivo de credenciais /etc/passwd-ossfs. Para mais detalhes, consulte Instalação rápida.

  2. Restrinja as permissões do arquivo de credenciais com o comando:

    chmod 640 /etc/passwd-ossfs
  3. Obtenha o caminho de instalação do ossfs executando:

    which ossfs
  4. Consulte o UID e o GID do usuário www com o comando:

    Nota

    Este exemplo usa o usuário www. Se www não existir, crie-o com o comando useradd.

    id www
  5. Altere o proprietário do arquivo de credenciais para o usuário www. Este comando exige permissões de root.

    chown www:root /etc/passwd-ossfs
  6. Mude para o usuário www e crie o diretório do ponto de montagem.

    Nota

    Neste exemplo, test1 é o diretório do ponto de montagem.

    su - www
    mkdir test1
  7. Como usuário www, monte o bucket com o comando:

    /usr/local/bin/ossfs $Bucket test1 -ourl=$URL -ouid=$(id -u www) -ogid=$(id -g www) -o passwd_file=/etc/passwd-ossfs
    Nota

    Substitua os espaços reservados pelos valores reais:

    • $Bucket — nome do bucket do OSS.

    • $URL — endpoint do bucket, por exemplo, oss-cn-hangzhou.aliyuncs.com.

    • $(id -u www) e $(id -g www) — substituições de shell que resolvem o UID e o GID do usuário www em tempo de execução.

  8. Verifique a montagem com o comando:

    ls -l test1
  9. Para desmontar o bucket, utilize um dos comandos abaixo:

    • Como root:

      umount /home/www/test1
    • Como usuário www (ou qualquer usuário não root):

      fusermount -u /home/www/test1

      Se o ponto de montagem estiver ocupado, adicione a flag -z: fusermount -uz /home/www/test1.

Referências

  • Para uma visão geral do ossfs, consulte Visão geral.

  • Para perguntas frequentes sobre o ossfs, consulte FAQ.