Dirently 使用指南

从另一台电脑或手机控制你自己的电脑。设备之间直接连接，不需要账号。

快速上手 · macOS · Windows · Android · 远程麦克风 · 快捷键 · 连不上？ · 卸载

1. 安装 Dirently：要被控制的电脑和你用来连接的设备都要装。在 Releases 下载。
2. 创建小组：在其中一台设备的 设备 页面点 创建小组，填写 小组名称 和 小组密码（至少 10 个字符，不能是常见密码；点 生成强密码 可以自动生成）， 保持 私人小组，点 创建并加入。
3. 加入小组：在另一台设备上点 查找小组，搜索名称，点 加入，输入密码， 再点 加入小组。如果小组管理员给了你一次性邀请，就在 查找小组 里点 使用邀请，粘贴邀请码或链接。
4. 确认电脑已共享：共享默认是开的，这时电脑自己的卡片上显示 停止共享。 如果显示的是 共享本机，点一下它。
5. 连接：在另一台设备上，点这台电脑卡片上的 连接。

需要知道：

• 任何人都能用 查找小组 按名称找到小组。请用强密码，只告诉你信任的人。
• 想让新设备加入又不想给出密码：打开 管理小组 → 邀请与保护 → 邀请新设备。 每个邀请（邀请码、链接或二维码）只能让一台设备加入一次。这里还可以打开 需要管理员批准：之后输对密码也只是提交申请，由管理员同意。有人反复猜密码时， 管理员会在这里看到提醒。
• 连续输错 10 次密码，这台设备就会被该小组封禁，直到小组管理员解封 （管理小组 → 封禁 → 解封）。
• 所有设备请保持同一个 Dirently 版本。

需要 Apple 芯片的 Mac，macOS 13 或更高版本。

1. 打开 Dirently-<版本>-arm64.pkg，按提示安装。安装包经过 Apple 签名和公证， macOS 打开时不会弹出警告。
2. 装好后 Dirently 会在后台启动。点菜单栏里的 Dirently 图标，选 显示 Dirently； 也可以从"应用程序"里打开。
3. 在 系统设置 → 隐私与安全性 中打开下面的权限。只用来控制别的设备的 Mac， 不需要前两项。

如果 macOS 提示退出并重新打开 Dirently，照做即可。列表里显示的名称是 Dirently；如果 还看到 dirently-host，也一起打开。

关闭窗口不会退出 Dirently，它会留在菜单栏，这台 Mac 仍能被连接。要退出，在菜单栏 图标里选 退出。

需要 64 位的 Windows 10 或 11。

1. 运行 Dirently-Setup-<版本>.exe。
2. 如果看到 Windows 已保护你的电脑，点 更多信息，再点 仍要运行。 测试版安装包还没有代码签名。
3. 允许更改时点 是。安装程序会添加后台服务、防火墙规则、虚拟显示器驱动（没接 显示器的电脑也能共享），以及遥控手柄用的 ViGEmBus 驱动（电脑上没有时才装）。
4. Dirently 随后打开，并会随 Windows 启动（设置 → 本机共享 → 随 Windows 启动 Dirently）。关闭窗口后它会继续在通知区域运行。

Android 应用用来控制你的电脑，手机本身不能被控制。需要 Android 12 或更高版本。

1. 在手机上从 Releases 下载 .apk 并打开。允许浏览器或 文件管理器安装应用（允许来自此来源的应用），再点 安装。如果 Play 保护机制 提示这是未知应用，仍可继续安装。
2. 按快速上手创建或加入小组。在线且已共享的电脑会出现在列表里，点 连接。
3. 会话中，点屏幕顶部的小标签打开会话菜单：键盘、操控方式（直接触控、触控板 或虚拟鼠标）、麦克风透传、文件 和 断开连接。

你可以把麦克风传到被控电脑，让它上面的应用（通话、游戏）听到你。被控电脑（Windows 或 Mac）需要安装免费的 VB-CABLE 驱动，Dirently 不包含它。

1. 在被控电脑上，从 https://vb-audio.com/Cable/ 安装 VB-CABLE，然后重启。VB-CABLE 是捐赠软件，使用 VB-Audio 自己的许可条款。
2. 在这台电脑的 设置 → 声音 → 虚拟麦克风桥 中，应显示 已检测到 VB-CABLE：…。 如果显示 此设备未检测到 VB-CABLE。，请装完并重启，再点 重新检测。
3. 在你用来控制的设备上，在 设置 → 声音 或会话菜单里打开 麦克风透传。

会话菜单里显示 麦克风 - 就绪 就表示可以用了；显示 麦克风 - 就绪（已设为远端默认输入） 时，Dirently 还在本次会话中把 VB-CABLE 设成了 被控电脑的默认麦克风。显示 远端缺少虚拟麦克风 表示那台电脑没装 VB-CABLE：点 获取 VB-CABLE，装好后点 重新检测。如果某个应用还是听不到你，在该应用里把 麦克风选成 VB-CABLE（Windows 上叫 CABLE Output）。

