CyberPalm 赛博掌｜安装、配对与外网串流完整教程
更新日期：2026-07-16

============================================================
0. 先看这一句
============================================================

CyberPalm 需要“两端都安装”：

1) 手机或平板安装 CyberPalm 客户端；
2) 电脑安装并运行主机端。

Windows 主机端：Foundation Sunshine 基地版（AlkaidLab）
Apple Silicon Mac 主机端：CyberPalm Base

只安装手机端、没有电脑主机端，无法串流。
CyberPalm Android、HarmonyOS、iOS / iPadOS 客户端与 CyberPalm Base 均为内测版本。
Windows Foundation Sunshine 基地版由 AlkaidLab 发布，基于 LizardByte Sunshine；它本身不是 CyberPalm 内测软件。

CyberPalm 当前仍处于早期开发与设备适配阶段。手机、平板、折叠屏、掌机的屏幕比例、
解码器、系统版本与外设组合很多，我们会根据可复现反馈逐一适配。

反馈 Bug 时请提供：设备平台和型号、系统版本、CyberPalm 版本、电脑系统、主机端版本、
网络环境、问题现象、复现步骤、是否每次出现，以及截图或脱敏日志。
不要发送账号密码、验证码、PIN、证书、私钥、Token 或未脱敏的设备资料。

反馈渠道：
- 官方 QQ 群：812169534
- 一键加群：https://qun.qq.com/universal-share/share?ac=1&authKey=lF6vDoKOWcCzyl0xLl%2B0CVdonLwfY8bzO%2FVLVT%2B2u7hC4vzIAL2JLiI%2B%2Fm6J2T75&busi_data=eyJncm91cENvZGUiOiI4MTIxNjk1MzQiLCJ0b2tlbiI6InhsMDBKOE9DdDhvRm40RnFxZFY5TGJtSEZuNnhtR2RwSGU4a0M0elNrQzJwdWZvZnZweFY3R3RLZHR4clFUYjgiLCJ1aW4iOiIxMjYyNDUzMTM5In0%3D&data=Tqq-xWNS1fDcjTJyR2yHcf2oUUfrcNuaMOnh0NAMeHMglnDLKEO1rtmR29dGammwGZ2nrJim4wdgx0g2_pFZxg&svctype=4&tempid=h5_group_info
- 结构化邮件：ojitomars@gmail.com（标题写“CyberPalm Bug 反馈”）


============================================================
1. Android 客户端
============================================================

怎样选版本：

- Standard：普通 Android 手机、平板和折叠屏默认选择。
- Thor：只用于 AYN Thor 双屏掌机。
- 两个版本使用不同包名，可以同时安装；普通用户没有必要同时安装。

安装步骤：

1) 从 CyberPalm 官方下载页取得 APK。
2) 普通手机或平板确认文件名包含 Standard。
3) 点开 APK。如果系统拦截，只允许当前浏览器或文件管理器“安装未知应用”。
4) 安装完成后，可关闭刚才的“安装未知应用”授权。
5) 打开 CyberPalm，按系统提示允许本地网络访问。
6) 电脑端同时安装并运行 Sunshine 基地版或 CyberPalm Base。
7) 手机与电脑连接同一路由器，再按第 5 节完成 PIN 配对。

如果升级时提示“签名不一致”，先不要卸载旧版。请核对下载来源或进群确认，
否则卸载可能清除原有设置。


============================================================
2. HarmonyOS NEXT 客户端
============================================================

官网下载经过安全复核的真正未签名 789 HAP，再由用户用自己的华为开发者账号签名：
https://cyberpalm.stay-humane.com/downloads/CyberPalm-HarmonyOS-NEXT-0.8-beta-build789-unsigned.hap?v=0.8-789-a1897449
不要把账号验证码、实名资料、签名证书、Profile 或私钥发给他人。

方式 A：小白调试助手（简便，但属于第三方工具）

