前言

本手册面向四类使用者：

文档地图

阅读约定

• 文中 → 表示点击路径，例如 主机 → 设置。
• 「主机端」指被控的 Windows 电脑；「控制端」指你正在使用的浏览器。
• 「匿名房间」指不登录、凭分享链接进入的会话；「登录态」指使用 YiLink 账号在控制台看到主机列表后连接。
• 界面文字以简体中文为准；括号内英文为对应术语，便于后续英文版翻译。
• 截图中的账号、IP、主机 UUID 已做打码处理；示例值不代表真实环境。

一句话理解 YiLink

主机端服务（Windows，常驻后台）
        │  主服务 + 信令服务（自动重连）
        ▼
YiLink 云端：SSO / 信令 / TURN / Gamespace
        │
        ├── 控制端浏览器：控制台 → 远控页（WebRTC P2P，默认自动 TURN 兜底）
        ├── 匿名访客：分享链接 → 房间页 → 主机确认
        └── Gamespace 玩家：游戏库 → 试玩页（edge 节点）

反馈与修订

• 页面右上角 帮助 指向官网手册页；本目录是仓库内的可维护版本。
• 发现界面与手册不一致时，以页面实际文案和 web-client/pAGENTS.md、gamespace-server/pAGENTS.md 为准。
• 截图清单与来源见 11 附录。
• 英文版见 yiLink-manual.en.html（源文件在 en/）。

01 快速开始

本章只做一件事：让你在五分钟内完成第一次远程连接。更细的配置放到后面的章节。

1.1 先分清三条接入路径

YiLink 有三种完全不同的入口，先选对路径，后面就不会绕：

三种路径最终都进入远控页（remote.html），控制栏和输入能力一致；差别在“共享的是什么”和“是否需要账号/确认”。

1.2 路径 A：匿名房间（最快）

主机端（被控电脑）

1. 确认主机端服务已启动，托盘图标存在。
2. 右键托盘图标，菜单里可以直接 打开设置页，或 创建匿名共享桌面（完全共享）。
3. 如果只想共享某个应用/游戏，打开设置页 → 房间管理 → 选择应用/游戏 → 创建共享房间。
4. 复制页面上的房间链接（形如 https://z.mycloudgame.com/room.html?room=xxxxxxxx）。

控制端（你的浏览器）

5. 打开链接，页面显示主机名、连接数、双方 NAT 类型和有效期倒计时。
6. 可选填“连接请求附言”，点 请求连接。
7. 主机端弹出确认后点允许，画面出现即连接成功。

匿名房间最长存在 8 天；如果主机连续 24 小时没有上线，房间会提前释放。以房间页倒计时为准。

1.3 路径 B：登录态控制（日常推荐）

1. 打开 https://z.mycloudgame.com/login.html。没有账号先点 注册账号，完成邮箱注册（邮箱 + 密码 + 确认密码，可选填 Solo 兑换码）。
2. 用注册好的邮箱密码登录；也可以用 Google / Steam 登录（首次登录自动创建账号）。
3. 进入控制台，等待主机卡片出现。
4. 点主机卡片中间的蓝色 连接 按钮。
5. 浏览器新开远控页，几秒内出现主机桌面。

登录态不需要主机端逐次确认，适合自己常用的电脑。

图 1-1 控制台主页：左侧为在线主机卡片，底部为快速连接，右上角为账号与语言切换。

1.4 路径 C：Gamespace 试玩

1. 打开 https://gs.mycloudgame.com/public/games。
2. 选游戏卡片上的 立即试玩（有主机在线时）或 详情 查看介绍。
3. 试玩页会依次显示“正在连接服务器 → 正在建立画面连接 → 试玩已就绪”。
4. 试玩时长结束后出现结束页，可按活动配置跳转商店或停留。

1.5 连接前检查清单

• 主机端托盘图标在；右键托盘的菜单或设置页能看到 主服务/信令服务均为已连接。
• 控制端浏览器为 Chrome / Edge / Safari / Firefox 的较新版本。
• 页面通过 HTTPS 打开（WebRTC、剪贴板、手柄等能力依赖安全上下文）。
• 主机没有休眠/关机；锁屏不影响连接（安装版可正常登录，免安装版有权限限制）。
• 对称 NAT 不必自备 TURN：系统默认自动使用 mycloudgame.com 的 TURN 中继，但延迟受中继位置与容量影响；如需稳定低延迟，可在主机端配置自己的 TURN（优先使用）。
• 公司/校园网没有拦截 UDP 3478、TCP 443。

1.6 第一次连接的正常现象

1.7 接下来读什么

• 想调画质/帧率/多显示器 → 04 远程会话
• 想配置主机端服务、TURN、开机自启 → 07 主机端服务
• 想上架游戏、看试玩数据 → 09 Gamespace 控制台
• 连不上 → 10 故障排查

