花生殼phtunnel嵌入Openwrt 詳細介紹如何將phtunnel封裝成一個openwrt標準組件,並編譯到自己的openwrt固件中。 phtunnel組件製作下載 下載自己的編譯平臺的二進位phtunnel文件是第一步要做的,我們可以到oray的官方github網站進行下載,根據自己的型號 ...
花生殼phtunnel嵌入Openwrt
詳細介紹如何將phtunnel封裝成一個openwrt標準組件,並編譯到自己的openwrt固件中。
phtunnel組件製作下載
下載自己的編譯平臺的二進位phtunnel文件是第一步要做的,我們可以到oray的官方github網站進行下載,根據自己的型號進行下載,比如我的路由器是基於MIPSel,c庫使用的是uclibc,那麼我可以進入xxxxx,進入xxxxxxxx,並下載mipsel-uclibc-phtunnel文件。
規劃目錄結構接
下來的任務是規劃自己的phtunnel組件安裝後,在openwrt系統上是怎樣的目錄結構。
首先核心的應用程式phtunnel我們可以放在/usr/bin目錄下,因為它是一個非管理員應用,所以一般比放在/usr/sbin目錄下要更科學一些。
uci配置文件:由於openwrt的uci是常用的配置解決方案(不理解uci可參閱其他文檔),所以需要一個uci配置文件,該文件通常放在/etc/config目錄下,同時我們取名同樣為phtunnel,這樣就可以使用uci set phtunnel.xx.xx等操作phtunnel的配置了。
根據phtunnel列出的參數,uci的配置如下:
啟動腳本:通常應用都是作為守護腳本運行,所以phtunnel也會製作成守護程式,自動運行,所以需要在/etc/init.d中建立phtunnel的啟動腳本,名稱也叫phtunnel。
hotplug.d機制:為了及時響應網路狀態,快速重啟phtunnel,可使用hotplug機制。這樣在wan口斷開重新連上網的時候,能馬上重啟phtunnel。在/etc/hotplug.d/iface下需要創建一個xx-phtunnel的腳本,其中xx代表腳本執行順序,可以隨便填。
這樣,安裝後的目錄結構是如下圖
編寫phtunnel組件Makefile
根據目錄結構規劃,現在來編寫組件,由於openwrt的組件是用makefile文件編寫。
將makefile及規劃的files目錄統一放在phtunnel目錄內,然後放在openwrt的package/utils目錄中即可(可放在package下的任何位置),再來看一下目錄結構
這時執行make menuconfig後,就能看到phtunnel組件了
選中該組件後保存,執行make,就可以編譯出帶phtunnel的固件了和對應的phtunnel的ipk組件包了。
啟動腳本
用於啟動與停止phtunnel,啟動後讀取uci配置,變成phtunnel的啟動參數,然後啟動phtunnel程式,代碼如下:
這裡用到了openwrt的PROCD機制,這樣可以在phtunnel意外崩潰的情況下,自動重啟。
hotplug腳本
用於在wan介面連接有效時,重新開啟phtunnel,加速重連速度。
phtunnel-luci-app組件製作功能
phtunnel運行後,需要進行掃碼登錄,管理,解綁等操作,這些都是需要與客戶的交互操作,openwrt提供的luci是實現交互的最佳選擇,也是最正式的方式,下麵來製作基於luci的phtunnel組件。
核心模塊
luci的代碼區域在/usr/lib/lua/luci中,所以所有交互的web代碼都放在這個下麵,首先是核心的基礎庫phtunnel.lua,它將提供所有核心函數,如獲取二維碼,登錄信息和解綁操等核心功能。
所有函數的核心都是調用wget來訪問rpc服務和官方提供的web服務。
LUCI頁面
完成核心函數庫後,接下來就是根據luci的架構進行開發。首先是規劃菜單與菜單項,如圖:
完成這樣的菜單,需要在controller目錄下實現,如圖:
其中setup頁面用於設置基本參數,Status頁面用於掃碼與解綁,Log用於顯示日誌。
Setup頁面
設置頁面是一個純UCI頁面,我們可以使用luci提供的cbi模塊開發。
顯現的頁面如圖
Status頁面
該頁面用於顯示二維碼,管理界面鏈接及解綁。相關代碼在view/oray/phtunnel_status.htm, view/oray/phtunnel_inner_status.htm, view/oray/phtunnel_log_off.htm,
phtunnel_status.htm : 用於顯示當前狀態。
phtunnel_inner_status.html : 用於後臺實時檢測綁定狀態,當用戶使用手機刷二維碼綁定後,phtunnel_status.htm頁面動態顯示綁定帳號。
phtunnel_log_off : 用於解綁帳號
Log頁面
用於顯示日誌,該頁面相對簡單(view/oray/phtunnel_log.htm),
通過uci獲取日誌路徑,並使用cat命令將文件內容輸出即可。
製作組件的makefile
與製作phtunnel組件一樣,將所有文件組織成目錄樹,並加入Makefile
Makefile
最後同樣將組件複製到openwrt/package/utils/下,這樣我們可以在配置界面中看到phtunnel-luci-app組件
選擇以上兩個組件,充分編譯後,即可在本地的luci界面上使用phtunnel了。