Como Criar uma Pasta Compartilhada no VMware: Guia Técnico Completo para Convidados Windows e Linux

Uma pasta compartilhada VMware é um diretório do lado do host exposto a uma máquina virtual convidada através do protocolo HGFS (Host-Guest File System), implementado via módulos de kernel do VMware Tools. Funciona como uma montagem de pseudo-sistema de ficheiros que ignora completamente o disco virtual, permitindo a troca direta de ficheiros entre o SO do host e o SO do convidado sem configuração de rede, FTP ou transferências SCP.

Este guia abrange o processo completo de configuração para VMware Workstation, VMware Player e VMware Fusion — incluindo a instalação do VMware Tools, configuração de pastas compartilhadas, acesso do lado do convidado tanto no Windows como no Linux, montagem HGFS persistente via `/etc/fstab`, e resolução dos modos de falha mais comuns que a documentação normalmente omite.

Pré-requisitos e Visão Geral da Arquitetura

Antes de alterar qualquer configuração, confirme que os seguintes requisitos estão cumpridos:

• VMware Workstation Pro/Player (v16+), VMware Fusion (host macOS), ou VMware Workstation Pro 17 está instalado no host.
• Existe uma máquina virtual funcional que consegue arrancar com sucesso.
• VMware Tools está instalado dentro do SO convidado — isto é inegociável. A funcionalidade de pasta compartilhada depende inteiramente do módulo de kernel `vmhgfs` (Linux) ou do driver VMCI/HGFS (Windows) que o VMware Tools instala.
• A pasta do host que pretende partilhar existe e tem permissões de sistema de ficheiros adequadas para a conta de utilizador que executa o processo VMware.

Por que o HGFS é importante: Ao contrário de uma partilha de rede (SMB/NFS), o HGFS opera através do canal de comunicação backdoor do VMware. Não existe pilha TCP/IP envolvida, não há regras de firewall a configurar e não é necessária resolução DNS. Isto torna-o significativamente mais rápido para transferências de ficheiros pequenos e completamente isolado da configuração de rede do convidado.

Passo 1: Instalar o VMware Tools no SO Convidado

O VMware Tools é o pré-requisito ao qual a maioria das configurações falhadas remonta. O Open-VM-Tools, o equivalente de código aberto mantido pela comunidade Linux, é totalmente suportado e preferido nas distribuições Linux modernas.

Instalar o VMware Tools num Convidado Windows

1. Com a VM ligada, navegue até VM > Instalar VMware Tools na barra de menus do VMware. Se a opção indicar “Reinstalar VMware Tools”, selecione-a — realiza a mesma operação.
2. O VMware monta uma ISO virtual (`windows.iso`) como unidade de CD-ROM dentro do convidado.
3. Abra o Explorador de Ficheiros, navegue até à unidade montada (normalmente `D:`) e execute `setup.exe`.
4. Selecione a instalação Típica, a menos que tenha um motivo específico para personalizar os componentes.
5. Reinicie o convidado quando solicitado.

Instalar o VMware Tools num Convidado Linux

As distribuições modernas devem utilizar o open-vm-tools do seu gestor de pacotes nativo em vez do instalador legado baseado em Perl:

“`bash

Debian / Ubuntu

sudo apt update && sudo apt install open-vm-tools open-vm-tools-desktop

RHEL / CentOS / AlmaLinux / Rocky Linux

sudo dnf install open-vm-tools

Arch Linux

sudo pacman -S open-vm-tools

“`

Após a instalação, ative e inicie o serviço:

“`bash

sudo systemctl enable vmtoolsd

sudo systemctl start vmtoolsd

“`

Nota crítica para convidados Linux headless/servidor: Instale apenas `open-vm-tools` (sem o sufixo `-desktop`) se o convidado não tiver ambiente gráfico. O pacote `-desktop` adiciona integração X11 que é irrelevante e potencialmente problemática em servidores.

Se estiver a utilizar o método legado de ISO do VMware Tools no Linux:

“`bash

Mount the CD if not auto-mounted

sudo mount /dev/cdrom /mnt/cdrom

Copy and extract the tarball

cp /mnt/cdrom/VMwareTools-*.tar.gz /tmp/

cd /tmp && tar -xzf VMwareTools-*.tar.gz

Run the installer

cd vmware-tools-distrib

sudo ./vmware-install.pl

“`