02 账号与登录

YiLink 的账号体系由 SSO 服务统一提供。控制台、会员、CDKey、Gamespace 控制台都复用它；主机端登录也是同一个账号。

2.1 注册

使用邮箱登录前必须先注册；Google / Steam 首次登录会自动创建账号。邮箱注册入口在登录页：

1. 打开 https://z.mycloudgame.com/login.html。
2. 点 注册账号（或直接访问 login.html?show=register）。
3. 填写邮箱、密码、确认密码；如有 Solo 兑换码可一并填写（可选）。
4. 勾选同意服务条款与隐私政策，点 注册账号。
5. 按提示完成邮箱验证（涉及付费/兑换时必须有已验证邮箱），然后返回登录。

注册方式共三种：

注意事项：

• mycloudgame.com（国际）和 mycloudgame.cn（中国）是两套独立服务器，账号不互通，需要分别注册。
• 付费用户必须有邮箱；只绑 Steam 不绑邮箱无法完成付费相关流程。
• 密码建议使用密码管理器生成；不要在多个站点复用。

2.2 密码登录

图 2-1 登录页：邮箱 + 密码，支持记住我、扫码和第三方账号。

常见提示：

• 邮箱或密码错误：确认没有多余空格；确认当前站点是 .com 还是 .cn。
• 账号被锁定/频繁失败：稍后再试，或走找回密码。
• 登录后没有主机：主机端没有登录同一账号，或主机离线（见 7.3）。

2.3 扫码登录

适合在电视、平板、会议室等不方便输密码的设备上使用。

1. 在登录页点 使用扫码登录。
2. 用已登录的手机扫描二维码。
3. 手机端确认后，网页自动登录。

二维码有时效，过期后刷新页面重新生成。

2.4 第三方账号

登录页底部提供：

• Steam 登录
• Google 登录

首次使用第三方登录会自动创建账号（不是先注册再绑定）：

• Google：直接使用 Google 账号邮箱，账号信息最完整。
• Steam：Steam 不返回邮箱，首次登录后需要到 用户中心 → 登录方式 手动关联邮箱；付费前必须完成。

也可以在 用户中心 → 登录方式 里把 Google / Steam 绑定到已有邮箱账号。

图 2-2 用户中心 → 登录方式：主账号邮箱 + Google/Steam 绑定入口。

绑定后仍建议保留邮箱密码登录方式，避免第三方账号异常时无法进入。

2.5 用户中心

点导航栏右侧的邮箱地址，进入 用户中心。共三个标签页：

概览

图 2-3 用户中心 → 概览。

会员与账单

详见 06 会员与计费。

登录方式

• 显示主账号邮箱。
• Google / Steam 显示“已绑定”或“未绑定”，右侧按钮用于绑定/解绑。

2.6 退出登录

点右上角 退出。退出后：

• 控制台回到未登录状态，主机列表隐藏。
• 本机保存的会话令牌被清理。
• 匿名房间链接不受影响（它不依赖你的账号）。

在公用电脑上使用后，除了退出，还建议清理浏览器站点数据。

2.7 多账号与切换

部分版本支持在同一浏览器保存多个账号的会话。切换账号时：

1. 在用户菜单中切换账号（如有），或退出后登录另一个账号。
2. 控制台会按新账号重新拉取主机列表。
3. 远控页的会话设置（分辨率、码率等）按“账号 + 主机”分别保存，不会串用。

2.8 账号安全建议

• 当前版本未提供账号二次验证，密码请使用密码管理器生成并妥善保管。
• 不要把控制台登录态截图发给他人；截图前先退出或打码。
• 主机端登录的账号 = 能看到该主机的账号，离职/转交设备时记得在主机端退出。
• 发现异常登录，立即改密码并在用户中心检查第三方绑定。

03 控制台（Dashboard）

控制台是登录后的主界面：看主机、连主机、改默认画质、进工具和 Gamespace。地址：

https://z.mycloudgame.com/dashboard.html

未登录也可以打开，但只显示登录/注册入口。

3.1 页面结构

图 3-1 控制台主页。示例账号为管理员，普通账号顶部没有“管理”菜单。

从上到下、从左到右：

1. 顶部导航：主机 / 设置 / 用户 / 工具 / 游戏空间 / 帮助。
2. 右上角：当前账号邮箱、语言切换（EN / 中）、退出。
3. 主机区：每台在线主机一张卡片。
4. 底部：快速连接输入框 + 快速连接按钮；右下角版本号与构建时间。

3.2 主机卡片

每张卡片代表一台登录了同一账号、且在线的主机。

选中卡片：点击卡片空白处会高亮，表示选中；再点一次取消。选中不影响连接。

