Введите не менее двух букв, чтобы искать по всем страницам документации.

↑ ↓ для навигации ↵ чтобы открыть esc чтобы закрыть

Работа с rdev

Подключение ноутбука

Ваш ноутбук — это редактор и браузер. Код, сервисы и агенты остаются на вашем сервере.

Ваш собственный tailnet

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

Синхронизация файлов

rdev поддерживает синхронизацию файлов проекта между ноутбуком и сервером в обе стороны. Папки, которые не нужно передавать, такие как node_modules, vendor и результаты сборки, игнорируются с самого начала.

Что синхронизируется, вы выбираете в панели, в разделе Дашборд > ваш сервер > Настройки:

  • Синхронизация с ноутбуками: выключите, чтобы работать полностью удалённо. На ноутбук ничего не копируется; редактор открывает проекты по SSH (ssh rdev, VS Code или Cursor Remote-SSH, PhpStorm Gateway). Сайты и .dev.test продолжают работать.
  • Проекты на ноутбуках: снимите отметку с проекта, чтобы он оставался только на сервере. Уже имеющаяся копия на ноутбуке не трогается, поэтому удалите её, когда она вам больше не нужна. Когда проект снова начнёт синхронизироваться, более старая копия на ноутбуке сначала переместится в ~/Code-rdev-old/, а копия с сервера будет загружена.
  • Никогда не синхронизируется: исключения по умолчанию, каждое из которых можно отключить, а также ваши собственные шаблоны в синтаксисе, похожем на .gitignore.

Ноутбуки применяют новые правила в течение нескольких минут. Выполните rdev laptop sync, чтобы применить их сразу.

Редакторы и браузер

Используйте привычный редактор, например VS Code или PhpStorm, на синхронизированных файлах. Открывайте свои сайты в привычном браузере по адресу https://<name>.dev.test; приложение для ноутбука настраивает разрешение имён и доверенный сертификат для этих адресов.

Обмен файлами

Терминал на вашем сервере не может вставить файл, поэтому rdev даёт вашему агенту общую папку. Всё, что лежит в ~/rdev-share на ноутбуке, в течение нескольких секунд копируется в ~/Share/<laptop name> на сервере, даже когда синхронизация файлов выключена; у каждого ноутбука там своя папка, поэтому несколько ноутбуков могут делиться файлами одновременно. Попросите агента «посмотреть последний скриншот» или «открыть файл, который я только что отправил», и он откроет самый новый. Подходят любые файлы: изображения, PDF, логи, выгрузки.

  • Send clipboard в приложении (а также в значке в строке меню или в трее) отправляет файлы, скопированные в Finder, Проводнике или вашем файловом менеджере, а если их нет, то изображение из буфера обмена. Оно ждёт, пока файлы дойдут до сервера, и помещает их пути на сервере в буфер обмена; вставьте их агенту. В терминале: rdev laptop share send или rdev laptop share send <files>.
  • Перетащите файлы в окно приложения, чтобы отправить их так же.
  • В обратную сторону: файлы, которые агент кладёт в ~/Share/<laptop name>/out на сервере, приходят в ~/rdev-share/from-server на ноутбуке. Попросите его «положить отчёт в out».
  • Save macOS screenshots here заставляет Shift-Command-3, 4 и 5 сохранять в ~/rdev-share (rdev laptop share macos). Приложения для скриншотов, такие как Shottr или CleanShot, тоже могут сохранять туда.
  • Файлы удаляются через 7 дней с обеих сторон; измените это в Keep files for (days) в приложении или командой rdev laptop share keep <days> (0 хранит их). Файлы в папке keep никогда не удаляются.
  • Файлы больше 500 МБ не отправляются; переносите их через scp или rsync. Всё идёт прямо на ваш сервер и никогда не проходит через rdev.cloud. Выключите обмен переключателем в приложении или командой rdev laptop share off.

До 1.2.0 это была папка для скриншотов: ~/rdev-shots сама переезжает в ~/rdev-share, а ~/Shots в ~/Share, и ~/Shots продолжает работать как ссылка.

Поддерживаемые ноутбуки

