启用Armbian的IP转发功能

首先，需要开启 Armbian 的 IP 转发功能（如果之前没做过）：

echo 'net.ipv4.ip_forward = 1' | sudo tee -a /etc/sysctl.conf

echo 'net.ipv6.conf.all.forwarding = 1' | sudo tee -a /etc/sysctl.conf

sysctl -p

宣告Tailscale子网路由

在PPtech上启动 Tailscale 并宣告子网路由。
你需要知道你被控设备所在的局域网网段，例如最常见的 192.168.1.0/24。使用 ip addr或 ifconfig命令查看被控设备的本地 IP（如 192.168.1.10）来推断网段。
执行命令

sudo tailscale up --accept-routes --advertise-routes=局域网网段IP/24 --accept-dns=false

比如你的被控设备局域网IP地址为：192.168.5.1 那么替换一下命令就为：

sudo tailscale up --accept-routes --advertise-routes=192.168.5.0/24 --accept-dns=false

激活Tailscale子网路由

进入 Tailscale 管理后台 登录 Tailscale Admin Console
找到设备 PPtech 的记录，点击右边的 ... 三个点菜单。
选择 Edit route settings...。

在弹出的窗口中，你会看到它宣告的 192.168.5.0/24网段，将对应的开关从灰色变为蓝，以启用该子网路由。

其他设置

现在你就可以在安装了Tailscale服务的控制电脑上访问被控设备的服务了
比如需要访问被控设备的远程桌面服务，可以在被控设备的系统里面启用远程桌面服务，然后在控制电脑打开远程桌面连接，直接输入被控电脑的局域网IP地址进行远程
比如被控电脑的局域网IP为：192.168.5.99
那么直接在控制电脑远程桌面连接输入IP：192.168.5.99 然后单击连接 最后输入账号密码即可。

:::tip[不支持的客户端]
不支持的客户端：

• RealVNC - 不支持大多数广泛使用的开放式 VNC 协议扩展
• Remmina - 与服务器匹配设置的算法略有缺陷，正在改进
• Guacamole - 未正确实现 vencrypt，不支持 JPEG 压缩
• Vinagre - 未正确实现 vencrypt，会崩溃
  :::

Windows

对于 Windows，可以使用 UVNC 和 TigerVNC，下面是 UVNC 的使用示例。

安卓 Android

对于安卓移动端，可以使用AVNC和bVNC Pro这两个开源软件。两个应用的操作手势都支持触摸屏和触摸板。对于AVNC应用，不能使用默认的安全性设置，需手动修改安全性为Vncauth才能正常连接PiKVM VNC。

苹果 IOS

对于苹果 iOS ，可以使用 bVNC 应用程序，这是一个付费软件。
VNCAuth身份认证
对于使用VNCAuth身份认证的VNC客户端（即只需使用密码不需要输入账户的VNC客户端），如果修改了PiKVM程序密码后，此身份认证文件不会自动修改，需手动在文件/etc/kvmd/vncpasswd修改或添加密码映射。添加内容为“自定义VNC密码 -> WEB账户:WEB密码”，如下为示例：

第一步：先将盒子连接到路由器

1.用网线将盒子连接到你的家用路由器上（随便哪个LAN口都行）。
2.盒子会自动获取一个临时IP地址（就像自动获得一个临时门牌号）。

第二步：查找盒子的当前IP地址

1.打开你的电脑，连接到同一个路由器的Wi-Fi或有线网络。
2.登录路由器后台管理界面（通常地址是 192.168.1.1或 192.168.0.1，账号密码一般在路由器底部）。
3.在路由器后台的“连接设备”或“DHCP客户端列表”里，找到盒子的名称和它当前获取到的IP地址（例如 192.168.1.105），记下这个地址。

第三步：进入盒子设置页面，改成固定IP

1.在电脑浏览器中输入刚才查到的盒子IP地址 例如 http://192.168.1.105 进入盒子的web页面
2.找到“网络设置”或类似选项，把网络模式从“自动获取（DHCP）”改为“手动设置”或“静态IP”。
3.设置一个固定的IP地址，比如：
➤ ​IP地址​：192.168.8.8
➤ ​子网掩码​：255.255.255.0
➤ ​网关​：可留空或填 192.168.8.1（不影响后续使用）
4.保存设置，并在页面中找到“重启”或“Reboot”选项，让盒子重启生效。

