切换root用户

网页终端默认登入的账户为 kvmd-webterm，处于安全考虑此用户无法使用 sudo 命令，如需执行需要root权限的命令请先执行 su root 切换到 root 账户。
命令如下：su root 密码：1234

图标

如果有替换 Logo 或其他图标的需要可以替换 /usr/share/kvmd/web/share/（对于源代码路径是 /web/share/ ）目录下的文件，如此目录下 svg/logo.svg 是应用 Logo。

颜色主题

如果有定制网页界面主题的需要，可以编辑 /usr/share/kvmd/web/share/css/user.css 修改网页放入 CSS 颜色主题来实现想要的配色。
以下是一些配色示例，可以根据实际需求自行修改。

浅白

:root {
    /* 主页面 */
    --cs-page-default-bg: #ffffff;
    --cs-page-default-fg: #1e293b;
    --cs-page-obscure-fg: #64748b;

    /* 控件 */
    --cs-control-default-bg: #f1f5f9;
    --cs-control-default-fg: #0f172a;
    --cs-control-intensive-fg: #ffffff;
    --cs-control-hovered-bg: #e2e8f0;
    --cs-control-hovered-fg: #0f172a;
    --cs-control-pressed-bg: #cbd5e1;
    --cs-control-pressed-fg: #0f172a;
    --cs-control-disabled-fg: #94a3b8;
    /* 导航栏 */
    --cs-navbar-default-bg: #e2e8f0;
    --cs-navbar-default-fg: #0f172a;
    --cs-navbar-item-hovered-bg: #cbd5e1;
    --cs-navbar-item-pressed-bg: #94a3b8;

    /* 窗口 */
    --cs-window-default-bg: #f8fafc;
    --cs-window-default-fg: #0f172a;
    --cs-window-header-default-fg: #0f172a;
    --cs-window-header-grabbed-bg: #2563eb;
    --cs-window-header-grabbed-fg: #ffffff;
    --cs-window-closer-default-fg: #64748b;
    /* 代码区域 */
    --cs-code-default-bg: #f1f5f9;
    --cs-code-default-fg: #0f172a;
    --cs-code-comment-fg: #475569;

    /* 滚动条 */
    --cs-scroll-default-bg: #cbd5e1;
    --cs-thumb-default-bg: #2563eb;
    --cs-thumb-disabled-bg: #94a3b8;

    /* 进度条 */
    --cs-progress-default-bg: #e2e8f0;
    --cs-progress-default-fg: #0f172a;
    --cs-progress-bar-bg: #2563eb;

    /* 按键 */
    --cs-key-default-bg: #f1f5f9;
    --cs-key-default-fg: #0f172a;
    --cs-key-hovered-bg: #cbd5e1;
    --cs-key-hovered-fg: #0f172a;
    --cs-key-pressed-bg: #94a3b8;
    --cs-key-pressed-fg: #1e293b;
    --cs-key-holded-bg: #3b82f6;
    /* 装饰元素 */
    --cs-marker-fg: #0f172a;
    --cs-corner-bg: #2563eb;

    /* 阴影效果 */
    --shadow-micro: 01px 2px rgba(0, 0, 0, 0.06);
    --shadow-small: 02px 4px rgba(0, 0, 0, 0.1);
    --shadow-big: 06px 12px rgba(15, 23, 42, 0.12);
    --shadow-navbar-item-pressed: 0 2px 0#2563eb inset;
    --shadow-window-fullscreen-active: 00 0 2px #2563ebinset;

    /* 边框 */
    --border-default-thin: thin solid #cbd5e1;
    --border-default-2px: 2px solid #cbd5e1;
    --border-hovered-2px: 2px solid #2563eb;
    --border-navbar-item-thin: thin solid #94a3b8;
    --border-control-thin: thinsolid #cbd5e1;
    --border-key-thin: thin solid #cbd5e1;
}

深黑

