Skip to content

Latest commit

 

History

History
103 lines (98 loc) · 6.46 KB

readme.cn.md

File metadata and controls

103 lines (98 loc) · 6.46 KB

移动网关

提供内网穿透能力，通过加密隧道，能安全的将内网服务暴露出来.
支持p2p通讯（p2p通道可用时显示为绿色）
支持自定义代理服务器
免费，测试稳定后考虑开源.
包含一个android客户端和需内网安装的服务端.

samrGate是什么？

官方命名为“移动网关”，通过手机客户端将位于内网的服务端网络进行按需暴露。
具备如下特点：

  • 安全性
  • 手机客户端作为唯一的访问入口，按需开放，及时关闭。
  • 电脑可以接入手机热点或wifi环境下通过访问手机开放的端口穿透到内网进行访问（客户端会显示手机ip）。
  • 手机网络一般为私有网段别人无法访问。
  • 用户间隔离（共享能力暂未实现）。
  • 扩展性
  • 基于内网网段代理，可以配合众多工具实现各种网络服务能力（telnet、ssh、http服务、内网摄像头、远程桌面等）
  • 面向极客，可访问自定义的内网服务（rpc）
  • 便利性
  • 手机客户端一点配置
  • 服务能力动态增减

“移动网关”是用户私有网关，所有共享访问入口都在客户端，不是类似其它穿透工具主推的面向域名的公共访问入口

samrGate有什么技术特点？

  • 支持代理穿透
  • 官方提供免费的代理服务器（共享带宽，多人共用时比较慢，最佳实践为启用自有代理服务器）
  • 如果自己有云服务器（具备公网ip），用户可自定义自己的代理服务器，且在代理服务器上安装proxy_server。所有数据传输走用户配置的代理服务器（为了防止中间人攻击，代理服务器需要用户生成自签名证书） 。“代理服务器”配置如下：
  <?xml version="1.0" encoding="GBK"?>
    <app-config code="PROXY" name="proxy-server">
        <app-parameter>
	        <proxy-service-port value="9001"/><!--自定义代理端口 -->
          <!-- 如果自己有证书及私钥，则配置如下项，启动安全的SSL通道，其中文件名需要配置正确；没有证书则不需要配置，启用普通tcp连接
	        <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>

服务端中增加如下配置：

......
    <moudle-parameter>
      ......
      <!-- 配置上述代理服务器的ip或域名+端口，注意：ip必须为公网IP。ssl选项必须配置正确，如果代理服务器有证书且生效则配置为true否则为false -->
      <channel address="xxx.xxx.xxx.xxx:9001" ssl="false" />
    </moudle-parameter>
  • 支持p2p通道
  • 使用TCP协议进行p2p穿透，提升安全性
  • 不是所有的网络都支持p2p，取决于两端NAT类型

已知问题

  • 客户端采用webview控件，在android下启动时内存占用较多，后续版本计划用native界面，预计内存占用可降低到50m左右

使用指南:

1、下载android客户端（app-release.apk）支持armv7及arm64 cpu架构

2、注册新用户（邀请码必填，为数字，可任意填。ps：如果信息未填完整，部分用户反馈会注册失败）

login
register

3、注册成功后请务必记住返回的服务ID(N)

register result

4、下载内网服务器适合的服务端版本（目前支持linux-x86-32/64，windows，及linux-arm【树莓派、群晖】）

5、解压服务端压缩包，修改配置文件(conf-proxy.xml):

  <?xml version="1.0" encoding="GBK"?>
    <app-config code="PROXY" name="proxy-server">
       <moudle-parameter>
        <log-level value="LOG_ERROR"/>
        <log-write-mode value="CONSOLE_ONLY"/>
        <app-name value="xxxxx [name of service points]." /><!-- need modify -->
        <app-description value="yyyyy [description of service points]" /><!-- need modify -->
        <server-address value="visery.net:39001"/>
        <user-audit value="N:index"/><!-- need modify (N 为注册成功返回的服务ID，index为自定义的服务端实例序号，建议从1开始，不能重复. 例如:[12345:1])-->
    </moudle-parameter>
  </app-config>

6、执行命令： "nohup ./proxy_server -i1000 -o1000 -w8 >/dev/null &"(参数说明 i:最大接入连接数,o:最大接出连接数,w:最大线程数，执行命令前确保为 proxy_server 添加执行权限：chmod +x proxy_server )

7、使用注册时的用户名/密码登陆手机客户端

operator

8、在客户端中可以看到上线的服务端，可以在客户端上定义端口反弹规则

operator

配置中的“远程ip”为“访问点”对应内网中的某台主机ip（localhost或127.0.0.1代表内网server端所在机器本身）

operator

9、电脑或手机可以直接访问手机客户端设置的服务（如ssh、http等）

补充说明:

  • 所有版本已经打包了依赖，开箱即用.
  • 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、弹出框中下载安装

附网盘下载地址： https://pan.baidu.com/s/14Iq60kxHW711NVoCVKWySg

如有需要请添加微信：ws_lzy008 注明：smarGate ，视情况组建技术讨论群