Skip to content

Commit

Permalink
update to 4.0
Browse files Browse the repository at this point in the history
  • Loading branch information
ottomao committed Dec 1, 2017
1 parent e392fef commit 4be5aa8
Show file tree
Hide file tree
Showing 267 changed files with 26,986 additions and 84,460 deletions.
7 changes: 7 additions & 0 deletions .eslintignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
node_modules
dist
web
web2
resource
*.sh
docs
75 changes: 75 additions & 0 deletions .eslintrc
Original file line number Diff line number Diff line change
@@ -0,0 +1,75 @@
{
"extends": "airbnb",
"parser": "babel-eslint",
"env": {
"browser": true,
"node": true,
"es6": true,
"jasmine": true
},
"globals": {
"React": true,
"ReactDOM": true,
"Zepto": true,
"JsBridgeUtil": true
},
"rules": {
"semi": [0],
"comma-dangle": [0],
"global-require": [0],
"no-alert": [0],
"no-console": [0],
"no-param-reassign": [0],
"max-len": [0],
"func-names": [0],
"no-underscore-dangle": [0],
"no-unused-vars": ["error", { "vars": "all", "args": "none", "ignoreRestSiblings": false }],
"object-shorthand": [0],
"arrow-body-style": [0],
"no-new": [0],
"strict": [0],
"no-script-url": [0],
"spaced-comment": [0],
"no-empty": [0],
"no-constant-condition": [0],
"no-else-return": [0],
"no-use-before-define": [0],
"no-unused-expressions": [0],
"no-class-assign": [0],
"new-cap": [0],
"array-callback-return": [0],
"prefer-template": [0],
"no-restricted-syntax": [0],
"no-trailing-spaces": [0],
"import/no-unresolved": [0],
"jsx-a11y/img-has-alt": [0],
"camelcase": [0],
"consistent-return": [0],
"guard-for-in": [0],
"one-var": [0],
"react/wrap-multilines": [0],
"react/no-multi-comp": [0],
"react/jsx-no-bind": [0],
"react/prop-types": [0],
"react/prefer-stateless-function": [0],
"react/jsx-first-prop-new-line": [0],
"react/sort-comp": [0],
"import/no-extraneous-dependencies": [0],
"import/extensions": [0],
"react/forbid-prop-types": [0],
"react/require-default-props": [0],
"class-methods-use-this": [0],
"jsx-a11y/no-static-element-interactions": [0],
"react/no-did-mount-set-state": [0],
"jsx-a11y/alt-text": [0],
"import/no-dynamic-require": [0],
"no-extra-boolean-cast": [0],
"no-lonely-if": [0],
"no-plusplus": [0],
"generator-star-spacing": ["error", {"before": true, "after": false}],
"require-yield": [0],
"arrow-parens": [0],
"no-template-curly-in-string": [0],
"no-mixed-operators": [0]
}
}
245 changes: 0 additions & 245 deletions .eslintrc.js

This file was deleted.

11 changes: 10 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -3,15 +3,18 @@ cert/**/*.key
cert/**/*.crt
cert/**/*.csr
web/build/.module-cache/
test/report/*.txt
tmp.txt
.*.swp
._*
.DS_Store
.vscode
.git
.hg
.lock-wscript
.svn
.wafpickle-*
.vscode
CVS
npm-debug.log
logs
Expand All @@ -25,4 +28,10 @@ coverage
build/Release
node_modules
.lock-wscript
temp
temp
dist
test/report
*.tgz
doc_compiled.md
docs-md/cn/doc.md
docs-md/en/doc.md
31 changes: 31 additions & 0 deletions .npmignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
cert/**/*.srl
cert/**/*.key
cert/**/*.crt
cert/**/*.csr
web/build/.module-cache/
tmp.txt
.*.swp
._*
.DS_Store
.git
.hg
.lock-wscript
.svn
.wafpickle-*
CVS
npm-debug.log
logs
*.log
pids
*.pid
*.seed
lib-cov
coverage
.grunt
node_modules
.lock-wscript
temp
releases
rule_sample
test
*.tgz
5 changes: 5 additions & 0 deletions CHANGELOG
Original file line number Diff line number Diff line change
@@ -1,3 +1,8 @@
22 Dec 2016: AnyProxy 4.0.0-beta:

* to AnyProxy rules: all the rule interfaces are asynchronous now, you can write them in a Promise way
* to the UI, rewrite the code and enhance the user experience

26 Feb 2016: AnyProxy 3.10.4:

* let users assign the port for web socket in AnyProxy cli
Expand Down
131 changes: 8 additions & 123 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,144 +1,29 @@
AnyProxy
==========

> AnyProxy 4.x is in beta release now. Rule interface is simplified and Promise is supported. Welcome to have a try! http://anyproxy.io/4.x/
> AnyProxy 4.x 正在beta中,rule接口大幅简化,同时支持了Promise。文档及试用:http://anyproxy.io/4.x/
----------------

[![NPM version][npm-image]][npm-url]
[![node version][node-image]][node-url]
[![npm download][download-image]][download-url]

[npm-image]: https://img.shields.io/npm/v/anyproxy.svg?style=flat-square
[npm-url]: https://npmjs.org/package/anyproxy
[node-image]: https://img.shields.io/badge/node.js-%3E=_0.10-green.svg?style=flat-square
[node-image]: https://img.shields.io/badge/node.js-%3E=_5.0.0-green.svg?style=flat-square
[node-url]: http://nodejs.org/download/
[download-image]: https://img.shields.io/npm/dm/anyproxy.svg?style=flat-square
[download-url]: https://npmjs.org/package/anyproxy

A fully configurable HTTP/HTTPS proxy in NodeJS.
AnyProxy is A fully configurable HTTP/HTTPS proxy in NodeJS.