3.2.1 游戏列表

点 游戏列表 打开弹窗，列出主机端同步上来的游戏。同步规则：

• 主机端 同步游戏列表默认关闭，需要手动开启；
• 仅查询 Steam / Epic 的固定目录，不会做全盘扫描；
• 只识别这两个平台库里的游戏，其它目录/独立游戏不会出现。

列表为空时，优先检查同步开关是否打开、游戏是否在 Steam/Epic 固定目录。

3.2.2 电源菜单

图 3-2 主机卡片 → 电源。

远程执行关机/重启后，主机将离线；除非你配置了 WOL（Wake-on-LAN），否则无法再远程唤醒。

3.2.3 单主机串流设置

图 3-3 主机卡片 → 设置。

点 保存 写入该主机配置；取消 放弃。

3.3 系统设置（全局默认）

导航栏 设置 打开系统设置弹窗：

图 3-4 系统设置。

与单主机设置的区别：

• 顶部多一个 选择主机 下拉，可对任意主机套用设置。
• 底部有 恢复缺省，可一键回到默认值。
• 其余字段与 3.2.3 相同。

建议：先在这里设一套通用值（如 1080p / 20 Mbps / 自动帧率），再对个别游戏主机单独调整。

3.4 快速连接

底部输入框只支持两种输入：

1. 房间号：8 位房间 ID。
2. 完整房间链接：https://z.mycloudgame.com/room.html?room=...。

不支持主机 ID / 主机 UUID。

点 快速连接 后跳到房间页，按匿名房间流程连接。适合把常用房间链接或房间号存在备忘录里，临时换电脑时不用进控制台找主机。

输入框占位文案可能仍显示“粘贴分享链接，或输入主机 ID”，但实际只识别房间号/房间链接，不支持主机 ID。

想连自己的主机，请直接在主机卡片上点 连接。

3.5 工具菜单

图 3-5 工具菜单。

这些页面都在新标签打开，不影响当前会话。

3.6 游戏空间菜单

3.7 帮助与 PWA

• 帮助：跳转官网手册页 https://mycloudgame.com/manual。
• 安装：浏览器支持 PWA 时，导航栏会出现“安装”按钮；安装后从桌面/开始菜单直接打开控制台，体验接近原生应用。
• PWA 的 start_url 是控制台；远控页仍建议在浏览器标签中使用，便于多会话。

3.8 控制台常见状态

04 远程会话（远控页）

远控页是真正的“操作电脑”界面，地址形如：

https://z.mycloudgame.com/remote.html?mode=token&host_id=...&launch_id=...

不需要手动拼 URL——从控制台点 连接、从房间页连接、或从 Gamespace 试玩入口进入即可。

4.1 页面构成

4.2 唤出控制栏

控制栏默认收起，屏幕左中位置有一个 绿色圆形按钮（带箭头）：

1. 鼠标移到屏幕最左侧中部。
2. 点绿色圆钮，控制栏展开。
3. 3 秒无操作会自动收起；鼠标停在控制栏上不会收。
4. 再次点击圆钮可手动收起。

4.3 控制栏按钮

从左到右：

4.3.1 系统菜单

图 4-1 控制栏 → 系统。

关机和重启会直接断开连接；确认没有未保存的工作再执行。

4.3.2 IO 菜单（输入）

4.3.3 音视频菜单

图 4-2 控制栏 → 音视频。

分辨率、码率、帧率是“会话级”设置，修改后立即生效；刷新页面会保留（按主机保存）。

4.3.4 工具菜单

4.3.5 游戏列表

点手柄图标，弹出主机端上报的游戏列表；选择游戏可让主机启动它（需要主机端支持）。列表为空的原因见 3.2.1。

4.4 输入设备

手柄排查顺序

1. 客户端本地测试：在控制台打开 工具 → 手柄测试，确认浏览器能识别手柄、按键/摇杆数值正常。
2. 主机端虚拟手柄：在主机上打开主机端的手柄测试页，确认虚拟手柄已正常加载。
3. 全链路测试：回到远控页，按动客户端手柄，观察主机端虚拟手柄是否同步动作——这一步验证的是“客户端 → 主机端”的完整通路。
4. 非 Xbox 手柄：PS4/PS5、Steam Deck 等浏览器不直接识别，需要在 IO → WebHID 手柄 授权接入；当前仅 Steam Deck 完整适配，其它型号可能部分可用。
5. 蓝牙手柄延迟高时，优先用有线或 2.4G 接收器。

4.5 剪贴板

浏览器首次使用会请求剪贴板权限；拒绝后需要在站点设置里重新允许。部分浏览器只允许在用户手势（点击/按键）后读写。

4.6 全屏与退出

