version 1.1.1.2, 2012/05/29 12:55:57
|
version 1.1.1.3, 2013/07/22 00:32:35
|
Line 1
|
Line 1
|
MiniUPnP project. |
MiniUPnP project. |
(c) 2006-2011 Thomas Bernard | (c) 2006-2012 Thomas Bernard |
Homepage : http://miniupnp.free.fr/ |
Homepage : http://miniupnp.free.fr/ |
Mirror: http://miniupnp.tuxfamily.org/ |
Mirror: http://miniupnp.tuxfamily.org/ |
|
github: https://github.com/miniupnp/miniupnp |
|
|
miniupnpd is still under active developpement. This documentation is |
miniupnpd is still under active developpement. This documentation is |
likely to be a little outdated when you read it. So please go on the |
likely to be a little outdated when you read it. So please go on the |
Line 13 To Build and Install :
|
Line 14 To Build and Install :
|
- use BSD make to compile. |
- use BSD make to compile. |
- you can first 'make config.h' then edit config.h to your preferences and |
- you can first 'make config.h' then edit config.h to your preferences and |
finally 'make' |
finally 'make' |
|
Alternatively to editing config.h, options can be passed to genconfig.sh |
|
For more details : |
|
> ./genconfig.sh -h |
- add "rdr-anchor miniupnpd" and "anchor miniupnpd" lines to /etc/pf.conf |
- add "rdr-anchor miniupnpd" and "anchor miniupnpd" lines to /etc/pf.conf |
- some FreeBSD users reported that it is also necessary for them |
- some FreeBSD users reported that it is also necessary for them |
to explicitly allow udp traffic on 239.0.0.0/8 by adding the two following |
to explicitly allow udp traffic on 239.0.0.0/8 by adding the two following |
Line 25 To Build and Install :
|
Line 29 To Build and Install :
|
and "anchor miniupnpd" lines. |
and "anchor miniupnpd" lines. |
- install as root using : |
- install as root using : |
# make install |
# make install |
or | or |
# PREFIX=/usr/local make install |
# PREFIX=/usr/local make install |
- run as root : The daemon needs rights to modify pf rules. |
- run as root : The daemon needs rights to modify pf rules. |
|
|
edit the /etc/miniupnpd.conf file to set options. All options are also | edit the /etc/miniupnpd.conf file to set options. Almost all options are also |
available through command line switches. |
available through command line switches. |
To stop the daemon use : |
To stop the daemon use : |
> kill `cat /var/run/miniupnpd.pid` |
> kill `cat /var/run/miniupnpd.pid` |
Line 46 http://blogs.sun.com/avalon/category/IPFilter
|
Line 50 http://blogs.sun.com/avalon/category/IPFilter
|
|
|
============================= Mac OS X/ipfw =============================== |
============================= Mac OS X/ipfw =============================== |
|
|
|
- To enable non standard compilation options, |
|
> ./genconfig.sh -h |
|
Or edit config.h after it has been generated by genconfig.sh |
- use 'bsdmake' or 'make -f Makefile.macosx' to build |
- use 'bsdmake' or 'make -f Makefile.macosx' to build |
|
|
|
|
============================ Linux/netfilter ============================== |
============================ Linux/netfilter ============================== |
To Build and install : |
To Build and install : |
|
|
Line 66 To Build and install :
|
Line 72 To Build and install :
|
> vi config.h |
> vi config.h |
- Build the daemon |
- Build the daemon |
> make -f Makefile.linux |
> make -f Makefile.linux |
If not using iptables from your system, | If not using iptables from your system, |
> IPTABLESPATH=/path/to/iptables-1.4.1 make -f Makefile.linux |
> IPTABLESPATH=/path/to/iptables-1.4.1 make -f Makefile.linux |
note : make sure you have iptables with static libraries compiled. |
note : make sure you have iptables with static libraries compiled. |
use "./configure --enable-static" before compiling iptables |
use "./configure --enable-static" before compiling iptables |
Line 86 NOTE: a /etc/init.d/miniupnpd script will be installed
|
Line 92 NOTE: a /etc/init.d/miniupnpd script will be installed
|
|
|
|
|
How to get libiptc with its headers on debian : |
How to get libiptc with its headers on debian : |
|
(Note: that should be useless now that netfilter/tiny_nf_nat.h is included) |
- Use apt-get to get sources : |
- Use apt-get to get sources : |
> apt-get source iptables |
> apt-get source iptables |
you should then have an iptables-x.x.x/ directory. |
you should then have an iptables-x.x.x/ directory. |
Line 97 How to get libiptc with its headers on debian :
|
Line 104 How to get libiptc with its headers on debian :
|
> IPTABLESPATH=§path/to/iptables-x.x.x make -f Makefile.linux |
> IPTABLESPATH=§path/to/iptables-x.x.x make -f Makefile.linux |
|
|
=========================== Configuration ============================= |
=========================== Configuration ============================= |
Edit the /etc/miniupnpd.conf file to set options. All options are also | Edit the /etc/miniupnpd.conf file to set options. Almost all options are |
available through command line switches. | also available through command line switches. |
|
|
Miniupnpd supports some kind of security check for allowing or disallowing |
Miniupnpd supports some kind of security check for allowing or disallowing |
redirection to be made. The UPnP permission rules are read from the |
redirection to be made. The UPnP permission rules are read from the |
Line 137 automatically.
|
Line 144 automatically.
|
|
|
To stop the daemon use : |
To stop the daemon use : |
# kill `cat /var/run/miniupnpd.pid` |
# kill `cat /var/run/miniupnpd.pid` |
or if your linux system use /etc/init.d/ | or if your linux system use /etc/init.d/ |
# /etc/init.d/miniupnpd stop |
# /etc/init.d/miniupnpd stop |
|
|
|
|