--- canonical: https://koalavps.com/pt/guides-self-host-btcpay-server-on-a-vps/ language: pt generated: 2026-10-21T13:33:42.126Z --- [Início](https://koalavps.com/pt/) / [Explorar](https://koalavps.com/pt/resources/) / As notas de campo do KoalaVPS As notas de campo do KoalaVPS # Um servidor de pagamentos com custódia concebida deliberadamente. O BTCPay Server pode permitir que um comerciante opere o seu próprio fluxo de pagamento. Separe a deteção de pagamentos, o controlo da carteira e as operações da loja. [Encontre o seu VPS](https://koalavps.com/pt/vps/) ## NESTE DOCUMENTO [Defina o limite da carteira](https://koalavps.com/pt/guides-self-host-btcpay-server-on-a-vps/#section-1)[Dimensionar para a pilha completa](https://koalavps.com/pt/guides-self-host-btcpay-server-on-a-vps/#section-2)[Proteja a interface do comerciante](https://koalavps.com/pt/guides-self-host-btcpay-server-on-a-vps/#section-3)[Faça backup e reconcilie](https://koalavps.com/pt/guides-self-host-btcpay-server-on-a-vps/#section-4)[Verifique a implantação e a estratégia da cadeia](https://koalavps.com/pt/guides-self-host-btcpay-server-on-a-vps/#section-5)[Mantenha a chave de gasto onde você pretende](https://koalavps.com/pt/guides-self-host-btcpay-server-on-a-vps/#section-6)[Crie uma lista de verificação de implementação em torno da stack escolhida](https://koalavps.com/pt/guides-self-host-btcpay-server-on-a-vps/#section-7)[Investigue pagamentos de carteira em falta sem importar uma seed](https://koalavps.com/pt/guides-self-host-btcpay-server-on-a-vps/#section-8)[Reconciliar faturas antes do cumprimento](https://koalavps.com/pt/guides-self-host-btcpay-server-on-a-vps/#section-9)[Base de conhecimento](https://koalavps.com/pt/resources/) ## Defina o limite da carteira Uma carteira somente observação pode detectar pagamentos sem manter as chaves privadas de gasto. Uma chave pública estendida ainda revela atividade sensível da carteira e deve ser protegida. A integração com Lightning pode exigir uma carteira online e introduz risco operacional adicional. ## Dimensionar para a pilha completa Um backend Bitcoin, base de dados, serviço web e nó Lightning opcional têm necessidades diferentes de armazenamento e memória. Reveja as instruções de implantação atualmente suportadas e os requisitos de crescimento antes de escolher uma máquina pequena. ## Proteja a interface do comerciante Use um nome de anfitrião dedicado, HTTPS, uma proteção de login forte e acesso administrativo restrito. Mantenha o servidor atualizado e verifique as assinaturas de webhook ou os mecanismos de verificação suportados na aplicação recetora. Não envie mercadorias apenas com base num redirecionamento do navegador. ## Faça backup e reconcilie Proteja a configuração da loja, a base de dados, as informações de recuperação da carteira e o material específico da Lightning de acordo com a documentação relevante. Teste a recuperação e reconcilie as faturas com o sistema de pagamento, especialmente em torno de expiração, pagamento insuficiente e reembolsos. ## Verifique a implantação e a estratégia da cadeia Use as instruções de implantação atualmente suportadas, um hostname dedicado e uma rota HTTPS verificada. Uma cadeia podada pode reduzir os requisitos contínuos de armazenamento onde houver suporte, mas as necessidades de rescan e recuperação devem ser compreendidas. Não escolha um disco apenas pelo tamanho atual da cadeia; deixe espaço para toda a pilha e para o crescimento. - Verifique o callback de pagamento a partir de um teste externo - Use pagamentos de teste antes de uma loja ao vivo - Confirme a política de liquidação de faturas Documentação oficial: [Opções de implantação do BTCPay](https://docs.btcpayserver.org/Deployment/) ## Mantenha a chave de gasto onde você pretende Uma configuração somente observação pode detectar pagamentos a partir de uma chave pública estendida sem entregar ao servidor a chave de gasto. A xpub é sensível porque pode revelar a atividade da carteira. Uma carteira quente altera esse risco ao colocar a capacidade de gasto online. Revise separadamente a custódia da carteira e da Lightning e siga o processo de backup suportado. Documentação oficial: [Modelo de carteira BTCPay](https://docs.btcpayserver.org/Wallet/) ## Crie uma lista de verificação de implementação em torno da stack escolhida Comece com um domínio dedicado, um método de implementação suportado, o modo de cadeia pretendido e espaço em disco suficiente para a sincronização. Reveja o gerador Docker upstream e os componentes selecionados antes da instalação; preserve as escolhas de implementação não secretas para que outra máquina possa ser reconstruída de forma consistente. Verifique a resolução do domínio, a emissão do certificado e a titularidade da conta administrativa antes de mostrar um checkout aos clientes. Um exemplo genérico de Docker Compose não é prova de que todos os componentes opcionais do BTCPay estão configurados. - Decida qual proprietário da instância controla atualizações, monitorização, backups e resposta a incidentes. - Separe a exposição do reverse-proxy do RPC Bitcoin privado, do banco de dados e da administração do Lightning. - Documente os limites de recuperação/rescan de um backend podado antes de conectar uma carteira com pagamentos históricos. - Mantenha um ambiente de teste suportado ou um pequeno exercício de pagamento controlado para integrações antes de cumprir encomendas valiosas. Documentação oficial: [BTCPay Server: opções de implementação](https://docs.btcpayserver.org/Deployment/) · [BTCPay Server: implementação Docker suportada](https://docs.btcpayserver.org/Docker/) ## Investigue pagamentos de carteira em falta sem importar uma seed Uma loja pode usar a informação xpub/derivação de uma carteira enquanto a chave de gasto permanece noutro dispositivo. Teste a receção e o caminho de recuperação com a carteira escolhida. Se o BTCPay detetar o pagamento de uma fatura mas uma carteira externa não o mostrar, inspecione o seu esquema de derivação e o comportamento do limite de lacunas de endereços antes de assumir que os fundos desapareceram. Longas sequências de endereços gerados não pagos podem afetar a descoberta de uma carteira. Utilize os diagnósticos suportados da carteira em vez de copiar palavras de recuperação para o servidor. Documentação oficial: [BTCPay Server: solução de problemas de carteira e derivação](https://docs.btcpayserver.org/FAQ/Wallet/) ## Reconciliar faturas antes do cumprimento Registe os identificadores de fatura e torne a operação de cumprimento idempotente. O regresso de um navegador à loja é um evento de navegação, não prova de liquidação. Verifique o estado do pagamento através da sua integração de servidor autenticada, trate explicitamente faturas expiradas, atrasadas ou pagas a menos, e mantenha um percurso de revisão para resultados não resolvidos. Se um callback se repetir, devolver uma confirmação bem-sucedida não deve enviar nem creditar o pedido duas vezes. - Teste um pagamento que chega perto do fim do prazo e verifique se a encomenda permanece associada à fatura correta. - Mantenha o banco de dados, a configuração da loja e o material de recuperação da carteira em um backup independente testado. - O Lightning acrescenta uma responsabilidade separada de liquidez e de backup de canais; restaurar todo o VPS de ontem não é um procedimento de recuperação universal seguro. - Alojar uma instância BTCPay não acrescenta Lightning nem XMR ao checkout de clientes KoalaVPS; os métodos de pagamento neste site de alojamento continuam a ser as suas sete rotas publicadas. Documentação oficial: [Guia para programadores Bitcoin: verificação de pagamento](https://developer.bitcoin.org/devguide/payment_processing.html) · [LND: recuperação de desastres](https://docs.lightning.engineering/lightning-network-tools/lnd/disaster-recovery) · [Core Lightning: backups de carteira e canais](https://docs.corelightning.org/docs/backup) CONTINUE A EXPLORAR ## Continuar a ler. [Guias ### O seu nó, com recuperação cuidadosa da carteira. Uma configuração Bitcoin e Lightning combina sincronização de dados, rede e fundos que exigem a sua própria disciplina de cópias d…](https://koalavps.com/pt/guides-self-host-bitcoin-lightning-node/)[Guias ### Um pagamento cuidadoso leva um minuto. As transferências de cripto merecem uma verificação deliberada porque a rede não oferece um botão de anulação convencional.…](https://koalavps.com/pt/payment-safety/)[Guias ### Um backup importa quando restaura. Projete um backup em torno dos dados que você não pode recriar e do tempo que seu serviço pode se dar ao luxo de perder. Um upload…](https://koalavps.com/pt/backups/) CONFIGURE SUA INFRAESTRUTURA ## Assuma o controle. Implemente nos seus termos. Sem documentação de identidade. Acesso total de administrador. Faturação nativa em cripto. [Selecione uma configuração](https://koalavps.com/pt/vps/)