VallierDev/uu-remote-linux

选用指南

AI 根据 README 整理 · 2026/10/22 14:06:35

适用场景

适用于需要从 Mac、Windows 或手机远程控制 Linux 电脑的用户，支持无头服务器和 Docker 部署。

查看 README 依据

# uu-remote-linux · UU 远程 Linux 被控端 + 控制端（非官方） **简体中文** | [English](README.en.md) > **写在前面** > > 网易 UU 远程非常好用，但官网一直没有 Linux 版本。于是我借助 Claude 和 Codex，写了这个开源的 Linux 被控端： > 装上之后，就能用官方的 Mac / Windows / 手机客户端远程控制你的 Linux 电脑。 > 现在还附带一个**实验性 Linux 控制端** `uuremote-viewer`：在 Linux 上用 UU 账号远控官方 Windows / Mac 被控端或本项目主机 > （桌面、文件传输、终端、端口映射、远程协助，详见[下文](#实验性原生控制端uuremote-viewer)）。 > 没有桌面的**群晖 / NAS** 也能用 Docker 部署：[部署指南](docs/deploy-nas-docker.md)，镜像 [`ghcr.io/vallierdev/uu-remote-linux`](https://github.com/VallierDev/uu-remote-linux/pkgs/container/uu-remote-linux)。 >

| 锁屏与自动解锁 | 向控制端上报锁屏状态；开启「自动解锁被控端」后，通过 PAM 校验密码并解锁当前会话 | | 远程结束后自动锁屏 | 设置保存在本机，重连后依然生效 | | 被控端静音运行 | 主机扬声器静音，控制端照常能听到声音；结束后恢复原来的音量设置 | | 系统操作 | 锁屏、显示桌面、任务管理器（系统监视器）、重启、关机（通过 `systemctl`，需要当前用户有 polkit 权限：通常本机有活动的图形会话即可；没有权限时直接失败并记日志，不会在被控端弹出密码框） | | 端口映射 | 官方「端口映射」工具：把控制端本地端口转发到 Linux 能访问到的地址（如 127.0.0.1:22）；`UU_PORT_MAPPING=0` 可关闭 | | 多次重连 | 每个工具窗口独立连接，互不影响 | | 无头服务器 | 没有显示器也能上线，提供终端、文件传输和端口映射；也可以用 Xvfb 虚拟桌面提供完整远程桌面（见下文） | 桌面连接建立、结束及服务启动时会清理遗留输入状态；旧连接的迟到事件不能影响新的桌面连接。 X11 清理当前已认证显示上的按下状态（包括无法区分来源的实际按键）；uinput 仅清理本服务虚拟设备， Portal 仅作用于本服务获授权的会话。文件传输、终端等独立工具连接不触发桌面松键。 ## 支持的 Linux 桌面

目标用户

面向 Linux 用户，特别是需要远程控制 Linux 桌面的用户。

查看 README 依据

# uu-remote-linux · UU 远程 Linux 被控端 + 控制端（非官方） **简体中文** | [English](README.en.md) > **写在前面** > > 网易 UU 远程非常好用，但官网一直没有 Linux 版本。于是我借助 Claude 和 Codex，写了这个开源的 Linux 被控端： > 装上之后，就能用官方的 Mac / Windows / 手机客户端远程控制你的 Linux 电脑。 > 现在还附带一个**实验性 Linux 控制端** `uuremote-viewer`：在 Linux 上用 UU 账号远控官方 Windows / Mac 被控端或本项目主机 > （桌面、文件传输、终端、端口映射、远程协助，详见[下文](#实验性原生控制端uuremote-viewer)）。 > 没有桌面的**群晖 / NAS** 也能用 Docker 部署：[部署指南](docs/deploy-nas-docker.md)，镜像 [`ghcr.io/vallierdev/uu-remote-linux`](https://github.com/VallierDev/uu-remote-linux/pkgs/container/uu-remote-linux)。 >

使用方式

通过命令行或图形界面使用，支持扫码登录和 systemd 服务常驻。

查看 README 依据

