![\"Mascote](\"\/wp-content\/uploads\/2026\/09\/filestash-v1.webp\")
<\/p>\n<\/p>\n
O fim do File Browser<\/a> deixou muita gente procurando um gerenciador de arquivos web para colocar no servidor. O FileBrowser Quantum \u00e9 o substituto direto, mas n\u00e3o \u00e9 a \u00fanica op\u00e7\u00e3o. O Filestash<\/strong> parte de outra ideia: em vez de mostrar uma pasta do disco, ele \u00e9 um cliente web para quase qualquer armazenamento, de SFTP e FTP a S3, SMB, WebDAV, NFS e Git. Neste guia, voc\u00ea vai compilar o Filestash a partir do c\u00f3digo, instalar o bin\u00e1rio no Debian ou no Ubuntu com systemd e Nginx, e comparar as tr\u00eas op\u00e7\u00f5es para saber qual faz sentido no seu caso.<\/p>\n <\/p>\n O Filestash<\/a> \u00e9 mantido por Mickael Kerjean desde 2017, escrito em Go, com a interface web em JavaScript puro, e tem cerca de 14,7 mil estrelas no GitHub. A licen\u00e7a \u00e9 a AGPL-3.0<\/strong>: voc\u00ea pode usar e modificar \u00e0 vontade, mas se oferecer uma vers\u00e3o modificada como servi\u00e7o na rede, precisa publicar o c\u00f3digo dessas modifica\u00e7\u00f5es.<\/p>\n A arquitetura gira em torno de plugins. O pr\u00f3prio README resume a filosofia: tudo o que n\u00e3o \u00e9 uma “verdade fundamental do universo” vive num plugin. Na pr\u00e1tica, isso se traduz em tr\u00eas tipos de pe\u00e7a:<\/p>\n Vale saber desde j\u00e1 onde fica a linha entre o que \u00e9 aberto e o que \u00e9 pago. A documenta\u00e7\u00e3o oficial marca como recursos da edi\u00e7\u00e3o comercial o login por OpenID Connect e SAML<\/strong>, as regras de autoriza\u00e7\u00e3o por papel (RBAC) e o HTTPS nativo com certificado pr\u00f3prio ou ACME. Na build AGPL que voc\u00ea compila, esses plugins n\u00e3o v\u00eam inclu\u00eddos; LDAP, O Filestash n\u00e3o guarda os seus arquivos: ele se conecta aos armazenamentos que voc\u00ea habilitar e mostra todos na mesma interface. A configura\u00e7\u00e3o, o banco de metadados, o \u00edndice de busca e o cache ficam num diret\u00f3rio de estado. No nosso guia, o bin\u00e1rio roda com systemd, escuta na porta 8334 e fica atr\u00e1s do Nginx com TLS.<\/p>\n O Filestash n\u00e3o publica bin\u00e1rio pronto<\/strong>. A instala\u00e7\u00e3o oficial \u00e9 o Testamos o procedimento abaixo em cont\u00eaineres limpos de Debian 13<\/strong> e Ubuntu 24.04<\/strong>, com o c\u00f3digo de 21 de setembro de 2026. H\u00e1 uma diferen\u00e7a importante entre os dois:<\/p>\n Instale as ferramentas e as bibliotecas de desenvolvimento, as mesmas que o O Em servidor ARM, troque O bin\u00e1rio \u00e9 din\u00e2mico: ele depende das bibliotecas de imagem e v\u00eddeo instaladas no passo anterior. Por isso, o jeito mais simples \u00e9 compilar no pr\u00f3prio servidor. Se for compilar em outra m\u00e1quina, use a mesma vers\u00e3o da distribui\u00e7\u00e3o e instale no servidor as bibliotecas de execu\u00e7\u00e3o correspondentes (as listadas por Crie um usu\u00e1rio de sistema, copie o conte\u00fado de Este \u00e9 o cuidado mais importante do guia. Enquanto n\u00e3o existe senha de administrador, o Filestash redireciona tudo para Por isso, defina a senha antes da primeira execu\u00e7\u00e3o, pela vari\u00e1vel Na inicializa\u00e7\u00e3o, o Filestash grava esse hash na pr\u00f3pria configura\u00e7\u00e3o. Mantenha a vari\u00e1vel no arquivo: se um dia voc\u00ea trocar a senha pelo painel, lembre que a vari\u00e1vel volta a valer no pr\u00f3ximo restart.<\/p>\n Crie Com O Como o Filestash escuta em todas as interfaces, bloqueie a porta 8334 no firewall e deixe o acesso externo s\u00f3 pelo Nginx:<\/p>\n A configura\u00e7\u00e3o segue a que o autor publica para a demo oficial<\/a>: sem buffer, com timeout longo para uploads e transfer\u00eancias grandes.<\/p>\n Emita o certificado com Abra Um exemplo comum para servidor Linux: habilitar s\u00f3 o SFTP<\/strong>, usar passthrough<\/strong> com Sem vers\u00f5es numeradas, atualizar significa recompilar a partir do ramo principal. Guarde uma c\u00f3pia do bin\u00e1rio anterior e do diret\u00f3rio de estado antes:<\/p>\n No Ubuntu, o Os tr\u00eas s\u00e3o gerenciadores de arquivos web em Go, mas resolvem problemas diferentes:<\/p>\nO que \u00e9 o Filestash<\/h2>\n
\n
htpasswd<\/code> no estilo Apache, usu\u00e1rios locais com MFA, LDAP\/Active Directory, passthrough<\/em> (o login \u00e9 repassado ao pr\u00f3prio armazenamento) e at\u00e9 usu\u00e1rios de um WordPress.<\/li>\nhtpasswd<\/code> e usu\u00e1rios locais v\u00eam.<\/p>\nComo funciona<\/h2>\n
![\"Diagrama:](\"\/wp-content\/uploads\/2026\/09\/filestash-arquitetura.webp\")
<\/p>\nPor que compilar<\/h2>\n
docker-compose.yml<\/code> da documenta\u00e7\u00e3o<\/a>, com a imagem machines\/filestash:latest<\/code>, e a \u00faltima tag numerada no GitHub \u00e9 a v0.4<\/code>, de 2019: o projeto \u00e9 distribu\u00eddo como rolling release<\/em>, a partir do ramo principal. Para rodar sem Docker, o caminho \u00e9 compilar, exatamente como o Dockerfile<\/code> oficial faz: Go para o servidor, bibliotecas C para miniaturas de imagem e FFmpeg para v\u00eddeo.<\/p>\n\n
Dockerfile<\/code> oficial, a compila\u00e7\u00e3o sai completa.<\/li>\nsed<\/code>. O resto da aplica\u00e7\u00e3o compila e funciona normalmente; s\u00f3 a convers\u00e3o de v\u00eddeo sob demanda fica de fora.<\/li>\n<\/ul>\nDepend\u00eancias de compila\u00e7\u00e3o<\/h2>\n
Dockerfile<\/code> oficial usa:<\/p>\nsudo apt update\nsudo apt install -y git curl make gcc g++ pkg-config ca-certificates apache2-utils \\\n libjpeg-dev libtiff-dev libpng-dev libwebp-dev libraw-dev libheif-dev libgif-dev libvips-dev \\\n libavcodec-dev libavdevice-dev libavfilter-dev libavformat-dev \\\n libswresample-dev libswscale-dev libavutil-dev ffmpeg poppler-utils<\/code><\/pre>\ngo.mod<\/code> do projeto exige Go 1.26<\/strong>, mais novo do que o dos reposit\u00f3rios do Debian e do Ubuntu. Instale a vers\u00e3o oficial em \/usr\/local\/go<\/code>:<\/p>\nGO_VERSION=1.26.8\ncurl -fsSL \"https:\/\/go.dev\/dl\/go${GO_VERSION}.linux-amd64.tar.gz\" | sudo tar -C \/usr\/local -xz\nexport PATH=\/usr\/local\/go\/bin:$PATH\ngo version<\/code><\/pre>\namd64<\/code> por arm64<\/code>.<\/p>\nCompilando o bin\u00e1rio<\/h2>\n
git clone --depth 1 https:\/\/github.com\/mickael-kerjean\/filestash ~\/filestash-src\ncd ~\/filestash-src\n\n# Somente no Ubuntu 24.04 (FFmpeg 6.1): remove o plugin de transcodifica\u00e7\u00e3o\nsed -i '\/plg_video_transcoder\/d' server\/plugin\/index.go\n\nmake init\nmake build\nls -lh dist\/<\/code><\/pre>\nmake init<\/code> baixa os m\u00f3dulos Go e gera o c\u00f3digo embutido; make build<\/code> produz dist\/filestash<\/code> com a interface web dentro do bin\u00e1rio. Avisos do compilador C durante o build s\u00e3o normais; o que importa \u00e9 o arquivo existir no final.<\/p>\nldd dist\/filestash<\/code>).<\/p>\nInstalando com systemd<\/h2>\n
dist\/<\/code> para \/opt\/filestash<\/code> e reserve \/var\/lib\/filestash<\/code> para o estado. A vari\u00e1vel FILESTASH_PATH<\/code> diz ao Filestash onde gravar configura\u00e7\u00e3o, banco, \u00edndice de busca e cache; sem ela, ele usa data\/<\/code> relativo ao diret\u00f3rio de trabalho.<\/p>\nsudo useradd --system --home-dir \/var\/lib\/filestash --shell \/usr\/sbin\/nologin filestash\nsudo install -d -o root -g root -m 0755 \/opt\/filestash\nsudo cp -a ~\/filestash-src\/dist\/. \/opt\/filestash\/\nsudo install -d -o filestash -g filestash -m 0750 \/var\/lib\/filestash\nsudo install -d -o root -g filestash -m 0750 \/etc\/filestash<\/code><\/pre>\nSenha do administrador antes de subir<\/h3>\n
\/admin\/setup<\/code>, e qualquer pessoa que chegar primeiro vira administradora<\/strong>. Conferimos no c\u00f3digo: sem senha definida, a verifica\u00e7\u00e3o de sess\u00e3o do painel devolve “autenticado” para qualquer um. E o servidor HTTP escuta em todas as interfaces, n\u00e3o s\u00f3 em 127.0.0.1<\/code>.<\/p>\nADMIN_PASSWORD<\/code>. Ela n\u00e3o recebe a senha em texto: recebe o hash bcrypt<\/strong>, que o htpasswd<\/code> gera:<\/p>\nread -rsp 'Senha do admin: ' SENHA; echo\nHASH=$(htpasswd -bnBC 10 \"\" \"$SENHA\" | tr -d ':\\n')\nunset SENHA\nprintf 'FILESTASH_PATH=\/var\/lib\/filestash\/\\nADMIN_PASSWORD=%s\\n' \"$HASH\" | sudo tee \/etc\/filestash\/filestash.env >\/dev\/null\nsudo chown root:filestash \/etc\/filestash\/filestash.env\nsudo chmod 0640 \/etc\/filestash\/filestash.env<\/code><\/pre>\nA unit<\/h3>\n
\/etc\/systemd\/system\/filestash.service<\/code>:<\/p>\n[Unit]\nDescription=Filestash\nAfter=network-online.target\nWants=network-online.target\n\n[Service]\nUser=filestash\nGroup=filestash\nWorkingDirectory=\/var\/lib\/filestash\nEnvironmentFile=\/etc\/filestash\/filestash.env\nExecStart=\/opt\/filestash\/filestash\nRestart=on-failure\n\nNoNewPrivileges=true\nPrivateTmp=true\nProtectSystem=strict\nProtectHome=true\nReadWritePaths=\/var\/lib\/filestash\n\n[Install]\nWantedBy=multi-user.target<\/code><\/pre>\nProtectSystem=strict<\/code>, o servi\u00e7o s\u00f3 grava em \/var\/lib\/filestash<\/code>. Se voc\u00ea for usar o armazenamento local<\/strong> para servir uma pasta do servidor, acrescente essa pasta em ReadWritePaths<\/code> e d\u00ea permiss\u00e3o ao usu\u00e1rio filestash<\/code>; para SFTP, S3 e os demais, nada muda.<\/p>\nsudo systemctl daemon-reload\nsudo systemctl enable --now filestash\ncurl -s http:\/\/127.0.0.1:8334\/healthz; echo\njournalctl -u filestash -f<\/code><\/pre>\n\/healthz<\/code> responde com um JSON de status, \u00fatil para monitorar. Para o b\u00e1sico de units e logs, veja o guia de comandos essenciais do systemd<\/a>.<\/p>\nFeche a porta 8334<\/h3>\n
sudo ufw allow OpenSSH\nsudo ufw allow 'Nginx Full'\nsudo ufw deny 8334\/tcp\nsudo ufw enable\nsudo ufw status<\/code><\/pre>\nNginx com HTTPS<\/h2>\n
server {\n listen 80;\n server_name arquivos.exemplo.com.br;\n return 301 https:\/\/$host$request_uri;\n}\n\nserver {\n listen 443 ssl;\n server_name arquivos.exemplo.com.br;\n\n ssl_certificate \/etc\/letsencrypt\/live\/arquivos.exemplo.com.br\/fullchain.pem;\n ssl_certificate_key \/etc\/letsencrypt\/live\/arquivos.exemplo.com.br\/privkey.pem;\n\n client_max_body_size 0;\n\n location \/ {\n proxy_pass http:\/\/127.0.0.1:8334;\n proxy_buffering off;\n proxy_cache off;\n proxy_read_timeout 86400;\n proxy_set_header Host $host:$server_port;\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n proxy_set_header X-Forwarded-Proto $scheme;\n }\n}<\/code><\/pre>\nsudo certbot --nginx -d arquivos.exemplo.com.br<\/code> e recarregue o Nginx. client_max_body_size 0<\/code> tira o limite de tamanho de upload no proxy; se preferir um teto, use algo como 10G<\/code>.<\/p>\nPrimeira configura\u00e7\u00e3o<\/h2>\n
https:\/\/arquivos.exemplo.com.br\/admin<\/code> e entre com a senha definida no hash. O painel tem tr\u00eas \u00e1reas principais:<\/p>\n\n
host<\/code> p\u00fablico (usado em links), porta e recursos opcionais. O console web (\/admin\/tty\/<\/code>) vem desligado<\/strong> por padr\u00e3o; deixe assim.<\/li>\n<\/ul>\nhostname<\/code> fixo em 127.0.0.1<\/code>, e cada pessoa entra com o pr\u00f3prio usu\u00e1rio do sistema. As permiss\u00f5es s\u00e3o as do Linux, e o Filestash vira uma interface web para o SSH que voc\u00ea j\u00e1 administra.<\/p>\nAtualizando<\/h2>\n
sudo tar czf \/root\/filestash-estado-$(date +%F).tar.gz -C \/var\/lib filestash\nsudo cp -a \/opt\/filestash \/opt\/filestash.anterior\n\ncd ~\/filestash-src\ngit pull\nsed -i '\/plg_video_transcoder\/d' server\/plugin\/index.go # s\u00f3 no Ubuntu 24.04\nmake init && make build\nsudo systemctl stop filestash\nsudo cp -a dist\/. \/opt\/filestash\/\nsudo systemctl start filestash\ncurl -s http:\/\/127.0.0.1:8334\/healthz; echo<\/code><\/pre>\ngit pull<\/code> pode reclamar da altera\u00e7\u00e3o local em server\/plugin\/index.go<\/code>; rode git checkout server\/plugin\/index.go<\/code> antes do pull<\/code> e aplique o sed<\/code> de novo depois.<\/p>\nFile Browser, FileBrowser Quantum e Filestash lado a lado<\/h2>\n