Введите не менее двух букв, чтобы искать по всем страницам документации.

↑ ↓ для навигации ↵ чтобы открыть esc чтобы закрыть

Работа с rdev

Проекты и сайты

Каждый проект на вашем сервере становится сайтом с собственным адресом и доверенным HTTPS.

Адреса сайтов

Каждый проект получает адрес https://<name>.dev.test. Сертификат пользуется доверием вашего ноутбука, поэтому браузер не показывает предупреждений, а адрес работает везде, где ваш ноутбук подключён к вашему tailnet.

PHP

  • Любая версия PHP от 7.4 до 8.5, выбирается для каждого сайта.
  • Laravel и WordPress поддерживаются в первую очередь.
  • Другие PHP-фреймворки и обычные PHP-проекты тоже поддерживаются.
  • Расширения, такие как mongodb и xdebug, устанавливаются одной командой; см. Расширения PHP.

Другие языки

Проекты на Python, Ruby, Node.js, Go, .NET, Java и Flutter поддерживаются. Среды выполнения языков по умолчанию не устанавливаются: когда вы добавляете проект на одном из этих языков, rdev в этот момент устанавливает нужную среду выполнения и повторно использует её для следующих проектов.

Так окружение остаётся компактным, а средам выполнения, которыми вы не пользуетесь, не нужны обновления.

Базы данных и сервисы

Каждый проект может использовать MySQL, MariaDB, PostgreSQL, MongoDB, Redis, Meilisearch, Typesense или RustFS в выбранной вами версии, а также перехват почты и dump-сервер. Для чего нужен каждый из них, версии, настройки .env и как запустить то, чего нет в списке, описано в разделе Сервисы.

Добавление проекта

Проект можно добавить тремя способами:

  • попросив вашего ИИ-агента, который создаёт сайты через свой доступ по MCP;
  • с помощью инструмента командной строки rdev на сервере;
  • из веб-панели.

Любая папка, которую вы создаёте в ~/Code, сразу обслуживается как https://<folder>.dev.test, так что достаточно клонировать туда PHP-проект.

Рецепты: запуск проекта из фреймворка

Рецепт запускает новый проект на основе фреймворка в пустой папке ~/Code/<name>: rdev устанавливает язык, запускает собственный установщик фреймворка, задаёт команду сервера разработки и публикует приложение по адресу https://<name>.dev.test.

Язык Рецепты
PHP Laravel и WordPress (встроены), Symfony, Statamic, CodeIgniter, CakePHP, Drupal
Node.js Next.js, Nuxt, Astro, SvelteKit, React, Vue, Angular, Ionic (с Capacitor), Expo (React Native), NestJS, Express, пустой проект Node.js
Python Django, Flask, FastAPI, пустой проект Python (каждый в собственном .venv)
Ruby Ruby on Rails, Sinatra, пустой проект Rack
Go Gin, Echo, Fiber, пустой модуль Go
.NET ASP.NET Core Web API, Blazor, пустое приложение ASP.NET Core
Java Spring Boot, Quarkus, Micronaut, пустой проект на Java
Flutter Приложение Flutter для веба, Android и iOS с живым веб-превью; HTTP-сервер на Dart (shelf)

Мобильные рецепты (Ionic, Expo и Flutter) запускают веб-превью приложения на сервере; сборки под Android и iOS выполняются на вашем ноутбуке. Expo Go на телефоне, который находится в вашем tailnet, тоже может открыть проект Expo прямо с сервера.

  • В панели: откройте сервер в разделе Серверы, перейдите на вкладку Рецепты и выберите Создать проект у рецепта либо выберите его как тип в Добавить проект. Затем проект появится на вкладке Проекты.
  • На сервере: rdev project recipes выводит их список; rdev project add web --recipe nextjs запускает один из них.
  • Из агента: инструмент MCP, добавляющий проекты, принимает recipe, так что можно попросить «запусти проект Django с именем api».

Django и Rails настроены принимать адреса *.dev.test; серверам разработки на базе Vite (Nuxt, Astro, SvelteKit) они тоже разрешены. Рецепты берутся из каталога, подписанного rdev, а сервер отвергает каталог, подпись которого не проходит проверку, поэтому новые фреймворки появляются без обновления rdev. Для рецептов нужен rdev 0.2.0-beta.38 или новее.

Из командной строки

  • Клонировать репозиторий и опубликовать его как проект:

    rdev project add shop --git [email protected]:you/shop.git
    
  • Запустить пустой проект Python вместе со средой выполнения:

    rdev project add api --lang python
    
  • Опубликовать сайт на другой версии PHP:

    rdev use shop 8.3
    

    В панели нажмите на проект в столбце Проекты карточки PHP сервера (Расширения PHP).

rdev project list показывает ваши проекты, rdev project start|stop|logs <name> управляет сервером разработки проекта не на PHP, а rdev project remove <name> удаляет проект (его файлы остаются, если не добавить --delete-files).

