Удаленный доступ

AirCode Ø создан для управления из любого места, в то время как приложения, проекты, терминалы и агенты продолжают работать на вашей собственной машине. Никогда не раскрывайте его не аутентично в общественном Интернете.

Встроенный удаленный доступ

Десктопное приложение и сервер включают в себя туннель только для выхода. Вам не нужно открывать порт маршрутизатора или настраивать динамический DNS:

1. Откройте Настройки → Удалённый доступ на компьютере или Ещё → Серверы → Удалённый доступ в адаптивной веб-версии и нативном мобильном приложении.
2. Подключите аккаунт, задайте пароль экземпляра в разделе Безопасность и доступ и оставьте AirCode Ø relay выбранным в Настройках подключения.
3. Удалённый доступ запускается автоматически. Обзор показывает HTTPS-адрес экземпляра и состояние подключения.
4. Откройте этот адрес или выберите Создать QR-код сопряжения и отсканируйте его через Добавить сервер → Сканировать QR-код в мобильном приложении.

Управляемый удалённый доступ запускается и переподключается автоматически, когда аккаунт и пароль экземпляра готовы, в том числе после прежнего отключения. Действие активации и диалог настройки не нужны. Частные и собственные подключения остаются доступны в Настройках подключения. Hosted управляет соединением автоматически; адрес изменяется в настройках Hosted.

Пароль AirCode Ø по-прежнему защищает сервер, а приложения, проекты и сессии остаются на хост-машине. Туннель отказывается от запуска, если пароль не настроен. В параллельном QR никогда не содержится этот пароль: он содержит случайную возможность, которая истекает через пять минут и прекращает работу после первого успешного сканирования. Затем сервер дает этому телефону свой собственный отзывчивый токен.

Если Windows Безопасность блокирует туннель рабочего стола

AirCode Ø связывает frpc.exe, клиент, который создает выходной туннель. Политика безопасности Windows может классифицировать прокси-программное обеспечение как потенциально нежелательное приложение и отказаться от его запуска. Когда AirCode Ø обнаруживает отказ, удаленный доступ показывает Клиент туннеля не мог запустить с Показания и Повторные действия .

1. Выберите Показать инструкции, а затем Открыть Windows Security.
2. Откройте Вирус и защита от угроз → История защиты и расширите последнюю версию Потенциально нежелательный вход в приложение.
3. Убедитесь в том, что пострадавший файл принадлежит к установке AirCode Ø , которую вы доверие и что его путь заканчивается с \resources\payload\vendor\frpc\frpc.exe. Соответствующее обнаружение может быть названо PUA:Win32/FRProxy.
4. Только при сопоставлении установки и пути выберите Разрешить на устройстве.
5. Вернитесь к AirCode Ø и выберите Retry.

Если имя обнаружения или путь файла отличаются, оставьте объект заблокированным и проверьте его отдельно. Никогда не деактивируйте Windows Security или не добавляйте исключения для всей инсталляционной папки AirCode Ø . Microsoft объясняет доступные действия в руководстве по истории защиты История охраны Руководство.

Настройка командной строки на сервере Linux

Авторизируйте управляемую учетную запись Relay , прежде чем запрашивать ее в качестве примера:

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

Авторизация устройства используется всеми инстанциями AirCode Ø , принадлежащими одному и тому же пользователю Unix. Каждая инстанция сохраняет свой порт, пароль, публичный шлюг, туннельную идентификацию и разрешенное состояние. Первая служба запуска завершает регистрацию, а туннель восстанавливает связь с сервером после аварий и перезагрузок.

Управляемый 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/private-network-only. Управляемый Relay запускается автоматически, когда аккаунт и пароль готовы.

Управляемая граница доверия реле

Текущий управляемый релей прекращает TLS , прежде чем перенаправить аутентифицированный трафик на хост AirCode Ø . Таким образом, операторы Relay могут технически получить доступ к трафику во время его прохождения через реле, даже если данные приложений и сеансов не хранятся там в рамках обычной службы. Шифрование от конечного до конечного, которое предотвращает проверку релей, пока не доступно.

Используйте Приватная сеть только с Tailscale или другой VPN, или эксплуатируйте настраиваемый реле, когда этот предел доверия не соответствует вашим требованиям.

Fast preview и Общий браузер

Экран браузера предлагает два разных вида транспорта:

• Fast preview является стандартным для разработки localhost URL. На этой странице, активы, живая перезагрузка и HMR WebSockets рендеринг непосредственно на устройстве просмотра; Chromium не работает на сервере. Удаленный доступ, AirCode Ø создает отозванный источник просмотра через реле. Открыть его, когда обмен ссылка на доступ к HttpOnly cookie. Вы можете добавить пароль для предварительного просмотра, как второй слой; личная ссылка все еще необходима, пароль хранится только как локальный хеш, и неудачные попытки ограничены темпом.
• Общий браузер запускает Chromium на сервере и передает тот же интерактивный сеанс для людей и агентов. Выберите его, когда агент нуждается в контроле браузера, диагностика, скриншоты или следы.

Закрытие Fast preview отменяет происхождение реле. Ссылки для предварительного просмотра являются возможностями доступа даже при включении пароля: не публикуйте их.

