快速概覽【快速上手手冊】 【三方視頻教學(xué)- B站】

• 平臺適配，支持linux、windows、macos、android、（tob，小型機：hp-unix、solaris、AIX）
  

• cpu架構(gòu)，支持x86、arm、mips、riscv（tob：alpha、PowerPC、SPRAC）
  

• 注重安全，“內(nèi)網(wǎng)”到“內(nèi)網(wǎng)”的穿透，無需映射任何端口到外網(wǎng)，不更改任何防火墻配置
  

• 注重帶寬，”4G手機+v6寬帶“采用P2P方式訪問內(nèi)網(wǎng)服務(wù)（基于TCP協(xié)議，v4支持NAT1-3穿透）
  

• 注重節(jié)約，無需購買vps、無需公網(wǎng)IP；家中淘汰Android手機可做服務(wù)器
  

• 注重可靠，隨用隨有，可7*24不間斷服務(wù)，且不受UDP協(xié)議Qos之苦
  

• 注重可控，客戶端一點配置，且隨時隨地控制服務(wù)開啟/關(guān)閉
  

• 注重環(huán)保，免安裝，體量小巧（mini版1MB左右） allinone，高性能且資源占用最少
  

• 注重便攜，無論工作或是度假，不管在任何地方，只要手機有網(wǎng)絡(luò)，一切盡在掌控
  

• ......如果這都是你想要的！請耐心繼續(xù)往下看；如果你還想要...請?zhí)醝ssue，【更新歷史】也有看頭哦
  

• 免費，測試穩(wěn)定后考慮開源.
  

• 包含一個android客戶端和需內(nèi)網(wǎng)安裝的服務(wù)端.
  

APP端配置（必須）--- 無法正常使用典型情況

• 必須配置“允許后臺運行”權(quán)限，否則切后臺即被系統(tǒng)斷連

• 必須配置“休眠時始終保持網(wǎng)絡(luò)連接”，否則一旦休眠則被系統(tǒng)斷連

• 可以配置“允許自啟動”權(quán)限，否則Android服務(wù)端模式下無法開機啟動（v0.30及后續(xù)版本）

• 可以配置“麥克風(fēng)”權(quán)限，否則Android服務(wù)端無法提供語音監(jiān)聽功能（v0.30及后續(xù)版本）

• 注意：SG官方代理不提供到港澳臺及國外IP的數(shù)據(jù)轉(zhuǎn)發(fā)

smarGate是什么？

官方命名為“移動網(wǎng)關(guān)”，通過手機客戶端將位于內(nèi)網(wǎng)的服務(wù)端網(wǎng)絡(luò)進行按需暴露，核心引擎采用c++實現(xiàn)。

“移動網(wǎng)關(guān)”是用戶私有網(wǎng)關(guān)，所有共享訪問入口都在客戶端，不是類似其它穿透工具主推的面向域名的公共訪問入口。打個比方：smarGate是將防盜門隨身攜帶，其它穿透產(chǎn)品是將防盜門放到公共場所，額...雖然需要鑰匙，但有種職業(yè)叫開鎖匠

具備如下技術(shù)特點：

• 安全性
  

• 手機客戶端作為主要的訪問入口，按需開放，及時關(guān)閉。
  

• 支持服務(wù)端間端口映射組網(wǎng)（v0.31及以后版本）。
  

• 電腦可以接入手機熱點或wifi環(huán)境下通過訪問手機開放的端口穿透到內(nèi)網(wǎng)進行訪問（客戶端會顯示手機ip）。
  

• 手機網(wǎng)絡(luò)一般為私有網(wǎng)段別人無法訪問。
  

• 用戶間隔離。
  

• 擴展性
  

• 基于內(nèi)網(wǎng)網(wǎng)段代理，可以配合眾多工具實現(xiàn)各種網(wǎng)絡(luò)服務(wù)能力（telnet、ssh、http服務(wù)、內(nèi)網(wǎng)攝像頭、遠程桌面等）
  

• 面向極客，可訪問自定義的內(nèi)網(wǎng)服務(wù)（rpc）
  

• 便利性
  

• 手機客戶端一點配置
  

• 服務(wù)能力動態(tài)增減
  

• 高性能
  

• 跨平臺實現(xiàn) socket 多路復(fù)用，支持：poll、epoll、kqueue、port、select、IOCP 等模型
  

