[ILUG-BOM] Fwd: [OpenWrt-Users] Introducing Charcoal - Centralised URL filter for Squid

Arun Khan knura9 at gmail.com
Fri Jul 14 23:04:22 IST 2017

FWIW, this might be useful to folks using multiple openWRT+Squid.

Arun Khan

---------- Forwarded message ----------
From: Nishant Sharma <codemarauder at gmail.com>
Date: Wed, Jun 14, 2017 at 5:47 AM
Subject: [OpenWrt-Users] Introducing Charcoal - Centralised URL filter for Squid
To: openwrt-users at lists.openwrt.org


We are excited to invite early users to test drive Charcoal
(http://charcoal.io) - a Squid URL Rewriter for distributed proxies.

It has come out of our need of managing ACLs for 100+ proxy servers on
OpenWRT/LEDE running at our customer offices across the geography of
India. We are releasing it in the hope that it will be useful for
users who have to manage multiple proxy servers everyday.

Devices that we have tested it on are:

- PCEngines ALIX
- PCEngines APU
- PCEngines APU2
- Mikrotik Routerboard RB951Ui-2HnD

Releases that we have tested it on are:

- OpenWRT 14.07
- OpenWRT 15.05
- LEDE 17.01

Charcoal is designed to help administrators manage access rules for
the proxies at just one place with a GUI, instead of editing
configuration of individual proxy servers.

The architecture is API key driven client-server, where a squid
url-rewrite helper contacts server to query access controls for the
incoming requests.

Current features:
- Supports Squid 2.x and 3.x
- 70+ pre-existing domains blacklist
- Custom destination groups/categories
- Custom source groups for IPs and Networks (usernames in the pipeline)
- As of now only domain filter support (no full url filtering)
- API key driven

- Download the helper from
- Make sure IO::Socket (perlbase-io) module for Perl is installed.
- Add following lines to squid.conf after downloading the helper:

url_rewrite_program /path/to/charcoal-helper.pl YOUR_API_KEY
url_rewrite_children X startup=Y idle=Z concurrency=1

YOUR_API_KEY for our hosted Charcoal service can be requested by
filling in the form at http://charcoal.io or writing in to
charcoal at hopbox.in. The credentials for login to
https://active.charcoal.io to manage the ACL will be emailed along

URL Rewrite helper for squid is licensed under GPLv2.0 while Charcoal
Server is licensed under AGPLv3.0.

GIT Repo:
Squid URL Rewrite helper can be downloaded from

Git repository for Charcoal Server is at https://github.com/Hopbox/charcoal

openwrt-users mailing list
openwrt-users at lists.openwrt.org

More information about the Linuxers mailing list