Chegar a uma nuvem que o PolyDrive não lista
Testado a 18 de setembro de 2026 com o rclone v1.75.1. Cerca de dez minutos e um terminal para dois comandos. O rclone é um projeto de código aberto independente, não é nosso — esta página explica como juntar os dois e onde as costuras se notam.
O seletor do PolyDrive tem 47 entradas. Se o serviço de que precisa não estiver entre elas, quase sempre resta uma porta de entrada. O rclone fala com cerca de 57 sistemas de armazenamento e pode publicar qualquer um deles como um pequeno servidor na sua própria máquina. O PolyDrive monta esse servidor. O rclone trata do fornecedor; o PolyDrive trata da metade do Finder — entrada na barra lateral, ficheiros que se descarregam ao abrir, sem camada FUSE nem extensão do kernel.
Veja primeiro no seletor. Muitos serviços que não aparecem pelo nome continuam a ser alcançáveis diretamente: tudo o que é compatível com S3 encaixa na entrada S3 com o seu endpoint, tudo o que fala WebDAV encaixa em WebDAV, e há entradas para SFTP, FTP e OpenStack Swift. Uma ligação direta é sempre melhor do que uma ponte. Esta página é para o que sobra.
- Para que nuvens serve isto
- Antes de começar
- Passo 1 · Configurar o remoto no rclone
- Passo 2 · Publicá-lo na sua máquina
- Passo 3 · Ligar o PolyDrive
- Várias nuvens por trás de uma unidade
- Mantê-lo a funcionar
- As definições que decidem a experiência
- SFTP em vez de WebDAV
- Resolução de problemas
- O que saber antes de depender disto
Para que nuvens serve isto
Estes são serviços a que o rclone chega e para os quais o PolyDrive não tem entrada, em setembro de 2026. Os nomes são os do rclone.
| Tipo | Serviços |
|---|---|
| Nuvens pessoais | Proton Drive, iCloud Drive, Mail.ru Cloud, HiDrive, OpenDrive, SugarSync, Internxt, Filen, Drime, Gofile, Pixeldrain, put.io, premiumize.me, 1Fichier, Uloz.to, Linkbox |
| Trabalho e empresas | Files.com, Citrix ShareFile, Zoho WorkDrive, Quatrix, Enterprise File Fabric, Akamai NetStorage, Shade |
| Infraestrutura e arquivos | Oracle Cloud Object Storage, QingStor, HDFS, Sia, Internet Archive, Google Photos, Cloudinary, ImageKit, and any plain HTTP directory listing (read-only) |
O rclone assinala alguns como experimentais ou sobretudo de leitura, e uns quantos não conseguem mudar o nome de um ficheiro nem manter a data de modificação. Leia a página do seu fornecedor em rclone.org antes de mover algo importante pela ponte — os limites que encontrar no Finder são os desse backend, não os do PolyDrive.
Antes de começar
- Uma máquina que não adormeça. A ponte existe apenas enquanto o rclone estiver a correr. No seu Mac serve, mas a unidade desaparece quando o Mac adormece; num NAS ou num pequeno servidor sempre ligado está sempre lá.
- Uma conta no fornecedor e um navegador para o passo de início de sessão, se usar OAuth.
- Uma unidade da sua quota do PolyDrive. Uma ponte conta como uma única unidade, por mais remotos que estejam por trás — veja Várias nuvens por trás de uma unidade.
Passo 1 · Configurar o remoto no rclone
Instale o rclone com o Homebrew, ou traga o binário de rclone.org:
brew install rclone
Depois execute a configuração interativa. Pede um nome, um tipo de armazenamento e o que esse fornecedor precisar; os fornecedores com OAuth abrem um navegador e devolvem o token sozinhos.
rclone config
Dê ao remoto um nome curto — mycloud aqui em baixo. Confirme
que funciona antes de o PolyDrive entrar em cena:
rclone lsd mycloud:
Isso imprime as pastas de primeiro nível. Se falhar já aqui, o problema está entre o rclone e o fornecedor, e a documentação do rclone é o sítio certo.
Passo 2 · Publicá-lo na sua máquina
Um comando publica o remoto como servidor WebDAV na interface de loopback, acessível apenas a partir desta máquina:
rclone serve webdav mycloud: \
--addr 127.0.0.1:8080 \
--user polydrive --pass 'choose-a-long-password' \
--vfs-cache-mode writes \
--dir-cache-time 1m
O que faz cada parte:
| Opção | Porquê |
|---|---|
--addr 127.0.0.1:8080 |
Só escuta nesta máquina. Qualquer outra coisa põe a sua nuvem na rede — veja a nota de segurança. |
--user / --pass |
Invente ambos. Sem eles o rclone publica sem autenticação nenhuma, e qualquer processo da máquina pode ler a unidade. |
--vfs-cache-mode writes |
Guarda em disco local o ficheiro que está a ser escrito e envia-o assim que estiver completo. Sem isto, os backends que precisam de saber o tamanho de um ficheiro à partida recusam as escritas do Finder. |
--dir-cache-time 1m |
Durante quanto tempo o rclone confia nas suas próprias listagens de pastas. Os cinco minutos por omissão são muito tempo à espera de um ficheiro que acabou de adicionar noutro lado. |
Deixe essa janela de terminal aberta por agora — Mantê-lo a funcionar torna isto permanente.
Passo 3 · Ligar o PolyDrive
No PolyDrive, adicione uma unidade na nuvem, escolha WebDAV e preencha:
- Server Address:
http://127.0.0.1:8080 - Username e Password: o par que inventou no passo 2
Dê à unidade o nome do fornecedor em vez de “rclone”, porque é assim que aparecerá na barra lateral do Finder. Daqui para a frente comporta-se como qualquer outra unidade do PolyDrive: os ficheiros aparecem de imediato, o conteúdo chega quando os abre, e pode manter uma pasta offline.
Este caminho está testado, não suposto. O motor WebDAV do
próprio PolyDrive faz uma volta completa contra o
rclone serve webdav — listar, criar pasta, escrever,
leitura por intervalos, leitura completa, mudar o nome, apagar — e passa
tudo. O mesmo com o rclone serve sftp. Última execução a
18 de setembro de 2026 com o rclone v1.75.1.
Várias nuvens por trás de uma unidade
O rclone consegue apresentar vários remotos como uma só árvore, que o PolyDrive monta então como uma única unidade. Cada remoto passa a ser uma pasta de primeiro nível:
rclone config create everything combine \
upstreams "proton=proton: archive=ia: work=filescom:"
rclone serve webdav everything: --addr 127.0.0.1:8080 \
--user polydrive --pass 'choose-a-long-password' --vfs-cache-mode writes
O primeiro nível de um remoto combinado é uma lista de nomes, não uma pasta.
Dentro de proton/ ou work/ pode ler, escrever, mudar
nomes e apagar à vontade, mas criar um ficheiro ou uma pasta ao lado deles
falha: o rclone aceita a pasta e depois recusa a escrita com um conflito.
Trabalhe um nível abaixo.
Mantê-lo a funcionar
O rclone serve não tem modo de segundo plano próprio. No macOS,
entregue-o ao launchd para que arranque ao iniciar sessão e volte a
arrancar se parar. Guarde isto como
~/Library/LaunchAgents/net.example.rclone-bridge.plist:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
"http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key> <string>net.example.rclone-bridge</string>
<key>ProgramArguments</key>
<array>
<string>/opt/homebrew/bin/rclone</string>
<string>serve</string>
<string>webdav</string>
<string>mycloud:</string>
<string>--addr</string> <string>127.0.0.1:8080</string>
<string>--user</string> <string>polydrive</string>
<string>--pass</string> <string>choose-a-long-password</string>
<string>--vfs-cache-mode</string><string>writes</string>
<string>--dir-cache-time</string><string>1m</string>
</array>
<key>RunAtLoad</key> <true/>
<key>KeepAlive</key> <true/>
</dict>
</plist>
Carregue-o:
launchctl load ~/Library/LaunchAgents/net.example.rclone-bridge.plist
A palavra-passe fica nesse ficheiro em claro, por isso mantenha-o legível só
para si (chmod 600). Num Mac Intel o caminho do rclone é
/usr/local/bin/rclone; o which rclone diz-lhe qual
tem. Num NAS, corra o mesmo comando num contentor que reinicie com o aparelho e
aponte o PolyDrive ao endereço do NAS em vez de 127.0.0.1 —
se for pela rede, leia primeiro a nota de segurança.
As definições que decidem a experiência
Escrita: --vfs-cache-mode
writes é a resposta certa para uma unidade montada. O rclone
escreve primeiro o ficheiro que chega num diretório de cache e envia-o quando
este é fechado, que é o que permite ao Finder copiar para backends que não
aceitam um fluxo de comprimento desconhecido. O custo é disco: uma cópia de
40 GB precisa por momentos de 40 GB livres. Limite-o com
--vfs-cache-max-size 20G se o espaço for escasso. O
full também guarda o que lê, o que ajuda se reabrir os mesmos
ficheiros constantemente e prejudica se percorrer uma biblioteca grande uma só
vez.
Atualidade: --dir-cache-time
Um ficheiro que adicione pela app ou pelo site do fornecedor só aparece no
Finder depois de a listagem do rclone expirar. O
Refresh from Server do PolyDrive pergunta ao rclone, e o rclone
responde a partir dessa cache, por isso não consegue encurtar a espera. Um
minuto é um bom compromisso. Se preferir limpá-la a pedido, acrescente
--rc ao comando serve e execute rclone rc vfs/forget.
Não use o rclone serve s3
Parece a escolha natural e é a única ponte que não funciona. O PolyDrive cria uma pasta como o armazenamento de objetos o faz — um objeto marcador de zero bytes — e o servidor S3 do rclone transforma esse marcador num ficheiro vulgar com o nome da pasta. A primeira escrita dentro da pasta falha então, porque já lá está um ficheiro com esse nome. Testado e reproduzido a 18 de setembro de 2026. Use WebDAV ou SFTP.
SFTP em vez de WebDAV
O SFTP é a mesma ideia com outro protocolo, e vale a pena experimentar se um fornecedor se portar de forma estranha por WebDAV — nomes de ficheiro e datas invulgares tendem a sobreviver melhor.
rclone serve sftp mycloud: \
--addr 127.0.0.1:2022 \
--user polydrive --pass 'choose-a-long-password' \
--vfs-cache-mode writes
No PolyDrive escolha SFTP, ponha o
Server Address em 127.0.0.1:2022 e use o mesmo
nome de utilizador e palavra-passe. O rclone gera a sua chave de anfitrião na
primeira execução e guarda-a, por isso a chave que o PolyDrive memorizou
continua válida.
Solução de problemas
| O que vê | Porquê | Solução |
|---|---|---|
| O PolyDrive não liga de todo | O comando serve não está a correr, ou está noutro porto | Veja o terminal ou launchctl list | grep rclone, e se o porto coincide |
| A autenticação falha | --user/--pass missing or different |
Os dois lados têm de coincidir exatamente. Ponha entre aspas uma palavra-passe com espaços ou $ |
| A unidade monta mas está vazia | O remoto foi publicado numa subpasta, ou o próprio remoto está vazio | Execute rclone lsd mycloud: e publique o caminho que tem os seus ficheiros, p. ex. mycloud:Documents |
| Copiar um ficheiro para lá falha | O backend não aceita um fluxo de comprimento desconhecido | Acrescente --vfs-cache-mode writes |
| Um ficheiro adicionado noutro lado não aparece | A listagem de pastas do rclone ainda não expirou | Baixe o --dir-cache-time, ou use rclone rc vfs/forget |
| As escritas falham no primeiro nível de um remoto combinado | Esse nível é uma lista de nomes de remotos, não uma pasta | Trabalhe dentro de uma das pastas com nome |
| Mudar o nome falha, ou as datas voltam erradas | Esse backend do rclone não consegue fazê-lo | Veja a página dele em rclone.org; nada do lado do PolyDrive altera isto |
| Tudo para depois de o Mac adormecer | O processo serve foi com ele | Ponha a ponte numa máquina sempre ligada, ou volte a ligar a unidade depois de acordar |
| O disco enche durante uma cópia grande | A cache de escrita guarda o ficheiro inteiro | --vfs-cache-max-size, e deixe espaço para o maior ficheiro que mover |
O que saber antes de depender disto
-
Mantenha a ponte na interface de loopback. A autenticação
WebDAV sobre
http://simples envia a palavra-passe de uma forma que qualquer um no caminho pode ler, e o servidor entrega a sua nuvem inteira. Se a ponte tiver de viver noutra máquina, ponha-a atrás de algo como o Tailscale, ou dê ao rclone um certificado com--certe--keye ligue-se porhttps://. Nunca encaminhe o porto para a internet. -
Os tokens são do rclone. Um remoto em que inicia sessão através
do
rclone configfica autorizado ao registo de aplicação do rclone, não ao do PolyDrive. Revogue-o nas definições da sua conta no fornecedor, tal como faria com qualquer outra app. - Duas caches, não uma. O PolyDrive guarda o que aprende da ponte, e o rclone guarda o que aprende do fornecedor. Quando algo parece desatualizado, a causa costuma ser a segunda.
- Não conseguimos dar apoio à metade do rclone. O rclone é um projeto independente sob a licença MIT, sem ligação ao PolyDrive. As perguntas de configuração de um backend concreto pertencem ao fórum dele. Tudo o que correr mal entre o PolyDrive e uma ponte a funcionar é connosco, e queremos saber.
- Uma ponte é um remendo, não uma funcionalidade. Traz um processo que tem de estar a correr, uma cache que é preciso afinar e o calendário de lançamentos de um segundo projeto. Onde o PolyDrive suporta um serviço diretamente, use isso.
Diga-nos qual devemos integrar
Todos os serviços do seletor lá estão porque alguém pediu. Se estiver a usar uma ponte para algum, escreva para [email protected] e diga qual — é assim que a fila se ordena. Se for a própria ponte a portar-se mal no Finder, inclua o que o botão Copy Diagnostics da janela de erro lhe der. Veja também Resolução de problemas.