• 采用 lock-free 算法
  

• 線程池設(shè)計
  

• socket 連接池
  

• 多級任務(wù)隊列
  

• ...
  

• 0.1.1版本開始采用自主網(wǎng)絡(luò)引擎，性能高，千元手機客戶端能支持1千以上的并發(fā)共享訪問
  

• 高性能設(shè)計：
  

smarGate有什么主要功能？

• 支持代理穿透
  

• 官方提供免費的代理服務(wù)器（共享帶寬，多人共用時比較慢，最佳實踐為啟用自有代理服務(wù)器）
  

• 如果自己有云服務(wù)器（具備公網(wǎng)ip），用戶可自定義自己的代理服務(wù)器，且在代理服務(wù)器上安裝proxy_server。所有數(shù)據(jù)傳輸走用戶配置的代理服務(wù)器（代理服務(wù)器需要證書，可自動生成也可配置已有證書）
  

  1、“代理服務(wù)器”配置如下（代理服務(wù)器必須允許任意端口“入站”連接）：

  <?xml version="1.0" encoding="GBK"?>     <app-config code="PROXY" name="proxy-server">         <app-parameter>         <proxy-service-port value="9001"/><!--自定義代理端口 --> <owner-id value="xxxx" /><!-- xxxx 為注冊成功返回的用戶ID --> <access-token value="nnnnn"/><!--訪問token，必須為數(shù)字【可選配】 --> <ssl-create-certfile value="true" /><!-- 如未用如下選項指定證書，則自動生成證書【必須確保安裝openssl】，默認為 false 代表無需自動生成 -->           <!-- 如果自己有證書及私鑰，則配置如下項，啟動安全的SSL通道，其中文件名需要配置正確；沒有證書則不需要配置，可啟用上面自動生成證書選項         <ssl-cacert-file value="xxx.crt"/>         <ssl-privatekey-file value="xxx.key"/>           -->        </app-parameter>        <moudle-parameter>         <log-level value="LOG_ERROR"/>         <log-write-mode value="CONSOLE_ONLY"/>       </moudle-parameter>   </app-config>

  2、"服務(wù)端"中增加如下配置：

......     <app-parameter>              <ssl-create-certfile value="true" />        <!-- 如果代理服務(wù)器啟動安全的SSL通道，這里必須配置證書及私鑰      <ssl-cacert-file value="xxx.crt"/>      <ssl-privatekey-file value="xxx.key"/>        -->     </app-parameter>     <moudle-parameter>       ......     </moudle-parameter>     <!-- 配置上述代理服務(wù)器的ip或域名+端口，注意：ip必須為公網(wǎng)IP。ssl選項必須配置正確，如果代理服務(wù)器有證書（包括自動生成證書）且生效則配置為true否則為false -->     <channel address="xxx.xxx.xxx.xxx:9001" ssl="true" token="nnnnn" /><!--訪問token，必須與代理服務(wù)器一致，如果沒有則不配 -->

• 支持p2p通道
  

  服務(wù)端 NAT	客戶端 NAT	P2P成功
  NAT1-3	NAT1-3	YES
  NAT1-2	NAT4	YES
  NAT4	NAT1-2	YES
  NAT4	NAT3-4	NO
  NAT3-4	NAT4	NO

• 使用TCP協(xié)議進行p2p穿透，提升安全性
  

• 不是所有的網(wǎng)絡(luò)都支持p2p，取決于兩端NAT類型

• v0.14以上版本，直接支持ipv6，且能提供防火墻穿透

• P2P測試結(jié)論：一端是NAT4，另一端是NAT3或NAT4時無法打通
  注：NAT1-〉Full Cone ， NAT2-〉Restricted Cone ， NAT3-〉Port Restricted Cone ， NAT4-〉Symmetric
  

• 支持外網(wǎng)發(fā)布（有違安全設(shè)計理念，v0.31版本開放）
  

• 其它內(nèi)網(wǎng)穿透工具的主推模式，將內(nèi)網(wǎng)服務(wù)直接映射到外網(wǎng)端口
  

• 支持服務(wù)端之間的P2P端口映射（v0.31及以后版本）
  

• 具體配置主要通過 ip@index方式支持
  

使用指南:

