Laptop của bạn là trình soạn thảo và trình duyệt. Mã nguồn, các dịch vụ và agent nằm trên máy chủ của bạn.
Tailnet của riêng bạn
Laptop và máy chủ của bạn trò chuyện qua một mạng Tailscale riêng thuộc về tài khoản Tailscale của bạn. rdev không bao giờ tham gia mạng đó. Trình cài đặt kết nối máy chủ của bạn bằng một khóa từ tài khoản của bạn, và ứng dụng laptop kết nối laptop của bạn.
Đồng bộ tệp
rdev giữ các tệp dự án của bạn đồng bộ giữa laptop và máy chủ, theo cả hai chiều. Các thư mục không cần di chuyển, như node_modules, vendor và kết quả build, bị bỏ qua ngay từ đầu.
Bạn chọn những gì được đồng bộ trong bảng điều khiển, tại Bảng điều khiển > máy chủ của bạn > Cài đặt:
- Đồng bộ về laptop: tắt nó để làm việc hoàn toàn từ xa. Không có gì được sao chép về laptop; trình soạn thảo của bạn mở dự án qua SSH (
ssh rdev, VS Code hoặc Cursor Remote-SSH, PhpStorm Gateway). Các site và.dev.testvẫn hoạt động. - Dự án trên laptop: bỏ chọn một dự án để chỉ giữ nó trên máy chủ. Bản sao đã có trên laptop được giữ nguyên, nên hãy xóa nó khi không cần nữa. Khi một dự án được đồng bộ lại sau này, bản sao cũ trên laptop được chuyển đến
~/Code-rdev-old/trước và bản trên máy chủ được tải xuống. - Chưa từng đồng bộ: các mục loại trừ mặc định, mỗi mục bạn đều có thể tắt, cùng các mẫu riêng của bạn theo cú pháp giống
.gitignore.
Laptop áp dụng các quy tắc mới trong vài phút. Chạy rdev laptop sync để áp dụng ngay.
Trình soạn thảo và trình duyệt
Hãy dùng trình soạn thảo bạn đã quen, như VS Code hoặc PhpStorm, trên các tệp đã đồng bộ. Mở các site của bạn trong trình duyệt quen thuộc tại https://<name>.dev.test; ứng dụng laptop thiết lập phân giải tên và một chứng chỉ đáng tin cậy cho các địa chỉ này.
Chia sẻ tệp
Terminal trên máy chủ của bạn không dán được tệp, nên rdev cho agent của bạn một thư mục dùng chung. Mọi thứ trong ~/rdev-share trên laptop được sao chép đến ~/Share/<laptop name> trên máy chủ trong vài giây, ngay cả khi đồng bộ tệp đang tắt; mỗi laptop có thư mục riêng ở đó, nên nhiều laptop có thể chia sẻ cùng lúc. Hãy nhờ agent "xem ảnh chụp màn hình gần nhất" hoặc "mở tệp tôi vừa gửi" và nó mở tệp mới nhất. Loại tệp nào cũng được: hình ảnh, PDF, log, tệp xuất.
- Send clipboard trong ứng dụng (cũng có ở biểu tượng thanh menu hoặc khay hệ thống) gửi các tệp bạn đã sao chép trong Finder, Explorer hoặc trình quản lý tệp, nếu không thì gửi hình ảnh trong clipboard của bạn. Nó đợi đến khi chúng tới máy chủ và đặt đường dẫn của chúng trên máy chủ vào clipboard của bạn; hãy dán chúng vào agent. Trong terminal:
rdev laptop share send, hoặcrdev laptop share send <files>. - Thả tệp vào cửa sổ ứng dụng để gửi chúng theo cách tương tự.
- Chiều ngược lại: các tệp agent đặt vào
~/Share/<laptop name>/outtrên máy chủ sẽ đến~/rdev-share/from-servertrên laptop của bạn. Hãy nhờ nó "đặt báo cáo vào out". - Save macOS screenshots here làm cho Shift-Command-3, 4 và 5 lưu vào
~/rdev-share(rdev laptop share macos). Các ứng dụng chụp màn hình như Shottr hay CleanShot cũng có thể lưu vào đó. - Tệp bị xóa sau 7 ngày ở cả hai phía; thay đổi điều này ở Keep files for (days) trong ứng dụng hoặc bằng
rdev laptop share keep <days>(0 sẽ giữ lại). Tệp trong thư mụckeepkhông bao giờ bị xóa. - Tệp lớn hơn 500 MB không được gửi; hãy chuyển chúng bằng
scphoặcrsync. Mọi thứ đi thẳng đến máy chủ của bạn và không bao giờ qua rdev.cloud. Tắt chia sẻ bằng công tắc trong ứng dụng hoặcrdev laptop share off.
Trước 1.2.0 đây là thư mục ảnh chụp màn hình: ~/rdev-shots tự chuyển sang ~/rdev-share và ~/Shots sang ~/Share, và ~/Shots vẫn hoạt động như một liên kết.
Các laptop được hỗ trợ
Ứng dụng laptop và rdev laptop chạy trên macOS (Apple silicon và Intel), Linux (x64 và ARM64) và Windows 10 và 11 (x64 và ARM64); tải ứng dụng ở trang tải xuống. Trên Linux, bạn có thể cài đặt bằng một lệnh thay thế, lệnh này chọn .deb trên Debian và Ubuntu, .rpm trên Fedora và AppImage ở nơi khác, ví dụ trên Arch và CachyOS: curl -fsSL https://rdev.cloud/install | sh -s -- app. AppImage được đặt trong ~/.local/bin và xuất hiện trong menu ứng dụng của bạn; ứng dụng giữ cho mục đó luôn trỏ tới tệp nếu bạn di chuyển nó (1.4.4 trở lên). Nếu bạn tự tải .deb, hãy cài đặt từ /tmp (sudo apt install /tmp/rdev-linux-arm64.deb, hoặc -x64); từ thư mục home của bạn apt cũng chạy được nhưng sẽ ghi chú rằng người dùng sandbox của nó không đọc được tệp. Trên Linux, rdev chuyển *.dev.test đến máy chủ của bạn thông qua systemd-resolved, mà hầu hết bản phân phối dùng. Nếu nó bị tắt hoặc bị mask, như trên một số image máy ảo, rdev laptop connect sẽ cho biết và chỉ cách bật: sudo systemctl unmask systemd-resolved && sudo systemctl enable --now systemd-resolved, rồi sudo ln -sf /run/systemd/resolve/stub-resolv.conf /etc/resolv.conf, và kết nối lại. Khi NetworkManager giữ một /etc/resolv.conf riêng bên cạnh systemd-resolved đang chạy (khi đó Tailscale báo rằng chúng "wired together incorrectly"), các truy vấn không bao giờ tới được tuyến của rdev; rdev laptop connect và rdev laptop status sẽ cho biết điều này (1.4.4 trở lên), và cùng lệnh ln -sf đó sẽ khắc phục. rdev thêm chứng chỉ của nó vào các chứng chỉ tin cậy của hệ thống trên Debian, Ubuntu, Fedora, openSUSE, Arch và CachyOS; trước 1.4.4, kết nối dừng lại ở đó trên Arch và CachyOS.
Kết nối từng bước
- Cài Tailscale trên laptop của bạn và đăng nhập bằng cùng tài khoản Tailscale mà máy chủ của bạn dùng. Trên Linux bạn có thể bỏ qua bước này: nếu thiếu Tailscale,
rdev laptop connectsẽ cài nó từ kho chính thức của Tailscale và bắt đầu đăng nhập, mà bạn hoàn tất trong trình duyệt. - Cài rdev trên laptop của bạn và kết nối nó. Chạy lệnh này trong terminal bằng chính tài khoản của bạn, và nhập mật khẩu laptop khi được hỏi; nó cần để cài rdev, tin cậy chứng chỉ và thiết lập phân giải tên:
curl -fsSL https://rdev.cloud/install | sh -s -- laptop
Nó cài lệnh rdev và chạy rdev laptop connect, lệnh này tìm máy chủ của bạn trong tailnet, thêm một mục rdev vào cấu hình SSH của bạn, tin cậy chứng chỉ của môi trường, chuyển *.dev.test đến máy chủ của bạn và bắt đầu đồng bộ thư mục ~/Code của bạn với ~/Code trên máy chủ.
Bạn không phải cài gì khác trước. Nếu thiếu công cụ đồng bộ tệp, rdev cài một bản cố định, đã xác minh checksum trong ~/.local/share/rdev/bin; công cụ bạn đã có sẽ được dùng nguyên trạng. Trên Linux, nó cũng cài các công cụ clipboard dùng cho ảnh chụp màn hình (wl-clipboard, xclip) và certutil, công cụ đặt chứng chỉ vào Chrome, bằng trình quản lý gói của bạn, trong cùng một lần hỏi mật khẩu. Nếu bạn đặt cho máy chủ một tên khác lúc cài đặt, hãy thêm --server <name>; để đồng bộ một thư mục khác, hãy thêm --code-dir <folder>. Chạy lại rdev laptop connect bất cứ khi nào bạn muốn thiết lập lại.
Trước khi hỏi mật khẩu, rdev laptop connect kiểm tra thư mục sắp đồng bộ. Lệnh dừng và gợi ý --code-dir <thư-mục> nếu một phiên đồng bộ khác đã đồng bộ thư mục đó hoặc thư mục chứa nó (đồng bộ thêm bằng rdev sẽ sao chép mọi thứ giữa ba máy); chạy với --force hoặc chọn Vẫn đồng bộ trong ứng dụng để vẫn đồng bộ. Thư mục lớn hơn 5 GB vẫn kết nối được, chỉ kèm ghi chú rằng lần đồng bộ đầu sẽ mất thời gian (rdev 1.1.10 trở lên; trước đó lệnh sẽ dừng).
Trên một máy Mac đã chuyển dev.test đến nơi khác, ví dụ một máy chủ phát triển khác, rdev để riêng cài đặt đó và đặt lại khi bạn ngắt kết nối hoặc gỡ cài đặt.
Trên Windows, lệnh curl ở trên không áp dụng: hãy cài ứng dụng từ trang tải xuống và kết nối từ đó. Từ ứng dụng laptop 1.4.2 trở đi, ứng dụng cũng cài lệnh rdev vào %USERPROFILE%\.local\share\rdev\bin và thêm thư mục đó vào PATH của bạn; hãy mở một terminal mới để dùng. Lệnh này không cần quyền quản trị và được cập nhật cùng ứng dụng.
Nếu ứng dụng cứ hiện Check connection trong khi tệp đang đồng bộ, và rdev laptop status báo *.dev.test resolves to …, not the server, hãy xem trang DNS của bảng quản trị Tailscale. Một mục split DNS cho dev.test trỏ đến máy khác, chẳng hạn một máy chủ cũ, được ưu tiên hơn cài đặt của rdev trên Windows. Hãy xóa nó, hoặc cho nó trỏ đến máy chủ của bạn.
Kiểm tra kết nối bất cứ lúc nào bằng rdev laptop status. rdev laptop disconnect dừng đồng bộ và xóa các cài đặt; các tệp của bạn vẫn còn ở cả hai phía.
Gỡ rdev khỏi laptop của bạn
rdev laptop uninstall
Nó ngắt kết nối, ngừng tin cậy chứng chỉ của môi trường, và xóa lệnh rdev, các cài đặt của nó và các công cụ nó đã cài. Thư mục đã đồng bộ và ~/rdev-share của bạn vẫn còn. Công cụ đồng bộ mà rdev đã cài cũng được giữ lại khi các phiên đồng bộ khác vẫn dùng nó. Nó hỏi mật khẩu laptop một lần và cần rdev 0.2.0-beta.21 trở lên.
Laptop của bạn phải đăng nhập được vào máy chủ: trình cài đặt sao chép các khóa SSH có thể đăng nhập vào máy chủ khi bạn cài đặt. Để thêm một laptop khác, hãy thêm khóa công khai của nó trên trang máy chủ của bạn trong bảng điều khiển, tại Khóa SSH (mỗi dòng một khóa, nên có thể thêm nhiều máy tính cùng lúc; khi thêm một khóa, bạn có thể đặt tên như Laptop công việc, nếu không tên ở cuối khóa sẽ được hiển thị); máy chủ cho nó vào trong vài giây. Điều đó cần rdev 0.2.0-beta.33 trở lên; trước đó, hãy đặt khóa vào /opt/rdev/home/.ssh/authorized_keys trên máy chủ. Nếu rdev laptop connect báo không đăng nhập được, đây là thứ còn thiếu.
Khi đã kết nối, hãy mở terminal trên máy chủ bằng ssh rdev và khởi động agent của bạn ở đó; mở các site của bạn trong trình duyệt tại https://<folder>.dev.test. rdev open <dự-án> mở terminal trên server ngay trong thư mục dự án, trong phiên làm việc liên tục của bạn; không có tên thì liệt kê các dự án (rdev 1.1.11 trở lên).
Ứng dụng Mac
Thích nhấp chuột hơn gõ lệnh? Hãy tải ứng dụng rdev cho Mac (Apple silicon và Intel, được Apple ký và công chứng), kéo nó vào Applications và mở. Nó cho biết laptop của bạn đã kết nối chưa, kết nối và ngắt kết nối bằng một nút và mở terminal trên máy chủ của bạn. Nó thực hiện cùng thiết lập như rdev laptop connect, nên bạn cần Tailscale (bước 1) nhưng không cần lệnh; ứng dụng tự cài công cụ đồng bộ. Trước khi kết nối, bạn có thể đổi thư mục mà các dự án của bạn đồng bộ vào (mặc định ~/Code), tức phiên bản của --code-dir trong ứng dụng.
Lần đầu mở, ứng dụng hướng dẫn thiết lập từng bước và các thẻ chỉ mở khi mọi bước đều thành công: đăng nhập bằng tài khoản rdev, kiểm tra Tailscale đã cài và đăng nhập, chọn server trong tài khoản, cho phép laptop này truy cập (ứng dụng tự thêm khóa SSH của nó vào server, tạo khóa nếu chưa có), chọn thư mục đồng bộ dự án bằng Duyệt…, rồi kết nối. Sau này, Đổi server trong thẻ Sites thiết lập lại laptop cho server khác. Khi server của laptop không còn, không kết nối được hoặc không còn trong tài khoản, ứng dụng sẽ báo và đề nghị Thiết lập lại. Trong cả hai trường hợp tệp vẫn giữ nguyên. Khi lệnh rdev cũ hơn ứng dụng, About hiển thị Chạy trong Terminal, mở terminal với lệnh cập nhật.
Ứng dụng có bảy tab:
- Site: các dự án của bạn dưới dạng liên kết
https://<name>.dev.test, một terminal trên máy chủ và các tệp bạn chia sẻ. Mỗi site có Open in Terminal, mở terminal trong thư mục của dự án đó trên máy chủ. Tab Sites cũng có các nút Mail và Dumps để mở trang thư và dump đã bắt. Cũng có nút Web terminal để mở terminal web. Cũng có một nút Errors để mở công cụ theo dõi lỗi. - Đồng bộ: các cài đặt giống như trên bảng điều khiển (bật hoặc tắt đồng bộ, dự án trên laptop này, các mục loại trừ). Lưu sẽ áp dụng chúng trên laptop này ngay lập tức.
- Env: đọc và thay đổi
.envcủa một dự án trên máy chủ. Ứng dụng làm việc qua kết nối SSH, nên nó hiển thị các giá trị hiện tại, và chúng không bao giờ đi qua rdev.cloud. - Gotify: nếu thông báo của bạn đi tới một máy chủ Gotify, ứng dụng lắng nghe nó và hiển thị mỗi tin nhắn dưới dạng thông báo trên màn hình kèm âm thanh. Nhập địa chỉ máy chủ và một client token (Gotify Clients); thêm một application token (Gotify Apps) để gửi tin nhắn thử. Các token nằm lại trên laptop này.
- Tích hợp: Truy cập Git của máy chủ: khóa của nó, bao nhiêu tài khoản GitHub, GitLab, Bitbucket và khác tùy ý (mỗi tài khoản có khóa SSH riêng hoặc một token), các máy chủ lưu trữ đang chờ được tin cậy và một bài kiểm tra truy cập. Token được gửi đến máy chủ qua SSH, không bao giờ qua rdev.cloud.
- Cài đặt: ứng dụng terminal mà Terminal trên máy chủ mở (bất kỳ ứng dụng nào đã cài, như Terminal, iTerm2 hoặc Warp; được giữ cho đến khi bạn đổi), biểu tượng thanh menu (đơn sắc, theo thanh menu sáng hoặc tối, hoặc biểu tượng ứng dụng có màu), đồng bộ ảnh chụp màn hình, và tài khoản của bạn: chọn Đăng nhập bằng rdev.cloud, xác nhận mật khẩu trong trình duyệt, kiểm tra xem nó hiển thị cùng mã, và phê duyệt. Các ứng dụng đã đăng nhập được liệt kê, và có thể ngắt kết nối, trong Cài đặt > Ứng dụng đã kết nối trên bảng điều khiển của bạn.
- Giới thiệu: phiên bản của ứng dụng và của lệnh
rdev, và ứng dụng mới nhất trên rdev.cloud.
Terminal tích hợp
Terminal on the server mở terminal tích hợp của rdev: một cửa sổ riêng có thể đổi kích thước, phóng to hoặc toàn màn hình, và lần sau mở lại với kích thước cuối. Nó đăng nhập bằng ssh rdev và tham gia phiên lâu dài của máy chủ, nên đóng cửa sổ hay mất mạng không bao giờ dừng agent; khi mất kết nối, nó tự kết nối lại và bạn quay về đúng chỗ đang làm.
- Sao chép và dán: Cmd-C và Cmd-V trên macOS, Ctrl-Shift-C và Ctrl-Shift-V trên Linux và Windows. Văn bản sao chép trên máy chủ, ví dụ trong vim, vào bộ nhớ tạm của laptop. Khi bật ảnh chụp màn hình, dán một ảnh sẽ gửi ảnh lên máy chủ và dán đường dẫn của nó, sẵn cho agent.
- Shift-Enter bắt đầu dòng mới trong prompt của Claude Code.
- Tìm kiếm bằng Cmd-F (Ctrl-Shift-F trên Linux và Windows); đổi cỡ chữ bằng Cmd và +, − hoặc 0 (Ctrl trên Linux và Windows).
- Liên kết mở trong trình duyệt, kể cả các site
https://<tên>.dev.test. Khi cửa sổ ở nền và terminal rung chuông, ví dụ khi agent cần bạn, bạn nhận được thông báo. - Open in an external terminal mở cùng phiên đó trong một ứng dụng terminal: nút cạnh Terminal on the server, menu của biểu tượng trên thanh menu, hoặc Cmd-Shift-O (Ctrl-Shift-O) trong terminal tích hợp. Để đặt một ứng dụng terminal làm mặc định, chọn nó trong Settings. Ứng dụng được dùng do External terminal trong Settings chọn; ban đầu là ứng dụng terminal bạn đã chọn trước đó, hoặc Terminal trên Mac.
Ứng dụng kiểm tra phiên bản mới khi khởi động, mỗi sáu giờ và khi bạn mở Giới thiệu. Khi có bản mới, một thanh phía trên các tab sẽ báo: chọn Cập nhật, và ứng dụng tải nó xuống, kiểm tra chữ ký, cài đặt và khởi động lại (trên Linux, .deb và .rpm hỏi mật khẩu của bạn; trên Windows trình cài đặt tự chạy). Cập nhật trong ứng dụng cần 0.2.0-beta.34 trở lên; các phiên bản cũ hơn hãy cài đè thủ công một lần. Lệnh rdev trên laptop được cập nhật riêng: chạy lại lệnh cài đặt, curl -fsSL https://rdev.cloud/install | sh -s -- laptop. Trên Windows, lệnh này đi kèm ứng dụng và được cập nhật cùng ứng dụng. Khi lệnh cũ hơn ứng dụng, About hiển thị lệnh đó kèm nút sao chép.
Đóng cửa sổ vẫn giữ rdev trong thanh menu và đưa nó ra khỏi Dock và Cmd-Tab; Quit trong menu của biểu tượng thanh menu, hoặc Cmd-Q, sẽ thoát nó.
Trong Settings (ứng dụng laptop 1.4.3 trở lên), Open at login khởi động rdev ở chế độ nền khi bạn đăng nhập, vào thẳng thanh menu hoặc khay hệ thống, còn Keep running when the window is closed (mặc định bật) quyết định việc đóng cửa sổ sẽ giữ rdev ở đó hay thoát nó. Khi bật, đồng bộ tệp và thông báo vẫn hoạt động khi cửa sổ đã đóng. GNOME chỉ hiển thị biểu tượng khay khi có tiện ích mở rộng AppIndicator (Ubuntu có sẵn); nếu không có, cửa sổ đã đóng sẽ không để lại biểu tượng nào để nhấp, nên hãy mở lại rdev từ menu ứng dụng của bạn. Ứng dụng cảnh báo về điều này trong Settings (ứng dụng laptop 1.4.4 trở lên). Mở khi đăng nhập không cần quyền quản trị: rdev chỉ thêm một mục đăng nhập cho người dùng của bạn (launch agent trên macOS, mục autostart trên Linux, mục Run trong registry của người dùng bạn trên Windows).
Ứng dụng cũng áp dụng các quy tắc đồng bộ của bảng điều khiển mỗi năm phút khi nó đang chạy.
Firefox giữ danh sách chứng chỉ riêng. Trên Linux, rdev thêm chứng chỉ của nó vào Chrome và mọi hồ sơ Firefox nó tìm thấy, kể cả Firefox snap mà Ubuntu cung cấp và bản Flatpak (rdev 0.2.0-beta.34 trở lên); hãy khởi động lại Firefox sau đó. Với hồ sơ Firefox tạo sau này, hoặc trên macOS và Windows, hãy nhập ~/.config/rdev/ca.pem trong Settings > Privacy & Security > Certificates.