:root {
    --cs-page-default-bg: #36393f;
    --cs-page-default-fg: #c3c3c3;
    --cs-page-obscure-fg: #6c7481;

    --cs-control-default-bg: #36393f;
    --cs-control-default-fg: #c3c3c3;
    --cs-control-intensive-fg: white;
    --cs-control-hovered-bg: #2a2d31;
    --cs-control-hovered-fg: white;
    --cs-control-pressed-bg: #17191d;
    --cs-control-pressed-fg: #6c7481;
    --cs-control-disabled-fg: #6c7481;

    --cs-navbar-default-bg: #202225;
    --cs-navbar-default-fg: #c3c3c3;
    --cs-navbar-item-hovered-bg: #1a1c1f;
    --cs-navbar-item-pressed-bg: #171717;

    --cs-window-default-bg: #484b51;
    --cs-window-default-fg: #c3c3c3;
    --cs-window-header-default-fg: #aaaaaa;
    --cs-window-header-grabbed-bg: #436a8a;
    --cs-window-header-grabbed-fg: white;
    --cs-window-closer-default-fg: #6c7481;

    --cs-code-default-bg: #17191d;
    --cs-code-default-fg: #aaaaaa;
    --cs-code-comment-fg: #6c7481;

    --cs-scroll-default-bg: #6c7481;
    --cs-thumb-default-bg: #436a8a;
    --cs-thumb-disabled-bg: #202225;

    --cs-progress-default-bg: #171717;
    --cs-progress-default-fg: white;
    --cs-progress-bar-bg: #436a8a;

    --cs-key-default-bg: #3b3e43;
    --cs-key-default-fg: #c3c3c3;
    --cs-key-hovered-bg: #2a2d31;
    --cs-key-hovered-fg: white;
    --cs-key-pressed-bg: #17191d;
    --cs-key-pressed-fg: #6c7481;
    --cs-key-holded-bg: #436a8a;

    --cs-marker-fg: #5b90bb;
    --cs-corner-bg: #5b90bb;

    --shadow-micro: 1px 2px 4px 0 rgba(0, 0, 0, 0.4);
    --shadow-small: 0 2px 4px 0 rgba(0, 0, 0, 0.2);
    --shadow-big: 0 8px 16px 0 rgba(0, 0, 0, 0.4);
    --shadow-navbar-item-pressed: 0 5px 0 #5b90bb inset;
    --shadow-window-fullscreen-active: 0 0 0 2px #5b90bb inset;

    --border-default-thin: thin solid #36393f;
    --border-default-2px: 2px solid #36393f;
    --border-hovered-2px: 2px solid #2a2d31;
    --border-navbar-item-thin: thin solid black;
    --border-control-thin: thin solid #17191d;
    --border-key-thin: thin solid #202225;
    --border-intensive-2px: 2px solid #5b90bb;
    --border-intensive-thin: thin solid #5b90bb;

    --border-window-default-2px: 2px solid #282a2e;
    --border-window-active-2px: 2px solid #5b90bb;
    --border-window-default-thin: thin solid #17191d;

    --border-navbar-menu-default-2px: 2px solid black;
    --border-navbar-menu-active-2px: 2px solid #5b90bb;
    --border-menu-item-content-top-thin: thin solid #17191d;
}

默认（深灰）

