Fernzugriff

AirCode Ø ist so konzipiert, dass die Anwendung, die Projekte, die Terminals und die Agenten von überall aus betrieben werden können, während die Anwendung, die Projekte, die Terminals und die Agenten auf Ihrem eigenen Computer laufen. Veröffentlichen Sie es niemals nicht authentisch im öffentlichen Internet.

Eingebauter Fernzugriff

Die Desktop-App und der Server enthalten einen Ausgangs-Tunnel. Sie müssen keinen Router-Port öffnen oder den dynamischen DNSkonfigurieren:

Öffnen Sie Einstellungen → Fernzugriff am Desktop oder Mehr → Server → Fernzugriff im responsiven Web und in der nativen Mobil-App.
Verbinden Sie Ihr Konto, legen Sie unter Sicherheit und Zugriff ein Instanzpasswort fest und lassen Sie AirCode Ø relay in den Verbindungseinstellungen ausgewählt.
Der Fernzugriff startet automatisch. Die Übersicht zeigt die HTTPS-Adresse der Instanz und den Verbindungsstatus.
Öffnen Sie diese Adresse oder wählen Sie QR-Code zur Kopplung erstellen und scannen Sie ihn unter Server hinzufügen → QR-Code scannen in der Mobil-App.

Der verwaltete Fernzugriff startet und verbindet sich automatisch neu, sobald Konto und Instanzpasswort bereit sind, auch nach einer früheren Aus-Einstellung. Es gibt keine Aktivierungsaktion und keinen Einrichtungsdialog. Private und benutzerdefinierte Verbindungen bleiben in den Verbindungseinstellungen verfügbar. Hosted verwaltet seine Verbindung automatisch; ändern Sie die Adresse in den Hosted-Einstellungen.

Ihr AirCode Ø -Passwort schützt den Server immer noch, und die Anwendung, Projekte und Sitzungen bleiben auf der Host-Maschine. Der Tunnel weigert sich zu starten, wenn kein Passwort konfiguriert ist. Ein Pairing QR enthält dieses Passwort nie: Es enthält eine zufällige Fähigkeit, die nach fünf Minuten abläuft und nach dem ersten erfolgreichen Scannen nicht mehr funktioniert. Der Server gibt diesem Telefon dann sein eigenes widerrufliches Token.

Wenn Windows Sicherheit den Desktop-Tunnel blockiert

AirCode Ø bündelt frpc.exe, den Client, der den Ausgangstunnel erstellt. Eine Windows -Sicherheitsrichtlinie kann Proxy-Software als potenziell unerwünschte Anwendung klassifizieren und sich weigern, sie zu starten. Wenn AirCode Ø diese Ablehnung erkennt, zeigt Remote Access Der Tunnel-Client konnte nicht mit starten Anweisungen und **** Aktionen anzeigen.

Wählen Sie Anweisungen anzeigen, dann Öffnen Sie Windows Sicherheit.
Öffnen Sie Virus & Bedrohungs-Schutz → Schutzverlauf und erweitern Sie die neueste potentiell unerwünschte App-Eingabe.
Überprüfen Sie, ob die betroffene Datei zu der von Ihnen installierten AirCode Ø -Installation gehört. Vertrauen und dass sein Weg mit \resources\payload\vendor\frpc\frpc.exe. Eine Matching Detection kann benannt werden PUA:Win32/FRProxy.
Nur wenn sowohl die Installation als auch der Pfad übereinstimmen, wählen Sie Erlauben auf dem Gerät.
Zurück zu AirCode Ø und wählen Sie Retry.

Wenn sich der Erkennungsname oder der Dateiweg unterscheidet, lassen Sie das Element gesperrt und überprüfen Sie es separat. Deaktivieren Sie niemals Windows Security oder fügen Sie für den gesamten AirCode Ø -Installationsordner keine Ausnahme hinzu. Microsoft erklärt die verfügbaren Aktionen in der -Schutzverlaufsanleitung.

Befehlszeileninstallation auf einem Linux -Server

