website view pt/doc/handbook/web-server.html @ rev 551

Fix c6b2d9c4e031, pt: localy browseable (with file://)
author Pascal Bellard <pascal.bellard@slitaz.org>
date Mon Oct 26 10:30:55 2009 +0100 (2009-10-26)
parents c6b2d9c4e031
children
line source
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="pt" lang="pt">
4 <head>
5 <title>Manual SliTaz (pt) - Servidor de Internet LightTPD</title>
6 <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
7 <meta name="description" content="slitaz portuguese handbook" />
8 <meta name="expires" content="never" />
9 <meta name="modified" content="2008-07-18 07:00:00" />
10 <meta name="publisher" content="www.slitaz.org" />
11 <meta name="author" content="Christophe Lincoln" />
12 <link rel="shortcut icon" href="favicon.ico" />
13 <link rel="stylesheet" type="text/css" href="book.css" />
14 </head>
15 <body bgcolor="#ffffff">
16
17 <!-- Header and quick navigation -->
18 <div id="header">
19 <div id="quicknav" align="right">
20 <a name="top"></a>
21 <a href="chroot-env.html">Ambiente Chroot</a> |
22 <a href="index.html">Conteúdo</a>
23 </div>
24 <h1><font color="#3e1220">Manual SliTaz (pt)</font></h1>
25 </div>
26
27 <!-- Content. -->
28 <div id="content">
29 <div class="content-right"></div>
30
31 <h2><font color="#df8f06">Servidor de Internet LightTPD</font></h2>
32
33 <ul>
34 <li><a href="web-server.html#about">Sobre o LightTPD.</a></li>
35 <li><a href="web-server.html#var-www">/var/www</a> - Diretório raiz de documentos.</li>
36 <li><a href="web-server.html#Public">~/Public</a> - Diretório público de usuários.</li>
37 <li><a href="web-server.html#config">lighttpd.conf</a> - Arquivo de Configuração do LightTPD.</li>
38 <li><a href="web-server.html#start-stop-restart">Inicie, pare e reinicie o servidor.</a></li>
39 <li><a href="web-server.html#cgi-perl">Scripts CGI e Perl</a> - Scripts CGI usando Perl.</li>
40 <li><a href="web-server.html#cgi-python">Scripts CGI e Python</a> - Scripts CGI usando Python.</li>
41 <li><a href="web-server.html#auth">Autenticação</a> - Proteção para diretórios.</li>
42 </ul>
43
44 <a name="about"></a>
45 <h3>Sobre o LightTPD</h3>
46 <p>
47 Este capítulo descreve a configuração e uso do servidor de internet LightTPD.
48 É um servidor de HTTP rápido, seguro, flexível e que consome pouca memória RAM.
49 Habilita uma administração inteligente dos recursos da cpu e oferece suporte a
50 FastCGI, CGI, Auth, compressão de Output, reescritura de URLs, etc. O LightTPD é
51 um modo barato para hospedar seu próprio site em uma máquina antiga.
52 </p>
53 <p>
54 No SliTaz o servidor é lançado automaticamente na inicialização do sistema e é
55 pré-configurado com PHP. A raiz dos documentos por padrão está em
56 <code>/var/www</code>, contendo a página padrão <code>index.html</code>.
57 Imagens são armazenadas no diretório <code>images/</code>. Website do LightTPD:
58 <a href="http://www.lighttpd.net/">http://www.lighttpd.net/</a>
59 </p>
60 <a name="var-www"></a>
61 <h3>/var/www - Diretório raiz de documentos</h3>
62 <p>
63 A pasta /var/www é o diretório <em>raiz</em> de documentos - você pode ter acesso
64 a ela pela URL <a href="http://localhost/">http://localhost/</a>. Se você quiser
65 hospedar um site, você pode salvar todos seus documentos aqui. Se você quiser
66 hospedar múltiplos sites, você precisará criar os hosts virtuais. Note que você
67 também pode conferir o <a href="http://localhost/server-status">http://localhost/server-status</a>.
68 </p>
69 <a name="Public"></a>
70 <h3>~/Public - Diretório público de usuários </h3>
71 <p>
72 O SliTaz provê aos usuários do sistema um espaço público para colocar documentos,
73 geralmente HTML. Este diretório chama-se Public e deve estar dentro da raiz de seu
74 espaço de usuário, como por exemplo /home/hacker/Public. Para criar este diretório
75 use o comando mkdir:
76 </p>
77 <pre> $ mkdir ~/Public
78 </pre>
79 <p>
80 Você pode ter acesso então pela URL:
81 <a href="http://localhost/%7Ehacker/">http://localhost/~hacker/</a>. Você também
82 pode usar o nome de máquina ou o endereço IP se conectar de outro computador.
83 </p>
84 <a name="config"></a>
85 <h3>/etc/lighttpd/lighttpd.conf - arquivo de configuração do LightTPD</h3>
86 <p>
87 O arquivo de configuração principal do LightTPD (<code>lighttpd.conf</code>) é
88 encontrado em /etc/lighttpd/. Este arquivo provido por SliTaz é auto-explicativo,
89 leia-o para maiores informações. Você pode achar outros exemplos no website do
90 LightTPD. No SliTaz você achará também o arquivo <code>vhosts.conf</code> para a
91 configuração de qualquer host virtual (hospedar vários sites no mesmo servidor).
92 </p>
93 <a name="start-stop-restart"></a>
94 <h3>Inicie, pare, reinicie o servidor de internet</h3>
95 <p>
96 Por padrão o SliTaz inicia o servidor automaticamente no boot, para prevenir isto
97 você precisa remover o <code>lighttpd</code> da variável RUN_DAEMONS localizado
98 no arquivo de sistema <code>/etc/rcS.conf</code>. Para iniciar, parar ou reiniciar
99 o servidor você pode usar os comandos:
100 <code>/etc/init.d/lighttpd [binstart|stop|restart]</code>. Exemplo para reiniciar
101 o servidor após mudar o arquivo de configuração:
102 </p>
103 <pre> # /etc/init.d/lighttpd restart
104 </pre>
105 <a name="cgi-perl"></a>
106 <h3>Scripts CGI usando Perl </h3>
107 <p>
108 Para configurar o servidor de LightTPD para localizar o caminho do binário do
109 <code>perl</code> e usar CGI/Perl, você precisará instalar o perl e modificar o
110 arquivo de configuração de servidor. Exemplo usando o Geany:
111 </p>
112 <pre> # tazpkg get-install perl
113 # geany /etc/lighttpd/lighttpd.conf &amp;
114 </pre>
115 <pre class="script"># CGI module. Você pode instalar o Perl e atribuir scripts .pl e .cgi
116 # para o executável /usr/bin/perl
117 $HTTP["url"] =~ "/cgi-bin/" {
118 cgi.assign = (
119 ".sh" =&gt; "/bin/sh",
120 ".cgi" =&gt; "/usr/bin/perl,
121 ".pl" =&gt; "/usr/bin/perl
122 )
123 }
124 </pre>
125 <a name="cgi-python"></a>
126 <h3>Scripts CGI que usam Python</h3>
127 <p>
128 Para configurar o servidor LightTPD para localizar o caminho do binário
129 <code>python</code> e usar CGI/Python, você precisará instalar o python e
130 modificar o arquivo de configuração do servidor. Exemplo usando o Geany:
131 </p>
132 <pre> # tazpkg get-install python
133 # geany /etc/lighttpd/lighttpd.conf &amp;
134 </pre>
135 <pre class="script"># CGI module. Você pode instalar o Python e atribuir scripts .py e .cgi
136 # para o executável /usr/bin/python
137 $HTTP["url"] =~ "/cgi-bin/" {
138 cgi.assign = (
139 ".sh" =&gt; "/bin/sh",
140 ".cgi" =&gt; "/usr/bin/python,
141 ".py" =&gt; "/usr/bin/python
142 )
143 }
144 </pre>
145 <p>
146 Para as mudanças fazerem efeito e para usar os seus primeiros scripts de CGI no
147 SliTaz, apenas reinicie o servidor LightTPD:
148 </p>
149 <pre> # /etc/init.d/lighttpd restart
150 </pre>
151 <a name="auth"></a>
152 <h3>Autenticação - Proteção para os diretórios</h3>
153 <p>
154 LightTPD provê módulos de autenticação que podem, por exemplo, proteger um
155 diretório. O servidor oferece vários métodos de autenticação, mas nós começaremos
156 usando o método básico sem codificar qualquer password. Para poder usar o módulo
157 <code>mod_auth</code> você tem que instalar o pacote lighttpd-modules
158 (<code>tazpkg get-install lighttpd-modules</code>). Uma vez instalado, o
159 <code>mod_auth</code> deve ser adicionado à lista de módulos:
160 </p>
161 <pre class="script"># Modules to load.
162 # See /usr/lib/lighttpd for all available modules.
163 #
164 server.modules = (
165 "mod_access",
166 "mod_auth",
167 "...",
168 )
169 </pre>
170 <p>
171 Agora você pode configurar os módulos especificando o nível de depuração (debug)
172 e método (<code>plain</code>) e o caminho para o arquivo que contém uma lista de
173 nomes usando uma password protegida para ter acesso aos diretórios. Você também
174 tem que definir os diretórios que requerem autorização. Neste exemplo nós
175 protegeremos o diretório <code>/admin</code> e autorizaremos o acesso para o
176 usuário hacker (<code>user=hacker</code>):
177 </p>
178 <pre class="script"># Authentication for protected directory.
179 auth.debug = 2
180 auth.backend = "plain"
181 auth.backend.plain.userfile = "/etc/lighttpd/plain.passwd"
182 auth.require = ( "/admin/" =&gt;
183 (
184 "method" =&gt; "basic",
185 "realm" =&gt; "Password protected area",
186 "require" =&gt; "user=hacker"
187 )
188 )
189 </pre>
190 <p>
191 Finalmente, nós vamos criar agora o arquivo que contém as passwords, adicionar
192 um usuário e reiniciar o servidor para testar. A sintaxe básica para o arquivo
193 é <code>user:password</code>. Você pode criar o arquivo e pode adicionar um
194 usuário com o comando <code>echo</code> ou pode editar com seu editor de texto
195 favorito. Para acrescentar <code>hacker:root</code> ao arquivo de passwords
196 <code>/etc/lighttpd/plain.passwd</code>:
197 </p>
198 <pre> # echo "hacker:root" &gt; /etc/lighttpd/plain.passwd
199 Ou :
200 # nano /etc/lighttpd/plain.passwd
201 </pre>
202 <p>
203 Para testar o endereço: <strong>http://localhost/admin/</strong>, apenas reinicie
204 o servidor:
205 </p>
206 <pre> # /etc/init.d/lighttpd restart
207 </pre>
208
209 <!-- End of content -->
210 </div>
211
212 <!-- Footer. -->
213 <div id="footer">
214 <div class="footer-right"></div>
215 <a href="web-server.html#top">Topo da Página</a> |
216 <a href="index.html">Conteúdo</a>
217 </div>
218
219 <div id="copy">
220 Copyright © 2008 <a href="http://www.slitaz.org/pt/">SliTaz</a> -
221 <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
222 Documentation is under
223 <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
224 and code is <a href="http://validator.w3.org/">valid xHTML 1.0</a>.
225 </div>
226
227 </body>
228 </html>
229