Aceite todas as predefinições, a menos que tenha um requisito de configuração específico. Reinicie após a conclusão.

Passo 2: Ativar Pastas Compartilhadas nas Definições do VMware

Este passo é realizado na máquina host através da interface do VMware. A VM não precisa de estar ligada para a configuração inicial, embora também seja possível ajustar as definições enquanto a VM está em execução em algumas versões do VMware.

1. No VMware Workstation/Player, selecione a sua máquina virtual alvo no painel da biblioteca.
2. Clique em Editar definições da máquina virtual (ou prima `Ctrl+D`).
3. Navegue até ao separador Opções (não ao separador Hardware).
4. Selecione Pastas Compartilhadas na lista do lado esquerdo.
5. Na secção “Partilha de pastas”, escolha uma das seguintes opções:

Selecione Sempre ativado para um fluxo de trabalho de desenvolvimento ou operações persistente.

1. Clique em Adicionar para iniciar o Assistente de Pasta Compartilhada.

Passo 3: Configurar a Pasta Compartilhada através do Assistente

O assistente é simples, mas contém uma opção que frequentemente causa confusão:

1. Clique em Seguinte no ecrã de boas-vindas do assistente.
2. Clique em Procurar para selecionar o diretório do lado do host que pretende expor ao convidado. Também pode escrever o caminho diretamente. Importante: O caminho deve ser acessível à conta de utilizador do SO sob a qual o VMware está a ser executado. Se o VMware for executado com a sua conta de utilizador, a pasta deve ser legível (e gravável, se necessário) por essa conta.
3. Dê um nome à pasta compartilhada. Este nome torna-se o identificador do ponto de montagem dentro do convidado — não precisa de corresponder ao nome real da pasta no host. Utilize nomes curtos e alfanuméricos sem espaços para evitar problemas de escape de caminhos em terminais Linux.
4. Marque Ativar esta partilha para a ativar imediatamente.
5. Opcionalmente, marque Apenas leitura se o convidado não deve ter acesso de escrita à pasta do host. Esta é uma prática de segurança recomendada ao partilhar código-fonte ou ficheiros de configuração com VMs não confiáveis ou experimentais.
6. Clique em Concluir e depois em OK.

Passo 4: Aceder à Pasta Compartilhada Dentro do SO Convidado

Aceder a Pastas Compartilhadas num Convidado Windows

1. Arranque a VM e inicie sessão.
2. Abra o Explorador de Ficheiros.
3. No painel de navegação esquerdo, clique em Rede. Verá um host com o nome `vmware-host`.
4. Expanda `vmware-host` > Pastas Compartilhadas — a sua pasta configurada aparece aqui.
5. Pode mapeá-la como uma unidade de rede persistente: clique com o botão direito na pasta, selecione Mapear unidade de rede e atribua uma letra de unidade (por exemplo, `Z:`).

Em alternativa, aceda diretamente através do caminho UNC na caixa de diálogo Executar (`Win+R`):

“`

vmware-hostShared Foldersyour_folder_name

“`

Aceder a Pastas Compartilhadas num Convidado Linux

Por predefinição, o VMware Tools monta as pastas compartilhadas em `/mnt/hgfs/`. Verifique isto imediatamente após o arranque:

“`bash

ls /mnt/hgfs/

“`

Se o nome da sua pasta compartilhada aparecer, navegue para dentro dela:

“`bash

cd /mnt/hgfs/your_folder_name

ls -la

“`

Se `/mnt/hgfs/` estiver vazio ou o diretório não existir, o sistema de ficheiros HGFS não foi montado automaticamente. Este é um problema comum com kernels mais recentes e open-vm-tools. Utilize o seguinte comando de montagem manual:

“`bash

sudo mkdir -p /mnt/hgfs

sudo vmhgfs-fuse .host:/ /mnt/hgfs/ -o subtype=vmhgfs-fuse,allow_other

“`

O binário `vmhgfs-fuse` (parte do open-vm-tools) substitui a abordagem legada de módulo de kernel utilizada em versões mais antigas do VMware Tools. A sintaxe `.host:/` monta todas as pastas compartilhadas em `/mnt/hgfs/` simultaneamente.