Autorisieren Sie das verwaltete Relay -Konto, bevor Sie es für ein Beispiel anfordern:

aircode login
aircode whoami
aircode start --projects-root /srv/workspaces --relay managed --generate-password

Die Geräteautorisierung wird von allen AirCode Ø -Instanzen geteilt, die demselben Unix-Benutzer gehören. Jede Instanz behält ihren eigenen Port, Passwort, öffentliche Schleife, Tunnel-Identität und den aktiven Zustand. Der erste Service-Boot schließt die Registrierung ab und der Tunnel verbindet sich nach Abstürzen und Neustarts wieder mit dem Server.

Das verwaltete Relay startet nicht, wenn Sie abgemeldet sind, das Konto nicht aktiv ist oder die Instanz kein Passwort hat. aircode logout entfernt die freigegebene Maschineneinrichtung. Bestehende verwaltete Verbindungen können lebendig bleiben, bis ihre aktuelle Vermietung abläuft, also stoppen oder wechseln Sie diese Instanzen in den privaten Modus, bevor Sie sich abmelden, wenn die sofortige Abschaltung von Bedeutung ist.

Weitere Startoptionen sind explizit:

aircode start --relay private
aircode start --relay custom --relay-url https://relay.example.com \
  --relay-enrollment-token-file /run/secrets/aircode-relay-enrollment

private wählt den VPN/private-network-only-Modus aus. Der verwaltete Relay-Zugriff startet automatisch, sobald Konto und Passwort bereit sind.

Managed-Relais Vertrauensgrenze

Der aktuelle verwaltete Relais beendet TLS , bevor er den authentifizierten Datenverkehr an Ihren AirCode Ø -Host weiterleitet. Daher können Relay -Betreiber technisch auf den Verkehr zugreifen, während er durch den Relais geht, auch wenn Anwendungs- und Sitzungsdaten nicht dort als Teil des normalen Dienstes gespeichert werden. End-to-end-Verschlüsselung, die die Überprüfung von Relais verhindert, ist noch nicht verfügbar.

Verwenden Sie Private Netzwerk nur mit Tailscale oder einem anderen VPNoder betreiben Sie ein benutzerdefiniertes Relais, wenn diese Vertrauensgrenze Ihre Anforderungen nicht erfüllt.

Fast preview und geteilter Browser

Der Browser-Bildschirm bietet zwei verschiedene Transportmöglichkeiten:

Fast preview ist die Standardeinstellung für eine localhost-Entwicklung URL. Die Seite , -Assets, Live Reload und HMR WebSockets Render direkt auf dem Anzeigengerät; Chromium läuft nicht auf dem Server. Mit Remote Access aktiviert, AirCode Ø erstellt eine widerrufliche Vorschau-Origin über das Relais. Öffnen Sie es einmal Austausch ist der Zugriffslink für ein HttpOnly-Cookie. Sie können ein Per-Preview-Passwort hinzufügen, wie eine zweite Schicht; der private Link ist immer noch erforderlich, das Passwort wird nur gespeichert als lokaler Hash, und versagte Versuche sind in der Rate begrenzt.
Gemeinsamer Browser läuft Chromium auf dem Server und streamt die gleiche interaktive Sitzung an Personen und Agenten. Wählen Sie es, wenn ein Agent eine Browser-Steuerung benötigt, Diagnostik, Screenshots oder Spuren.

Das Schließen eines Fast preview widerruft seinen Relay-Origin. Vorschau-Links sind Zugriffsmöglichkeiten, auch wenn ein Passwort aktiviert ist: veröffentlichen Sie sie nicht.

Tailscale oder Ihr eigenes VPN

Für Peer-to-Peer-Zugriff ohne den AirCode Ø -Relais öffnen Sie Remote Access → Einstellungen und wählen Sie Private Netzwerk nuraus. AirCode Ø öffnet dann keinen öffentlichen Tunnel.