:root {
    --cs-page-default-bg: #36393f;
    --cs-page-default-fg: #c3c3c3;
    --cs-page-obscure-fg: #6c7481;

    --cs-control-default-bg: #36393f;
    --cs-control-default-fg: #c3c3c3;
    --cs-control-intensive-fg: white;
    --cs-control-hovered-bg: #2a2d31;
    --cs-control-hovered-fg: white;
    --cs-control-pressed-bg: #17191d;
    --cs-control-pressed-fg: #6c7481;
    --cs-control-disabled-fg: #6c7481;

    --cs-navbar-default-bg: #202225;
    --cs-navbar-default-fg: #c3c3c3;
    --cs-navbar-item-hovered-bg: #1a1c1f;
    --cs-navbar-item-pressed-bg: #171717;

    --cs-window-default-bg: #484b51;
    --cs-window-default-fg: #c3c3c3;
    --cs-window-header-default-fg: #aaaaaa;
    --cs-window-header-grabbed-bg: #436a8a;
    --cs-window-header-grabbed-fg: white;
    --cs-window-closer-default-fg: #6c7481;

    --cs-code-default-bg: #17191d;
    --cs-code-default-fg: #aaaaaa;
    --cs-code-comment-fg: #6c7481;

    --cs-scroll-default-bg: #6c7481;
    --cs-thumb-default-bg: #436a8a;
    --cs-thumb-disabled-bg: #202225;

    --cs-progress-default-bg: #171717;
    --cs-progress-default-fg: white;
    --cs-progress-bar-bg: #436a8a;

    --cs-key-default-bg: #3b3e43;
    --cs-key-default-fg: #c3c3c3;
    --cs-key-hovered-bg: #2a2d31;
    --cs-key-hovered-fg: white;
    --cs-key-pressed-bg: #17191d;
    --cs-key-pressed-fg: #6c7481;
    --cs-key-holded-bg: #436a8a;

    --cs-marker-fg: #5b90bb;
    --cs-corner-bg: #5b90bb;

    --shadow-micro: 1px 2px 4px 0 rgba(0, 0, 0, 0.4);
    --shadow-small: 0 2px 4px 0 rgba(0, 0, 0, 0.2);
    --shadow-big: 0 8px 16px 0 rgba(0, 0, 0, 0.4);
    --shadow-navbar-item-pressed: 0 5px 0 #5b90bb inset;
    --shadow-window-fullscreen-active: 0 0 0 2px #5b90bb inset;

    --border-default-thin: thin solid #36393f;
    --border-default-2px: 2px solid #36393f;
    --border-hovered-2px: 2px solid #2a2d31;
    --border-navbar-item-thin: thin solid black;
    --border-control-thin: thin solid #17191d;
    --border-key-thin: thin solid #202225;
    --border-intensive-2px: 2px solid #5b90bb;
    --border-intensive-thin: thin solid #5b90bb;

    --border-window-default-2px: 2px solid #282a2e;
    --border-window-active-2px: 2px solid #5b90bb;
    --border-window-default-thin: thin solid #17191d;

    --border-navbar-menu-default-2px: 2px solid black;
    --border-navbar-menu-active-2px: 2px solid #5b90bb;
    --border-menu-item-content-top-thin: thin solid #17191d;
}

选中普通文件模式

选择要上传到被控主机的文件上传

上传完成

把上传的文件打包成镜像

根据文件大小等待10几秒到几分钟等待文件打包成功

把打包好的镜像挂载到被控主机

复制文件到被控主机

从被控主机下载文件到控制主机

选中NormaIFiles.img镜像连接到被控主机

把被控主机上需要下载的文件复制到挂载的U盘里面

然后断开跟被控主机的连接，选择镜像NormaIFiles.img 从镜像文件解压文件 根据文件大小不同等待10几秒到几分钟

等待镜像文件解压后回到普通文件模式下查看文件列表

在文件列表里面即可查看到需要下载的文件

选中文件点击下载

🚀 快速开始（5分钟上手）

新手用户建议按以下步骤进行：

步骤1：确认设备连接

✅ PPtech盒子已通过HDMI线连接被控电脑
✅ PPtech盒子已通过USB线连接被控电脑
✅ PPtech盒子已连接网络（网线）
✅ 被控电脑开机正常

步骤2：局域网测试

1. 在同一网络下，打开浏览器
2. 输入PPtech盒子的IP地址（通常是 192.168.x.x）
3. 如果能看到被控电脑桌面，说明设备工作正常

步骤3：选择外网方案

• 新手推荐：异地组网（Tailscale）→ 免费且简单
• 有公网IP：公网映射 → 速度最快
• 临时使用：跳板机 → 立即可用

步骤4：实施方案

根据选择的方案，跳转到对应章节查看详细教程

📚 什么是外网控制？

外网控制就是让您在家里的时候能够操作公司的电脑，或者在外出差时能够控制家里的电脑。简单来说，就是"不在电脑身边也能操作电脑"。