在会话窗口中：

• 上面这些快捷键和下面的紧急断开键都可以在 设置 → 快捷键 里修改。
• 会话菜单就是会话窗口里那个可以拖动的 Dirently 图标。
• 当 沉浸模式（设置 → 远程画面）或游戏占住鼠标和键盘时才需要"松开"。在窗口里点 一下即可重新接管。
• 在 Mac 上，F11 和 F12 会像普通按键一样发给远程电脑。

紧急断开。 如果有人正在控制你的电脑，在这台电脑自己的键盘上按 F12（Mac 上 通常是 fn+F12，并需要"辅助功能"权限），会立即结束所有传入的会话。它只是断开， 对方还能再连：要让所有人都连不进来，点 停止共享，或打开 禁止所有远控 （设置 → 本机共享）。在 Windows 锁屏、管理员权限确认窗口和 Mac 密码输入框中，F12 不起作用。

手机快捷键栏。 会话中打开会话菜单，点 键盘。键盘上方会多出一排手机没有的 按键，并按被控电脑的系统显示：

连点两下 Shift（先打开再关闭），中间不按别的键，就能把电脑的输入法在中英文之间 切换（前提是该输入法用 Shift 切换）。

Dirently 没有中转。我们的服务器只帮设备互相找到对方；画面、声音和操作都在设备之间 直接传输，从不经过我们的服务器，出问题时也不会改走服务器。所以两边网络必须能直接 连通。大多数家庭网络都可以。连不通时，Dirently 会说明原因，开头是"双方网络无法直接 连通。"

1. 基本检查。 两台设备都在线、在同一个小组、版本相同；被控电脑显示 停止共享，并且 禁止所有远控 是关的（设置 → 本机共享）。
2. 在路由器上打开 UPnP。 Dirently 里的 启用 UPnP 自动端口映射 要保持打开 （设置 → 网络，默认打开）。该页的 NAT 一栏会显示结果，例如 端口映射：UDP …。
3. 映射表已满。 如果看到 端口映射：路由器拒绝了请求，映射表可能已满（重启 路由器可清空），重启路由器后再试。如果还会出现，就改用端口转发。
4. 用 ZeroTier（最省事）。 在两台设备上都装免费的 ZeroTier， 加入同一个 ZeroTier 网络。Dirently 会自动发现 ZeroTier 的地址并通过它连接，不用 设置路由器。打开 ZeroTier 后先等几秒再连接。如果手机刚在 Wi-Fi 和流量之间切换过，把 ZeroTier 关掉再打开一次。ZeroTier 通常是设备间直连，延迟和平常一样；只有它也打不通时，才会 经它自己的服务器中转，延迟会变高（zerotier-cli peers 里显示 DIRECT 或 RELAY）。Android 同一时间只能运行一个 VPN 类应用，开 ZeroTier 时不能同时开 别的 VPN。
5. 端口转发（最后的办法）。 在要被控制的电脑上，把 本机被控起始端口 （设置 → 网络）设成 1025 到 65534 之间的固定数字（0 表示随机），保存。然后在它的 路由器上把这个 UDP 端口转发到这台电脑，并给这台电脑分配固定的内网 IP。如果 受限的是你用来连接的那一边，就在那边用 客户端端口 做同样的设置。
6. 受限网络。 如果 Dirently 提示你的网络外还有一层运营商 NAT，请在对方那边开放 端口。如果两边都在受限网络上（手机流量、公司、学校、酒店、部分 VPN），可能无法 直接连接；请让其中一边换到家庭网络。
7. 防火墙。 在其他防火墙或安全软件中放行 Dirently。

没有画面？ 如果看到 远程设备未发送视频，在那台 Windows 电脑的 设置 → 本机共享 中把 显示器 设为 虚拟显示器。

反馈问题： 告诉我们用了哪些设备（例如"Windows 11 电脑 → MacBook"）、出了什么 问题，以及 Dirently 显示的原话。在 Android 上可以附上 设置 → 常规 → 诊断 → 导出诊断日志 生成的文件（不含密码、密钥、ID 和 IP 地址）。 Discord · support [at] dirently.com · GitHub Issues

Windows： 设置 → 应用 → 已安装的应用（Windows 10 为"应用和功能"）→ Dirently → 卸载。这会删除应用、后台服务、防火墙规则和虚拟显示器驱动。会保留 ViGEmBus 驱动（其他应用可能在用；不需要的话在同一列表里卸载）、你装过的 VB-CABLE， 以及保存在 C:\ProgramData\Dirently 的设备身份和设置（重装后仍在原来的小组；想彻底 清除就删除这个文件夹）。

macOS： 在菜单栏图标里选 退出，再把 Dirently 从"应用程序"拖到废纸篓。 也可以在 系统设置 → 隐私与安全性 的各个列表里把它删掉。设备身份和设置保存在 ~/Library/Application Support/dirently，想彻底清除就删除这个文件夹。

Android： 长按 Dirently 图标，选 卸载。这会删除手机的设备身份，重装后需要 重新加入小组。