Home page : [AnyProxy.io](http://anyproxy.io)

(Chinese in this doc is nothing but translation of some key points. Be relax if you dont understand.)

<img src="http://gtms04.alicdn.com/tps/i4/TB1XfxDHpXXXXXpapXX20ySQVXX-512-512.png" width="250" height="250" alt="anyproxy logo" />

特性
------------
* 支持https明文代理
* 支持低网速模拟
* 支持二次开发,可以用javascript控制代理的全部流程,搭建前端个性化调试环境
* 提供web版界面,观测请求情况
* 中文文档:
* [代理服务器的新轮子](https://github.com/alibaba/anyproxy/wiki/%E4%BB%A3%E7%90%86%E6%9C%8D%E5%8A%A1%E5%99%A8%E7%9A%84%E6%96%B0%E8%BD%AE%E5%AD%90%EF%BC%9Aanyproxy) ,介绍AnyProxy的设计初衷,以及它的开放式设计可以解决什么问题。
* [HTTPS相关教程](https://github.com/alibaba/anyproxy/wiki/HTTPS%E7%9B%B8%E5%85%B3%E6%95%99%E7%A8%8B),讲解如何配置AnyProxy的https特性
* 中文主页:[http://anyproxy.io](http://anyproxy.io/cn)

Feature
------------
* work as http or https proxy
* fully configurable, you could modify a request at any stage with your customized javascript code
* when working as https proxy, AnyProxy could intercept https requests for any domain without complaint by browser (after you trust its root CA)
* a web interface for you to watch realtime request details, where html with (almost) any charset could be shown correctly

Quick Start
--------------

### step 1 - install

* install [NodeJS](http://nodejs.org/)
* ``npm install -g anyproxy`` , may require ``sudo``
* python is optional, it will be OK if you get some error about it during installing.

### step 2 - start proxy server

* start with default settings : ``anyproxy``
* ...or start with a specific port: ``anyproxy --port 8001``
* ...start with a rule file: ``anyproxy --rule ./rule_sample/rule_allow_CORS.js``

### step 3 - set up proxy settings in your browser , or system ,or mobile devices ,etc

* default proxy should be 127.0.0.1:8001 , or you_ip_address:8001 on remote devices

### step 4 - launch web interface

* visit [http://127.0.0.1:8002](http://127.0.0.1:8002) ,you will see realtime requests in your browser
* be sure to use web interface with modern browsers

![screenshot](http://gtms01.alicdn.com/tps/i1/TB1IdgqGXXXXXa9apXXLExM2pXX-854-480.gif)


Issue: https://github.com/alibaba/anyproxy/issues

Rule module
-------------------
* Rule module is the specialty for AnyProxy. Think it as a middleware, you could write your own code to hack requests at any stage, no matter it is about to response or the proxy just gets the request. In this way, AnyProxy would be flexible to meet your own demands.
AnyProxy是一个基于NodeJS的,可供插件配置的HTTP/HTTPS代理服务器。

* It's highly recommended to read this guide before using: [What is rule file and how to write one ?](https://github.com/alibaba/anyproxy/wiki/What-is-rule-file-and-how-to-write-one)
主页:[AnyProxy.io](http://anyproxy.io)

* An entire scheme of rule file could be found at [./rule_sample/rule__blank.js](https://github.com/alibaba/anyproxy/blob/master/rule_sample/rule__blank.js). Besides, there are some samples at [./rule_sample](https://github.com/alibaba/anyproxy/tree/master/rule_sample). That may help you a lot when writing your own rule files.
![](https://gw.alipayobjects.com/zos/rmsportal/JoxHUbVhXNedsPUUilnj.gif)


Https features
----------------
After configuring rootCA, AnyProxy could help to decrypt https requests, whose approach is also called Man-In-The-Middle(MITM).

A guide about configuring https features is here : [https://github.com/alibaba/anyproxy/wiki/How-to-config-https-proxy](https://github.com/alibaba/anyproxy/wiki/How-to-config-https-proxy)

HTTPS配置中文教程 : [https://github.com/alibaba/anyproxy/wiki/HTTPS%E7%9B%B8%E5%85%B3%E6%95%99%E7%A8%8B](https://github.com/alibaba/anyproxy/wiki/HTTPS%E7%9B%B8%E5%85%B3%E6%95%99%E7%A8%8B)


Others
-----------------

#### to save request data
* to save request data to local file, use ``` anyproxy --file /path/to/file ```
* anyproxy uses [nedb](https://github.com/louischatriot/nedb) to save request data. Since NeDB's persistence uses an append-only format, you may get some redundant record in local file. For those dupplicated ones with the same id, just use the lastest line of record.
* [TrafficeRecorder](https://github.com/ottomao/TrafficRecorder) is another tool based on anyproxy to help recording all request data, including header and body. You may have a try.

#### throttling
* for instance, ``` anyproxy --throttle 10 ``` sets the speed limit to 10kb/s (kbyte/sec)
* this is just a rough throttling for downstream, not for network simulation

#### work as a module for nodejs
* use it as a module and develop your own proxy.

```
npm install anyproxy --save
```

```javascript
var proxy = require("anyproxy");

//create cert when you want to use https features
//please manually trust this rootCA when it is the first time you run it
!proxy.isRootCAFileExists() && proxy.generateRootCA();

var options = {
type : "http",
port : 8001,
hostname : "localhost",
rule : require("path/to/my/ruleModule.js"),
dbFile : null, // optional, save request data to a specified file, will use in-memory db if not specified
webPort : 8002, // optional, port for web interface
socketPort : 8003, // optional, internal port for web socket, replace this when it is conflict with your own service
throttle : 10, // optional, speed limit in kb/s
disableWebInterface : false, //optional, set it when you don't want to use the web interface
setAsGlobalProxy : false, //set anyproxy as your system proxy
silent : false //optional, do not print anything into terminal. do not set it when you are still debugging.
};
new proxy.proxyServer(options);

```

Contact
-----------------

* Please feel free to [raise issue](https://github.com/alibaba/anyproxy/issues), or give us some advice. :)
* AnyProxy用户旺旺群已经停止维护,任何疑问可以直接[提issue](https://github.com/alibaba/anyproxy/issues) :)


License
-----------------

* Apache License, Version 2.0
Legacy doc of version 3.x : https://github.com/alibaba/anyproxy/wiki/3.x-docs
Loading

0 comments on commit 4be5aa8

Please sign in to comment.