### px命令用法示意

> px --dst="h=可连接的时长;s=是否校验hash;ws地址1,ws地址2,..." --dst="..." ...  /path/to/settings


1. px命令参数列表：--dst --all --port --quiet --plimit=128

1. dst参数指定目标服务器列表，及每组服务器列表持续运行时间。dst参数比较复杂，下文详细说明

1. all参数指定是否全部流量通过代理发出（默认本地可访问的流量本地直接发出，不经过代理）

1. port指定端口号，默认为8081

1. quiet如果填了则不会输出详细的日志信息

1. plimit参数可以不填，不填则会正常启动程序，不会限制使用的内存大小。如果填写了，则当heapUsed超过设置的数字时，程序会自动重启，切断当前已存在的连接

1. 参数过长时可以把实际参数写到文件中，例如：

 cfg内容

  ```javascript
  --port=8081
  --all
  --dst=ws://a.com
  ```

  如果单个参数过长，也可以换行写，解析时会自动并在一行，比如：

  ```javascript
  --port=8081
  --all
  --dst=ws://a.com,
  ws://a1.com,
  ws://a2.com,
  ws://a3.com,
  ws://a4.com
  ```

  启动命令：

  ```
  px cfg
  ```

---

## dst参数详解

dst参数指定远程服务的地址，首先来看远程服务器的代码示例：

### 远程服务器代码示例：

```
require('cwg-http-proxy-tools').startSimpleServer(8080)
```

假设以上代码被部署到4个服务器，对外域名分别是：
a.com, a1.com, b.com, b1.com

1. 以上服务器支持https访问

2. 已映射443端口和80端口到内部的8080端口

则px命令写法如下：

>px --dst="s=1;ws://a.com,a1.com" --dst="h=7;s=1;ws://b.com,b1.com"

- s=1表示校验服务端公钥hash（通过请求https://域名/keyhash.hex比对）
- s=0表示不校验服务端公钥hash（存在被中间人攻击风险，如果目标服务器不支持https连接，请尽可能使用固定hash校验）
- s=32为字母数字组合，表示比较固定hash
- s=一个链接，表示从该链接获取hash值。链接写法：https://${host}${pathname}/keyhash.hex。链接内可以使用参数，参数是ws字符串用url.parse()方法解析之后的字段，例如ws链接是 ws://aaa@test.com/xx/yy，则`https://${host}${pathname}/../keyhash.hex`的含义是 `https://test.com/xx/keyhash.hex`

- 最后一串即为实际的服务器ws连接字符串，多个地址用字母逗号隔开。如果目标服务器配置了连接密码，则可以使用`ws://<cpwdbase64>@a.com`这样的方式填写，把`<cpwdbase64>`换成服务器连接密码的base64字符串

> --dst参数可以有多个，最终会被合并成一个列表

### 其他

1. pxs --quiet --port=8080 --mpwd=12345 --cpwd=123 --dst=目标服务器列表 --httpfile=path/to/httpfile.js 开启一个本地server，连接密码123，管理密码12345，目标服务器列表写法同px命令的dst，如果填写了则表示本server会作为远程server的上传源，可以设置多个dst。httpfile指定一个文件，当使用http协议访问server时，使用httpfile里的规则来响应内容。httpfile内容即http.createServer()的参数0，例如：module.exports=async (req, res)=>{res.end('ok')}。

2. pxu --quiet --dst=ws://MTIz@127.0.0.1:8080 --shell --fork=4 开启一个本地上传源，连接到8080端口的server，使用连接密码123的base64字符串MTIz，允许shell，fork参数不填则只维持一个连接，如果填了则会同时维持多个连接

3. pxm --quiet --ws=ws://127.0.0.1:8080 --mpwd=12345 使用管理端连接8080端口的server，使用管理密码12345