1) 注册并实名自己的华为开发者账号。
2) 在鸿蒙设备开启开发者模式、USB 调试；无线方式还要开启无线调试。
3) 电脑安装小白调试助手，点击“登录账号 / 更换账号”。
4) 用户本人在打开的华为页面完成登录，返回工具确认账号信息。
5) 用数据线连接设备，或填写无线调试的 IP 与端口，并在手机确认调试授权。
6) 选择 CyberPalm 789 真正未签名的 HAP，点击“开始调试”，等待工具准备证书 / Profile、签名并安装。
7) 如果提示证书失败，先确认网络正常，再在工具中使用“重置证书 / 重置证书配置”。

小白调试助手不是华为或 CyberPalm 官方产品；使用前应核对来源、SHA-256 和原作者说明：
https://github.com/likuai2010/auto-installer/releases/tag/3.1.0
https://gitee.com/xiaobai-studio/XiaoBaiGuide

方式 B：DevEco Studio（华为官方开发方式）

1) 取得 CyberPalm 的完整 HarmonyOS 工程并安装 DevEco Studio。
2) 进入 File → Project Structure → Project → Signing Configs。
3) 勾选 Automatically generate signature，用自己的华为账号登录授权。
4) 连接自己的设备，再通过 Run 重新编译、签名和安装。


============================================================
3. iOS / iPadOS 客户端
============================================================

当前状态：已在中国大陆区以外的 App Store 上线；中国大陆区暂未开放。

官方页面：https://apps.apple.com/app/cyberpalm/id6788013824

1) 无需提交 UDID，也无需 TestFlight。
2) 不安装来路不明的 IPA。
3) 只使用 CyberPalm 官网跳转的官方 App Store 页面。
4) 首次打开时允许“本地网络”权限。
5) 必须先在同一局域网完成首次配对，再尝试外网连接。


============================================================
4. 电脑主机端
============================================================

4.1 Windows：Foundation Sunshine 基地版

原作者 / 维护方：AlkaidLab
上游项目：LizardByte Sunshine
项目地址：https://github.com/AlkaidLab/foundation-sunshine

Foundation Sunshine 是第三方正式开源项目，不是 CyberPalm 内测软件。

1) 普通用户下载 WindowsInstaller.exe，保留默认安装路径。
2) 不要同时运行 Foundation Sunshine 与另一套 Sunshine。
3) 安装完成后重启一次电脑。
4) 在这台电脑的浏览器打开：https://localhost:47990
5) 只有地址确实是 localhost 或自己的局域网 IP 时，才继续通过本地证书提示。
7) 创建独立的管理用户名和强密码。
8) 在“应用”页面确认存在 Desktop / 桌面。
9) 需要手柄时，在故障排除页确认 ViGEmBus 已安装，然后重启。
10) Windows 防火墙询问时允许“专用网络”；不要长期关闭防火墙。
11) 保持 Sunshine 后台服务运行。

电脑最好用网线连接路由器；手机或平板优先使用 5 GHz / Wi-Fi 6。

4.2 macOS：CyberPalm Base

1) Base 公开下载目前暂停；1.02 尚未完成 Developer ID 签名与 Apple 公证。
2) 暂停期间不要寻找旧直链或网盘镜像；只等待官网明确恢复 Base 下载。
3) 将 Base 拖入“应用程序”，并按 DMG 内说明运行一次 install-service.sh。
4) 首次打开若被 Gatekeeper 拦截，右键 Base 选择“打开”；仍被拦截时，到
   “系统设置 → 隐私与安全性”选择“仍要打开”。不要关闭 Gatekeeper。
5) 在“屏幕与系统音频录制”“辅助功能”和“输入监控”中允许 Base。
6) 完全退出 Base 与主机服务，再重新打开，让权限生效。
7) 保持菜单栏主机服务运行，并从菜单栏打开管理页确认桌面可用。
8) Mac 与移动端连接同一路由器，再完成 PIN 配对。

