1 <?xml version="1.0" encoding="ISO-8859-1"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head>
4 <meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
7 This file is generated from xml source: DO NOT EDIT
8 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
10 <title>mod_proxy_ftp - Serveur Apache HTTP Version 2.4</title>
11 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
12 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
13 <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
14 <script src="../style/scripts/prettify.min.js" type="text/javascript">
17 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
19 <div id="page-header">
20 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
21 <p class="apache">Serveur Apache HTTP Version 2.4</p>
22 <img alt="" src="../images/feather.png" /></div>
23 <div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
25 <a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Modules</a></div>
26 <div id="page-content">
27 <div id="preamble"><h1>Module Apache mod_proxy_ftp</h1>
29 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_proxy_ftp.html" hreflang="en" rel="alternate" title="English"> en </a> |
30 <a href="../fr/mod/mod_proxy_ftp.html" title="Français"> fr </a></p>
32 <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Module fournissant le support FTP à
33 <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></td></tr>
34 <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
35 <tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>proxy_ftp_module</td></tr>
36 <tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_proxy_ftp.c</td></tr></table>
39 <p>Pour pouvoir fonctionner, ce module <em>requiert</em> le
40 chargement de <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>. Il fournit le support du
41 mandatement des sites FTP. Notez que le support FTP est
42 actuellement limité à la méthode GET.</p>
44 <p>Ainsi, pour pouvoir traiter les requêtes FTP mandatées,
45 <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>, et <code class="module"><a href="../mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code>
46 doivent être chargés dans le serveur.</p>
48 <div class="warning"><h3>Avertissement</h3>
49 <p>N'activez pas la fonctionnalité de mandataire avant d'avoir <a href="mod_proxy.html#access">sécurisé votre serveur</a>. Les
50 serveurs mandataires ouverts sont dangereux non seulement pour
51 votre réseau, mais aussi pour l'Internet au sens large.</p>
54 <div id="quickview"><h3>Sujets</h3>
56 <li><img alt="" src="../images/down.gif" /> <a href="#mimetypes">Pourquoi les fichiers du type
57 <var>xxx</var> ne sont-ils pas téléchargeables par FTP ?</a></li>
58 <li><img alt="" src="../images/down.gif" /> <a href="#type">Comment puis-je forcer le téléchargement
59 FTP en mode ASCII du fichier <var>xxx</var> ?</a></li>
60 <li><img alt="" src="../images/down.gif" /> <a href="#ftpnonget">Comment puis-je effectuer un
61 chargement FTP ?</a></li>
62 <li><img alt="" src="../images/down.gif" /> <a href="#percent2fhck">Comment puis-je accéder par FTP à
63 des fichiers situés en dehors de mon répertoire home ?</a></li>
64 <li><img alt="" src="../images/down.gif" /> <a href="#ftppass">Comment puis-je dissimuler le mot de
65 passe FTP apparaissant en clair dans la ligne d'URL de mon
67 <li><img alt="" src="../images/down.gif" /> <a href="#wildcard">Pourquoi reçois-je un listing de
68 fichiers alors que j'ai demandé le téléchargement d'un fichier
70 </ul><h3 class="directives">Directives</h3>
72 <li><img alt="" src="../images/down.gif" /> <a href="#proxyftpdircharset">ProxyFtpDirCharset</a></li>
73 <li><img alt="" src="../images/down.gif" /> <a href="#proxyftpescapewildcards">ProxyFtpEscapeWildcards</a></li>
74 <li><img alt="" src="../images/down.gif" /> <a href="#proxyftplistonwildcard">ProxyFtpListOnWildcard</a></li>
76 <h3>Traitement des bugs</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">Journal des modifications de httpd</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_proxy_ftp">Problèmes connus</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_proxy_ftp">Signaler un bug</a></li></ul><h3>Voir aussi</h3>
78 <li><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></li>
79 <li><a href="#comments_section">Commentaires</a></li></ul></div>
80 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
82 <h2><a name="mimetypes" id="mimetypes">Pourquoi les fichiers du type
83 <var>xxx</var> ne sont-ils pas téléchargeables par FTP ?</a></h2>
84 <p>Ce type particulier de fichier n'est probablement pas défini en
85 temps que <code>application/octet-stream</code> dans le fichier
86 de configuration mime.types de votre mandataire. La ligne suivante
89 <div class="example"><pre>application/octet-stream bin dms lha lzh exe class tgz taz</pre></div>
90 <p>Vous pouvez aussi définir par défaut tous les types de fichiers
91 en tant que fichiers binaires :</p>
92 <div class="example"><pre class="prettyprint lang-config">ForceType application/octet-stream</pre>
94 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
96 <h2><a name="type" id="type">Comment puis-je forcer le téléchargement
97 FTP en mode ASCII du fichier <var>xxx</var> ?</a></h2>
98 <p>Dans les rares siruations où vous devez télécharger un fichier
99 spécifique en utilisant la méthode de transfert FTP
100 <code>ASCII</code> (alors que le mode transfert par défaut est
101 <code>binary</code>), vous pouvez modifier le mode de transfert de
102 <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> en suffixant la requête avec
103 <code>;type=a</code> pour forcer un transfert en mode ASCII (les
104 listings de répertoires FTP sont cependant quant à eux transmis en
106 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
107 <div class="section">
108 <h2><a name="ftpnonget" id="ftpnonget">Comment puis-je effectuer un
109 chargement FTP ?</a></h2>
110 <p>Actuellement, seule la méthode GET est supportée pour FTP dans
111 mod_proxy. Vous pouvez en revanche utiliser le chargement HTTP (POST
112 or PUT) via un mandataire Apache.</p>
113 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
114 <div class="section">
115 <h2><a name="percent2fhck" id="percent2fhck">Comment puis-je accéder par FTP à
116 des fichiers situés en dehors de mon répertoire home ?</a></h2>
117 <p>Un URI FTP est considéré comme relatif au répertoire home de
118 l'utilisateur connecté. Hélas, vous ne pouvez pas utiliser /../
119 pour atteindre des répertoires de niveau supérieur, car les points
120 sont interprétés par le navigateur et ne sont donc pas vraiment
121 envoyés au serveur FTP. Pour traiter ce problème, une méthode
122 nommée <dfn>Squid %2f hack</dfn> a été implémentée dans le
123 mandataire FTP Apache ; cette solution est aussi utilisée par
124 d'autres serveurs mandataires courants comme le <a href="http://www.squid-cache.org/">Cache mandataire Squid</a>. En
125 préfixant par <code>/%2f</code> le chemin de votre requête, vous
126 pouvez faire en sorte que le mandataire modifie le répertoire FTP
127 racine en <code>/</code> (au lieu du répertoire home). Par
128 exemple, pour extraire le fichier <code>/etc/motd</code>, vous
129 pourriez utiliser l'URL :</p>
131 <div class="example"><p><code>
132 ftp://<var>utilisateur</var>@<var>serveur</var>/%2f/etc/motd
134 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
135 <div class="section">
136 <h2><a name="ftppass" id="ftppass">Comment puis-je dissimuler le mot de
137 passe FTP apparaissant en clair dans la ligne d'URL de mon
138 navigateur ?</a></h2>
139 <p>Apache utilise différentes stratégies pour effectuer une
140 connexion à un serveur FTP à l'aide d'un nom d'utilisateur et d'un
141 mot de passe. En l'absence de nom d'utilisateur et de mot de passe
142 dans l'URL, Apache tente une connexion anonyme auprès du serveur
145 <div class="example"><p><code>
146 utilisateur : anonymous<br />
147 mot de passe : apache_proxy@
150 <p>Ceci fonctionne avec tous les serveurs FTP courants configurés
151 pour accepter les connexions anonymes.</p>
153 <p>Pour une connexion personnalisée avec un nom d'utilisateur
154 spécifique, vous pouvez intégrer ce dernier dans l'URL comme suit
157 <div class="example"><p><code>
158 ftp://<var>nom-utilisateur</var>@<var>serveur</var>/mon-fichier
161 <p>Si le serveur FTP demande un mot de passe pour ce nom
162 d'utilisateur (ce qu'il est censé faire), Apache va renvoyer au
163 client une réponse <code>401</code> (Autorisation requise), ce qui
164 fera afficher au navigateur une boîte de dialogue utilisateur/mot
165 de passe. Une fois le mot de passe saisi, la connexion est tentée
166 à nouveau, et si elle réussit, la ressource demandée est
167 présentée. L'avantage de cette procédure réside dans le fait que
168 votre navigateur n'affiche pas le mot de passe en clair, ce qu'il
169 aurait fait si vous aviez utilisé l'URL :</p>
171 <div class="example"><p><code>
172 ftp://<var>nom-utilisateur</var>:<var>mot-de-passe</var>
173 @<var>serveur</var>/mon-fichier
176 <div class="note"><h3>Note</h3>
177 <p>Le mot de passe transmis de cette manière n'est pas chiffré
178 lorsqu'il est envoyé. Il transite entre votre navigateur et le
179 serveur mandataire Apache sous la forme d'une chaîne de texte en
180 clair codée en base64, et entre le mandataire Apache et le
181 serveur FTP en texte pur. Vous devez par conséquent réfléchir à
182 deux fois avant d'accéder à votre serveur FTP via HTTP (et d'une
183 manière générale avant d'accéder à vos fichiers personnels via
184 FTP !) sur des canaux non sécurisés, car des oreilles
185 indiscrètes pourraient intercepter votre mot de passe au cours
186 de son transfert.</p>
188 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
189 <div class="section">
190 <h2><a name="wildcard" id="wildcard">Pourquoi reçois-je un listing de
191 fichiers alors que j'ai demandé le téléchargement d'un fichier
193 <p>Apache examine l'URL de la requête afin de permettre la
194 navigation dans les répertoires d'un serveur FTP ainsi que le
195 téléchargement de fichiers. Si elle ressemble à un répertoire, ou
196 contient des caractères génériques ("*?[{~"), alors Apache
197 considère que c'est un listing qui est demandé, et non un
199 <p>Vous pouvez désactiver le traitement spécial des noms contenant
200 des caractères génériques. Voir à cet effet la directive
201 <code class="directive">ProxyFtpListOnWildcard</code>.
204 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
205 <div class="directive-section"><h2><a name="proxyftpdircharset" id="proxyftpdircharset">Directive</a> <a name="ProxyFtpDirCharset" id="ProxyFtpDirCharset">ProxyFtpDirCharset</a></h2>
206 <table class="directive">
207 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le jeu de caractères des listings FTP
209 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyFtpDirCharset <var>jeu-caractères</var></code></td></tr>
210 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProxyFtpDirCharset ISO-8859-1</code></td></tr>
211 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr>
212 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
213 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_ftp</td></tr>
214 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.2.7 d'Apache. Déplacé
215 depuis <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> à partir de la version 2.3.5 d'Apache</td></tr>
217 <p>La directive <code class="directive">ProxyFtpDirCharset</code> permet de
218 définir le jeu de caractères à utiliser pour les listings FTP en
219 HTML générés par <code class="module"><a href="../mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code>.</p>
222 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
223 <div class="directive-section"><h2><a name="proxyftpescapewildcards" id="proxyftpescapewildcards">Directive</a> <a name="ProxyFtpEscapeWildcards" id="ProxyFtpEscapeWildcards">ProxyFtpEscapeWildcards</a></h2>
224 <table class="directive">
225 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Les caractères génériques dans les noms de fichiers
226 doivent-ils être échappés lorsqu'ils sont envoyés au serveur FTP ?</td></tr>
227 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyFtpEscapeWildcards [on|off]</code></td></tr>
228 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>on</code></td></tr>
229 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr>
230 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
231 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_ftp</td></tr>
232 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.3 du serveur HTTP Apache</td></tr>
234 <p>La directive <code class="directive">ProxyFtpEscapeWildcards</code> permet
235 de déterminer si les caractères génériques ("*?[{~") que contiennent
236 les noms de fichiers demandés doivent être échappés pas un slash
237 inversé avant d'être envoyés au serveur FTP. Il s'agit du comportement
238 par défaut ; cependant, de nombreux serveurs FTP n'ont aucune
239 connaissance de la notion d'échappement, et tentent de servir le
240 fichier demandé sous sa forme littérale, en incluant les slashes
241 inversés dans son nom.</p>
242 <p>Définissez cette directive à "off" pour permettre le
243 téléchargement de fichiers dont les noms contiennent des caractères
244 génériques depuis des serveurs FTP qui ne connaissent pas
245 l'échappement des caractères génériques.</p>
248 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
249 <div class="directive-section"><h2><a name="proxyftplistonwildcard" id="proxyftplistonwildcard">Directive</a> <a name="ProxyFtpListOnWildcard" id="ProxyFtpListOnWildcard">ProxyFtpListOnWildcard</a></h2>
250 <table class="directive">
251 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Les caractères génériques dans les noms de fichiers
252 demandés doivent-ils déclencher l'affichage d'un listing ?</td></tr>
253 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyFtpListOnWildcard [on|off]</code></td></tr>
254 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>on</code></td></tr>
255 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr>
256 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
257 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_ftp</td></tr>
258 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.3 du serveur HTTP Apache</td></tr>
260 <p>La directive <code class="directive">ProxyFtpListOnWildcard</code> permet
261 de déterminer si les caractères génériques ("*?[{~") que contiennent
262 les noms de fichiers demandés provoquent l'affichage d'un listing de
263 fichiers par <code class="module"><a href="../mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code> au lieu de télécharger un
264 fichier. Il s'agit de leur comportement par défaut (valeur on).
265 Définissez cette directive à "off" pour permettre le téléchargement de
266 fichiers même si leur nom contient des caractères génériques.</p>
270 <div class="bottomlang">
271 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_proxy_ftp.html" hreflang="en" rel="alternate" title="English"> en </a> |
272 <a href="../fr/mod/mod_proxy_ftp.html" title="Français"> fr </a></p>
273 </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
274 <script type="text/javascript"><!--//--><![CDATA[//><!--
275 var comments_shortname = 'httpd';
276 var comments_identifier = 'http://httpd.apache.org/docs/2.4/mod/mod_proxy_ftp.html';
278 if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
279 d.write('<div id="comments_thread"><\/div>');
280 var s = d.createElement('script');
281 s.type = 'text/javascript';
283 s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
284 (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
287 d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
289 })(window, document);
290 //--><!]]></script></div><div id="footer">
291 <p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
292 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
293 if (typeof(prettyPrint) !== 'undefined') {