Installing the Dansguardian package in PFSense - One user's experience



  • yeah, the message I get on reboot is:

    Dansguardian no process found
    Dansguardian no process found
    Dansguardian no process found

    I just start or restart it once boot is complete and all is OK.
    No biggee, but slightly annoying.

    Thanks and wouldn't be without it….



  • I've tested it today on a clean install and dansguardian did worked after reboot.

    It still takes 1minute to start but it works.  ???



  • Curious to me that it worked for you… I had the same problem - DG wasn't working because it started before Squid. I couldn't figure out how the package manager controlled the order of startup scripts, so I did a little hack. I simply created another startup script called z_fixstartup.sh and placed it in /usr/local/etc/rc.d. Contents of the script is...

    #!/bin/sh

    This file was automatically generated

    by the pfSense service handler.

    rc_start() {
    /usr/local/sbin/dansguardian -Q
    }

    rc_stop() {
    }

    case $1 in
    start)
    rc_start
    ;;
    stop)
    rc_stop
    ;;
    restart)
    rc_stop
    rc_start
    ;;
    esac

    I had another small issue that someone else might want to be aware of. If you create a NAT rule to autoforward port 80 traffic, this somehow breaks XBox downloads. I had to exclude the IP address of the XBox in the forwarding rule.



  • RJ - Nice fix I'm going to try that one. What I still don't understand though is, as you say, how does the package manager control the start up order ? Is there no consideration to the order designed in to the mechanism ?

    Marcello - I don't get it and I'm wonder if it's somehow random ? Does DG sometimes start after Squid or does it sometimes retry the connection, I have no idea, but it's very frustrating particularly when we can't reliably recreate the problem. Your comment about the time taken makes me wonder if I wait longer would the connection between DG and Squid eventually start ?



  • @Chewy:

    I don't get it and I'm wonder if it's somehow random ? Does DG sometimes start after Squid or does it sometimes retry the connection, I have no idea, but it's very frustrating particularly when we can't reliably recreate the problem. Your comment about the time taken makes me wonder if I wait longer would the connection between DG and Squid eventually start ?

    If you check boot-up process, you will see dansguardian taking about a minute to startup. Did you tried to wait boot process finish before trying to connect to dansguardian?



  • I'll move the startup script somewhere else and try it again… but I'm fairly certain that it was never coming up - or at least not consistently.

    This one might be a little off topic, but let me throw out another "feature" idea from something that I originally had working on my IPCop box. I had IPCop running with DG/Squid by using the copplus addon. In addition, found a script that got me started and then made some changes to implement a "Dansguardian Bypass" that would allow you to enter a password and bypass filtering for a time period. It's nice because sometimes DG is overly aggressive in filtering. I don't remember where I got the setup script, but on IPCop it was doing perl CGI to a web server on port 81. It also looks like someone did the same thing with PHP on ClearOS (see http://honestpchelp.com/2011/clearos-dansguardian-accessdenied-php-bypass-script/).

    I'm going to play around trying to get it to work on PFSense. However, the forum instructions I found for setting up a web server required installing a couple packages and mysql (see http://forum.pfsense.org/index.php/topic,47086.msg247364.html#msg247364)… it just seemed a little excessive to me since there's already a web server running for the web interface. Is there an easy way to get a web server instance that supports perl CGI or PHP on another port? Or... better yet, has anyone already implemented the bypass feature?



  • @rjcrowder:

    This one might be a little off topic, but let me throw out another "feature" idea from something that I originally had working on my IPCop box. I had IPCop running with DG/Squid by using the copplus addon. In addition, found a script that got me started and then made some changes to implement a "Dansguardian Bypass" that would allow you to enter a password and bypass filtering for a time period. It's nice because sometimes DG is overly aggressive in filtering. I don't remember where I got the setup script, but on IPCop it was doing perl CGI to a web server on port 81. It also looks like someone did the same thing with PHP on ClearOS (see http://honestpchelp.com/2011/clearos-dansguardian-accessdenied-php-bypass-script/).

    It's a dansguardian feature, but I did not included on gui. check dansguardian.conf to see the secret.

    @rjcrowder:

    I'm going to play around trying to get it to work on PFSense. However, the forum instructions I found for setting up a web server required installing a couple packages and mysql (see http://forum.pfsense.org/index.php/topic,47086.msg247364.html#msg247364)… it just seemed a little excessive to me since there's already a web server running for the web interface. Is there an easy way to get a web server instance that supports perl CGI or PHP on another port? Or... better yet, has anyone already implemented the bypass feature?

    I'll test it this week.



  • Or… better yet, has anyone already implemented the bypass feature?

    I'm in the same position having come from Smoothwall where I had this feature working. Exactly as you say, DG can be a little harsh at times so I simply implemented the "Bypass Button" which gave access for 10 minutes and then reset. Mine wasn't as sophisticated as a userid and password since my filtering is only to provide a warning almost, I'm not really trying to ban my daughters from anything on the net, I'm just trying to stop them accessing stuff accidentally that they probably don't want (and of course remove adverts and such).

    But anyway, I'm rambling on, if you do get that feature working I'd be really interested in how you've done it for this implementation with PFsense.



  • Dansguardian override works like a champ… Here is what I did.

    1. Installed the vhosts package.
    I had one minor issue with this. The service status page doesn't seem to correctly display the fact that it is running. I found a workaround on the forums to fix it http://forum.pfsense.org/index.php/topic,33804.0.html.

    2. Followed the instructions for setting up the override page from here http://honestpchelp.com/2011/clearos-dansguardian-accessdenied-php-bypass-script/.
    This was pretty straight forward, I just had to change the directories to be appropriate to the light http web server. For example, I put the accessdenied.php file in the directory /usr/local/vhosts/vhost01.local/. Of course, I also had to change the URL's to be appropriate to my box and port. I put the password text file in /var/etc/.



  • On a related note… It did not work when I tried booting without the script to restart dansguardian at the end of the bootup. Without the script it appears that dansguardian starts up, squid starts after and then dansg eventually shuts down.



  • I could not reproduce this issue but I'll include on dansguardian gui an option to force squid startup before dansguardian.



  • @marcelloc:

    @rjcrowder:

    This one might be a little off topic, but let me throw out another "feature" idea from something that I originally had working on my IPCop box. I had IPCop running with DG/Squid by using the copplus addon. In addition, found a script that got me started and then made some changes to implement a "Dansguardian Bypass" that would allow you to enter a password and bypass filtering for a time period. It's nice because sometimes DG is overly aggressive in filtering. I don't remember where I got the setup script, but on IPCop it was doing perl CGI to a web server on port 81. It also looks like someone did the same thing with PHP on ClearOS (see http://honestpchelp.com/2011/clearos-dansguardian-accessdenied-php-bypass-script/).

    It's a dansguardian feature, but I did not included on gui. check dansguardian.conf to see the secret.

    @rjcrowder:

    I'm going to play around trying to get it to work on PFSense. However, the forum instructions I found for setting up a web server required installing a couple packages and mysql (see http://forum.pfsense.org/index.php/topic,47086.msg247364.html#msg247364)… it just seemed a little excessive to me since there's already a web server running for the web interface. Is there an easy way to get a web server instance that supports perl CGI or PHP on another port? Or... better yet, has anyone already implemented the bypass feature?

    I'll test it this week.

    It appears that there is no way to get the GUI to not overwrite my changes when the config is saved (for the access denied php page that I put in place)… Would it be possible to add an option to the GUI so that you can specify a URL for the access denied page rather than having the user supply the HTML page content?



  • Would it be possible to add an option to the GUI so that you can specify a URL for the access denied page rather than having the user supply the HTML page content?

    vote +1

    or even better, for me at least, the option to either specify the content or an override URL ?



  • @Chewy:

    or even better, for me at least, the option to either specify the content or an override URL ?

    The way to specify the content isn't already there?  ???



  • The way to specify the content isn't already there?

    Yes, it is there but RJCrowder is suggesting specifying a URL instead (or that's how I read it)

    Would it be possible to add an option to the GUI so that you can specify a URL for the access denied page rather than having the user supply the HTML page content?

    I'm merely asking to have both which could be achieved quite easily by allowing the reporting level and a redirect URL to be exposed through the GUI. Dansguardian will use the local HTML when the reporting level is 3 and the redirect URL when it is at levels 1 or 2.



  • Think I may have tracked down why Dans doesn't start properly on bootup (on my setup)
    I get this error:
    php: : The command '/usr/local/sbin/squid -k reconfigure' returned exit code '1', the output was '2012/04/25 10:17:58| WARNING: '192.168.0.0/255.255.255.0' is a subnetwork of '192.168.0.0/255.255.255.0' 2012/04/25 10:17:58| WARNING: because of this '192.168.0.0/255.255.255.0' is ignored to keep splay tree searching predictable 2012/04/25 10:17:58| WARNING: You should probably remove '192.168.0.0/255.255.255.0' from the ACL named 'localnet' squid: ERROR: No running copy'

    On my squid setup I have chosen to select LAN + loopback, so that the children go through the 8080 dans proxy and my machine uses 3128 (for caching purposes)
    Is it possible that this is causing the error and not allowing dans to start automatically.

    Still starts when I go in and press start.
    Or am I just completely barking up the wrong tree….  ::)
    Thanks
    Chris



  • Just another quick note on something that needs to be done… it appears that DG log rotation is not setup. You can enable the "logrotation" script in /usr/local/share/dansguardian/scripts/. To get it working, do the following.

    1. Edit /usr/local/share/dansguardian/scripts/logrotation and change
      LOG_DIR=/var/log/ to
      LOG_DIR=/var/log/dansguardian
    2. Make the file executable
      chmod +x /usr/local/share/dansguardian/scripts/logrotation
    3. Add it to your list of scheduled tasks in cron so that it executes once a week. To do so, I installed the "cron" package and added an entry as follows (executes at 2:30am on Saturday):
    30 2 sat root /usr/local/share/dansguardian/scripts/logrotation

    Hope this helps...



  • @rjcrowder:

    Just another quick note on something that needs to be done… it appears that DG log rotation is not setup. You can enable the "logrotation" script in /usr/local/share/dansguardian/scripts/.

    Thanks for these steps, I'll take a look and implement when time permits.



  • I've just pushed some fixes do improve dansguardian boot process and checks.

    On my tests, dansguardian startup time during boot process reduced to 20 seconds.

    Wait 15 minutes, reinstall the package, apply config and reboot.



  • Firstly - Thanks Marcello that's excellent news. Can I just clarify that where you say "apply config and reboot" do you mean manually apply the config or restore from a saved xml config ? Would that work ? (Just saves me some time if it does).

    Secondly and totally unconnected here's a strange one for Netflix users.

    I recently re-installed my windows system onto a new SSD and subsequently my Netflix gave a Silverlight N8152 DRM error when starting. I tried every suggested fix I could find for what is apparently a fairly common error all to no avail. The solution I found that worked for me was to disable the Dansguardian redirect rule, start Netflix, watch a moment of some content then stop Netflix and re-enable the redirect rule for DG, no more DRM N8152 Silverlight problem…..

    I have no idea why, but it worked for me.



  • @Chewy:

    Firstly - Thanks Marcello that's excellent news. Can I just clarify that where you say "apply config and reboot" do you mean manually apply the config or restore from a saved xml config ? Would that work ? (Just saves me some time if it does).

    Reinstall the package, go on dansguardian gui, manually apply the config. If you whant to test boot process, reboot after apply config.



  • Hello All

    Many thanks to the author of the Dansguardian-Package. This is a very usefull function added to pfSense.

    I found a what appears to be a bug in the handling of the Dansguardian Package configuration on pfSense 2.

    Setup:
    pfSense 2.0.1-release
    Dansguardian Package (2.12.0.0 pkg; v.0.1.5.3)
    squid Package (2.7.9 pkg v.4.3.1)

    The Problem:
    If I set on the configuration page of Dansguardian (>Services>Dansguardian>Daemon) the Proxi-IP to 127.0.0.1 and leave the value for the Proxy-Port empty (for the default) in the config file of Dansguardian (/usr/local/etc/dansguardian/dansguardian.conf) the value 127.0.0.1 will be written for the proxy-port entry (proxyport = 127.0.0.1).

    My Solution:
    Manually set the value of the proxyport setting in /usr/local/etc/dansguardian/dansguardian.conf
    (In the pfSense-webgui for example by browsing to the config-file via >Diagnostics>Edit File).

    Regards
    Roman



  • @rs:

    The Problem:
    If I set on the configuration page of Dansguardian (>Services>Dansguardian>Daemon) the Proxi-IP to 127.0.0.1 and leave the value for the Proxy-Port empty (for the default) in the config file of Dansguardian (/usr/local/etc/dansguardian/dansguardian.conf) the value 127.0.0.1 will be written for the proxy-port entry (proxyport = 127.0.0.1).

    My Solution:
    Manually set the value of the proxyport setting in /usr/local/etc/dansguardian/dansguardian.conf

    Why not just fill proxy port fied?  ???



  • @marcelloc:

    Why not just fill proxy port fied?  ???

    Yes, this works, and is of course a better solution. I just not have tried it until now.



  • Hi All,

    Where I could find exceptioniplist on the menu. It seems I can't find it.

    Regards,
    Rocel



  • @kryptos:

    Where I could find exceptioniplist on the menu. It seems I can't find it.

    http://forum.pfsense.org/index.php/topic,42664.msg274045.html#msg274045



  • Hi, I think there is an option under in DansGuardian to set timing. Access lists->site and url



  • Hi, I think there is an option under in DansGuardian to set timing. Access lists->site and url



  • Hi and thanks to all you where of great help..
    I installed DansGuardian and Squid from packages, works fine, just a few questions,

    1. is there a need to put in a blacklist url into Dansguardian?
    2. I'm trying to get "phrase" to work and it doesn't seem to?
      I tried to just put e.g. "<gambling>" with or without spaces front or back but with out any response? Was able to enter any gambling site there is?
      And while we are at it, where are the category settings? Also when a block comes up it just says Category regular expressions? wondering.
      TIA

    P.S. as a newbie using pfsense, thanks to the Makers, its unreal, great work.
    and thanks to the maker of the DG pkg very nice job.</gambling>



  • @hf:

    I tried to just put e.g. "<gambling>" with or without spaces front or back but with out any response? Was able to enter any gambling site there is?</gambling>

    You have to check to get dansguardian working before going on access lists.

    Check if it's listening,
    Check if dansguardian is sending traffic to squid
    Check if clients are using dansguardian ip/port as their proxies.
    check log files to see what is passing through dansguardian.
    etc, etc, etc.

    This package gui follow dansguardian conf files, so you need some dansguardian knowledge to get it working

    @hf:

    thanks to the maker of the DG pkg very nice job.

    Thanks! donations are always welcome ;D

    att,
    Marcello Coutinho



  • Thanks,
    When i put into Site e.g. "google.com" it got blocked so that tells me that it listens and works, doesn't it?

    And i added the rule under nat so i understand that all traffic is forwarded to DG?

    Now the log files I wasn't able to  figure it out? I'm using strictly the GUI.
    TIA



  • @hf:

    When i put into Site e.g. "google.com" it got blocked so that tells me that it listens and works, doesn't it?

    Did you enabled the phrase Banned Lists on default group?

    @hf:

    And i added the rule under nat so i understand that all traffic is forwarded to DG?

    Using nat to get it transparent, you can only filter http.

    @hf:

    Now the log files I wasn't able to  figure it out? I'm using strictly the GUI.

    The log will be usefull only on console tail -f /var/log/dansguardian/access.log



  • guys, i'm at a loss here… I installed the dansguardian package and then had to uninstall it, and now after a reinstall, I can't get the gui components of the package to ever finish installing...  it just stops at this part:

    Removing Dansguardian components...
    Tabs items... done.
    Menu items... done.
    Services... done.
    Loading package instructions...
    Deinstall commands... done.
    Removing package instructions...done.
    Auxiliary files... done.
    Package XML... done.
    Configuration... done.
    Beginning package installation for Dansguardian...
    Downloading package configuration file... done.
    Saving updated package information... done.
    Downloading Dansguardian and its dependencies... 
    Checking for package installation... Loading package configuration... done.
    Configuring package components...
    Additional files... done.
    Loading package instructions...
    Custom commands...
    Executing custom_php_install_command()...
    

    Can someone please tell me what I should do here?  I have DG working on another server but wanted to do it all on the pfsense box if i could…that way I can filter sites for my kids IPODs and stuff that doesn't have proxy settings easily available.

    Appreciate your help, thanks in advance!



  • Can you check if there is any errors on console/system logs?

    How old is your dansguardian install?



  • I didn't really see any errors on the logs or console….  i think it's probably about a year old installation at best.  I have upgraded it whenever the upgrade was available from the main repository.  I think dg is actually installing, but i'm not seeing any portions of it available for configuration in the GUI.



  • @emuttillo:

    but i'm not seeing any portions of it available for configuration in the GUI.

    If you can't see it on pfsense menu, try to remove/install the package again.



  • hi Marcello,
    I've done that probably 5 times and still not showing up…it just stops at that one point and nothing happens, even if i let it sit there for an hour it never finishes apparently.

    i'm tempted to blow it away tonight and reinstall pfsense2 and restore backup and try again... hate to do that if i don't have to though.

    doesn't appear that it's fully installing when i run the package, it goes through some of the motions but never registers the service as available and the GUI components never show up.



  • I'm have no idea what's going on with your install, I've tested here and could uninstall/install dansguardian without errors.

    I'm going to test it on other machines too.



  • ok, well, i guess i have no other choice but to fully wipe the pfsense install and start over… luckily, i don't have a very involved configuration so it shouldn't take too long, just have to deal with a wife who will not be happy for me blocking her facebook time.  lol



  • Nice write up.. i have installed Dansguardian and configured it as you said. but after finishing 1st step, when i test it I cannot browse anything at all, no good site, no bad site, no pfsense either. any idea what i am doing wrong.

    OK.. managed to setup DG successfully. Now, how do i check the reports based on AD username??