2024-10-07 01:30:54 +00:00
# proxy.pac
2024-10-07 03:05:46 +00:00
这个项目用来生成代理自动配置 `proxy.pac` 文件,可以用于配置浏览器或系统级的代理设置。你可以自定义规则,根据配置文件中指定的域名来路由流量。
2024-10-07 01:30:54 +00:00
2024-10-07 03:05:46 +00:00
## 使用方法
2024-10-07 01:30:54 +00:00
2024-10-07 03:05:46 +00:00
1. **域名规则配置**
2024-10-07 01:30:54 +00:00
2024-10-07 03:05:46 +00:00
项目包含一些示例配置文件:
2024-10-07 01:30:54 +00:00
2024-10-08 01:38:38 +00:00
- `auto-proxy.txt.example`
2024-10-07 01:30:54 +00:00
- `domain-rules-blocked.txt.example`
- `domain-rules-direct.txt.example`
- `domain-rules-proxy.txt.example`
2024-10-08 01:38:38 +00:00
- `ipv4-rules-direct.txt.example`
- `ipv6-rules-direct.txt.example`
2024-10-07 01:30:54 +00:00
2024-10-07 03:05:46 +00:00
要使用这些文件,去掉 `.example` 扩展名。每个文件代表不同的代理行为:
2024-10-07 01:30:54 +00:00
2024-10-08 01:38:38 +00:00
- **Auto-Proxy 配置的规则**:把规则添加到 `auto-proxy.txt` 中,将会按照规则来访问网站。
所有以 `auto-proxy` 开头,并且以 `.txt` 结尾的文件都按 Auto-Proxy 规则来解析。如果你有多个 Auto-Proxy 规则,可以保存为多个文件,例如 `auto-proxy-1.txt` 、`auto-proxy-2.txt` 等等。
**注意** :当前,会忽略 Auto-Proxy 中的 URL 的匹配规则,仅仅处理域名规则。
2024-10-07 03:05:46 +00:00
- **Blocked**:添加到 `domain-rules-blocked.txt` 中的域名将被阻止访问。
2024-10-08 01:38:38 +00:00
- **Direct**:
- 添加到 `domain-rules-direct.txt` 中的域名将绕过代理,直接连接。
- 添加到 `ipv4-rules-direct.txt` 中的 IPv4 网络段( CIDR格式) 将绕过代理, 直接连接。
- 添加到 `ipv6-rules-direct.txt` 中的 IPv6 网络段( CIDR格式) 将绕过代理, 直接连接。
2024-10-07 03:05:46 +00:00
- **Proxy**:添加到 `domain-rules-proxy.txt` 中的域名将使用默认代理。
2024-10-07 01:30:54 +00:00
2024-10-08 01:38:38 +00:00
将你的域名或者IP网络段添加到合适的文件中, 每个域名一行。以 `#` 开头的行被视为注释。例如:
2024-10-07 01:30:54 +00:00
2024-10-08 01:38:38 +00:00
文件 domain-rules-direct.txt 中添加的域名将会绕过代理直接连接
2024-10-07 01:30:54 +00:00
```
2024-10-07 03:05:46 +00:00
# 直连域名
2024-10-07 01:30:54 +00:00
google.com
example.org
```
2024-10-08 01:38:38 +00:00
文件 ipv4-rules-direct.txt 中添加的网络段将会绕过代理直接连接
```
# 直连的 IPv4 网络段
192.168.0.0/16
114.114.114.114/32 # 如果要添加一个特定 IP 地址,请追加 /32 到 IP 地址后面
```
你也可以创建自己的自定义规则文件,文件名应遵循 `<domain|ipv4|ipv6>-rules-<rule_name>.txt` 的格式。例如,`domain-rules-companyProxy.txt` 将使该文件中的所有域名使用 `proxy.pac` 中定义的 `companyProxy` 设置。`ipv4-rules-block.txt` 将不可访问文件中的所有网络段。
2024-10-07 01:30:54 +00:00
2024-10-07 03:05:46 +00:00
2. **生成 `proxy.pac` 文件**
2024-10-07 01:30:54 +00:00
2024-10-07 03:05:46 +00:00
运行脚本生成 `proxy.pac` 文件:
2024-10-07 01:30:54 +00:00
```sh
./build.sh
```
2024-10-07 03:05:46 +00:00
在项目根目录中会自动生成 `proxy.pac` 文件。
2024-10-07 01:30:54 +00:00
2024-10-08 01:38:38 +00:00
3. **默认的规则来源**
构建脚本 [`build.sh` ](./build.sh ) 默认会下载以下文件,但不会覆盖已有的同名文件:
- `auto-proxy.txt`
- `ipv4-rules-direct.txt`
- `ipv6-rules-direct.txt`
如果你不需要 Auto-Proxy 的规则或者 IP 网络段的规则,请创建同名的空文件即可忽略下载。
4. **代理配置**
2024-10-07 01:30:54 +00:00
2024-10-07 03:05:46 +00:00
生成的 `proxy.pac` 文件使用以下默认的代理配置(注意默认代理服务器是 `SOCKS5 127.0.0.1:1080` ) :
2024-10-07 01:30:54 +00:00
```javascript
var proxyBehaviors = {
2024-10-07 03:05:46 +00:00
proxy: "SOCKS5 127.0.0.1:1080", // 默认代理
2024-10-07 01:30:54 +00:00
direct: DIRECT,
blocked: "PROXY 0.0.0.0:0",
"http_proxy": "PROXY 127.0.0.1:3128",
2024-10-07 03:05:46 +00:00
"companyProxy": "PROXY 192.168.1.1:8080", // `domain-rules-companyProxy.txt` 中的域名将使用此代理设置
2024-10-07 01:30:54 +00:00
};
```
2024-10-07 03:05:46 +00:00
你可以在生成 `proxy.pac` 后修改这些值,或者直接在原始脚本 `proxy.js` 中进行自定义,以便使用不同的默认设置。请根据实际环境和需求调整这些代理设置。
2024-10-07 01:30:54 +00:00
2024-10-08 01:38:38 +00:00
5. **测试**
2024-10-07 01:30:54 +00:00
2024-10-07 03:05:46 +00:00
如果安装了 Node.js, 可以使用以下命令运行测试以验证配置:
2024-10-07 01:30:54 +00:00
```sh
node proxy.pac test
```
2024-10-07 03:05:46 +00:00
测试代码位于 `proxy.pac` 文件的末尾,例如:
2024-10-07 01:30:54 +00:00
```javascript
assertVisitHostWithProxy("com.google");
assertVisitHostWithProxy("domains.google");
assertHostWithDefaultAction("www.not-google");
assertDirectHost("10.3.4.5");
assertDirectHost("114.114.114.114");
assertBlockedHost("www.whitehouse.com");
```
2024-10-07 03:05:46 +00:00
## 示例
2024-10-07 01:30:54 +00:00
2024-10-07 03:05:46 +00:00
要添加一个需要被阻止的域名,只需编辑 `domain-rules-blocked.txt` 文件:
2024-10-07 01:30:54 +00:00
```
2024-10-07 03:05:46 +00:00
# 被阻止的域名
2024-10-07 01:30:54 +00:00
example.com
ads.example.net
```
2024-10-07 03:05:46 +00:00
运行 `./build.sh` 重新生成的 `proxy.pac` 将阻止访问 `example.com` 和 `ads.example.net` 。
2024-10-07 01:30:54 +00:00
## License
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the [GNU General Public License ](./LICENSE ) along with this program. If not, see < https: // www . gnu . org / licenses /> .