第四步：盒子与电脑直连

1.盒子重启成功后，拔掉它和路由器之间的网线。
2.用另一根网线，直接将盒子的网口和电脑的网口连接起来。

第五步：设置电脑的IP地址

1.打开电脑的“网络设置” → “更改适配器选项” → 右键点击“以太网” → “属性”。
2.选择“Internet协议版本4 (TCP/IPv4)” → 点击“属性”。
3.选择“使用下面的IP地址”，并填写：
➤ ​IP地址​：192.168.8.9（只要和盒子在同一网段就行）
➤ ​子网掩码​：255.255.255.0
➤ ​默认网关​：可留空
4.点击“确定”保存。

最后一步：访问盒子​

•打开浏览器，输入盒子的固定地址：
​https://192.168.8.8​
现在你应该能成功访问盒子的控制页面啦！

总结一下：

整个过程就是：
​路由器找IP → 进盒子改固定IP → 重启 → 直连电脑 → 改电脑IP → 用浏览器访问盒子​
如果有哪步遇到问题，检查一下网线是否插好、IP是否填对，或者重启试试。祝你顺利！

切换到ROOT用户

su root

默认密码：1234

切换到跟目录

cd /

打开配置工具箱

./ppconfig

修改Root密码

选择选项 5 根据工具提示输入新的Root密码 确认修改

切换到ROOT用户

su root

默认密码：1234

切换到跟目录

cd /

打开配置工具箱

./ppconfig

配置网络唤醒

选择选项 4 输入需要唤醒的设备MAC地址 根据工具提示重启服务使其生效

切换到ROOT用户

su root

默认密码：1234

切换到跟目录

cd /

打开配置工具箱

./ppconfig

修改web管理端口

选择选项 3 按工具提示输入新的端口 重启设备使其生效

切换到ROOT用户

su root

默认密码：1234

切换到跟目录

cd /

打开配置工具箱

./ppconfig

进入用户管理

输入选项2 进入用户管理

在这里可以修改默认用户：admin 的密码 同时也可以添加新用户 修改添加的用户密码等等

输入选项 1 即可根据工具提示修改默认：admin 用户的密码。

切换到ROOT用户

su root

默认密码：1234

切换到跟目录

cd /

打开配置工具箱

./ppconfig

下载工具箱

如果上面的命令运行后提示找不到命令 或者报错 请运行下面的命令下载工具箱
进入根目录

cd /

下载工具箱

wget http://47.122.122.184:9988/ppconfig

打开工具箱

./ppconfig

设置静态IP地址

根据工具箱提示 选择选项 - 网络配置 - 静态IP地址设置

推荐选择第一个配置一键把当前IP地址写入到固定IP配置

如果您不想把当前IP设置为固定IP地址也可以选择2选项设置自定义固定IP地址，按照工具提示输入您需要自定义配置的IP地址 掩码 网关 即可设置完根据工具箱指引重启网络使其生效。

📍 适用场景

在以下情况下，您可能无法通过常规方式获取PPtech盒子的IP地址：

🚫 没有路由器管理权限

• 🏢 在公司网络环境中，IT部门限制了路由器访问
• 🏠 家庭环境中，不知道路由器管理员密码
• 🏫 学校或其他机构的受限网络环境

🚫 路由器管理界面复杂

• 🤯 路由器界面全英文，看不懂设备列表
• 🔍 设备太多，难以识别哪个是PPtech盒子
• ⚙️ 路由器型号特殊，界面布局不熟悉

🎯 解决方案优势

✅ 无需路由器权限 - 直接扫描局域网设备
✅ 操作简单 - 下载即用，无需安装
✅ 结果清晰 - 直接显示设备名称和IP地址
✅ 兼容性强 - 支持所有Windows系统

🛠️ 工具介绍

📱 Wireless Network Watcher 简介

Wireless Network Watcher 是一款免费的网络扫描工具，专门用于发现局域网内的所有设备。

⭐ 核心特点

• 🆓 完全免费 - 无需付费，无广告干扰
• 🚀 扫描快速 - 通常1-2分钟完成全网扫描
• 📊 信息详细 - 显示IP地址、设备名称、MAC地址等
• 🔒 安全可靠 - 只读取信息，不修改网络设置
• 💻 绿色软件 - 无需安装，解压即用

🎯 工作原理

