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.5</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/quickreference.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.5</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.5</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><a title="Lien permanent" href="#mimetypes" class="permalink">¶</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><a title="Lien permanent" href="#type" class="permalink">¶</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><a title="Lien permanent" href="#ftpnonget" class="permalink">¶</a></h2>
110 <p>Actuellement, seule la méthode GET est supportée pour FTP dans
111 mod_proxy. Vous pouvez par contre 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><a title="Lien permanent" href="#percent2fhck" class="permalink">¶</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><a title="Lien permanent" href="#ftppass" class="permalink">¶</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>@<var>serveur</var>/mon-fichier
175 <div class="note"><h3>Note</h3>
176 <p>Le mot de passe transmis de cette manière n'est pas chiffré
177 lorsqu'il est envoyé. Il transite entre votre navigateur et le
178 serveur mandataire Apache sous la forme d'une chaîne de texte en
179 clair codée en base64, et entre le mandataire Apache et le
180 serveur FTP en texte pur. Vous devez par conséquent réfléchir à
181 deux fois avant d'accéder à votre serveur FTP via HTTP (et d'une
182 manière générale avant d'accéder à vos fichiers personnels via
183 FTP !) sur des canaux non sécurisés, car des oreilles
184 indiscrètes pourraient intercepter votre mot de passe au cours
185 de son transfert.</p>
187 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
188 <div class="section">
189 <h2><a name="wildcard" id="wildcard">Pourquoi reçois-je un listing de
190 fichiers alors que j'ai demandé le téléchargement d'un fichier
191 ?</a><a title="Lien permanent" href="#wildcard" class="permalink">¶</a></h2>
192 <p>Apache examine l'URL de la requête afin de permettre la
193 navigation dans les répertoires d'un serveur FTP ainsi que le
194 téléchargement de fichiers. Si elle ressemble à un répertoire, ou
195 contient des caractères génériques ("*?[{~"), alors Apache
196 considère que c'est un listing qui est demandé, et non un
198 <p>Vous pouvez désactiver le traitement spécial des noms contenant
199 des caractères génériques. Voir à cet effet la directive
200 <code class="directive">ProxyFtpListOnWildcard</code>.
203 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
204 <div class="directive-section"><h2><a name="proxyftpdircharset" id="proxyftpdircharset">Directive</a> <a name="ProxyFtpDirCharset" id="ProxyFtpDirCharset">ProxyFtpDirCharset</a><a title="Lien permanent" href="#proxyftpdircharset" class="permalink">¶</a></h2>
205 <table class="directive">
206 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le jeu de caractères des listings FTP
208 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyFtpDirCharset <var>jeu-caractères</var></code></td></tr>
209 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProxyFtpDirCharset ISO-8859-1</code></td></tr>
210 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr>
211 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
212 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_ftp</td></tr>
213 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Déplacé
214 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>
216 <p>La directive <code class="directive">ProxyFtpDirCharset</code> permet de
217 définir le jeu de caractères à utiliser pour les listings FTP en
218 HTML générés par <code class="module"><a href="../mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code>.</p>
221 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
222 <div class="directive-section"><h2><a name="proxyftpescapewildcards" id="proxyftpescapewildcards">Directive</a> <a name="ProxyFtpEscapeWildcards" id="ProxyFtpEscapeWildcards">ProxyFtpEscapeWildcards</a><a title="Lien permanent" href="#proxyftpescapewildcards" class="permalink">¶</a></h2>
223 <table class="directive">
224 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Les caractères génériques dans les noms de fichiers
225 doivent-ils être échappés lorsqu'ils sont envoyés au serveur FTP ?</td></tr>
226 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyFtpEscapeWildcards [on|off]</code></td></tr>
227 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>on</code></td></tr>
228 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr>
229 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
230 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_ftp</td></tr>
231 <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>
233 <p>La directive <code class="directive">ProxyFtpEscapeWildcards</code> permet
234 de déterminer si les caractères génériques ("*?[{~") que contiennent
235 les noms de fichiers demandés doivent être échappés pas un slash
236 inversé avant d'être envoyés au serveur FTP. Il s'agit du comportement
237 par défaut ; cependant, de nombreux serveurs FTP n'ont aucune
238 connaissance de la notion d'échappement, et tentent de servir le
239 fichier demandé sous sa forme littérale, en incluant les slashes
240 inversés dans son nom.</p>
241 <p>Définissez cette directive à "off" pour permettre le
242 téléchargement de fichiers dont les noms contiennent des caractères
243 génériques depuis des serveurs FTP qui ne connaissent pas
244 l'échappement des caractères génériques.</p>
247 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
248 <div class="directive-section"><h2><a name="proxyftplistonwildcard" id="proxyftplistonwildcard">Directive</a> <a name="ProxyFtpListOnWildcard" id="ProxyFtpListOnWildcard">ProxyFtpListOnWildcard</a><a title="Lien permanent" href="#proxyftplistonwildcard" class="permalink">¶</a></h2>
249 <table class="directive">
250 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Les caractères génériques dans les noms de fichiers
251 demandés doivent-ils déclencher l'affichage d'un listing ?</td></tr>
252 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyFtpListOnWildcard [on|off]</code></td></tr>
253 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>on</code></td></tr>
254 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr>
255 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
256 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_ftp</td></tr>
257 <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>
259 <p>La directive <code class="directive">ProxyFtpListOnWildcard</code> permet
260 de déterminer si les caractères génériques ("*?[{~") que contiennent
261 les noms de fichiers demandés provoquent l'affichage d'un listing de
262 fichiers par <code class="module"><a href="../mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code> au lieu de télécharger un
263 fichier. Il s'agit de leur comportement par défaut (valeur on).
264 Définissez cette directive à "off" pour permettre le téléchargement de
265 fichiers même si leur nom contient des caractères génériques.</p>
269 <div class="bottomlang">
270 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_proxy_ftp.html" hreflang="en" rel="alternate" title="English"> en </a> |
271 <a href="../fr/mod/mod_proxy_ftp.html" title="Français"> fr </a></p>
272 </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>
273 <script type="text/javascript"><!--//--><![CDATA[//><!--
274 var comments_shortname = 'httpd';
275 var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_proxy_ftp.html';
277 if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
278 d.write('<div id="comments_thread"><\/div>');
279 var s = d.createElement('script');
280 s.type = 'text/javascript';
282 s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
283 (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
286 d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
288 })(window, document);
289 //--><!]]></script></div><div id="footer">
290 <p class="apache">Copyright 2018 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
291 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.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[//><!--
292 if (typeof(prettyPrint) !== 'undefined') {