• 点控制栏 全屏 进入全屏。
• 退出全屏：长按 ESC（这是 YiLink 远控页的固定操作）。
• 直接关闭标签页会结束会话；主机端会收到断开事件。
• 会话结束后回到控制台或房间页。

4.7 画质与延迟调优

经验值：

• 1080p60 办公：10–20 Mbps。
• 1080p60 游戏：20–30 Mbps，公网 15–25 Mbps。
• 1440p/4K：50 Mbps 起，需稳定上行。
• 帧率不是越高越好：主机编码器吃力时会反而抖动。

4.8 断线与重连

• 顶部出现“连接已断开，正在自动重连”时，先不要关闭页面。
• 客户端会按退避策略重试；网络恢复后自动恢复画面。
• 若 30 秒以上仍无法恢复：
  1. 检查本地网络；
  2. 回控制台看主机是否仍在线；
  3. 重新点连接；
  4. 仍失败按第 10 章排查 NAT/TURN。

4.9 安全提示

• 远控页 URL 含一次性 token，不要截图外发。
• 在公用电脑上结束会话后关闭标签页，并退出账号。
• 主机端可右键托盘菜单删除房间，或停止共享/关闭服务来中断会话。

05 匿名房间

匿名房间用于“临时把电脑借给别人用”：访客不需要 YiLink 账号，凭一条链接进入，主机端批准一次即可。

5.1 主机端创建房间

方式一：托盘菜单（完全共享）

1. 右键任务栏托盘里的 YiLink 图标。
2. 点 创建匿名共享桌面，直接创建“整个桌面”的房间。

方式二：设置页（可指定应用）

1. 右键托盘图标 → 打开设置页（或手动打开 http://127.0.0.1:<端口>/index.html）。
2. 进入顶部 房间管理 标签。
3. 在 选择应用 / 选择游戏 里选中要共享的窗口或游戏（不选则共享桌面）。
4. 点 创建共享房间。
5. 页面出现房间 ID、有效期、链接、当前应用。

两种共享模式：

• 完全共享：整个桌面，连接后可在控制栏切换显示器。
• 指定应用：只共享选中的进程/游戏窗口。

当前版本的 local_settings 只暴露“创建房间 + 查看房间信息”。删除房间请在右键托盘菜单里操作；本页不提供访客列表、连接日志、强制重连。

5.2 房间信息

创建成功后，主机端会显示：

主机端总览（图 7-1）会同步显示 房间状态（已创建/未创建、连接状态），可点 刷新状态 更新；部分版本提供 加入 按钮用于重新进入房间。

需要让链接立即失效时，右键托盘图标 → 删除房间；也可以停止共享的应用/服务。

5.3 访客连接

访客打开链接后看到：

流程：

1. 访客填附言（可选），点 请求连接。
2. 页面显示“正在等待主机端批准，请稍后…”。
3. 主机端弹出请求，房主点允许。
4. 访客进入远控页。

首次连接需要房主批准；同一设备在同一房间内再次连接会复用缓存的访问码，通常不再重复确认。新建房间后需要重新批准。

5.4 有效期与回收

到期后重新创建房间即可，旧链接不会恢复。

5.5 登录用户与匿名访客的差异

5.6 安全建议

• 只把链接发给可信的人；链接本身就是进入凭证。
• 附言里不要写密码、身份证号等敏感信息。
• 用完立即让房间失效：右键托盘图标 → 删除房间。
• 发现陌生连接请求，直接拒绝，并在主机端确认来源。
• 不要把房间链接发到公开群/论坛。

5.7 常见问题

06 会员与计费

入口：控制台右上角邮箱 → 用户中心 → 会员与账单。

图 6-1 用户中心 → 会员与账单。

6.1 页面分区

6.2 套餐

截图时的价格（以页面实时为准）：

操作：

1. 点对应卡片上的 选择。
2. 进入支付流程（跳转 buy.html → Waffo）。
3. 支付成功后回到控制台，等级即时生效。

升级按差价折算（proration）；降级通常在当前周期结束后生效，具体以支付页说明为准。

付费会员主要面向谁

付费档主要服务 Gamespace 商业场景：游戏开发者、发行商、需要在网页里做试玩/投放的团队。个人远程控制自己的电脑不需要购买主机数量配额。

免费档申请

Gamespace 也提供免费档（dev_free），适合验证/小规模试玩。申请时通常需要提供：

• Steam 商店页面；或
• 产品官网/域名页面。

用于核验游戏/团队的真实性。免费档的配额较低（见 6.6），超出后需要升级。

6.3 CDKEY 兑换

1. 在 CDKEY 兑换 输入框粘贴兑换码（形如 PRM-XXXX-XXXX-XXXX）。
2. 点 兑换。
3. 成功后页面提示到账内容与有效期。

注意事项：

