Guia do pairing file do iPhone: como criar, importar e corrigir (2026)

Um pairing file é um pequeno arquivo que permite que um app no seu iPhone converse com os serviços de desenvolvedor do próprio iPhone, da mesma forma que um computador confiável faz. SideStore, StikDebug, LiveContainer, Feather, KSign e vários outros apps de sideloading precisam de um, e “invalid pairing file” é um dos motivos mais comuns para eles pararem de funcionar. Este guia explica o que é o arquivo, as formas de criar um, como colocá-lo em um app, por que ele para de funcionar e como mantê-lo seguro. Última verificação: 2 de novembro de 2026, com base nas páginas do GitHub do iloader, idevice_pair e StikDebug e na documentação do SideStore.

A versão resumida

• Um pairing file (geralmente um arquivo .plist ou .mobiledevicepairing) é um registro de que seu iPhone confia em um “computador”. Os apps usam esse arquivo para acessar os serviços de desenvolvedor do iPhone sem precisar de cabo.
• Ele é específico de um único aparelho. Um arquivo criado para um iPhone não funciona em outro.
• A forma mais fácil de criar e colocar um é o iloader, em um computador Mac, Windows ou Linux. O idevice_pair e o Impactor também conseguem fazer isso.
• Ele para de funcionar quando você reseta o iPhone ou muda a senha, muitas vezes depois de uma atualização do iOS, e às vezes de forma aleatória. A solução é criar um novo.
• Trate-o como uma senha: nunca compartilhe nem baixe um que outra pessoa tenha criado.

O que é um Pairing File

Quando você conecta um iPhone a um computador e toca em Confiar, os dois aparelhos trocam chaves e o computador guarda um “registro de pareamento”. Com esse registro, o computador pode usar os serviços de desenvolvedor do iPhone: instalar apps, ler logs, iniciar um debugger. Um pairing file é uma cópia desse registro que você entrega a um app no próprio iPhone. O app então age como o computador confiável, conversando com o iPhone por uma conexão local loopback (muitas vezes por meio de um pequeno app de VPN, como o LocalDevVPN), de modo que consegue fazer essas tarefas sem nenhum computador por perto.

O guia do StikDebug descreve o arquivo como “específico do aparelho”, e o README do StikDebug o lista como .plist ou .mobiledevicepairing. Existem dois tipos: o pareamento clássico lockdown, que funciona em qualquer versão do iOS, e o pareamento remoto (RPPairing), que exige iOS 17.4 ou mais recente.

Quais apps precisam de um

• SideStore, para instalar e atualizar apps no aparelho.
• StikDebug, para ativar o JIT em emuladores e outros apps.
• LiveContainer, quando instalado junto com o SideStore.
• Feather e KSign, que podem usá-lo para instalação.
• Ferramentas menores, como Protokolle, Antrag e SparseBox, que o idevice_pair também lista.

O Scarlet iOS não usa pairing file. Ele instala apps com seu próprio certificado e não precisa de nenhuma configuração via computador.

Como criar um Pairing File

As três ferramentas de computador abaixo são gratuitas e de código aberto. Baixe-as apenas das respectivas páginas do GitHub (o iloader também pode ser baixado em iloader.app); a página do iloader avisa para não baixá-lo de nenhum outro site. Antes de começar, defina uma senha no iPhone e mantenha-o desbloqueado na tela inicial durante o pareamento.

Opção 1: iloader (mais fácil)

1. No Windows, instale o iTunes primeiro (ele traz o driver USB). No Linux, instale o usbmuxd se estiver faltando. Um Mac não precisa de nada extra.
2. Instale o iloader a partir das releases no GitHub ou de iloader.app e abra-o.
3. Conecte o iPhone com um cabo USB e toque em Confiar se for solicitado.
4. Clique em Manage Pairing File.
5. Clique em Place ao lado de cada app que você quer parear, por exemplo StikDebug ou SideStore. A mensagem “Pairing file placed successfully!” aparece em verde.

Quando o iloader instala o SideStore ou o LiveContainer + SideStore para você, ele coloca os pairing files automaticamente, então você só precisa desses passos para substituir um antigo ou adicionar outro app.

Opção 2: idevice_pair

O idevice_pair (de jkcoxson, versão 1.1.0) é uma ferramenta pequena que só cria pairing files. Escolha o aparelho, selecione Lockdown ou Remote pairing, clique em Create e depois em Save to file ou clique no nome de um app para gravar o arquivo diretamente nele. Ele também consegue verificar se um arquivo novo realmente funciona, o que ajuda quando um app continua rejeitando o seu.

