Ваш ноутбук — це редактор і браузер. Код, сервіси та агенти залишаються на вашому сервері.
Ваша власна 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 підключення зупинялося на цьому кроці.
Підключення крок за кроком
- Встановіть Tailscale на ноутбук і увійдіть у той самий обліковий запис Tailscale, що й ваш сервер. У Linux цей крок можна пропустити: якщо Tailscale немає,
rdev laptop connectвстановить його з офіційного репозиторію Tailscale й почне вхід, який ви завершите в браузері. - Встановіть 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, 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.