esp8266socks's Introduction

esp8266socks

connect your PC to WIFI network by esp8266

hardware

pc -> USB Serial UART Converter -> esp01

notes:

chips on usb serial converter both pl2303, ch340 or ft232 are tested working fine. The converter's Gnd should wire to esp01's Gnd, otherwise the serial output is garbled.
3.3v power supply to esp01 is important, esp01's unstable issue is mostly possibly caused by the power supply
require good heat dissipation on esp8266 chip, when the wifi is turning on, the power consumption is becoming high and temperature is becoming high, it's very possible lead to stuck.

Internet speed on esp8266

let's take 115200 baud rate as an example, it's the default uart serial config on esp8266.

115200bit/s = 14.0625kb/s

so in theory, the speed can never be faster than 14kb/s. today's most modern web page is about 5mb, it costs more than 6 minutes to load it.

usage

# install dependancy package
pip install -r requirements.txt

python main.py --host <ip address> --port <port> --serial /dev/tty<serial port> --ssid <ssid> --password <password>

software structure

     -------------                                                                            --------------
    |             | <- connect                                                    connect -> |              |   listen
    | esp8266wifi | <-   close    linkid <== esp8266_linkid_socks_map ==> sock    close   -> | socks5server | ========== socks5 proxy
    |             | <-    recv                                                    revc    -> |              |
    |             | <-    send                                                    send    -> |              |
     -------------                                                                            --------------
           ||
           ||
           || at command
           ||
           ||
       ----------
      | pyserial |
       ----------