Tailscale или ваш собственный VPN

Для доступа peer-to-peer без реле 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"

Первый запуск может напечатать ссылку admin-console, чтобы включить Serve/HTTPS на вашей tailnet (однократный, один клик переключатель).

WireGuard, ZeroTier или тоннель SSH (ssh -L 7860:localhost:7860 server) работают так же.

Настройка реле

Организации могут запускать трехконтейнерный Caddy + FRP + регистрационный прибор из источника AirCode Ø . Он сохраняет данные приложений и проектов на хостах сотрудников, закрывает регистрацию новых машин по умолчанию и предоставляет каждому экземпляру независимую идентификацию туннеля.

На хостере 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, контейнер или VM и один экземпляр на каждого сотрудника, пока не будут реализованы роли одного экземпляра и изоляция выполнения.

Десктопные и мобильные приложения

Добавьте соединение вручную с сервером URL + пароль, или создайте одноразовый QR-код в разделе Настройки → Безопасность и доступ → Сравнение телефона. Подключения и токены пары устройств хранятся в защищенном хранилище аккредитации платформы. Настольное приложение показывает активный сервер в нижнем левом показателе состояния — нажмите его, чтобы переключить или добавить серверы (локальный или удаленный).

Народному мобильному приложению сначала нужен уже доступный серверный адрес. После подключения More → Server → Remote Access управляет этим экземпляром с тем же состоянием, принадлежащим серверу, как настольный компьютер и откликнувшийся веб: управляемая учетная запись Relay , метод подключения, пользовательская регистрация Relay , общедоступная префикс URL , автоматическое подключение и переподключение, живая ротация URL и постоянная ротация URL . Аккаунт, однократная регистрация и туннельная идентификация остаются на сервере, а не в телефонном профиле. Мобильный адрес может быть LAN или VPN , обратный прокси, управляемый пользователем, или публичный Relay URL.

Текущий QR импортирует этот адрес и обменивает его одноразовые возможности на токен, принадлежащий этому телефону; старые только адреса QR-коды все еще возвращаются к вводу пароля. Сканирование QR не активирует или не требует Relay. Спарные телефоны можно просмотреть и отозвать индивидуально в разделе Security & access на веб-сайте, в ответном веб-сайте или на мобильном устройстве.

Подключение использует HTTPS по умолчанию. Когда сервер уже доступен через HTTP LAN или частный адресVPN , включите Разрешить пары на этом локальном соединении перед созданием QR. Этот выбор применяется только к следующему пятиминутному коду и отключается после генерации.

Установите веб-приложение с инстанции HTTPS

Клиент AirCode Ø , свободный от магазина, устанавливается с точного источника HTTPS , который обслуживает ваш инстанция. Как только управляемый Relay, пользовательский Relay или ваш собственный доверенный HTTPS обратный прокси будет активным:

1. открыть адрес инстанции HTTPS на телефоне или планшете и войти;
2. выбрать Установите веб-приложение от Больше или Настройки → Веб-приложение;
3. согласитесь с указанием об установке Chromium или следуйте руководству iPhone/iPad для Добавить Добавить Добавить Home Screen;
4. Запустить установленную иконку, а затем включить Пожаловать уведомления явно, если вы хотите закрытые приложения оповещения.

На iPhone и iPad Web Push предлагается только после того, как веб-приложение запущено с его значка Home Screen . Браузер и операционная система остаются ответственными за установку и разрешения. Одно установленное веб-приложение принадлежит одному источнику; перемещение инстанции в другой источник означает установку нового источника и повторное вхождение.

Вы можете запустить тот же handoff из специальной настройки веб-приложений Web App настройте или из Download. Маркетинговый сайт локально проверяет адрес, отбрасывает идентификационные данные, пути, запросы и фрагменты и открывает только /?pwa-install=1 по полученному происхождению HTTPS . Он не получает и не сохраняет адрес инстанции.

Реактивное веб-приложение охватывает основное рабочее пространство, сессии, запросы внимания, терминалы, файлы, Git, браузер/приложения, планы фокуса, Prompt Queue, Scheduled Tasks, настройки и управление уведомлениями-устройствами. Native Mobile по-прежнему имеет более глубокую интеграцию с операционной системой: зашифрованное локальное хранилище, защищенные многосерверные профили, ограниченная работа на фоне, потоки файлов/камеры/распределения, хаптики, каналы уведомлений и ссылки aircode:// . Хранилище браузера может быть вытеснено, выполнение на фоне не гарантировано, а установка iPhone/iPad выполняется вручную.

Защитные стены

Встроенный туннель не требует входного порта. Он делает выходной соединения с реле через HTTPS и FRP. Частный сетевой режим не открывает дополнительного соединения; ваш VPN определяет доступность. Быстрые просмотры используют аутентифицированные эфемерические порты на том же интерфейсе, что и сервер AirCode Ø , поэтому ограничительная брандмауэр хоста должна позволять трафик из частной сети в эти порты.

Для сеанса Docker песочницы этот маршрут все еще заканчивается на контрольном плане хоста AirCode Ø . Терминальный трафик затем пересекает Docker API к работнику. Туннель не автоматически несет рабочий выход и не публикует порты разработки из контейнера.