語言繁體中文
選擇語言適用於公共網站
EnglishFrançaisFrenchDeutschGermanעבריתHebrewРусскийRussian日本語JapaneseالعربيةArabic简体中文Chinese (Simplified)繁體中文Chinese (Traditional)

遠程訪問

AirCode Ø 是由任何地方驅動的,而應用程序、項目、終端和代理仍在您自己的機器上運行。 永遠不要將它暴露在公共互聯網上。

內置遠程訪問

桌面應用程序和服務器包括一個只出口的隧道。 您不需要打開路由器端口或配置動態 DNS:

  1. 在桌面端開啟設定 → 遠端存取，或在響應式網頁和原生行動應用程式中開啟更多 → 伺服器 → 遠端存取。
  2. 連接帳戶，在安全性與存取中設定執行個體密碼，並在連線設定中保持選取 AirCode Ø relay。
  3. 遠端存取會自動啟動。概覽顯示執行個體的 HTTPS 位址和連線狀態。
  4. 開啟該位址，或選擇產生配對 QR 碼，然後在行動應用程式中透過新增伺服器 → 掃描 QR 碼掃描。

帳戶和執行個體密碼準備就緒後，託管遠端存取會自動啟動和重新連線，包括先前設為關閉的情況。不需要點選啟用按鈕或開啟設定對話框。私人和自訂連線仍可在連線設定中選取。Hosted 會自動管理連線；請在 Hosted 設定中修改位址。

您的 AirCode Ø 密碼仍然保護服務器,而應用程序、項目和會話仍然保留在主機上。 如果沒有配置密碼,隧道將拒絕啓動。 配對QR從不包含該密碼:它包含一個隨機功能,在5分鐘後到期,並在第一次成功掃描後停止工作。 然後服務器會給該手機自己的可撤銷代幣。

如果 Windows 安全阻止桌面隧道

AirCode Ø 集合 frpc.exe,創建出口隧道的客戶端。 Windows 安全策略可能會將代理軟件歸類爲潛在不需要的應用程序,並拒絕啓動它。 當 AirCode Ø 檢測到拒絕時,遠程訪問顯示 隧道客戶端無法啓動 使用 查看說明 和 重複 操作。

  1. 選擇 查看說明,然後 打開 Windows 安全。
  2. 打開 病毒和威脅保護 → 保護歷史 並擴展最新版本 潛在不需要的應用程序輸入。
  3. 檢查受影響的文件是否屬於您安裝的 AirCode Ø 文件 信任,其路徑以 \resources\payload\vendor\frpc\frpc.exe. 一個匹配檢測可以被命名爲 PUA:Win32/FRProxy.
  4. 只有當安裝和路徑匹配時,選擇 允許在設備上。
  5. 返回 AirCode Ø 並選擇 返回。

如果檢測名稱或文件路徑不同,請將項目鎖定並單獨檢查。 永遠不要禁用 Windows Security 或爲整個 AirCode Ø 安裝文件夾添加排除。 Microsoft 在其 保護歷史指南中解釋了可用的操作。

命令行設置在 Linux 服務器上

請在請求一個實例之前授權管理的 Relay 帳戶:

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

該設備授權是由同一 Unix 用戶擁有的所有 AirCode Ø 實例共享的。 每個實例都保留了自己的端口、密碼、公共、隧道身份和啓用狀態。 第一次服務啓動完成註冊,隧道在崩潰和重新啓動後重新連接到服務器。

當您已登出、帳戶未啟用或實例沒有密碼時，託管 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 操作員在通過轉換器時可以技術上訪問流量,即使應用程序和會話數據不是作爲正常服務的一部分存儲在那裏。 阻止傳遞檢查的端到端加密尚未提供。

使用 私人網絡只有 與 Tailscale 或其他 VPN,或運行自定義傳遞器,當信任限制不符合您的要求。

Fast preview 和共享瀏覽器

瀏覽器屏幕提供兩種不同的運輸方式:

  • Fast preview 是 localhost 開發的默認值 URL。 這個頁面, 資產,直播重新加載和 HMR WebSockets 直接在觀看設備上渲染; Chromium 不在服務器上運行。 已啓用遠程訪問, AirCode Ø 通過傳遞器創建可撤銷的預覽源。 開啓一次交換 是 HttpOnly Cookie 的訪問鏈接。 您可以添加一個預覽密碼作爲 第二層;私人鏈接仍然需要,密碼僅存儲 作爲本地哈希,失敗的嘗試是率有限的。
  • 共享瀏覽器 在服務器上運行Chromium並流相同的交互式 會話給人員和代理人。 當一個代理需要瀏覽器控制時,選擇它。 診斷、屏幕截圖或痕跡。

關閉 Fast preview 將取消其傳送源。 預覽鏈接即使在啓用密碼時也是訪問功能:不要發佈它們。

Tailscale 或您自己的 VPN

若不使用 AirCode Ø 傳感器,請打開 遠程訪問 → 設置 ,然後選擇 私人網絡僅爲。 AirCode Ø 然後不會打開公共隧道。