🔧 系统工作原理（新手必读）

想象一下，您要远程控制一台电脑，就需要三个角色：

• 被控电脑：您要控制的那台电脑（比如公司的工作电脑）
• PPtech盒子：一个小设备，像翻译官一样帮您传递信号
• 控制端：您现在使用的电脑或手机

📡 信号传递过程（简单理解）

第一步：收集信号

• PPtech盒子通过HDMI线连接被控电脑，获取屏幕画面
• 通过USB线连接被控电脑，传递键盘鼠标操作

💡 小白提示：就像您在家看电视，HDMI线传输画面，USB线让您能"遥控"电脑

第二步：信号处理

• PPtech盒子把获取的画面和操作指令进行"翻译"处理
• 然后通过网络发送到互联网上

💡 重要：PPtech盒子必须连接网络

第三步：远程操作

• 您在任何地方打开浏览器
• 输入特定地址，就能看到被控电脑的屏幕
• 您的鼠标键盘操作会实时传送过去

🏠 局域网模式 vs 外网模式

局域网模式：在同一个局域网下直接控制，速度快，延迟低
外网模式：通过互联网控制，可以在世界任何地方操作

✅ 网络要求总结

🚀 外网控制方案选择

要实现外网控制，我们提供4种方案，每种都有不同的适用场景：

📊 方案对比表

🎯 新手推荐方案

💡 强烈推荐：异地组网方案

为什么推荐这个方案？

• ✅ 完全免费：不需要花钱购买服务
• ✅ 操作简单：按步骤操作，15分钟搞定
• ✅ 速度最快：点对点连接，延迟最低
• ✅ 最安全：数据加密传输
• ✅ 支持多设备：最多20个设备免费组网

推荐工具：Tailscale （新手友好）

📋 详细方案说明

🌟 方案一：异地组网（推荐新手）

什么是异地组网？
就像把不同地方的设备"虚拟"连接在同一个网络里，让它们以为在同一个房间。

优点：

• 🆓 完全免费
• 🚀 速度最快
• 🔒 安全性最高
• 🎯 操作简单

推荐工具：

• Tailscale：最适合新手，界面友好
• ZeroTier：功能强大，稍微复杂一点

适合场景：

• 个人用户日常使用
• 小型团队内部使用
• 对安全性要求高的场景

🌐 方案二：公网映射

什么是公网映射？
如果您的网络有公网IP（就像有固定门牌号），可以直接把这个"门牌号"告诉外面的人。

如何判断是否有公网IP？

1. 联系您的网络服务商（电信/联通/移动）询问
2. 或者查看路由器获取的IP是否与网上查询的IP一致

操作步骤：

1. 在路由器中设置端口映射
2. 将PPtech盒子的内网IP和443端口映射到公网
3. 外网通过 公网IP:端口 访问

优点：

• ⚡ 速度极快
• 🎯 配置简单（如果有公网IP）
• 💪 稳定性极高

缺点：

• 💰 可能需要额外费用申请公网IP
• 🏠 大部分家庭用户没有公网IP

🔄 方案三：内网穿透

什么是内网穿透？
通过第三方服务器做"中介"，让外网能访问到内网设备。

推荐工具：FRP

操作步骤：

1. 租用一台有公网IP的服务器
2. 在服务器上部署FRP服务端
3. 在PPtech盒子上配置FRP客户端
4. 通过服务器IP访问PPtech盒子

优点：

• 🔧 灵活性高
• 🎛️ 可自定义配置

缺点：

• 💰 需要租用服务器
• ⚙️ 配置相对复杂
• 🐌 速度受服务器带宽限制

🖥️ 方案四：跳板机

什么是跳板机？
通过现有的远程控制软件（如向日葵、ToDesk）先连接到一台中间电脑，再通过这台电脑访问PPtech盒子。

操作步骤：

1. 在PPtech盒子所在网络的任意一台电脑上安装向日葵/ToDesk
2. 远程连接到这台"跳板"电脑
3. 在跳板电脑的浏览器中访问PPtech盒子

优点：

