Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dosgo/ngrok-c
ngrok client for c language,Due to the use of GO ngrok language development, porting to embedded devices some inconvenience, such as openwrt, so use C language rewrite a client. Very mini, the need to support polarssl library.
https://github.com/dosgo/ngrok-c
Last synced: about 2 months ago
JSON representation
ngrok client for c language,Due to the use of GO ngrok language development, porting to embedded devices some inconvenience, such as openwrt, so use C language rewrite a client. Very mini, the need to support polarssl library.
- Host: GitHub
- URL: https://github.com/dosgo/ngrok-c
- Owner: dosgo
- License: mit
- Created: 2015-03-04T05:51:22.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2023-11-30T01:10:16.000Z (10 months ago)
- Last Synced: 2024-02-15T17:30:53.875Z (7 months ago)
- Language: C
- Size: 18.4 MB
- Stars: 497
- Watchers: 53
- Forks: 213
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-hacking-lists - dosgo/ngrok-c - ngrok client for c language,Due to the use of GO ngrok language development, porting to embedded devices some inconvenience, such as openwrt, so use C language rewrite a client. Very mini, the need to (C)
README
## ngrok-c
- the client of ngrok in language C
- Before compiling, you need to generate the libpolarssl.a static library(via polarssl official website).
- contact me via email: [email protected]
不会编译的伙伴可以用，hauntek大神写的python版本，https://github.com/hauntek/python-ngrok
# openwrt 编译方法。
- 看教程http://www.jianshu.com/p/8428949d946c
- 另外还需要在mbedtls-lib子目录中以同样方法修改并执行build.sh，并将编译生成的三个.a静态库文件拷贝至上层目录中
## build
ddns.cpp and https.cpp are abandoned
# windows
run Build.bat in CLI.
# linux
run build.sh instead of makefile
# openwrt
run openwrtbuild.sh
# tomatoware
### openssl
cp Makefile.openssl.static Makefile
make
### mbedTLS
Compile and install mbedTLS into tomatoware first, then:
cp Makefile.mbedtls.static Makefile
make
## 使用说明
命令
ngrok-polarssl -SER[Shost:ngrokd.ngrok.com,Sport:443,Atoken:xxx] -AddTun[Type:http,Lhost:127.0.0.1,Lport:80,Sdname:xxdosgo]
Shost -Server host. //服务器host
Sport -server port. //服务器端口
Atoken -ngrok authtoken. //服务器认证串
type -tcp or http or https. //要映射的类型，tcp,http,https
Lhost -local address. //本地地址，如果是本机直接127.0.0.1
Lport -local port. //本地端口
sdname -Subdomain. //子域名
Hostname -hostname //自定义域名映射
Rport -remote port //远程端口，tcp映射的时候，制定端口使用。
## Example
- ngrokc -SER[Shost:ngrokd.ngrok.com,Sport:443] -AddTun[Type:http,Lhost:127.0.0.1,Lport:80,Sdname:Example]
- ngrokc -AddTun[Type:http,Lhost:127.0.0.1,Lport:80,Sdname:Example]
You can also register multiple Tunnel, but can only have one of each type.
- ngrokc -AddTun[Type:http,Lhost:127.0.0.1,Lport:80,Sdname:Example] -AddTun[Type:https,Lhost:127.0.0.1,Lport:81,Sdname:Example1]
## 2015/7/10更新增加
- 如，你只要把xx.xxx.org解析到tunnel.mobi，那么访问xx.xxx.org就可以了..比Sdname好。。
ngrokc.exe -SER[Shost:tunnel.mobi,Sport:44433] -AddTun[Type:http,Lhost:127.0.0.1,Lport:80,Hostname:xx.xxx.org] -AddTun[Type:tcp,Lhost:127.0.0.1,Lport:80,Rport:55556]
- 有空的话增加openssl的支持
- 感谢981213的makefile文件
- 感谢maz-1 修复ubuntu下编译bug
## 2015/7/28更新
- 增加openssl支持，
- 如果编译openssl版本，修改config.h文件把define OPENSSL 改为1,
- 如果编译polarssl版本，修改config.h文件把define OPENSSL 改为0,
## 2015/8/4
- make -f Makefile.openssl编译openssl版本
- make -f Makefile.polarssl编译polarssl版本
- openssl版本有bug，运行久了会崩溃...慎用。。
## 2015/10/7
- 增加PolarSSL v2.0.0++版本兼容
### 注意如果编译polarssl版本
如果你使用的PolarSSL 版本是v2.0.0及其以上的版本编译，请把config.h文件的define ISMBEDTLS 改为1
## 2015/10/17
- 修复内存泄漏
- 增加编译详细说明
- 发现bug，路由上CPU偶尔9%,暂未修复。
## 2015/10/20
- 大幅减少内存占用
- 如无重大bug，不更新了。。
-
## 2015/11/5
- 修复没网导致的内存泄漏问题。会导致路由不断重启
- 增加版本号。
## 2015/12/8
- 做些小优化，避免嵌入式设备，栈溢出，主要是嵌入式设备栈内存太小。。多个连接就会导致崩溃。
- 对了，记得编译的时候用-O2参数，不然这些，优化完全无效。。电脑可以忽略，但是嵌入式设备，记得用，我的8M，20个连接就溢出了。优化以后没测试，感觉没那么脆弱了。。
## 2015/12/13
- 修复一个古老的bug,10月份以后的版本都有这问题,如果是，请务必升级到最新版本，加载速度大幅提升。
## 2015/12/20
- 关闭。。tcp缓存区。。以修复http连接，保存失败问题。
- 打开tcp keepalive避免死链问题。
- 这个版本相对完善，没啥，大问题了。。不更新了。
## 2015/12/30
- 修复一个超长url在大端下,无法使用的bug。
## 2016/3/12
- 增加http://www.ngrok.cc/服务器支持
## 2016/3/29
- 增加openssl库动态加载，以方便编译openwrt版本。
- 增加openwrt傻瓜编译教程。
- 关于需要luci界面的，恩山有大神写了。我提交了。叫luci-app-ngrokc_git-15.290.16504-8c2fd44-1_all.ipk,下载安装好以后把编译好的ngrokc替换/usr/bin/里面的ngrokc，改权限，重启就可以了。。
## 2016/3/31
- 修复openssl版本连接不了sslv2服务器问题。
## 2016/4/4
- 去掉线程减少内存占用。
- 修改发送接收缓存区大小，避免阻塞。
## 2016/04/19
- 修复一个bug，增大缓存区。
- 大幅减少CPU消耗，一般10%以下
## 2016/04/20
- 修复1.22版本的polarssl下的bug，如果你使用的是ngrokc1.22版本，请更新，那个版本有重大bug，openssl版本没问题。
- 全部建议到1.24稳定版本。
## 2016/04/25
-1.25 版本（测试）增加多个通道功能，避免多个进程，可以注册N个通道，如- ngrokc -AddTun[Type:http,Lhost:127.0.0.1,Lport:80,Sdname:Example] -AddTun[Type:http,Lhost:127.0.0.1,Lport:80,Sdname:Example1] -AddTun[Type:http,Lhost:127.0.0.1,Lport:80,Sdname:Example2]
- 这是一个支持ngrok完全协议的版本。go语言以后可能员生支持mips，这个就没人用了。可能不更新了。
## 2016/05/2
-1.32稳定版本，修复1.25版本tcp映射出错问题。修复1.25的崩溃bug。
## 2016/05/11
-1.33版本 修复重连子域名bug。
## 2016/05/25
-1.37版本 修复一个崩溃bug，建议所有的都升级到这个版本。
## 2016/07/26
-1.39版本 为了增加自定义cid。其它没用
## 2016/10/27
-1.40版本 增加password功能支持。
## 2016/11/26
准备新功能开发，UDP端口映射功能，有没有有兴趣的，一起开发，目前最大的问题在于，我的go语言很烂，别指望官方会加这功能，自己自己动手，又兴趣的加群192182463（QQ群）
## 2017/1/9
-1.41版本 修复一个网络不好可能导致的内存泄漏问题。
## 2018/5/7
-1.45版本 增加自定义转发Hostheader功能。用于那些本地会判断host的网站
使用方法-AddTun[Type:http,Lhost:127.0.0.1,Lport:80,Hostheader:localhost]
## 2019/07/28
-1.53 add support openssl 1.1。
## 2019/11/2
-1.54 add support http basic auth。
Example -AddTun[Type:http,Lhost:127.0.0.1,Lport:80,Httpauth:"test:test"]
## 2019/11/2
-1.54 add support http basic auth。
Example -AddTun[Type:http,Lhost:127.0.0.1,Lport:80,Httpauth:"test:test"]
## 2021/8/31
-1.55 add support local tls。
Example -AddTun[Type:https,Lhost:127.0.0.1,Lport:443,Ltls:1]
### 关于编译对应路由的版本的ngrokc。
## 一。去http://downloads.openwrt.org/下载你路由对应的SDK版本 ，如OpenWrt-SDK-ar71xx-for-linux-x86_64-gcc-4.8-linaro_uClibc-0.9.33.2.tar.bz2，并且解压。
## 二.需要先编译polarssl或者openssl库（取决你想用啥库,2选1）。
- 1.编译polarssl库
- 去https://tls.mbed.org/download-archive下载，polarssl版本，然后解压
- 再把buildlib.sh复制进去，并且修改export STAGING_DIR export PATH,把里面的路径改成你下载的SDK，所在的目录，注意是staging_dir目录对应STAGING_DIR，bin目录对应PATH。
- 还得修改CC=mips-openwrt-linux-gcc CXX=mips-openwrt-linux-g++ AR=mips-openwrt-linux-ar RANLIB=mips-openwrt-linux-ranlib,把这些参数分别对应你的，编译器。名称。。
- 然后执行，buildlib.sh
- 如果一切顺利的话，就会在library目录下生成，2.0版本（libmbedtls.a libmbedcrypto.a libmbedx5.9.a）1.3版本（libpolarssl.a）
- 这就编译好了polarssl库。
- 2.编译 openssl库
- 去https://www.openssl.org/source/ 下载openssl，然后解压。
- 再把buildlib.sh复制进去，并且修改export STAGING_DIR export PATH,把里面的路径改成你下载的SDK，所在的目录，注意是staging_dir目录对应STAGING_DIR，bin目录对应PATH。
- 然后执行，buildlib.sh
- 如果一切顺利的话，就会在当前目录下生成，libssl.a,libcrypto.a
- 这就编译好了openssl库库。
## 三.编译ngrokc
- 1.openssl版本
- 把下载的openssl里面的include/openssl，文件夹复制到，你SDK里面的staging_dir/toolchain-mips_r2_gcc-4.6-linaro_uClibc-0.9.33.2/include里面，（可能根据SDK路径有所不同）。
- 然后把第二步生成的，libssl.a,libcrypto.a,放到ngrok-c目录。
- 再修改，ngrok-c里面的config.h，#define OPENSSL 0，改成#define OPENSSL 1;
- 继续修改openwrtbuild.sh文件export STAGING_DIR export PATH,把里面的路径改成你下载的SDK，所在的目录，注意是staging_dir目录对应STAGING_DIR，bin目录对应PATH。
- 还有，最后一行的libpolarssl-mips.a改成libssl.a,libcrypto.a.
- 执行openwrtbuild.sh，就行了。。
- 就会在build-mips生成ngrokc文件。。你用ssh，上传到路由的/bin目录，并且加入执行权限。。就可以了。。跑了。。
- 2.polarssl版本
- 把下载的polarssl里面的include/polarssl，或者include/mbedtls 文件夹复制到，你SDK里面的staging_dir/toolchain-mips_r2_gcc-4.6-linaro_uClibc-0.9.33.2/include里面，（可能根据SDK路径有所不同）。
- 然后把第二步生成的，2.0版本（libmbedtls.a libmbedcrypto.a libmbedx5.9.a）1.3版本（libpolarssl.a）放到ngrok-c目录。
- 再修改，ngrok-c里面的config.h，#define OPENSSL 1，改成#define OPENSSL 0，如你的是2.0版本，请ISMBEDTLS 0改成ISMBEDTLS 1，如果是1.3，ISMBEDTLS 0
- 继续修改openwrtbuild.sh文件export STAGING_DIR export PATH,把里面的路径改成你下载的SDK，所在的目录，注意是staging_dir目录对应STAGING_DIR，bin目录对应PATH。
- 还有，最后一行的libpolarssl-mips.a改成2.0版本（libmbedtls.a libmbedcrypto.a libmbedx5.9.a）1.3版本（libpolarssl.a）.
- 执行openwrtbuild.sh，就行了。。
- 就会在build-mips生成ngrokc文件。。你用ssh，上传到路由的/bin目录，并且加入执行权限。。就可以了。。跑了。。
- 3.这里用Centos7 编译斐讯K2路由(polarssl库)做个(纯小白)教程
###安装相应软件包
yum install bzip2 gzip git vim wget -y
###下载并解压SDK(以下没说明的话均默认在/root目录下操作)
wget http://archive.openwrt.org/chaos_calmer/15.05/ramips/mt7621/OpenWrt-SDK-15.05-ramips-mt7621_gcc-4.8-linaro_uClibc-0.9.33.2.Linux-x86_64.tar.bz2
tar jxvf OpenWrt-SDK-15.05.1-ramips-mt7621_gcc-4.8-linaro_uClibc-0.9.33.2.Linux-x86_64.tar.bz2
###文件夹名字太长，改个名字....
mv OpenWrt-SDK-15.05.1-ramips-mt7621_gcc-4.8-linaro_uClibc-0.9.33.2.Linux-x86_64 op
###拉取ngrok源码
git clone https://github.com/dosgo/ngrok-c.git
###开始编译polarsshl库###
###下载并解压polarssl
wget https://tls.mbed.org/download/mbedtls-2.14.1-gpl.tgz&&tar zxvf mbedtls-2.14.1-gpl.tgz
###复制buildlib.sh文件到polarssl文件夹
cp /root/ngrok-c/buildlib.sh /root/mbedtls-2.14.1/buildlib.sh
###修改buildlib.sh
vim /root/mbedtls-2.14.1/buildlib.sh
###我这里SDK是这个所以把PATH改成这个
###export PATH=$PATH:'/root/op/staging_dir/toolchain-mipsel_1004kc+dsp_gcc-4.8-linaro_uClibc-0.9.33.2/bin'
###export STAGING_DIR="/root/op/staging_dir"
###下面的SDK编译器名字可以在SDK/bin 下找到，例如:
### ls /root/op/staging_dir/toolchain-mipsel_1004kc+dsp_gcc-4.8-linaro_uClibc-0.9.33.2/bin
###看到一些gcc和g++之类的，把名字复制替换掉就行了
###运行buildlib.sh
cd /root/mbedtls-2.14.1&&chmod 777 buildlib.sh&&./buildlib.sh
###不出意外的话会在library文件夹生成三个文件libmbedcrypto.a,libmbedtls.a,libmbedx509.a
###把生成的文件复制到ngrok目录下
cd /root/mbedtls-2.14.1/library
cp {libmbedcrypto.a,libmbedtls.a,libmbedx509.a} /root/ngrok-c/
###复制mbedtls文件夹到SDK/include下
cp -r /root/mbedtls-2.14.1/include/mbedtls /root/op/staging_dir/toolchain-mipsel_1004kc+dsp_gcc-4.8-linaro_uClibc-0.9.33.2/include/
###修改config.h文件，我们用的是polarssl2.0 所以把 #define OPENSSL 1，改成#define OPENSSL 0；#define ISMBEDTLS 0改成#define ISMBEDTLS 1(其实默认就是1.....)
vim /root/ngrok-c/config.h
###修改openwrtbuild.sh里面 SDK路径和编译器，SDK路径上边说了就不再重复，这里的编译器改成上面编译polarssh时buildlib.sh里的那个CXX的值
###我这里是CXX=mipsel-openwrt-linux-g++，所以openwrtbuild.sh的CC=mipsel-openwrt-linux-g++
vim /root/ngrok-c/openwrtbuild.sh
###修改CC=mipsel-openwrt-linux-g++，保存退出
cd /root/ngrok-c/
chmod 777 openwrtbuild.sh&&./openwrtbuild.sh
###执行完openwrtbuild.sh如果没有提示erroe的话就行了。。。
###然后会在build-mips生成ngrokc文件。。你用ssh，上传到路由的/bin目录，并且加入执行权限
###下面在SSH连接到路由后的操作
###记得安装，libstdcpp.ipk，官网有下载，我这个SDK对应的下载地址是
wget http://archive.openwrt.org/chaos_calmer/15.05/ramips/mt7621/packages/base/libstdcpp_4.8-linaro-1_ramips_1004kc.ipk
###安装
opkg install libstdcpp_4.8-linaro-1_ramips_1004kc.ipk
安装完就可以用了。。。。。
（小声BB:作者很有耐心，纯小白问一下很愚蠢的问题他都会耐心解答，哈哈，再次感谢dosgo）
## 四.简单编译ngrokc。
1. 去http://downloads.openwrt.org/下载你路由对应的SDK版本 ，如OpenWrt-SDK-ar71xx-for-linux-x86_64-gcc-4.8-linaro_uClibc-0.9.33.2.tar.bz2，并且解压。
2.编辑openwrtbuildv2.sh 修改export STAGING_DIR export PATH,把里面的路径改成你下载的SDK。
3. 把openssl.zip解压到你的下载的sdk,/xxx/OpenWrt-SDK/staging_dir/toolchain-mips_r2_gcc-4.6-linaro_uClibc-0.9.33.2/include目录下，
4. 运行编辑openwrtbuildv2.sh,就会在build-mips生成一个叫ngrokc的文件。成功了。。把它复制到bin目录。就可以运行ngrokc了。
5.记得安装，libopenssl.ipk，官网有下载。
## 五.zig交叉编译ngrokc。
1. 去https://ziglang.org/download/下载zig编译器并且安装好，
2. 修改crossbuild.bat文件的TARGET=mipsel-linux-musl改成你的平台。
3. 运行crossbuild.bat就会在当前目录生成编译文件。
4. 记得安装，libopenssl.ipk，官网有下载。
编译就这样了，以后请不要邮件问我怎么编译了，有bug可以联系。
现在tunnel.mobi不能用了。。，哪里还有国内的服务器的。。