Приложение для ноутбука и rdev laptop работают на macOS (Apple silicon и Intel), Linux (x64 и ARM64) и Windows 10 и 11 (x64 и ARM64); приложение можно скачать на странице загрузки. В Linux его можно установить одной командой, которая берёт .deb в Debian и Ubuntu, .rpm в Fedora и AppImage в остальных случаях, например в Arch и CachyOS: curl -fsSL https://rdev.cloud/install | sh -s -- app. AppImage помещается в ~/.local/bin и появляется в меню приложений; если вы переместите файл, приложение обновит эту запись, чтобы она по-прежнему указывала на него (1.4.4 или новее). Если вы скачиваете .deb самостоятельно, устанавливайте его из /tmp (sudo apt install /tmp/rdev-linux-arm64.deb или -x64); из домашней папки apt тоже работает, но замечает, что его пользователь песочницы не может прочитать файл. В Linux rdev направляет *.dev.test на ваш сервер через systemd-resolved, который используется в большинстве дистрибутивов. Если он выключен или замаскирован, как в некоторых образах виртуальных машин, rdev laptop connect сообщает об этом и показывает, как его включить: sudo systemctl unmask systemd-resolved && sudo systemctl enable --now systemd-resolved, затем sudo ln -sf /run/systemd/resolve/stub-resolv.conf /etc/resolv.conf и подключитесь снова. Когда NetworkManager держит собственный /etc/resolv.conf рядом с работающим systemd-resolved (Tailscale тогда сообщает, что они «wired together incorrectly»), запросы никогда не доходят до маршрута rdev; rdev laptop connect и rdev laptop status сообщают об этом (1.4.4 или новее), и та же команда ln -sf это исправляет. rdev добавляет свой сертификат в доверенные сертификаты системы в Debian, Ubuntu, Fedora, openSUSE, Arch и CachyOS; до 1.4.4 в Arch и CachyOS подключение останавливалось на этом шаге.

Подключение шаг за шагом

  1. Установите Tailscale на ноутбук и войдите в тот же аккаунт Tailscale, который использует ваш сервер. В Linux этот шаг можно пропустить: если Tailscale отсутствует, rdev laptop connect устанавливает его из официального репозитория Tailscale и запускает вход, который вы завершаете в браузере.
  2. Установите rdev на ноутбук и подключите его. Выполните это в терминале от своего имени и введите пароль ноутбука, когда его спросят; он нужен, чтобы установить rdev, сделать сертификат доверенным и настроить разрешение имён:
curl -fsSL https://rdev.cloud/install | sh -s -- laptop

Команда устанавливает rdev и запускает rdev laptop connect, которая находит ваш сервер в вашем tailnet, добавляет запись rdev в вашу конфигурацию SSH, делает сертификат вашего окружения доверенным, направляет *.dev.test на ваш сервер и начинает синхронизировать вашу папку ~/Code с ~/Code на сервере.

Ничего другого предварительно устанавливать не нужно. Если инструмент синхронизации файлов отсутствует, rdev устанавливает зафиксированную копию с проверкой контрольной суммы в ~/.local/share/rdev/bin; уже имеющийся у вас используется как есть. В Linux он также устанавливает через ваш менеджер пакетов, при том же запросе пароля, инструменты буфера обмена, используемые для скриншотов (wl-clipboard, xclip), и certutil, который добавляет сертификат в Chrome. Если при установке вы дали серверу другое имя, добавьте --server <name>; чтобы синхронизировать другую папку, добавьте --code-dir <folder>. Выполняйте rdev laptop connect снова, когда захотите повторить настройку.

Прежде чем спросить пароль, rdev laptop connect проверяет папку, которую собирается синхронизировать. Он останавливается и предлагает --code-dir <папка>, если эту папку или папку над ней уже синхронизирует другой сеанс синхронизации (синхронизация ещё и с rdev копировала бы всё между тремя машинами); запустите его с --force или выберите в приложении Всё равно синхронизировать, чтобы всё же синхронизировать её. Папка больше 5 ГБ тоже подключается, с пометкой, что первая синхронизация займёт время (rdev 1.1.10 и новее; раньше он останавливался).

На Mac, который уже направляет dev.test куда-то ещё, например на другой сервер разработки, rdev откладывает эту настройку в сторону и возвращает её, когда вы отключаетесь или удаляете rdev.

В Windows команда curl выше не подходит: установите приложение со страницы загрузки и подключайтесь из него. Начиная с версии приложения для ноутбука 1.4.2 приложение также устанавливает команду rdev в %USERPROFILE%\.local\share\rdev\bin и добавляет эту папку в ваш PATH; чтобы пользоваться ею, откройте новый терминал. Права администратора не нужны, а обновляется команда вместе с приложением.

Если приложение продолжает показывать Check connection, пока файлы синхронизируются, а rdev laptop status выводит *.dev.test resolves to …, not the server, загляните на страницу DNS консоли администрирования Tailscale. Запись split DNS для dev.test, указывающая на другой компьютер, например на старый сервер, в Windows имеет приоритет над настройкой rdev. Удалите её или направьте на ваш сервер.

