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

远程访问

AirCode Ø 是由任何地方驱动的,而应用程序、项目、终端和代理仍在您自己的机器上运行。 永远不要将它暴露在公共互联网上。

内置远程访问

桌面应用程序和服务器包括一个只出口的隧道。 您不需要打开路由器端口或配置动态 DNS:

  1. 在桌面端打开设置 → 远程访问，或在响应式网页和原生移动应用中打开更多 → 服务器 → 远程访问。
  2. 连接账户，在安全与访问中设置实例密码，并在连接设置中保持选中 AirCode Ø relay。
  3. 远程访问会自动启动。概览显示实例的 HTTPS 地址和连接状态。
  4. 打开该地址，或选择生成配对二维码，然后在移动应用中通过添加服务器 → 扫描二维码进行扫描。

账户和实例密码准备就绪后，托管远程访问会自动启动和重新连接，包括之前设为关闭的情况。无需点击激活按钮或打开设置对话框。私有和自定义连接仍可在连接设置中选择。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 到达工人。 隧道不会自动携带工人退出,也不会从集装箱发布开发端口。