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

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

• cpu架構，支持x86、arm、mips、riscv（tob：alpha、PowerPC、SPRAC）
  

• 注重安全，“內網”到“內網”的穿透，無需映射任何端口到外網，不更改任何防火墻配置
  

• 注重帶寬，”4G手機+v6寬帶“采用P2P方式訪問內網服務（基于TCP協議，v4支持NAT1-3穿透）
  

• 注重節約，無需購買vps、無需公網IP；家中淘汰Android手機可做服務器
  

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

• 注重可控，客戶端一點配置，且隨時隨地控制服務開啟/關閉
  

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

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

• ......如果這都是你想要的！請耐心繼續往下看；如果你還想要...請提issue，【更新歷史】也有看頭哦
  

• 免費，測試穩定后考慮開源.
  

• 包含一個android客戶端和需內網安裝的服務端.
  

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

• 必須配置“允許后臺運行”權限，否則切后臺即被系統斷連

• 必須配置“休眠時始終保持網絡連接”，否則一旦休眠則被系統斷連

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

• 可以配置“麥克風”權限，否則Android服務端無法提供語音監聽功能（v0.30及后續版本）

• 注意：SG官方代理不提供到港澳臺及國外IP的數據轉發

smarGate是什么？

官方命名為“移動網關”，通過手機客戶端將位于內網的服務端網絡進行按需暴露，核心引擎采用c++實現。

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

具備如下技術特點：

• 安全性
  

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

• 支持服務端間端口映射組網（v0.31及以后版本）。
  

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

• 手機網絡一般為私有網段別人無法訪問。
  

• 用戶間隔離。
  

• 擴展性
  

• 基于內網網段代理，可以配合眾多工具實現各種網絡服務能力（telnet、ssh、http服務、內網攝像頭、遠程桌面等）
  

• 面向極客，可訪問自定義的內網服務（rpc）
  

• 便利性
  

• 手機客戶端一點配置
  

• 服務能力動態增減
  

• 高性能
  

• 跨平臺實現 socket 多路復用，支持：poll、epoll、kqueue、port、select、IOCP 等模型
  

• 采用 lock-free 算法
  

• 線程池設計
  

• socket 連接池
  

• 多級任務隊列
  

• ...
  

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

• 高性能設計：
  

smarGate有什么主要功能？

• 支持代理穿透
  

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

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

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

  <?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，必須為數字【可選配】 --> <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、"服務端"中增加如下配置：

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

• 支持p2p通道
  

  服務端 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協議進行p2p穿透，提升安全性
  

• 不是所有的網絡都支持p2p，取決于兩端NAT類型

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

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

• 支持外網發布（有違安全設計理念，v0.31版本開放）
  

• 其它內網穿透工具的主推模式，將內網服務直接映射到外網端口
  

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

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

使用指南:

三方視頻教學- B站

使用實踐-度娘

使用實踐-google

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

• 下載android app（app-release.apk包含客戶端和服務端）支持armv7及arm64 cpu架構
  

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

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

2、下載服務端 && 配置

• 下載內網服務器適合的服務端版本（目前支持linux-x86-32/64，windows，及linux-arm【樹莓派、群暉】,另：Android app自帶服務端模式）
  

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

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

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

• windows下執行命令：proxy_server.exe -i1000 -o1000 -w8
  

• Android 手機/設備：運行app -〉編輯模式下，配置服務端信息 -〉打開“服務端”開關 -〉重啟app
  

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

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

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

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

補充說明:

• 所有版本已經打包了依賴，開箱即用.
  

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

• Android 客戶端需要權限:
  

1、后臺執行權限（如果不允許，則app進入后臺會斷開連接）
2、網絡訪問權限（基本權限）

• 手機設置 (Android):
  

1、設置 -> 無線及網絡 -> WLAN -> 系統休眠保持連接 "允許" （否則，系統休眠會被斷連）
2、設置 -> 無線及網絡 -> 移動網絡 -> 高級 ->始終保持數據連接 "允許"

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

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

• Q：需要訪問家中局域網多臺設備，是否每臺都需要安裝服務端？
  

  A：不需要，只需選擇任意一臺設備安裝服務端即可。
  

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

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

• Q：ipv6為何無法P2P？
  

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

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

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

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

  A：確保手機NAS客戶端ip黑名單中沒有localhost（127.0.0.1）。
  

• Q：如何將異地公司內網機器共享給多地團隊？
  

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

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

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

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

  A：不需要，直接點對點連接，網速取決于你的客戶端及服務端所在網絡。
  

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

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

• Q：smarGate連接優先級規則？
  

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

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

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

• Q: 服務端能否支持Android手機 ？
  

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

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

  
  

最佳實踐

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

免責申明

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

捐助

如果您覺得 smarGate 對你有幫助，歡迎給予一定的捐助來維持項目的長期發展！
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/> ……