Simple PPPoE scanner Python Script

  • Thread starter Thread starter JB701
  • Start date Start date
  • Replies Replies 32
  • Views Views 8,821
  • Tags Tags
    ppppoe
Yes. Ont in bridge mode. You must have python installed with tkinter and scapy modules.

You need to change the interface name, you can see this in control panel>network and internet it should be Realtek or Intel....
 
modify this def send_padi(smac="00:2B:67:F8:1F:78", vlan=0) right?
modify it how? like for vlan in range (0, 4096)?
cause we want it to check all available vlan tags from 0 to 4096
 
could you create a small script to get the vlan id only? no gui or anything. your script seems to work but vlan id is not working. if you only give a script to get vlan id.
 

[TOOL] VLAN Hunter: Reliable PPPoE VLAN Discovery Tool (Linux)​


Hello everyone,

I've recently completed a significant refinement of the script often circulated as the "Simple PPPoE scanner Python Script" (originally by JB701—thanks for the foundation!). I've named this improved version VLAN Hunter. The goal was to create a robust, accurate tool for a common issue: finding the specific VLAN ID required for PPPoE connections when setting up a custom router.

A major benefit of this script is that it removes the need for specialized external hardware. You no longer need devices like the XZ000 G3 just for VLAN scanning—your Linux PC can handle it.

Technical Summary & Features:​

  • Core Function: Scans all possible VLAN IDs (1-4094, plus untagged) to capture the correct PPPoE Active Discovery Offer (PADO) from your ISP's network.
  • Automated Setup: The script is self-contained. It handles dependency checks and automatic installation of necessary packages (like scapy and pip).
  • User Interface: Requires minimal interaction. When run, it provides an interactive menu to select the appropriate network interface.
  • System Integrity: Guarantees a clean exit. The script automatically restores system configurations and removes any temporary files or packages it installed.
  • Platform: Linux only (sudo required).

Prerequisites Checklist (Read First):​

Before execution, ensure these conditions are met for successful scanning:
  1. ONT/Router Configuration: Must be in bridge or transparent mode.
  2. Physical Connection: Connect a LAN port from your ISP device/ONT directly to the machine running the script.
  3. Internet Access: The host PC must have temporary internet connectivity for the initial package installation phase.
  4. Security: Using a bootable Linux USB OS is advised if you prefer to isolate the process from your main operating system.

Script: ​

<iframe src="
Source" style="border:none;width:100%"></iframe>

Execution:​

To run the script (assuming it's saved as VLAN.py on your Desktop):

Code:
sudo python3 ~/Desktop/VLAN.py

I hope this proves useful to anyone currently working through their PPPoE setup. Feedback on performance is welcome.
 
@x86_64 yes. They are both made with the help of AI (and several hours of trial & error and testing from my end). This is the final script and should work on all Linux machines without any issues.
 
Back