Из панели

Проект можно добавить и не открывая терминал: откройте сервер в разделе Серверы и выберите Добавить на вкладке Проекты либо выберите Добавить проект рядом с сервером на дашборде; задайте название и выберите тип: новое приложение Laravel, новый сайт WordPress, клон git-репозитория, пустой PHP-проект или один из рецептов. Сервер подхватывает запрос примерно за пять минут, а дашборд показывает, когда проект готов по адресу https://<name>.dev.test. Таблица Добавлено из панели на дашборде перечисляет каждый запрошенный вами проект и сервис с его сервером, статусом и, если что-то не удалось, причиной. rdev никогда не подключается для этого к вашему серверу; ваш сервер сам запрашивает свои заявки. Для git-репозитория можно также выбрать язык (PHP, Node.js, Python, Ruby, Go, .NET или Java); при Определить автоматически сервер определит его по файлам репозитория. Если выбор не совпадает с файлами, сервер использует ваш выбор и сообщает об этом в статусе проекта.

Вкладка Проекты перечисляет каждый проект, о котором сообщает сервер, с его адресом, а также запрошенные вами проекты, которые ещё в пути или завершились ошибкой, с причиной.

Исправление, удаление и псевдонимы

Меню ⋯ у проекта на вкладке Проекты:

  • Изменить и повторить (проект, который не удалось настроить): форма открывается с вашим запросом, например с URL репозитория или рецептом. Исправьте его и отправьте снова. Убрать из списка скрывает неудавшийся запрос.
  • Изменить и переустановить (проект на сервере): папка проекта удаляется, и проект настраивается заново с нуля с выбранным вами типом. Его данные сохраняются, поэтому новый проект находит их, если только вы не отметите Также удалить его базы данных (что при этом удаляется, описано ниже). Сначала сделайте commit и push своей работы: файлы, которых нет в git, будут потеряны.
  • Удалить, сохранить данные удаляет папку проекта в ~/Code, его сайт и сервер разработки; базы данных и файлы в хранилище остаются. Удалить полностью, с данными также удаляет данные проекта: базы данных MySQL, MariaDB, PostgreSQL и MongoDB с его именем (my-shop использует my_shop) и его бакет RustFS (my-shop) со всеми загруженными в него файлами.
  • Добавить псевдоним даёт проекту ещё один адрес: псевдоним store делает так, что https://store.dev.test открывает тот же сайт, на вашем ноутбуке и на каждом устройстве в вашем tailnet. Точки создают подадреса, например api.shop. Псевдонимы показаны под проектом; × у псевдонима удаляет его.

Сервер выполняет каждое действие за несколько секунд; для этого нужен rdev 1.0.3 или новее, а для удаления данных MongoDB и RustFS — 1.0.4. На самом сервере rdev domain add <name> store.dev.test добавляет псевдоним, а rdev project remove <name> --delete-files удаляет проект, созданный командой rdev project add (для сайта Laravel или WordPress удалите его папку).

Прежде чем удалять данные, узнайте, что это затронет:

  • Это нельзя отменить. Ночная резервная копия в Pro и Team содержит базы данных, так что их можно восстановить из панели; бакетов RustFS в ней нет, поэтому загруженные файлы пропадают навсегда. Сначала скачайте то, что вам нужно.
  • Удаляется по имени, а не по владельцу. rdev удаляет базу данных и бакет с именем проекта. Если .env другого проекта указывает на ту же базу данных или тот же бакет, этот проект тоже потеряет свои данные.
  • Остановленный сервис сохраняет свои данные. rdev удаляет данные только в запущенных сервисах и сообщает, какие пропустил; запустите их и повторите удаление или удалите данные сами.
  • В тарифе Team у среды каждого участника свои сервисы; удаление проекта в вашей среде никогда не затрагивает общие сервисы владельца.

Добавление сервиса к проекту

Проект может получить сервис позже, когда он понадобится:

rdev project service shop postgres

В панели выберите Добавить сервис у проекта или рядом с сервером. Выбор версии, настройки .env и остальное описаны в разделе Сервисы.

Переменные окружения из панели

Чтобы задать API-ключ или другой секрет, не открывая терминал, откройте сервер в разделе Серверы на боковой панели и воспользуйтесь Переменными окружения: выберите проект, введите имя и значение в разделе Добавить или изменить и выберите Зашифровать и сохранить. Сервер записывает его в .env проекта за секунды.

Значения шифруются в вашем браузере ключом вашего сервера, поэтому rdev.cloud никогда их не видит и не сможет показать позже. В разделе Сейчас в .env перечислены только имена. Чтобы изменить значение, нажмите на его имя: оно переместится в Добавить или изменить, где вы вводите новое значение. Нажмите × у имени, чтобы удалить переменную; удаление APP_KEY или настроек DB_ обычно ломает приложение.