• 🚀 快速部署
• 📱 支持手机APP
• 🎯 适合临时使用

缺点：

• 💰 商业版需要付费
• 🐌 双重转发，速度较慢
• 📱 手机操作体验不如直接连接

适合场景：

• 临时应急使用
• 不想配置复杂网络的用户

🤔 如何选择适合的方案？

新手用户

推荐：异地组网（Tailscale）

• 按照我们的详细教程，15分钟搞定
• 免费且稳定

有技术基础的用户

推荐：公网映射 > 内网穿透

• 如果有公网IP，选择公网映射
• 否则选择内网穿透

临时使用

推荐：跳板机

• 快速部署，立即可用

❓ 常见问题

Q: 我不知道自己适合哪种方案？
A: 建议从异地组网开始尝试，免费且容易上手。

Q: 设置失败了怎么办？
A: 每种方案我们都有详细的图文教程，遇到问题可以查看对应教程。

Q: 哪种方案最安全？
A: 异地组网的安全性最高，数据端到端加密。

Q: 可以同时使用多种方案吗？
A: 可以，但建议选择一种主要方案，避免配置冲突。

🤔 什么是Tailscale？

简单理解： Tailscale 就像一个"魔法桥梁"，能让您在家里的电脑和公司的PPtech盒子"以为"它们在同一个房间里，即使它们相隔千里。

✨ 核心特点

• 🆓 完全免费 - 个人用户最多20台设备
• 🔒 军用级加密 - 使用WireGuard协议端到端加密
• 🚀 点对点连接 - 直连速度，延迟最低
• 🌍 全球可用 - 支持所有主流平台
• 🛠️ 配置简单 - 无需复杂网络知识

🆚 与其他方案对比

🏠 工作原理

📊 工作流程图解（三步走）

📋 第一步：物理连接（公司端）

• 📺 视频采集: PPtech盒子的 USB1口 连接被控电脑的 HDMI输出口
  • 💡 作用：实时获取电脑屏幕画面
• 🖱️ 控制模拟: PPtech盒子的 USB2口 连接被控电脑的 USB口
  • 💡 作用：模拟虚拟键盘鼠标，实现硬件级控制
• 🌐 网络接入: PPtech盒子通过网线连接互联网

📋 第二步：虚拟组网（通过互联网）

• 🔗 同步登录: PPtech盒子和家庭控制电脑上的 Tailscale 客户端同时登录同一账户
• 🔒 建立隧道: 两者通过互联网建立加密的 P2P VPN 隧道
• 🏠 组成虚拟局域网: 形成安全的虚拟局域网，家庭电脑可直接访问PPtech盒子的虚拟IP地址（如 100.x.x.x）

📋 第三步：远程控制流程（核心工作流）

1. 📤 指令下发

   • 您在家中的控制电脑上访问PPtech盒子的虚拟IP（Web管理界面）
   • 您的操作（点击、打字）通过 Tailscale隧道 发送给公司的PPtech盒子

2. 🎨 本地执行

   • PPtech盒子收到指令后，通过 USB连接 将指令模拟为真实的键盘鼠标信号
   • 发送给被控电脑执行，就像直接在物理上操作那台电脑

3. 📺 画面抓取

   • PPtech盒子通过 HDMI连接 实时抓取被控电脑的屏幕画面

4. 🔄 画面回传

   • 抓取的屏幕画面经过编码后，通过 Tailscale隧道 传回您家中控制电脑的Web界面显示

🎆 最终效果

这样就完成了一个完整的"下发指令 → 执行 → 返回屏幕"的实时控制循环。您在家中的感觉就像是直接坐在了公司的电脑前一样。

⚡ 快速配置向导（10分钟完成）

📋 配置清单

准备工作：

• ✅ PPtech盒子已正常连接并能访问管理界面
• ✅ 控制电脑能正常上网
• ✅ 准备一个邮箱账号（推荐使用微软邮箱）