• 兑换码区分大小写，不要带空格。
• 一个码通常只能兑换一次；已使用的码会提示。
• 兑换后会员时长叠加到当前到期时间。
• 企业/批量码由管理员在 cdkey-admin.html 生成。

查询兑换码状态：打开 https://z.mycloudgame.com/cdkey-query.html，输入码后点 查询，可看到是否有效、是否已使用、绑定账号等。

6.4 发票、支付方式与退款

点 发票与支付方式（Waffo 门户）：

• 更新支付方式（卡、PayPal 等，取决于 Waffo 支持范围）。
• 下载历史发票。
• 申请退款（是否符合条件由退款政策决定）。
• 查看订阅状态。

支付页 buy.html 只是跳转中转页，显示“正在准备安全付款环境…”。不要在此页刷新或关闭，否则可能丢失订单上下文。

6.5 账单流水

显示每笔订单的：

• 时间
• 商品/套餐
• 金额与币种
• 支付状态（成功/处理中/失败/退款）
• 订单号（报障时提供）

对账建议每月导出一次，尤其是企业报销。

6.6 会员等级与配额

会员等级不只是“能不能用”，还直接决定 Gamespace 的配额。个人远程控制自己的电脑没有主机数量限额，下表仅适用于 Gamespace 共享场景。当前版本的默认值：

补充规则：

• 有效主机配额 = 基础档 + 未过期的加购（addon）。
• 主机连接 edge 时校验配额；超额会拒绝并提示 host_quota_exceeded。
• 上架游戏数只在“加入游戏库/展柜”时占用，取消上架即释放。
• 配额由运营通过内部 API 调整，页面上的数字以控制台头部为准。

6.7 续费与到期

• 到期前建议提前续费，避免试玩会话中断。
• 到期后：等级回落到免费档，超出配额的主机会无法连接（不会删除数据）。
• 自动续费可在 Waffo 门户关闭。
• 年付通常比月付便宜约 17%。

6.8 常见问题

07 主机端服务与 local_settings

主机端是跑在被控 Windows 电脑上的后台服务，负责采集画面、编码、维持与云端的连接，并在本机开一个只监听 127.0.0.1 的配置页。

关键点：local_settings.html 只能在主机本机打开。在别的电脑上直接访问 https://z.mycloudgame.com/local_settings.html 会一直显示“连接中 → 已断开”，因为它连接的是本机服务，不是云端。

7.1 主机端在做什么

Windows 主机
├── YiLink 主机服务（托盘常驻）
│   ├── 主服务连接（ProServer）── 账号、主机注册、控制面
│   ├── 信令服务连接（signal）── 房间、WebRTC 信令
│   ├── 采集/编码（桌面、窗口、游戏）
│   └── 本地配置页 http://127.0.0.1:<端口>/index.html
├── 匿名房间（可选）
└── Gamespace 接入（可选，连 edge 节点）

服务启动后会自动连接，不需要每次手动登录；断网恢复后自动重连。

7.2 打开配置页

两种方式，任选其一：

1. 托盘菜单（推荐）：右键任务栏托盘里的 YiLink 图标 → 打开设置页。菜单里同时能看到主服务/信令服务的连接状态，以及 创建匿名共享桌面。
2. 手动输入：在主机浏览器打开 http://127.0.0.1:<端口>/index.html。

桌面/开始菜单里的 YiLink 快捷方式不是本地配置页的入口，不要依赖它。

端口由主机服务启动时决定（示例环境为 39210），以服务日志为准。页面支持语言参数：

http://127.0.0.1:39210/index.html?lang=zh-CN

右上角 中文 / English 可随时切换。

7.3 总览（Overview）

图 7-1 主机端 → 总览。

右键托盘图标的菜单里也能直接看到主服务/信令服务是否连接，不必每次打开设置页。

状态解读

• 已连接 / 已连接：正常。
• 主服务已连接，信令断开：能登录但连不上会话；多为 WebSocket 被代理/防火墙拦截。
• 主服务断开：主机不会出现在控制台；检查 DNS、系统时间、代理。
• 房间未创建 - 未连接：正常，说明当前没有匿名房间。

7.4 配置（Config）

图 7-2 主机端 → 配置。

操作：

• 应用配置：提交修改。切换目标服务器会退出当前账号并重启服务，需要重新登录；.cn 与 .com 账号不互通。
• 恢复已加载配置：放弃未保存修改，回到上次加载值。

建议：

• 主机名不要包含个人信息。
• 长期无人值守的机器开启“开机自启”。
• 游戏主机开启“同步游戏列表”，方便控制端快速启动。

7.5 TURN 中继配置

图 7-3 主机端 → TURN 配置。

系统默认会自动使用 mycloudgame.com 的 TURN 中继，P2P 打不通时不需要你手动配置。本页用于配置自己的 TURN，保存后优先于自动中继。

