2004-09-24 00:58:32 +02:00
|
|
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
2006-03-23 18:18:44 +01:00
|
|
|
|
<html>
|
|
|
|
|
|
<head>
|
2007-04-23 00:01:55 +02:00
|
|
|
|
<meta http-equiv="CONTENT-TYPE" content="text/html; charset=UTF-8">
|
2006-10-16 17:08:31 +02:00
|
|
|
|
<title>Shoreline Firewall (Shorewall) 3.*</title>
|
2007-04-23 00:01:55 +02:00
|
|
|
|
<base target="_self">
|
2006-03-23 18:18:44 +01:00
|
|
|
|
<meta name="CREATED" content="20040920;15031500">
|
2006-05-30 18:32:57 +02:00
|
|
|
|
<meta name="CHANGED"
|
2007-04-23 00:01:55 +02:00
|
|
|
|
content="$Id$">
|
2006-03-23 18:18:44 +01:00
|
|
|
|
</head>
|
2007-04-23 00:01:55 +02:00
|
|
|
|
|
2006-03-23 18:18:44 +01:00
|
|
|
|
<body dir="ltr" lang="en-US">
|
|
|
|
|
|
<h1>Shoreline Firewall (Shorewall)</h1>
|
2007-04-23 00:01:55 +02:00
|
|
|
|
|
|
|
|
|
|
<p>Copyright © 2001-2007 Thomas M. Eastep</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>Permission is granted to copy, distribute and/or modify this document
|
|
|
|
|
|
under the terms of the GNU Free Documentation License, Version 1.2 or any
|
|
|
|
|
|
later version published by the Free Software Foundation; with no Invariant
|
|
|
|
|
|
Sections, with no Front-Cover, and with no Back-Cover Texts. A copy of the
|
|
|
|
|
|
license is included in the section entitled “<a href="GnuCopyright.htm"
|
|
|
|
|
|
target="_self">GNU Free Documentation License</a>”.</p>
|
|
|
|
|
|
|
2007-08-22 15:58:23 +02:00
|
|
|
|
<p>2007-08-22</p>
|
2007-03-24 23:45:05 +01:00
|
|
|
|
<hr style="width: 100%; height: 2px;">
|
2007-08-22 15:58:23 +02:00
|
|
|
|
<hr>
|
|
|
|
|
|
|
2006-10-16 17:08:31 +02:00
|
|
|
|
<h2>Table of Contents</h2>
|
2007-04-23 00:01:55 +02:00
|
|
|
|
|
2007-05-19 18:39:13 +02:00
|
|
|
|
<p style="margin-left: 0.42in; margin-bottom: 0in;"><a
|
|
|
|
|
|
href="#Intro">Introduction to Shorewall</a> </p>
|
2007-04-23 00:01:55 +02:00
|
|
|
|
|
|
|
|
|
|
<p style="margin-left: 0.83in; margin-bottom: 0in;"><a
|
|
|
|
|
|
href="#Glossary">Glossary</a><br>
|
|
|
|
|
|
<a href="#WhatIs">What is Shorewall?</a><br>
|
2007-02-20 16:33:00 +01:00
|
|
|
|
<a href="#Releases">Current Shorewall Releases</a><br>
|
2007-04-23 00:01:55 +02:00
|
|
|
|
<a href="#GettingStarted">Getting Started with Shorewall</a><br>
|
2006-03-23 18:18:44 +01:00
|
|
|
|
<a href="#Info">Looking for Information?</a><br>
|
2007-08-22 20:45:12 +02:00
|
|
|
|
<a href="#License">License</a></p?
|
|
|
|
|
|
|
2007-04-23 00:01:55 +02:00
|
|
|
|
|
2006-03-23 18:18:44 +01:00
|
|
|
|
<p style="margin-left: 0.42in;"><br>
|
2007-08-22 20:45:12 +02:00
|
|
|
|
<a href="#Notice"><strong>Important Notice to users of Shorewall Multi-ISP
|
|
|
|
|
|
Feature</strong></a><br>
|
2006-03-23 18:18:44 +01:00
|
|
|
|
<a href="#Leaf">Leaf</a><br>
|
|
|
|
|
|
<a href="#OpenWRT">OpenWRT</a><br>
|
|
|
|
|
|
<a href="#Donations">Donations</a></p>
|
2007-04-23 00:01:55 +02:00
|
|
|
|
|
2006-03-23 18:18:44 +01:00
|
|
|
|
<h3><a name="Glossary"></a>Glossary</h3>
|
|
|
|
|
|
<ul>
|
2007-04-23 00:01:55 +02:00
|
|
|
|
<li><p style="margin-bottom: 0in;"><a href="http://www.netfilter.org/"
|
|
|
|
|
|
target="_top">Netfilter</a> - the packet filter facility built into the
|
|
|
|
|
|
2.4 and later Linux kernels.</p>
|
2006-03-23 18:18:44 +01:00
|
|
|
|
</li>
|
2007-04-23 00:01:55 +02:00
|
|
|
|
<li><p style="margin-bottom: 0in;">ipchains - the packet filter facility
|
|
|
|
|
|
built into the 2.2 Linux kernels. Also the name of the utility program
|
|
|
|
|
|
used to configure and control that facility. Netfilter can be used in
|
|
|
|
|
|
ipchains compatibility mode.</p>
|
2006-03-23 18:18:44 +01:00
|
|
|
|
</li>
|
2007-04-23 00:01:55 +02:00
|
|
|
|
<li><p>iptables - the utility program used to configure and control
|
|
|
|
|
|
Netfilter. The term 'iptables' is often used to refer to the combination
|
|
|
|
|
|
of iptables+Netfilter (with Netfilter not in ipchains compatibility
|
|
|
|
|
|
mode).</p>
|
2006-03-23 18:18:44 +01:00
|
|
|
|
</li>
|
|
|
|
|
|
</ul>
|
2007-04-23 00:01:55 +02:00
|
|
|
|
|
2006-03-23 18:18:44 +01:00
|
|
|
|
<h3><a name="WhatIs"></a>What is Shorewall?</h3>
|
2007-04-23 00:01:55 +02:00
|
|
|
|
|
|
|
|
|
|
<p style="margin-left: 0.42in;">The Shoreline Firewall, more commonly known
|
|
|
|
|
|
as "Shorewall", is a high-level tool for configuring Netfilter. You describe
|
|
|
|
|
|
your firewall/gateway requirements using entries in a set of configuration
|
|
|
|
|
|
files. Shorewall reads those configuration files and with the help of the
|
|
|
|
|
|
iptables utility, Shorewall configures Netfilter to match your requirements.
|
|
|
|
|
|
Shorewall can be used on a dedicated firewall system, a multi-function
|
|
|
|
|
|
gateway/router/server or on a standalone GNU/Linux system. Shorewall does not
|
|
|
|
|
|
use Netfilter's ipchains compatibility mode; as a consequence, Shorewall can
|
|
|
|
|
|
take advantage of Netfilter's connection state tracking capabilities to
|
|
|
|
|
|
create a stateful firewall.<br>
|
2006-03-23 18:18:44 +01:00
|
|
|
|
<br>
|
2007-04-23 00:01:55 +02:00
|
|
|
|
Shorewall is <u>not</u> a daemon. Once Shorewall has configured Netfilter,
|
|
|
|
|
|
it's job is complete and there is no Shorewall code left running in the
|
2007-07-19 16:39:20 +02:00
|
|
|
|
system. The <a href="starting_and_stopping_shorewall.htm">/sbin/shorewall
|
2006-03-23 18:18:44 +01:00
|
|
|
|
program can be used at any time to monitor the Netfilter firewall</a>.</p>
|
2007-04-23 00:01:55 +02:00
|
|
|
|
|
|
|
|
|
|
<p style="margin-left: 0.42in;">Shorewall is not the easiest to use of the
|
|
|
|
|
|
available iptables configuration tools but I believe that it is the most
|
|
|
|
|
|
flexible and powerful. So if you are looking for a simple point-and-click
|
|
|
|
|
|
set-and-forget Linux firewall solution that requires a minimum of networking
|
|
|
|
|
|
knowledge, I would encourage you to check out the following alternatives:</p>
|
2006-03-23 18:18:44 +01:00
|
|
|
|
<ul>
|
2007-04-23 00:01:55 +02:00
|
|
|
|
<li><p style="margin-bottom: 0in;"><a
|
|
|
|
|
|
href="http://www.m0n0.ch/wall">m0n0wall</a> (FreeBSD Based) </p>
|
2006-03-23 18:18:44 +01:00
|
|
|
|
</li>
|
2007-04-23 00:01:55 +02:00
|
|
|
|
<li><p><a href="http://www.fs-security.com/">Firestarter</a></p>
|
2006-03-23 18:18:44 +01:00
|
|
|
|
</li>
|
|
|
|
|
|
</ul>
|
2007-04-23 00:01:55 +02:00
|
|
|
|
|
|
|
|
|
|
<p style="margin-left: 0.42in;">On the other hand, if you are looking for a
|
|
|
|
|
|
Linux firewall solution that can handle complex and fast changing network
|
|
|
|
|
|
environments then Shorewall is a logical choice.</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p style="margin-left: 0.42in;">To see some of the many things that you can
|
2007-07-19 16:39:20 +02:00
|
|
|
|
do with Shorewall, see the <a href="shorewall_features.htm">Shorewall
|
2006-10-16 17:08:31 +02:00
|
|
|
|
Features page</a>.<br>
|
|
|
|
|
|
</p>
|
2007-04-23 00:01:55 +02:00
|
|
|
|
|
2007-02-20 16:33:00 +01:00
|
|
|
|
<h3><a name="Releases"></a>Current Shorewall Releases</h3>
|
2007-04-23 00:01:55 +02:00
|
|
|
|
|
2006-10-16 17:08:31 +02:00
|
|
|
|
<p style="margin-left: 40px;">The <span style="font-weight: bold;">current
|
2007-08-10 19:37:02 +02:00
|
|
|
|
Stable Release</span> version is 4.0.2<br>
|
2006-10-16 17:08:31 +02:00
|
|
|
|
</p>
|
|
|
|
|
|
<ul style="margin-left: 40px;">
|
|
|
|
|
|
<li>Here are the <a
|
2007-08-10 19:37:02 +02:00
|
|
|
|
href="http://www1.shorewall.net/pub/shorewall/4.0/shorewall-4.0.2/releasenotes.txt">release
|
2007-04-23 00:01:55 +02:00
|
|
|
|
notes</a> <br>
|
2006-10-16 17:08:31 +02:00
|
|
|
|
</li>
|
|
|
|
|
|
<li>Here are the <a
|
2007-08-10 19:37:02 +02:00
|
|
|
|
href="http://www1.shorewall.net/pub/shorewall/4.0/shorewall-4.0.2/known_problems.txt">known
|
2007-04-23 00:01:55 +02:00
|
|
|
|
problems</a> and <a
|
2007-08-10 19:37:02 +02:00
|
|
|
|
href="http://www1.shorewall.net/pub/shorewall/4.0/shorewall-4.0.2/errata/">updates</a>.
|
2007-07-20 04:24:34 +02:00
|
|
|
|
<p>Read more about the <a href="Shorewall-4.html">Release here</a>.<br>
|
2007-07-17 22:10:12 +02:00
|
|
|
|
</p>
|
|
|
|
|
|
</li>
|
2006-10-16 17:08:31 +02:00
|
|
|
|
</ul>
|
2007-04-23 00:01:55 +02:00
|
|
|
|
|
|
|
|
|
|
<div style="margin-left: 40px;">
|
|
|
|
|
|
The <span style="font-weight: bold;">previous Stable Release</span> version
|
2007-08-19 17:46:51 +02:00
|
|
|
|
is 3.4.6<br>
|
2007-04-23 00:01:55 +02:00
|
|
|
|
|
2006-10-16 19:17:34 +02:00
|
|
|
|
<ul>
|
|
|
|
|
|
<li>Here are the <a
|
2007-08-19 17:46:51 +02:00
|
|
|
|
href="http://www1.shorewall.net/pub/shorewall/3.4/shorewall-3.4.6/releasenotes.txt">release
|
2007-04-23 00:01:55 +02:00
|
|
|
|
notes</a> <br>
|
2006-10-16 19:17:34 +02:00
|
|
|
|
</li>
|
|
|
|
|
|
<li>Here are the <a
|
2007-08-19 17:46:51 +02:00
|
|
|
|
href="http://www1.shorewall.net/pub/shorewall/3.4/shorewall-3.4.6/known_problems.txt">known
|
2007-04-23 00:01:55 +02:00
|
|
|
|
problems</a> and <a
|
2007-08-19 17:46:51 +02:00
|
|
|
|
href="http://www1.shorewall.net/pub/shorewall/3.4/shorewall-3.4.6/errata/">updates</a>.</li>
|
2006-10-16 19:17:34 +02:00
|
|
|
|
</ul>
|
2007-04-23 00:01:55 +02:00
|
|
|
|
The <span style="font-weight: bold;">current Development Release</span> is
|
2007-07-19 16:39:20 +02:00
|
|
|
|
4.1. No packages yet been made available for this release. </div>
|
2007-04-23 00:01:55 +02:00
|
|
|
|
|
|
|
|
|
|
<div style="margin-left: 40px;">
|
2007-07-19 16:39:20 +02:00
|
|
|
|
<p>Get them from the <a href="download.htm">download sites</a></p>
|
|
|
|
|
|
</div>
|
2007-04-23 00:01:55 +02:00
|
|
|
|
|
2006-03-23 18:18:44 +01:00
|
|
|
|
<h3><a name="GettingStarted"></a>Getting Started with Shorewall</h3>
|
2007-04-23 00:01:55 +02:00
|
|
|
|
|
|
|
|
|
|
<p style="margin-left: 0.42in;">New to Shorewall? Download the current Stable
|
|
|
|
|
|
version (see above) then select the <a
|
2007-07-20 04:24:34 +02:00
|
|
|
|
href="shorewall_quickstart_guide.htm">QuickStart Guide</a> that most closely
|
|
|
|
|
|
matches your environment and follow the step by step instructions.</p>
|
2007-04-23 00:01:55 +02:00
|
|
|
|
|
2006-03-23 18:18:44 +01:00
|
|
|
|
<h3><a name="Info"></a>Looking for Information?</h3>
|
2007-04-23 00:01:55 +02:00
|
|
|
|
|
|
|
|
|
|
<p style="margin-left: 0.42in;">The <a
|
2007-07-20 04:24:34 +02:00
|
|
|
|
href="Documentation.html">Documentation Index</a> is a good place to start as
|
|
|
|
|
|
is the Site Search in the frame above.</p>
|
2007-04-23 00:01:55 +02:00
|
|
|
|
|
2006-03-23 18:18:44 +01:00
|
|
|
|
<h3><a name="License"></a>License</h3>
|
2007-04-23 00:01:55 +02:00
|
|
|
|
|
2006-03-23 18:18:44 +01:00
|
|
|
|
<p style="margin-left: 0.42in;">This program is free software; you can
|
|
|
|
|
|
redistribute it and/or modify it under the terms of <a
|
2007-04-23 00:01:55 +02:00
|
|
|
|
href="http://www.gnu.org/licenses/gpl.html">Version 2 of the GNU General
|
|
|
|
|
|
Public License</a> as published by the Free Software Foundation.</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p style="margin-left: 0.42in;">This program is distributed in the hope that
|
|
|
|
|
|
it will be useful, but WITHOUT ANY WARRANTY; without even the implied
|
|
|
|
|
|
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
|
|
|
|
General Public License for more detail.</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p style="margin-left: 0.42in;">You should have received a copy of the GNU
|
|
|
|
|
|
General Public License along with this program; if not, write to the Free
|
|
|
|
|
|
Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p style="margin-left: 0.42in;">Permission is granted to copy, distribute
|
|
|
|
|
|
and/or modify this document under the terms of the GNU Free Documentation
|
|
|
|
|
|
License, Version 1.2 or any later version published by the Free Software
|
|
|
|
|
|
Foundation; with no Invariant Sections, with no Front-Cover, and with no
|
|
|
|
|
|
Back-Cover Texts. A copy of the license is included in the section entitled
|
|
|
|
|
|
"GNU Free Documentation License".</p>
|
2006-03-23 18:18:44 +01:00
|
|
|
|
<hr>
|
2007-04-23 00:01:55 +02:00
|
|
|
|
|
2007-08-22 20:45:12 +02:00
|
|
|
|
<h2><a name="Notice">Important Notice to Users of Shorewall's Multi-ISP
|
|
|
|
|
|
Feature</a></h2>
|
|
|
|
|
|
|
|
|
|
|
|
<p>A bug in Shorewall versions 3.2.0-3.2.10, 3.4.0-3.4.6 and Shorewall-shell
|
|
|
|
|
|
4.0.0-4.0.2 prevents proper handling of PREROUTING marks when
|
|
|
|
|
|
HIGH_ROUTE_MARKS=No and the <strong>track</strong> option is specified.
|
|
|
|
|
|
Patches are available to correct this problem:</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>Shorewall version 3.2.0-3.2.10, 3.4.0-3.4.3: <a
|
|
|
|
|
|
href="http://www1.shorewall.net/pub/shorewall/3.2/shorewall-3.2.10/errata/patches/Shorewall/patch-3.2.10-2.diff">http://www1.shorewall.net/pub/shorewall/3.2/shorewall-3.2.10/errata/patches/Shorewall/patch-3.2.10-2.diff</a></p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>Shorewall version 3.4.4-3.4.6: <a
|
|
|
|
|
|
href="http://www1.shorewall.net/pub/shorewall/3.4/shorewall-3.4.6/errata/patches/Shorewall/patch-3.4.6-1.diff">http://www1.shorewall.net/pub/shorewall/3.4/shorewall-3.4.6/errata/patches/Shorewall/patch-3.4.6-1.diff</a></p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>Shorewall-shell version 4.0.0-4.0.2: <a
|
|
|
|
|
|
href="http://www1.shorewall.net/pub/shorewall/4.0/shorewall-4.0.2/errata/patches/Shorewall-shell/patch-shell-4.0.2-2.diff">http://www1.shorewall.net/pub/shorewall/4.0/shorewall-4.0.2/errata/patches/Shorewall-shell/patch-shell-4.0.2-2.diff</a></p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>Note that a patch may succeed with an offset when applied to a release
|
|
|
|
|
|
other than the one for which it was specifically prepared. For example, when
|
|
|
|
|
|
the patch for 3.2.0-3.2.10, 3.4.0-3.4.3 (which was prepared for release
|
|
|
|
|
|
3.2.10) is applied to release 3.4.3, the following is the result:</p>
|
|
|
|
|
|
<pre>root@wookie:~# <strong>cd /usr/share/shorewall</strong>
|
|
|
|
|
|
root@wookie:<strong>/usr/share/shorewall# patch < ~/shorewall/tags/3.2.10/Shorewall.updated/patch-3.2.10-2.diff</strong>
|
|
|
|
|
|
patching file compiler
|
|
|
|
|
|
Hunk #1 succeeded at 958 (offset -1669 lines).
|
|
|
|
|
|
root@wookie:/usr/share/shorewall#</pre>
|
|
|
|
|
|
|
|
|
|
|
|
<p></p>
|
|
|
|
|
|
<hr>
|
|
|
|
|
|
|
2006-03-23 18:18:44 +01:00
|
|
|
|
<h2><a name="Leaf"></a>Leaf</h2>
|
2007-04-23 00:01:55 +02:00
|
|
|
|
|
2006-03-23 18:18:44 +01:00
|
|
|
|
<p><font color="#000080"><a href="http://leaf.sourceforge.net/"
|
2007-04-23 00:01:55 +02:00
|
|
|
|
target="_top"><font color="#000080"><img src="images/leaflogo.gif"
|
|
|
|
|
|
name="Graphic1" alt="(Leaf Logo)" align="bottom" border="1" height="39"
|
|
|
|
|
|
width="52" /></font></a></font> LEAF is an open source project which provides
|
|
|
|
|
|
a Firewall/router on a floppy, CD or CF. Several LEAF distributions including
|
|
|
|
|
|
Bering and Bering-uClibc use Shorewall as their Netfilter configuration
|
|
|
|
|
|
tool.</p>
|
2006-03-23 18:18:44 +01:00
|
|
|
|
<hr>
|
2007-04-23 00:01:55 +02:00
|
|
|
|
|
2006-03-23 18:18:44 +01:00
|
|
|
|
<h2><a name="OpenWRT"></a>OpenWRT</h2>
|
2007-04-23 00:01:55 +02:00
|
|
|
|
|
2006-03-23 18:18:44 +01:00
|
|
|
|
<p style="margin-bottom: 0in;"><font color="#000000"><a
|
2007-04-23 00:01:55 +02:00
|
|
|
|
href="http://openwrt.org/"><font color="#000080"><img
|
|
|
|
|
|
src="images/openwrt.png" name="graphics1" alt="(OpenWRT Logo)" align="bottom"
|
|
|
|
|
|
border="1" height="34" hspace="4" width="91" /></font></a></font>OpenWRT is a
|
|
|
|
|
|
project which provides open source firmware for Linksys WRT54G wireless
|
|
|
|
|
|
routers. Two different Shorewall packages are available for OpenWRT.</p>
|
2006-03-23 18:18:44 +01:00
|
|
|
|
<hr>
|
2007-04-23 00:01:55 +02:00
|
|
|
|
|
2006-03-23 18:18:44 +01:00
|
|
|
|
<h2><a name="Donations"></a>Donations</h2>
|
2007-04-23 00:01:55 +02:00
|
|
|
|
|
2006-03-23 18:18:44 +01:00
|
|
|
|
<p><a href="http://www.alz.org/" target="_top"><font color="#000080"><img
|
2007-04-23 00:01:55 +02:00
|
|
|
|
src="images/alz_logo2.gif" name="Graphic2"
|
|
|
|
|
|
alt="(Alzheimer's Association Logo)" align="right" border="1" height="66"
|
|
|
|
|
|
width="306" /></font></a><a href="http://www.starlight.org/"
|
|
|
|
|
|
target="_top"><font color="#000080"><img src="images/newlog.gif"
|
|
|
|
|
|
name="Graphic3" alt="(Starlight Foundation Logo)" align="right" border="1"
|
|
|
|
|
|
height="108" width="65" /></font></a>Shorewall is free but if you try it and
|
|
|
|
|
|
find it useful, please consider making a donation to the <a
|
|
|
|
|
|
href="http://www.alz.org/" target="_top">Alzheimer's Association</a> or to
|
|
|
|
|
|
the <a href="http://www.starlight.org/" target="_top">Starlight Children's
|
|
|
|
|
|
Foundation</a>. <br>
|
2006-03-23 18:18:44 +01:00
|
|
|
|
<br>
|
|
|
|
|
|
Thank You</p>
|
2007-04-23 00:01:55 +02:00
|
|
|
|
|
2006-03-23 18:18:44 +01:00
|
|
|
|
<p align="left"><br>
|
|
|
|
|
|
<br>
|
|
|
|
|
|
</p>
|
|
|
|
|
|
</body>
|
|
|
|
|
|
</html>
|
