Кожен проєкт на вашому сервері стає сайтом із власною адресою та довіреним 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 у вибраній вами версії, а також перехоплення пошти та сервер дампів. Для чого кожен із них, їхні версії, налаштування .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_ зазвичай ламає застосунок.