如果串流时窗口自动跑到另一块屏幕：

这是 Base 的“自动跟屏”功能。先停止串流，再用 Mission Control 把窗口移回。
如果不需要自动搬窗，可在 ~/.config/sunshine/sunshine.conf 加入：

mac_follow_windows_to_stream = disabled

保存后重启 CyberPalm Base。


============================================================
5. 局域网 PIN 配对（所有平台通用）
============================================================

PIN 的正确方向：客户端显示，电脑主机端确认。

1) 电脑端安装并保持 Sunshine 或 Base 运行。
2) 手机或平板端打开 CyberPalm。
3) 两台设备连接同一个路由器，不要使用访客 Wi-Fi。
4) 在 CyberPalm 中点选自动发现的电脑。
5) PIN 会显示在手机或平板上。
6) 回到电脑，在主机管理页打开“PIN”。
7) 输入客户端显示的 PIN，并填写设备名称，例如“我的 iPad”。
8) 页面提示成功后返回 CyberPalm。
9) 刷新主机，选择“桌面”或游戏开始串流。

找不到电脑时：

1) 在 Windows 按 Win + R，输入 cmd。
2) 执行 ipconfig。
3) 找到当前网卡的 IPv4 地址，例如 192.168.1.50。
4) 在 CyberPalm 中选择“手动添加主机”，输入该地址。
5) 不要填写路由器网关地址，例如常见的 192.168.1.1。

仍找不到时，依次检查：

- 手机与电脑是否处于同一网段；
- 是否开启访客隔离、AP 隔离或客户端隔离；
- Windows 网络是否设置为“专用网络”；
- 主机端是否仍在运行；
- 防火墙是否允许 Sunshine。

配对失败时：

1) 回到 CyberPalm，重新点选主机，让客户端显示新的 PIN。
2) 把这组新 PIN 输入电脑主机管理页。
3) 仍失败时，在主机端删除旧设备记录后重新发起。


============================================================
6. 外网串流：开始前检查
============================================================

必须先在家中局域网完成 PIN 配对和稳定串流测试。

1) 在路由器“DHCP 地址保留 / 静态租约”中固定电脑的局域网 IP。
2) 记录路由器状态页中的 WAN IPv4。
3) 外网连接填写公网 IPv4 或 DDNS，不填写 192.168.x.x。
4) 端口规则全部指向电脑主机，不指向手机或平板。


============================================================
7. 外网方案 A：Sunshine 自动 UPnP
============================================================

1) 登录自己家里的路由器，确认 UPnP 已开启。
2) 打开 Sunshine Web 管理页。
3) 进入“配置 → 网络”，开启 UPnP。
4) 保存并重启 Sunshine。
5) 手机先在局域网完成配对。
6) 关闭手机 Wi-Fi，切到 4G / 5G 测试。
7) 主机未自动在线时，手动添加家里的公网 IPv4 或 DDNS。

UPnP 默认关闭，只在信任的家庭路由器上使用。
不再需要外网串流时，可以关闭它。


============================================================
8. 外网方案 B：路由器手动端口转发
============================================================

每条规则都指向电脑固定的局域网 IP。
外部端口和内部端口必须相同。

协议    外部端口    内部端口
TCP     47984       47984
TCP     47989       47989
TCP     48010       48010
UDP     47998       47998
UDP     47999       47999
UDP     48000       48000
UDP     48002       48002
UDP     48010       48010

绝对不要转发：

- TCP 47990：Sunshine Web 管理页；
- UDP 5353：局域网自动发现；
- 不要开 DMZ；
- 不要把一整段端口全部转发。

保存规则后：

1) 确认 Windows 防火墙允许 Sunshine。
2) 保持主机端运行。
3) 手机关闭 Wi-Fi，切到 4G / 5G。
4) 在 CyberPalm 中手动添加公网 IPv4 或 DDNS。
5) 公网 IP 经常变化时，在路由器上配置 DDNS。

