====== Court Tutorial sur DeleGate pour les Débutants ======

**Article écrit par Yutaka Sato <ysato (at) delegate (dot) org>, traduit de l'anglais par Ioguix et wikisé par Arnaud Fontaine.**

Ce document est un très court tutorial sur **DeleGate** pour les débutants. Vous trouverez plus de détails dans le [[ftp://www.delegate.org/pub/DeleGate/Manual.htm|manuel de référence]].

===== Intructions minimum =====

  - Voici le moyen le plus simple pour utiliser **DeleGate** comme proxy HTTP sur le port 8080 : <code># delegated -P8080 SERVER=http</code>Ici, **-Pxxxx** indique le numéro de port écouté pour recevoir les requêtes des clients et **SERVER=yyyy** le nom du protocole utilisé pour communiquer avec les clients.
  - La validité et la conservation des données du cache peuvent être controlées grâce aux paramètres **EXPIRE** et **CRON**.<code>EXPIRE=1d CRON="0 * * * * -expire 2d"</code>
  - DeleGate n'autorise implicitement que les accès provenant des réseaux locaux de son hôte. Vous pouvez spécifier explicitement les hôtes, réseaux ou domaines autorisés en utilisant le paramètre **PERMIT** sous cette forme : <code>PERMIT="*:*:host1,123.123.123.123/255.255.255.0,*.my.domain,!bad.my.domain"</code>

===== Instructions un peu plus avancées =====

  - Exécuter DeleGate en mode verbeux (travaille en tâche de fond et écrit ses journaux sur la console) : <code># delegated -v [...]</code>
  - Arrêter un serveur Delegate écoutant sur le port 8080 : <code># delegated -P8080 -Fkill</code>
  - Charger et utiliser les paramètres de configuration depuis une URL : <code>delegated +=http://serveur/chemin/des/paramètres.txt</code>
  - Restreindre à une interface réseau l'écoute des requêtes des clients : <code># delegated -Phostname:8080 SERVER=http</code>
  - Contrôler dans quel ordre les différents services de résolution de noms seront intérrogés : <code>RESOLV=dns,nis,file</code>
  - Se connecter via un(des) serveur(s) Socks si la destination n'est pas locale à votre site : <code>CONNECT="cache,socks:*:!*.my.domain" SOCKS=sockshost</code>
  - Faire suivre toutes les requêtes à un autre proxy : <code>PROXY="proxyHost:8080:*"</code>
  - Faire suivre les requêtes destinées à certains serveurs vers un autre proxy : <code>PROXY="proxyHost:8080:!*.my.domain,!*.near.domain"</code>
  - Rediriger n'importe quel protocole TCP vers un serveur donné : <code>SERVER=tcprelay://serverName:portNumber/</code>
  - Rediriger n'importe quel protocole TCP vers un autre serveur DeleGate : <code>MASTER="delegateHost:8080:*"</code>
  - Rediriger n'importe quel protocole UDP vers un serveur donné : <code>SERVER=udprelay://serverName:portNumber/</code>
  - Lier le serveur cible à DeleGate pour présenter ce dernier comme le serveur d'origine au client : <code># delegated -P80 SERVER=http://httpserver/</code>
  - Restreindre les newsgroups fournis aux clients : <code># delegated -P8119 SERVER=nntp://nntpserver/comp,misc,news</code>
  - Regrouper différents serveurs en un seul serveur virtuel grâce au paramètre **MOUNT** : <code>SERVER=nntp MOUNT="= nntp://serv1/comp" MOUNT="= nntp://serv2/misc,news"</code>
  - Passerelle pour clients HTTP vers les serveurs NNTP : <code>SERVER=http MOUNT="/news1/* nntp://ns1/*" MOUNT="/news2/* nntp://ns2/*"</code>
  - Utiliser DeleGate comme serveur HTTP : <code>-P80 SERVER=http MOUNT="/* /usr/local/www/*" REMITTABLE=file</code>
  - Restreindre les hôtes/réseaux/domaines de destination accessible via DeleGate : <code>PERMIT="*:*.reachable.domain:*"</code>