VallierDev/uu-remote-linux

效率与系统工具

让 Linux 电脑以被控端身份出现在网易 UU 远程官方客户端里的非官方主机程序。

418
214
Rust
GPL-3.0
上线 10 天

如果你已经在 Windows 或 Mac 上用 UU 远程,又希望 Linux 机器也能被同一套官方客户端控制,这个项目值得看一眼。它不是成品,也与网易无关。

解决什么问题

你想用手机上或 Mac 上已经装好的客户端去连一台 Linux 主机,但网易 UU 远程只发布了 Windows、Mac 和手机端,Linux 电脑根本不会出现在设备列表里。这个项目用你自己的 UU 账号扫码登录,把这台 Linux 注册成被控端,之后官方客户端就能像连 Windows 被控端那样连过来。连上以后,远程桌面、文件传输、终端、端口映射这些操作基本沿用官方客户端的入口,不需要另装一套远控软件。

有什么不同

它是纯 Rust 写的原生程序,不是 Wine 套壳,也没有重做一套客户端界面,而是直接对接被控端的协议。因此控制端仍然是官方的手机或 Mac App,项目本身主要补的是缺失的平台位置。视频用 H.264,有 NVIDIA 显卡时走 NVENC,否则用 libx264;声音通过 PulseAudio 或 PipeWire 采集后用 Opus 传输。X11 主机可以通过 xrandr 真正修改桌面分辨率,作者也说明 NVENC 与 libx264 路径输出真彩 4:4:4。

代价是覆盖面不均。Wayland 支持比较分散:Hyprland 和 niri 走实验性的原生协议,GNOME 和 KDE 走 xdg-desktop-portal,portal 路径下分辨率固定,并且默认只采集单屏,多屏要额外开启。HDR、虚拟显示器、控制端麦克风传到被控端、以及控制 Linux 系统登录界面,都明确列为未实现。项目另有一个实验性的 uuremote-viewer,可以在 Linux 上当控制端,但那是次要角色。

谁值得试

适合已经有 UU 账号、手边有官方客户端,又想连 Linux 桌面或无头服务器、但不想再引入另一套远控方案的人。群晖或 NAS 是个典型例子:项目提供了 Docker 部署路径,没有桌面也能上线,提供终端、文件传输和端口映射。

不适合需要 HDR、虚拟显示器、在所有 Wayland 合成器上都稳定,或者要在无人登录时控制 Linux 登录界面的用户。主力机是 Hyprland 或 niri 的话,要有实验性路径的心理准备;如果是 Ubuntu 24.04 上的 GNOME X11 这类主流组合,那是作者声称日常使用的配置,其他几个桌面则主要在虚拟机里验证。

使用条件与边界

你需要一个现成的 UU 账号,控制端仍然要用官方客户端,项目不替代它。安装方式有面向 x86_64/aarch64 的 .deb、其他发行版的 release 压缩包,以及给 NAS 用的 Docker 镜像,具体步骤见 README。Xfce 这类不会把显示环境传给用户服务的桌面,需要自己补 DISPLAY。

Wayland 下通过 portal 注入键鼠,在某些键盘布局下会丢符号,项目建议改为给当前登录用户开放 /dev/uinput 权限;这需要一条 udev 规则,deb 不会自动完成。日常维护也有成本:多屏模式的显示器布局在主机启动时读取,插拔显示器后要重启服务;出问题时作者希望先附上 uuremote-server doctor 的输出。项目自述是个人兴趣作品,与网易无关,所以对后续官方客户端更新带来的兼容性,应当持续关注而不是默认没问题。

HotRepo 点评

HotRepo 只记录了两个榜单日期:2026-10-25,项目创建 10 天,以 418 总星数排在 rust 新项目榜第 21 名。这是一次快照,不是逐日增长序列,暂时无法判断热度能否持续。决定动手前,先对照支持桌面表确认你的合成器和登录方式落在 X11 还是 Wayland 路径上。

本文由 AI 根据项目 README 生成,更新于 2026年10月25日,以项目官方文档为准。