Tornar a Montagem HGFS Persistente Entre Reinicializações (Linux)

Adicione uma entrada em `/etc/fstab` para que as pastas compartilhadas sejam montadas automaticamente no arranque:

“`bash

sudo nano /etc/fstab

“`

Acrescente a seguinte linha:

“`

.host:/ /mnt/hgfs fuse.vmhgfs-fuse defaults,allow_other,uid=1000,gid=1000 0 0

“`

Substitua `uid=1000` e `gid=1000` pelo UID/GID real da sua conta de utilizador (verifique com `id yourusername`). Definir estes valores garante que os ficheiros montados pertencem ao seu utilizador em vez de root, o que evita erros de permissão ao editar ficheiros dentro do convidado.

Teste a entrada do fstab sem reiniciar:

“`bash

sudo mount -a

“`

Passo 5: Resolução de Problemas Comuns em Pastas Compartilhadas

Os seguintes problemas representam os padrões de falha mais frequentes, incluindo casos extremos que a documentação padrão não aborda.

Pasta Compartilhada Não Visível no Convidado Linux

Sintoma: `/mnt/hgfs/` existe mas está vazio após ativar as pastas compartilhadas nas definições do VMware.

Causa 1 — módulo vmhgfs não carregado:

“`bash

lsmod | grep vmhgfs

“`

Se não aparecer nenhum resultado, o módulo falhou ao carregar. Verifique `dmesg` para erros:

“`bash

dmesg | grep -i vmhgfs

“`

Causa 2 — Incompatibilidade de versão do kernel: Após uma atualização do kernel, os módulos de kernel do open-vm-tools podem não recompilar automaticamente. Reinstale:

“`bash

sudo apt reinstall open-vm-tools # Debian/Ubuntu

sudo dnf reinstall open-vm-tools # RHEL-based

“`

Causa 3 — vmtoolsd não está em execução:

“`bash

sudo systemctl status vmtoolsd

sudo systemctl restart vmtoolsd

“`

Erros de Permissão Negada na Pasta HGFS Montada

Sintoma: Os ficheiros são visíveis mas não podem ser editados ou criados dentro da pasta compartilhada a partir do convidado.

Causa raiz: A montagem HGFS tem por predefinição propriedade root. As opções FUSE `allow_other` e `uid`/`gid` resolvem este problema. Se estiver a utilizar o módulo de kernel legado (não FUSE), adicione o utilizador ao grupo `vmware` ou ajuste a ACL da pasta do host.

Pastas Compartilhadas Desativadas nas Definições do VMware

Sintoma: A opção Pastas Compartilhadas está presente mas não é configurável.

Causa: Isto ocorre com o VMware Player (versão gratuita) em determinadas configurações de SO do host, ou quando a VM está configurada em modo restrito/encriptado. O VMware Workstation Pro é necessário para a gestão completa de pastas compartilhadas em implementações empresariais.

Pasta Compartilhada Inacessível Após Suspensão/Hibernação do Host

Sintoma: A montagem HGFS fica obsoleta após o host retomar do modo de suspensão.

Solução: Remonte manualmente ou adicione um serviço systemd que remonte na retomada:

“`bash

sudo systemctl restart vmtoolsd

sudo vmhgfs-fuse .host:/ /mnt/hgfs/ -o subtype=vmhgfs-fuse,allow_other

“`

Desempenho Lento na Transferência de Ficheiros Através de Pastas Compartilhadas

Causa raiz: O HGFS não está otimizado para transferências de binários de grande dimensão. Para transferir ficheiros com mais de 500 MB, considere utilizar SCP, rsync sobre SSH para um adaptador de rede apenas do host, ou simplesmente anexar um disco virtual adicional. As pastas compartilhadas destacam-se em ficheiros de configuração pequenos, scripts e código-fonte — não em movimentação de dados em massa.

Passo 6: Gerir e Remover Pastas Compartilhadas

A gestão de pastas compartilhadas é não destrutiva — remover uma pasta compartilhada das definições do VMware não elimina o diretório do lado do host. Remove apenas o mapeamento HGFS.

