3-minute quickstart
Install RockDesk on two machines and connect by ID. Remote desktop, terminal, files and forwarding all ride that one connection — and your AI agent can use it too.
1Install it on both machines
- Windows: run the installer from the download section. It is not code-signed yet, so Windows may say “Windows protected your PC” — click More info → Run anyway.
- macOS (Apple silicon or Intel, one download each): open the .dmg and drag the app into Applications.
- Linux:
sudo apt install ./rockdesk-*-linux-*.deb(x86_64: Ubuntu 20.04 or later; arm64: Ubuntu 22.04 or later). No screen on that machine? See below. - Android: install the .apk. iPhone / iPad: “RockDesk Remote” on the App Store (free), for reaching your computers.
- Nothing to install at all: open the web version in a browser.
2On the machine you’ll reach: decide who gets in
Open RockDesk. The home screen shows this machine’s 9-digit ID and a one-time password — that is all the other side needs (new installs from 1.0.6 have it on). In Settings → Who can connect you choose the ways in:
- One-time password — on by default, shown on the home screen, changes after every use. Works when nobody is at that machine.
- Allow when someone connects — a dialog pops up when someone connects; nothing happens until a person there clicks Allow.
- Fixed password / key pair — for your own machines: type it once and they remember it (key pairs work like ssh).
3Connect from the other one
Type the other machine’s ID → Connect → enter the one-time password (or have someone there click Allow). The first connection takes a second or two to punch through; after that, desktop, terminal, files and forwards open instantly.
No screen? Servers, robots, dev boards
Install the same .deb, then turn on the system service. It starts at boot and needs nobody logged in:
sudo systemctl enable --now rockd
sudo rds status # this machine's ID
sudo rds otp # its current one-time password
Connect from another machine with that ID and one-time password. On a machine like this, the one-time password also lets people use the terminal and port forwarding (file transfer is on too), and “Allow when someone connects” is off, since nobody is there to click. Change any of it with rds (settings live in /var/lib/rockd):
- Fixed password:
sudo rds passwd(asks twice;sudo rds passwd --clearremoves it). - Key pair, like ssh: on your own computer run
rds key genonce (afterwardsrds keyprints the same line); on this machine,sudo rds authorize "<that line>". Your computer then gets in with no password and can use everything. - One-time password:
sudo rds otpshows it,sudo rds otp newmakes a new one,sudo rds config otp offturns it off. - What others may use:
sudo rds configlists it;sudo rds config feature shell off(or file, fwd, mount, vpn, serial, usb …) switches one;sudo rds config ask onturns the allow dialog back on.
4Let your AI agent use it
RockDesk ships rds, a command line that does everything the app does, and a skill that teaches coding agents how to use it. In Claude Code (or a similar agent), say this once in the chat — it installs the skill itself:
Install the skill at https://rockdesk.io/rockdesk-cli.md
The agent uses rds (the skill file is rockdesk-cli.md). On macOS rds is /Applications/rockd.app/Contents/MacOS/rds; on Windows, "C:\Program Files\rockd\rds.exe". Then just ask:
“Take a screenshot of 123456789, open Settings and turn on dark mode.”
“Copy ~/build/app.zip to 123456789 and unzip it in Downloads.”
The agent gets exactly what the other machine allows you — nothing more.
5Or use the command line yourself
rds 123456789 shell -c "df -h" # run a command, get its exit code
rds 123456789 cp ./build.zip :~/build.zip # copy (':' marks the remote side)
rds 123456789 mount :/home/me/proj ~/proj # mount a remote folder
rds 123456789 forward 15432:5432 # remote Postgres on local port 15432
rds 123456789 vpn up # VPN into the other side
Everything else is in the CLI guide.
FAQ
- It won’t connect.
- Both machines need RockDesk running and internet access. Check step 2 on the machine you are reaching. When a direct path is impossible, RockDesk falls back to a relay (China and the US) automatically — slower, but it works.
- Is it secure?
- Each device has its own certificate and every connection is end-to-end encrypted (QUIC + TLS 1.3). Our servers only introduce the two ends and relay ciphertext. Who can connect, and to which features, is decided on the machine being reached.
- What does it cost?
- Each device gets a 10-day free trial from first use; after that, buy days, a month or a year on the pricing page.
- Something else?
- Write to support@rockdesk.io — a person reads every message.
三分钟上手
两台电脑装上 RockDesk,输对方的 ID 就连上。远程桌面、终端、文件、转发都走这一条连接,AI 也能直接用。
1两台都装上
- Windows:在下载区下安装包运行。安装包暂时还没做代码签名,可能提示「Windows 已保护你的电脑」,点更多信息 →仍要运行。
- macOS(Apple 芯片、Intel 各一个包):打开 .dmg,把 app 拖进「应用程序」。
- Linux:
sudo apt install ./rockdesk-*-linux-*.deb(x86_64 要 Ubuntu 20.04 起,arm64 要 22.04 起)。那台没有屏幕?看下面。 - 安卓:装 .apk。iPhone / iPad:App Store 搜「RockDesk Remote」(免费),用来连你的电脑。
- 什么都不想装:浏览器打开网页版也能连。
2在要被连的那台:定好谁能连
打开 RockDesk,首页上是这台的 9 位 ID 和临时密码,对方有这两样就能连(1.0.6 起新装默认开着)。连进来的办法在 设置 →「谁能连我」 里选:
- 临时密码:默认开着,首页上显示,用一次换一个。人不在那台电脑前也能连。
- 连接时允许:有人连进来时弹窗,那边的人点「允许」才行。
- 固定密码 / 密钥对:给自己的几台电脑用,输一次就记住(密钥对跟 ssh 一样)。
3从另一台连过去
输入对方的 ID → 连接 → 输临时密码(或者让那边的人点「允许」)。第一次要一两秒打洞,之后远程桌面、终端、文件、转发都是秒开。
没有屏幕的机器:服务器、机器人、开发板
装同一个 .deb,再开系统服务。开机就起,不用有人登录:
sudo systemctl enable --now rockd
sudo rds status # 这台的 ID
sudo rds otp # 现在的一次性密码
从别的机器用这个 ID 和一次性密码连。这种机器上,拿一次性密码进来的人还能用终端和端口转发(文件本来就能传),「连接时允许」是关着的(没人在旁边点)。都能用 rds 改(配置在 /var/lib/rockd):
- 固定密码:
sudo rds passwd(输两遍;sudo rds passwd --clear去掉)。 - 密钥对,跟 ssh 一样:在自己电脑上
rds key gen一次(以后rds key打出的是同一行),在这台上sudo rds authorize "<那一行>"。之后自己的电脑不用密码就能连、什么都能用。 - 一次性密码:
sudo rds otp看,sudo rds otp new换一个,sudo rds config otp off关掉。 - 别人能用哪些:
sudo rds config列出来;sudo rds config feature shell off(还有 file、fwd、mount、vpn、serial、usb……)开关某一项;sudo rds config ask on打开「连接时允许」。
4让 AI 用起来
RockDesk 带着命令行 rds(界面能做的它都能做),还有一份教 AI 用它的 Skill。在 Claude Code 这类 AI 工具的对话框里说这一句,它自己就装好了:
安装下 https://rockdesk.cn/rockdesk-cli.md 这个 skill
AI 用的是命令行 rds(Skill 文件是 rockdesk-cli.md)。macOS 上 rds 在 /Applications/rockd.app/Contents/MacOS/rds;Windows 是 "C:\Program Files\rockd\rds.exe"。然后直接说:
「把 123456789 的屏幕截个图,打开设置,把深色模式打开。」
「把 ~/build/app.zip 拷到 123456789,在它的下载目录里解压。」
对方那台允许你做什么,AI 就只能做什么。
5自己用命令行也行
rds 123456789 shell -c "df -h" # 跑命令,退出码跟对方一样
rds 123456789 cp ./build.zip :~/build.zip # 拷文件(冒号表示对方那边)
rds 123456789 mount :/home/me/proj ~/proj # 把对方的目录挂到本机
rds 123456789 forward 15432:5432 # 对方的 Postgres 映射到本机 15432
rds 123456789 vpn up # 内网穿透到对方
完整用法见 命令行说明。
常见问题
- 连不上?
- 两边都要开着 RockDesk、能上网;再看看被连那台第 2 步开了没有。打不通直连会自动走中继(国内、美国都有节点),慢一点但能用。
- 安全吗?
- 每台设备一张证书,每条连接都端到端加密(QUIC + TLS 1.3),服务器只牵线、转发密文。谁能连、能用哪些功能,由被连的那台决定。
- 要钱吗?
- 每台设备从第一次用起免费试用 10 天,之后按天、月、年买,见价格页。
- 别的问题?
- 写信到 support@rockdesk.io,每封都有人看。