不同客户端的说明：

- Android Standard / Thor：路由器端口相同。
- HarmonyOS NEXT：路由器端口相同。
- iOS / iPadOS：先允许本地网络，并先在局域网配对。
- Windows Sunshine 基地版：可使用上面的默认端口表。
- macOS CyberPalm Base：只有当前内测包仍显示默认 Sunshine 端口时才照表设置；
  如果 Base 管理页端口不同，以当前测试包或官方群说明为准。


============================================================
9. 端口转发后仍然无法连接
============================================================

检查路由器 WAN IP。以下地址不是公网 IPv4：

- 10.x.x.x
- 100.64.x.x ～ 100.127.x.x
- 172.16.x.x ～ 172.31.x.x
- 192.168.x.x

常见原因：

1) 路由器 WAN IP 与查询到的公网 IPv4 不同：可能是双重路由或运营商 CGNAT。
2) 光猫和自己的路由器都在路由模式：需要让光猫桥接，或在两层设备上分别转发。
3) 运营商 CGNAT：可申请公网 IPv4，或使用能建立直连的 Tailscale / ZeroTier 等组网。
4) 组网一直走中继：通常不适合持续高码率串流。
5) 电脑局域网 IP 改变：重新检查 DHCP 地址保留与转发目标。
6) Windows 防火墙阻止：允许 Sunshine 的专用网络访问，不要直接关闭防火墙。


============================================================
10. 卡顿、黑屏与软件操作
============================================================

卡顿：

- 电脑优先接网线；
- 移动端使用 5 GHz / Wi-Fi 6；
- 先降低分辨率、帧率和码率；
- 外网串流码率必须低于主机网络的实际上行速度。

黑屏：

- 更新显卡驱动；
- 确认使用硬件编码；
- HDR 异常时先关闭 HDR，再用普通 HEVC 测试。

iOS / iPadOS CyberPalm 常用操作：

- 轻点悬浮球，再点“键盘”，打开控制面板；
- 在全键盘按键区或数字 / 导航区横向长划：键盘切换到触控板；
- 在触控板底部左键或右键按钮上横向长划：触控板切回键盘；
- 单指滑动移动鼠标；
- 单指轻点为左键；
- 双指轻点为右键；
- 双指滑动为滚动；
- 单指长按约 0.35 秒后移动为拖拽。


============================================================
11. 官方资料与帮助
============================================================

Sunshine 安装：
https://docs.lizardbyte.dev/projects/sunshine/latest/md_docs_2getting__started.html

Sunshine 网络配置：
https://docs.lizardbyte.dev/projects/sunshine/latest/md_docs_2configuration.html#network

Moonlight 外网串流端口：
https://github.com/moonlight-stream/moonlight-docs/wiki/Setup-Guide#streaming-over-the-internet

Foundation Sunshine：
https://github.com/AlkaidLab/foundation-sunshine

CyberPalm 官方 QQ 群：812 169 534
一键加群：https://qun.qq.com/universal-share/share?ac=1&authKey=lF6vDoKOWcCzyl0xLl%2B0CVdonLwfY8bzO%2FVLVT%2B2u7hC4vzIAL2JLiI%2B%2Fm6J2T75&busi_data=eyJncm91cENvZGUiOiI4MTIxNjk1MzQiLCJ0b2tlbiI6InhsMDBKOE9DdDhvRm40RnFxZFY5TGJtSEZuNnhtR2RwSGU4a0M0elNrQzJwdWZvZnZweFY3R3RLZHR4clFUYjgiLCJ1aW4iOiIxMjYyNDUzMTM5In0%3D&data=Tqq-xWNS1fDcjTJyR2yHcf2oUUfrcNuaMOnh0NAMeHMglnDLKEO1rtmR29dGammwGZ2nrJim4wdgx0g2_pFZxg&svctype=4&tempid=h5_group_info
联系邮箱：ojitomars@gmail.com