VallierDev/uu-remote-linux

非官方 UU 远程 Linux 被控端 · Unofficial Linux host for NetEase UU Remote

Open original source ↗

Older snapshot: check the original source for current information.

From the publisher

README & documentation

Source preview

Read the project’s overview, installation instructions and usage examples. The original README is the source of truth.

简体中文 | English Linux 控制端:设备列表(设备名已打码) Linux 被控端主窗口:远程协助与账号(设备 ID、验证码和账号已打码) 启动时按以下顺序确定界面语言: 协议字段以及 UU 服务器返回的提示按服务器原文显示。 桌面连接建立、结束及服务启动时会清理遗留输入状态;旧连接的迟到事件不能影响新的桌面连接。 X11 清理当前已认证显示上的按下状态(包括无法区分来源的实际按键);uinput 仅清理本服务虚拟设备, Portal 仅作用于本服务获授权的会话。文件传输、终端等独立工具连接不触发桌面松键。 最后一列是源码编译方式;Release 预编译包已包含全部后端,直接使用即可(见安装)。 GNOME Wayland 的 Portal/EIS 路径已在 Ubuntu 26.04、GNOME 50、单屏 4K/200% 缩放下验证画面和键鼠;锁屏冷连接自动解锁已用 Mac 和 iPhone 4.42.0 客户端实机验证,其余锁屏恢复及重连仍待验收。除 GNOME 的上述路径和 X11 外,其余桌面目前主要在虚拟机里测试。如果你在真机上遇到问题,欢迎提交 issue, 请附上 uuremote-server doctor 的输出(v0.2.17 起;只含会话、后端、插件、权限、编码器等状态,不含账号、令牌或地址,可直接粘贴)和 journalctl --user -u uuremote-native.service 里的相关日志。 Wayland 下的限制:默认采集单屏,Hyprland 可按上文启用切屏;分辨率固定;Hyprland 原生后端默认使用双缓冲流水线 shm screencopy,控制端帧率设置会同步到采集节拍和编码器,但实际帧率仍受合成器、渲染和读回速度限制(旧串行路径在 2560x1600 曾测得约 16~22 帧;流水线只在虚拟机里测量过,不代表实机保证);portal 后端暂不支持动态分辨率;GNOME 的屏幕唤醒与锁屏恢复见下;剪贴板只在控制端的远控窗口处于前台时同步。 手机控制端触控(GNOME):Android/iOS 控制端在触控模式下把手指当作左键拖动发送,在桌面上会选中文字。Portal 后端下被控端按每次按下判断:0.45 秒内移动超过几个像素即平滑滚动(NotifyPointerAxis,内容跟随手指,终端里同样有效,最后一个事件让客户端可以惯性滑动);按住不动则像鼠标拖动一样选中;短按为点击。此模式无需触摸屏授权。UUTOUCHINPUT=touch 改为把拖动按单指触控在 Portal 触摸屏上重放,门户提供触摸屏设备类型时被控端会一并申请;此前保存的授权只恢复键盘和指针,因此第一次拖动时会在后台再申请一次(GNOME 共享对话框,手机画面中也能看到,授权超时后自动关闭),同意同一显示器后无需重连即切换为触控。不会预先删除已保存的授权,每次运行最多申请一次。UUTOUCHINPUT=0 保持鼠标拖动。 Wayland 手机输入法打字与剪贴板:Wayland 下手机端输入法提交的文字(textinput)优先通过虚拟键盘空闲键码上屏;GNOME(Portal)下,当前输入源为拉丁 xkb 布局时,可打印 ASCII 直接以 keysym 输入(由 Mutter 选择按键和 Shift 层级);其他文字、KDE 以及键码耗尽的环境自动通过「写系统剪贴板 + 触发 Shift+Insert(或 UUWAYLANDPASTEKEY=ctrlv)」兜底粘贴。VTE 终端的 Shift+Insert 粘贴的是 PRIMARY 选区,因此 ASCII 改为直接输入。注意:此兜底过程会覆盖被控端原有的剪贴板内容,且会被双向同步回传到控制端剪贴板;设置 UUWAYLANDTEXT=0 可完全关闭…

VallierDev/uu-remote-linux on GitHub A short preview, not the full document.

Read the full README ↗ · Preview checked 2026-10-31T20:48:26.193Z

Inside the original README — Document outline
  1. uu-remote-linux · UU 远程 Linux 被控端 + 控制端(非官方)
  2. 语言 / Language
  3. 它是什么
  4. 已实现的功能
  5. 支持的 Linux 桌面
  6. 多显示器切换(实验性)
  7. 尚未实现 / 不支持
  8. 安装
  9. 0. 直接用 Release 预编译包(推荐,x8664 / aarch64)
  10. 1. 依赖(Ubuntu / Debian)
  11. 2. 编译
  12. 3. 登录

Headings are captured from the source. Links open the publisher’s document, not a locally hosted copy.

Links from the README

References supplied by the publisher, not independently verified endorsements. Check the destination before downloading files or entering credentials.

Documentation belongs to its respective authors. Reported project/model license: GPL-3.0. A listing is not a grant of reuse or training rights. Confirm the document’s own terms at the source.

What this repository does

非官方 UU 远程 Linux 被控端 · Unofficial Linux host for NetEase UU Remote

Repository facts

Owner
VallierDev
Primary language
Rust
Stars
354
Forks
195
Open issues + pull requests
19
License
GPL-3.0
Archived
No
Default branch
main
Created
2026-10-14T15:53:43.000Z
Last push
2026-10-21T08:29:20.000Z

Topics and intended use

No topics were included in the latest source metadata.

Review the README for scope, installation, examples and limitations. We do not run repository code or certify it.

Evaluate before installing

Review licensing and dependencies, inspect recent commits and unresolved issues, and test in an isolated environment before production use. Stars and forks alone cannot answer these questions.

README and project files

Issues and maintenance discussion

Releases and changelog

Source and freshness

Source: GitHub. Metadata observed 2026-10-21T12:11:54.486Z. Daily imports are snapshots, not real-time monitoring.

Popularity and source listings do not establish security, suitability, licensing rights or benchmark performance.

Open original source

Related repositories

ultraworkers/claw-code

clash-verge-rev/clash-verge-rev

farion1231/cc-switch

openai/codex

rustdesk/rustdesk

rust-lang/rust