Проверить подключение можно в любой момент командой rdev laptop status. rdev laptop disconnect останавливает синхронизацию и удаляет настройки; ваши файлы остаются с обеих сторон.

Удаление rdev с ноутбука

rdev laptop uninstall

Команда отключает ноутбук, перестаёт доверять сертификату вашего окружения и удаляет команду rdev, её настройки и установленные ею инструменты. Ваша синхронизированная папка и ~/rdev-share остаются. Инструмент синхронизации, установленный rdev, тоже остаётся, пока его используют другие сессии синхронизации. Она один раз запрашивает пароль ноутбука и требует rdev 0.2.0-beta.21 или новее.

Ваш ноутбук должен иметь возможность входить на сервер: установщик копирует SSH-ключи, которым разрешён вход на сервер на момент установки. Чтобы добавить другой ноутбук, добавьте его публичный ключ на странице вашего сервера в панели в разделе SSH-ключи (по одному в строке, так что можно сразу несколько компьютеров; при добавлении ключа ему можно дать имя, например «Рабочий ноутбук», иначе показывается имя в конце ключа); сервер пустит его в течение нескольких секунд. Для этого нужен rdev 0.2.0-beta.33 или новее; до этого поместите ключ в /opt/rdev/home/.ssh/authorized_keys на сервере. Если rdev laptop connect сообщает, что не может войти, не хватает именно этого.

После подключения откройте терминал на сервере командой ssh rdev и запустите там своего агента; открывайте свои сайты в браузере по адресу https://<folder>.dev.test. rdev open <проект> открывает терминал на сервере сразу в папке проекта, в вашей постоянной сессии; без имени выводит список проектов (rdev 1.1.11 и новее).

Приложение для Mac

Предпочитаете щёлкать мышью, а не печатать? Скачайте приложение rdev для Mac (Apple silicon и Intel, подписано и нотаризовано Apple), перетащите его в «Программы» и откройте. Оно показывает, подключён ли ноутбук, подключает и отключает одной кнопкой и открывает терминал на вашем сервере. Оно выполняет ту же настройку, что и rdev laptop connect, поэтому вам нужен Tailscale (шаг 1), но не команда; инструмент синхронизации приложение устанавливает само. Перед подключением можно изменить папку, в которую синхронизируются ваши проекты (по умолчанию ~/Code), — это версия --code-dir в приложении.

При первом запуске приложение проводит через настройку шаг за шагом, а вкладки открываются только после успеха каждого шага: войдите аккаунтом rdev, проверьте, что Tailscale установлен и вход выполнен, выберите сервер из аккаунта, пустите этот ноутбук (приложение само добавит его SSH-ключ на сервер, создав ключ, если его нет), выберите кнопкой Обзор… папку для синхронизации проектов и подключитесь. Позже Сменить сервер на вкладке Sites заново настраивает ноутбук для другого сервера. Если сервера ноутбука больше нет, он недоступен или исчез из аккаунта, приложение сообщает об этом и предлагает Настроить заново. В обоих случаях файлы остаются на месте. Если команда rdev старше приложения, во вкладке About появляется кнопка Запустить в терминале, которая открывает терминал с командой обновления.

В приложении семь вкладок:

  • Сайты: ваши проекты в виде ссылок https://<name>.dev.test, терминал на сервере и ваши общие файлы. У каждого сайта есть Open in Terminal: открывает терминал в папке этого проекта на сервере. На вкладке Sites также есть кнопки Mail и Dumps, которые открывают страницы перехваченной почты и дампов. Есть также кнопка Web terminal, открывающая веб-терминал. Также есть кнопка Errors, которая открывает отслеживание ошибок.
  • Синхронизация: те же настройки, что и в панели (синхронизация вкл. или выкл., проекты на этом ноутбуке, исключения). Сохранение применяет их на этом ноутбуке сразу.
  • Env: чтение и изменение .env проекта на сервере. Приложение работает через SSH-соединение, поэтому показывает текущие значения, и они никогда не проходят через rdev.cloud.
  • Gotify: если ваши уведомления идут на сервер Gotify, приложение слушает его и показывает каждое сообщение как уведомление на рабочем столе со звуком. Введите адрес сервера и клиентский токен (Gotify Clients); добавьте токен приложения (Gotify Apps), чтобы отправить тестовое сообщение. Токены остаются на этом ноутбуке.
  • Интеграции: доступ вашего сервера к Git: его ключ, сколько угодно аккаунтов GitHub, GitLab, Bitbucket и других (у каждого свой SSH-ключ или токен), хосты, ожидающие доверия, и проверка доступа. Токены передаются на сервер по SSH, никогда через rdev.cloud.
  • Настройки: терминал, который открывает Terminal on the server (любой установленный, например Terminal, iTerm2 или Warp; запоминается, пока вы его не смените), значок в строке меню (монохромный, подстраивающийся под светлую или тёмную строку меню, или цветной значок приложения), синхронизация скриншотов и ваш аккаунт: выберите Sign in with rdev.cloud, подтвердите пароль в браузере, убедитесь, что показан тот же код, и одобрите. Авторизованные приложения перечислены, и их можно отключить в разделе Настройки > Подключённые приложения в вашей панели.
  • О программе: версии приложения и команды rdev, а также последняя версия приложения на rdev.cloud.

