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

↑ ↓ 导航 ↵ 打开 esc 关闭

使用 rdev

服务

数据库、缓存、搜索和文件存储运行在您的环境内,紧挨着您的站点。rdev 会在项目首次需要时安装每个服务(版本由您选择),保持其持续运行,并将连接设置写入项目的 .env。

有哪些可用

服务 用途 版本 默认端口
MySQL 关系型数据库 8.0, 8.4, 9.7 3306
MariaDB 关系型数据库 10.11, 11.4, 11.8, 12.3 3307
PostgreSQL 关系型数据库;-full 构建添加了 pgvector、PostGIS、pgRouting 以及(16 起)TimescaleDB 14, 15, 16, 17, 18 5432
MongoDB 文档数据库 7.0, 8.0, 9.0 27017
Redis 缓存、队列和会话 9.1 6379
Meilisearch 全文搜索,适用于 Laravel Scout 1 7700
Typesense 全文搜索,适用于 Laravel Scout 29, 30 8108
RustFS 兼容 S3 的文件存储,网页控制台位于下一个端口 1 9000
Elasticsearch 搜索和分析,适用于 Scout 驱动和 Elastic 客户端(不带机器学习运行) 8.19, 9 9200
Qdrant 向量搜索,适用于语义搜索等 AI 功能 1 6333
邮件捕获 捕获外发邮件,使其不会进入真实收件箱;SMTP 127.0.0.1:2525,在浏览器中访问 https://rdev-mail.dev.test 内置
转储服务器 收集来自您代码的调试转储;127.0.0.1:2304,在浏览器中访问 https://rdev-dumps.dev.test 内置

Redis 使用标准的 Redis 协议:Laravel 的 redis 驱动和 phpredis 无需修改即可使用。每个服务都只在您的环境内部的 127.0.0.1 上监听;RustFS 这类网页控制台请通过您的笔记本电脑连接访问。

在浏览器中查看捕获的邮件和转储

在您 tailnet 上的任意浏览器中打开 https://rdev-mail.dev.test,即可阅读您的应用发送的邮件。您会看到列表(最新的在前)、每封邮件的邮件头、纯文本和 HTML 版本以及附件。您可以删除单封或全部邮件,新邮件会自动出现。HTML 邮件显示时会阻止脚本和远程图片。

https://rdev-dumps.dev.test 按最新在前列出 dump() 调用和其他捕获的事件,并显示它们来自的文件和行号。使用 Clear 清空列表。

这两个页面都运行在您的服务器上,与您的项目一样只能通过您的 tailnet 访问。数据永远不会离开您的服务器,预览也永远无法将它们公开。rdev mail list 会打印这两个地址,笔记本电脑应用在 Sites 标签页的 Mail 和 Dumps 中打开它们。rdev-mail 和 rdev-dumps 这两个名称是保留的,因此项目不能使用它们。

在浏览器中管理数据库

https://rdev-adminer.dev.test 会在你的服务器上打开数据库管理工具 Adminer。选择 MySQL 或 PostgreSQL,服务器填 127.0.0.1,用户填 root(MySQL)或 postgres(PostgreSQL),密码留空;SQLite 则填写数据库文件的路径。和上面的页面一样,它只能通过你的 tailnet 打开,rdev-adminer 这个名称已被保留。rdev 1.2.0 起提供;更早安装的服务器请先运行 sudo rdev host update。

为项目添加服务

在服务器上,指明项目和服务:

rdev project service shop postgres

如果服务尚未运行,rdev 会安装并启动它,创建以项目命名的数据库(MySQL、MariaDB、PostgreSQL)或存储桶(RustFS),并将连接设置写入项目的 .env。没有 .env 的项目则会直接打印这些设置。MongoDB 会在您的代码首次写入时创建数据库;对于 PHP 项目,rdev 还会为站点使用的 PHP 版本安装 PHP mongodb 扩展(参见 PHP 扩展)。

当 Laravel 项目获得新的 MySQL、MariaDB 或 PostgreSQL 数据库时,rdev 还会运行 php artisan migrate --force,这样新应用存放会话、缓存和队列的表就已就位,站点能继续工作。它只对刚创建且仍为空的数据库执行此操作;已有的数据库保持原样。如果迁移失败,服务会保留,消息会告诉您原因,您可以自己运行 php artisan migrate。