Installieren Sie Tailscale auf dem Server und auf Ihren Geräten. AirCode Ø erkennt und bindet das Tailnet IP automatisch; öffne http://<tailnet-ip>:7860 von einem anderen Gerät. tailscale serve kann HTTPS mit einem echten Zertifikat hinzufügen:

sudo tailscale serve --bg "http://$(tailscale ip -4):7860"

Der erste Run kann einen Admin-Konsole-Link ausdrucken, um Serve/HTTPS auf Ihrem Tailnet zu aktivieren (ein einmaliger, ein-Klick-Switch).

WireGuard, ZeroTier oder ein SSH -Tunnel (ssh -L 7860:localhost:7860 server) funktionieren auf die gleiche Weise.

Custom Relay

Organisationen können das Dreiecontinent Caddy + FRP + Registrierungsgerät aus dem AirCode Ø Quellbaum ausführen. Es speichert Anwendungs- und Projektdaten auf Mitarbeiterhosts, schließt Standardmäßig neue Maschineneinschreibungen ab und gibt jeder Instanz eine unabhängige Tunnel-Identität.

Auf dem Relay Host:

cd infra/relay
./aircode-relay init \
  --control-domain relay.example.com \
  --tunnel-domain tunnel.example.com \
  --tls-mode provided
# Add a certificate covering relay.example.com and *.tunnel.example.com:
#   tls/fullchain.pem
#   tls/privkey.pem
./aircode-relay up
./aircode-relay doctor
./aircode-relay enrollment create --expires 15m --uses 1 --label alice-laptop

Setzen Sie den angezeigten einmaligen Wert in einen Modus-0600 -Datei auf dem AirCode Ø -Host, und verwenden Sie dann den benutzerdefinierten Befehl Relay , der oben gezeigt wird. AirCode Ø verbraucht und entfernt das aufgehende Token nach erfolgreicher Anmeldung. FRPS erfordert TLS, und der Host pins das interne CA und den Servernamen des Geräts aus der authentifizierten HTTPS -Eintragungsreaktion.

Viele Mitarbeiter können eine Relay teilen. Dies macht eine AirCode Ø -Instanz nicht zu einem sicheren Multi-User-Server: Verwenden Sie ein Unix-Konto, einen Container oder eine VM und eine Instanz pro Mitarbeiter, bis gleichbehandelte Rollen und Ausführungsausscheidung implementiert sind.

Die Desktop- und Mobil-Apps

Fügen Sie eine Verbindung manuell mit dem Server URL + Passwort hinzu oder generieren Sie einen QR-Code für eine einmalige Verwendung unter Einstellungen → Sicherheit & Zugriff → Paar ein Telefon. Verbindungen und Paarungs-Geräte-Token werden in der sicheren Credential Storage der Plattform gespeichert. Die Desktop-App zeigt den aktiven Server im unteren linken Statusindikator an – klicken Sie darauf, um zu wechseln oder Server hinzuzufügen (lokal oder remote).

Die native mobile App benötigt zunächst eine bereits erreichbare Serveradresse. Sobald es verbunden ist, verwaltet Mehr → Server → Remote Access diese Instanz mit dem gleichen Server-Eigentumsstatus wie Desktop und responsive Web: verwaltetes Relay -Konto, verbindungsmethode, benutzerdefinierte Relay -Eintragung, öffentliche URL -Präfix, automatische Verbindung und Wiederverbindung, Live- URL und permanente URL -Rotation. Die Konto-Auskunft, die einmalige Anmeldegenehmigung und die Tunnel-Identität bleiben auf dem Server und nicht im Telefonprofil. Die mobile Adresse kann eine LAN oder VPN -Adresse, ein von einem Benutzer betriebener reverse proxy oder eine öffentliche Relay URL sein.

Eine aktuelle QR importiert diese Adresse und tauscht ihre einmalige Fähigkeit für ein Token aus, das von diesem Telefon gehört; ältere QR-Codes, die nur Adresse enthalten, fallen immer noch zurück auf die Passwort-Eingabe. Das Scannen einer QR aktiviert oder erfordert keine Relay. Paarte Telefone können einzeln unter Sicherheit und Zugriff im Web, responsive web oder native mobile überprüft und widerrufen werden.