配置步骤概览：
🟢 步骤1: 在PPtech盒子上安装Tailscale（约5分钟）
🟢 步骤2: 在控制电脑上安装Tailscale（约3分钟）
🟢 步骤3: 登录同一账户进行组网（约2分钟）
🟢 步骤4: 测试连接和使用（约1分钟）

总耗时：约10-15分钟

💡 新手提示: 如果遇到问题，可以直接跳转到常见问题章节查找解决方案。

📱 PPtech盒子配置

🔧 步骤1：进入终端界面

1. 登录PPtech管理界面

   • 在浏览器中输入PPtech盒子的IP地址
   • 使用用户名和密码登录管理界面

2. 进入终端

   • 在管理界面中找到 Terminal（终端）选项
   • 点击进入网页终端界面

🔑 步骤2：切换到管理员权限

su root

输入默认密码： 1234

💡 新手提示: 输入密码时屏幕不会显示任何字符，这是正常的安全保护。直接输入 1234 然后按回车即可。

📦 步骤3：安装Tailscale

复制粘贴以下命令并执行：

curl -fsSL https://tailscale.com/install.sh | sh

⏰ 安装时间: 整个安装过程约5-10分钟，请耐心等待

✅ 安装成功标志: 看到以下提示表示安装完成：

Installation complete! Log in to start using Tailscale by running:

tailscale up

🚀 步骤4：启动Tailscale服务

输入以下命令启动服务：

tailscale up --accept-dns=false

🌐 重要操作:

• 命令执行后会显示一个网址链接
• 用鼠标点击该网址会自动跳转到Tailscale登录页面

📧 步骤5：登录账户完成绑定

登录选项：

1. 微软账号登录（推荐）

   • 输入您的微软邮箱和密码
   • 授权登录即可

2. Tailscale账号登录

   • 如果没有微软邮箱，可以注册Tailscale账号

✅ 绑定成功: 登录后Tailscale会自动给盒子分配一个虚拟组网IP地址

⚠️ 重要设置：取消6个月过期限制

⚠️ 重要提醒:

Tailscale设备绑定默认6个月有效期，到期需重新绑定。

避免重复操作的方法：

1. 在设备列表中找到您的PPtech盒子
2. 点击设备后方的 3个小点 ⋯
3. 选择 "disable key expiry"
4. 这样就永久解除了授权过期限制

💻 控制电脑配置

📥 步骤1：下载Tailscale客户端

官方下载地址: https://tailscale.com/download/windows

🌍 支持平台: Windows、macOS、Android、iOS等所有主流平台

🇨🇳 国内用户加速下载链接

为方便国内用户，PPtech提供以下离线安装包：

• Windows: tailscale-setup-full-1.86.2.exe
• macOS: Tailscale-1.86.4-macos.pkg
• Android: tailscale-android-universal-1.86.4.apk

🖥️ Windows平台安装步骤

1. 下载安装程序

   • 下载完成后双击运行安装程序

2. 开始安装
   

   • ✅ 勾选"同意许可协议"
   • 点击 Install 开始安装

⏰ 安装时间: 约2分钟完成安装

🔐 步骤2：登录Tailscale账户

启动客户端:

• 安装完成后会自动启动Tailscale客户端
• 系统托盘区域会出现Tailscale图标

登录方式:

两种登录方式任选其一：

1. 点击软件界面的 "Sign in to your network"
2. 右键点击托盘区的Tailscale图标

关键要求: ⚠️ 必须登录与PPtech盒子相同的账号

✅ 步骤3：确认连接

点击 "确认连接"

登录成功!

🎉 步骤4：验证组网成功

✅ 成功标志:

• 可以看到本地控制电脑和PPtech盒子都已成功组建虚拟局域网
• 系统自动分配了虚拟组网IP地址
• 两台设备现在处于同一个"虚拟房间"中

🔧 连接测试

🌐 访问PPtech盒子管理界面

1. 获取虚拟IP地址

   • 在Tailscale客户端中查看PPtech盒子的虚拟IP地址
   • 通常格式为 100.x.x.x

2. 浏览器访问

   • 打开任意浏览器
   • 在地址栏输入PPtech盒子的虚拟IP地址
   • 例如：http://100.64.0.1