安裝 Tailscale 在服務器和您的設備上。 AirCode Ø 會自動檢測和綁定 tailnet IP ;從另一臺設備打開 http://<tailnet-ip>:7860 。 tailscale serve 可以添加 HTTPS 用真正的證書:

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

第一個運行可能會打印一個 admin-console 鏈接,以在 tailnet 上啓用 Serve/HTTPS (一次,單擊交換機)。

WireGuard、ZeroTier 或 SSH 隧道 (ssh -L 7860:localhost:7860 server) 以相同的方式工作。

定製傳感器

組織可以從 AirCode Ø 源樹運行三容器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,並且主機將設備的內部 CA 和服務器名稱從經過驗證的 HTTPS 登錄響應中引入。

許多員工可以共享一個 Relay。 這不會將一個 AirCode Ø 實例轉化爲一個安全的多用戶服務器:使用一個Unix帳戶、容器或虛擬機和每個員工的一個實例,直到實現同一實例角色和執行隔離。

桌面和移動應用程序

使用服務器 URL + 密碼手動添加連接,或者在 設置 → 安全與訪問 → 配對手機下生成一次性 QR 代碼。 連接和配對設備代幣存儲在平臺的安全身份存儲中。 桌面應用程序在左下角狀態指示器中顯示活躍的服務器 - 點擊它以切換或添加服務器(本地或遠程)。

原生移動應用程序首先需要一個已經可訪問的服務器地址。 一旦連接, 更多 → 服務器 → 遠程訪問 將管理該實例與桌面和響應式 Web 相同的服務器所有狀態:管理的 Relay 帳戶,連接方法,自定義的 Relay 登錄,公共 URL 前綴,自動連線和重新連線,現場 URL 和永久的 URL 旋轉。 帳戶憑證、一次性註冊授權和隧道身份保留在服務器上,而不是在電話配置文件中。 移動地址可以是 LAN 或 VPN 地址,也可以是用戶操作的反向代理,也可以是公共的 Relay URL。

當前的QR導入該地址並將其一次性能力交換爲該電話所擁有的代幣;舊的僅僅地址的QR代碼仍然返回密碼輸入。 掃描 QR 不會激活或需要 Relay。 配對的手機可以單獨審查和撤銷 安全和訪問 在網絡上,響應式網絡或本地移動。

配對使用 HTTPS 默認。 當服務器已經可以通過 HTTP LAN 或私人VPN 地址訪問時,在生成 QR 之前,啓用 允許在本地連接上的對接 。 此選項僅適用於下一個五分鐘的代碼,並在生成後自動關閉。

從 HTTPS 實例中安裝 Web 應用程序

免費的 AirCode Ø 客戶端安裝於您實例的準確 HTTPS 來源。 一旦管理的 Relay、自定義的 Relay或您自己的受信任的 HTTPS 反向代理程序是活躍的:

  1. 打開手機或平板電腦上的 HTTPS 實例地址,然後登錄;
  2. 選擇 安裝 Web App 從 更多 或 設置 → Web App;
  3. 接受 Chromium 安裝提示,或遵循 iPhone/iPad 指南 分享 添加到 Home Screen;
  4. 打開已安裝的圖標,然後啓用 明確發佈通知 ,如果 你想要的關閉應用程序警報。

在 iPhone 和 iPad中, Web Push 僅在從其 Home Screen 圖標啓動 Web 應用程序後才提供。 瀏覽器和操作系統仍然負責安裝和許可提示。 一個安裝的 Web 應用程序屬於一個源頭;將一個實例移動到另一個源頭意味着安裝該新源頭並再次登錄。

您可以從專用的 Web 應用程序設置 或從 下載開始同樣的操作。 市場營銷網站在本地驗證地址,丟棄憑證、路徑、查詢和片段,並只在結果的 HTTPS 來源上打開 /?pwa-install=1 。 它不會接收或保留實例地址。

響應式 Web 應用程序涵蓋了核心工作空間、會話、注意請求、終端、文件、 Git、瀏覽器/應用程序、焦點計劃、 Prompt Queue、 Scheduled Tasks、設置和通知設備管理。 Native mobile 仍然具有更深入的操作系統集成:加密的本地存儲,安全的多服務器配置文件,有限的背景工作,本地文件/攝像頭/共享流,觸摸,通知渠道和 aircode:// 鏈接。 瀏覽器存儲可以被驅逐,背景執行不保證, iPhone/iPad 安裝手動。

防火牆

內置隧道不需要入口端口。 它通過 HTTPS 和 FRP對傳感器進行輸出連接。 隱私網絡模式不會打開額外的連接;您的 VPN 決定可達性。 快速預覽使用與 AirCode Ø 服務器相同的界面上經過驗證的簡歷端口,因此,限制性主機防火牆必須允許從私人網絡到這些端口的流量。

對於 Docker 沙盒 會話,該路線仍然在主機 AirCode Ø 控制平面結束。 接下來,終端流量將通過 Docker API 到達工人。 隧道不會自動攜帶工人退出,也不會從集裝箱發佈開發端口。