Встроенный терминал

Terminal on the server открывает встроенный терминал rdev: отдельное окно, которое можно растянуть, развернуть или открыть на весь экран и которое снова открывается в последнем размере. Он входит через ssh rdev и подключается к постоянному сеансу сервера, поэтому закрытие окна или обрыв сети никогда не останавливают агента; если соединение пропало, терминал сам переподключается, и вы оказываетесь там же, где остановились.

  • Копирование и вставка: Cmd-C и Cmd-V в macOS, Ctrl-Shift-C и Ctrl-Shift-V в Linux и Windows. Текст, скопированный на сервере, например в vim, попадает в буфер обмена ноутбука. Если скриншоты включены, вставка изображения отправляет его на сервер и вставляет путь к нему, готовый для агента.
  • Shift-Enter начинает новую строку в запросе Claude Code.
  • Поиск — Cmd-F (Ctrl-Shift-F в Linux и Windows); размер текста — Cmd и +, − или 0 (Ctrl в Linux и Windows).
  • Ссылки открываются в браузере, включая сайты https://<имя>.dev.test. Если окно в фоне и терминал подаёт звуковой сигнал, например когда агенту нужны вы, приходит уведомление.
  • Open in an external terminal открывает тот же сеанс в приложении-терминале: кнопка рядом с Terminal on the server, меню значка в строке меню или Cmd-Shift-O (Ctrl-Shift-O) во встроенном терминале. Чтобы сделать приложение-терминал основным, выберите его в Settings. Какое приложение использовать, выбирает External terminal в Settings; сначала это ранее выбранное приложение терминала, а на Mac — Terminal.

Приложение проверяет наличие новой версии при запуске, каждые шесть часов и когда вы открываете О программе. Если она есть, полоса над вкладками сообщает об этом: выберите Обновить, и приложение скачает её, проверит подпись, установит и перезапустится (в Linux .deb и .rpm запрашивают пароль; в Windows установщик запускается сам). Для обновления из приложения нужна версия 0.2.0-beta.34 или новее; более старые версии один раз установите поверх вручную. Команда rdev на ноутбуке обновляется отдельно: снова выполните команду установки, curl -fsSL https://rdev.cloud/install | sh -s -- laptop. В Windows она поставляется вместе с приложением и обновляется вместе с ним. Если команда старше приложения, About показывает эту команду с кнопкой копирования.

Закрытие окна оставляет rdev в строке меню и убирает его из Dock и Cmd-Tab; Quit в меню значка в строке меню или Cmd-Q завершают его.

В Settings (приложение для ноутбука 1.4.3 или новее) Open at login запускает rdev в фоне при входе в систему, сразу в строке меню или в системном трее, а Keep running when the window is closed (по умолчанию включено) определяет, останется ли rdev там после закрытия окна или завершится. Когда параметр включён, синхронизация файлов и уведомления продолжают работать при закрытом окне. GNOME показывает значки в трее только с расширением AppIndicator (в Ubuntu оно есть); без него после закрытия окна не остаётся значка, на который можно нажать, поэтому откройте rdev снова из меню приложений. Приложение предупреждает об этом в Settings (приложение для ноутбука 1.4.4 или новее). Запуск при входе не требует прав администратора: rdev добавляет элемент входа только для вашего пользователя (launch agent в macOS, запись autostart в Linux, запись Run в реестре вашего пользователя в Windows).

Пока приложение работает, оно также применяет правила синхронизации из панели каждые пять минут.

Firefox хранит собственный список сертификатов. В Linux rdev добавляет свой сертификат в Chrome и в каждый найденный профиль Firefox, включая snap-версию Firefox, которую поставляет Ubuntu, и версию Flatpak (rdev 0.2.0-beta.34 или новее); после этого перезапустите Firefox. Для профиля Firefox, созданного позже, или на macOS и Windows импортируйте ~/.config/rdev/ca.pem в разделе Settings > Privacy & Security > Certificates.