🎊 成功访问!

✅ 测试成功标志:

• 能够正常打开PPtech管理界面
• 可以看到被控电脑的实时屏幕
• 鼠标键盘操作响应正常

🎉 恭喜！您已成功配置Tailscale异地组网！

❓ 常见问题

🔧 安装相关问题

Q: 安装Tailscale时提示网络错误怎么办？

A: 尝试以下解决方案：

1. 检查网络连接是否正常
2. 使用PPtech提供的离线安装包
3. 稍后重试，可能是网络临时问题

Q: 输入root密码时看不到字符正常吗？

A: 完全正常。这是Linux系统的安全设计，输入密码时不会显示任何字符，直接输入 1234 然后回车即可。

🔗 连接相关问题

Q: 登录成功但看不到其他设备怎么办？

A: 检查以下几点：

1. 确认两台设备登录的是同一个账号
2. 稍等1-2分钟，有时需要时间同步
3. 尝试重启Tailscale客户端

Q: 可以看到设备但无法访问怎么办？

A: 排查步骤：

1. 检查虚拟IP地址是否正确
2. 尝试ping命令测试连通性
3. 确认防火墙设置没有阻止连接

🌐 网络相关问题

Q: 访问速度很慢怎么办？

A: 优化建议：

1. 检查两端网络质量
2. 尝试重新连接Tailscale
3. 考虑网络高峰期影响

Q: 连接时断时续怎么办？

A: 解决方案：

1. 检查网络稳定性
2. 更新Tailscale到最新版本
3. 重新登录账户

🔐 账户相关问题

Q: 忘记了Tailscale账户密码怎么办？

A: 解决步骤：

1. 在登录页面点击"忘记密码"
2. 通过邮箱重置密码
3. 或者直接使用微软账号登录

Q: 想要更换登录账号怎么办？

A: 操作步骤：

1. 在两端都注销当前账号
2. 重新登录新账号
3. 等待设备同步

🔗 扩展资源

📚 官方文档

想了解更多高级功能，可以参考：

• Tailscale官方文档: Docs · Tailscale Docs
• 多端互访设置
• 子网路由配置
• 访问控制策略

🆘 技术支持

如果遇到本指南未涵盖的问题：

1. PPtech技术支持: 联系PPtech客服获取专业帮助
2. Tailscale社区: 加入Tailscale官方社区讨论
3. 在线文档: 查阅最新的官方技术文档

🎯 使用技巧

高级技巧分享:

• 设置设备别名便于识别
• 配置自动启动避免手动操作
• 定期检查设备在线状态
• 合理使用访问控制功能

🎉 恭喜您完成了Tailscale异地组网配置！

现在您可以在世界任何地方安全、便捷地访问您的PPtech盒子，享受如同本地操作般的远程控制体验。

要使用外网控制家里/公司/内网/机房环境下的被控设备，您需要明白它的工作原理。

PPKVM设备工作原理（信号流向）

PPtech系统的核心在于让一台无需联网的电脑（被控端）能够被远程控制和访问。其工作原理遵循以下信号流向：

1.信号采集（被控端）：
被控电脑的HDMI视频输出信号直接连接到PPtech盒子内置采集卡。
被控电脑的USB接口（用于键鼠控制）通过一条 USB OTG线（或基于CH340/9329等芯片的专用线缆）连接到PPtech盒子。

2.信号处理与转发（PPtech盒子）：
PPtech盒子接收到来自被控电脑的HDMI视频和USB控制信号，盒子将这些信号进行编码、压缩等处理。

【提示】PPtech盒子通过端口映射、内网穿透或异地组网等技术，将处理后的数据流上传至互联网。因此，PPtech盒子本身需要接入互联网。

3.远程访问与控制（控制端）：
用户在任何地方的另一台控制电脑上，打开网页浏览器，在浏览器地址栏中输入PPtech盒子的IP地址。

【提示】 控制电脑需要能够访问互联网，才能成功连接到PPtech盒子推送出来的服务地址。
随后，用户即可在网页中看到被控电脑的实时屏幕，并可以通过本地键鼠远程操作被控电脑，体验如同直接操作一样。

