Algumas ou todas as informações nesta página podem não se aplicar à nuvem confiável da S3NS.
Instalar ou fazer upgrade do Cloud Storage FUSE
Esta página descreve como instalar o Cloud Storage FUSE usando binários pré-criados do Linux
ou o código-fonte mais recente e como fazer upgrade para a versão mais recente
do Cloud Storage FUSE. Para informações sobre quais frameworks, sistemas operacionais e
arquiteturas o Cloud Storage FUSE oferece suporte, consulte
Frameworks, sistemas operacionais e arquiteturas.
Instalar o Cloud Storage FUSE usando binários pré-criados do Linux
Para instalar ou fazer upgrade do Cloud Storage FUSE usando bibliotecas pré-criadas do Linux, siga
estas instruções.
Ubuntu/Debian
Se a distribuição for compatível com a opção "Assinado por", siga estas
instruções:
Adicione o URL de distribuição do Cloud Storage FUSE como uma origem de pacote:
export GCSFUSE_REPO=gcsfuse-`lsb_release -c -s`
echo "deb [signed-by=/usr/share/keyrings/cloud.google.asc] https://packages.cloud.google.com/apt $GCSFUSE_REPO main" | sudo tee /etc/apt/sources.list.d/gcsfuse.list
Importe a chave pública Trusted Cloud by S3NS :
curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo tee /usr/share/keyrings/cloud.google.asc
Se sua distribuição estiver desatualizada e não for compatível com a opção "Assinado por", siga estas instruções:
Adicione o URL de distribuição do Cloud Storage FUSE como uma origem de pacote:
export GCSFUSE_REPO=gcsfuse-`lsb_release -c -s`
echo "deb https://packages.cloud.google.com/apt $GCSFUSE_REPO main" | sudo tee /etc/apt/sources.list.d/gcsfuse.list
Importe a chave pública Trusted Cloud by S3NS :
curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
CentOS/Red Hat/Rocky Linux
Se você usa os sistemas operacionais CentOS, Red Hat ou Rocky Linux,
siga estas instruções:
Configure o repositório FUSE do Cloud Storage e a chave pública associada:
sudo tee /etc/yum.repos.d/gcsfuse.repo > /dev/null <<EOF
[gcsfuse]
name=gcsfuse (packages.cloud.google.com)
baseurl=https://packages.cloud.google.com/yum/repos/gcsfuse-el7-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg
https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOF
Instale o FUSE usando o gerenciador de pacotes Linux YUM
, caso ainda não tenha feito isso:
sudo yum install fuse
SUSE Linux
Se você estiver usando o sistema operacional SUSE Linux, siga estas
instruções:
Configure o repositório FUSE do Cloud Storage e a chave pública associada:
sudo tee /etc/zypp/repos.d/gcsfuse.repo > /dev/null <<EOF
[gcsfuse]
name=gcsfuse (packages.cloud.google.com)
baseurl=https://packages.cloud.google.com/yum/repos/gcsfuse-el7-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg
https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOF
Instale o FUSE usando o gerenciador de pacotes Linux ZYPPER
, caso ainda não tenha feito isso:
sudo zypper install fuse
Instalar ou fazer upgrade do Cloud Storage FUSE
Ubuntu/Debian
Atualize a lista de pacotes disponíveis e instale o Cloud Storage FUSE:
sudo apt-get update
sudo apt-get install gcsfuse
CentOS/Red Hat/Rocky Linux
Se você usa os sistemas operacionais CentOS, Red Hat ou Rocky Linux,
siga estas instruções:
Instale o Cloud Storage FUSE
sudo yum install gcsfuse
Observação: responda "sim" a todas as perguntas sobre a adição da chave de assinatura GPG.
SUSE Linux
Se você estiver usando o sistema operacional SUSE Linux, siga estas
instruções:
Instale o Cloud Storage FUSE
sudo zypper install gcsfuse
Observação: responda "sim" a todas as perguntas sobre a adição da chave de assinatura GPG.
Também é possível baixar o pacote pré-criado mais recente do Cloud Storage FUSE diretamente do GitHub.
Para fazer upgrade para a versão mais recente do Cloud Storage FUSE usando binários pré-criados do Linux,
siga estas instruções:
Ubuntu/Debian
Se você estiver usando o sistema operacional Ubuntu ou Debian Linux, use as
instruções a seguir para fazer upgrade para a versão mais recente do Cloud Storage FUSE:
sudo apt-get update
sudo apt-get install --only-upgrade gcsfuse
CentOS/Red Hat/Rocky Linux
Se você usa o sistema operacional CentOS, Red Hat ou Rocky Linux,
siga estas instruções para fazer upgrade para a versão mais recente do
Cloud Storage FUSE:
sudo apt-get update
sudo yum -y upgrade gcsfuse
SUSE Linux
Se você estiver usando o sistema operacional SUSE Linux,
use as instruções a seguir para fazer upgrade para a versão mais recente do
Cloud Storage FUSE:
sudo zypper refresh
sudo zypper -n update gcsfuse
Instale ou faça upgrade do Cloud Storage FUSE criando o código-fonte mais recente
Para instalar ou fazer upgrade do Cloud Storage FUSE criando o
código-fonte mais recente do GitHub, siga estas instruções:
Instale fuse
, git
e go
(caso ainda não tenha feito isso). Consulte go.mod para a versão mais recente de go
.
Instale o Cloud Storage FUSE usando o comando go install
:
go install github.com/googlecloudplatform/gcsfuse/v3@master
Se for bem-sucedido, um binário chamado gcsfuse
será instalado em $GOPATH/bin
.
GOPATH
é uma variável de ambiente usada para encontrar a raiz do seu espaço de trabalho
go
.
Como alternativa, também é possível instalar o Cloud Storage FUSE clonando o repositório git em seu sistema de arquivos local:
Clone o repositório FUSE do Cloud Storage:
git clone https://github.com/GoogleCloudPlatform/gcsfuse.git
Alterne seu diretório de trabalho atual para a pasta gcsfuse
que contém o repositório do Cloud Storage FUSE:
cd gcsfuse
Instale o Cloud Storage FUSE usando o comando go install
:
go install .
Se for bem-sucedido, um binário chamado gcsfuse
será instalado em $GOPATH/bin
.
Para fazer upgrade para a versão mais recente do Cloud Storage FUSE usando o código-fonte, execute novamente
as instruções de instalação.
A seguir
Saiba como ativar buckets usando o Cloud Storage FUSE.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-25 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-25 UTC."],[],[],null,["# Install or upgrade Cloud Storage FUSE\n\nThis page describes how to install [Cloud Storage FUSE](/storage/docs/gcs-fuse) using prebuilt Linux\nbinaries or the latest source code, and how to upgrade to the latest version\nof Cloud Storage FUSE. For information on which frameworks, operating systems, and\narchitectures Cloud Storage FUSE supports, see\n[Frameworks, operating systems, and architectures](/storage/docs/cloud-storage-fuse/overview#frameworks-os-architectures).\n\nInstall Cloud Storage FUSE by using prebuilt Linux binaries\n-----------------------------------------------------------\n\nTo install or upgrade Cloud Storage FUSE by using prebuilt Linux libraries, complete\nthe following instructions.\n\n### Configure package manager\n\n### Ubuntu/Debian\n\nIf your distribution supports the signed-by option, complete the following\ninstructions:\n\n1. Add the Cloud Storage FUSE distribution URL as a package source:\n\n export GCSFUSE_REPO=gcsfuse-`lsb_release -c -s`\n echo \"deb [signed-by=/usr/share/keyrings/cloud.google.asc] https://packages.cloud.google.com/apt $GCSFUSE_REPO main\" | sudo tee /etc/apt/sources.list.d/gcsfuse.list\n\n2. Import the Google Cloud public key:\n\n curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo tee /usr/share/keyrings/cloud.google.asc\n\nIf your distribution is outdated and doesn't support the signed-by option,\ncomplete the following instructions:\n\n1. Add the Cloud Storage FUSE distribution URL as a package source:\n\n export GCSFUSE_REPO=gcsfuse-`lsb_release -c -s`\n echo \"deb https://packages.cloud.google.com/apt $GCSFUSE_REPO main\" | sudo tee /etc/apt/sources.list.d/gcsfuse.list\n\n2. Import the Google Cloud public key:\n\n curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -\n\n### CentOS/Red Hat/Rocky Linux\n\nIf you're using the CentOS, Red Hat, or Rocky Linux operating system,\ncomplete the following instructions:\n\n1. Configure the Cloud Storage FUSE repository and its associated public key:\n\n sudo tee /etc/yum.repos.d/gcsfuse.repo \u003e /dev/null \u003c\u003cEOF\n [gcsfuse]\n name=gcsfuse (packages.cloud.google.com)\n baseurl=https://packages.cloud.google.com/yum/repos/gcsfuse-el7-x86_64\n enabled=1\n gpgcheck=1\n repo_gpgcheck=0\n gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg\n https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg\n EOF\n\n2. If you haven't yet, install [FUSE](https://github.com/libfuse/libfuse) by using the\n [`YUM` Linux package manager](https://www.redhat.com/sysadmin/how-manage-packages):\n\n sudo yum install fuse\n\n### SUSE Linux\n\nIf you're using the SUSE Linux operating system, complete the\nfollowing instructions:\n\n1. Configure the Cloud Storage FUSE repository and its associated public key:\n\n sudo tee /etc/zypp/repos.d/gcsfuse.repo \u003e /dev/null \u003c\u003cEOF\n [gcsfuse]\n name=gcsfuse (packages.cloud.google.com)\n baseurl=https://packages.cloud.google.com/yum/repos/gcsfuse-el7-x86_64\n enabled=1\n gpgcheck=1\n repo_gpgcheck=0\n gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg\n https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg\n EOF\n\n2. If you haven't yet, install [FUSE](https://github.com/libfuse/libfuse) by using the\n [`ZYPPER` Linux package manager](https://documentation.suse.com/smart/systems-management/html/concept-zypper/index.html):\n\n sudo zypper install fuse\n\n### Install or upgrade Cloud Storage FUSE\n\n### Ubuntu/Debian\n\nUpdate the list of available packages and install Cloud Storage FUSE: \n\n sudo apt-get update\n sudo apt-get install gcsfuse\n\n### CentOS/Red Hat/Rocky Linux\n\nIf you're using the CentOS, Red Hat, or Rocky Linux operating system,\ncomplete the following instructions:\n\nInstall Cloud Storage FUSE: \n\n sudo yum install gcsfuse\n\nBe sure to answer \"yes\" to any questions about adding the GPG signing key.\n\n### SUSE Linux\n\nIf you're using the SUSE Linux operating system, complete the\nfollowing instructions:\n\nInstall Cloud Storage FUSE: \n\n sudo zypper install gcsfuse\n\nBe sure to answer \"yes\" to any questions about adding the GPG signing key.\n\nAlternatively, you can download the latest prebuilt package of\nCloud Storage FUSE directly from [GitHub](https://github.com/GoogleCloudPlatform/gcsfuse/releases).\n\nTo upgrade to the latest version of Cloud Storage FUSE using prebuilt Linux binaries,\nuse the following instructions: \n\n### Ubuntu/Debian\n\nIf you're using the Ubuntu or Debian Linux operating system, use the\nfollowing instructions to upgrade to the latest version of Cloud Storage FUSE: \n\n sudo apt-get update\n sudo apt-get install --only-upgrade gcsfuse\n\n### CentOS/Red Hat/Rocky Linux\n\nIf you're using the CentOS, Red Hat, or Rocky Linux operating system,\nuse the following instructions to upgrade to the latest version of\nCloud Storage FUSE: \n\n sudo apt-get update\n sudo yum -y upgrade gcsfuse\n\n### SUSE Linux\n\nIf you're using the SUSE Linux operating system,\nuse the following instructions to upgrade to the latest version of\nCloud Storage FUSE: \n\n sudo zypper refresh\n sudo zypper -n update gcsfuse\n\nInstall or upgrade Cloud Storage FUSE by building the latest source code\n------------------------------------------------------------------------\n\nTo install or upgrade Cloud Storage FUSE by building the\n[latest source code from GitHub](https://github.com/GoogleCloudPlatform/gcsfuse/tree/master), complete the following instructions:\n\n1. If you haven't yet, install `fuse`, `git`, and `go` (see\n [go.mod](https://github.com/GoogleCloudPlatform/gcsfuse/blob/master/go.mod) for the latest version of `go`).\n\n2. Install Cloud Storage FUSE by using the `go install` command:\n\n go install github.com/googlecloudplatform/gcsfuse/v3@master\n\n If successful, a binary named `gcsfuse` is installed to `$GOPATH/bin`.\n `GOPATH` is an environment variable that's used to find the root of your `go`\n workspace.\n\nAlternatively, you can also install Cloud Storage FUSE by cloning the git\nrepository to your local file system:\n\n1. Clone the Cloud Storage FUSE repository:\n\n git clone https://github.com/GoogleCloudPlatform/gcsfuse.git\n\n2. Switch your current working directory to the `gcsfuse` folder containing the\n Cloud Storage FUSE repository:\n\n cd gcsfuse\n\n3. Install Cloud Storage FUSE by using the `go install` command:\n\n go install .\n\n If successful, a binary named `gcsfuse` is installed to `$GOPATH/bin`.\n\nTo upgrade to the latest version of Cloud Storage FUSE using source code, re-run\nthe [install instructions](#install-source-code).\n\nWhat's next\n-----------\n\nLearn how to [mount buckets using Cloud Storage FUSE](/storage/docs/gcsfuse-mount)."]]