1. ARP扫描: 发送ARP请求到局域网内所有可能的IP地址
2. 设备响应: 在线设备会回应请求并提供基本信息
3. 信息收集: 收集设备的IP、MAC地址、设备名称等
4. 结果展示: 以表格形式清晰展示所有发现的设备

📥 下载与准备

🌐 官方下载链接

PPtech提供的加速下载地址：
wireless_network_watcher.zip

📋 系统要求

• 💻 操作系统: Windows 7/8/10/11 (32位/64位均可)
• 🌐 网络要求: 需要连接到与PPtech盒子相同的局域网
• 💾 存储空间: 约5MB磁盘空间
• 👤 权限要求: 普通用户权限即可，无需管理员权限

⚠️ 重要准备事项

1. 确认网络连接

   • ✅ 确保您的电脑与PPtech盒子在同一个网络中
   • ✅ 可以是有线网络或WiFi网络
   • ✅ 网络连接状态正常

2. PPtech盒子状态

   • ✅ PPtech盒子已正常通电
   • ✅ 网络指示灯显示正常连接状态
   • ✅ 盒子已正常启动（通常需要2-3分钟）

⚡ 快速操作指南

🚀 5分钟快速找到IP地址

总耗时：约3-5分钟

🟢 步骤1: 下载工具包（约30秒）
🟢 步骤2: 解压缩文件（约15秒）
🟢 步骤3: 运行扫描程序（约15秒）
🟢 步骤4: 等待扫描完成（约1-2分钟）
🟢 步骤5: 识别PPtech设备（约30秒）

📋 操作前检查清单

在开始操作前，请确认以下事项：

• [ ] 电脑已连接到局域网
• [ ] PPtech盒子已正常通电并联网
• [ ] 下载了扫描工具
• [ ] 关闭了可能干扰的安全软件（可选）

📝 详细操作步骤

🔽 步骤1：下载工具包

1. 点击下载链接

   • 点击上方提供的下载链接
   • 选择保存位置（建议保存到桌面）
   • 等待下载完成

2. 验证下载

   • 下载完成后，文件名应为：wireless_network_watcher.zip
   • 文件大小约为：3-5MB

📂 步骤2：解压缩文件

1. 找到下载的压缩包

   • 通常在"下载"文件夹或您选择的保存位置

2. 解压缩文件

   • 右键点击 wireless_network_watcher.zip
   • 选择"解压到当前文件夹"或"解压到指定文件夹"
   • 等待解压完成

3. 查看解压结果

   • 解压后会生成一个文件夹
   • 文件夹内包含 WNetWatcher.exe 等文件

🚀 步骤3：启动扫描程序

1. 打开程序文件

   • 进入解压后的文件夹
   • 找到 WNetWatcher.exe 文件
   • 双击运行程序

2. 程序启动确认

   • 程序窗口会立即打开
   • 界面显示为表格形式
   • 程序会自动开始扫描

💡 新手提示: 如果Windows提示"无法识别的应用"，请点击"更多信息"然后选择"仍要运行"。这是正常的安全提示。

🔍 步骤4：等待扫描完成

扫描过程说明：

1. 扫描开始

   • 程序会自动检测您的网络范围
   • 开始向局域网内所有可能的IP地址发送请求
   • 窗口标题栏会显示扫描进度

2. 设备逐个显示

   • 发现的设备会逐个出现在列表中
   • 每个设备显示：IP地址、设备名称、MAC地址等信息
   • 扫描过程通常需要1-2分钟

3. 扫描完成标志

   • 窗口标题栏不再显示扫描进度
   • 设备列表不再增加新项目
   • 状态栏显示"扫描完成"（如果有的话）

⏰ 耐心等待: 扫描时间取决于网络规模，通常1-3分钟内完成。

🎯 结果识别

🔎 如何找到PPtech盒子

扫描完成后，按以下方法识别PPtech盒子：

方法1：通过设备名称识别（推荐）

在设备名称列中查找以下关键词：

• 🎯 "PPtech" - 最直接的标识
• 🎯 "pikvm" - PPtech系统的技术名称
• 🎯 "raspberry" - 基于树莓派的设备
• 🎯 "rpi" - 树莓派的缩写

方法2：通过MAC地址前缀识别

在MAC地址列中查找以下前缀：