操作顺序：

1. 填地址、端口、用户名、密码。
2. 点 测试连接。
3. 看“测试结果”：
   • 测试成功，发现中继候选 N 个：配置可用。
   • 未发现中继候选：账号/密码/端口/防火墙有问题。
   • 测试超时：UDP 3478 被拦截。
4. 勾选 启用 TURN 中继，点 保存 TURN 配置。

自配 TURN 适合对延迟/稳定性有要求的场景；普通使用保持自动中继即可。

7.6 房间管理（创建共享房间）

图 7-4 主机端 → 房间管理：选择应用/游戏后创建共享房间。

入口在顶部标签栏 房间管理。本页负责“选应用 + 创建房间”，与总览中的“房间状态”联动。

房间信息：

• 房间 ID：8 位。
• 有效期：到期时间。
• 链接：可复制发给访客。
• 当前应用：共享的是桌面还是某个进程。
• 选中项详情：标题、进程名、进程路径。

说明：

• 不选应用时默认共享桌面。
• 当前页面不提供删除房间；删除请右键托盘图标 → 删除房间。本页也不提供访客列表/连接日志。
• 需要让链接立即失效时，停止共享应用/关闭主机服务；房间会在主机连续离线 24 小时后释放。

选择应用/游戏的建议

• 只想让别人看到一个游戏窗口，避免暴露桌面其他内容。
• 游戏全屏/多显示器时，指定进程更稳定。
• 进程列表为空：以管理员权限重启主机服务，或确认进程正在运行。

7.7 Gamespace 接入

图 7-5 主机端 → Gamespace：ID、区域、密码、编码参数与进程列表。

主机端可以直接加入某个 Gamespace，成为试玩主机。入口在顶部 Gamespace 标签。

加入成功后：

• 控制台 ② Hosts 会出现这台主机（在线/健康/区域）。
• 玩家从游戏库点试玩时，edge 会分配到这台主机。
• 主机数量受套餐配额限制（见 6.6）。

“加入密码”是做什么的

加入密码不是你的 YiLink 账号密码，而是某个游戏在 Gamespace 里设置的加入密码：

• 填写正确的加入密码后，即使主机端没有登录该 Gamespace 所属账号，也能成为这个游戏的候选主机。
• 不填密码时，主机只能加入同一账号创建的 Gamespace 里的游戏。
• 密码错误/为空且账号不匹配时，加入会失败。

退出/暂停前先确认没有正在进行的试玩会话。

7.8 版本、日志与升级

• 版本信息：总览底部，格式 0.9.29 / 2026-10-31 18:19:24。
• 日志：安装目录下 log/（如 C:\Users\<用户>\AppData\Roaming\YiLink\log）。
• 升级：运行安装包/自动更新；升级后重启服务，确认版本号变化。
• 卸载：先退出账号，再卸载；残留配置在 AppData\Roaming\YiLink。

7.9 安全与运维建议

• 本地配置页只监听 127.0.0.1，不要把端口映射到公网。
• 不要把 host_config.json、public_key.pem、日志外发。
• 主机服务账号建议使用专用账号，不要与个人主账号混用。
• 无人值守主机开启自动登录需谨慎；锁屏不影响远控，但休眠会断连。
• 定期检查：主服务/信令状态、版本、磁盘空间、GPU 驱动。

08 Gamespace 玩家侧

Gamespace 是 YiLink 的游戏宣发/试玩能力：开发者上架游戏，玩家在浏览器里直接试玩，不需要安装。

8.1 页面地图

域名以当前环境为准（.com / .cn）；玩家入口可能按区域 302 跳到对应 edge 域名。

Gamespace 试玩只共享指定的游戏/应用，不是整个桌面；这也是它与匿名房间“完全共享”的最大区别。

8.2 游戏库

图 8-1 游戏库。

卡片状态逻辑：

• 有可用主机：显示“立即试玩”，点击进入试玩。
• 暂无主机但有跳转目标：显示“了解更多”，点击跳商店/官网。
• 都没有：按钮置灰，显示“当前暂不可试玩”。

8.3 游戏详情

图 8-2 游戏详情页。

操作：

• 点右下/浮动的试玩按钮进入试玩。
• 点 ← 返回游戏库 回到列表。
• 点 前往 Steam 商店 打开 Steam 页面。

8.4 试玩流程

1. 从游戏库/详情/活动链接进入试玩页。
2. 页面依次显示：
   • 正在准备试玩连接
   • 正在连接服务器
   • 已连接到服务器
   • 正在建立画面连接
   • 试玩已就绪（画面出现）
3. 试玩时长由活动配置（常见 300 秒），页面可能有倒计时。
4. 结束时显示 试玩已结束：
   • 前往详情：跳活动配置的目标页（商店/官网）。
   • 停留当前页：关闭提示，留在当前页。

