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>
|
|
|
|
|
<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>
|
2006-03-23 18:18:44 +01:00
|
|
|
<base target="_self">
|
|
|
|
|
<meta name="GENERATOR" content="OpenOffice.org 2.0 (Linux)">
|
|
|
|
|
<meta name="CREATED" content="20040920;15031500">
|
2006-05-30 18:32:57 +02:00
|
|
|
<meta name="CHANGED"
|
|
|
|
|
content="$Id$">
|
2006-03-23 18:18:44 +01:00
|
|
|
</head>
|
|
|
|
|
<body dir="ltr" lang="en-US">
|
|
|
|
|
<h1>Shoreline Firewall (Shorewall)</h1>
|
2006-10-14 23:22:53 +02:00
|
|
|
<p>Copyright
|
2007-01-17 01:09:16 +01:00
|
|
|
© 2001-2007 Thomas M. Eastep</p>
|
2006-03-23 18:18:44 +01:00
|
|
|
<p>Permission is granted to copy, distribute and/or modify this
|
2006-03-11 05:33:26 +01:00
|
|
|
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
|
2006-03-23 18:18:44 +01:00
|
|
|
entitled “<a href="GnuCopyright.htm" target="_self">GNU Free
|
|
|
|
|
Documentation License</a>”.</p>
|
2007-04-13 00:03:15 +02:00
|
|
|
<p>2007-04-12</p>
|
2007-03-24 23:45:05 +01:00
|
|
|
<hr style="width: 100%; height: 2px;">
|
2006-10-16 17:08:31 +02:00
|
|
|
<h2>Table of Contents</h2>
|
2006-03-23 18:18:44 +01:00
|
|
|
<p style="margin-left: 0.42in; margin-bottom: 0in;"><a href="#Intro">Introduction
|
|
|
|
|
to Shorewall</a></p>
|
|
|
|
|
<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>
|
2006-03-23 18:18:44 +01:00
|
|
|
<a href="#GettingStarted">Getting Started with
|
|
|
|
|
Shorewall</a><br>
|
|
|
|
|
<a href="#Info">Looking for Information?</a><br>
|
|
|
|
|
<a href="#License">License</a></p>
|
|
|
|
|
<p style="margin-left: 0.42in;"><br>
|
|
|
|
|
<a href="#Leaf">Leaf</a><br>
|
|
|
|
|
<a href="#OpenWRT">OpenWRT</a><br>
|
|
|
|
|
<a href="#Donations">Donations</a></p>
|
|
|
|
|
<h2><a name="Intro"></a>Introduction to Shorewall</h2>
|
|
|
|
|
<h3><a name="Glossary"></a>Glossary</h3>
|
|
|
|
|
<ul>
|
|
|
|
|
<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>
|
|
|
|
|
</li>
|
|
|
|
|
<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>
|
|
|
|
|
</li>
|
|
|
|
|
<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>
|
|
|
|
|
</li>
|
|
|
|
|
</ul>
|
|
|
|
|
<h3><a name="WhatIs"></a>What is Shorewall?</h3>
|
|
|
|
|
<p style="margin-left: 0.42in;">The Shoreline Firewall, more commonly
|
|
|
|
|
known as "Shorewall", is a high-level tool for configuring
|
2006-03-11 05:33:26 +01:00
|
|
|
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
|
2006-10-20 17:42:06 +02:00
|
|
|
does not use Netfilter's ipchains compatibility mode; as a consequence,
|
|
|
|
|
Shorewall can
|
2006-03-11 05:33:26 +01:00
|
|
|
take advantage of Netfilter's connection state tracking
|
2006-10-20 17:42:06 +02:00
|
|
|
capabilities to create a stateful firewall.<br>
|
2006-03-23 18:18:44 +01:00
|
|
|
<br>
|
|
|
|
|
Shorewall is <u>not</u> a daemon. Once Shorewall
|
2006-10-20 17:42:06 +02:00
|
|
|
has configured Netfilter, it's job is complete and there is
|
|
|
|
|
no Shorewall code left running in the system. The <a
|
2006-03-23 18:18:44 +01:00
|
|
|
href="starting_and_stopping_shorewall.htm">/sbin/shorewall
|
|
|
|
|
program can be used at any time to monitor the Netfilter firewall</a>.</p>
|
|
|
|
|
<p style="margin-left: 0.42in;">Shorewall is not the easiest to use of
|
2006-03-11 05:33:26 +01:00
|
|
|
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
|
2006-03-23 18:18:44 +01:00
|
|
|
the following alternatives:</p>
|
|
|
|
|
<ul>
|
|
|
|
|
<li>
|
|
|
|
|
<p style="margin-bottom: 0in;"><a href="http://www.m0n0.ch/wall">m0n0wall</a>
|
|
|
|
|
(FreeBSD Based) </p>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<p><a href="http://www.fs-security.com/">Firestarter</a></p>
|
|
|
|
|
</li>
|
|
|
|
|
</ul>
|
|
|
|
|
<p style="margin-left: 0.42in;">On the other hand, if you are looking
|
2006-03-11 05:33:26 +01:00
|
|
|
for a Linux firewall solution that can handle complex and fast
|
2006-03-23 18:18:44 +01:00
|
|
|
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 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-02-20 16:33:00 +01:00
|
|
|
<h3><a name="Releases"></a>Current Shorewall Releases</h3>
|
2006-10-16 17:08:31 +02:00
|
|
|
<p style="margin-left: 40px;">The <span style="font-weight: bold;">current
|
2006-10-16 19:20:06 +02:00
|
|
|
Stable Release</span> version
|
2007-04-02 03:11:49 +02:00
|
|
|
is 3.4.2<br>
|
2006-10-16 17:08:31 +02:00
|
|
|
</p>
|
|
|
|
|
<ul style="margin-left: 40px;">
|
|
|
|
|
<li>Here are the <a
|
2007-04-02 03:11:49 +02:00
|
|
|
href="http://www1.shorewall.net/pub/shorewall/3.4/shorewall-3.4.2/releasenotes.txt">release
|
2006-10-16 17:08:31 +02:00
|
|
|
notes</a> <br>
|
|
|
|
|
</li>
|
|
|
|
|
<li>Here are the <a
|
2007-04-02 03:11:49 +02:00
|
|
|
href="http://www1.shorewall.net/pub/shorewall/3.4/shorewall-3.4.2/known_problems.txt">known
|
2006-10-16 17:08:31 +02:00
|
|
|
problems</a> and <a
|
2007-04-02 03:11:49 +02:00
|
|
|
href="http://www1.shorewall.net/pub/shorewall/3.4/shorewall-3.4.2/errata/">updates</a>.</li>
|
2006-10-16 17:08:31 +02:00
|
|
|
</ul>
|
2006-10-16 19:17:34 +02:00
|
|
|
<div style="margin-left: 40px;">The <span style="font-weight: bold;">previous
|
2007-04-08 19:24:09 +02:00
|
|
|
Stable Release</span> version is 3.2.10<br>
|
2006-10-16 19:17:34 +02:00
|
|
|
<ul>
|
|
|
|
|
<li>Here are the <a
|
2007-04-08 19:24:09 +02:00
|
|
|
href="http://www1.shorewall.net/pub/shorewall/3.2/shorewall-3.2.10/releasenotes.txt">release
|
2006-10-16 19:17:34 +02:00
|
|
|
notes</a> <br>
|
|
|
|
|
</li>
|
|
|
|
|
<li>Here are the <a
|
2007-04-08 19:24:09 +02:00
|
|
|
href="http://www1.shorewall.net/pub/shorewall/3.2/shorewall-3.2.10/known_problems.txt">known
|
2006-10-16 19:17:34 +02:00
|
|
|
problems</a> and <a
|
2007-04-08 19:24:09 +02:00
|
|
|
href="http://www1.shorewall.net/pub/shorewall/3.2/shorewall-3.2.10/errata/">updates</a>.</li>
|
2006-10-16 19:17:34 +02:00
|
|
|
</ul>
|
2007-04-02 03:11:49 +02:00
|
|
|
The <span style="font-weight: bold;">current Development
|
2007-04-13 00:03:15 +02:00
|
|
|
Release</span> is 3.9.1<br>
|
2007-04-02 03:11:49 +02:00
|
|
|
<ul>
|
|
|
|
|
<li>Here are the <a
|
2007-04-13 00:03:15 +02:00
|
|
|
href="http://www1.shorewall.net/pub/shorewall/development/3.9/shorewall-3.9.1/releasenotes.txt">release
|
2007-04-02 03:11:49 +02:00
|
|
|
notes</a> <br>
|
|
|
|
|
</li>
|
|
|
|
|
<li>Here are the <a
|
2007-04-13 00:03:15 +02:00
|
|
|
href="http://www1.shorewall.net/pub/shorewall/development/3.9/shorewall-3.9.1/known_problems.txt">known
|
2007-04-02 03:11:49 +02:00
|
|
|
problems</a> and <a
|
2007-04-13 00:03:15 +02:00
|
|
|
href="http://www1.shorewall.net/pub/shorewall/development/3.9/shorewall-3.9.1/errata/">updates</a>.</li>
|
2007-04-02 03:11:49 +02:00
|
|
|
</ul>
|
2007-04-13 01:06:53 +02:00
|
|
|
<div style="margin-left: 40px;">Read about the<a href="Shorewall-4.html">
|
|
|
|
|
New Development Release here</a>.<br>
|
|
|
|
|
</div>
|
2006-10-16 17:08:31 +02:00
|
|
|
</div>
|
2007-03-24 23:45:05 +01:00
|
|
|
<div style="margin-left: 40px;"><br>
|
|
|
|
|
Get them from the <a href="download.htm">download sites</a></div>
|
2006-03-23 18:18:44 +01:00
|
|
|
<h3><a name="GettingStarted"></a>Getting Started with Shorewall</h3>
|
|
|
|
|
<p style="margin-left: 0.42in;">New to Shorewall? Download the current
|
|
|
|
|
Stable version (see above) then select the <a
|
|
|
|
|
href="shorewall_quickstart_guide.htm">QuickStart
|
|
|
|
|
Guide</a> that most closely matches your environment and follow the
|
|
|
|
|
step by step instructions.</p>
|
|
|
|
|
<h3><a name="Info"></a>Looking for Information?</h3>
|
|
|
|
|
<p style="margin-left: 0.42in;">The <a href="Documentation.html">Documentation
|
|
|
|
|
Index</a> is a good place to start as is the Site Search in the frame
|
|
|
|
|
above.</p>
|
|
|
|
|
<h3><a name="License"></a>License</h3>
|
|
|
|
|
<p style="margin-left: 0.42in;">This program is free software; you can
|
|
|
|
|
redistribute it and/or modify it under the terms of <a
|
|
|
|
|
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
|
2006-03-11 05:33:26 +01:00
|
|
|
hope that it will be useful, but WITHOUT ANY WARRANTY; without even
|
|
|
|
|
the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
|
2006-03-23 18:18:44 +01:00
|
|
|
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
|
2005-10-05 20:11:56 +02:00
|
|
|
GNU General Public License along with this program; if not, write to
|
2006-03-11 05:33:26 +01:00
|
|
|
the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA
|
2006-03-23 18:18:44 +01:00
|
|
|
02139, USA</p>
|
|
|
|
|
<p style="margin-left: 0.42in;">Permission is granted to copy,
|
2006-03-11 05:33:26 +01:00
|
|
|
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
|
2006-03-23 18:18:44 +01:00
|
|
|
of the license is included in the section entitled "GNU Free
|
|
|
|
|
Documentation License".</p>
|
|
|
|
|
<hr>
|
|
|
|
|
<h2><a name="Leaf"></a>Leaf</h2>
|
|
|
|
|
<p><font color="#000080"><a href="http://leaf.sourceforge.net/"
|
|
|
|
|
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>
|
2005-10-05 20:11:56 +02:00
|
|
|
LEAF is an open source project which provides a Firewall/router on a
|
|
|
|
|
floppy, CD or CF. Several LEAF distributions including Bering and
|
2006-03-23 18:18:44 +01:00
|
|
|
Bering-uClibc use Shorewall as their Netfilter configuration tool.</p>
|
|
|
|
|
<hr>
|
|
|
|
|
<h2><a name="OpenWRT"></a>OpenWRT</h2>
|
|
|
|
|
<p style="margin-bottom: 0in;"><font color="#000000"><a
|
|
|
|
|
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
|
2005-10-05 20:11:56 +02:00
|
|
|
is a project which provides open source firmware for Linksys WRT54G
|
|
|
|
|
wireless routers. Two different Shorewall packages are available for
|
2006-03-23 18:18:44 +01:00
|
|
|
OpenWRT.</p>
|
|
|
|
|
<hr>
|
|
|
|
|
<h2><a name="Donations"></a>Donations</h2>
|
|
|
|
|
<p><a href="http://www.alz.org/" target="_top"><font color="#000080"><img
|
|
|
|
|
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
|
2006-03-11 05:33:26 +01:00
|
|
|
is free but if you try it and find it useful, please consider making
|
2006-03-23 18:18:44 +01:00
|
|
|
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>
|
|
|
|
|
<br>
|
|
|
|
|
Thank You</p>
|
|
|
|
|
<p align="left"><br>
|
|
|
|
|
<br>
|
|
|
|
|
</p>
|
|
|
|
|
</body>
|
|
|
|
|
</html>
|
