Ir para o guia

Documentação 9.6.24

Solução de problemas

Anote servidor, versão, horário e erro exato. Remova segredos dos registros.

A bridge não retorna dados#

Confira se a conexão não foi desligada no cartão Tosun Connect, se não há set tosun_db_bridge_manual "1" sem tosun_db_bridge_enabled "1" e se o espelho antigo (ts.panelMirror.enabled) está desligado; depois confira oxmysql, framework, estrutura e conexão recente. Um pacote tosun-ac anterior à 9.6.14 ainda precisa de set tosun_db_bridge_enabled "1" no server.cfg até o novo pacote ser instalado. Os resultados são páginas de campos compatíveis, não uma cópia total.

Proteção garantida?#

Não. Validação e tokens restritos reduzem riscos específicos. Atualize recursos, reveja falsos positivos, proteja administradores e troque chaves expostas. Criptografia não impede análise do código cliente.

Localize a primeira falha#

Distinga sessão, pagamento, descarga, arranque, painel, ponte e site. Registe primeiro passo falhado, resultado esperado e último funcionamento.

Anote versão, mudanças e conta; compare horas da consola e painel. Teste uma alteração de cada vez. Em pagamento ou mudança de dinheiro incerta, consulte fatura ou saldo antes de repetir.

Confira descarga e arranque#

A descarga verifica direito ao serviço, acesso ao servidor e gestão. Use a sua própria área de descarga.

  1. Escolha conta e servidor; leia o aviso de permissão ou faturação.
  2. Mantenha tosun-ac, extraia tudo e não misture versões.
  3. Reveja dependências e ordem; corrija o primeiro erro sem levar a licença ao cliente.
  4. Envie versão, ID e erro sem segredos; não publique o pacote.

Serviços pendentes e ajuda#

Um site pode estar em fila: não duplique. Ativação e HTTPS são distintos. Domínio exige encaminhamento e TXT. A ponte vem ligada por padrão (sem linha extra no server.cfg) e exige direitos no painel, oxmysql e esquema suportado. Não responde se a conexão foi desligada no cartão Tosun Connect, se, no modo manual (tosun_db_bridge_manual), falta set tosun_db_bridge_enabled "1" ou se o espelho completo antigo está ativo (ts.panelMirror.enabled = true em configs/anticheat_config.lua); neste último caso a ponte fica desligada para o espelho continuar funcionando. Pacotes anteriores à 9.6.14 ainda precisam de set tosun_db_bridge_enabled "1" até a instalação do novo pacote.

A ponte não é um navegador SQL completo; resposta vazia ou incompatível não prova base vazia. Após dez minutos reinicie 2FA com novo QR/chave; verifique relógio e conta se o código falhar.

Ao suporte: ID, versão/framework, passos, expectativa, erro, data e fuso, alterações recentes. Remova licenças, tokens, QR, códigos de recuperação ou banco e dados desnecessários de jogadores.

Isole um problema do navegador sem perder provas#

Antes de atualizar uma página incorreta, registe endereço, conta e mensagem. Distinga problema visual, gravação recusada e redirecionamento externo falhado. As causas diferem; limpar imediatamente todas as definições pode apagar contexto útil sem corrigir permissões ou estado do serviço.

Para um problema só visual, compare a página numa sessão nova e reveja extensões que bloqueiam scripts ou navegação. Confirme a conta após entrar. Se um formulário antigo indica sessão de segurança expirada, abra a página pela navegação normal em vez de o enviar repetidamente.

Mantenha pagamentos e escritas de economia fora da comparação até conhecer o resultado original. Não copie cookies ou cabeçalhos de autenticação para o suporte. Indique versão do navegador, se a sessão nova alterou o resultado e o erro e hora originais.

Prepare uma reprodução curta com ponto de paragem#

Escolha a sequência mínima até ao erro com uma conta autorizada. Por exemplo, selecionar servidor, abrir jogadores e registar resposta: não é necessário editar saldos para provar uma falha de leitura. Indique o resultado esperado em cada passo.

Se o problema ocorre apenas após uma atualização ou numa ação específica de jogo, inclua essa condição. Compare com a última instalação funcional e versão. Pare depois do primeiro erro registado, evitando acumular pedidos, reinícios e alterações que escondem a causa original.

