mirror of
https://gitlab.com/shorewall/code.git
synced 2024-12-26 08:08:59 +01:00
b31dbd1bc6
git-svn-id: https://shorewall.svn.sourceforge.net/svnroot/shorewall/trunk@2728 fbd18981-670d-0410-9b5c-8dc0c1a9a2bb
278 lines
11 KiB
HTML
278 lines
11 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
|
|
|
<html>
|
|
<head>
|
|
<meta name="generator" content=
|
|
"HTML Tidy for Linux (vers 1st April 2002), see www.w3.org">
|
|
<meta http-equiv="CONTENT-TYPE" content=
|
|
"text/html; charset=utf-8">
|
|
|
|
<title>Shoreline Firewall (Shorewall) 2.0</title>
|
|
<base target="_self">
|
|
<meta name="GENERATOR" content="OpenOffice.org 1.1.1 (Linux)">
|
|
<meta name="CREATED" content="20040920;15031500">
|
|
<meta name="CHANGED" content="20040920;15183300">
|
|
</head>
|
|
|
|
<body dir="ltr" lang="en-US">
|
|
<h1>Shorewall 2.x</h1>
|
|
|
|
<h2><a href="News.htm#20050717"><font color="#ff0000">Security
|
|
vulnerability in Shorewall 2.x</font></a></h2>
|
|
<hr style="width: 100%; height: 2px;">
|
|
|
|
<p>The information on this site applies only to 2.x releases of
|
|
Shorewall. For older versions:</p>
|
|
|
|
<ul>
|
|
<li>
|
|
<p style="margin-bottom: 0in;">The 1.4 site is <a href=
|
|
"http://www.shorewall.net/1.4" target="_top">here.</a></p>
|
|
</li>
|
|
|
|
<li>
|
|
<p style="margin-bottom: 0in;">The 1.3 site is <a href=
|
|
"http://www.shorewall.net/1.3" target="_top">here.</a></p>
|
|
</li>
|
|
|
|
<li>
|
|
<p>The 1.2 site is <a href="http://shorewall.net/1.2/"
|
|
target="_top">here</a>.</p>
|
|
</li>
|
|
</ul>
|
|
|
|
<p>The current 2.4 Stable Release is 2.4.4 -- Here are the <a
|
|
href=
|
|
"http://shorewall.net/pub/shorewall/2.4/shorewall-2.4.4/releasenotes.txt">
|
|
release notes</a> and here are the <a href=
|
|
"http://shorewall.net/pub/shorewall/2.4/shorewall-2.4.4/known_problems.txt">
|
|
known problems</a> and <a href=
|
|
"http://shorewall.net/pub/shorewall/2.4/shorewall-2.4.4/errata/">
|
|
updates</a>.<br>
|
|
<br>
|
|
The current 2.5 Development Release is 2.5.6 -- Here are the <a
|
|
href=
|
|
"http://shorewall.net/pub/shorewall/2.5/shorewall-2.5.6/releasenotes.txt">
|
|
release notes</a> and the preliminary documentation is <a href=
|
|
"http://www1.shorewall.net/3.0/index.html">here</a>.<br>
|
|
<br>
|
|
Copyright © 2001-2005 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>
|
|
|
|
<p>2005-09-17</p>
|
|
<hr style="width: 100%; height: 2px;">
|
|
|
|
<h3>Table of Contents</h3>
|
|
|
|
<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>
|
|
<a href="#GettingStarted">Getting Started with
|
|
Shorewall</a><br>
|
|
<a href="#Info">Looking for Information?</a><br>
|
|
<a href="#Mandrake">Running Shorewall on Mandrake® with a
|
|
two-interface setup?</a><br>
|
|
<a href="#License">License</a><br>
|
|
</p>
|
|
|
|
<div style="margin-left: 40px;">
|
|
<br>
|
|
<a href="#Leaf">Leaf</a><br>
|
|
<br>
|
|
<a href="#OpenWRT">OpenWRT</a><br>
|
|
</div>
|
|
|
|
<p style="margin-left: 40px;"><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 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 and can thus take advantage of
|
|
Netfilter's <a href=
|
|
"http://www.cs.princeton.edu/%7Ejns/security/iptables/iptables_conntrack.html"
|
|
target="_top">connection state tracking capabilities</a>.<br>
|
|
<br>
|
|
Shorewall is <u>not</u> a daemon. Once Shorewall has configured
|
|
Netfilter, it's job is complete. After that, there is no
|
|
Shorewall code running although the <a href=
|
|
"starting_and_stopping_shorewall.htm">/sbin/shorewall program
|
|
can be used at any time to monitor the Netfilter
|
|
firewall</a>.<br>
|
|
</p>
|
|
|
|
<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>
|
|
|
|
<ul style="margin-left: 40px;">
|
|
<li><a href=
|
|
"http://www.m0n0.ch/wall">http://www.m0n0.ch/wall</a></li>
|
|
|
|
<li><a href=
|
|
"http://www.fs-security.com/">http://www.fs-security.com/</a><br>
|
|
|
|
</li>
|
|
</ul>
|
|
|
|
<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.<br>
|
|
</p>
|
|
|
|
<h3><a name="GettingStarted"></a>Getting Started with
|
|
Shorewall</h3>
|
|
|
|
<p style="margin-left: 0.42in;">New to Shorewall? Start by
|
|
selecting 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_Index.html">Documentation Index</a> is a good
|
|
place to start as is the Site Search in the frame above.<br>
|
|
</p>
|
|
|
|
<h3><a name="Mandrake"></a>Running Shorewall on Mandrake® with
|
|
a two-interface setup?</h3>
|
|
|
|
<p style="margin-left: 0.42in;">If so, the documentation on
|
|
this site will not apply directly to your setup. If you want to
|
|
use the documentation that you find here, you will want to
|
|
consider uninstalling what you have and installing a setup that
|
|
matches the documentation on this site. See the <a href=
|
|
"two-interface.htm">Two-interface QuickStart Guide</a> for
|
|
details.<br>
|
|
<br>
|
|
<b>Update:</b> I have been informed by Mandrake Development
|
|
that this problem has been corrected in Mandrake 10.0 Final
|
|
(the problem still exists in the 10.0 Community release).</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 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>
|
|
<hr>
|
|
|
|
<h2><a name="Leaf"></a>Leaf</h2>
|
|
|
|
<p><a href="http://leaf.sourceforge.net/" target="_top"><font
|
|
color="#000000"><img src="images/leaflogo.gif" name="Graphic1"
|
|
alt="(Leaf Logo)" align="bottom" border="1" height="39" width=
|
|
"52"></font></a> 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>
|
|
<hr style="width: 100%; height: 2px;">
|
|
|
|
<h2><a name="OpenWRT"></a>OpenWRT</h2>
|
|
<a href="http://openwrt.org"><img alt="(OpenWRT Logo)" src=
|
|
"images/openwrt.png" style=
|
|
"border: 0px solid ; width: 88px; height: 31px;" hspace=
|
|
"4"></a>OpenWRT is a project which provides open source
|
|
firmware for Linksys WRT54G wireless routers. Two different
|
|
Shorewall packages are available for OpenWRT.<br>
|
|
<hr>
|
|
|
|
<h2><a name="Donations"></a>Donations</h2>
|
|
|
|
<p align="left"><a href="http://www.alz.org/" target=
|
|
"_top"><font color="#000000"><img src="images/alz_logo2.gif"
|
|
name="Graphic2" alt="(Alzheimer's Association Logo)" align=
|
|
"right" border="1" height="63" width="303"></font></a><a href=
|
|
"http://www.starlight.org/" target="_top"><font color=
|
|
"#000000"><img src="images/newlog.gif" name="Graphic3" alt=
|
|
"(Starlight Foundation Logo)" align="right" border="1" height=
|
|
"105" width="62"></font></a><font size="4">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>.</font></p>
|
|
|
|
<p align="left"><font size="4">Thank You<br>
|
|
</font></p>
|
|
|
|
<p align="left"><br>
|
|
<br>
|
|
</p>
|
|
</body>
|
|
</html>
|
|
|