Anleitung

Verbindung per SSH

Terminalzugang zum gemieteten Mac von Windows, einem Mac oder Linux: SSH-Schlüssel, erste Anmeldung, Dateiübertragung, tmux und VS Code. Ohne zusätzliche Software.

Sie verbinden sich mit dem gemieteten Mac per normalem SSH über unser Gateway gate.bohemiansilicon.com. Sie installieren nichts zusätzlich und richten im Netzwerk nichts ein. Die Einrichtung dauert etwa 10 Minuten, und die erste Stunde jeder Miete ist kostenlos, damit Sie alles in Ruhe vorbereiten können.

In unserer E-Mail mit den Zugangsdaten erhalten Sie Ihren Benutzernamen, Ihre Portnummer (sie sieht aus wie 2201), den Fingerabdruck des Macs und für Remote Desktop ein Passwort. Wo in dieser Anleitung BENUTZERNAME und PORT stehen, verwenden Sie die Angaben aus dieser E-Mail.

Für SSH schicken Sie uns nur Ihren öffentlichen SSH-Schlüssel. Passwörter sind für SSH deaktiviert; Sie melden sich nur mit dem Schlüssel an.

Windows

Windows 10 und 11 enthalten den SSH-Client bereits, Sie müssen nichts weiter installieren.

1. SSH-Schlüssel erstellen

Wir empfehlen einen eigenen Schlüssel nur für Bohemian Silicon. Die Befehle unten speichern ihn unter einem eigenen Namen, sodass sie keinen Schlüssel überschreiben, den Sie schon anderswo nutzen (zum Beispiel id_ed25519 für GitHub).

Öffnen Sie die PowerShell (klicken Sie auf Start, tippen Sie PowerShell und öffnen Sie sie).
Führen Sie diese Befehle aus. Wenn nach einer Passphrase gefragt wird, geben Sie eine ein und bestätigen Sie sie (beim Tippen wird nichts angezeigt). Die Passphrase schützt den Schlüssel, falls jemand die Datei kopiert. Sie können sie leer lassen, das ist aber weniger sicher.

mkdir -Force $HOME\.ssh | Out-Null
ssh-keygen -t ed25519 -f $HOME\.ssh\bohemian_ed25519 -C bohemian-silicon

Der Befehl erzeugt zwei Dateien. bohemian_ed25519 ist Ihr privater Schlüssel: Er bleibt auf Ihrem Computer, und Sie geben ihn nie weiter. bohemian_ed25519.pub ist der öffentliche Schlüssel: Den schicken Sie uns. Er kann bedenkenlos per normaler E-Mail verschickt werden, denn allein kann man sich damit nicht anmelden.

Sie möchten einen vorhandenen Schlüssel verwenden? Schicken Sie uns dessen .pub-Datei und verwenden Sie in den Befehlen unten seinen Dateinamen statt bohemian_ed25519.

Zeigen Sie den öffentlichen Schlüssel an:

Get-Content $HOME\.ssh\bohemian_ed25519.pub

Kopieren Sie die ganze Zeile, die mit ssh-ed25519 beginnt.

Schicken Sie uns den Schlüssel per E-Mail. Senden Sie nie die Datei ohne .pub: Das ist Ihr privater Schlüssel, und er bleibt nur auf Ihrem eigenen Computer.

Die Passphrase des Schlüssels geben Sie bei jeder Verbindung ein.

2. Verbinden

ssh -i $HOME\.ssh\bohemian_ed25519 -p PORT BENUTZERNAME@gate.bohemiansilicon.com

Beim ersten Mal zeigt SSH den Fingerabdruck des Macs (ED25519 key fingerprint is SHA256:…) und fragt Are you sure you want to continue connecting?. Vergleichen Sie ihn mit dem Fingerabdruck in unserer E-Mail. Tippen Sie yes nur, wenn sie genau übereinstimmen. Wenn nicht, tippen Sie no und schreiben Sie uns.
Sie sind angemeldet, wenn Sie eine Zeile sehen, die mit % endet. Mit exit trennen Sie die Verbindung.

Mac

1. SSH-Schlüssel erstellen

Öffnen Sie das Terminal (Programme → Dienstprogramme → Terminal).
Führen Sie diese Befehle aus. Wenn nach einer Passphrase gefragt wird, geben Sie eine ein und bestätigen Sie sie (beim Tippen wird nichts angezeigt). Die Passphrase schützt den Schlüssel, falls jemand die Datei kopiert. Sie können sie leer lassen, das ist aber weniger sicher.