局域网工作模式:
在同一个局域网内（例如办公室或家庭网络环境中），控制电脑可以跳过互联网，直接通过局域网IP地址访问PPtech盒子并进行控制，此时延迟更低，体验更流畅。

总结一下：
被控电脑无需联网：它的所有信号都通过物理线缆（HDMI和USB）传输给PPtech盒子，自身不需要任何网络连接（如Wi-Fi或网线）。
PPtech盒子跟控制电脑需要接入互联网：PPtech盒子是连接被控电脑和远程控制者的桥梁，必须联网才能将信号发布出去；控制电脑也必须联网才能接收这个信号（Ps：如果是局域网内控制则不需要联网）

控制方案

如需外网访问PPtech盒子控制被控设备这里提供4种方案。

1. 公网映射
2. 内网穿透
3. 异地组网
4. 内网穿透

:::tip[推荐方案]
这里PPtech推荐使用异地组网的方式进行外网控制，相对于其他3种方案优点是完全免费并且可以建立隧道点对点传输，同时推荐使用Tailscle进行异地组网，配置简单方便，免费支持20设备进行虚拟组网。
:::

公网映射

如果您有公网IP，那么直接通过公网IP映射PPtech盒子的内网IP跟443端口即可。

内网穿透

内网穿透推荐使用FRP进行穿透，详情如图。

跳板机

可以使用向日葵，todesk等远程控制软件做为跳板进行控制，详情如图。。

异地组网

异地组网推荐使用Tailscle或者zerotiter进行组网，详情如图。

cp /etc/kvmd/override.yaml /etc/kvmd/override.yaml.bak

编辑配置文件

nano /etc/kvmd/override.yaml

找到下面几行的配置信息

    gpio:
        drivers:
            wol_server1:
                type: wol
                mac: 2c:56:dc:db:7c:1e
            short_press:

修改上面的mac地址配置

mac: 2c:56:dc:db:7c:1e

为你被控主机的mac地址
比如你的被控主机mac地址为：5c:56:7c:db:8u:23
将上面的信息修改为

    gpio:
        drivers:
            wol_server1:
                type: wol
                mac: 5c:56:7c:db:8u:23
            short_press:

修改完成后按键盘上的ctrl + x 在按Y保存配置
最后执行命令重启服务即可

systemctl restart kvmd kvmd-nginx

# This file describes the credentials for VNCAuth. The left part before arrow is a passphrase
# for VNCAuth. The right part is username and password with which the user can access to KVMD API.
# The arrow is used as a separator and shows the relationship of user registrations on the system.
#
# Never use the same passwords for VNC and IPMI users. This default configuration is shown here
# for example only.
#
# If this file does not contain any entries, VNCAuth will be disabled and you will only be able
# to login in using your KVMD username and password using VeNCrypt methods.

# pa$$phr@se -> admin:password
admin -> admin:admin 

对应关系为：

admin -> admin:admin 
密码 -> 账号:密码

这里只需要把2个密码字段改为你的web控制台密码即可
比如web控制台的密码为：passwd 那么这里的配置文件就需要修改为

passwd -> admin:passwd

使用nano命令打开配置文件

nano /etc/kvmd/vncpasswd

修改完成后配置文件如下：

# This file describes the credentials for VNCAuth. The left part before arrow is a passphrase
# for VNCAuth. The right part is username and password with which the user can access to KVMD API.
# The arrow is used as a separator and shows the relationship of user registrations on the system.
#
# Never use the same passwords for VNC and IPMI users. This default configuration is shown here
# for example only.
#
# If this file does not contain any entries, VNCAuth will be disabled and you will only be able
# to login in using your KVMD username and password using VeNCrypt methods.

# pa$$phr@se -> admin:password
passwd -> admin:passwd 

修改完成后按CTRL+X 然后在按Y 继续按回车键保存配置文件即可
最后重启VNC服务即可使用新的密码登录vnc控制台

systemctl restart kvmd-vnc