猫棒助手是一款用于配置 GPON Stick / GPON 猫棒的桌面工具，适合通过 SSH 写入原光猫认证信息、设置 VLAN、查看 PON 注册状态，并进行在线或本地固件升级。
软件下载可以前往 GitHub Release 页面：猫棒助手 v1.2。 或者网盘地址：蓝奏网盘 密码wifi
适用型号：HUAWEI（华为）MA5671A 、 Nokia（诺基亚）G-010S-A 、 Alcatel（阿尔卡特）G-010S-P
一、使用前先准备这些信息
配置猫棒前，建议先进入原光猫后台或查看原光猫标签，记录下面几类信息：
- GPON SN：通常在原光猫背面标签或后台信息页中可以找到。
- LOID / LOID CheckCode：联通、电信宽带常见，部分地区会叫 LOID 密码。
- PLOAM Password：移动宽带常见，一般是 10 位 ASCII 字符。
- 上网 VLAN，也就是 PVID：只填写原光猫 Internet 连接名称里的 VLAN 数字。
- IPTV VLAN：不使用 IPTV 可以先留空，减少误配置。
不同地区和运营商的认证方式不完全一样，不建议靠猜测填写。尤其是 LOID 和 PLOAM Password，通常按实际运营商认证方式选择一种，不要混填。
二、连接猫棒并读取当前配置
打开猫棒助手后，顶部连接区一般可以先保持默认参数：
- 主机：
192.168.1.10 - 端口：
22 - 用户：
root - 密码：默认无密码
填写完成后，先点击“连接”，连接成功后再点击“读取”。读取动作会把猫棒当前配置同步到软件中，后续修改时更稳妥。
三、重点：用快速设置完成认证和 VLAN 配置
进入“快速设置”标签页后，只需要关注几项关键参数。这个页面就是给第一次配置准备的，比高级页面更不容易误操作。
1. 填写 GPON SN
GPON SN 必须填写，一般填写原光猫背面标签或后台显示的 GPON SN / SN。这里是注册认证里最基础的一项，填错通常无法进入 O5。
2. 按运营商认证方式填写 LOID 或 PLOAM
- 联通 / 电信用户：优先填写 LOID，如果有 LOID 密码，就填入 LOID CheckCode。
- 移动用户：常见做法是填写 PLOAM Password。
如果不确定自己地区用哪一种认证方式，建议先回到原光猫后台确认，不要同时乱填多种认证。
3. 填写 PVID，也就是上网 VLAN
PVID 只填写 Internet 业务对应的 VLAN 数字。例如原光猫后台里 Internet 连接名称或配置项中显示 VLAN 为 41，就在 PVID 中填写 41。IPTV 不使用时可以留空。
4. 保存并重启
填完关键参数后，点击右下角“保存并应用”。等待大约 8 秒后点击“重启”，然后等待猫棒重启完成，建议等 3 分钟左右再重新连接。
四、回到状态页确认是否注册成功
猫棒重启后，重新点击“连接”和“读取”，再进入状态页查看 PON 状态。最重要的判断是：
- PON 状态为 O5：通常代表认证注册成功，可以继续在路由器中设置 PPPoE 拨号。
- PON 状态不是 O5：优先检查 GPON SN、LOID、PLOAM Password、上网 VLAN 和光纤信号。
- 有光功率但无法 O5：多半是认证信息、运营商绑定或 OMCI 兼容问题。
- 已经 O5 但无法拨号：重点检查 PVID、宽带账号密码、路由器拨号方式和运营商绑定。
状态页还可以查看 RX / TX 光功率、芯片温度、激光温度、网口速率、当前系统版本、设备型号、OMCID 版本等信息。日常排障时，先看 O5，再看光功率和 VLAN，是比较高效的顺序。
五、在线升级页怎么用
在线升级页用于根据设备型号检测可用固件，也支持本地选择 .image 固件文件刷写。使用前一定要先在状态页读取出设备型号和当前系统版本。
目前发货的已经是综合最优的固件，暂时不用升级
推荐流程如下：
- 先连接猫棒，并确认状态页能正常读取设备型号。
- 进入“在线升级”页，点击“在线固件检测”。
- 选择匹配自己设备型号的固件版本。
- 确认无误后点击“刷写并重启”。
- 刷写过程中不要断电，不要拔猫棒，也不要中断供电。
如果使用本地固件升级，建议先计算 MD5 并和固件发布方提供的 MD5 对比。刷错固件可能导致设备变砖。
六、常见问题快速判断
- 软件连接不上：检查路由器wan口是否和猫棒在同一网段，wan设置静态IP 192.168.1.x
- 保存后没生效：需要重启猫棒后才会完全生效。
- O5 但不能上网：优先检查 PVID、路由器 PPPoE 账号密码，以及运营商是否绑定 MAC。
- IPTV 不正常：再考虑下行组播 VLAN、组播版本、ME 规则等高级项目。
七、安全提醒
猫棒接入的是运营商共享光网络，错误的认证、VLAN、OMCI 或固件操作可能导致自己无法上网，严重时还可能影响设备稳定性。建议只填写自己原光猫中真实存在的认证信息，不要使用未经授权的数据，也不要随意刷写不匹配的固件。
简单来说：第一次配置只动“快速设置”里的 GPON SN、LOID / PLOAM 和 PVID；注册成功看 O5；然后去路由器拨号。这样是最稳的路线。