三方視頻教學(xué)- B站

使用實踐-度娘

使用實踐-google

1、下載app && 注冊新用戶

• 下載android app（app-release.apk包含客戶端和服務(wù)端）支持armv7及arm64 cpu架構(gòu)
  

• 注冊新用戶（邀請碼必填，為數(shù)字，可任意填。ps：如果必填信息未填完整,或包含中文字符，會注冊失敗）
  

• 注冊成功后請務(wù)必記住返回的服務(wù)ID(N) 【重要】：注冊成功后務(wù)必在1小時內(nèi)完成首次登錄
  

2、下載服務(wù)端 && 配置

• 下載內(nèi)網(wǎng)服務(wù)器適合的服務(wù)端版本（目前支持linux-x86-32/64，windows，及l(fā)inux-arm【樹莓派、群暉】,另：Android app自帶服務(wù)端模式）
  

• 解壓服務(wù)端壓縮包，修改配置文件(conf-proxy.xml):
  

3、運行內(nèi)網(wǎng)服務(wù)端(命令參數(shù)說明 i:最大接入連接數(shù),o:最大接出連接數(shù),w:最大線程數(shù))

• linux下執(zhí)行命令：chmod +x proxy_server && nohup ./proxy_server -i1000 -o1000 -w8 >/dev/null &
  

• windows下執(zhí)行命令：proxy_server.exe -i1000 -o1000 -w8
  

• Android 手機/設(shè)備：運行app -〉編輯模式下，配置服務(wù)端信息 -〉打開“服務(wù)端”開關(guān) -〉重啟app
  

• OpenWrt mips設(shè)備安裝請見：【MIPS linux下正確使用方式】
  

4、登陸手機app && 配置端口映射 【常用服務(wù)配置】

• 在客戶端中可以看到上線的服務(wù)端（“訪問點”），可以在客戶端上定義端口映射規(guī)則
  

5、電腦或手機可以直接訪問手機客戶端設(shè)置的服務(wù)（如ssh、http等）

補充說明:

• 所有版本已經(jīng)打包了依賴，開箱即用.
  

• 系統(tǒng)將自動清除30天以上未使用的“僵尸賬號”.
  

• Android 客戶端需要權(quán)限:
  

1、后臺執(zhí)行權(quán)限（如果不允許，則app進入后臺會斷開連接）
2、網(wǎng)絡(luò)訪問權(quán)限（基本權(quán)限）

• 手機設(shè)置 (Android):
  

1、設(shè)置 -> 無線及網(wǎng)絡(luò) -> WLAN -> 系統(tǒng)休眠保持連接 "允許" （否則，系統(tǒng)休眠會被斷連）
2、設(shè)置 -> 無線及網(wǎng)絡(luò) -> 移動網(wǎng)絡(luò) -> 高級 ->始終保持數(shù)據(jù)連接 "允許"

• Q：如何下載安裝 android app？
  

  1、用android手機瀏覽器打開 https://github.com/lazy-luo/smarGate/raw/master/app-release.apk
  2、彈出框中下載安裝
  網(wǎng)盤鏈接為最新測試版本，github上版本稍有滯后
  附網(wǎng)盤下載地址： https://pan.baidu.com/s/14Iq60kxHW711NVoCVKWySg
  gitee地址（速度快些，不會有圖片無法顯示問題）：https://gitee.com/lazy-luo/smarGate
  如有需要請?zhí)砑游⑿牛簑s_lzy008 注明：smarGate ，視情況組建技術(shù)討論群
  

• Q：需要訪問家中局域網(wǎng)多臺設(shè)備，是否每臺都需要安裝服務(wù)端？
  

  A：不需要，只需選擇任意一臺設(shè)備安裝服務(wù)端即可。
  

• Q：為何有時連接不上？
  

  A：服務(wù)端空閑約2-3分鐘，會自動斷開，須等待10秒左右重連。
  

• Q：ipv6為何無法P2P？
  

  A：請將客戶端及服務(wù)端更新到最新版本；確保手機與內(nèi)網(wǎng)電腦能獲取到全局ipv6地址；確保沒被防火墻攔截（windows）；排查兩個ipv6是否能路由出去；查看hosts文件確保hostname能解析到ipv6地址。
  

