{"id":12,"date":"2026-06-11T09:00:00","date_gmt":"2026-06-11T12:00:00","guid":{"rendered":"https:\/\/www.wspeed.com.br\/blog\/backup-firebird\/"},"modified":"2026-06-20T16:02:33","modified_gmt":"2026-06-20T19:02:33","slug":"backup-firebird","status":"publish","type":"post","link":"https:\/\/www.wspeed.com.br\/blog\/backup-firebird\/","title":{"rendered":"Backup Firebird: o Perigo de Copiar o .FDB Cru"},"content":{"rendered":"
Resposta r\u00e1pida<\/span><\/p>\n

Backup Firebird correto usa o gbak \u2014 utilit\u00e1rio oficial que l\u00ea o banco de forma transacional e gera um .fbk \u00edntegro, mesmo com o banco em uso. Copiar o arquivo .fdb diretamente com o servi\u00e7o no ar cria uma c\u00f3pia inconsistente que pode n\u00e3o restaurar na hora que voc\u00ea mais precisar.<\/p>\n<\/div>\n

Mas Maur\u00edcio, o sistema j\u00e1 gera backup todo dia \u2014 ele copia o .fdb automaticamente, ent\u00e3o t\u00e1 protegido, n\u00e9?<\/strong><\/p>\n

Essa \u00e9 a frase que mais me preocupa quando um t\u00e9cnico me conta como est\u00e1 a prote\u00e7\u00e3o do cliente dele. Porque copiar o .fdb<\/code> com o Firebird rodando \u00e9 uma das armadilhas mais silenciosas que existe em pequenas e m\u00e9dias empresas brasileiras.<\/p>\n

Voc\u00ea olha a pasta, v\u00ea o arquivo l\u00e1, o relat\u00f3rio marca “OK”. Mas na hora do restore \u2014 HD queimado, servidor comprometido, troca de m\u00e1quina \u2014 o arquivo simplesmente n\u00e3o abre. Ou pior: abre com erro de integridade, com registros faltando, com as \u00faltimas horas de trabalho perdidas.<\/p>\n

Backup Firebird (ou becape do Firebird) feito do jeito errado cria a ilus\u00e3o de prote\u00e7\u00e3o.<\/strong> E ilus\u00e3o de prote\u00e7\u00e3o \u00e9 mais perigosa do que n\u00e3o ter backup nenhum \u2014 porque voc\u00ea para de procurar o problema at\u00e9 o dia que ele te encontra.<\/p>\n

Neste post vou te explicar por que isso acontece e como fazer do jeito certo, com o utilit\u00e1rio oficial. Se voc\u00ea ainda est\u00e1 construindo o conceito de por que backup de banco de dados \u00e9 diferente de backup de arquivos comuns, recomendo come\u00e7ar pelo backup de banco de dados<\/a> antes de continuar aqui.<\/p>\n

Por que copiar o .fdb com o banco no ar \u00e9 roleta-russa?<\/h2>\n

O Firebird armazena tudo \u2014 estrutura e dados \u2014 em um \u00fanico arquivo .fdb<\/code> (ou .gdb<\/code> em vers\u00f5es antigas). Parece simples. Mas por baixo desse arquivo \u00fanico existe uma estrutura de p\u00e1ginas em mem\u00f3ria, transa\u00e7\u00f5es em aberto, e um processo cont\u00ednuo de escrita em disco.<\/p>\n

Quando voc\u00ea copia o .fdb<\/code> com o servi\u00e7o no ar, voc\u00ea est\u00e1 congelando esse arquivo no meio de uma opera\u00e7\u00e3o. O resultado \u00e9 uma c\u00f3pia que reflete um estado parcial do banco \u2014 p\u00e1ginas que foram escritas at\u00e9 a metade, transa\u00e7\u00f5es que n\u00e3o fecharam, \u00edndices inconsistentes com os dados.<\/p>\n

Tecnicamente isso se chama c\u00f3pia de arquivo inconsistente<\/strong>. Na pr\u00e1tica, se chama: o banco n\u00e3o abre no restore.<\/p>\n

Vou ser honesto aqui: n\u00e3o sei o exato comportamento de cada vers\u00e3o do Firebird em cada cen\u00e1rio de c\u00f3pia \u2014 a l\u00f3gica de flush de p\u00e1ginas pode variar. O que eu sei, de pr\u00e1tica no campo, \u00e9 que copiar o .fdb<\/code> cru \u00e9 roleta-russa. \u00c0s vezes funciona. \u00c0s vezes n\u00e3o. E voc\u00ea s\u00f3 vai descobrir qual foi quando precisar recuperar.<\/p>\n

O .fbk que o gbak gera \u00e9 diferente do .fdb?<\/h2>\n

Completamente diferente. O gbak<\/strong> \u00e9 o utilit\u00e1rio oficial do Firebird para backup e restore. Ele n\u00e3o copia o arquivo f\u00edsico \u2014 ele l\u00ea o banco de forma l\u00f3gica e transacional: exporta estrutura e dados, p\u00e1gina por p\u00e1gina, garantindo consist\u00eancia mesmo com o banco em uso.<\/p>\n

O arquivo gerado \u00e9 o .fbk<\/code>. Esse \u00e9 o arquivo que vale. Ele pode ser restaurado em qualquer servidor com Firebird na mesma vers\u00e3o ou mais recente, e o gbak valida o banco durante o processo \u2014 se tiver corrup\u00e7\u00e3o no .fdb<\/code> original, o gbak acusa durante o backup, antes de voc\u00ea precisar descobrir isso no pior momento.<\/p>\n

Existe tamb\u00e9m o nbackup<\/strong>, que faz c\u00f3pia f\u00edsica incremental. Menciono pra voc\u00ea saber que existe \u2014 mas fique com o gbak. O nbackup, se o processo for interrompido por qualquer motivo, deixa o banco em modo delta acumulando mudan\u00e7as indefinidamente, sem concluir. J\u00e1 vi banco parar por isso.<\/p>\n\n\n\n\n\n\n
M\u00e9todo<\/th>\nConsist\u00eancia<\/th>\nBanco pode ficar no ar?<\/th>\nRestaura?<\/th>\nRecomendado?<\/th>\n<\/tr>\n<\/thead>\n
Copiar .fdb cru<\/strong><\/td>\nN\u00e3o garantida (p\u00e1ginas em escrita)<\/td>\nSim (mas o risco \u00e9 esse)<\/td>\nTalvez \u2014 depende da sorte<\/td>\nN\u00e3o<\/td>\n<\/tr>\n
gbak (.fbk)<\/strong><\/td>\nGarantida (leitura transacional)<\/td>\nSim<\/td>\nSim, sempre<\/td>\nSim<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Como fazer o backup Firebird com gbak (passo a passo)?<\/h2>\n

O fluxo que usamos \u2014 e recomendamos \u2014 \u00e9 o seguinte: fazer um shutdown controlado e brev\u00edssimo via gfix<\/strong>, copiar o .fdb<\/code> pra uma pasta tempor\u00e1ria, reativar o banco imediatamente, e rodar o gbak sobre a c\u00f3pia. O banco fica indispon\u00edvel por segundos; o gbak trabalha na c\u00f3pia enquanto o sistema j\u00e1 est\u00e1 de volta para os usu\u00e1rios.<\/p>\n

Aqui est\u00e3o os comandos:<\/p>\n

:: Coloca o banco em shutdown controlado (aguarda ate 100s pelas transacoes ativas)\ngfix -sh -tr 100 -fo 100 -user SYSDBA -pas masterkey localhost:C:\\Dados\\Sistema.fdb\n\n:: Copia o .fdb para pasta temporaria\ncopy C:\\Dados\\Sistema.fdb C:\\WSPEED\\BACKUP\\Validar\\Sistema.fdb\n\n:: Reativa o banco imediatamente (usuarios ja podem entrar)\ngfix -online normal -user SYSDBA -pas masterkey localhost:C:\\Dados\\Sistema.fdb\n\n:: Roda o gbak sobre a copia (banco ja esta online de novo)\ngbak -backup -v -ig -y C:\\WSPEED\\BACKUP\\Logs\\backup.txt ^\n  localhost:C:\\WSPEED\\BACKUP\\Validar\\Sistema.fdb ^\n  C:\\WSPEED\\BACKUP\\Sistema-backup.fbk\n<\/code><\/pre>\n
Os par\u00e2metros importantes: -v<\/code> ativa o verbose (voc\u00ea v\u00ea o que est\u00e1 acontecendo no log), -ig<\/code> ignora erros n\u00e3o cr\u00edticos de integridade durante o dump, -y<\/code> redireciona a sa\u00edda para um arquivo de log que voc\u00ea pode checar depois.<\/p>\n
Aten\u00e7\u00e3o no caminho do gbak.<\/strong> Em vers\u00f5es 2.5, normalmente fica em C:\\Program Files (x86)\\Firebird\\Firebird_2_5\\bin\\gbak.exe<\/code>. Em vers\u00f5es 3.x e 4.x o caminho muda. Muita gente roda o Firebird embutido dentro do sistema ERP e nem sabe qual vers\u00e3o est\u00e1 instalada \u2014 confirme qual vers\u00e3o do Firebird est\u00e1 instalada (2.5, 3.x ou 4.x) antes de montar o script, porque o caminho do gbak muda conforme a vers\u00e3o.<\/p>\n
Como restaurar um .fbk no Firebird?<\/h2>\n
Mas Maur\u00edcio, e se eu precisar restaurar \u2014 como funciona na pr\u00e1tica?<\/strong><\/p>\n
O restore com gbak \u00e9 direto. O par\u00e2metro -c<\/code> cria um banco novo a partir do .fbk<\/code>; o -r<\/code> substitui se o arquivo de destino j\u00e1 existir:<\/p>\n
set GBAK=\"C:\\Program Files (x86)\\Firebird\\Firebird_2_5\\bin\\gbak.exe\"\nset ISC_USER=SYSDBA\nset ISC_PASSWORD=masterkey\n\n%GBAK% -c -r -user %ISC_USER% -pas %ISC_PASSWORD% -p 8192 -v ^\n  C:\\WSPEED\\BACKUP\\Sistema-backup.fbk ^\n  localhost:C:\\WSPEED\\RESTORE\\SistemaRestaurado.fdb\n<\/code><\/pre>\n
O -p 8192<\/code> define o page size em 8 KB \u2014 padr\u00e3o moderno para Firebird 2.5+. Se o banco original foi criado com 4 KB (vers\u00f5es antigas), use o mesmo valor que o original, sen\u00e3o o restore pode falhar.<\/p>\n
Um ponto que pouca gente faz mas que \u00e9 obrigat\u00f3rio: teste o restore periodicamente, em ambiente separado, sem aviso pr\u00e9vio.<\/strong> Rode o restore num servidor de teste, abra o banco, confirme que as tabelas est\u00e3o l\u00e1, que os registros mais recentes aparecem. Fazer isso uma vez por m\u00eas \u2014 ou pelo menos uma vez por trimestre \u2014 \u00e9 o que separa backup de verdade de falsa seguran\u00e7a.<\/p>\n
Se voc\u00ea quer entender por que “fazer backup” e “ter backup” s\u00e3o coisas diferentes, vale ler o post sobre o que \u00e9 backup<\/a>.<\/p>\n
O .fbk ficou no servidor \u2014 e agora?<\/h2>\n
Voc\u00ea j\u00e1 imaginou fazer backup Firebird todos os dias durante meses e descobrir que o .fbk est\u00e1 no mesmo servidor que o sistema?<\/strong><\/p>\n
Ransomware criptografa tudo que est\u00e1 acess\u00edvel no servidor \u2014 inclusive a pasta de backup local. HD queima e leva o .fdb<\/code> e o .fbk<\/code> juntos. Servidor pega fogo ou fica debaixo d’\u00e1gua (como aconteceu com 9 clientes nossos na enchente do Rio Grande do Sul em maio de 2024 \u2014 recolocamos todos de p\u00e9 em dias, porque o dado deles estava na nuvem, longe do problema).<\/p>\n
O .fbk na pasta local \u00e9 um arquivo tempor\u00e1rio esperando o pior acontecer. O backup de verdade s\u00f3 existe quando sai do servidor.<\/strong><\/p>\n
O fluxo completo que recomendamos \u00e9 este:<\/p>\n
    \n
  1. Script com gfix + gbak gera o .fbk<\/code> na pasta local.<\/li>\n
  2. O arquivo vai pra nuvem criptografada imediatamente (off-site).<\/li>\n
  3. A nuvem guarda vers\u00f5es por 7, 15 ou 30 dias (rotativo).<\/li>\n
  4. Restore testado mensalmente em ambiente separado.<\/li>\n<\/ol>\n
    Aqui na WSpeed, o nosso backup em nuvem para empresas<\/a> monitora a pasta onde o gbak deposita o .fbk<\/code> e envia cada arquivo novo pro Backblaze B2 \u2014 nosso armazenamento prim\u00e1rio, especializado em backup e mais econ\u00f4mico \u2014 com criptografia AES-256 e reten\u00e7\u00e3o configur\u00e1vel. Se precisar, o arquivo tamb\u00e9m vai pro AWS S3. Sem a\u00e7\u00e3o manual, sem depender de algu\u00e9m lembrar de copiar.<\/p>\n
    Se voc\u00ea cuida da TI de v\u00e1rios clientes e muitos deles rodam sistemas em Firebird, d\u00e1 uma olhada em como trabalhamos com solu\u00e7\u00f5es para empresas de TI<\/a> \u2014 o modelo de parceria para MSP faz sentido exatamente pra esse tipo de cen\u00e1rio.<\/p>\n
    Por onde come\u00e7ar se voc\u00ea est\u00e1 montando isso agora?<\/h2>\n
    N\u00e3o precisa virar especialista em Firebird para montar uma rotina decente. O resumo pr\u00e1tico \u00e9 este:<\/p>\n
      \n
    1. Identifique qual vers\u00e3o do Firebird est\u00e1 instalada (2.5, 3.x ou 4.x) e onde fica o gbak \u2014 o caminho muda conforme a vers\u00e3o.<\/li>\n
    2. Monte o script com gfix + copy + gfix online + gbak. Use os comandos deste post como ponto de partida.<\/li>\n
    3. Agende o script para rodar fora do horario comercial (00h, 01h) via Agendador de Tarefas do Windows.<\/li>\n
    4. Monitore o log gerado pelo -y<\/code> do gbak \u2014 qualquer erro aparece ali.<\/li>\n
    5. Configure o envio do .fbk<\/code> pra nuvem assim que o arquivo for gerado.<\/li>\n
    6. Teste o restore. Sem isso, os passos anteriores s\u00e3o s\u00f3 esperan\u00e7a.<\/li>\n<\/ol>\n
      Para os outros bancos de dados que voc\u00ea encontra nas empresas \u2014 SQL Server, MySQL, PostgreSQL, Oracle \u2014 o post de backup de banco de dados<\/a> cobre os comandos nativos de cada um com o mesmo n\u00edvel de detalhe.<\/p>\n
      Me conta nos coment\u00e1rios: qual \u00e9 a vers\u00e3o do Firebird que mais aparece nos seus clientes \u2014 e j\u00e1 pegou algum backup de .fdb que simplesmente n\u00e3o restaurou na hora H? Aposto que tem hist\u00f3ria boa (ou dolorosa) por a\u00ed.<\/p>\n
      Abra\u00e7o e at\u00e9 o pr\u00f3ximo artigo ou v\u00eddeo.<\/p>\n
      \n
      Perguntas frequentes<\/h2>\n
      \nPosso copiar o .fdb com o banco aberto?<\/summary>\n
      \n
      N\u00e3o \u00e9 recomendado. O Firebird mant\u00e9m p\u00e1ginas sendo escritas em disco durante o uso, e copiar o .fdb com o servi\u00e7o no ar pode resultar em um arquivo inconsistente \u2014 voc\u00ea acha que tem backup, mas tem um .fdb que n\u00e3o restaura. O caminho certo \u00e9 usar o gbak ou fazer uma janela de parada controlada via gfix antes de copiar.<\/p>\n<\/div>\n<\/details>\n
      \nO que \u00e9 gbak?<\/summary>\n
      \n
      gbak \u00e9 o utilit\u00e1rio oficial de backup e restore do Firebird. Ele l\u00ea o banco de forma l\u00f3gica e transacional \u2014 exportando estrutura e dados com consist\u00eancia garantida \u2014 e gera um arquivo .fbk que pode ser restaurado em qualquer servidor com Firebird na mesma vers\u00e3o ou mais recente.<\/p>\n<\/div>\n<\/details>\n
      \nComo restaurar um .fbk?<\/summary>\n
      \n
      Use o gbak com o par\u00e2metro -c (create) para criar um banco novo a partir do .fbk, ou -r (replace) para substituir um existente. Exemplo: gbak -c -r -user SYSDBA -pas masterkey backup.fbk localhost:C:\\Dados\\SistemaRestaurado.fdb. Confirme a vers\u00e3o do Firebird no servidor de destino antes de restaurar.<\/p>\n<\/div>\n<\/details>\n
      \nPreciso parar o servi\u00e7o para fazer backup Firebird?<\/summary>\n
      \n
      N\u00e3o necessariamente. O gbak consegue gerar um backup consistente com o banco em uso. A alternativa mais segura \u2014 especialmente em sistemas com muita escrita simult\u00e2nea \u2014 \u00e9 fazer um shutdown controlado e breve via gfix (-sh -tr), copiar o .fdb para uma pasta tempor\u00e1ria, reativar o banco imediatamente e rodar o gbak sobre a c\u00f3pia. O banco fica offline por segundos.<\/p>\n<\/div>\n<\/details>\n
      \nComo mandar o backup Firebird pra nuvem?<\/summary>\n
      \n
      Depois que o gbak gera o .fbk na pasta local, voc\u00ea precisa que esse arquivo saia do servidor \u2014 porque ransomware, HD queimado ou servidor destru\u00eddo levam o .fbk junto. A WSpeed monitora a pasta de destino e envia cada arquivo novo para o Backblaze B2 (armazenamento prim\u00e1rio) com criptografia AES-256 e versionamento, sem a\u00e7\u00e3o manual.<\/p>\n<\/div>\n<\/details>\n<\/section>\n