| Linux 系统登录界面 | 还不支持控制开机后的系统登录界面（还没有人登录 Linux 桌面时）；这种情况可以用无头模式或虚拟桌面（见下文）。注意：这里说的是 Linux 系统登录，**不登录 UU 账号**现在可以通过「远程协助」使用 | | 跨运营商 / 受限网络的中继连接 | 已接入官方下发的 ICE 服务器，但复杂网络环境未充分测试 | | 作为控制端（在 Linux 上控制别的电脑） | 🧪 实验性 `uuremote-viewer`，见[下文](#实验性原生控制端uuremote-viewer) | ## 安装 ### 0. 直接用 Release 预编译包（推荐，x86_64 / aarch64） **Ubuntu / Debian（v0.2.18 起）**：下载 `uu-remote-linux_<版本>_amd64.deb`（ARM64 选 `arm64`）后： ```sh sudo apt install ./uu-remote-linux_<版本>_amd64.deb uuremote-server login # 用 UU 远程 App 扫码 systemctl --user enable --now uuremote-native.service # 随图形会话启动

### 4. 作为用户服务常驻 `~/.config/systemd/user/uuremote-native.service`： ```ini [Unit] Description=UU Remote Linux host (unofficial) After=graphical-session.target PartOf=graphical-session.target [Service] Environment=RUST_LOG=info # GNOME/KDE 等桌面会把 DISPLAY / WAYLAND_DISPLAY 导入用户管理器，并启动 graphical-session.target ExecStart=%h/.local/bin/uuremote-server Restart=always RestartSec=5 [Install] WantedBy=graphical-session.target ``` ```sh install -Dm755 target/release/uuremote-server ~/.local/bin/uuremote-server systemctl --user daemon-reload systemctl --user enable --now uuremote-native.service

部署要求

需要 glibc ≥ 2.35（X11）或 ≥ 2.39（GNOME/KDE Wayland），以及 FFmpeg 等依赖。

查看 README 依据

| X11 | glibc ≥ 2.35（Ubuntu 22.04、Debian 12 及更新） | | Hyprland / Sway / niri 等 wlroots | 同上，另需 `libwayland-client`、`libxkbcommon`（Wayland 桌面自带） | | GNOME / KDE Wayland | glibc ≥ 2.39（Ubuntu 24.04、Fedora 40、Debian 13 及更新），以及 libei ≥ 1.1、PipeWire | 插件放在 `uuremote-server` 同目录、`../lib/uu-remote-linux/`、`~/.local/lib/uu-remote-linux/` 或 `/usr/lib/uu-remote-linux/` 都能找到 （`UU_ENGINE_DIR` 可指定）。缺库或版本太旧时日志会写明原因。之后从第 3 步「登录」继续；其他架构请按下面源码编译。 ### 1. 依赖（Ubuntu / Debian） ```sh sudo apt install build-essential pkg-config \ libx11-dev libxext-dev libxtst-dev libxfixes-dev \ libgtk-3-dev ffmpeg

已知限制

不支持 HDR、超级屏、被控端防窥模式、麦克风传输和 Linux 系统登录界面控制。

查看 README 依据

切屏复用同一条视频轨道，过渡期间暂停输入，发送新屏首帧后恢复；采集或编码失败、等待首帧超时会请求恢复原屏。当前通过 `hyprctl` 枚举未旋转的显示器，显示器插拔或布局变化后需重启服务。已在 Omarchy / Hyprland 上用官方手机客户端实测 2560×1440（125%）与 1920×1080（133.33%）双屏切换及点击。 ## 尚未实现 / 不支持 | 功能 | 状态 | |---|---| | 多显示器切换 | Hyprland 原生 Wayland 后端实验性支持，见上文 | | 真彩（4:4:4） | 支持（v0.1.15）：NVENC / libx264 的默认 FFmpeg 管线输出 H.264 High 4:4:4；`inproc-av` 原生 NVENC 输出 H.264 High 4:4:4 / HEVC FRExt；VAAPI 管线仍为 4:2:0，并如实回报给客户端 | | HDR | 未实现 | | 超级屏 / 虚拟显示器 | 未实现 | | 被控端防窥模式 | 未实现 | | 麦克风（控制端声音传到被控端） | 未实现（需要虚拟声卡） | | 魔兽世界排队提醒等插件 | 不支持，会明确告诉客户端「无插件」 |

| Linux 系统登录界面 | 还不支持控制开机后的系统登录界面（还没有人登录 Linux 桌面时）；这种情况可以用无头模式或虚拟桌面（见下文）。注意：这里说的是 Linux 系统登录，**不登录 UU 账号**现在可以通过「远程协助」使用 | | 跨运营商 / 受限网络的中继连接 | 已接入官方下发的 ICE 服务器，但复杂网络环境未充分测试 | | 作为控制端（在 Linux 上控制别的电脑） | 🧪 实验性 `uuremote-viewer`，见[下文](#实验性原生控制端uuremote-viewer) | ## 安装 ### 0. 直接用 Release 预编译包（推荐，x86_64 / aarch64） **Ubuntu / Debian（v0.2.18 起）**：下载 `uu-remote-linux_<版本>_amd64.deb`（ARM64 选 `arm64`）后： ```sh sudo apt install ./uu-remote-linux_<版本>_amd64.deb uuremote-server login # 用 UU 远程 App 扫码 systemctl --user enable --now uuremote-native.service # 随图形会话启动