--- title: No celular description: Use o Lampson, o agente de programação com IA, pelo celular: instale como app, entre com uma passkey e conecte ao seu PC por um túnel do Synsema (endereço fixo, inicia com o PC) ou ao seu VPS pelo seu próprio domínio. --- # No celular O Lampson roda no seu PC ou no seu servidor; o celular é o controle remoto. Ele se instala como app (PWA), você entra com a digital ou o rosto, e vê e usa seus espaços de trabalho como no navegador do PC. ## 1. Fazer o celular chegar ao Lampson O celular precisa de um endereço **https** que chegue ao hub (`127.0.0.1:8080`). Escolha um: | | Para quem | Endereço | |---|---|---| | **Túnel do Synsema** | seu PC de casa, recomendado | fixo, `…-tunnel.synsema.app`; inicia com o PC | | **Túnel rápido** | testar em 1 minuto | muda a cada início | | **Túnel persistente** | seu PC de casa, todo dia | fixo, no seu domínio | | **Domínio próprio** | um VPS com IP público | fixo, no seu domínio | ### Túnel do Synsema (recomendado) O Lampson roda sobre o Synsema, e a plataforma Synsema tem túneis: seu PC num endereço **fixo** `https://-tunnel.synsema.app`, sem abrir portas, sem mexer em DNS e sem domínio próprio. O PC abre uma única conexão de saída e tudo chega por ela: páginas, eventos ao vivo e o terminal (WebSocket). **1.** Instale o CLI da plataforma, `syn`, e entre na conta (uma vez por computador; o plano gratuito basta): ```sh curl -fsSL https://synsema.com/cli/install.sh | sh # macOS, Linux irm https://synsema.com/cli/install.ps1 | iex # Windows (PowerShell) syn login # syn signup se você ainda não tem conta ``` **2.** Coloque o hub nesse endereço e deixe o PC mantê-lo no ar: ```sh syn tunnel 8080 --name lampson --service ``` Ele mostra o endereço, que é sempre o mesmo para este PC e o nome `lampson`. Com `--service` o túnel **inicia junto com o computador**, sem terminal aberto: a pasta Inicializar no Windows (ao entrar na sessão), uma unit do systemd no Linux, um LaunchAgent no macOS. Sem `--service` ele vive enquanto o terminal estiver aberto. **3.** Faça o hub também iniciar sozinho: `lampson --install`. **4.** Pareie o celular pelo terminal: `lampson --pair https://-tunnel.synsema.app` (ou pelo PC, passo 2 abaixo). - O endereço não muda, então a passkey continua valendo depois de reiniciar. - Se o PC estiver desligado, o endereço responde `503` com `X-Synsema-Tunnel: offline`, e o app mostra «Tu PC no responde» no lugar. - `syn tunnel service list` mostra os túneis mantidos no ar e o último estado; `syn tunnel service remove lampson` para o túnel (o endereço continua seu); `syn tunnel release lampson` libera o endereço. Log: `~/.synsema/tunnels/lampson.log`. - Planos: Free tem 3 endereços e 5 GB por mês, e um navegador vê uma página de aviso na primeira vez que abre o endereço (aceite uma vez; as requisições do próprio app nunca a veem). Pro não tem aviso e permite um nome próprio: `--subdomain meulampson` → `https://meulampson.synsema.app` — um nome novo é outro domínio para a passkey, então pareie de novo. - Faça o túnel para o hub (`8080`), nunca para a porta de um espaço de trabalho: é o hub que pede a passkey. ### Túnel rápido (para testar) Instale o [cloudflared](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/) (no Windows: `winget install Cloudflare.cloudflared`) e rode: ```sh cloudflared tunnel --url http://localhost:8080 ``` Ele mostra um endereço `https://….trycloudflare.com`. Não precisa de conta nem de domínio. O endereço muda toda vez que você inicia de novo, e a passkey fica presa ao endereço: quando ele muda, é preciso parear de novo. ### Túnel persistente (seu PC, sempre) Para um endereço fixo que sobrevive a reinícios. Você precisa de uma conta gratuita da Cloudflare com o seu domínio adicionado (a Cloudflare administra o DNS). **1.** No painel da Cloudflare: **Zero Trust → Networks → Tunnels → Create a tunnel**, tipo *Cloudflared*, nome `lampson`. **2.** Copie o comando de instalação que ele mostra e rode no seu PC. Ele instala o túnel como serviço do sistema, então inicia junto com o PC: ```sh cloudflared service install # Windows: num terminal como administrador sudo cloudflared service install # Linux ``` **3.** Em **Public Hostname** adicione: subdomínio `lampson`, seu domínio, serviço `HTTP` → `localhost:8080`. **4.** Faça o hub iniciar sozinho também: `lampson --install` (no Windows, ao entrar na sessão). Seu endereço fica `https://lampson.seudominio.com`. Se o PC estiver desligado, o app avisa («Tu PC no responde») em vez de mostrar a página de erro do túnel. Se preferir o terminal ao painel da Cloudflare: ```sh cloudflared tunnel login cloudflared tunnel create lampson cloudflared tunnel route dns lampson lampson.seudominio.com cloudflared tunnel run --url http://localhost:8080 lampson ``` ### Domínio próprio (VPS) Se o Lampson roda num servidor com IP público, não precisa de túnel: o Synsema serve o seu domínio com HTTPS diretamente. ```sh lampson --domain lampson.seudominio.com --email voce@seudominio.com ``` Detalhes e requisitos em [Docker e servidores](/pt/docs/deploy). ## 2. Parear o celular **1.** No PC, abra `http://127.0.0.1:8080` → **dispositivos** → *emparejar dispositivo*. **2.** Cole o endereço https (o túnel ou o seu domínio; com `--domain` ele já está preenchido) e toque em **Generar QR**. **3.** Leia o QR com a câmera do celular e toque em **Crear passkey**: digital, rosto ou o bloqueio de tela. O QR vale 5 minutos e funciona uma única vez. A passkey fica no celular (ou no seu gerenciador de senhas, como o do Google ou do iCloud). O Lampson guarda só a chave pública. ### Num VPS: pelo terminal Num servidor não há navegador para abrir `127.0.0.1:8080`, e o pareamento só pode começar pela própria máquina (de propósito: ninguém consegue parear só entrando no seu domínio). Entre por SSH e rode: ```sh lampson --pair ``` Aparece um **QR no terminal**: aponte a câmera do celular e toque em **Crear passkey**. Vale 5 minutos e serve uma única vez; embaixo fica o link, caso prefira abri-lo à mão. Com `--domain` o endereço já está configurado; senão, passe-o: `lampson --pair https://seu-dominio`. Funciona também no seu PC, com um túnel. Se o endereço salvo não responder — por exemplo um túnel do cloudflare que você já fechou: cada um vem com um endereço novo —, ele avisa em vez de mostrar um QR que não levaria a lugar nenhum. Outra forma, sem `--pair`: um túnel SSH (`ssh -L 8080:127.0.0.1:8080 usuario@seu-vps`) e abrir `http://127.0.0.1:8080` no seu PC — o servidor enxerga como local e os passos acima funcionam como estão. ## 3. Instalar como app - **Android (Chrome, Edge, Samsung):** menu ⋮ → *Instalar app*. - **iPhone / iPad (Safari):** Compartilhar → *Adicionar à Tela de Início*. ## Sessões e acesso - O próprio PC entra sem nada, como sempre. Todo o resto — túnel, rede local, domínio — precisa de um dispositivo pareado. - Outro site nunca consegue usar o seu Lampson, nem a partir de um navegador no PC: uma requisição de outra origin é recusada (isso cobre uma página que tente chegar a `127.0.0.1:8080`, terminal incluído). - Use um túnel HTTP (Synsema, cloudflared) para o hub. Um encaminhamento TCP cru (`ssh -R`, `ngrok tcp`) não deixa rastro de onde vem o visitante, então o Lampson não conseguiria distingui-lo do PC. - A sessão se renova sozinha enquanto você usa: expira depois de **30 dias sem uso**, e a passkey é pedida de novo a cada **90 dias** de qualquer forma. - Em **dispositivos** você vê os pareados, muda o nome, encerra a sessão ou remove um; remover o deixa de fora na hora. - Se o endereço mudar (outro túnel rápido, outro domínio), é preciso parear de novo: a passkey fica presa ao endereço.