リモートアクセス
AirCode Ø は、アプリケーション、プロジェクト、端末、エージェントが独自のマシンで動作し続ける間、どこからでも動作するように構築されています。 決して、公衆のインターネットに非正確にそれを露出しないでください。
内蔵のリモートアクセス
デスクトップアプリとサーバーには、アウトボードのみのトンネルが含まれています。 Router ポートを開く必要もなく、Dynamic DNSを設定する必要もありません。
- デスクトップでは 設定 → リモートアクセス、レスポンシブWebとネイティブモバイルアプリでは その他 → サーバー → リモートアクセス を開きます。
- アカウントを接続し、セキュリティとアクセスでインスタンスのパスワードを設定して、接続設定で AirCode Ø relay を選択したままにします。
- リモートアクセスは自動的に開始されます。概要にはインスタンスのHTTPSアドレスと接続状態が表示されます。
- そのアドレスを開くか、ペアリング用QRコードを生成を選び、モバイルアプリの サーバーを追加 → QRコードをスキャンから読み取ります。
管理リモートアクセスは、以前にオフにしていた場合も、アカウントとインスタンスのパスワードが準備できると自動的に開始・再接続します。有効化の操作や設定ダイアログは必要ありません。プライベート接続とカスタム接続は引き続き接続設定で選択できます。Hosted は接続を自動管理します。アドレスは Hosted の設定で変更します。
あなたの AirCode Ø パスワードはまだサーバーを保護し、アプリケーション、プロジェクト、セッションはホストマシンに残ります。 パスワードが設定されていない場合、トンネルは起動を拒否します。 ペアリング QR には、そのパスワードが含まれていない:それは 5 分後に終了し、最初のスキャンが成功した後で機能を停止するランダムな機能を含んでいます。 サーバーはその後、その電話に独自の取り消し可能なトークンを提供します。
If Windows セキュリティがデスクトップトンネルをブロックする場合
AirCode Ø バンド frpc.exeは、出力トンネルを作成するクライアントです。 Windows セキュリティ ポリシーは、プロキシ ソフトウェアを潜在的に不要なアプリケーションとして分類し、起動を拒否する場合があります。 AirCode Ø がこの拒否を検出した場合、リモート アクセスの表示 トンネル クライアントは で を起動できなかった と **** アクションを再起動します。
- 選択 指示を見るその後 オープン Windows 安全保障.
- ウィルスと脅威保護 → 保護履歴を開いて、最新の拡張 潜在的に不要なアプリの入力
- 影響を受けたファイルが AirCode Ø インストールに属していることを確認します。
信頼とその道が終わることを
\resources\payload\vendor\frpc\frpc.exe. A matching detection may be namedPUA:Win32/FRProxy. - インストールとパスが一致した場合にのみ、 デバイスでを許可します。
- AirCode Ø に戻り、 Retryを選択します。
検出名またはファイルパスが異なる場合は、アイテムをブロックし、別々にチェックしてください。 決して Windows Security を無効にしないでください、または AirCode Ø インストール フォルダ全体の除外を追加してください。 Microsoft は 保護履歴ガイドラインで利用可能なアクションを説明します。
コマンドライン設定 Linux サーバー
インスタンスをリクエストする前に、管理された Relay アカウントを認証する:
aircode login
aircode whoami
aircode start --projects-root /srv/workspaces --relay managed --generate-password
デバイス認証は、同じUnixユーザーが所有するすべての AirCode Ø インスタンスで共有されます。 各インスタンスは、独自のポート、パスワード、公開スラグ、トンネルアイデンティティ、および有効状態を保持します。 最初のサービスブートは、登録を完了し、トンネルは、クラッシュやリブート後にサーバーと再接続します。
Managed Relay は、サインアウトしている場合、アカウントがアクティブでない場合、またはインスタンスにパスワードがない場合、開始を拒否します。 aircode logout は、共有マシン認証を削除します。 既存のマネージド接続は、現在のレンタル期間が終了するまで生き残ることができますので、即時切断が重要なときにサインインする前に、これらのインスタンスを停止またはプライベートモードに切り替えることができます。
他の打ち上げオプションは明示的である:
aircode start --relay private
aircode start --relay custom --relay-url https://relay.example.com \
--relay-enrollment-token-file /run/secrets/aircode-relay-enrollment
private は VPN・プライベートネットワーク専用モードを選択します。管理 Relay はアカウントとパスワードの準備ができると自動的に開始します。
マネージド・レレー・信頼限界
現在のマネージド・レレレイは、 TLS を AirCode Ø ホストに認証されたトラフィックを転送する前に終了します。 Relay オペレーターは、通常のサービスの一部としてアプリケーションとセッションデータがそこに保存されていないにもかかわらず、リレーを通過する間、トラフィックに技術的にアクセスできます。 レレイヤー検査を防ぐエンド-to-エンド暗号化はまだ利用できません。
利用 プライベートネットワークのみ 同 Tailscale あるいは別の VPN, または、その信頼限界があなたの要件を満たさない場合のカスタムリレーを実行します。
Fast preview and Shared browser
ブラウザ画面は、2つの異なる輸送を提供しています:
- Fast preview は、 localhost 開発のデフォルトである URLです。 ページは、 資産、ライブリロード、および HMR WebSockets レンダリングは、視聴デバイス上に直接表示されます。 Chromium はサーバー上で実行されません。 リモートアクセスを有効にした場合、 AirCode Ø は、レレイヤーを通じて、取り消し可能なプレビュー オリジナルを作成します。 開封した後交換 は、HttpOnly Cookieのアクセスリンクです。 Per-preview password を追加することもできます。 二次層;プライベートリンクはまだ必要であり、パスワードだけが保存されます。 はローカルハッシュとして使用され、失敗した試みは割合が制限されます。
- 共有ブラウザ サーバー上で Chromium を実行し、同じインタラクティブなストリームをストリーミングします。 セッションは、人とエージェントにします。 エージェントがブラウザの制御を必要とする場合、 診断、スクリーンショット、または痕跡。
Fast preview を閉じると、リレーの起源が取り消されます。 プレビューリンクはパスワードが有効な場合でもアクセス機能です: 公開しないでください。
Tailscale またはあなたの VPN
AirCode Ø レレイヤーなしのピアツーピア アクセスの場合、 Remote Access → Settings を開いて Private network onlyを選択します。 AirCode Ø は、公衆トンネルを開くことはありません。
Tailscale をサーバーとデバイスにインストールします。 AirCode Ø は自動的に tailnet IP を検出し、別のデバイスから http://<tailnet-ip>:7860 を開きます。 tailscale serve は、実際の証明書で HTTPS を追加できます。
sudo tailscale serve --bg "http://$(tailscale ip -4):7860"
最初の実行では、サーバー/HTTPS を tailnet で有効にする admin-console リンクを印刷する場合があります(一回の、一クリックのスイッチ)。
WireGuard、ZeroTier、または SSH トンネル(ssh -L 7860:localhost:7860 server)は同じように動作します。
カスタムレレー
組織は、 AirCode Ø ソースツリーから3コンテナのCaddy + FRP +レジストリデバイスを実行することができます。 アプリケーションとプロジェクトのデータを従業員ホストに保存し、新しいマシン登録をデフォルトで閉じ、各インスタンスに独立したトンネルアイデンティティを提供します。
Relay ホストについて:
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
表示された一度値を0600 ファイルモードに AirCode Ø ホストに置き、上記に示されたカスタム Relay コマンドを使用します。 AirCode Ø は、登録が成功した後、待機するトークンを消費し、削除します。 FRPS は TLSを必要とし、ホストは認証された HTTPS 登録応答からデバイスの内部 CA とサーバー名をピンします。
複数の従業員が1つの Relayを共有できます。 これは、1つの AirCode Ø インスタンスを安全なマルチユーザサーバーに変えることはありません:同一インスタンスの役割と実行隔離が実装されるまで、従業員ごとに 1 つの Unix アカウント、コンテナ、または VM と 1 つのインスタンスを使用します。
デスクトップおよびモバイルアプリ
サーバー URL + パスワードで接続を手動で追加するか、 設定 → セキュリティ & アクセス → 電話をペアする下で、一度使用する QR コードを生成します。 接続やデバイス・トークンは、プラットフォームのセキュアな認証ストレージに保存されます。 デスクトップアプリは、左下の状態指標でアクティブなサーバーを表示します - クリックしてサーバーを切り替えたり(ローカルまたはリモート)追加したりします。
ネイティブモバイルアプリケーションには、すでにアクセス可能なサーバーアドレスが必要です。 More → Server → Remote access は、デスクトップとリスニング ウェブと同じサーバー所有状態のインスタンスを管理します:管理 Relay アカウント、接続方法、カスタマイズされた Relay 登録、公開 URL プレフィックス、自動接続と自動再接続、ライブ URL および永続的な URL 回転。 アカウント認証、一度の登録許可、トンネルアイデンティティは、電話プロフィールではなくサーバーに残ります。 モバイル アドレスは LAN または VPN アドレス、ユーザーが運営する逆プロキシ、または公開 Relay URLかもしれません。
現在のQRは、そのアドレスを輸入し、その電話が所有するトークンにその一度の能力を交換します; 古いアドレスだけのQRコードはまだパスワード入力に戻ります。 QR をスキャンするには、 Relayを有効にしたり、必要としたりしない。 ペアリングされた携帯電話は、 セキュリティおよびアクセス の下で個別にレビューおよび撤回することができます。
デフォルトでは HTTPS を使用します。 サーバーが HTTP LAN またはプライベートVPN アドレスを通じて既にアクセス可能である場合、QR を生成する前に このローカル接続でペアリングを許可する を有効にする。 この選択は次の5分間のコードにのみ適用され、生成後に自らをオフにします。
HTTPS インスタンスから Web アプリをインストール
ストアフリーの AirCode Ø クライアントは、あなたのインスタンスをサービスする正確な HTTPS の起源からインストールされます。 管理された Relay、カスタム Relay、または信頼されている HTTPS 逆プロキシがアクティブになった場合:
- 電話またはタブレットの HTTPS インスタンスアドレスを開いて、サインインします。
- 選ぶ Web App をインストール から もっと あるいは Settings → Web App;
- Chromium install prompt を承認するか、または iPhone/iPad ガイド for シェア → Home Screenに追加する
- インストールされたアイコンを起動し、 を有効にし、Push notifications を明示的に you want closed-app alerts. あなたは閉じたアプリの警告を望む。
iPhone および iPadでは、 Web Push アイコンから Web アプリケーションが起動した後にのみ Home Screen が提供されます。 ブラウザおよびオペレーティングシステムは、インストールおよび許可ポンプの責任を残します。 インストールされた Web アプリケーションは 1 つの起源に属します; 別の起源にインスタンスを移動することは、その新しい起源をインストールし、再度サインインすることを意味します。
同じハンドオフを Web アプリケーションのセットアップ から、または Downloadから開始できます。 マーケティングサイトは、アドレスをローカルに検証し、認証、パス、クエリ、およびフラグメントを廃棄し、結果として /?pwa-install=1 を HTTPS オープンします。 インスタンスのアドレスは受け取ったり保存したりしません。
応答型ウェブアプリケーションは、コアワークスペース、セッション、注意要請、ターミナル、ファイル、 Git、ブラウザ/アプリケーション、フォーカスプラン、 Prompt Queue、 Scheduled Tasks、設定、および通知デバイス管理をカバーしています。 Native mobile には、暗号化されたローカルストレージ、セキュアなマルチサーバープロファイル、限られたバックグラウンドワーク、ネイティブファイル/カメラ/シェアフロー、ハプティック、通知チャネル、 aircode:// リンクがあります。 ブラウザストレージは削除され、バックグラウンド実行は保証されず、 iPhone/iPad のインストールは手動です。
ファイアウォール
内蔵トンネルは、入力ポートは必要ありません。 HTTPS と FRPを介してリレーへの出力接続を作成します。 プライベート ネットワーク モードは追加接続が開かず、 VPN はアクセス可能性を決定します。 Fast Preview では、 AirCode Ø サーバーと同じインターフェイスで認証済みのエフェメラルポートを使用するため、制限的なホストファイアウォールは、プライベート ネットワークからこれらのポートへのトラフィックを許可する必要があります。
Docker サンドボックス セッションの場合、このルートはホスト AirCode Ø コントロール フロントで終了します。 ターミナル トラフィックは Docker API を労働者に渡します。 トンネルは自動的に労働者の出荷を運ぶものではなく、コンテナから開発ポートを公開しない。