1. Desligue a VM (ou ajuste as definições em tempo real se a versão do VMware suportar hot-add).
2. Abra Editar definições da máquina virtual > Opções > Pastas Compartilhadas.
3. Selecione a entrada da pasta alvo.
4. Clique em Remover para eliminar o mapeamento, ou em Propriedades para modificar o nome, caminho ou indicador de apenas leitura.
5. Ligue novamente a VM. O ponto de montagem no convidado estará vazio ou ausente no próximo arranque.

Para remover uma entrada obsoleta de `/etc/fstab` no Linux após remover a pasta compartilhada, edite o ficheiro e elimine a linha `.host:/` correspondente, depois execute `sudo mount -a` para verificar que não há erros.

Pastas Compartilhadas VMware vs. Métodos Alternativos de Transferência de Ficheiros

Compreender quando utilizar pastas compartilhadas em vez de outros mecanismos é fundamental tanto para ambientes de produção como de desenvolvimento.

Para equipas que gerem infraestrutura virtualizada em escala, as limitações do HGFS tornam-se rapidamente evidentes. As cargas de trabalho de produção que requerem acesso a ficheiros consistente e de alto débito entre host e convidado são melhor servidas por soluções de armazenamento dedicadas. Se estiver a executar múltiplas VMs para desenvolvimento, testes ou pipelines CI/CD, um ambiente de Alojamento VPS com volumes de armazenamento devidamente provisionados elimina completamente a fronteira host-convidado.

Considerações de Segurança para Pastas Compartilhadas VMware

As pastas compartilhadas introduzem uma ponte direta de sistema de ficheiros entre o host e o convidado. Isto tem implicações de segurança significativas:

• Risco de fuga da VM: Um convidado comprometido com acesso de escrita a uma pasta compartilhada pode modificar ficheiros do lado do host. Utilize sempre o modo apenas leitura ao partilhar pastas com VMs que executam software não confiável ou serviços voltados para o público.
• Princípio do menor privilégio: Partilhe apenas o subdiretório específico necessário, nunca o diretório home completo ou a raiz do sistema.
• Propagação de malware: Ransomware executado dentro de uma VM convidada pode encriptar ficheiros numa pasta compartilhada gravável no host. Trate as pastas compartilhadas como uma superfície de ataque.
• Consistência de snapshots: Os ficheiros modificados através do HGFS não são capturados nos snapshots da VM. Se a consistência de reversão for importante, copie os ficheiros para o disco virtual antes de criar um snapshot.

Para ambientes onde o isolamento é fundamental — como investigação de segurança, análise de malware ou alojamento multi-inquilino — considere utilizar um Servidor Dedicado com isolamento ao nível do hardware em vez de fluxos de trabalho baseados em pastas compartilhadas.

Integrar Pastas Compartilhadas VMware em Fluxos de Trabalho de Desenvolvimento

As pastas compartilhadas são mais poderosas quando integradas em fluxos de trabalho automatizados:

Sincronização de ficheiros de projetos web: Monte uma pasta compartilhada apontando para o diretório do projeto do lado do host e configure o servidor web do convidado (Apache/Nginx) para servir diretamente a partir de `/mnt/hgfs/project/`. As edições feitas no IDE do host refletem-se instantaneamente no convidado sem qualquer passo de sincronização.

Gestão de configuração compartilhada: Armazene playbooks Ansible, ficheiros de estado Terraform ou definições Docker Compose no host e execute-os a partir do convidado. Isto mantém os ficheiros com controlo de versão no host enquanto aproveita as ferramentas do lado do convidado.

Recolha de artefactos de compilação: Configure scripts CI dentro do convidado para escrever binários compilados ou relatórios de testes no diretório montado HGFS, tornando-os imediatamente disponíveis no host sem passos de SSH ou cópia de ficheiros.

Para equipas que gerem múltiplos ambientes virtuais com acesso a painel de controlo, o VPS com cPanel fornece uma alternativa gerida onde a gestão de ficheiros, permissões de utilizador e pipelines de implementação são tratados através de uma interface unificada sem configuração manual de HGFS.

Se o seu fluxo de trabalho envolve a implementação de aplicações web de VMs de desenvolvimento para produção, combinar a sua configuração VMware local com Alojamento Web Partilhado para ambientes de staging permite-lhe testar estruturas de ficheiros e permissões antes de enviar para servidores de produção.