Pairing verwendet standardmäßig HTTPS . Wenn der Server bereits über eine HTTP LAN oder eine privateVPN -Adresse erreichbar ist, aktivieren Sie Erlauben der Pairing auf dieser lokalen Verbindung , bevor Sie die QR generieren. Diese Wahl gilt nur für den nächsten fünfminütigen Code und schaltet sich nach der Generation aus.

Installieren Sie die Web-App von der HTTPS -Instanz

Der Store-freie AirCode Ø -Client wird von der genauen HTTPS -Quelle installiert, die Ihre Instanz bedient. Sobald der verwaltete Relay, ein benutzerdefinierter Relay oder Ihr eigener vertrauenswürdiger HTTPS reverse proxy aktiv ist:

Öffnen Sie die HTTPS -Instanzadresse auf dem Telefon oder Tablet und melden Sie sich an;
Wählen Sie Installation der Web-App von Mehr oder Einstellungen → Web-App;
akzeptieren Sie die Chromium-Installationsanleitung oder folgen Sie der Anleitung iPhone/iPad für Teilen → Home Screenhinzufügen
starten Sie das installierte Symbol und aktivieren Sie dann die Push-Benachrichtigungen explizit, wenn Sie möchten geschlossene App-Warnungen.

Auf iPhone und iPad wird Web Push erst nach dem Start der Web-App von ihrem Home Screen -Symbol angeboten. Der Browser und das Betriebssystem bleiben für die Installations- und Berechtigungsanrufe verantwortlich. Eine installierte Web-App gehört zu einem Ursprung; die Verlegung einer Instanz zu einem anderen Ursprung bedeutet, dass Sie diesen neuen Ursprung installieren und sich erneut anmelden.

Sie können den gleichen Handoff aus der speziellen Web-App-Setup oder von Downloadstarten. Die Marketing-Website validiert die Adresse lokal, verwerft Anmeldeinformationen, Wege, Abfragen und Fragmente und öffnet nur /?pwa-install=1 auf der resultierenden HTTPS Herkunft. Es erhält oder behält die Instanz-Adresse nicht.

Die responsive Web-App deckt den Kernarbeitsbereich, Sitzungen, Aufmerksamkeitsanfragen, Terminal, Dateien, Git, Browser/Anwendungen, Focus Plans, Prompt Queue, Scheduled Tasks, Einstellungen und Benachrichtigungs-Gerätemanagement ab. Native Mobile verfügt immer noch über eine tiefergehende Betriebssystemintegration: verschlüsselte lokale Speicherung, sichere Multi-Server-Profile, begrenzte Hintergrundarbeit, native Datei/Kamera/Sharing-Flows, Haptics, Benachrichtigungskanäle und aircode:// -Links. Browser-Speicher kann verdrängt werden, Hintergrund-Ausführung ist nicht garantiert, und iPhone/iPad Installation ist manuell.

Firewalls

Der eingebaute Tunnel benötigt keinen Inbound-Port. Es macht Ausgangsverbindungen zum Relais über HTTPS und FRP. Der Private-Netzwerk-Modus öffnet keine zusätzliche Verbindung; Ihr VPN bestimmt die Reichweite. Schnelle Vorschau verwendet authentifizierte Ephemeral-Ports auf der gleichen Schnittstelle wie der AirCode Ø -Server, so dass eine restriktive Host-Firewall den Datenverkehr vom privaten Netzwerk zu diesen Ports zulassen muss.

Für eine Docker Sandbox -Sitzung endet diese Route immer noch am Host-Steuerplan AirCode Ø . Der Terminalverkehr überquert dann den Docker API an den Arbeitnehmer. Der Tunnel trägt nicht automatisch Arbeiterabfluss und veröffentlicht keine Entwicklungs-Ports aus dem Container.