mkdir -p ~/.ssh
ssh-keygen -t ed25519 -f ~/.ssh/bohemian_ed25519 -C bohemian-silicon

Sie möchten einen vorhandenen Schlüssel verwenden? Schicken Sie uns dessen .pub-Datei und verwenden Sie in den Befehlen unten seinen Dateinamen statt bohemian_ed25519.

Zeigen Sie den öffentlichen Schlüssel an:

pbcopy < ~/.ssh/bohemian_ed25519.pub

Der Schlüssel liegt jetzt in der Zwischenablage; fügen Sie ihn mit ⌘V ein.

Schicken Sie uns den Schlüssel per E-Mail. Senden Sie nie die Datei ohne .pub: Das ist Ihr privater Schlüssel, und er bleibt nur auf Ihrem eigenen Computer.

Tipp: Damit Sie die Passphrase nicht jedes Mal eingeben müssen, speichern Sie sie im macOS-Schlüsselbund:

ssh-add --apple-use-keychain ~/.ssh/bohemian_ed25519

2. Verbinden

ssh -i ~/.ssh/bohemian_ed25519 -p PORT BENUTZERNAME@gate.bohemiansilicon.com

Beim ersten Mal zeigt SSH den Fingerabdruck des Macs (ED25519 key fingerprint is SHA256:…) und fragt Are you sure you want to continue connecting?. Vergleichen Sie ihn mit dem Fingerabdruck in unserer E-Mail. Tippen Sie yes nur, wenn sie genau übereinstimmen. Wenn nicht, tippen Sie no und schreiben Sie uns.
Sie sind angemeldet, wenn Sie eine Zeile sehen, die mit % endet. Mit exit trennen Sie die Verbindung.

Linux

1. SSH-Schlüssel erstellen

Öffnen Sie ein Terminal.
Führen Sie diese Befehle aus. Wenn nach einer Passphrase gefragt wird, geben Sie eine ein und bestätigen Sie sie (beim Tippen wird nichts angezeigt). Die Passphrase schützt den Schlüssel, falls jemand die Datei kopiert. Sie können sie leer lassen, das ist aber weniger sicher.

mkdir -p ~/.ssh
ssh-keygen -t ed25519 -f ~/.ssh/bohemian_ed25519 -C bohemian-silicon

Sie möchten einen vorhandenen Schlüssel verwenden? Schicken Sie uns dessen .pub-Datei und verwenden Sie in den Befehlen unten seinen Dateinamen statt bohemian_ed25519.

Zeigen Sie den öffentlichen Schlüssel an:

cat ~/.ssh/bohemian_ed25519.pub

Kopieren Sie die ganze Zeile, die mit ssh-ed25519 beginnt.

Schicken Sie uns den Schlüssel per E-Mail. Senden Sie nie die Datei ohne .pub: Das ist Ihr privater Schlüssel, und er bleibt nur auf Ihrem eigenen Computer.

Tipp: Auf den meisten Linux-Desktops läuft bereits ein SSH-Agent, sodass Sie die Passphrase nur einmal pro Anmeldung eingeben:

ssh-add ~/.ssh/bohemian_ed25519

2. Verbinden

ssh -i ~/.ssh/bohemian_ed25519 -p PORT BENUTZERNAME@gate.bohemiansilicon.com

Beim ersten Mal zeigt SSH den Fingerabdruck des Macs (ED25519 key fingerprint is SHA256:…) und fragt Are you sure you want to continue connecting?. Vergleichen Sie ihn mit dem Fingerabdruck in unserer E-Mail. Tippen Sie yes nur, wenn sie genau übereinstimmen. Wenn nicht, tippen Sie no und schreiben Sie uns.
Sie sind angemeldet, wenn Sie eine Zeile sehen, die mit % endet. Mit exit trennen Sie die Verbindung.

Dateien übertragen

Führen Sie scp auf Ihrem eigenen Computer aus, nicht auf dem gemieteten Mac.

Windows

scp -i $HOME\.ssh\bohemian_ed25519 -P PORT daten.zip BENUTZERNAME@gate.bohemiansilicon.com:~/
scp -i $HOME\.ssh\bohemian_ed25519 -P PORT BENUTZERNAME@gate.bohemiansilicon.com:~/ergebnisse.zip .

