SSH und Ports

Mit SSH (einer sicheren Verbindung zu Ihrem Server) arbeiten Sie in Ihrem eigenen Editor. Das Gateway (der Eingang für SSH) ist in allen Plänen enthalten.

Mit VS Code verbinden

Ein Schlüssel ist wie ein Hausschlüssel für Ihren Rechner. Haben Sie noch keinen, erzeugen Sie ihn mit ssh-keygen -t ed25519. Die Datei mit der Endung .pub ist der öffentliche Teil.

Öffnen Sie in Ihrer Instanz (Ihrem Entwicklungsserver) Settings → SSH keys.
Fügen Sie dort Ihren öffentlichen Schlüssel ein.
Öffnen Sie in my.envbay.com die Dienstseite (die Seite Ihrer Instanz).
Lesen Sie im Feld SSH-Gateway den Port ab. Ein Port ist wie eine Türnummer.
Installieren Sie in VS Code die Erweiterung Remote - SSH.
Wählen Sie Remote-SSH: Connect to Host….
Tippen Sie ssh -p <Port> <projekt>@ssh.<kunde>.envbay.dev ein.
Öffnen Sie den Ordner /var/www/html.

Das ist Ihr Projekt. Das Projekt muss dafür laufen. Zeigt Ihnen Envoryx im Reiter IDE einen anderen Hostnamen (envoryx.<kunde>.envbay.dev), nehmen Sie trotzdem ssh.<kunde>.envbay.dev; Port und Benutzer sind dieselben.

Wenn etwas nicht klappt

Zeitüberschreitung: Prüfen Sie den Port. Manche Firmennetze sperren hohe Ports.
Permission denied: Ihr Schlüssel ist nicht hinterlegt, oder der Benutzername stimmt nicht. Der Benutzername ist der Projektname.
Es geht gar nichts: Läuft das Projekt? Ist Ihre Instanz gesperrt? Dann lehnt SSH die Anmeldung ab. Lesen Sie Sicherheit und faire Nutzung.
Sie kommen nicht weiter: Schreiben Sie uns ein Ticket (eine Nachricht an den Support). Die Schritte stehen im Kapitel Hilfe.

Verbindungsdaten

Angabe	Wert
Host	`ssh.<kunde>.envbay.dev` (IPv4 und IPv6). Envoryx selbst zeigt im Reiter IDE den Namen Ihrer Oberfläche `envoryx.<kunde>.envbay.dev`; der funktioniert derzeit ebenfalls, verlässlich und auch nach einem Umzug Ihrer Instanz gilt aber nur `ssh.<kunde>`
Port	`22000 + n`; Ihr Wert steht auf der Dienstseite im Feld SSH-Gateway
Benutzer	der Projektname (Slug), optional mit Laufzeit-Endung (`shop.node`)
Anmeldung	öffentlicher Schlüssel unter Settings → SSH keys oder ein API-Token als Passwort

Port 22 wird nicht verwendet. In Ihrer Instanz lauscht das Gateway auf 2222, nach außen ist es auf 22000 + n abgebildet. Statische Seiten bieten nur SFTP und scp. Benutzername und Anmeldung beschreibt der Autor unter Terminal, SSH & logs. Nach mehreren Fehlversuchen sperrt Envoryx die anfragende Adresse für das Projekt kurz.

Setzen Sie in allen Beispielen für <Port> den Wert von Ihrer Dienstseite ein.

Beispiel für ~/.ssh/config

Host envbay-shop
  HostName ssh.<kunde>.envbay.dev
  Port <Port>
  User shop
  IdentityFile ~/.ssh/id_ed25519

Editor und IDE

VS Code (Remote-SSH): ssh -p <Port> shop@ssh.<kunde>.envbay.dev, danach /var/www/html öffnen.
JetBrains: Aktivieren Sie im Projekt Allow JetBrains Gateway for this project (standardmäßig aus). Laut Envoryx braucht das Backend 2 bis 4 GB Arbeitsspeicher und lädt rund 1,5 GB herunter. In Free (1 GB) und im Starter (2 GB für die ganze Instanz) ist das zu knapp; planen Sie dafür Team oder Agency ein. Einzelheiten: IDE and remote development.
SFTP und scp: Das Projekt liegt unter /var/www/html.

Tunnel zu Projektdiensten

Datenbanken und Zusatzdienste lauschen nur lokal und sind aus dem Internet nicht erreichbar. Von Ihrem Rechner kommen Sie per SSH-Tunnel heran:

ssh -N -p <Port> -L 15432:127.0.0.1:<Zielport> shop@ssh.<kunde>.envbay.dev

Danach verbinden Sie Ihr Werkzeug mit 127.0.0.1:15432. Den Zielport und die fertigen Verbindungsangaben zeigt Envoryx im Bereich Database, nachdem Sie Publish port on the host aktiviert haben; bei verwalteten Instanzen nennt der IDE-Bereich den Tunnel-Befehl. Für den Alltag genügt oft der Datenbank-Browser (Adminer), siehe Databases. Debugger-Ports (Xdebug, Node, debugpy, Delve, rdbg, JDWP) stehen in der Envoryx-Doku; Delve, rdbg und JDWP haben keine Anmeldung und gehören nur in den Tunnel.

Netzregeln

Eingehend erreichen Ihre Instanz nur die Ports 80, 443 und die SSH-Ports der Instanzen (ab 22000).
Ausgehende Verbindungen ins Internet sind erlaubt, die Mailports 25, 465 und 587 ausgenommen. Zu anderen Kunden und zu Envbay-Systemen sind sie weitgehend gesperrt; Namensauflösung (DNS) und der Paket-Cache bleiben erreichbar.
Neue ausgehende Verbindungen sind auf 50 pro Sekunde begrenzt (kurze Spitzen bis 200).

Wenn die Verbindung nicht klappt

Zeitüberschreitung: Stimmt der Port? Manche Netze, etwa Firmen-WLANs, sperren ausgehende Verbindungen auf hohe Ports.
Permission denied: Der Schlüssel ist nicht unter Settings → SSH keys hinterlegt, oder der Benutzername stimmt nicht mit dem Projektnamen überein. Prüfen Sie mit ssh -v.
Projekt läuft nicht: Shells und Debugger funktionieren nur bei laufendem Projekt.
Instanz gesperrt: SSH und SFTP lehnen die Anmeldung ab, siehe Sicherheit und faire Nutzung.
Bleibt das Problem: Ticket eröffnen und die Ausgabe von ssh -v anhängen (ohne Schlüssel oder Passwörter).