uu-remote-linux：UU 远程 Linux 被控端

项目简介

uu-remote-linux 是非官方的网易 UU 远程 Linux 被控端，用纯 Rust 编写，不需要 Wine，也不依赖任何 Windows / macOS 组件。用你自己的 UU 远程账号扫码登录后，这台 Linux 会出现在官方客户端的设备列表里，用法和官方 Windows 被控端一样。

项目另外附带一个实验性的 Linux 控制端 uuremote-viewer，可以在 Linux 上用 UU 账号远控官方 Windows / Mac 被控端或本项目主机。没有桌面的群晖 / NAS 也可以用 Docker 部署。

主要功能

• 主窗口与扫码登录：一个窗口包含「本设备」（远程协助）和「账号」两部分，未登录时显示二维码；也可用 login --no-gui 在终端扫码。
• 远程协助（实验性）：把设备 ID + 验证码发给别人，对方在 UU「开始协助」里输入即可连接，登录前（访客身份）与登录后都能用。
• 远程桌面：H.264 视频，NVIDIA 显卡走 NVENC 硬件编码，否则用 libx264；查看端绘制本地鼠标，不出现双光标。
• 鼠标 / 键盘：绝对/相对移动、点击、滚轮、按键；Wayland 下可用 uinput 虚拟键鼠。
• 剪贴板：双向文本同步。
• 画质 / 帧率 / 分辨率：自动、原画 20M、超清 8M、高清 2M、自定义；30/60/90/144 帧；X11 下切换分辨率会真正修改桌面分辨率。
• 声音：采集系统声音（PulseAudio / PipeWire），Opus 编码传到控制端。
• 文件传输：上传、下载（含文件夹）、新建文件夹、重命名、删除。
• 终端：官方「终端」工具，PTY 会话，支持多会话和重命名。
• 锁屏与自动解锁：向控制端上报锁屏状态，开启自动解锁后通过 PAM 校验密码解锁当前会话；也可设置远程结束后自动锁屏。
• 系统操作：锁屏、显示桌面、任务管理器、重启、关机（通过 systemctl）。
• 端口映射：把控制端本地端口转发到 Linux 能访问到的地址（如 127.0.0.1:22）。
• 无头服务器：没有显示器也能上线，提供终端、文件传输和端口映射，也可配合 Xvfb 提供完整远程桌面。
• 实验性控制端 uuremote-viewer：在 Linux 上远控官方 Windows / Mac 被控端或本项目主机，支持桌面、文件传输、终端、端口映射、远程协助。

支持的环境

桌面环境	显示协议	状态
GNOME（Ubuntu 24.04）	X11 / Xorg	✅ 实机长期使用
KDE Plasma / Xfce / Cinnamon / MATE	X11	✅ 虚拟机测试通过
Hyprland / niri	Wayland（wlroots 原生协议）	🧪 实验性
GNOME / KDE Plasma	Wayland（xdg-desktop-portal）	🧪 实验性

Release 预编译包已包含全部后端，直接使用即可。

安装与使用

Ubuntu / Debian：下载 uu-remote-linux_<版本>_amd64.deb（ARM64 选 arm64）后安装，扫码登录并启用用户级服务：

sudo apt install ./uu-remote-linux_<版本>_amd64.deb
uuremote-server login
systemctl --user enable --now uuremote-native.service

其他发行版：下载 uu-remote-linux-<版本>-x86_64-linux.tar.gz（ARM64 选 aarch64-linux），解压后用普通桌面用户（不要 root）运行 ./install.sh，脚本会把程序和插件装到 ~/.local，并写入用户级 systemd 服务。

Docker：镜像 ghcr.io/vallierdev/uu-remote-linux，适合没有桌面的群晖 / NAS。

服务启动时和每次有人连接桌面时都会检查 FFmpeg，FFmpeg 需带 libx264，否则客户端会一直停在「正在传输画面」。

注意事项

• 本项目是个人兴趣项目，与网易无关，也不是官方客户端。
• 官方只提供被控端的 Linux 版本；用来控制别人的客户端仍是官方 Mac / Windows / 手机 App（Linux 控制端为实验性）。
• uinput 权限不会自动开启，需要按文档自行配置。
• Wayland 下仍有限制：默认采集单屏、分辨率固定、剪贴板只在远控窗口处于前台时同步等。
• 尚未实现：HDR、超级屏 / 虚拟显示器、麦克风（控制端声音传到被控端）、Linux 系统登录界面控制、魔兽世界排队提醒等插件。
• 被控端防窥模式为实验性功能，目前仅支持 KDE Plasma Wayland。

---

本作品整理自 GitHub 开源项目 VallierDev/uu-remote-linux，原作者 @VallierDev，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。