Opção 3: Impactor

O Impactor (antigo PlumeImpactor) tem uma página de Utilitários que aparece quando um aparelho está conectado. A partir dela, é possível instalar o SideStore ou o LiveContainer, reconfiar no aparelho e colocar um pairing file em um app compatível.

Sem computador (apenas aparelhos mais recentes)

O StikDebug tem um menu de pareamento embutido (Settings, depois Pair a Device), mas o guia afirma que isso só funciona em aparelhos com iOS/iPadOS 27 ou mais recente e na Apple TV. Em versões mais antigas, ainda é preciso usar um computador uma vez.

Como importar o arquivo em um app

Se você usou a opção “place” do iloader ou do idevice_pair, já está pronto. Se salvou o arquivo em vez disso, envie-o para o iPhone (AirDrop, Files ou iCloud Drive) e abra o app:

• StikDebug: toque em Select Pairing File e escolha o arquivo.
• SideStore: ele pede o arquivo na primeira abertura e quando o antigo para de funcionar.
• Feather / KSign: ambos têm uma opção para importar um pairing file; siga as instruções do próprio app, já que os nomes dos menus mudam entre versões.

Depois, ative a VPN de loopback que o app usa (LocalDevVPN para StikDebug e SideStore) e permaneça no Wi-Fi.

Por que um Pairing File para de funcionar

• Troca ou reset da senha: o guia do StikDebug avisa que o arquivo expira se você resetar ou trocar a senha.
• Atualização do iOS ou reset do aparelho: a documentação do SideStore diz que o arquivo “pode expirar” depois que você atualiza ou reseta o aparelho, e que isso também acontece “em momentos aleatórios”, o que depende da Apple.
• Aparelho errado: um arquivo de outro iPhone, ou de antes de uma restauração, não vai funcionar.
• VPN desligada: erros como “heartbeat” ou “connection dropped” no StikDebug muitas vezes significam que a VPN está desligada ou que você não está no Wi-Fi, e não que o arquivo está corrompido.

A solução é quase sempre a mesma: conecte o iPhone ao computador, mantenha-o desbloqueado, e crie e coloque um arquivo novo. No iloader, apague o antigo com Delete Stored Pairing primeiro, depois toque em Confiar no iPhone novamente. Para mensagens específicas do SideStore, como “The current pairing file is invalid”, veja nosso guia de erros do SideStore.

Um Pairing File é seguro?

Ele dá a quem o possui o mesmo acesso que um computador confiável teria, então trate-o como uma senha. Não poste em um chat do Discord nem envie para um site “para ajuda”, e nunca use um que alguém tenha criado para você; de qualquer forma não funcionaria, já que está vinculado ao seu aparelho. Se você acha que um arquivo vazou, remover a confiança o reseta: no iPhone, vá em Ajustes > Geral > Transferir ou Redefinir iPhone > Redefinir > Redefinir Localização e Privacidade, o que faz todo computador pedir Confiar novamente. Depois, crie um arquivo novo.

Pairing File ou Scarlet?

Um pairing file faz parte do caminho faça-você-mesmo: sua própria Apple Account, seu próprio certificado, uma configuração via computador feita uma única vez e uma renovação a cada 7 dias em uma conta gratuita, que o SideStore consegue fazer pelo próprio aparelho. O Scarlet iOS dispensa tudo isso: sem computador, sem Apple Account e sem pairing file, porque ele mesmo fornece o certificado. Esse certificado é compartilhado, então a Apple pode revogá-lo. Nosso guia comparando ferramentas gratuitas de sideloading mostra os dois caminhos lado a lado. Para experimentar o Scarlet, veja como instalar o Scarlet iOS ou comece pela nossa página de instalação do Scarlet iOS.

Perguntas frequentes

Onde fica o pairing file no meu computador?
O computador guarda seus registros de pareamento na própria pasta de lockdown, mas você não precisa procurar por ele. O iloader e o idevice_pair criam e exportam o arquivo para você.

Posso usar o mesmo pairing file em dois iPhones?
Não. Cada arquivo é feito para um único dispositivo.

Preciso de um arquivo novo depois de cada atualização do iOS?
Nem sempre, mas é comum precisar. Se um app informar que o pairing file é inválido ou está ausente depois de uma atualização, crie um novo.

O pairing file exige uma conta de desenvolvedor paga?
Não. Para criar um, basta um computador em que o iPhone confie. Os apps que o utilizam continuam sendo assinados com sua própria Apple Account, com os limites habituais da Apple para contas gratuitas.