Atualizando guia para incluir Tailscale Funnel (URL Pública)

2026-05-06 16:00:48 -03:00
parent e3f649459a
commit 09d30df26b
1 changed files with 47 additions and 0 deletions
@@ -0,0 +1,47 @@
+# 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](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:
+```bash
+git clone https://dietpi.tail706a7a.ts.net/rodolpho/apitdn.git
+```
+
+### B. Download de Snapshot (ZIP)
+Para baixar a versão mais recente sem Git:
+*   **URL**: [https://dietpi.tail706a7a.ts.net/rodolpho/apitdn/archive/master.zip](https://dietpi.tail706a7a.ts.net/rodolpho/apitdn/archive/master.zip)
+
+### 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`
+
+### Passo 3: Headers
+```http
+Authorization: token [SEU_TOKEN_PAT]
+Accept: application/json
+```
+
+## 🔒 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.