270 lines
8.3 KiB
Markdown
270 lines
8.3 KiB
Markdown
|
||
# Proxy SDK 使用说明
|
||
|
||
支持以下平台:
|
||
- Android,`.arr`库
|
||
- IOS,`.framework`库
|
||
- Windows,`.dll`库
|
||
- Linux,`.so`库
|
||
|
||
proxy使用gombile实现了一份go代码编译为android和ios平台下面可以直接调用的sdk类库,
|
||
另外还为linux和windows提供sdk支持，基于这些类库,APP开发者可以轻松的开发出各种形式的代理工具。
|
||
|
||
# 下面分平台介绍SDK的用法
|
||
|
||
## Android SDK
|
||
|
||
[](https://github.com/snail007/goproxy-sdk-android/) []() [](https://github.com/snail007/goproxy-sdk-android/releases) [](https://github.com/snail007/goproxy-sdk-android/releases)
|
||
|
||
[点击下载Android-SDK](https://github.com/snail007/goproxy-sdk-android/releases)
|
||
在Android系统提供的sdk形式是一个后缀为.aar的类库文件,开发的时候只需要把arr类库文件引入android项目即可.
|
||
|
||
### Android-SDK使用实例
|
||
|
||
#### 1.导入包
|
||
|
||
```java
|
||
import snail007.proxy.Porxy
|
||
```
|
||
|
||
#### 2.启动一个服务
|
||
|
||
```java
|
||
String args="http -p :8080";
|
||
String err=Proxy.start(args);
|
||
if (!err.isEmpty()){
|
||
//启动失败
|
||
System.out.println("start fail,error:"+err);
|
||
}else{
|
||
//启动成功
|
||
}
|
||
```
|
||
#### 3.判断一个服务是否在运行
|
||
|
||
```java
|
||
String args="http -p :8080";
|
||
boolean isRunning=Proxy.isRunning(args);//这里传递http也可以,最终使用的就是args里面的第一个参数http
|
||
if(isRunning){
|
||
//正在运行
|
||
}else{
|
||
//没有运行
|
||
}
|
||
```
|
||
|
||
由于tclient和client服务的特性,目前这个方法对于服务tclient和client永远返回false.
|
||
|
||
#### 4.停止一个服务
|
||
|
||
```java
|
||
String args="http -p :8080";
|
||
Proxy.stop(args);//这里传递http也可以,最终使用的就是args里面的第一个参数http
|
||
//停止完毕
|
||
|
||
```
|
||
|
||
## IOS SDK
|
||
|
||
[](https://github.com/snail007/goproxy-sdk-ios/) []() [](https://github.com/snail007/goproxy-sdk-ios/releases) [](https://github.com/snail007/goproxy-sdk-ios/releases)
|
||
|
||
[点击下载IOS-SDK](https://github.com/snail007/goproxy-sdk-ios/releases)
|
||
在IOS系统提供的sdk形式是一个后缀为.framework的类库文件夹,开发的时候只需要把类库文件引入项目,然后调用方法即可.
|
||
|
||
### IOS-SDK使用实例
|
||
|
||
#### 导入包
|
||
|
||
```objc
|
||
#import <Proxy/Proxy.objc.h>
|
||
```
|
||
|
||
#### 2.启动一个服务
|
||
|
||
```objc
|
||
-(IBAction)doStart:(id)sender
|
||
{
|
||
NSString *args = @"http -p :8080";
|
||
NSString *error = ProxyStart(args);
|
||
|
||
if (error != nil && error.length > 0)
|
||
{
|
||
NSLog(@"start error %@",error);
|
||
}else{
|
||
NSLog(@"启动成功");
|
||
}
|
||
}
|
||
```
|
||
|
||
#### 3.判断一个服务是否在运行
|
||
|
||
```objc
|
||
-(IBAction)hasRunning:(id)sender;
|
||
{
|
||
NSString *args = @"http -p :8080";
|
||
if (ProxyIsRunning(args))//这里传递http也可以,最终使用的就是args里面的第一个参数http
|
||
{
|
||
NSLog(@"正在运行");
|
||
}else{
|
||
NSLog(@"没有运行");
|
||
}
|
||
}
|
||
```
|
||
|
||
由于tclient和client服务的特性,目前这个方法对于服务tclient和client永远返回false.
|
||
|
||
#### 4.停止一个服务
|
||
|
||
```objc
|
||
-(IBAction)doStop:(id)sender
|
||
{
|
||
NSString *args = @"http -p :8080";
|
||
ProxyStop(args);//这里传递http也可以,最终使用的就是args里面的第一个参数http
|
||
//停止完毕
|
||
}
|
||
```
|
||
|
||
|
||
## Windows SDK
|
||
[](https://github.com/snail007/goproxy-sdk-windows/) []() [](https://github.com/snail007/goproxy-sdk-windows/releases) [](https://github.com/snail007/goproxy-sdk-windows/releases)
|
||
|
||
[点击下载Windows-SDK](https://github.com/snail007/goproxy-sdk-windows/releases)
|
||
在Windows系统提供的sdk形式是一个后缀为.dll的类库文件,开发的时候只需要把dll类库文件加载,然后调用方法即可.
|
||
|
||
### Windows-SDK使用实例
|
||
C++示例，不需要包含头文件，只需要加载proxy-sdk.dll即可，ieshims.dll需要和proxy-sdk.dll在一起。
|
||
作者：[yjbdsky](https://github.com/yjbdsky)
|
||
|
||
```cpp
|
||
#include <stdio.h>
|
||
#include<stdlib.h>
|
||
#include <string.h>
|
||
#include<pthread.h>
|
||
#include<Windows.h>
|
||
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
typedef char *(*GOSTART)(char *s);
|
||
typedef char *(*GOSTOP)(char *s);
|
||
typedef int(*GOISRUN)(char *s);
|
||
HMODULE GODLL = LoadLibrary("proxy-sdk.dll");
|
||
|
||
char * Start(char * p)
|
||
{
|
||
if (GODLL != NULL)
|
||
{
|
||
GOSTART gostart = *(GOSTART)(GetProcAddress(GODLL, "Start"));
|
||
if (gostart != NULL){
|
||
printf("%s\n", p);
|
||
char *ret = gostart(p);
|
||
return ret;
|
||
}
|
||
}
|
||
return "Cannot Find dll";
|
||
}
|
||
char * Stop(char * p)
|
||
{
|
||
if (GODLL != NULL)
|
||
{
|
||
GOSTOP gostop = *(GOSTOP)(GetProcAddress(GODLL, "Stop"));
|
||
if (gostop != NULL){
|
||
printf("%s\n", p);
|
||
char *ret = gostop(p);
|
||
return ret;
|
||
}
|
||
}
|
||
return "Cannot Find dll";
|
||
}
|
||
|
||
int IsRunning(char * p)
|
||
{
|
||
|
||
if (GODLL != NULL)
|
||
{
|
||
GOISRUN isrun = *(GOISRUN)(GetProcAddress(GODLL, "IsRunning"));
|
||
if (isrun != NULL){
|
||
int ret = isrun(p);
|
||
return ret;
|
||
}
|
||
FreeLibrary(GODLL);
|
||
}
|
||
return 0;
|
||
}
|
||
|
||
int main()
|
||
{
|
||
char *p = "http -t tcp -p :38080";
|
||
printf("This is demo application.\n");
|
||
char *str = "http -t tcp -p :38080";
|
||
//启动服务,返回空字符串说明启动成功;返回非空字符串说明启动失败,返回的字符串是错误原因
|
||
printf("start result %s\n", Start(str));
|
||
//停止服务,没有返回值
|
||
Stop(str);
|
||
//服务是否在运行,返回0是没有运行,返回1正在运行
|
||
printf("is running result %d\n", IsRunning(str));
|
||
return 0;
|
||
}
|
||
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
```
|
||
|
||
## Linux SDK
|
||
[](https://github.com/snail007/goproxy-sdk-linux/) []() [](https://github.com/snail007/goproxy-sdk-linux/releases) [](https://github.com/snail007/goproxy-sdk-linux/releases)
|
||
|
||
[点击下载Linux-SDK](https://github.com/snail007/goproxy-sdk-linux/releases)
|
||
在Linux系统提供的sdk形式是一个后缀为.so的类库文件,开发的时候只需要把so类库加载,调用方法即可.
|
||
|
||
### Linux-SDK使用实例
|
||
Linux下面使用的sdk是so文件即proxy-sdk.so,下面写一个简单的C程序示例,调用so库里面的方法.
|
||
|
||
`vi test-proxy.c`
|
||
|
||
```c
|
||
#include <stdio.h>
|
||
#include "proxy-sdk.h"
|
||
|
||
int main() {
|
||
printf("This is demo application.\n");
|
||
char *str = "http -t tcp -p :38080";
|
||
//启动服务,返回空字符串说明启动成功;返回非空字符串说明启动失败,返回的字符串是错误原因
|
||
printf("start result %s\n",Start(str));
|
||
//停止服务,没有返回值
|
||
Stop(str);
|
||
//服务是否在运行,返回0是没有运行,返回1正在运行
|
||
printf("is running result %d\n",IsRunning(str));
|
||
return 0;
|
||
}
|
||
```
|
||
|
||
#### 编译test-proxy.c ####
|
||
`export LD_LIBRARY_PATH=./ && gcc -o test-proxy test.c proxy-sdk.so`
|
||
|
||
#### 执行 ####
|
||
`./test-proxy`
|
||
|
||
|
||
### 关于服务
|
||
proxy的服务有11种,分别是:
|
||
|
||
```shell
|
||
http
|
||
socks
|
||
sps
|
||
tcp
|
||
udp
|
||
bridge
|
||
server
|
||
client
|
||
tbridge
|
||
tserver
|
||
tclient
|
||
```
|
||
每个服务只能启动一个,如果相同的服务启动多次,那么之前的服务会被停掉,后面启动的服务覆盖之前的服务.
|
||
上面这些服务的具体使用方式和具体参数,可以参考[proxy手册](https://github.com/snail007/goproxy/blob/master/README_ZH.md)
|
||
sdk里面的服务不支持手册里面的：--daemon和--forever参数.
|
||
|
||
|