Datenbanken, Caches, Suche und Dateispeicher laufen in Ihrer Umgebung, neben Ihren Sites. rdev installiert jeden Dienst, sobald ein Projekt ihn zum ersten Mal braucht, in der gewünschten Version, hält ihn am Laufen und schreibt die Verbindungseinstellungen in die .env des Projekts.
Was verfügbar ist
| Dienst | Wofür er gedacht ist | Versionen | Standard-Port |
|---|---|---|---|
| MySQL | Relationale Datenbank | 8.0, 8.4, 9.7 | 3306 |
| MariaDB | Relationale Datenbank | 10.11, 11.4, 11.8, 12.3 | 3307 |
| PostgreSQL | Relationale Datenbank; die -full-Builds fügen pgvector, PostGIS, pgRouting und (ab 16) TimescaleDB hinzu |
14, 15, 16, 17, 18 | 5432 |
| MongoDB | Dokumentendatenbank | 7.0, 8.0, 9.0 | 27017 |
| Redis | Cache, Queues und Sitzungen | 9.1 | 6379 |
| Meilisearch | Volltextsuche, für Laravel Scout | 1 | 7700 |
| Typesense | Volltextsuche, für Laravel Scout | 29, 30 | 8108 |
| RustFS | S3-kompatibler Dateispeicher, mit einer Webkonsole auf dem nächsten Port | 1 | 9000 |
| Elasticsearch | Suche und Analytik, für Scout-Treiber und Elastic-Clients (läuft ohne Machine Learning) | 8.19, 9 | 9200 |
| Qdrant | Vektorsuche für KI-Funktionen wie die semantische Suche | 1 | 6333 |
| Mail-Erfassung | Fängt ausgehende E-Mails ab, damit nichts in echten Postfächern landet; SMTP 127.0.0.1:2525, im Browser unter https://rdev-mail.dev.test |
integriert | |
| Dump-Server | Sammelt Debug-Dumps aus Ihrem Code; 127.0.0.1:2304, im Browser unter https://rdev-dumps.dev.test |
integriert |
Redis spricht das Standard-Redis-Protokoll: Die redis-Treiber von Laravel und phpredis funktionieren unverändert. Jeder Dienst lauscht nur innerhalb Ihrer Umgebung, auf 127.0.0.1; erreichen Sie eine Webkonsole wie die von RustFS über Ihre Laptop-Verbindung.
Abgefangene E-Mails und Dumps im Browser
Öffnen Sie https://rdev-mail.dev.test in einem beliebigen Browser in Ihrem Tailnet, um die von Ihren Apps gesendeten E-Mails zu lesen. Sie sehen die Liste (neueste zuerst), die Header jeder Nachricht, ihre Klartext- und HTML-Version und ihre Anhänge. Sie können eine oder alle Nachrichten löschen, und neue E-Mails erscheinen von selbst. HTML-E-Mails werden mit blockierten Skripten und Remote-Bildern angezeigt.
https://rdev-dumps.dev.test listet dump()-Aufrufe und andere erfasste Ereignisse auf, neueste zuerst, mit Datei und Zeile, aus der sie stammen. Leeren Sie die Liste mit Clear.
Beide Seiten laufen auf Ihrem Server und sind wie Ihre Projekte nur über Ihr Tailnet erreichbar. Die Daten verlassen Ihren Server nie, und eine Vorschau kann sie nie öffentlich machen. rdev mail list gibt beide Adressen aus, und die Laptop-App öffnet sie über Mail und Dumps im Tab Sites. Die Namen rdev-mail und rdev-dumps sind reserviert, ein Projekt kann sie also nicht verwenden.
Datenbanken im Browser
https://rdev-adminer.dev.test öffnet Adminer, einen Datenbankmanager, auf deinem Server. Wähle MySQL oder PostgreSQL, Server 127.0.0.1, Benutzer root (MySQL) oder postgres (PostgreSQL) und lass das Passwort leer; für SQLite gib den Pfad der Datenbankdatei ein. Wie die Seiten oben ist er nur über dein Tailnet erreichbar, und der Name rdev-adminer ist reserviert. Er kommt mit rdev 1.2.0; auf einem früher installierten Server führe zuerst sudo rdev host update aus.
Einem Projekt einen Dienst geben
Nennen Sie auf dem Server das Projekt und den Dienst:
rdev project service shop postgres
rdev installiert und startet den Dienst, falls er noch nicht läuft, legt eine nach dem Projekt benannte Datenbank (MySQL, MariaDB, PostgreSQL) oder einen Bucket (RustFS) an und schreibt die Verbindungseinstellungen in die .env des Projekts. Ein Projekt ohne .env erhält die Einstellungen stattdessen ausgegeben. MongoDB legt die Datenbank an, wenn Ihr Code zum ersten Mal hineinschreibt; bei einem PHP-Projekt installiert rdev außerdem die PHP-Erweiterung mongodb für die PHP-Version, die die Site verwendet (siehe PHP-Erweiterungen).
Wenn ein Laravel-Projekt eine neue MySQL-, MariaDB- oder PostgreSQL-Datenbank erhält, führt rdev außerdem php artisan migrate --force aus, damit die Tabellen, in denen eine neue App ihre Sitzungen, ihren Cache und ihre Queue speichert, vorhanden sind und die Site weiter funktioniert. Das geschieht nur bei einer gerade angelegten, noch leeren Datenbank; eine bestehende Datenbank bleibt unverändert. Schlägt die Migration fehl, bleibt der Dienst bestehen, und die Meldung sagt Ihnen, warum, sodass Sie php artisan migrate selbst ausführen können.
Öffnen Sie im Panel den Server über Server in der Seitenleiste und wählen Sie in der Karte Dienste die Option Dienst hinzufügen, entweder oben oder neben einem Projekt (das Dashboard hat dieselbe Schaltfläche), wählen Sie den Dienst und bei Diensten mit mehreren Versionen die Version. Die Zeile des Projekts zeigt, wo der Server steht: Dienst installieren und starten, Datenbank anlegen, .env schreiben, Migrationen ausführen. Eine Benachrichtigung sagt, wann er bereit ist. Die erstmalige Installation eines Dienstes kann einige Minuten dauern. Ihr KI-Agent kann dasselbe über seinen MCP-Zugriff tun; bitten Sie ihn um „eine PostgreSQL-Datenbank für shop“.
Ein neues Projekt kann seine Dienste mit demselben Befehl erhalten:
rdev project add shop --git [email protected]:you/shop.git --service mysql --service redis
Was in die .env kommt
| Dienst | Einstellungen |
|---|---|
| MySQL, MariaDB, PostgreSQL | DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME (kein Passwort: nur Ihre Umgebung kann ihn erreichen) |
| MongoDB | MONGODB_URI, MONGODB_DATABASE, für das Paket 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) und ELASTIC_HOST (127.0.0.1:9200); kein SCOUT_DRIVER, da Laravel keinen eingebauten Elasticsearch-Treiber hat: Setzen Sie ihn für das Paket, das Sie verwenden |
| 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 |
Werte, die für diese Schlüssel bereits in der .env stehen, werden ersetzt; andere Zeilen bleiben unverändert.
Eine Datenbank in einer Desktop-App öffnen
Sie können Ihre Datenbanken mit jeder Datenbank-App auf Ihrem Laptop ansehen und bearbeiten, zum Beispiel TablePlus, TablePro, DBeaver, DataGrip, Beekeeper Studio, DBX, pgAdmin, MySQL Workbench, MongoDB Compass, Redis Insight. Die Dienste lauschen nur innerhalb Ihrer Umgebung, wählen Sie daher die Option SSH (SSH-Tunnel) der App: SSH-Host ist die Tailscale-Adresse Ihres Servers (der HostName im Eintrag rdev in ~/.ssh/config), Benutzer dev, Port 22 und der SSH-Schlüssel, mit dem sich Ihr Laptop anmeldet. Verbinden Sie sich dann mit der Datenbank unter 127.0.0.1 mit Port und Zugangsdaten aus der Tabelle oben. Dafür muss Ihr Laptop verbunden sein; die Daten laufen über Ihr Tailnet und nie über rdev.cloud.
Keine App zur Hand, oder auf Smartphone oder Tablet? https://rdev-adminer.dev.test öffnet Adminer im Browser (siehe den Adminer-Abschnitt oben).
Standardeinstellungen
Jeder Dienst lauscht nur auf 127.0.0.1 innerhalb Ihrer Umgebung, sodass nichts außerhalb ihn erreichen kann, und alle sind für die Entwicklung eingerichtet:
| Dienst | Zugangsdaten | Gut zu wissen |
|---|---|---|
| MySQL, MariaDB | Benutzer root, kein Passwort |
Jedes Projekt erhält eine Datenbank mit seinem Namen (my-shop wird zu my_shop). |
| PostgreSQL | Benutzer postgres, kein Passwort (Trust-Authentifizierung) |
Kein Unix-Socket: Verbinden Sie sich mit 127.0.0.1. Eine Datenbank pro Projekt, wie oben. |
| MongoDB | Keine Authentifizierung | Eine Datenbank entsteht, sobald Ihr Code zum ersten Mal in sie schreibt. |
| Redis | Kein Passwort | Nur im Arbeitsspeicher: Ein Neustart des Dienstes leert Cache, Warteschlangen und Sitzungen. |
| Meilisearch | Kein Master Key | Entwicklungsmodus, Analytik aus. |
| Typesense | API-Schlüssel rdev-typesense |
CORS ist aktiviert, sodass eine Seite auf Ihrem Laptop ihn direkt abfragen kann. |
| Elasticsearch | Kein Benutzer und kein Passwort (Sicherheit aus) | Ein einzelner Knoten mit 512 MB Arbeitsspeicher; maschinelles Lernen ist nicht enthalten. |
| Qdrant | Kein API-Schlüssel | gRPC auf dem Port nach dem HTTP-Port (6334); Telemetrie aus. |
| RustFS | Zugriffsschlüssel rdev, geheimer Schlüssel rdev-secret |
Ein Bucket pro Projekt; die Webkonsole liegt auf dem nächsten Port (9001). |
Im Panel zeigt Konfiguration im ⋯-Menü eines Dienstes dasselbe für die Version und den Port, die Ihr Server verwendet, samt den .env-Zeilen seines ersten Projekts, bereit zum Kopieren. Um eine Option zu ändern, verwenden Sie rdev service set (siehe unten; MySQL, MariaDB, PostgreSQL und Redis), zum Beispiel rdev service set redis appendonly yes, damit Redis-Daten Neustarts überdauern.
Eine Version wählen
Hängen Sie @ und eine Version oder Release-Linie an den Dienst an:
rdev project service shop [email protected]
Das installiert das neueste MySQL 8.0 und wechselt dorthin. Ohne Version erhalten Sie die bereits installierte oder die neueste. Um alle installierbaren Versionen zu sehen:
rdev service available
Von jedem Dienst läuft jeweils eine Version:
- MySQL und MariaDB behalten für jede Release-Linie (8.0, 8.4, 9.7 …) getrennte Daten. Der Wechsel auf eine neuere Linie beginnt mit einer Kopie der Daten der älteren Linie, die der neuere Server aktualisiert; die Daten der älteren Linie bleiben unverändert, sodass Sie zurückwechseln können. Der Wechsel auf eine ältere Linie beginnt mit leeren Daten, weil ein älterer Server neuere Daten nicht lesen kann.
- PostgreSQL und MongoDB behalten für jede Hauptversion getrennte Daten (PostgreSQL 14, 15 …; MongoDB 7, 8, 9). Eine neue Hauptversion beginnt leer; übertragen Sie Ihre Daten mit
pg_dumpodermongodump. - Meilisearch und Typesense bauen ihre Indizes nach einem Versionswechsel aus Ihrer App neu auf (
php artisan scout:import).
MySQL verwendet Port 3306 und MariaDB 3307, sodass beide gleichzeitig installiert sein und laufen können; Projekte erhalten den richtigen Port in ihrer .env. MariaDB verwendete vor rdev 0.2.0-beta.37 den Port 3306; setzen Sie nach diesem Update DB_PORT=3307 in der .env eines Projekts, das es verwendet, oder behalten Sie den alten Port mit rdev service set-port mariadb 3306. Die Versionswahl erfordert rdev 0.2.0-beta.18 oder neuer.
PostgreSQL-Erweiterungen
Die -full-Builds von PostgreSQL enthalten pgvector (Vektorsuche für KI-Funktionen), PostGIS und pgRouting (Karten und Routen) und ab Version 16 TimescaleDB (Zeitreihen). Wählen Sie eine anhand ihrer vollständigen Version, wie rdev service available sie auflistet:
rdev project service shop [email protected]
Aktivieren Sie die Erweiterung dann in Ihrer Datenbank, zum Beispiel in einer Migration:
CREATE EXTENSION IF NOT EXISTS vector;
Dasselbe gilt für postgis, pgrouting und timescaledb. rdev lädt TimescaleDB automatisch vor, wenn der Build es enthält.
Dienste verwalten
Die Karte Dienste auf der Seite Ihres Servers listet jeden installierten Dienst mit seiner Version, ob er läuft, seinem Port und den Projekten auf, denen Sie ihn über das Panel gegeben haben. Das Menü ⋯ in einer Zeile startet, stoppt oder startet ihn neu, installiert dieselbe Version neu (die Daten bleiben erhalten) oder deinstalliert ihn, wobei seine Daten für eine spätere Installation erhalten bleiben oder ebenfalls gelöscht werden. Eine Zeile, deren Einrichtung fehlgeschlagen ist, zeigt im selben Menü, warum, und kann erneut versucht oder aus der Liste entfernt werden. Der Server führt jede Aktion innerhalb von Sekunden aus, und die Tabelle folgt; dies erfordert rdev 0.2.0-beta.24 oder neuer auf dem Server.
Auf dem Server selbst:
| Befehl | Was er tut |
|---|---|
rdev service available |
Listet die installierbaren Versionen auf |
rdev service start mysql / stop / restart |
Startet, stoppt oder startet einen Dienst neu |
rdev service logs mysql |
Zeigt die letzten Zeilen seines Logs |
rdev service set-port mysql 3307 |
Verschiebt ihn auf einen anderen Port (beim nächsten Neustart) |
rdev service set mysql max_connections 300 |
Setzt eine Konfigurationsoption (beim nächsten Neustart; MySQL, MariaDB, PostgreSQL und Redis) |
rdev service change-version mysql 9.7.4 |
Wechselt auf eine andere Version |
rdev service uninstall mysql 9.7.4 |
Entfernt eine Version; fügen Sie --purge hinzu, um auch ihre Daten zu löschen |
Dienste starten mit Ihrer Umgebung. Das Entfernen eines Projekts entfernt nie dessen Datenbank; löschen Sie sie selbst, wenn Sie sie nicht mehr brauchen.
Teams und Backups
In einem Team-Tarif erreicht jede Mitgliedsumgebung die Dienste des Inhabers unter dem Namen rdev-team, neben ihren eigenen privaten (Teams).
Das nächtliche Daten-Backup in Pro und Team umfasst jede MySQL-, MariaDB-, PostgreSQL- und MongoDB-Datenbank sowie Ihren Ordner ~/Code und stellt sie über das Panel wieder her (Backups). MySQL und MariaDB werden jeweils auf ihrem eigenen Port gesichert; MongoDB als ein Archiv aller seiner Datenbanken. Suchindizes und RustFS-Buckets werden aus Ihrer App und Ihren eigenen Kopien neu aufgebaut.
Ein Dienst, der nicht auf der Liste steht
Sie müssen nicht auf uns warten, um etwas anderes auszuführen:
-
Ein in Node.js, Python, Ruby oder Go geschriebener Dienst läuft als Projekt. rdev installiert seine Laufzeit, startet den Befehl, gibt ihm einen Port und startet ihn neu, wenn er stoppt:
rdev project add realtime --lang node --command "npx soketi start --port={port}" -
Andere Software kommt in Ihren Home-Ordner, zum Beispiel ein heruntergeladenes Binary in
~/.local/bin, und startet auf dieselbe Weise über den Befehl eines Projekts. Ihr Home-Ordner ist der Teil der Umgebung, denrdev host updatebeibehält; alles, was anderswo mitsudo aptinstalliert wurde, ist nach dem nächsten Umgebungs-Update weg. -
Möchten Sie ihn wie die obigen Dienste unterstützt haben, mit Versionen, Panel,
.env-Einstellungen und Backups? Schreiben Sie uns mit dem Dienst und wofür Sie ihn nutzen. Wir fügen Dienste hinzu, die mehrere Kunden brauchen, und sagen Ihnen, wo es steht.
Ihr KI-Agent kann die ersten beiden für Sie einrichten; bitten Sie ihn, „Elasticsearch für das Projekt shop auszuführen“.