试玩状态对照

无主机时的行为

• 如果活动配置了跳转目标：自动/静默跳转到目标页，不打断广告转化。
• 如果没有跳转目标：留在试玩页并提示。
• 未知活动 token：404。

8.5 开发者空间（厂商页）

图 8-3 开发者空间列表。

• 列表显示厂商名称、游戏数量、进入 按钮。
• 进入后是该厂商的游戏卡片，布局与游戏库一致。

访问密码

部分厂商给游戏设置了 web 访问密码：

图 8-4 厂商页（示例已解锁）。

1. 点带锁的游戏，弹出密码框。
2. 输入密码，点 解锁。
3. 解锁后当前浏览器可访问该游戏；关闭浏览器后失效（服务端 24 小时兜底）。

密码由开发者在 Gamespace 控制台设置；忘记密码需要联系开发者。

8.6 平台限制

开发者可以限制游戏只在某些平台展示/试玩：

不满足平台限制时，试玩入口会被拒绝。遇到“当前设备不支持”，换对应设备或联系开发者。

8.7 延迟测试

打开 https://gs.mycloudgame.com/play/latency：

• 对每个 edge 节点做 STUN 绑定 + HTTPS 健康检查。
• 显示最近节点、各节点往返延迟、目标阈值。
• 数据只在浏览器本地计算，不上传。

用途：判断应该从哪个区域进入试玩；VPN/代理会显著影响结果。

8.8 玩家常见问题

09 Gamespace 控制台

Gamespace 控制台面向游戏开发者/租户，管理游戏、主机、活动、试玩数据和边缘节点。

入口：

• 控制台导航 游戏空间 → Gamespace 控制台
• 或直接打开 https://z.mycloudgame.com/admin-ops/customer

需要 SSO 登录；账号等级决定配额。

9.1 控制台头部

图 9-1 Gamespace 控制台（① 游戏）。

9.2 ① 游戏（Games）

列表

点任意行进入 游戏详情。

创建游戏

点右上 创建，填写表单：

提交后：

• 自动创建默认推广活动（名称“默认”，不可删除）。
• Steam 游戏会异步拉取元数据（封面、描述、截图、视频）。

游戏详情

图 9-2 游戏详情。

注意：

• Game 绑定后不可改；要换游戏请新建活动。
• 默认活动不能删除；可以切换 active/inactive。
• 修改显示名称/来源/渠道不影响已有链接的归因。

9.3 ② 主机（Hosts）

图 9-3 主机列表。

使用建议：

• 区域筛选（右上）用于多 edge 场景。
• 主机长期 OFFLINE：检查主机端服务、Gamespace 是否暂停、配额是否超限。
• 删除绑定只解除 Gamespace 关联，不卸载主机端。

9.4 ③ Campaign（活动）

图 9-4 活动列表。

操作说明：

• 打开：新窗口打开活动链接（/go/{token}）。
• 复制链接：复制到剪贴板，用于投放。
• 统计：查看转化漏斗（resolved → allocated → host_ready → web_connected → completed → cta_clicked）、时长分布、失败数、按区域。
• 展开：查看 token、完整 URL、QR。
• 删除：不可恢复；默认活动禁止删除。

新建 Campaign

9.5 ④ 试玩记录（Sessions）

图 9-5 试玩会话。

右上筛选：

• 活动：全部 / 指定活动
• 结果：全部 / 成功 / 失败 / 跳转

用途：核对投放效果、定位失败集中在哪个区域/活动。

9.6 ⑤ 边缘节点（Edges）

图 9-6 边缘节点。

每个节点卡片显示：

节点离线通常意味着 edge 进程异常或网络中断；需要运维介入。

9.7 配额与限制

以下配额只影响 Gamespace；个人远控主机不受此限制。

配额值见 06 会员与计费。

9.8 常用 SOP

SOP 1：上线一款新游戏

1. ① 游戏 → 创建，填显示名、匹配方式、AppID/进程名。
2. 上传封面，勾选 上架游戏库（注意上架配额）。
3. 如需详情页，勾选 生成详情页 并等待 Steam 元数据。
4. 主机端加入 Gamespace，确认 ② 主机 出现且在线。
5. ③ Campaign 创建投放活动，复制 /go/{token}。
6. 用无痕窗口打开链接，完整走一遍试玩。
7. 确认 ④ 试玩记录 有数据、⑤ 边缘节点 正常。

SOP 2：临时下线一个游戏

• 取消 上架游戏库（释放上架配额）。
• 或把活动状态改为 inactive（已投放链接会跳转目标页）。
• 不建议直接删除游戏（会连带活动/数据）。

SOP 3：排查“玩家说玩不了”

