Guia de Acesso Externo e Integração (Tailscale Funnel)
Este documento descreve como acessar e consumir os dados do projeto apitdn de qualquer lugar da internet através do Tailscale Funnel.
🌐 1. Infraestrutura de Conexão
O seu Raspberry Pi está agora exposto publicamente (via túnel seguro) e também através da VPN Mesh:
- Endereço Público (Funnel): https://dietpi.tail706a7a.ts.net - Acesso de qualquer lugar, sem VPN.
- IP Tailscale (VPN):
100.127.147.8 - Acesso restrito à sua rede privada.
- IP Local (LAN):
192.168.0.63:3000 - Acesso apenas na rede Wi-Fi local.
🛠️ 2. Métodos de Consumo de Dados (Acesso Público)
A. Clonagem via Git
Você pode clonar o repositório de qualquer máquina com acesso à internet:
B. Download de Snapshot (ZIP)
Para baixar a versão mais recente sem Git:
C. Acesso aos Arquivos Raw
Ideal para scripts e automações que precisam ler um arquivo específico:
- Exemplo:
https://dietpi.tail706a7a.ts.net/rodolpho/apitdn/raw/branch/master/fluig_rag_docs/README.md
🤖 3. Integração com LLMs e Agentes de IA
Para alimentar sistemas de RAG externos:
Passo 1: Autenticação (PAT)
Gere um Personal Access Token (PAT) no seu perfil do Gitea (Configurações > Aplicativos).
Passo 2: Endpoint de API Público
Utilize a URL do Funnel para chamadas de API:
GET https://dietpi.tail706a7a.ts.net/api/v1/repos/rodolpho/apitdn/contents/fluig_rag_docs
🔒 Segurança e Notas
- Funnel: O tráfego é criptografado via HTTPS (TLS) gerenciado automaticamente pelo Tailscale.
- Autenticação: Embora a URL seja pública, o acesso ao conteúdo segue as permissões do repositório no Gitea.
- Disponibilidade: O acesso depende do Raspberry Pi estar ligado e com o serviço
tailscaled ativo.