360智能路由器插件開發指南版本1. 0目錄目錄1?概述3?? 1.插件與Linux插件之間的關系3 2.插件體系結構4 3.插件在啟動和退出時4 4.插件程序配置方法5 4. 1本地配置方法5 4. 2插件中心配置方法5 5.安裝開發工具5 6.如何使用API??6 7. ]插件程序目錄結構6 8.插件程序參數7 9.使用插件自己的動態鏈接庫81 0.使用C開發插件81 1.安裝插件到路由器8?插件API10 1. API返回值10 2.用戶組10 3. URL URL組14 4. URL URL過濾策略組15 5. http訪問控制15 5. 1 URL黑白名單16 5. 2HTTP高級過濾策略17 5. 3Web身份驗證19 5. 4取消360智能路由器25 6.網絡接口26 6. 1查詢中特定URL路徑的訪問身份驗證并設置WAN端口配置26 6. 2查詢d設置LAN端口配置27 7.帶寬控制28 7. 1主機速度限制281 8.連接網絡用戶信息29 8. 1獲取Intranet主機信息29 8. 2獲取Intranet主機信息30 9.與存儲相關的接口30 9. 1獲取RAM存儲器信息30 9. 2獲取插件臨時存儲路徑31 9. 3獲取插件永久存儲路徑311 0.系統信息321 0. 1獲取設備唯一的硬件標識321 0. 2獲取系統啟動時間32?插件配置接口和接口33 1.開發插件配置接口34網頁目錄結構34 2.開發插件配置接口（）CGI34 2. 1開發支持360OS CGI34 2. 2定義插件的CGI接口35 2. 3編寫CGI處理功能36?附錄38 1.示例1：您好，世界！ 38 2.示例2：Web用戶認證39 3.位掩碼操作功能40 3. 1位掩碼初始化40 3. 2在位掩碼中設置一個位41 3. 3清除位掩碼41 3. 4位掩碼中的測試位412?概述本文詳細介紹了基于360 OS的設備側插件程序的開發方法。

開發人員需要具備TCP / IP網絡協議知識，Linux環境下的C語言插件程序開發經驗，熟悉JSON數據打包格式以及HTML / JavaScript。術語解釋：JSON：JavaScriptObject符號CGI：CommonGatewayInterfaceAPI：應用程序編程接口插件：在360智能路由器中運行的插件程序1.插件和Linux插件之間的關系除了支持Linux樣式的插件開發之的無線主機信息，如組操作時間組，網站組，用戶組操作存儲與存儲相關，例如獲取系統主分區信息，遍歷所有存儲設備以及系統API的其他設備信息，以獲取與設備相關的信息，例如設備綁定用戶列表，設備ID號等。3 2.插件體系結構360OS插件在系統中的位置如右圖所示，“插件”框中的部分是網關插件的一部分。

“功能實現”是必須的。如果要開發帶有網關本地Web配置界面的插件，則必須具有配置界面，配置界面和功能實現部分。如果只需要云Web配置功能，則仍然需要開發配置界面，但是已經安裝在云中，并且需要配置網關中的插件。接口和功能實現部分；例如，如果僅通過專用插件（不使用Web技術）配置插件的所有功能，則僅使用手機APP進行控制，則不需要配置接口部分，而是配置界面和功能實現部分。插件自己的動態鏈接庫和內核模塊是可選的。庫和模型sokosoko塊隨附了支持插件。注意：安全路由器不支持內核模塊文件。 360miniko 3.插件的啟動和退出插件必須在進程的主線程中申請360OS資源，即，調用以register為前綴的API。在插件程序的工作期間，主線程保持不變。為了避免資源泄漏，當插件的主線程結束時，需要釋放請求的360OS資源。插件程序注冊SIGTERM的信號處理功能，例如signal（SIGTERM，sig_func），并通過調用sig_func函數中以unregister為前綴的API釋放請求的資源。 4 4.插件程序的配置方法插件是通過Web進行配置的。包括插件的啟動和停止，獲取插件的狀態，配置插件參數等。

