Twój laptop to edytor i przeglądarka. Kod, usługi i agenci zostają na Twoim serwerze.
Twój własny tailnet
Laptop i serwer rozmawiają przez prywatną sieć Tailscale, która należy do Twojego konta Tailscale. rdev nigdy do niej nie dołącza. Instalator łączy Twój serwer kluczem z Twojego konta, a aplikacja na laptopa łączy laptop.
Synchronizacja plików
rdev utrzymuje pliki projektów zsynchronizowane między laptopem a serwerem, w obu kierunkach. Foldery, które nie muszą podróżować, takie jak node_modules, vendor i wyniki budowania, są ignorowane od początku.
To, co się synchronizuje, wybierasz w panelu, w Panel > Twój serwer > Ustawienia:
- Synchronizuj z laptopami: wyłącz, aby pracować w pełni zdalnie. Nic nie jest kopiowane na laptop; edytor otwiera projekty przez SSH (
ssh rdev, VS Code lub Cursor Remote-SSH, PhpStorm Gateway). Witryny i.dev.testnadal działają. - Projekty na laptopach: odznacz projekt, aby zachować go tylko na serwerze. Kopia już obecna na laptopie zostaje nietknięta, więc usuń ją, gdy nie będzie już potrzebna. Gdy projekt później znów zacznie się synchronizować, starsza kopia z laptopa jest najpierw przenoszona do
~/Code-rdev-old/, a kopia serwera schodzi na laptop. - Nigdy nie synchronizowano: domyślne wykluczenia, z których każde możesz wyłączyć, oraz Twoje własne wzorce w składni podobnej do
.gitignore.
Laptopy stosują nowe reguły w ciągu kilku minut. Uruchom rdev laptop sync, aby zastosować je od razu.
Edytory i przeglądarka
Używaj edytora, który już znasz, takiego jak VS Code lub PhpStorm, na zsynchronizowanych plikach. Otwieraj swoje witryny w zwykłej przeglądarce pod adresem https://<name>.dev.test; aplikacja na laptopa konfiguruje rozpoznawanie nazw i zaufany certyfikat dla tych adresów.
Udostępnianie plików
Terminal na serwerze nie potrafi wkleić pliku, więc rdev daje Twojemu agentowi wspólny folder. Wszystko w ~/rdev-share na laptopie jest kopiowane do ~/Share/<laptop name> na serwerze w ciągu kilku sekund, nawet gdy synchronizacja plików jest wyłączona; każdy laptop ma tam własny folder, więc kilka laptopów może udostępniać jednocześnie. Poproś agenta, aby „spojrzał na ostatni zrzut ekranu” albo „otworzył plik, który właśnie wysłałem”, a otworzy najnowszy. Działa każdy rodzaj pliku: obrazy, PDF-y, logi, eksporty.
- Wyślij schowek w aplikacji (także w ikonie na pasku menu lub w zasobniku) wysyła pliki skopiowane w Finderze, Eksploratorze lub menedżerze plików, a w przeciwnym razie obraz ze schowka. Czeka, aż dotrą na serwer, i wkłada do schowka ich ścieżki na serwerze; wklej je agentowi. W terminalu:
rdev laptop share sendlubrdev laptop share send <files>. - Upuść pliki na okno aplikacji, aby wysłać je w ten sam sposób.
- W drugą stronę: pliki, które agent umieści w
~/Share/<laptop name>/outna serwerze, trafiają do~/rdev-share/from-serverna laptopie. Poproś go, aby „wrzucił raport do out”. - Zapisuj zrzuty macOS tutaj sprawia, że Shift-Command-3, 4 i 5 zapisują do
~/rdev-share(rdev laptop share macos). Aplikacje do zrzutów, takie jak Shottr czy CleanShot, też mogą tam zapisywać. - Pliki są usuwane po 7 dniach po obu stronach; zmień to w Przechowuj pliki (dni) w aplikacji lub poleceniem
rdev laptop share keep <days>(0 je zachowuje). Pliki w folderzekeepnigdy nie są usuwane. - Pliki większe niż 500 MB nie są wysyłane; przenieś je przez
scplubrsync. Wszystko idzie prosto na Twój serwer i nigdy nie przechodzi przez rdev.cloud. Wyłącz udostępnianie przełącznikiem w aplikacji lub poleceniemrdev laptop share off.
Przed 1.2.0 był to folder na zrzuty ekranu: ~/rdev-shots przenosi się do ~/rdev-share, a ~/Shots do ~/Share samodzielnie, a ~/Shots dalej działa jako link.
Obsługiwane laptopy
Aplikacja na laptopa i rdev laptop działają na macOS (Apple silicon i Intel), Linuksie (x64 i ARM64) oraz Windows 10 i 11 (x64 i ARM64); pobierz aplikację na stronie pobierania. W Linuksie możesz zainstalować ją jednym poleceniem, które bierze .deb w Debianie i Ubuntu, .rpm w Fedorze i AppImage gdzie indziej, na przykład w Arch i CachyOS: curl -fsSL https://rdev.cloud/install | sh -s -- app. AppImage trafia do ~/.local/bin i pojawia się w menu aplikacji; jeśli go przeniesiesz, aplikacja utrzymuje ten wpis wskazujący na plik (1.4.4 lub nowsza). Jeśli pobierzesz .deb samodzielnie, zainstaluj go z /tmp (sudo apt install /tmp/rdev-linux-arm64.deb lub -x64); z folderu domowego apt też działa, ale zauważa, że jego użytkownik piaskownicy nie może odczytać pliku. W Linuksie rdev kieruje *.dev.test na Twój serwer przez systemd-resolved, którego używa większość dystrybucji. Jeśli jest wyłączony lub zamaskowany, jak w niektórych obrazach maszyn wirtualnych, rdev laptop connect mówi o tym i pokazuje, jak go włączyć: sudo systemctl unmask systemd-resolved && sudo systemctl enable --now systemd-resolved, potem sudo ln -sf /run/systemd/resolve/stub-resolv.conf /etc/resolv.conf, i połącz się ponownie. Gdy NetworkManager trzyma własny /etc/resolv.conf obok działającego systemd-resolved (Tailscale zgłasza wtedy, że są „wired together incorrectly”), zapytania nigdy nie docierają do trasy rdev; rdev laptop connect i rdev laptop status mówią o tym (1.4.4 lub nowsza), a to samo polecenie ln -sf to naprawia. rdev dodaje swój certyfikat do zaufanych certyfikatów systemu w Debianie, Ubuntu, Fedorze, openSUSE, Arch i CachyOS; przed 1.4.4 połączenie zatrzymywało się tam w Arch i CachyOS.
Połącz krok po kroku
- Zainstaluj Tailscale na laptopie i zaloguj się na to samo konto Tailscale, którego używa Twój serwer. W Linuksie możesz to pominąć: jeśli brakuje Tailscale,
rdev laptop connectinstaluje go z oficjalnego repozytorium Tailscale i zaczyna logowanie, które kończysz w przeglądarce. - Zainstaluj rdev na laptopie i połącz go. Uruchom to w terminalu jako Ty sam i wpisz hasło do laptopa, gdy zostaniesz poproszony; jest potrzebne do zainstalowania rdev, uznania certyfikatu za zaufany i skonfigurowania rozpoznawania nazw:
curl -fsSL https://rdev.cloud/install | sh -s -- laptop
Instaluje polecenie rdev i uruchamia rdev laptop connect, które znajduje Twój serwer w tailnecie, dodaje wpis rdev do konfiguracji SSH, uznaje za zaufany certyfikat Twojego środowiska, kieruje *.dev.test na Twój serwer i zaczyna synchronizować Twój folder ~/Code z ~/Code na serwerze.
Najpierw nie musisz instalować niczego innego. Jeśli brakuje narzędzia do synchronizacji plików, rdev instaluje przypiętą, zweryfikowaną sumą kontrolną kopię w ~/.local/share/rdev/bin; to, które już masz, jest używane bez zmian. W Linuksie instaluje też narzędzia schowka używane do zrzutów ekranu (wl-clipboard, xclip) oraz certutil, który wkłada certyfikat do Chrome, przez Twojego menedżera pakietów, przy tym samym pytaniu o hasło. Jeśli podczas instalacji nadałeś serwerowi inną nazwę, dodaj --server <name>; aby synchronizować inny folder, dodaj --code-dir <folder>. Uruchom rdev laptop connect ponownie, ilekroć chcesz powtórzyć konfigurację.
Zanim zapyta o hasło, rdev laptop connect sprawdza folder, który ma synchronizować. Zatrzymuje się i proponuje --code-dir <folder>, gdy inna sesja synchronizacji już synchronizuje ten folder lub folder nadrzędny (synchronizacja także z rdev kopiowałaby wszystko między trzema maszynami); uruchom go z --force albo wybierz w aplikacji Synchronizuj mimo to, aby i tak go synchronizować. Folder większy niż 5 GB też się łączy, z uwagą, że pierwsza synchronizacja potrwa (rdev 1.1.10 lub nowszy; wcześniej się zatrzymywał).
Na Macu, który już kieruje dev.test gdzie indziej, na przykład na inny serwer deweloperski, rdev odkłada to ustawienie na bok i przywraca je po rozłączeniu lub odinstalowaniu.
W systemie Windows powyższe polecenie curl nie ma zastosowania: zainstaluj aplikację ze strony pobierania i połącz się z jej poziomu. Od aplikacji na laptopa 1.4.2 aplikacja instaluje też polecenie rdev w %USERPROFILE%\.local\share\rdev\bin i dodaje ten folder do Twojego PATH; aby z niego korzystać, otwórz nowy terminal. Nie wymaga uprawnień administratora i aktualizuje się razem z aplikacją.
Jeśli aplikacja wciąż pokazuje Check connection, gdy pliki się synchronizują, a rdev laptop status zwraca *.dev.test resolves to …, not the server, zajrzyj na stronę DNS konsoli administracyjnej Tailscale. Wpis split DNS dla dev.test, który wskazuje inną maszynę, na przykład stary serwer, ma w systemie Windows pierwszeństwo przed ustawieniem rdev. Usuń go albo skieruj na swój serwer.
Sprawdź połączenie w dowolnej chwili poleceniem rdev laptop status. rdev laptop disconnect zatrzymuje synchronizację i usuwa ustawienia; Twoje pliki zostają po obu stronach.
Usuń rdev z laptopa
rdev laptop uninstall
Rozłącza, przestaje ufać certyfikatowi Twojego środowiska i usuwa polecenie rdev, jego ustawienia oraz narzędzia, które zainstalowało. Twój zsynchronizowany folder i ~/rdev-share zostają. Narzędzie synchronizacji zainstalowane przez rdev też zostaje, dopóki korzystają z niego inne sesje synchronizacji. Pyta o hasło do laptopa raz i wymaga rdev 0.2.0-beta.21 lub nowszego.
Twój laptop musi móc zalogować się na serwer: instalator kopiuje klucze SSH, które mogły logować się na serwer w chwili instalacji. Aby dodać kolejny laptop, dodaj jego klucz publiczny na stronie serwera w panelu w Klucze SSH (po jednym w wierszu, więc kilka komputerów naraz; przy dodawaniu możesz nadać mu nazwę, na przykład Laptop służbowy, w przeciwnym razie pokazywana jest nazwa na końcu klucza); serwer wpuszcza go w ciągu kilku sekund. Wymaga to rdev 0.2.0-beta.33 lub nowszego; wcześniej umieść klucz w /opt/rdev/home/.ssh/authorized_keys na serwerze. Jeśli rdev laptop connect mówi, że nie może się zalogować, tego właśnie brakuje.
Po połączeniu otwórz terminal na serwerze poleceniem ssh rdev i uruchom tam agenta; otwieraj swoje witryny w przeglądarce pod adresem https://<folder>.dev.test. rdev open <projekt> otwiera terminal na serwerze od razu w folderze projektu, w Twojej trwałej sesji; bez nazwy wyświetla listę projektów (rdev 1.1.11 lub nowszy).
Aplikacja na Maca
Wolisz klikać niż pisać? Pobierz aplikację rdev na Maca (Apple silicon i Intel, podpisana i notaryzowana przez Apple), przeciągnij ją do Programów i otwórz. Pokazuje, czy laptop jest połączony, łączy i rozłącza jednym przyciskiem i otwiera terminal na Twoim serwerze. Wykonuje tę samą konfigurację co rdev laptop connect, więc potrzebujesz Tailscale (krok 1), ale nie polecenia; aplikacja sama instaluje narzędzie synchronizacji. Przed połączeniem możesz zmienić folder, do którego synchronizują się Twoje projekty (domyślnie ~/Code), czyli wersję --code-dir w aplikacji.
Przy pierwszym uruchomieniu aplikacja prowadzi przez konfigurację krok po kroku, a jej karty otwierają się dopiero, gdy każdy krok się powiedzie: zaloguj się kontem rdev, sprawdź, czy Tailscale jest zainstalowany i zalogowany, wybierz serwer z konta, wpuść ten laptop (aplikacja sama dodaje jego klucz SSH do serwera, tworząc go, jeśli brak), wybierz przyciskiem Przeglądaj… folder, do którego synchronizują się projekty, i połącz. Później Zmień serwer na karcie Sites konfiguruje laptop ponownie dla innego serwera. Gdy serwera laptopa już nie ma, jest nieosiągalny albo zniknął z konta, aplikacja o tym mówi i proponuje Skonfiguruj ponownie. W obu przypadkach pliki zostają na miejscu. Gdy polecenie rdev jest starsze niż aplikacja, About pokazuje Uruchom w terminalu, który otwiera terminal z poleceniem aktualizacji.
Aplikacja ma siedem kart:
- Witryny: Twoje projekty jako linki
https://<name>.dev.test, terminal na serwerze i Twoje udostępnione pliki. Każda witryna ma Open in Terminal, który otwiera terminal w folderze tego projektu na serwerze. Karta Sites ma też przyciski Mail i Dumps, które otwierają strony z przechwyconą pocztą i zrzutami. Jest też przycisk Web terminal, który otwiera terminal webowy. Jest też przycisk Errors, który otwiera śledzenie błędów. - Synchronizacja: te same ustawienia co w panelu (synchronizacja włączona lub wyłączona, projekty na tym laptopie, wykluczenia). Zapisanie stosuje je od razu na tym laptopie.
- Env: odczyt i zmiana
.envprojektu na serwerze. Aplikacja działa przez połączenie SSH, więc pokazuje bieżące wartości, które nigdy nie przechodzą przez rdev.cloud. - Gotify: jeśli Twoje powiadomienia trafiają na serwer Gotify, aplikacja nasłuchuje go i pokazuje każdą wiadomość jako powiadomienie na pulpicie z dźwiękiem. Wpisz adres serwera i token klienta (Gotify Clients); dodaj token aplikacji (Gotify Apps), aby wysłać wiadomość testową. Tokeny zostają na tym laptopie.
- Integracje: dostęp do Git Twojego serwera: jego klucz, dowolna liczba kont GitHub, GitLab, Bitbucket i innych (każde z własnym kluczem SSH lub tokenem), hosty oczekujące na zaufanie oraz test dostępu. Tokeny trafiają na serwer przez SSH, nigdy przez rdev.cloud.
- Ustawienia: aplikacja terminala, którą otwiera Terminal na serwerze (dowolna zainstalowana, taka jak Terminal, iTerm2 lub Warp; zapamiętywana do zmiany), ikona na pasku menu (monochromatyczna, dostosowująca się do jasnego lub ciemnego paska menu, albo kolorowa ikona aplikacji), synchronizacja zrzutów ekranu oraz Twoje konto: wybierz Zaloguj w rdev.cloud, potwierdź hasło w przeglądarce, sprawdź, czy pokazuje ten sam kod, i zatwierdź. Zalogowane aplikacje są wymienione, i można je odłączyć, w Ustawienia > Połączone aplikacje w panelu.
- O aplikacji: wersje aplikacji i polecenia
rdevoraz najnowsza aplikacja na rdev.cloud.
Wbudowany terminal
Terminal on the server otwiera wbudowany terminal rdev: osobne okno, które możesz zmieniać, maksymalizować lub otwierać na pełnym ekranie i które otwiera się ponownie w ostatnim rozmiarze. Loguje się przez ssh rdev i dołącza do trwałej sesji serwera, więc zamknięcie okna ani utrata sieci nigdy nie zatrzymują agenta; gdy połączenie zostanie zerwane, łączy się ponownie samo i wracasz tam, gdzie skończyłeś.
- Kopiowanie i wklejanie: Cmd-C i Cmd-V w macOS, Ctrl-Shift-C i Ctrl-Shift-V w Linuksie i Windows. Tekst skopiowany na serwerze, na przykład w vim, trafia do schowka laptopa. Gdy zrzuty ekranu są włączone, wklejenie obrazu wysyła go na serwer i wkleja jego ścieżkę, gotową dla agenta.
- Shift-Enter zaczyna nowy wiersz w prompcie Claude Code.
- Szukaj przez Cmd-F (Ctrl-Shift-F w Linuksie i Windows); rozmiar tekstu zmienisz przez Cmd i +, − lub 0 (Ctrl w Linuksie i Windows).
- Linki otwierają się w przeglądarce, także witryny
https://<nazwa>.dev.test. Gdy okno jest w tle, a terminal zadzwoni dzwonkiem, na przykład gdy agent cię potrzebuje, dostajesz powiadomienie. - Open in an external terminal otwiera tę samą sesję w aplikacji terminala: przycisk obok Terminal on the server, menu ikony na pasku menu lub Cmd-Shift-O (Ctrl-Shift-O) we wbudowanym terminalu. Aby aplikacja terminala była domyślna, wybierz ją w Settings. External terminal w Settings wybiera aplikację; na początku jest to wcześniej wybrana aplikacja terminala, a na Macu Terminal.
Aplikacja sprawdza nowszą wersję przy starcie, co sześć godzin i po otwarciu O aplikacji. Gdy jest nowsza, pasek nad kartami o tym informuje: wybierz Aktualizuj, a aplikacja pobiera ją, sprawdza podpis, instaluje i uruchamia się ponownie (w Linuksie .deb i .rpm proszą o hasło; w Windows instalator uruchamia się sam). Aktualizacja w aplikacji wymaga 0.2.0-beta.34 lub nowszej; starsze wersje zainstaluj raz ręcznie. Polecenie rdev na laptopie aktualizuje się osobno: uruchom ponownie polecenie instalacji, curl -fsSL https://rdev.cloud/install | sh -s -- laptop. W systemie Windows polecenie jest dołączone do aplikacji i aktualizuje się razem z nią. Gdy polecenie jest starsze niż aplikacja, About pokazuje to polecenie z przyciskiem kopiowania.
Zamknięcie okna zostawia rdev na pasku menu i usuwa go z Docka i Cmd-Tab; Zakończ w menu ikony na pasku menu lub Cmd-Q zamyka go.
W Settings (aplikacja na laptopa 1.4.3 lub nowsza) Open at login uruchamia rdev w tle po zalogowaniu, od razu na pasku menu lub w zasobniku systemowym, a Keep running when the window is closed (domyślnie włączone) decyduje, czy zamknięcie okna zostawia rdev tam, czy go kończy. Gdy opcja jest włączona, synchronizacja plików i powiadomienia działają dalej przy zamkniętym oknie. GNOME pokazuje ikony w zasobniku tylko z rozszerzeniem AppIndicator (Ubuntu je ma); bez niego po zamknięciu okna nie zostaje żadna ikona do kliknięcia, więc otwórz rdev ponownie z menu aplikacji. Aplikacja ostrzega o tym w Settings (aplikacja na laptopa 1.4.4 lub nowsza). Uruchamianie przy logowaniu nie wymaga uprawnień administratora: rdev dodaje element logowania tylko dla Twojego użytkownika (launch agent w macOS, wpis autostart w Linuksie, wpis Run w rejestrze Twojego użytkownika w Windows).
Aplikacja stosuje też reguły synchronizacji z panelu co pięć minut, gdy działa.
Firefox przechowuje własną listę certyfikatów. W Linuksie rdev dodaje swój certyfikat do Chrome i do każdego znalezionego profilu Firefoksa, w tym do snapowego Firefoksa z Ubuntu i wersji Flatpak (rdev 0.2.0-beta.34 lub nowszy); po tym uruchom Firefoksa ponownie. W przypadku profilu Firefoksa utworzonego później albo w macOS i Windows zaimportuj ~/.config/rdev/ca.pem w Ustawienia > Prywatność i bezpieczeństwo > Certyfikaty.