在面板中,从侧边栏的服务器打开服务器,在其服务卡片中选择添加服务(顶部或某个项目旁边均可,仪表盘上也有同样的按钮),选择服务,对于有多个版本的服务,还要选择版本。项目所在行会显示服务器进行到哪一步:安装并启动服务、创建数据库、写入 .env、运行迁移。就绪时会有通知。首次安装服务可能需要几分钟。您的 AI 智能体也可以通过其 MCP 访问完成同样的操作;请它“为 shop 创建一个 PostgreSQL 数据库”即可。

新项目可以在同一条命令中获得其服务:

rdev project add shop --git [email protected]:you/shop.git --service mysql --service redis

.env 中会写入什么

服务 设置
MySQL、MariaDB、PostgreSQL DB_CONNECTION、DB_HOST、DB_PORT、DB_DATABASE、DB_USERNAME(没有密码:只有您的环境能访问它)
MongoDB MONGODB_URI、MONGODB_DATABASE,供 mongodb/laravel-mongodb 包使用
Redis REDIS_HOST、REDIS_PORT
Meilisearch SCOUT_DRIVER=meilisearch、MEILISEARCH_HOST
Typesense SCOUT_DRIVER=typesense、TYPESENSE_HOST、TYPESENSE_PORT、TYPESENSE_PROTOCOL、TYPESENSE_API_KEY
Elasticsearch ELASTICSEARCH_HOST(http://127.0.0.1:9200)和 ELASTIC_HOST(127.0.0.1:9200);没有 SCOUT_DRIVER,因为 Laravel 没有内置的 Elasticsearch 驱动:请为您使用的包设置它
Qdrant QDRANT_HOST、QDRANT_PORT、QDRANT_URL
RustFS AWS_ACCESS_KEY_ID=rdev、AWS_SECRET_ACCESS_KEY=rdev-secret、AWS_DEFAULT_REGION、AWS_BUCKET、AWS_ENDPOINT、AWS_URL、AWS_USE_PATH_STYLE_ENDPOINT=true

.env 中这些键已有的值会被替换;其他行保持不变。

在桌面应用中打开数据库

你可以用笔记本上的任何数据库应用浏览和编辑数据库,例如 TablePlus, TablePro, DBeaver, DataGrip, Beekeeper Studio, DBX, pgAdmin, MySQL Workbench, MongoDB Compass, Redis Insight。服务只在你的环境内部监听,因此请选择应用的 SSH(SSH 隧道)选项:SSH 主机是服务器的 Tailscale 地址(~/.ssh/config 中 rdev 条目的 HostName),用户 dev,端口 22,密钥为笔记本登录所用的 SSH 密钥。然后用上表中的端口和凭据连接 127.0.0.1 上的数据库。这需要已连接的笔记本;数据经由你的 tailnet 传输,从不经过 rdev.cloud。

手边没有应用,或者在手机或平板上?https://rdev-adminer.dev.test 会在浏览器中打开 Adminer(见上面的 Adminer 一节)。

默认设置

每个服务都只在您环境内部监听 127.0.0.1,因此外部无法访问它们,并且都已针对开发进行了配置:

服务 凭据 注意事项
MySQL, MariaDB 用户 root,无密码 每个项目都会获得一个以其命名的数据库(my-shop 会变成 my_shop)。
PostgreSQL 用户 postgres,无密码(trust 认证) 没有 Unix 套接字:请连接到 127.0.0.1。如上所述,每个项目一个数据库。
MongoDB 无需认证 数据库会在您的代码第一次写入时出现。
Redis 无密码 仅保存在内存中:重启服务会清空缓存、队列和会话。
Meilisearch 无 master key 开发模式,分析已关闭。
Typesense API 密钥 rdev-typesense 已开启 CORS,因此您笔记本电脑上的页面可以直接查询它。
Elasticsearch 无用户名和密码(安全功能关闭) 单节点,内存 512 MB;不包含机器学习。
Qdrant 无 API 密钥 gRPC 使用 HTTP 端口之后的端口(6334);遥测已关闭。
RustFS 访问密钥 rdev,私有密钥 rdev-secret 每个项目一个存储桶;Web 控制台位于下一个端口(9001)。

在面板中,服务 ⋯ 菜单里的配置会显示服务器所运行版本和端口的同样内容,并附上其第一个项目的 .env 行,可直接复制。要更改选项,请使用 rdev service set(见下文;适用于 MySQL、MariaDB、PostgreSQL 和 Redis),例如使用 rdev service set redis appendonly yes 让 Redis 数据在重启后保留。

选择版本

在服务后添加 @ 以及版本或发行系列:

rdev project service shop [email protected]

这会安装最新的 MySQL 8.0 并切换到它。不指定版本时,会使用已安装的版本,或最新版本。要查看所有可安装的版本:

rdev service available

每种服务同一时间只运行一个版本:

  • MySQL 和 MariaDB 为每个发行系列(8.0、8.4、9.7…)分别保存数据。迁移到较新的系列时,会从旧系列数据的副本开始,由较新的服务器进行升级;旧系列的数据保持原样,因此您可以迁移回去。迁移到较旧的系列时数据为空,因为较旧的服务器无法读取较新的数据。
  • PostgreSQL 和 MongoDB 为每个主版本(PostgreSQL 14、15…;MongoDB 7、8、9)分别保存数据。新的主版本从空数据开始;请使用 pg_dump 或 mongodump 迁移数据。
  • Meilisearch 和 Typesense 在版本变更后,会通过您的应用(php artisan scout:import)重建索引。

MySQL 使用端口 3306,MariaDB 使用 3307,因此两者可以同时安装并运行;项目会在其 .env 中获得正确的端口。在 rdev 0.2.0-beta.37 之前,MariaDB 使用 3306;该更新后,请在使用它的项目的 .env 中设置 DB_PORT=3307,或使用 rdev service set-port mariadb 3306 保留旧端口。选择版本需要 rdev 0.2.0-beta.18 或更高版本。

PostgreSQL 扩展

PostgreSQL 的 -full 构建包含 pgvector(用于 AI 功能的向量搜索)、PostGIS 和 pgRouting(地图和路线),以及从 16 版起的 TimescaleDB(时间序列)。请按完整版本号选择,如 rdev service available 所列:

rdev project service shop [email protected]

然后在您的数据库中启用该扩展,例如在迁移中:

CREATE EXTENSION IF NOT EXISTS vector;

postgis、pgrouting 和 timescaledb 同理。当构建包含 TimescaleDB 时,rdev 会自动预加载它。

管理服务

服务器页面上的服务卡片列出每个已安装的服务及其版本、是否在运行、端口,以及您从面板为其分配的项目。行上的 ⋯ 菜单可启动、停止或重启它,重新安装相同版本(数据保留),或卸载它,可保留数据以便日后安装,也可一并删除。设置失败的行会在同一菜单中显示原因,可重试或从列表中移除。服务器会在几秒内执行每个操作,表格随之更新;这需要服务器上有 rdev 0.2.0-beta.24 或更高版本。

在服务器本身上:

命令 作用
rdev service available 列出可安装的版本
rdev service start mysql / stop / restart 启动、停止或重启服务
rdev service logs mysql 显示其日志的最后几行
rdev service set-port mysql 3307 将其移到另一个端口(下次重启时生效)
rdev service set mysql max_connections 300 设置配置选项(下次重启时生效;MySQL、MariaDB、PostgreSQL 和 Redis)
rdev service change-version mysql 9.7.4 切换到另一个版本
rdev service uninstall mysql 9.7.4 移除一个版本;添加 --purge 可一并删除其数据

服务会随您的环境启动。移除项目绝不会移除其数据库;不再需要时请自行删除。

团队和备份

在 Team 套餐中,每个成员环境都通过名称 rdev-team 访问所有者的服务,同时也拥有自己的私有服务(团队)。

Pro 和 Team 的夜间数据备份包含每个 MySQL、MariaDB、PostgreSQL 和 MongoDB 数据库以及您的 ~/Code 文件夹,并可从面板恢复它们(备份)。MySQL 和 MariaDB 各自在其自己的端口上备份;MongoDB 则将其所有数据库作为一个归档备份。搜索索引和 RustFS 存储桶会根据您的应用和您自己的副本重建。

不在列表中的服务

您不必等我们就能运行其他东西:

  • 用 Node.js、Python、Ruby 或 Go 编写的服务可作为项目运行。rdev 会安装其运行时、启动命令、分配端口,并在其停止时重启:

    rdev project add realtime --lang node --command "npx soketi start --port={port}"
    
  • 其他软件放入您的主目录,例如放在 ~/.local/bin 中的已下载二进制文件,并以同样的方式通过项目的命令启动。您的主目录是 rdev host update 会保留的环境部分;使用 sudo apt 安装到其他位置的任何内容,在下次环境更新后都会消失。

  • 希望像上述服务一样获得支持,包括版本、面板、.env 设置和备份?请联系我们,告知该服务及其用途。我们会添加多位客户需要的服务,并告诉您进展。

您的 AI 智能体可以为您设置前两种;请它“为 shop 项目运行 Elasticsearch”即可。