Para implementações seguras com SSL onde os certificados precisam de ser distribuídos por vários ambientes, os Certificados SSL da AlexHost podem ser provisionados e depois distribuídos para VMs convidadas através de pastas compartilhadas durante scripts de configuração automatizados.

Lista de Verificação de Decisão Técnica

Utilize esta lista de verificação antes de configurar pastas compartilhadas VMware em qualquer ambiente:

• [ ] O VMware Tools ou open-vm-tools está instalado e o serviço `vmtoolsd` está em execução
• [ ] O caminho da pasta do lado do host não contém espaços ou caracteres especiais (evita bugs de escape de caminhos FUSE)
• [ ] As permissões de leitura/escrita adequadas estão definidas na pasta do host para o utilizador do processo VMware
• [ ] Para convidados Linux: o binário `vmhgfs-fuse` está disponível (`which vmhgfs-fuse`)
• [ ] Para montagens persistentes: a entrada `/etc/fstab` inclui as opções `uid`/`gid` e `allow_other`
• [ ] O modo apenas leitura está ativado para qualquer VM que execute cargas de trabalho não confiáveis ou voltadas para o exterior
• [ ] As transferências de ficheiros grandes (>500 MB) são encaminhadas através de SCP/rsync em vez de HGFS
• [ ] Os snapshots são tirados do estado do disco virtual, não dependendo do histórico de ficheiros do lado HGFS
• [ ] Após atualizações do kernel em convidados Linux, os módulos do open-vm-tools são verificados ou reinstalados
• [ ] As entradas obsoletas de `/etc/fstab` são removidas quando as pastas compartilhadas são eliminadas das definições do VMware

FAQ

Por que está `/mnt/hgfs/` vazio mesmo com as pastas compartilhadas ativadas no VMware?

A causa mais comum é que o daemon `vmhgfs-fuse` não está em execução ou o módulo de kernel HGFS falhou ao carregar após uma atualização do kernel. Execute `sudo systemctl restart vmtoolsd` e depois monte manualmente com `sudo vmhgfs-fuse .host:/ /mnt/hgfs/ -o subtype=vmhgfs-fuse,allow_other`. Se isso falhar, verifique `dmesg | grep vmhgfs` para erros de carregamento de módulos e reinstale o open-vm-tools.

Posso utilizar pastas compartilhadas VMware sem o VMware Tools instalado?

Não. O protocolo HGFS é implementado inteiramente dentro do VMware Tools. Sem ele, o SO convidado não tem nenhum driver capaz de comunicar com o subsistema de partilha de ficheiros do hipervisor VMware. Não existe solução alternativa — a instalação do VMware Tools é obrigatória.

Qual é a diferença entre `vmhgfs` e `vmhgfs-fuse`?

`vmhgfs` é o módulo legado no kernel utilizado por versões mais antigas do VMware Tools. `vmhgfs-fuse` é o substituto baseado em FUSE no espaço do utilizador introduzido no open-vm-tools 10.x, que não requer compilação de módulos de kernel e funciona em várias versões do kernel sem recompilação. As distribuições Linux modernas utilizam `vmhgfs-fuse` exclusivamente.

A ativação de pastas compartilhadas afeta o desempenho da VM?

O canal HGFS adiciona uma sobrecarga de CPU negligenciável durante períodos de inatividade. Sob I/O intenso — como compilar grandes bases de código diretamente a partir da montagem HGFS — observará aumentos de latência em comparação com o I/O nativo do disco virtual. Para operações intensivas em I/O, copie os ficheiros para o disco virtual local do convidado primeiro, realize a operação e depois copie os resultados de volta para a pasta compartilhada.

As pastas compartilhadas VMware são suportadas no VMware ESXi ou vSphere?

Não. As pastas compartilhadas via HGFS são uma funcionalidade exclusiva do VMware Workstation, Player e Fusion — os produtos de hipervisor de desktop. O VMware ESXi e vSphere não suportam pastas compartilhadas baseadas em HGFS. Nesses ambientes, a partilha de ficheiros entre host e convidado é tratada através de datastores NFS, vSAN ou protocolos baseados em rede (SMB/NFS) configurados ao nível do SO convidado.