서버의 모든 프로젝트는 고유한 주소와 신뢰할 수 있는 HTTPS를 갖춘 사이트가 됩니다.
사이트 주소
각 프로젝트는 https://<name>.dev.test 주소를 받습니다. 인증서는 노트북이 신뢰하므로 브라우저에 경고가 표시되지 않으며, 노트북이 테일넷에 연결된 곳이라면 어디서나 주소가 동작합니다.
PHP
- 7.4부터 8.5까지 모든 PHP 버전을 사이트별로 선택할 수 있습니다.
- 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 설정, 목록에 없는 것을 실행하는 방법은 서비스에서 확인하세요.
프로젝트 추가
프로젝트는 세 가지 방법으로 추가할 수 있습니다.
- AI 에이전트에게 요청: 에이전트가 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 | 웹, Android, iOS용 Flutter 앱, 라이브 웹 미리보기 포함; Dart HTTP 서버(shelf) |
모바일 레시피(Ionic, Expo, Flutter)는 앱의 웹 미리보기를 서버에서 실행하며, Android와 iOS 빌드는 노트북에서 이루어집니다. 테일넷에 있는 휴대폰의 Expo Go로 서버에서 Expo 프로젝트를 바로 열 수도 있습니다.
- 패널에서: 서버에서 서버를 열고 레시피 탭으로 이동해 레시피의 프로젝트 만들기를 선택하거나, 프로젝트 추가에서 유형으로 선택하세요. 그러면 프로젝트가 프로젝트 탭에 표시됩니다.
- 서버에서:
rdev project recipes로 목록을 확인하고,rdev project add web --recipe nextjs로 시작합니다. - 에이전트에서: 프로젝트를 추가하는 MCP 도구는
recipe를 받으므로 "api라는 이름의 Django 프로젝트를 시작해 줘"라고 요청할 수 있습니다.
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 프로젝트 또는 레시피 중 하나입니다. 서버는 약 5분 안에 요청을 가져가며, 대시보드에 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를 추가하면 노트북과 tailnet의 모든 기기에서https://store.dev.test로 같은 사이트가 열립니다. 마침표를 쓰면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_ 설정을 제거하면 앱이 동작하지 않을 수 있습니다.