• Q：IPv4及IPv6的P2P連接為何沒有UDP端口？
  

  A：smarGate基于TCP協(xié)議進行P2P穿透，具備更好的安全性，及連接可靠性。
  

• Q：手機NAS客戶端為何無法登錄？
  

  A：確保手機NAS客戶端ip黑名單中沒有l(wèi)ocalhost（127.0.0.1）。
  

• Q：如何將異地公司內(nèi)網(wǎng)機器共享給多地團隊？
  

  A：手機連接wifi，讓團隊成員電腦連接手機IP：PORT，直接通過手機代理進行訪問。實測，2k以上的手機，可以帶上百人團隊共享訪問。
  

• Q：為何windows服務(wù)端沒有控制臺黑框？
  

  A：為了防止誤操作關(guān)閉服務(wù)端，新版本windows服務(wù)端采用后臺方式運行。如需關(guān)閉，請用“任務(wù)管理器”
  

• Q：P2P時流量是否還需要走中間代理？
  

  A：不需要，直接點對點連接，網(wǎng)速取決于你的客戶端及服務(wù)端所在網(wǎng)絡(luò)。
  

• Q：smarGate后臺運行是否很耗電？
  

  A：經(jīng)過長時間測試，按偶爾使用的頻次，耗電量和任意一個系統(tǒng)進程相近，極低；頻繁后臺使用情況，長時間“后臺”使用，整體耗電量等同于偶爾使用微信的耗電量。電源管理提示“后臺頻繁刷新。。?！?，不用管它，后臺傳輸數(shù)據(jù)都會有此提示，關(guān)鍵看耗電排名
  

• Q：smarGate連接優(yōu)先級規(guī)則？
  

  A：首選P2P連接，無P2P時使用自定義代理連接，無前兩者連接時使用官方代理連接。
  

• Q: 同一個用戶能否多處登錄 ？
  

  A: 可以多點登錄，但同一時刻只能有一個客戶端可以進行P2P；服務(wù)端單臺機器只能啟1個實例，服務(wù)端各實例配置確保序號不重復(fù)，否則將無法正常使用。
  

• Q: 服務(wù)端能否支持Android手機 ？
  

  A：v0.27版本Android app加入了“服務(wù)端模式”的支持。
  

• Q: 客戶端不同顏色表示啥意思？
  

  
  

最佳實踐

• 以下為推薦使用的最佳實踐，供參考：
  1、android客戶端設(shè)置為“自動登錄”，免除每次輸入用戶名/密碼的麻煩;
  2、android客戶端設(shè)置好后讓其在后臺運行，如果始終保持前臺會定時刷新，webview控件空耗電，你懂的;
  3、服務(wù)端始終保持后臺運行，安全放心，只有你自己才能訪問；
  ...使用場景...
  【家用攝像頭P2P直連】
  

免責(zé)申明

• 請您仔細閱讀以下申明，您在使用smarGate工具軟件，表明您對以下內(nèi)容的接受：
  1、嚴禁使用本軟件從事計算機黑客以及其他任何危害計算機信息網(wǎng)絡(luò)安全的行為;
  2、本軟件屬于正規(guī)網(wǎng)絡(luò)接入軟件，請合理，合法的使用；勿用于違反法律，道德及影響他人利益的活動；如果因用于非法用途，由此造成的不良后果，由用戶自行負責(zé)，本軟件開發(fā)者不承擔(dān)任何責(zé)任及損失。
  

捐助

如果您覺得 smarGate 對你有幫助，歡迎給予一定的捐助來維持項目的長期發(fā)展！
ps：捐贈建議附上注冊用戶名

附錄

<auto-update value="true" />

<app-parameter>   <ssl-create-certfile value="true" /> ... </app-parameter>

<app-parameter>   <ssl-tunnel-required value="first" /><!-- 取值有3個：none、first、only -->   ... </app-parameter>

<app-parameter>  <proxy-service-port value="9001"/>  <access-token value="nnnnn”"/>  <access-restricting value="xxxxx"/>  … </app-parameter>

<channel address="x.x.x.x:9001" ssl="true" token="nnnnn" />

 …… <moudle-parameter> <http-content-type-filter value="application/javascript" /> …… <moudle-parameter/> ……

 …… <moudle-parameter> <negotiation-port value="xxxxx" /> …… <moudle-parameter/> ……