노트북은 에디터와 브라우저입니다. 코드, 서비스, 에이전트는 서버에 남습니다.
나만의 테일넷
노트북과 서버는 사용자의 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 MB가 넘는 파일은 전송되지 않습니다.
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에서는 명령어 하나로 설치할 수도 있으며, Debian과 Ubuntu에서는 .deb, Fedora에서는 .rpm, 그 외(예: Arch와 CachyOS)에는 AppImage를 사용합니다: 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는 대부분의 배포판이 사용하는 systemd-resolved를 통해 *.dev.test를 서버로 보냅니다. 일부 가상 머신 이미지처럼 꺼져 있거나 마스크된 경우 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가 실행 중인 systemd-resolved 옆에 자체 /etc/resolv.conf를 유지하면(이때 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를 실행합니다. 이 명령은 테일넷에서 서버를 찾고, SSH 설정에 rdev 항목을 추가하고, 환경의 인증서를 신뢰하고, *.dev.test를 서버로 보내고, ~/Code 폴더를 서버의 ~/Code와 동기화하기 시작합니다.
먼저 설치해야 할 것은 없습니다. 파일 동기화 도구가 없으면 rdev가 버전이 고정되고 체크섬이 검증된 사본을 ~/.local/share/rdev/bin에 설치하며, 이미 있는 도구는 그대로 사용합니다. Linux에서는 스크린샷에 사용하는 클립보드 도구(wl-clipboard, xclip)와 Chrome에 인증서를 넣는 certutil도 같은 비밀번호 입력 한 번으로 패키지 관리자를 통해 설치합니다. 설치 시 서버에 다른 이름을 지정했다면 --server <name>을 추가하고, 다른 폴더를 동기화하려면 --code-dir <folder>를 추가하세요. 설정을 다시 하려면 언제든지 rdev laptop connect를 다시 실행하세요.
rdev laptop connect는 비밀번호를 묻기 전에 동기화할 폴더를 확인합니다. 다른 동기화 세션이 그 폴더나 상위 폴더를 이미 동기화 중이면 멈추고 --code-dir <폴더>를 제안합니다(rdev로도 동기화하면 세 대의 기기 사이에서 모든 것이 복사됩니다). 그래도 동기화하려면 --force로 실행하거나 앱에서 그래도 동기화를 고르세요. 5GB가 넘는 폴더도 연결되며, 첫 동기화에 시간이 걸린다는 안내만 표시됩니다(rdev 1.1.10 이상, 이전에는 멈췄습니다).
이미 dev.test를 다른 곳(예: 다른 개발 서버)으로 보내고 있는 Mac에서는 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라고 하면, Tailscale 관리 콘솔의 DNS 페이지를 확인하세요. dev.test를 다른 머신(예: 예전 서버)으로 보내는 split DNS 항목이 있으면 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 앱
타이핑보다 클릭이 편하신가요? Mac용 rdev 앱(Apple silicon 및 Intel, Apple의 서명과 공증 완료)을 다운로드해 응용 프로그램으로 드래그하고 여세요. 노트북이 연결되었는지 표시하고, 버튼 하나로 연결 및 해제하며, 서버에서 터미널을 엽니다. rdev laptop connect와 같은 설정을 수행하므로 Tailscale(1단계)은 필요하지만 명령어는 필요 없으며, 앱이 동기화 도구를 직접 설치합니다. 연결하기 전에 프로젝트가 동기화될 폴더(기본값 ~/Code)를 변경할 수 있으며, 이는 앱의 --code-dir에 해당합니다.
처음 열면 앱이 설정을 한 단계씩 안내하며, 모든 단계가 성공해야 탭이 열립니다. rdev 계정으로 로그인하고, Tailscale이 설치되어 로그인되어 있는지 확인하고, 계정의 서버를 고르고, 이 노트북의 접근을 허용하고(앱이 SSH 키를 서버에 직접 추가하며, 키가 없으면 먼저 만듭니다), **찾아보기…**로 프로젝트가 동기화될 폴더를 고른 뒤 연결합니다. 나중에 Sites 탭의 서버 변경으로 다른 서버에 맞게 노트북을 다시 설정할 수 있습니다. 노트북의 서버가 사라지면(연결할 수 없거나 계정에 더 이상 없으면) 앱이 이를 알리고 다시 설정을 제안합니다. 두 경우 모두 파일은 그대로 남습니다. rdev 명령이 앱보다 오래되었으면 About에 업데이트 명령을 터미널에서 여는 터미널에서 실행 버튼이 나타납니다.
앱에는 일곱 개의 탭이 있습니다.
- Sites:
https://<name>.dev.test링크로 표시되는 프로젝트, 서버의 터미널, 공유 파일 각 사이트에는 Open in Terminal이 있어 서버에서 해당 프로젝트 폴더로 터미널을 엽니다. Sites 탭에는 캡처된 메일과 덤프 페이지를 여는 Mail과 Dumps 버튼도 있습니다. 웹 터미널을 여는 Web terminal 버튼도 있습니다. 오류 추적을 여는 Errors 버튼도 있습니다. - Sync: 패널과 같은 설정(동기화 켜기/끄기, 이 노트북의 프로젝트, 제외 항목). 저장하면 이 노트북에 즉시 적용됩니다.
- Env: 서버에 있는 프로젝트의
.env를 읽고 변경합니다. 앱은 SSH 연결로 동작하므로 현재 값이 표시되며, 값은 rdev.cloud를 거치지 않습니다. - Gotify: 알림이 Gotify 서버로 전송된다면 앱이 이를 수신하고 각 메시지를 소리와 함께 데스크톱 알림으로 표시합니다. 서버 주소와 클라이언트 토큰(Gotify Clients)을 입력하고, 테스트 메시지를 보내려면 애플리케이션 토큰(Gotify Apps)을 추가하세요. 토큰은 이 노트북에만 남습니다.
- Integrations: 서버의 Git 접근: 서버 키, 원하는 만큼의 GitHub, GitLab, Bitbucket 등 계정(각각 자체 SSH 키 또는 토큰), 신뢰 대기 중인 호스트, 접근 테스트. 토큰은 SSH로 서버에 전달되며 rdev.cloud를 거치지 않습니다.
- Settings: Terminal on the server가 여는 터미널 앱(Terminal, iTerm2, Warp 등 설치된 앱 중 선택, 변경할 때까지 유지), 메뉴 막대 아이콘(밝거나 어두운 메뉴 막대를 따르는 단색 또는 컬러 앱 아이콘), 스크린샷 동기화, 계정: Sign in with rdev.cloud를 선택하고, 브라우저에서 비밀번호를 확인하고, 같은 코드가 표시되는지 확인한 뒤 승인하세요. 로그인된 앱은 패널의 설정 > 연결된 앱에 나열되며 거기서 연결을 해제할 수 있습니다.
- About: 앱과
rdev명령어의 버전, rdev.cloud의 최신 앱
내장 터미널
Terminal on the server는 rdev의 내장 터미널을 엽니다. 크기를 바꾸고 최대화하거나 전체 화면으로 쓸 수 있는 별도 창이며, 다음에는 마지막 크기로 열립니다. ssh rdev로 로그인해 서버의 영구 세션에 참여하므로, 창을 닫거나 네트워크가 끊겨도 에이전트는 멈추지 않습니다. 연결이 끊기면 스스로 다시 연결해 하던 곳으로 돌아갑니다.
- 복사와 붙여넣기: macOS에서는 Cmd-C와 Cmd-V, Linux와 Windows에서는 Ctrl-Shift-C와 Ctrl-Shift-V. 서버에서 복사한 텍스트(예: vim)는 노트북 클립보드에 들어옵니다. 스크린샷이 켜져 있으면 이미지를 붙여 넣을 때 서버로 보내고 그 경로를 붙여 넣어 에이전트가 바로 쓸 수 있습니다.
- Shift-Enter는 Claude Code 프롬프트에서 새 줄을 시작합니다.
- 검색은 Cmd-F(Linux와 Windows에서는 Ctrl-Shift-F), 글자 크기는 Cmd와 +, −, 0(Linux와 Windows에서는 Ctrl)으로 바꿉니다.
- 링크는 브라우저에서 열리며
https://<이름>.dev.test사이트도 포함됩니다. 창이 뒤에 있을 때 터미널이 벨을 울리면(예: 에이전트가 당신을 기다릴 때) 데스크톱 알림을 받습니다. - Open in an external terminal은 같은 세션을 터미널 앱에서 엽니다. Terminal on the server 옆 버튼, 메뉴 막대 아이콘의 메뉴, 또는 내장 터미널에서 Cmd-Shift-O(Ctrl-Shift-O)를 쓰세요. 터미널 앱을 기본으로 하려면 Settings에서 고르세요. 사용할 앱은 Settings의 External terminal에서 고릅니다. 처음에는 이전에 고른 터미널 앱이고, 없으면 Mac에서는 터미널입니다.
앱은 시작할 때, 6시간마다, About을 열 때 새 버전을 확인합니다. 새 버전이 있으면 탭 위의 막대가 알려 줍니다. Update를 선택하면 앱이 다운로드하고, 서명을 확인하고, 설치한 뒤 재시작합니다(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는 해당 사용자에게만 로그인 항목을 추가합니다(macOS에서는 launch agent, Linux에서는 autostart 항목, Windows에서는 사용자 레지스트리의 Run 항목).
앱은 실행 중에 5분마다 패널의 동기화 규칙도 적용합니다.
Firefox는 자체 인증서 목록을 유지합니다. Linux에서 rdev는 인증서를 Chrome과 발견한 모든 Firefox 프로필(Ubuntu가 제공하는 snap Firefox와 Flatpak Firefox 포함, rdev 0.2.0-beta.34 이상)에 추가합니다. 이후 Firefox를 재시작하세요. 나중에 만든 Firefox 프로필이나 macOS와 Windows에서는 Settings > Privacy & Security > Certificates에서 ~/.config/rdev/ca.pem을 가져오세요.