• 🔍 "B8:27:EB" - 树莓派基金会官方前缀
• 🔍 "DC:A6:32" - 树莓派4代常用前缀
• 🔍 "E4:5F:01" - 其他树莓派型号前缀

方法3：通过IP地址范围识别

PPtech盒子的IP地址通常在以下范围：

• 📍 192.168.1.x - 最常见的家用网络
• 📍 192.168.0.x - 部分路由器默认网段
• 📍 10.0.0.x - 企业网络常用
• 📍 172.16.x.x - 其他私有网络

📊 识别示例

正确的PPtech设备条目应该类似这样：

✅ 确认找到正确设备

找到疑似PPtech设备后，进行最终确认：

1. 记录IP地址

   • 复制设备对应的IP地址
   • 例如：192.168.1.100

2. 验证访问

   • 打开浏览器
   • 在地址栏输入：https://[IP地址]
   • 例如：https://192.168.1.100

3. 成功标志

   • 如果能打开PPtech管理界面，说明找到了正确的设备
   • 界面会显示PPtech的登录页面或管理界面

❓ 常见问题

🚫 扫描问题

Q: 程序无法启动或启动后没有反应？

A: 解决方案：

1. 确认Windows版本兼容性
2. 尝试以管理员身份运行
3. 临时关闭杀毒软件和防火墙
4. 重新下载并解压工具

Q: 扫描结果为空或设备很少？

A: 排查步骤：

1. 检查网络连接状态
2. 确认与PPtech盒子在同一网络
3. 尝试刷新扫描（按F5键）
4. 检查防火墙是否阻止了网络扫描

🔍 识别问题

Q: 找不到名为"PPtech"的设备？

A: 尝试以下方法：

1. 查找包含"pikvm"、"raspberry"的设备
2. 通过MAC地址前缀筛选
3. 逐个测试可疑IP地址
4. 确认PPtech盒子是否正常启动

Q: 有多个疑似设备，不知道选哪个？

A: 识别技巧：

1. 优先选择设备名称最明确的
2. 查看MAC地址是否为树莓派厂商
3. 通过浏览器逐个验证
4. 咨询网络管理员或PPtech技术支持

🌐 网络问题

Q: 扫描到了设备但无法访问管理界面？

A: 解决步骤：

1. 检查IP地址是否记录正确
2. 尝试不同的端口（如:8080、:443）
3. 确认PPtech盒子完全启动（等待5分钟）
4. 检查网络防火墙设置

Q: 扫描速度特别慢？

A: 优化建议：

1. 确认网络连接质量
2. 关闭其他占用网络的程序
3. 等待网络空闲时间进行扫描
4. 使用有线连接替代WiFi

💡 其他查找方法

🔧 备用方案

如果Wireless Network Watcher无法使用，可以尝试以下方法：

方法1：Windows命令行扫描

1. 打开命令提示符

   • 按 Win + R 键
   • 输入 cmd 并回车

2. 执行扫描命令

   for /l %i in (1,1,254) do ping -n 1 -w 100 192.168.1.%i | find "TTL"

3. 分析结果

   • 有响应的IP地址会显示出来
   • 逐个在浏览器中测试这些IP

方法2：路由器DHCP日志

1. 访问路由器管理界面（如果有权限）
2. 查看DHCP客户端列表
3. 寻找PPtech或树莓派相关设备

方法3：手机APP扫描

使用手机安装网络扫描APP：

• Android: "Fing"、"Network Scanner"
• iOS: "iNet Network Scanner"、"LanScan"

📞 技术支持

如果所有方法都无法找到PPtech盒子IP地址：

1. 联系PPtech技术支持

   • 提供详细的网络环境描述
   • 说明已尝试的解决方案

2. 网络管理员协助

   • 寻求网络管理员帮助
   • 请求提供设备IP地址信息

3. 重置网络配置

   • 考虑重置PPtech盒子网络设置
   • 使用有线连接简化网络环境

🎉 总结

通过本指南，您应该能够：

✅ 成功下载并使用Wireless Network Watcher
✅ 快速扫描局域网内的所有设备
✅ 准确识别PPtech盒子的IP地址
✅ 解决常见的扫描和识别问题

🚀 下一步操作：

• 记录找到的IP地址
• 在浏览器中访问PPtech管理界面
• 继续您的远程控制配置

💡 小贴士：建议将找到的IP地址保存到便签或文档中，方便日后快速访问。