Firexport / Guias

Como exportar as regras de segurança e os índices do Firestore

O Console do Firebase mostra as regras de segurança do Firestore em um editor e os índices em uma tabela, mas não tem botão para salvar nenhum dos dois como arquivo. Os arquivos que a Firebase CLI implanta são firestore.rules e firestore.indexes.json. Há três formas de obtê-los. Qual delas serve depende de você implantar a partir de uma pasta de projeto e de qual versão das regras você precisa.

Atualizado em 27 de outubro de 2026. O Firexport, a extensão do método 1, é nosso. Os métodos 2 e 3 não precisam dele.

1. Exportar do Console do Firebase com o Firexport

O Firexport é uma extensão gratuita do Chrome que adiciona um botão Exportar às guias Regras (Rules) e Índices (Indexes) do Firestore. Não há login para fazer, e nada é lido do seu banco de dados: o Firexport salva o que o console já mostra.

Regras de segurança

1. Instale o Firexport pela Chrome Web Store.
2. No Console do Firebase, abra Firestore Database > Regras (Rules).
3. Para exportar uma versão anterior, escolha-a na lista à esquerda. Alterações não publicadas no editor são exportadas como estão.
4. Clique em Exportar, na ponta direita da barra acima do editor. O Firexport salva o texto do editor como firestore.rules.

O arquivo contém exatamente o que está no editor, byte a byte, incluindo comentários e linhas em branco. Exportar as regras é gratuito em todos os planos.

Índices

1. Abra Firestore Database > Índices (Indexes).
2. Clique em Exportar, ao lado de Adicionar índice (Add index).

• Na versão gratuita, o Firexport salva em JSON a tabela que você está vendo, com todas as páginas dela: os índices compostos em Manual, as isenções de campo único em Automático (Automatic). É a tabela como o console a mostra, então o firebase deploy não consegue lê-la, e o nome dela não é firestore.indexes.json.
• Com o Advanced, o Firexport salva o firestore.indexes.json: os índices compostos e as substituições de campo juntos, seja qual for a tabela exibida, no formato que o firebase firestore:indexes imprime. Para um banco de dados nomeado, o arquivo é firestore.<database>.indexes.json.
• Uma diferença em relação ao arquivo da CLI: um campo com política de TTL e sem isenção de índice não aparece nele, porque o console não carrega esses campos.

Exporte as regras e os índices do Firestore direto do console, sem instalar a Firebase CLI.

Adicionar ao Chrome — grátis

2. Baixar os arquivos com a Firebase CLI

A Firebase CLI grava os dois arquivos quando configura o Firestore em uma pasta: o firebase init firestore baixa as regras e os índices implantados no projeto. Se quiser só os índices, o firebase firestore:indexes imprime o firestore.indexes.json. Os dois são gratuitos e precisam do Node.js.

npm install -g firebase-tools
firebase login

# Rules and indexes, into firestore.rules and firestore.indexes.json
firebase init firestore

# Or only the indexes
firebase firestore:indexes --project your-project-id > firestore.indexes.json

• O init pergunta o projeto e os nomes dos arquivos e grava um firebase.json que aponta para eles. Ele baixa as últimas regras publicadas, não uma versão anterior nem um rascunho não publicado.
• Para um banco de dados que não seja o (default), adicione --database <id> ao firestore:indexes. O init pergunta qual banco de dados configurar, mas busca as regras sem o nome do banco de dados, então confira se o firestore.rules veio do banco que você queria.

3. Copiar as regras do console

Para as regras atuais, uma única vez, o console basta. Abra Firestore Database > Regras (Rules), clique no editor, selecione tudo com Ctrl+A (⌘A no Mac), copie e cole em um arquivo chamado firestore.rules. Para copiar uma versão anterior, escolha-a à esquerda primeiro.

Os índices não têm esse atalho. A guia Índices (Indexes) é uma tabela, não texto, então ter um arquivo com eles significa escrever cada índice à mão no firestore.indexes.json.

Implantar os arquivos de volta

Os dois arquivos ficam ao lado de um firebase.json que aponta para eles, o mesmo que o firebase init firestore grava:

{
  "firestore": {
    "rules": "firestore.rules",
    "indexes": "firestore.indexes.json"
  }
}

Depois execute firebase deploy --only firestore, ou firestore:rules ou firestore:indexes para só um deles.

• Se o projeto tiver índices que o arquivo não lista, a CLI os mostra e pergunta antes de excluí-los. O --force os exclui sem perguntar. Uma política de TTL que falte no arquivo não é excluída.
• Adicione --project para implantar as mesmas regras e índices em outro projeto, por exemplo de produção para homologação.
• As regras implantadas passam a valer imediatamente para todos os clientes, então teste as alterações primeiro no emulador do Firestore.

Perguntas frequentes

É possível baixar as regras de segurança do Firestore no Console do Firebase?

Não com um botão. A guia Regras (Rules) as mostra em um editor do qual você pode copiá-las, o firebase init firestore as baixa para o firestore.rules, e uma extensão do navegador como o Firexport adiciona um botão Exportar que as salva como firestore.rules.

Como exporto os índices do Firestore para firestore.indexes.json?

Execute firebase firestore:indexes > firestore.indexes.json com a Firebase CLI, ou exporte o arquivo da guia Índices (Indexes) com o Firexport Advanced. Os dois gravam os índices compostos e as substituições de campo no formato que o firebase deploy lê.

Como copio os índices do Firestore para outro projeto?

Exporte o firestore.indexes.json do primeiro projeto e depois execute firebase deploy --only firestore:indexes --project com o ID do outro projeto. Os novos índices são criados em segundo plano, e as consultas que precisam de um deles falham até que ele apareça como Ativado (Enabled).

Posso recuperar uma versão anterior das minhas regras do Firestore?

Sim, pelo console. A guia Regras (Rules) lista as versões anteriores à esquerda; escolha uma para vê-la e depois copie-a ou exporte-a com o Firexport. O firebase init firestore só baixa as últimas regras publicadas.

Exportar regras ou índices consome leituras do Firestore?

Não. As regras e as definições de índice não são documentos, então salvá-las não lê nada do seu banco de dados, seja pelo console, pela CLI ou pelo Firexport.