Cada projeto no seu servidor se torna um site com o próprio endereço e HTTPS confiável.
Endereços dos sites
Cada projeto recebe https://<name>.dev.test. O certificado é confiável para o seu laptop, então o navegador não mostra avisos, e o endereço funciona em qualquer lugar em que o seu laptop esteja conectado à sua tailnet.
PHP
- Todas as versões do PHP, de 7.4 a 8.5, escolhidas por site.
- Laravel e WordPress são cidadãos de primeira classe.
- Outros frameworks PHP e projetos PHP simples também são suportados.
- Extensões como
mongodbexdebugsão instaladas com um comando; veja Extensões do PHP.
Outras linguagens
Projetos Python, Ruby, Node.js, Go, .NET, Java e Flutter são suportados. Nenhum runtime de linguagem é instalado por padrão: quando você adiciona um projeto em uma dessas linguagens, o rdev instala o runtime de que ele precisa naquele momento e o reutiliza nos projetos seguintes.
Isso mantém o ambiente pequeno, e os runtimes que você nunca usa não precisam de atualizações.
Bancos de dados e serviços
Todo projeto pode usar MySQL, MariaDB, PostgreSQL, MongoDB, Redis, Meilisearch, Typesense ou RustFS na versão que você escolher, mais captura de e-mails e um servidor de dump. Para que serve cada um, as versões, as configurações do .env e como executar algo que não está na lista, veja Serviços.
Adicionando um projeto
Você pode adicionar um projeto de três maneiras:
- pedindo ao seu agente de IA, que cria sites pelo acesso MCP dele;
- com a ferramenta de linha de comando
rdevno servidor; - pelo painel web.
Qualquer pasta que você criar em ~/Code é servida na hora como https://<folder>.dev.test, então clonar um projeto PHP ali já basta.
Recipes: começando a partir de um framework
Uma recipe inicia um novo projeto a partir de um framework em uma pasta ~/Code/<name> vazia: o rdev instala a linguagem, executa o instalador do próprio framework, define o comando do servidor de desenvolvimento e serve o app em https://<name>.dev.test.
| Linguagem | Recipes |
|---|---|
| PHP | Laravel e WordPress (nativos), Symfony, Statamic, CodeIgniter, CakePHP, Drupal |
| Node.js | Next.js, Nuxt, Astro, SvelteKit, React, Vue, Angular, Ionic (com Capacitor), Expo (React Native), NestJS, Express, um projeto Node.js vazio |
| Python | Django, Flask, FastAPI, um projeto Python vazio (cada um no próprio .venv) |
| Ruby | Ruby on Rails, Sinatra, um projeto Rack vazio |
| Go | Gin, Echo, Fiber, um módulo Go vazio |
| .NET | ASP.NET Core Web API, Blazor, um app ASP.NET Core vazio |
| Java | Spring Boot, Quarkus, Micronaut, um projeto Java vazio |
| Flutter | Um app Flutter para web, Android e iOS, com pré-visualização web ao vivo; um servidor HTTP em Dart (shelf) |
As recipes mobile (Ionic, Expo e Flutter) executam a pré-visualização web do app no servidor; os builds para Android e iOS acontecem no seu laptop. O Expo Go em um celular que esteja na sua tailnet também pode abrir um projeto Expo direto do servidor.
- No painel: abra o servidor em Servidores, vá para a aba Recipes e escolha Criar projeto em uma recipe, ou escolha-a como tipo em Adicionar projeto. O projeto então aparece na aba Projetos.
- No servidor:
rdev project recipesas lista;rdev project add web --recipe nextjsinicia uma. - Por um agente: a ferramenta MCP que adiciona projetos aceita uma
recipe, então você pode pedir "inicie um projeto Django chamado api".
O Django e o Rails são configurados para aceitar endereços *.dev.test; os servidores de desenvolvimento baseados em Vite (Nuxt, Astro, SvelteKit) também os permitem. As recipes vêm de um catálogo assinado pelo rdev, e o servidor recusa um catálogo cuja assinatura não confere, então novos frameworks chegam sem uma atualização do rdev. As recipes exigem o rdev 0.2.0-beta.38 ou posterior.
Pela linha de comando
-
Clone um repositório e sirva-o como projeto:
rdev project add shop --git [email protected]:you/shop.git -
Inicie um projeto Python vazio com o runtime dele:
rdev project add api --lang python -
Sirva um site com outra versão do PHP:
rdev use shop 8.3No painel, clique no projeto na coluna Projetos do card PHP do servidor (Extensões do PHP).
O rdev project list mostra os seus projetos, o rdev project start|stop|logs <name> controla o servidor de desenvolvimento de um projeto que não é PHP, e o rdev project remove <name> remove um (os arquivos dele permanecem, a menos que você adicione --delete-files).
Pelo painel
Você também pode adicionar um projeto sem abrir um terminal: abra o servidor em Servidores e escolha Adicionar na aba Projetos dele, ou escolha Adicionar projeto ao lado de um servidor no painel; dê um nome e escolha um tipo: um novo app Laravel, um novo site WordPress, um clone de um repositório git, um projeto PHP vazio ou uma das recipes. O servidor recebe a solicitação em cerca de cinco minutos e o painel mostra quando ele está pronto em https://<name>.dev.test. A tabela Adicionado pelo painel no painel lista cada projeto e serviço que você pediu, com o servidor, o status e, quando algo falhou, o motivo. O rdev nunca se conecta ao seu servidor para isso; o seu servidor é quem pede as solicitações. Para um repositório git você também pode escolher a linguagem (PHP, Node.js, Python, Ruby, Go, .NET ou Java); em Detectar automaticamente, o servidor descobre pelos arquivos do repositório. Se sua escolha e os arquivos não baterem, o servidor usa sua escolha e avisa no status do projeto.
A aba Projetos lista todos os projetos que o servidor informa, com o endereço deles, e os que você pediu que ainda estão a caminho ou falharam, com o motivo.
Corrigir, remover e aliases
O menu ⋯ de um projeto na aba Projetos:
- Editar e tentar novamente (um projeto que falhou na configuração): o formulário abre com o que você pediu, por exemplo a URL do repositório ou a receita. Corrija e envie de novo. Remover da lista oculta a solicitação que falhou.
- Editar e reinstalar (um projeto no servidor): a pasta do projeto é excluída e ele é configurado novamente do zero, com o tipo que você escolher. Os dados dele são mantidos, então o novo projeto os encontra, a menos que você marque Excluir também os bancos de dados (veja abaixo o que isso exclui). Faça commit e push do seu trabalho antes: arquivos que não estão no git são perdidos.
- Remover, manter dados exclui a pasta do projeto em
~/Code, o site e o servidor de desenvolvimento; os bancos de dados e os arquivos no armazenamento ficam. Remover completamente, com dados também exclui os dados do projeto: os bancos de dados MySQL, MariaDB, PostgreSQL e MongoDB com o nome dele (my-shopusamy_shop) e o bucket do RustFS (my-shop) com todos os arquivos enviados a ele. - Adicionar alias dá ao projeto outro endereço: o alias
storefazhttps://store.dev.testabrir o mesmo site, no seu laptop e em todos os dispositivos da sua tailnet. Pontos criam subendereços comoapi.shop. Os aliases aparecem sob o projeto; o × em um deles o remove.
O servidor executa cada ação em poucos segundos; isso exige o rdev 1.0.3 ou posterior, e o 1.0.4 para excluir dados do MongoDB e do RustFS. No próprio servidor, rdev domain add <name> store.dev.test adiciona um alias e rdev project remove <name> --delete-files remove um projeto criado com rdev project add (para um site Laravel ou WordPress, exclua a pasta dele).
Antes de excluir dados, saiba o que isso alcança:
- Não pode ser desfeito. O backup noturno no Pro e no Team contém os bancos de dados, então você pode restaurá-los pelo painel; ele não contém os buckets do RustFS, então os arquivos enviados se perdem para sempre. Baixe antes o que você precisar.
- Vale o nome, não o dono. O rdev exclui o banco de dados e o bucket com o nome do projeto. Se o
.envde outro projeto aponta para o mesmo banco de dados ou bucket, esse projeto também perde seus dados. - Um serviço parado mantém seus dados. O rdev só exclui nos serviços em execução e informa quais pulou; inicie-os e execute a remoção de novo, ou exclua os dados você mesmo.
- Em um plano Team, o ambiente de cada membro tem seus próprios serviços; remover um projeto no seu nunca toca nos serviços compartilhados do proprietário.
Adicionando um serviço a um projeto
Um projeto pode receber um serviço depois, quando precisar de um:
rdev project service shop postgres
No painel, escolha Adicionar serviço em um projeto ou ao lado de um servidor. Escolher uma versão, as configurações do .env e o resto estão em Serviços.
Variáveis de ambiente pelo painel
Para definir uma chave de API ou outro segredo sem abrir um terminal, abra o servidor em Servidores na barra lateral e use Variáveis de ambiente: escolha o projeto, informe um nome e um valor em Adicionar ou alterar e escolha Criptografar e salvar. O servidor o grava no .env do projeto em segundos.
Os valores são criptografados no seu navegador com a chave do seu próprio servidor, então o rdev.cloud nunca os vê e não consegue exibi-los depois. Atualmente no .env lista apenas os nomes. Para alterar um valor, clique no nome dele: ele vai para Adicionar ou alterar, onde você digita o novo valor. Clique em × em um nome para removê-lo; remover o APP_KEY ou as configurações DB_ geralmente quebra o app.