服务器上的每个项目都会成为拥有自己地址和受信任 HTTPS 的站点。
站点地址
每个项目都有 https://<name>.dev.test。该证书受您的笔记本电脑信任,因此浏览器不会显示警告,并且只要笔记本电脑连接到您的 tailnet,该地址在任何地方都能使用。
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 | 面向 Web、Android 和 iOS 的 Flutter 应用,带实时 Web 预览;Dart HTTP 服务器(shelf) |
移动端配方(Ionic、Expo 和 Flutter)会在服务器上运行应用的 Web 预览;Android 和 iOS 构建则在您的笔记本电脑上进行。位于您的 tailnet 中的手机上的 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 项目,或某个配方。服务器会在大约五分钟内获取该请求,仪表盘会显示它何时在 https://<name>.dev.test 就绪。仪表盘上的从面板添加表格列出您请求的每个项目和服务,包括其服务器、状态,以及失败时的原因。rdev 绝不会为此连接您的服务器;是您的服务器来获取请求。 对于 git 仓库,还可以选择其语言(PHP、Node.js、Python、Ruby、Go、.NET 或 Java);保持 自动识别 时,服务器会根据仓库文件判断。若你的选择与文件不符,服务器按你的选择设置,并在项目状态中注明。
项目标签页列出服务器报告的每个项目及其地址,以及您请求的仍在进行中或已失败的项目(含原因)。
修复、移除和别名
项目 标签页中项目的 ⋯ 菜单:
- 编辑并重试(设置失败的项目):表单会带着您之前的请求打开,例如仓库 URL 或配方。修正后重新提交即可。从列表中移除 会隐藏失败的请求。
- 编辑并重新安装(服务器上的项目):项目文件夹会被删除,并按您选择的类型从头重新设置。其数据会保留,因此新项目能找到这些数据,除非您勾选 同时删除其数据库(删除的内容见下文)。请先提交并推送您的工作:不在 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_ 设置通常会导致应用出错。