至少输入两个字母,即可搜索文档的所有页面。

↑ ↓ 导航 ↵ 打开 esc 关闭

使用 rdev

项目和站点

服务器上的每个项目都会成为拥有自己地址和受信任 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_ 设置通常会导致应用出错。