Mac, Linux

scp -i ~/.ssh/bohemian_ed25519 -P PORT daten.zip BENUTZERNAME@gate.bohemiansilicon.com:~/
scp -i ~/.ssh/bohemian_ed25519 -P PORT BENUTZERNAME@gate.bohemiansilicon.com:~/ergebnisse.zip .

Die erste Zeile lädt eine Datei auf den gemieteten Mac hoch, die zweite lädt eine Datei in den aktuellen Ordner herunter. Mit -r kopieren Sie einen ganzen Ordner.

Lang laufende Aufgaben (tmux)

Wenn Sie das Terminal schließen oder die Verbindung abbricht, enden auch die darin gestarteten Programme. Starten Sie lange Aufgaben wie Modell-Downloads oder Training in tmux: Die Sitzung läuft auf dem Mac weiter, auch wenn Sie die Verbindung trennen. Starten Sie nach der Anmeldung am Mac eine Sitzung:

tmux new -s work

Starten Sie darin Ihre Aufgabe. Um sie laufen zu lassen und die Verbindung zu trennen, drücken Sie Strg+B, lassen beide Tasten los und drücken dann D. Nach einer neuen Verbindung kehren Sie so zur Sitzung zurück:

tmux attach -t work

tmux ls listet Ihre Sitzungen auf; exit in einer Sitzung beendet sie. Alle Sitzungen enden spätestens mit dem Ende der Miete, wenn Ihr Konto gelöscht wird.

Visual Studio Code (Remote-SSH)

Installieren Sie in VS Code die Erweiterung Remote - SSH von Microsoft.
Drücken Sie F1, wählen Sie Remote-SSH: Add New SSH Host… und geben Sie diesen Befehl ein (gleich unter Windows, Mac und Linux):

ssh -i ~/.ssh/bohemian_ed25519 -p PORT BENUTZERNAME@gate.bohemiansilicon.com

Speichern Sie ihn in der vorgeschlagenen SSH-Konfigurationsdatei. Drücken Sie dann erneut F1, wählen Sie Remote-SSH: Connect to Host… und die Adresse des Macs. Wenn nach der Plattform gefragt wird, wählen Sie macOS.
Bei der ersten Verbindung installiert VS Code seinen Serverteil in Ihr Konto auf dem Mac, das dauert ein bis zwei Minuten. Danach können Sie Ordner auf dem Mac öffnen und sein Terminal direkt in VS Code nutzen.

Fehlerbehebung

Die Verbindung läuft in ein Timeout oder wird abgelehnt: Prüfen Sie die Adresse gate.bohemiansilicon.com und die Portnummer nach -p. Manche Firmen- oder Hotelnetze blockieren ausgehende Verbindungen zu ungewöhnlichen Ports; versuchen Sie ein anderes Netz, etwa einen Hotspot vom Handy, oder schreiben Sie uns.
Permission denied (publickey) oder eine Passwortabfrage: Ihr Schlüssel wurde nicht verwendet. Verbinden Sie sich von dem Computer, auf dem Sie den Schlüssel erstellt haben, geben Sie -i mit dem Pfad zum Schlüssel an und prüfen Sie den Benutzernamen.
REMOTE HOST IDENTIFICATION HAS CHANGED: Brechen Sie ab und verbinden Sie sich nicht. Schreiben Sie uns zuerst. Wir sagen Ihnen, ob der Mac neu installiert wurde, und schicken Ihnen seinen neuen Fingerabdruck. Erst dann führen Sie ssh-keygen -R "[gate.bohemiansilicon.com]:PORT" aus und verbinden sich erneut, wobei Sie den neuen Fingerabdruck prüfen.

Am Ende der Miete

Am Ende der Miete löschen wir Ihr macOS-Konto samt Benutzerordner und entfernen Ihre Dateien aus gemeinsamen temporären Ordnern (/tmp, /Users/Shared). Laden Sie alles, was Sie behalten möchten, vor dem Ende der Miete herunter. Danach können Sie den Schlüssel auch von Ihrem Computer löschen: die Dateien bohemian_ed25519 und bohemian_ed25519.pub im Ordner .ssh.

Kommen Sie nicht weiter? Schreiben Sie an hello@bohemiansilicon.com und hängen Sie einen Screenshot oder den Fehlertext an. Meist antworten wir innerhalb weniger Minuten.