共有三種配置模式：本地配置模式，插件中心配置模式以及兩者均支持的配置模式。 360OS的設計確保了這兩種開發方法的一致性。 4. 1本地配置方法將支持此配置方法。該設備需要具有插件前端配置網頁和CGI程序。安裝插件后，新的插件將出現在路由器配置頁面上的“第三方擴展工具”菜單下。單擊圖標跳至該插件的配置頁面。在插件開發中，開發人員將首先使用此方法來完成插件開發和調試。如果您希望更多的用戶使用您的插件，則需要使用下一種方法：將您的插件提交給插件中心進行審查。 4. 2插件中心配置方法此配置方法僅使用設備端，并且前端網頁已安裝在插件中心服務器中。通過插入Web版本的CGI Ware Center或移動終端插件來配置插件。請注意，只能通過插件中心配置通過插件中心發布的插件。 5.安裝開發工具并訪問360 Smart Router的官方網站：下載開發工具并將其解壓縮到Linux主機上。 / opt / tarjxvf srouter_P0_P1_XXXX.tar.bz2 XXXX是版本號。解壓縮后，將生成以下目錄。 / srouter_ P0_P1_XXXX / include頭文件目錄./srouter_ P0_P1_XXXX / linux內核頭文件，用于開發內核驅動程序./srouter_ P0_P1_XXXX / lib庫目錄./srouter_ P0_P1_XXXX /實用工具目錄./srouter_ P0_P1_XXXX / doc開發指南。/srouter_XXXX/示例示例。/srouter_P0_P1_XXXX / toolchain交叉編譯工具目錄。/srouter_P0_P1_XXXX / env-rtk.sh環境配置腳本，360安全路由P 1、 mini使用source./env-rtk.sh運行5 6.如何使用API???本文介紹的API需要引用srouter.h頭文件，并且連接需要libnorouter.so。

鏈接參數：LDFLAGS = -L $ {SROUTER_PATH} / lib-Inorouter是安裝目錄$ {SROUTER_PATH} SDK為了處理HTTP請求，CGI程序還需要引用cgi.h，而libcgi.so是連接所必需的。 LDFLAGS = -L $ {SROUTER_PATH} /lib-lcgi-inorouter?為了解決使用新固件運行舊版本插件的問題，在許多C結構的頂部添加了uint32_t size_of_struct或SizeOfStruct成員。在使用宏之前，需要使用它們：NOS_STRUCT_INIT。初始化它。 7.插件程序的目錄結構根據以下目錄結構來組織插件：./plug-in name / app.json插件的基本信息，請參閱插件說明名稱，。// APPSIGN.png APPSIGN_b.png APPSIGN_w.png插件圖標文件APPSIGN指代插件的名稱。例如，信號調節插件的圖標文件：power_progress_b.png是單擊插件配置界面時的圖標，分辨率為75px * 75px power_progress.png是在插件列表中看到的圖標，分辨率為64px * 64px6 power_progress_w.png是當前圖片。將鼠標移動到插件圖標時顯示的圖片，分辨率為64px * 64px。/插件名稱/配置插件默認參數文件，其中由插件定義。/plugin-name/bin/此目錄存儲可執行程序和內核模塊文件，即動態鏈接庫插件名稱。此目錄存儲程序，和其他網頁文件。 // webs / cgihtml css javascript插件程序，帶有名為opk的擴展名，可以通過設備的本地Web配置頁面安裝。

App.json文件描述：該文件是插件的基本信息文件，為JSON格式，包括以下對象。插件程序需要填寫每個對象的值。請注意，該值不能換行：（）“ appsign”：插件的名稱，必須是唯一的是，與其他插件名稱不同，ASCII字符“ appname”：插件的顯示名稱，即名稱顯示在手機和本地配置頁面上，UTF8編碼“版本”：插件版本號，三個點分十進制數字。例如：“ 1. 0. 1”“ dep_version”：基本系統的版本依賴性要求，基本系統的版本號必須大于此版本才能安裝“ description”：插件簡介“ bin_start”：插件啟動程序文件名，該文件必須位于./bin目錄中。 “作者”：作者名稱“ URL”：官方網站“ maintainer”：維護者“ email”：維護者的電子郵件“ icon”：插件圖標，相對路徑“ configtype”：配置類型，0：不需要配置，1：本機配置界面（移動APP的本地實現），2：H5配置，對于H5配置插件，配置頁面路徑為/app//webs/index.html“ app_type”：插件程序類型，本地配置“ local “，” remote“，” local＆remote“” rom_use“：插件程序需要占用的rom空間，單位為KB” ram_use“：插件程序運行時所需的ram空間，單位為插件程序的參數插件KB 8.程序通常需要暫時且永久地保存數據。 SDK提供了兩個API，分別是get_tmp_path和get_config_path，以分別獲取插件的臨時數據存儲路徑和永久數據存儲路徑。 7有關詳細信息，請參閱API部分的“與存儲相關的API”一章。

