From 09d30df26be393995e809b31d103a01d1072c338 Mon Sep 17 00:00:00 2001
From: rodolpho <rodolphoborgesmarkovsky@gmail.com>
Date: Wed, 6 May 2026 16:00:48 -0300
Subject: [PATCH] =?UTF-8?q?Atualizando=20guia=20para=20incluir=20Tailscale?=
 =?UTF-8?q?=20Funnel=20(URL=20P=C3=BAblica)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 Acesso-Externo-e-Integracao.md | 47 ++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)
 create mode 100644 Acesso-Externo-e-Integracao.md

diff --git a/Acesso-Externo-e-Integracao.md b/Acesso-Externo-e-Integracao.md
new file mode 100644
index 0000000..496de38
--- /dev/null
+++ b/Acesso-Externo-e-Integracao.md
@@ -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.