Publica uma configuração redigida, refere que a VPN não funciona e recebe seis respostas sobre seis coisas diferentes. O problema costuma ser o pedido, não os leitores. Quem ajuda não consegue saber a partir de uma configuração se o túnel não é construído, se é construído mas descarta o tráfego, ou se funciona bem enquanto o serviço de ficheiros por trás recusa a ligação. Descreva antes um fluxo, com três responsáveis e uma falha observada, e as respostas melhoram de imediato.

Porque o pedido recebe respostas inúteis

Uma configuração descreve o que está configurado. Não descreve o que tentou, o que aconteceu nem qual de várias máquinas deve fazer que trabalho. Sem isso, cada leitor adivinha uma etapa diferente.

O caso ilustrativo é um portátil em viagem que deve chegar a um serviço de ficheiros num servidor doméstico através da gateway doméstica. Indique se a gateway, o servidor VPN e o servidor de ficheiros são a mesma máquina ou três máquinas, porque esse único facto muda quase todas as respostas.

Preencha este registo antes de publicar


Goal: the one resource or operation that should work
Path: client -> access network -> VPN endpoint -> resource
Owners: who controls the client, the gateway and the resource
Software: product, version and protocol in use
Expected: what success would look like
Observed: exact non-secret error or response
Time and change: when it started and what changed
Control: one comparable operation that still works


Oito linhas, e a maioria dos pedidos torna-se respondível. A linha de controlo é a que as pessoas omitem: se navegar a partir do mesmo portátil funciona enquanto a partilha de ficheiros não, isso restringe o problema às rotas do túnel ou ao serviço, e ninguém precisa de perguntar.

Mantenha as etiquetas coerentes quando redige. Preserve a diferença entre o ponto final público, o endereço do túnel e a sub-rede doméstica. Se dois intervalos se sobrepuserem, mantenha essa relação visível em vez de substituir cada rede pelo mesmo marcador, porque a sobreposição é muitas vezes a resposta.

Nomeie a etapa que falha, não todo o registo

Vale a pena separar cinco etapas: resolução de nomes, tentativa de ligação, autenticação, estabelecimento do túnel e acesso ao recurso. Diga qual pensa que falhou e o que viu ali.

Cole um pequeno excerto em torno do acontecimento em vez de cada ficheiro de depuração que o cliente possa produzir. Cem linhas de ruído de aperto de mão escondem a linha que diz que o nome do certificado não coincidia.

Mantenha a observação e a explicação separadas. «O cliente relata um tempo limite de aperto de mão após 30 segundos» é uma observação; «penso que o fornecedor bloqueia UDP» é uma teoria. Ambas são úteis, e misturá-las significa que quem ajuda não sabe em qual confiar. Etiquete-as, e a resposta que receber tratará da correta.

Envie-o ao responsável que pode agir

Para um portátil gerido pela entidade empregadora, comece pelo canal de suporte da entidade empregadora, porque um fórum comunitário não pode mudar a política dela. Para um serviço VPN comercial, indique o produto e a conta em privado, não em público. Para a sua própria gateway, inclua os papéis de router e de servidor que controla.

Se usar uma comunidade pública, escolha uma cujo âmbito atual se adeque à tarefa. Um tópico antigo sobre as regras do fórum não é um contrato de suporte, e uma resposta com cinco anos sobre uma versão de protocolo que não executa também não é.

Oculte os segredos sem achatar a topologia

Remova as chaves privadas, as palavras-passe, os tokens e as ligações que transportam credenciais antes de algo sair da sua máquina. Uma exportação de diagnóstico e uma configuração completa são artefactos diferentes mesmo quando os nomes dos ficheiros parecem iguais, e o que colou pode conter uma chave pré-partilhada.

Depois mantenha as relações que tornam o fluxo compreensível. O RFC 6973 trata a recolha e a correlação desnecessárias como questões de privacidade, e o mesmo princípio aplica-se aqui: partilhe as provas de que o destinatário precisa, não a máquina inteira.

Termine com uma pergunta respondível sobre a discrepância observada, como por que razão o cliente conclui a autenticação e depois nunca recebe uma rota. Uma pergunta específica obtém uma resposta específica, e o registo que construiu é o que permite a alguém dar uma sem pedir os seus segredos.

Artigos relacionados