Procházet zdrojové kódy

IPv6 and name resolution documentation updated for 0.8

z3APA3A před 10 roky
rodič
revize
d1f8180eab
2 změnil soubory, kde provedl 64 přidání a 5 odebrání
  1. 41 0
      doc/html/howtoe.html
  2. 23 5
      doc/html/howtor.html

+ 41 - 0
doc/html/howtoe.html

@@ -33,6 +33,8 @@
 		<li><A HREF="#BANDLIM">How to limit bandwidth</A>
 		<li><A HREF="#TRAFLIM">How to limit traffic amount</A>
 		<li><A HREF="#NETLIST">How to build network lists</A>
+		<li><a href="#NSCACHING">How to configure name resolution and DNS caching</a>
+		<li><a href="#IPv6">How to use IPv6</a>
 	</ul>
 	<li><A HREF="#CLIENT">Client configuration</A>
 	<li><A HREF="#ADMIN">Administering and information analisys</A>
@@ -738,6 +740,45 @@ In this example we obtain list of local networks from provider's page to
 local.networks file, allow direct access to these networks and redirect all
 connection to external networks to provider's proxy.
 </p>
+  <li><a name="NSCACHING"><i>How to configure name resolution and DNS caching</i></a>
+  <p>
+  For name resolution and caching use commands nserver, nscache / nscache6 and nsrecord.
+  <pre>
+  nserver 192.168.1.2
+  nserver 192.168.1.3:5353/tcp</pre>
+  sets DNS resolvers. 192.168.1.3 will be used via TCP/5353 (instead of default UDP/53)
+  only if 192.168.1.2 fails. Up to 5 nservers may be specified.
+  If no nserver is configured, default system name resolution functions are used.
+  <pre>
+  nscache 65535
+  nscache6 65535</pre>
+  sets name cache size for IPv4 and IPv6. Name cache must be large enouth, if presents.
+  name cache is only used if nserver is configured.
+  <pre>
+  nsrecord server.mycompany.example.com 192.168.1.1
+  nsrecord www.porno.com 127.0.0.2
+  ...
+  deny * * 127.0.0.2</pre>
+  adds static nsrecords. Also, static nsrecords are used for dnspr, unless -s option is specified.
+  Since 0.8 version, parent proxy may be configured for dnspr.
+</p>
+  <li><a name="IPv6"><i>How to use IPv6</i></a>
+  <p>
+  IPv6 is supported since 0.8. Please note, some proxy protolos, e.g. SOCKSv4,
+  do not  support IPv6. SOCKSv5 supports IPv6 with special request type (must be
+  implemented by client).
+  <br>
+  3proxy supports proxying from IPv4 and IPv6 networks to IPv4,
+  IPv6 and mixed networks. IPv6 address may be used in
+  internal, external, parent commands, ACLs, -i and -e options,etc.
+  external command and -e options may be given twice for each service - once with IPv4
+  and once with IPv6 address. internal can be given only once, to bind to all IPv4 and
+  IPv6 addresses use [0:0:0:0:0:0:0:0] or [::]. 
+  <br>
+  Any service may be configured with -4, -46, -64, -6 options to specify decied
+  priority for name to IPv4/IPv6 address resolution (IPv4 only, IPv4 priority,
+  IPv6 priority, IPv6 only).
+  </p>	
 	</ul>
 
 <hr>

+ 23 - 5
doc/html/howtor.html

@@ -34,6 +34,7 @@
     <li><a href="#TRAFLIM">Как ограничивать объем принимаемого трафика</a>
     <li><a href="#NETLIST">Как строить списки сетей</a>
     <li><a href="#NSCACHING">Как управлять разрешением имен и кэшированием DNS</a>
+    <li><a href="#IPV6">Как использовать IPv6</a>
     <li><a href="#DEMANDDIAL">Как устанавливать соединение по требованию</a>
   </ul>
   <li><a href="#CLIENT">Конфигурация и настройка клиентов</a>
@@ -765,21 +766,38 @@
   nscache и nsrecord.
   <pre>
   nserver 192.168.1.2
-  nserver 192.168.1.3</pre>
+  nserver 192.168.1.3:5353/tcp</pre>
   указывает 3proxy какие машины следует использвоать в качестве серверов
-  DNS. Сервер 192.168.1.3 будет использоваться толкьо при недостижимости
+  DNS. Сервер 192.168.1.3 будет использоваться по порту TCP/5353 (вместо дефолтного UDP/53) только при недостижимости
   192.168.1.2. Можно указать до 5 серверов. Если nserver не указан, будут
   использованы системные функции разрешения имен.
   <pre>
-  nscache 65535</pre>
-  указывает размер кэша для разрешения имен (обычно достаточно большой).
+  nscache 65535
+  nscache6 65535</pre>
+  указывает размер кэша для разрешения имен (обычно достаточно большой) для IPv4 и IPv6 соответственно.
   Кэш исопльзуется только при явном указании nserver.
   <pre>
   nsrecord server.mycompany.example.com 192.168.1.1
   nsrecord www.porno.com 127.0.0.2
   ...
   deny * * 127.0.0.2</pre>
-  добавляет статическую запись в кэш.</p>
+  добавляет статическую запись в кэш. Статические записи так же влияют на разрешение через dnspr если не указана опция -s. Начиная с версии 0.8 для dnspr могут быть сконфигурированы родительские прокси.</p>
+  <li><a name="IPv6"><i>Как использовать IPv6</i></a>
+  <p>
+  IPv6 поддерживается с версии 0.8. Обратите внимание, что в некоторых видах прокси (например SOCKSv4)
+  IPv6 не поддерживает на уровне протокола. В SOCKSv5 есть поддержка IPv6 с помощью отдельного вида
+  запроса, который должен быть реализован в клиентском приложении или соксификаторе.
+  <br>
+  Возможно проксирование из сетей IPv4 и IPv6 в сети IPv4,
+  IPv6 и смешанные. Адреса IPv6 могут использоваться в командах
+  internal, external, parent, ACL, опциях -i, -e и т.д. Команду external и опцию
+  -e для каждого сервиса можно давать два раза - один раз с IPv4 и один раз с IPv6
+  адресом. internal и -i может быть указан только один, для биндинга ко всем адресам IPv4 и IPv6
+  можно использовать адрес [0:0:0:0:0:0:0:0] or [::]. 
+  <br>
+  Кроме того, для каждого сервиса могут быть даны опции -4, -46, -64, -6 которые
+  задают приоритет разрешения имен в адреса IPv4 и IPv6 (только IPv4, приоритет IPv4, приоритет IPv6, только IPv6).
+  </p>	
   <li><a name="DEMANDDIAL"><i>Как устанавливать соединение по требованию</i></a>
   <p>
   Команда dialer задает программу, которая будет запускаться при