Mỗi dự án trên máy chủ của bạn trở thành một site với địa chỉ riêng và HTTPS đáng tin cậy.
Địa chỉ site
Mỗi dự án nhận https://<name>.dev.test. Chứng chỉ được laptop của bạn tin cậy, nên trình duyệt không hiện cảnh báo, và địa chỉ hoạt động ở bất cứ đâu laptop của bạn kết nối với tailnet.
PHP
- Mọi phiên bản PHP từ 7.4 đến 8.5, chọn theo từng site.
- Laravel và WordPress được hỗ trợ hạng nhất.
- Các framework PHP khác và dự án PHP thuần cũng được hỗ trợ.
- Các phần mở rộng như
mongodbvàxdebugđược cài bằng một lệnh; xem Phần mở rộng PHP.
Các ngôn ngữ khác
Các dự án Python, Ruby, Node.js, Go, .NET, Java và Flutter được hỗ trợ. Không có runtime ngôn ngữ nào được cài đặt theo mặc định: khi bạn thêm một dự án bằng một trong các ngôn ngữ này, rdev cài runtime nó cần vào lúc đó, và dùng lại cho các dự án sau.
Điều này giữ môi trường nhỏ gọn, và các runtime bạn không bao giờ dùng sẽ không cần cập nhật.
Cơ sở dữ liệu và dịch vụ
Mỗi dự án có thể dùng MySQL, MariaDB, PostgreSQL, MongoDB, Redis, Meilisearch, Typesense hoặc RustFS ở phiên bản bạn chọn, cùng bắt thư và máy chủ dump. Mỗi dịch vụ dùng để làm gì, các phiên bản, cài đặt .env và cách chạy thứ không có trong danh sách nằm ở Dịch vụ.
Thêm một dự án
Bạn có thể thêm một dự án theo ba cách:
- bằng cách nhờ AI agent của bạn, agent tạo site thông qua quyền truy cập MCP của nó;
- bằng công cụ dòng lệnh
rdevtrên máy chủ; - từ bảng điều khiển web.
Bất kỳ thư mục nào bạn tạo trong ~/Code được phục vụ ngay tại https://<folder>.dev.test, nên chỉ cần clone một dự án PHP vào đó là đủ.
Recipe: bắt đầu từ một framework
Một recipe bắt đầu một dự án mới từ một framework trong thư mục ~/Code/<name> trống: rdev cài ngôn ngữ, chạy trình cài đặt riêng của framework, đặt lệnh máy chủ phát triển và phục vụ ứng dụng tại https://<name>.dev.test.
| Ngôn ngữ | Recipe |
|---|---|
| PHP | Laravel và WordPress (tích hợp sẵn), Symfony, Statamic, CodeIgniter, CakePHP, Drupal |
| Node.js | Next.js, Nuxt, Astro, SvelteKit, React, Vue, Angular, Ionic (với Capacitor), Expo (React Native), NestJS, Express, một dự án Node.js trống |
| Python | Django, Flask, FastAPI, một dự án Python trống (mỗi dự án trong .venv riêng) |
| Ruby | Ruby on Rails, Sinatra, một dự án Rack trống |
| Go | Gin, Echo, Fiber, một module Go trống |
| .NET | ASP.NET Core Web API, Blazor, một ứng dụng ASP.NET Core trống |
| Java | Spring Boot, Quarkus, Micronaut, một dự án Java trống |
| Flutter | Một ứng dụng Flutter cho web, Android và iOS, kèm bản xem trước web trực tiếp; một máy chủ HTTP Dart (shelf) |
Các recipe di động (Ionic, Expo và Flutter) chạy bản xem trước web của ứng dụng trên máy chủ; bản build Android và iOS diễn ra trên laptop của bạn. Expo Go trên một điện thoại nằm trong tailnet của bạn cũng có thể mở thẳng một dự án Expo từ máy chủ.
- Trên bảng điều khiển: mở máy chủ trong Máy chủ, vào tab Recipe và chọn Tạo dự án trên một recipe, hoặc chọn nó làm loại trong Thêm dự án. Sau đó dự án hiện ra trong tab Dự án.
- Trên máy chủ:
rdev project recipesliệt kê chúng;rdev project add web --recipe nextjsbắt đầu một recipe. - Từ một agent: công cụ MCP thêm dự án nhận một
recipe, nên bạn có thể yêu cầu "bắt đầu một dự án Django tên là api".
Django và Rails được thiết lập để chấp nhận các địa chỉ *.dev.test; các máy chủ phát triển dựa trên Vite (Nuxt, Astro, SvelteKit) cũng được cho phép chúng. Các recipe đến từ một danh mục do rdev ký, và máy chủ từ chối danh mục có chữ ký không khớp, nên các framework mới đến mà không cần cập nhật rdev. Recipe cần rdev 0.2.0-beta.38 trở lên.
Với dòng lệnh
-
Clone một kho và phục vụ nó như một dự án:
rdev project add shop --git [email protected]:you/shop.git -
Bắt đầu một dự án Python trống cùng runtime của nó:
rdev project add api --lang python -
Phục vụ một site bằng phiên bản PHP khác:
rdev use shop 8.3Trong bảng điều khiển, nhấn vào dự án trong cột Dự án của thẻ PHP của máy chủ (Phần mở rộng PHP).
rdev project list hiển thị các dự án của bạn, rdev project start|stop|logs <name> điều khiển máy chủ phát triển của một dự án không phải PHP, và rdev project remove <name> xóa một dự án (các tệp của nó vẫn còn trừ khi bạn thêm --delete-files).
Từ bảng điều khiển
Bạn cũng có thể thêm một dự án mà không cần mở terminal: mở máy chủ trong Máy chủ và chọn Thêm trên tab Dự án của nó, hoặc chọn Thêm dự án cạnh một máy chủ trên bảng điều khiển; đặt tên và chọn một loại: một ứng dụng Laravel mới, một site WordPress mới, một bản clone của kho git, một dự án PHP trống hoặc một trong các recipe. Máy chủ nhận yêu cầu trong khoảng năm phút và bảng điều khiển cho biết khi nào nó sẵn sàng tại https://<name>.dev.test. Bảng Thêm từ bảng điều khiển trên bảng điều khiển liệt kê từng dự án và dịch vụ bạn đã yêu cầu, cùng máy chủ, trạng thái và, khi có lỗi, lý do. rdev không bao giờ kết nối đến máy chủ của bạn cho việc này; máy chủ của bạn tự hỏi các yêu cầu của nó. Với kho git, bạn cũng có thể chọn ngôn ngữ (PHP, Node.js, Python, Ruby, Go, .NET hoặc Java); để Tự động nhận diện, server sẽ dựa vào các tệp trong kho. Nếu lựa chọn và tệp không khớp, server dùng lựa chọn của bạn và ghi rõ trong trạng thái dự án.
Tab Dự án liệt kê mọi dự án mà máy chủ báo cáo, cùng địa chỉ của chúng, và những dự án bạn đã yêu cầu mà vẫn đang trên đường hoặc thất bại, kèm lý do.
Sửa lỗi, xóa và alias
Menu ⋯ của một dự án trong tab Dự án:
- Sửa và thử lại (dự án thiết lập thất bại): biểu mẫu mở ra với những gì bạn đã yêu cầu, chẳng hạn URL kho mã hoặc công thức. Hãy sửa rồi gửi lại. Xóa khỏi danh sách ẩn yêu cầu thất bại.
- Sửa và cài đặt lại (dự án trên máy chủ): thư mục của dự án bị xóa và dự án được thiết lập lại từ đầu, với loại bạn chọn. Dữ liệu của nó được giữ lại, nên dự án mới tìm thấy dữ liệu đó, trừ khi bạn chọn Xóa cả cơ sở dữ liệu của dự án (xem bên dưới để biết nó xóa những gì). Hãy commit và push công việc của bạn trước: các tệp không có trong git sẽ mất.
- Xóa, giữ dữ liệu xóa thư mục của dự án trong
~/Code, trang web và máy chủ phát triển của nó; các cơ sở dữ liệu và tệp trong bộ lưu trữ vẫn còn. Xóa hoàn toàn, cả dữ liệu còn xóa dữ liệu của dự án: các cơ sở dữ liệu MySQL, MariaDB, PostgreSQL và MongoDB mang tên dự án (my-shopdùngmy_shop) và bucket RustFS của nó (my-shop) cùng mọi tệp đã tải lên đó. - Thêm alias cho dự án một địa chỉ khác: alias
storekhiếnhttps://store.dev.testmở cùng một trang web, trên laptop của bạn và mọi thiết bị trong tailnet của bạn. Dấu chấm tạo địa chỉ con nhưapi.shop. Các alias hiển thị bên dưới dự án; nhấn × trên một alias để xóa nó.
Máy chủ thực hiện mỗi thao tác trong vài giây; việc này cần rdev 1.0.3 trở lên, và 1.0.4 trở lên để xóa dữ liệu MongoDB và RustFS. Trên chính máy chủ, rdev domain add <name> store.dev.test thêm một alias, và rdev project remove <name> --delete-files xóa một dự án tạo bằng rdev project add (với trang Laravel hoặc WordPress, hãy xóa thư mục của nó).
Trước khi xóa dữ liệu, hãy biết nó ảnh hưởng đến những gì:
- Không thể hoàn tác. Bản sao lưu hằng đêm ở Pro và Team có các cơ sở dữ liệu, nên bạn có thể khôi phục chúng từ bảng điều khiển; nó không có các bucket RustFS, nên các tệp đã tải lên mất vĩnh viễn. Hãy tải về những gì bạn cần trước.
- Xóa theo tên, không theo chủ sở hữu. rdev xóa cơ sở dữ liệu và bucket mang tên dự án. Nếu
.envcủa dự án khác trỏ tới cùng cơ sở dữ liệu hoặc bucket, dự án đó cũng mất dữ liệu. - Dịch vụ đã dừng vẫn giữ dữ liệu của nó. rdev chỉ xóa trong các dịch vụ đang chạy và cho biết dịch vụ nào đã bỏ qua; hãy khởi động chúng rồi chạy lại việc xóa, hoặc tự xóa dữ liệu.
- Với gói Team, môi trường của mỗi thành viên có các dịch vụ riêng; xóa một dự án trong môi trường của bạn không bao giờ động đến các dịch vụ dùng chung của chủ sở hữu.
Thêm một dịch vụ vào dự án
Một dự án có thể nhận thêm một dịch vụ sau, khi nó cần:
rdev project service shop postgres
Trong bảng điều khiển, chọn Thêm dịch vụ trên một dự án hoặc cạnh một máy chủ. Việc chọn phiên bản, cài đặt .env và phần còn lại nằm ở Dịch vụ.
Biến môi trường từ bảng điều khiển
Để đặt một API key hoặc bí mật khác mà không cần mở terminal, hãy mở máy chủ từ Máy chủ trên thanh bên và dùng Biến môi trường: chọn dự án, nhập tên và giá trị trong Thêm hoặc thay đổi, rồi chọn Mã hóa và lưu. Máy chủ ghi nó vào .env của dự án trong vài giây.
Các giá trị được mã hóa trong trình duyệt của bạn bằng khóa riêng của máy chủ, nên rdev.cloud không bao giờ thấy chúng và không thể hiển thị lại sau này. Hiện trong .env chỉ liệt kê các tên. Để đổi một giá trị, hãy nhấn vào tên của nó: nó chuyển sang Thêm hoặc thay đổi, nơi bạn gõ giá trị mới. Nhấn × trên một tên để xóa nó; xóa APP_KEY hoặc các cài đặt DB_ thường làm hỏng ứng dụng.