1. ④ 试玩记录：看失败/跳转比例与区域。
2. ② 主机：目标游戏是否有在线主机。
3. ③ Campaign：状态是否 active、链接是否最新。
4. ⑤ Edges：对应区域是否在线。
5. 主机端：Gamespace 是否暂停、配额是否超限。

9.9 控制台使用注意

• 控制台没有独立保存按钮的地方（如显示名称）是失焦自动保存。
• 删除类操作不可恢复，先导出配置（游戏详情 → 导出设置为 JSON）。
• 动态内容较多，改完配置后刷新一次页面确认。
• 浏览器建议用 Chrome/Edge，避免拦截第三方 cookie 影响登录态。

10 故障排查

排查顺序建议：先看状态，再看网络，再看配置，最后看日志。不要一上来就重装。

10.1 一分钟定位

10.2 主机不显示在控制台

按顺序检查：

1. 账号一致：主机端“当前登录用户” = 控制台账号。
2. 集群一致：主机端目标服务器（中国/国际）与账号所在站点一致。
3. 主服务状态：主机端总览显示“主服务连接状态：已连接”。
4. 如果是 Gamespace 主机：检查 Gamespace 主机配额是否已满（6.6）。个人远程控制没有主机数量限额。
5. 系统时间：偏差超过几分钟会导致 TLS/JWT 失败。
6. 代理/VPN：关闭或把 *.mycloudgame.com 加入直连。
7. 防火墙：允许主机服务出站 443/WSS。

主机端修复后，回控制台刷新页面。

10.3 连接失败 / 一直转圈

10.3.1 看提示

10.3.2 检查 NAT

• 控制台主机卡片底部显示 NAT 类型。
• 对称 NAT 不必手动开 TURN：系统默认会自动使用 mycloudgame.com 的 TURN 中继，但延迟受中继位置与容量影响。
• 如果自动中继延迟高/不稳定，可在主机端配置自己的 TURN（优先使用）。

10.3.3 自配 TURN

• 默认已经自动走 mycloudgame.com 的中继，不需要手动开。
• 想用自己的 TURN：主机端 → TURN 配置 → 测试连接 → 启用并保存（自配优先）。
• 或在远控页 工具 → TURN 配置 临时指定。
• 仍失败：确认 TURN 端口（3478/UDP、TLS 5349）没有被防火墙拦截。

10.3.4 看连接信息

远控页 工具 → 连接信息：

• candidate-pair 是否是 relay（中继）。
• RTT、可用上行/下行码率、丢包。
• 帧率是否持续为 0（编码/采集卡住）。

10.4 黑屏 / 花屏 / 卡顿

主机端建议：

• 游戏用“无边框窗口”而不是独占全屏。
• 关闭游戏内垂直同步可降低延迟。
• 编码器过载时优先降分辨率，而不是只降码率。

10.5 键鼠 / 手柄

10.6 匿名房间

10.7 Gamespace 试玩

10.8 账号 / 会员 / CDKey

10.9 主机端服务

10.10 收集诊断信息

报障时附上：

1. 控制台右下角 版本号 + 构建时间。
2. 主机端 版本信息（如 0.9.29 / 2026-10-31 18:19:24）。
3. 出现问题的页面 URL（去掉 token）。
4. 远控页 工具 → 连接信息 截图（RTT、候选类型、码率）。
5. 主机端 log/ 最近 10 分钟日志。
6. 网络检测结果（NAT 类型）。
7. 复现步骤：什么时间、哪台主机、从哪个网络、做了什么操作。

日志里可能含账号/主机信息，发送前先脱敏。

10.11 不要做的事

• 不要在生产环境反复重启/关机主机来“试试看”。
• 不要把本地配置页端口映射到公网。
• 不要用来源不明的 TURN 服务器。
• 不要在未备份的情况下删除 Gamespace 游戏/活动。
• 不要把带 token 的 URL 发到公开渠道。

11 附录

11.1 术语表（中 / 英）

11.2 页面索引

11.3 控制栏速查

11.4 主机端字段速查

11.5 截图清单

说明：

• 截图中的邮箱、用户 ID、公网 IP、主机 UUID 已打码（黑色/马赛克块，不是界面元素）。
• 远控页截图只保留了控制栏，未包含主机桌面内容。
• 主机端五个面板（总览/配置/TURN/房间/Gamespace）均为真实界面截图。

11.6 版本记录

11.7 翻译说明（英文版预留）

• 文件编号与文件名保持不变，英文版可并列放在 en/ 下。
• 标题层级、表格列顺序、图片编号保持一一对应。
• 术语首次出现时使用“中文（English）”，之后统一用中文。
• 界面按钮文字用 加粗 标注，英文版替换为对应 UI 文案。
• 截图需按语言重新截取，编号不变。