Descreva verificações já feitas e resultados inalterados. Partilhe apenas linhas de consola próximas do erro, removendo segredos e dados de jogadores alheios. Uma reprodução compacta oferece um caso verificável e um critério claro para saber se a correção proposta funcionou.

Confirme a correção contra o sintoma inicial#

Após corrigir, repita a leitura ou cenário de jogo original em condições comparáveis. Verifique resposta imediata e registo relevante do painel ou consola. Uma faixa desaparecida não prova, por si, conclusão correta de descarga, ligação, preparação de website ou confirmação de pagamento.

Guarde versões ou valores antigos e novos no registo de alterações. Para jogo, teste a ação normal afetada e uma próxima não afetada. Para website, confirme endereço pretendido e HTTPS. Para faturação, utilize o resultado da fatura existente em vez de criar uma cobrança de teste.

Se o sintoma regressar, comunique hora e condições alteradas desde a verificação. Restaure uma configuração conhecida apenas pelo procedimento preparado. Preserve o histórico curto para a próxima investigação partir de observações verificadas, evitando as mesmas suposições sem sucesso.

Prepare um ticket com um exemplo anônimo preenchido#

Abra um novo ticket na área de Suporte do painel; a conta precisa da permissão support.create. Preencha assunto, categoria, prioridade e mensagem seguindo o exemplo fictício abaixo. Para um problema de leitura da lista de jogadores foram escolhidos technical e normal. Escolha a prioridade conforme o impacto real: falha numa tela de leitura não significa indisponibilidade de todo o servidor. Os rótulos variam conforme o idioma da interface; os valores entre parênteses são opções atuais do formulário. Um ticket não exige licença, senha nem acesso à base de dados.

O servidor e a referência do exemplo não são registros de clientes. Identifique claramente o servidor afetado no seu ticket privado autorizado e anonimize o texto se o compartilhar publicamente. A mensagem inclui os passos e um ponto de parada: nenhum saldo foi alterado e nenhum novo trabalho foi criado. O formulário verifica no mínimo cinco caracteres no assunto e dez na mensagem; um título curto e uma explicação útil bastam. Acrescente observações futuras ao mesmo ticket. Envie somente linhas relevantes sem dados sensíveis, em vez de todo o console, um dump SQL ou cookies. A prioridade selecionada não garante um prazo de resposta.

Assunto: A solicitação da lista de jogadores não termina
Categoria: Técnica (technical)
Prioridade: Normal (normal)
Mensagem:
Servidor: TEST-SERVER — anonimizado neste exemplo
Versão / framework: 9.6.3 / QBCore — valores de exemplo
Hora: 2026-09-26 14:03 UTC
Passos: Selecionei o servidor e abri a lista uma vez.
Esperado: Primeira página de jogadores concluída.
Observado: pending seguido de timeout de rede.
Referência: TEST-REQUEST — não é um ID real
Conferido: resource iniciado; permissão de leitura necessária presente.
Ponto de parada: Não iniciei novo trabalho nem alterei saldos.
Segredos, cookies, _csrf e identificadores de jogadores removidos.

Escolha o próximo passo e o limite a partir do sintoma#

Esta sequência ajuda a identificar o primeiro passo que falhou; não é um reparo automático nem uma regra de repetição para qualquer erro. Se a lista de jogadores não abrir, confira primeiro HTTP: 401 aponta para a sessão, 419 para o valor de segurança do formulário, 403 para permissões da conta ou serviço e 429 para capacidade ou espera. Se apenas um registro estiver vazio, confira o personagem e o esquema compatível. Sintomas semelhantes podem ter causas diferentes: uma página vazia concluída e uma solicitação recusada são eventos distintos. Preserve as evidências antes de seguir uma decisão.

Para uma escrita de economia pendente ou pagamento com resultado incerto, escolha parar: confira solicitação existente, fatura e estado atual antes de iniciar outra operação. Se um resource não inicia, siga para instalação e primeiro erro do console; se um movimento legítimo é sinalizado, confira integração e duração limitada da permissão. Não desligue toda a proteção como solução provisória. Se um site está ativo mas HTTPS falha, examine domínio e certificado separadamente. Alterar relógio ou tela local não conclui a operação do servidor. Explique ao suporte qual observação determinou o caminho; não considere bem-sucedido um resultado desconhecido.