代理

本文档将介绍代理功能在 DotNetBrowser 中的工作原理，即如何配置代理设置和处理代理身份验证请求。

DotNetBrowser 默认使用系统代理设置。

系统代理

DotNetBrowser 使用与 Microsoft Internet Explorer 相同的设置。

配置

如果您不想使用系统代理设置，您可以使用 Proxy 为每个 Profile 配置自己的代理设置：

      IProxy proxy = profile.Proxy;

    

      Dim proxy As IProxy = profile.Proxy

    

如果使用 Engine.Proxy() 方法，则会获得与默认配置文件相关联的 Proxy 实例。

如果您想告诉库再次使用系统代理设置，请调用：

      engine.Profiles.Default.Proxy.Settings = new SystemProxySettings();

    

      engine.Profiles.Default.Proxy.Settings = New SystemProxySettings()

    

代理设置存储在用户数据目录中。如果将引擎配置为使用特定的用户数据目录，那么代理设置将被保存并在下次创建时恢复。

直接

在此配置中，连接完全不使用代理服务器：

      engine.Profiles.Default.Proxy.Settings = new DirectProxySettings();

    

      engine.Profiles.Default.Proxy.Settings = New DirectProxySettings()

    

自动检测

此配置会自动检测代理设置：

      engine.Profiles.Default.Proxy.Settings = new AutoDetectProxySettings();

    

      engine.Profiles.Default.Proxy.Settings = New AutoDetectProxySettings()

    

自定义代理设置

您可以为 HTTP、HTTPS 和 FTP 协议提供自定义代理设置：

      string proxyRules = "http=foo:80;https=foo:80;ftp=foo:80;socks=foo:80";
string exceptions = "<local>";  // 绕过代理服务器访问本地网页。
engine.Profiles.Default.Proxy.Settings = new CustomProxySettings(proxyRules, exceptions);

    

      Dim proxyRules As String = "http=foo:80;https=foo:80;ftp=foo:80;socks=foo:80"
Dim exceptions As String = "<local>" ' 绕过代理服务器访问本地网页。
engine.Profiles.Default.Proxy.Settings = New CustomProxySettings(proxyRules, exceptions)

    

代理服务器的 IP 地址在规则中也是可以接受的。例如，http=127.0.0.1:80。

代理规则示例：

http=foopy:80;ftp=foopy2 表示对于http:// URL，使用 HTTP 代理foopy:80，对于ftp:// URL，使用 HTTP 代理foopy2:80；
foopy:80 表示对于所有 URL 使用 HTTP 代理foopy:80；
socks4://foopy 表示对于所有 URL 使用 SOCKS v4 代理foopy:1080。

异常的格式可如下所示：

[ URL_SCHEME "://" ] HOSTNAME_PATTERN [ ":" <port> ]

示例:

foobar.com
*foobar.com
*.foobar.com
*foobar.com:99
https://x.*.y.com:99

"." HOSTNAME_SUFFIX_PATTERN [ ":" PORT ]

示例:
```
.google.com
.com
http://.google.com
```
[ SCHEME "://" ] IP_LITERAL [ ":" PORT ]

示例:
```
127.0.1
[0:0::1]
[::1]
http://[::1]:99
```
IP_LITERAL "/" PREFIX_LENGHT_IN_BITS.

示例:
```
192.168.1.1/16
fefe:13::abc/33
```
"<local>". 匹配本地地址。 <local> 表示主机匹配 127.0.0.1, ::1 和 localhost。

如果需要提供多个异常规则，可以用逗号分隔，例如 *foobar.com,.google.com,<local>.

PAC

代理设置是从代理自动配置（PAC）文件中获取的。您必须提供所需 PAC 文件的有效 URL：

      engine.Profiles.Default.Proxy.Settings = new PacProxySettings("<pac-file-url>");

    

      engine.Profiles.Default.Proxy.Settings = New PacProxySettings("<pac-file-url>")

    

PAC 文件 URL 必须是有效的 http:// 地址。您不能提供存储在本地文件系统中的 *.pac 文件的路径。 PAC 文件的名称必须具有_pac_扩展名，例如 http://my-site.com/proxy.pac。 Pac 文件必须在网络服务器上以 application/x-ns-proxy-autoconfig mime 类型提供。

有关详细信息，请参阅 PAC 脚本错误部分。

身份验证

DotNetBrowser 支持代理身份验证。详细内容请参阅身份验证部分。

多个代理

要在同一个 .NET 应用程序中使用多个代理服务器，请为每个代理创建单独的 IEngine 实例。绑定到同一 IEngine 的所有 IBrowser 实例将共享代理设置。

Go Top