2002-09-16 19:13:10 +02:00
|
|
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
2002-08-13 22:45:21 +02:00
|
|
|
|
<html>
|
|
|
|
|
<head>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
|
2002-09-16 19:13:10 +02:00
|
|
|
|
<meta http-equiv="Content-Language" content="en-us">
|
2003-05-15 21:39:23 +02:00
|
|
|
|
|
2002-09-16 19:13:10 +02:00
|
|
|
|
<meta name="GENERATOR" content="Microsoft FrontPage 5.0">
|
2003-05-15 21:39:23 +02:00
|
|
|
|
|
2002-09-16 19:13:10 +02:00
|
|
|
|
<meta name="ProgId" content="FrontPage.Editor.Document">
|
2003-05-15 21:39:23 +02:00
|
|
|
|
|
2002-09-16 19:13:10 +02:00
|
|
|
|
<meta http-equiv="Content-Type"
|
|
|
|
|
content="text/html; charset=windows-1252">
|
|
|
|
|
<title>Shorewall QuickStart Guide</title>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
|
2002-09-16 19:13:10 +02:00
|
|
|
|
<meta name="Microsoft Theme" content="none">
|
2002-08-13 22:45:21 +02:00
|
|
|
|
</head>
|
2002-09-16 19:13:10 +02:00
|
|
|
|
<body>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
|
2002-09-16 19:13:10 +02:00
|
|
|
|
<table border="0" cellpadding="0" cellspacing="0"
|
|
|
|
|
style="border-collapse: collapse;" width="100%" id="AutoNumber1"
|
|
|
|
|
bgcolor="#400169" height="90">
|
2003-05-15 21:39:23 +02:00
|
|
|
|
<tbody>
|
|
|
|
|
<tr>
|
|
|
|
|
<td width="100%">
|
|
|
|
|
|
|
|
|
|
<h1 align="center"><font color="#ffffff">Shorewall QuickStart Guides
|
|
|
|
|
(HOWTO's)<br>
|
|
|
|
|
Version 4.0</font></h1>
|
|
|
|
|
</td>
|
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
|
|
</tbody>
|
2002-08-22 23:21:41 +02:00
|
|
|
|
</table>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
|
|
|
|
|
<p align="center">With thanks to Richard who reminded me once again that
|
|
|
|
|
we must all first walk before we can run.<br>
|
|
|
|
|
The French Translations are courtesy of Patrice Vetsel<br>
|
|
|
|
|
</p>
|
|
|
|
|
|
2002-08-13 22:45:21 +02:00
|
|
|
|
<h2>The Guides</h2>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
|
|
|
|
|
<p>These guides provide step-by-step instructions for configuring Shorewall
|
|
|
|
|
in common firewall setups.</p>
|
|
|
|
|
|
2002-11-09 19:06:34 +01:00
|
|
|
|
<p>The following guides are for <b>users who have a single public IP address</b>:</p>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
|
2002-08-13 22:45:21 +02:00
|
|
|
|
<ul>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
<li><a href="standalone.htm">Standalone</a>
|
|
|
|
|
Linux System (<a href="standalone_fr.html">Version Fran<61>aise</a>)</li>
|
|
|
|
|
<li><a href="two-interface.htm">Two-interface</a>
|
|
|
|
|
Linux System acting as a firewall/router for a small local
|
|
|
|
|
network (<a href="two-interface_fr.html">Version Fran<61>aise</a>)</li>
|
|
|
|
|
<li><a href="three-interface.htm">Three-interface</a>
|
|
|
|
|
Linux System acting as a firewall/router for a small local
|
|
|
|
|
network and a DMZ. (<a href="three-interface_fr.html">Version Fran<61>aise</a>)</li>
|
|
|
|
|
|
2002-08-13 22:45:21 +02:00
|
|
|
|
</ul>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
|
|
|
|
|
<p>The above guides are designed to get your first firewall up and running
|
|
|
|
|
quickly in the three most common Shorewall configurations.</p>
|
|
|
|
|
|
|
|
|
|
<p>The <a href="shorewall_setup_guide.htm">Shorewall Setup Guide</a> (See
|
|
|
|
|
Index Below) outlines the steps necessary to set up a firewall
|
|
|
|
|
where <b>there are multiple public IP addresses involved or
|
|
|
|
|
if you want to learn more about Shorewall than is explained in
|
|
|
|
|
the single-address guides above.</b></p>
|
|
|
|
|
|
2002-08-13 22:45:21 +02:00
|
|
|
|
<ul>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
|
2002-08-13 22:45:21 +02:00
|
|
|
|
</ul>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
|
2002-11-24 21:08:19 +01:00
|
|
|
|
<h2><a name="Documentation"></a>Documentation Index</h2>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
|
|
|
|
|
<p>The following documentation covers a variety of topics and <b>supplements
|
|
|
|
|
the <a href="shorewall_quickstart_guide.htm">QuickStart Guides</a>
|
|
|
|
|
described above</b>. Please review the appropriate guide before
|
|
|
|
|
trying to use this documentation directly.</p>
|
|
|
|
|
|
2002-11-24 21:08:19 +01:00
|
|
|
|
<ul>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
<li><a
|
|
|
|
|
href="Shorewall_and_Aliased_Interfaces.html">Aliased (virtual) Interfaces
|
|
|
|
|
(e.g., eth0:0)</a><br>
|
|
|
|
|
</li>
|
|
|
|
|
<li><a href="blacklisting_support.htm">Blacklisting</a>
|
|
|
|
|
|
2002-09-16 19:13:10 +02:00
|
|
|
|
<ul>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
<li>Static Blacklisting using /etc/shorewall/blacklist</li>
|
|
|
|
|
<li>Dynamic Blacklisting using /sbin/shorewall</li>
|
|
|
|
|
|
2003-01-31 22:50:51 +01:00
|
|
|
|
</ul>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
</li>
|
|
|
|
|
<li><a
|
|
|
|
|
href="configuration_file_basics.htm">Common configuration file
|
|
|
|
|
features</a>
|
2002-09-16 19:13:10 +02:00
|
|
|
|
<ul>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
<li><a
|
|
|
|
|
href="configuration_file_basics.htm#Comments">Comments in configuration
|
|
|
|
|
files</a></li>
|
|
|
|
|
<li><a
|
2002-12-29 19:23:07 +01:00
|
|
|
|
href="configuration_file_basics.htm#Continuation">Line Continuation</a></li>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
<li><a href="configuration_file_basics.htm#INCLUDE">INCLUDE Directive</a><br>
|
|
|
|
|
</li>
|
|
|
|
|
<li><a
|
2003-02-28 03:12:52 +01:00
|
|
|
|
href="configuration_file_basics.htm#Ports">Port Numbers/Service Names</a></li>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
<li><a
|
2003-02-20 00:21:55 +01:00
|
|
|
|
href="configuration_file_basics.htm#Ranges">Port Ranges</a></li>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
<li><a
|
2003-01-14 18:18:42 +01:00
|
|
|
|
href="configuration_file_basics.htm#Variables">Using Shell Variables</a></li>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
<li><a
|
2003-01-31 22:50:51 +01:00
|
|
|
|
href="configuration_file_basics.htm#dnsnames">Using DNS Names</a><br>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
</li>
|
|
|
|
|
<li><a
|
|
|
|
|
href="configuration_file_basics.htm#Compliment">Complementing an IP address
|
|
|
|
|
or Subnet</a></li>
|
|
|
|
|
<li><a
|
|
|
|
|
href="configuration_file_basics.htm#Configs">Shorewall Configurations (making
|
|
|
|
|
a test configuration)</a></li>
|
|
|
|
|
<li><a
|
2003-03-07 00:41:31 +01:00
|
|
|
|
href="configuration_file_basics.htm#MAC">Using MAC Addresses in Shorewall</a></li>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
|
2002-09-16 19:13:10 +02:00
|
|
|
|
</ul>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
</li>
|
|
|
|
|
<li><a href="Documentation.htm">Configuration
|
|
|
|
|
File Reference Manual</a>
|
2002-09-16 19:13:10 +02:00
|
|
|
|
<ul>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
<li> <a
|
|
|
|
|
href="Documentation.htm#Variables">params</a></li>
|
|
|
|
|
<li><font color="#000099"><a
|
2002-12-28 16:38:03 +01:00
|
|
|
|
href="Documentation.htm#Zones">zones</a></font></li>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
<li><font color="#000099"><a
|
2002-11-09 19:06:34 +01:00
|
|
|
|
href="Documentation.htm#Interfaces">interfaces</a></font></li>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
<li><font color="#000099"><a
|
2002-12-28 16:38:03 +01:00
|
|
|
|
href="Documentation.htm#Hosts">hosts</a></font></li>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
<li><font color="#000099"><a
|
2002-12-28 16:38:03 +01:00
|
|
|
|
href="Documentation.htm#Policy">policy</a></font></li>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
<li><font color="#000099"><a
|
2002-12-28 16:38:03 +01:00
|
|
|
|
href="Documentation.htm#Rules">rules</a></font></li>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
<li><a href="Documentation.htm#Common">common</a></li>
|
|
|
|
|
<li><font color="#000099"><a
|
2002-12-28 16:38:03 +01:00
|
|
|
|
href="Documentation.htm#Masq">masq</a></font></li>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
<li><font color="#000099"><a
|
2002-11-24 21:08:19 +01:00
|
|
|
|
href="Documentation.htm#ProxyArp">proxyarp</a></font></li>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
<li><font color="#000099"><a
|
2002-12-28 16:38:03 +01:00
|
|
|
|
href="Documentation.htm#NAT">nat</a></font></li>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
<li><font color="#000099"><a
|
2002-11-24 21:08:19 +01:00
|
|
|
|
href="Documentation.htm#Tunnels">tunnels</a></font></li>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
<li><a
|
|
|
|
|
href="traffic_shaping.htm#tcrules">tcrules</a></li>
|
|
|
|
|
<li><font color="#000099"><a
|
2002-12-28 16:38:03 +01:00
|
|
|
|
href="Documentation.htm#Conf">shorewall.conf</a></font></li>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
<li><a href="Documentation.htm#modules">modules</a></li>
|
|
|
|
|
<li><a href="Documentation.htm#TOS">tos</a>
|
|
|
|
|
</li>
|
|
|
|
|
<li><a
|
|
|
|
|
href="Documentation.htm#Blacklist">blacklist</a></li>
|
|
|
|
|
<li><a href="Documentation.htm#rfc1918">rfc1918</a></li>
|
|
|
|
|
<li><a
|
|
|
|
|
href="Documentation.htm#Routestopped">routestopped</a></li>
|
|
|
|
|
|
2002-09-16 19:13:10 +02:00
|
|
|
|
</ul>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
</li>
|
|
|
|
|
<li><a href="dhcp.htm">DHCP</a></li>
|
|
|
|
|
<li><a href="ECN.html">ECN Disabling by host
|
|
|
|
|
or subnet</a><br>
|
|
|
|
|
</li>
|
|
|
|
|
<li><font color="#000099"><a
|
|
|
|
|
href="shorewall_extension_scripts.htm">Extension Scripts</a></font>
|
|
|
|
|
(How to extend Shorewall without modifying Shorewall code through the
|
|
|
|
|
use of files in /etc/shorewall -- /etc/shorewall/start, /etc/shorewall/stopped,
|
|
|
|
|
etc.)</li>
|
|
|
|
|
<li><a href="fallback.htm">Fallback/Uninstall</a></li>
|
|
|
|
|
<li><a
|
|
|
|
|
href="shorewall_firewall_structure.htm">Firewall Structure</a></li>
|
|
|
|
|
<li><font color="#000099"><a
|
|
|
|
|
href="kernel.htm">Kernel Configuration</a></font></li>
|
|
|
|
|
<li><a href="shorewall_logging.html">Logging</a><br>
|
|
|
|
|
</li>
|
|
|
|
|
<li><a href="MAC_Validation.html">MAC Verification</a><br>
|
|
|
|
|
</li>
|
|
|
|
|
<li><a href="myfiles.htm">My Shorewall
|
|
|
|
|
Configuration (How I personally use Shorewall)</a><br>
|
|
|
|
|
</li>
|
|
|
|
|
<li><a href="ping.html">'Ping' Management</a><br>
|
|
|
|
|
</li>
|
|
|
|
|
<li><a href="ports.htm">Port Information</a>
|
|
|
|
|
|
2002-09-16 19:13:10 +02:00
|
|
|
|
<ul>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
<li>Which applications use which ports</li>
|
|
|
|
|
<li>Ports used by Trojans</li>
|
|
|
|
|
|
2002-09-16 19:13:10 +02:00
|
|
|
|
</ul>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
</li>
|
|
|
|
|
<li><a href="ProxyARP.htm">Proxy ARP</a></li>
|
|
|
|
|
<li><a href="samba.htm">Samba</a></li>
|
|
|
|
|
<li><a href="shorewall_setup_guide.htm">Shorewall Setup Guide</a><br>
|
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
<ul>
|
|
|
|
|
<li><a href="shorewall_setup_guide.htm#Introduction">1.0 Introduction</a></li>
|
|
|
|
|
<li><a href="shorewall_setup_guide.htm#Concepts">2.0 Shorewall
|
|
|
|
|
Concepts</a></li>
|
|
|
|
|
<li><a href="shorewall_setup_guide.htm#Interfaces">3.0 Network
|
|
|
|
|
Interfaces</a></li>
|
|
|
|
|
<li><a href="shorewall_setup_guide.htm#Addressing">4.0 Addressing,
|
|
|
|
|
Subnets and Routing</a>
|
|
|
|
|
<ul>
|
|
|
|
|
<li><a href="shorewall_setup_guide.htm#Addresses">4.1 IP Addresses</a></li>
|
|
|
|
|
<li><a href="shorewall_setup_guide.htm#Subnets">4.2 Subnets</a></li>
|
|
|
|
|
<li><a href="shorewall_setup_guide.htm#Routing">4.3 Routing</a></li>
|
|
|
|
|
<li><a href="shorewall_setup_guide.htm#ARP">4.4 Address
|
|
|
|
|
Resolution Protocol (ARP)</a></li>
|
|
|
|
|
|
|
|
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
<ul>
|
|
|
|
|
<li><a href="shorewall_setup_guide.htm#RFC1918">4.5 RFC 1918</a></li>
|
|
|
|
|
|
|
|
|
|
</ul>
|
|
|
|
|
</li>
|
|
|
|
|
<li><a href="shorewall_setup_guide.htm#Options">5.0 Setting
|
|
|
|
|
up your Network</a>
|
|
|
|
|
<ul>
|
|
|
|
|
<li><a href="shorewall_setup_guide.htm#Routed">5.1 Routed</a></li>
|
|
|
|
|
|
|
|
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
<ul>
|
|
|
|
|
<li><a href="shorewall_setup_guide.htm#NonRouted">5.2 Non-routed</a>
|
|
|
|
|
|
|
|
|
|
<ul>
|
|
|
|
|
<li><a href="shorewall_setup_guide.htm#SNAT">5.2.1 SNAT</a></li>
|
|
|
|
|
<li><a href="shorewall_setup_guide.htm#DNAT">5.2.2 DNAT</a></li>
|
|
|
|
|
<li><a href="shorewall_setup_guide.htm#ProxyARP">5.2.3
|
|
|
|
|
Proxy ARP</a></li>
|
|
|
|
|
<li><a href="shorewall_setup_guide.htm#NAT">5.2.4 Static
|
|
|
|
|
NAT</a></li>
|
|
|
|
|
|
|
|
|
|
</ul>
|
|
|
|
|
</li>
|
|
|
|
|
<li><a href="shorewall_setup_guide.htm#Rules">5.3 Rules</a></li>
|
|
|
|
|
<li><a href="shorewall_setup_guide.htm#OddsAndEnds">5.4 Odds
|
|
|
|
|
and Ends</a></li>
|
|
|
|
|
|
|
|
|
|
</ul>
|
|
|
|
|
</li>
|
|
|
|
|
<li><a href="shorewall_setup_guide.htm#DNS">6.0 DNS</a></li>
|
|
|
|
|
<li><a href="shorewall_setup_guide.htm#StartingAndStopping">7.0
|
|
|
|
|
Starting and Stopping the Firewall</a></li>
|
|
|
|
|
|
|
|
|
|
</ul>
|
|
|
|
|
<li><font color="#000099"><a
|
2002-09-16 19:13:10 +02:00
|
|
|
|
href="starting_and_stopping_shorewall.htm">Starting/stopping the Firewall</a></font></li>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
|
2002-11-24 21:08:19 +01:00
|
|
|
|
<ul>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
<li>Description of all /sbin/shorewall commands</li>
|
|
|
|
|
<li>How to safely test a Shorewall configuration
|
|
|
|
|
change<br>
|
|
|
|
|
</li>
|
|
|
|
|
|
2002-11-24 21:08:19 +01:00
|
|
|
|
</ul>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
<li><font color="#000099"><a
|
|
|
|
|
href="NAT.htm">Static NAT</a></font></li>
|
|
|
|
|
<li><a href="Shorewall_Squid_Usage.html">Squid as a Transparent
|
|
|
|
|
Proxy with Shorewall</a><br>
|
|
|
|
|
</li>
|
|
|
|
|
<li><a href="traffic_shaping.htm">Traffic
|
|
|
|
|
Shaping/QOS</a></li>
|
|
|
|
|
<li>VPN
|
2003-03-07 00:41:31 +01:00
|
|
|
|
<ul>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
<li><a href="IPSEC.htm">IPSEC</a></li>
|
|
|
|
|
<li><a href="IPIP.htm">GRE and IPIP</a></li>
|
|
|
|
|
<li><a href="OPENVPN.html">OpenVPN</a><br>
|
|
|
|
|
</li>
|
|
|
|
|
<li><a href="PPTP.htm">PPTP</a></li>
|
|
|
|
|
<li><a href="VPN.htm">IPSEC/PPTP</a> from
|
|
|
|
|
a system behind your firewall to a remote network.</li>
|
|
|
|
|
|
2002-09-16 19:13:10 +02:00
|
|
|
|
</ul>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
</li>
|
|
|
|
|
<li><a
|
|
|
|
|
href="whitelisting_under_shorewall.htm">White List Creation</a></li>
|
|
|
|
|
|
2002-08-13 22:45:21 +02:00
|
|
|
|
</ul>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
|
2002-09-16 19:13:10 +02:00
|
|
|
|
<p>If you use one of these guides and have a suggestion for improvement <a
|
|
|
|
|
href="mailto:webmaster@shorewall.net">please let me know</a>.</p>
|
2003-05-15 21:39:23 +02:00
|
|
|
|
|
|
|
|
|
<p><font size="2">Last modified 5/03/2003 - <a href="support.htm">Tom Eastep</a></font></p>
|
|
|
|
|
|
|
|
|
|
<p><a href="copyright.htm"><font size="2">Copyright 2002, 2003 Thomas M.
|
|
|
|
|
Eastep</font></a><br>
|
|
|
|
|
</p>
|
|
|
|
|
<br>
|
|
|
|
|
<br>
|
2003-04-13 17:28:32 +02:00
|
|
|
|
<br>
|
2003-03-18 02:13:38 +01:00
|
|
|
|
<br>
|
2002-08-13 22:45:21 +02:00
|
|
|
|
</body>
|
2002-09-16 19:13:10 +02:00
|
|
|
|
</html>
|