臨時數據是指網關重啟后將清除的數據；永久數據是指關閉網關電源后將繼續保存的數據。不應將大量數據保存在臨時存儲路徑中。當系統內存不足時，將清理臨時存儲目錄，并強制清除占用較大臨時存儲空間的數據。插件的臨時目錄的存儲內容不應超過100KB，并且必須控制存儲在臨時目錄中的日志文件的大小。插件開發人員應使用API??返回的路徑來保存自己的數據。使用其他路徑不會通過插件中心審查，也不能保證固件升級后可以正常讀寫。當用戶恢復插件參數時，臨時和永久存儲路徑中的所有文件都將被刪除，插件目錄中的配置文件將被復制到永久數據存儲目錄中。升級插件后，臨時和永久存儲路徑下的內容將不會被刪除。 9.使用插件自己的動態鏈接庫如果所需的動態鏈接庫不在固件中，則可以將所需的動態鏈接庫文件復制到插件的bin目錄中。啟動該插件時，以及在Web服務器上執行CGI程序時，該插件的bin目錄將被添加到LD_LIBRARY_PATH環境變量中，以便您的程序可以正確地找到相應的動態鏈接庫文件。 360安全路由器P 1、 5G固件包括以下動態鏈接庫：libpthread，libresolv，libm，libuClibc，libssl，libcrypt，libcrypto，libnl，libnsl，librt 360安全路由器迷你固件包括以下動態鏈接庫：固件支持的動態鏈接庫可以遠程登錄到路由器并查看/ lib目錄中的文件。

1 0.使用C ++開發插件。不同的360安全路由器具有不同的資源。 360安全路由器P 1、 5G固件包含C庫，360安全路由器mini不包含C庫。 1 1.有兩種將插件安裝到路由器的插件安裝方法：?通過設備的Web配置頁面安裝插件。編譯和打包后，可以通過設備的本地配置頁面進行安裝。通過瀏覽器訪問8（或端口地址）。首先找到“開發人員模式”，將其“第三方LAN IP第三方插件開關”設置為ON，然后找到“第三方擴展工具”，單擊“添加插件”，選擇插件的opk文件，上傳路由器并完成安裝。注意：請謹慎使用。第三方插件調試功能是插件開發人員專有的。安裝未經正式審查的第三方插件可能會導致用戶信息泄漏，甚至可能導致路由器的基本功能不穩定。安裝后，可能會進行非正式審查。安裝第三方插件后，我們公司將不再保證路由器。打開電源后，按住重置按鈕3到5秒鐘，即可恢復出廠設置并清除第三方插件。 ?通過插件中心安裝提交插件中心，通過審核的插件可以通過“ 360”手機終端的“擴展工具”界面輸入插件中心路由器防護”中的右上角帶有“”。 9?插件API 1. API的返回值如果API調用失敗，則將返回負值。錯誤代碼定義如下：枚舉{ERR_FAILURE = -1，/ *一般錯誤，例如非法參數* / ERR_GROUP = -2，/ *用戶組ID非法* / ERR_NO_RESOURCE = -3，/ *資源不正確可用* / ERR_RULE_FULL = -4，/ *規則已滿* / ERR_NO_PERMISSION = -5，/ *無權限* / ERR_NO_MEM = -6，/ *內存分配失敗* / ERR_NAME_EXIST = -7，/ *名稱已存在* / ERR_NON_EXIST = -8，/ *規則不存在* / ERR_DATA_ERR = -9，/ *參數錯誤* / ERR_EXIST = -10，/ *規則已存在* / ERR_NOT_SUPPORT = -11，/ *不支持* /} ; 2.用戶組用戶組它是Intranet用戶的集合，可以是IP地址或用戶帳戶的集合。

本文來自本站，轉載請注明本文網址：
http://www.pc-fly.com/a/tongxingongju/article-370569-1.html