Add content blocking proxy settings #1136

Open
opened 2026-03-04 01:05:42 -05:00 by deekerman · 48 comments
Owner

Originally created by @ameshkov on GitHub (Dec 3, 2019).

We're going to add the proxy module in v0.102:
https://github.com/AdguardTeam/AdGuardHome/issues/391

Here's the necessary minimum that should be configurable:

  • Enable/disable
  • Filter lists (consider extending /#filters)
  • Certificate (we should generate it by ourselves, we should allow users to download this cert)
  • Port, network interface
  • Proxy authentication
  • Proxy types: HTTP, HTTP over TLS
Originally created by @ameshkov on GitHub (Dec 3, 2019). We're going to add the proxy module in v0.102: https://github.com/AdguardTeam/AdGuardHome/issues/391 Here's the necessary minimum that should be configurable: * Enable/disable * Filter lists (consider extending `/#filters`) * Certificate (we should generate it by ourselves, we should allow users to download this cert) * Port, network interface * Proxy authentication * Proxy types: HTTP, HTTP over TLS
Author
Owner

@Eyeborgs commented on GitHub (Dec 3, 2019):

Proxy types: HTTP, HTTP over TLS

socks5 will not? or will this be for the future?

@Eyeborgs commented on GitHub (Dec 3, 2019): > Proxy types: HTTP, HTTP over TLS socks5 will not? or will this be for the future?
Author
Owner

@rufengsuixing commented on GitHub (Dec 3, 2019):

Transparent Proxy for routers with iptables?just need to listen the port,i will do the iptables config in my luci project

@rufengsuixing commented on GitHub (Dec 3, 2019): Transparent Proxy for routers with iptables?just need to listen the port,i will do the iptables config in my luci project
Author
Owner

@ameshkov commented on GitHub (Dec 4, 2019):

socks5 will not? or will this be for the future?
Transparent Proxy for routers with iptables?just need to listen the port,i will do the iptables config in my luci project

Not at first. But in the future -- of course, we'll add both of these options.

@ameshkov commented on GitHub (Dec 4, 2019): > socks5 will not? or will this be for the future? > Transparent Proxy for routers with iptables?just need to listen the port,i will do the iptables config in my luci project Not at first. But in the future -- of course, we'll add both of these options.
Author
Owner

@ghost commented on GitHub (Mar 14, 2020):

@ameshkov is this issue include about add separate pages for place cosmetic filtering rules lists?
#155 #677 #639 #903 #920 #1045 #1132 #1319 #1397 #1455 #1480 #639

@ghost commented on GitHub (Mar 14, 2020): @ameshkov is this issue include about add separate pages for place cosmetic filtering rules lists? #155 #677 #639 #903 #920 #1045 #1132 #1319 #1397 #1455 #1480 #639
Author
Owner

@ameshkov commented on GitHub (Mar 16, 2020):

@ArchiveBase yeah, I guess we can use either this one or #391

@ameshkov commented on GitHub (Mar 16, 2020): @ArchiveBase yeah, I guess we can use either this one or #391
Author
Owner

@JACK-THINK commented on GitHub (Apr 7, 2020):

@ameshkov

Support for socks5 proxy is very important. Thanks a lot.

@JACK-THINK commented on GitHub (Apr 7, 2020): @ameshkov Support for socks5 proxy is very important. Thanks a lot.
Author
Owner

@temporallyaccount commented on GitHub (Oct 10, 2020):

Issues' i thought to mention

  1. Related logs https://github.com/AdguardTeam/AdGuardHome/issues/391#issuecomment-546719880

@R9980 so will we able to have another 'usage log' (hosts - both domains/ip) additional to 'query log' for web user interface with inbound/outbound bandwidth for each hosts?

yes, the proxy server will have a different log

  1. Usage bandwidth https://github.com/AdguardTeam/AdGuardHome/issues/1572
  2. Decentraleyes/LocalCDN https://github.com/AdguardTeam/AdGuardHome/issues/2148
@temporallyaccount commented on GitHub (Oct 10, 2020): Issues' i thought to mention 1. Related logs https://github.com/AdguardTeam/AdGuardHome/issues/391#issuecomment-546719880 > @R9980 so will we able to have another 'usage log' (hosts - both domains/ip) additional to 'query log' for web user interface with inbound/outbound bandwidth for each hosts? >>yes, the proxy server will have a different log 2. Usage bandwidth https://github.com/AdguardTeam/AdGuardHome/issues/1572 3. Decentraleyes/LocalCDN https://github.com/AdguardTeam/AdGuardHome/issues/2148
Author
Owner

@91ajames commented on GitHub (Oct 28, 2020):

Would this work with a proxy of http://wl.is/ .js file provided by https://www.weblockapp.com by any chance?
Blocks ads with'n apps and including the youtube app that I used several yrs ago.

@91ajames commented on GitHub (Oct 28, 2020): Would this work with a proxy of http://wl.is/ .js file provided by https://www.weblockapp.com by any chance? Blocks ads with'n apps and including the youtube app that I used several yrs ago.
Author
Owner

@mrbluecoat commented on GitHub (Feb 12, 2021):

+1

@mrbluecoat commented on GitHub (Feb 12, 2021): +1
Author
Owner

@mrbluecoat commented on GitHub (Feb 13, 2021):

I'm a bit confused. #391 was closed because it appears tracking of the issue transitioned to this one. One of the posts indicates you had to create https://github.com/AdguardTeam/gomitmproxy and people can try an early release via https://github.com/AdguardTeam/urlfilter/tree/master/cmd Is there an up-to-date quickstart guide that explains how to use AdGuardHome with custom CA proxy?

@mrbluecoat commented on GitHub (Feb 13, 2021): I'm a bit confused. #391 was closed because it appears tracking of the issue transitioned to this one. One of the posts indicates you had to create https://github.com/AdguardTeam/gomitmproxy and people can try an early release via https://github.com/AdguardTeam/urlfilter/tree/master/cmd Is there an up-to-date quickstart guide that explains how to use AdGuardHome with custom CA proxy?
Author
Owner

@ameshkov commented on GitHub (Feb 15, 2021):

@mrbluecoat it's not yet integrated into AGH so the only way to experiment with the proxy is to follow the instruction there: https://github.com/AdguardTeam/urlfilter/tree/master/cmd

I.e. you'd need to build it yourself.

@ameshkov commented on GitHub (Feb 15, 2021): @mrbluecoat it's not yet integrated into AGH so the only way to experiment with the proxy is to follow the instruction there: https://github.com/AdguardTeam/urlfilter/tree/master/cmd I.e. you'd need to build it yourself.
Author
Owner

@thirdbyte commented on GitHub (Mar 11, 2021):

Is it feasible to add a VPN server to which all local devices would connect to and that's how HTTPS filtering would work? Just as it happens in AdGuard applications. I guess that would be more sorted than configuring proxy on each device. Moreover, VPN would enable AdGuard Home to deal with IP addresses (for devices connected through VPN) and hence support for firewall rules are also possible.

@thirdbyte commented on GitHub (Mar 11, 2021): Is it feasible to add a VPN server to which all local devices would connect to and that's how HTTPS filtering would work? Just as it happens in AdGuard applications. I guess that would be more sorted than configuring proxy on each device. Moreover, VPN would enable AdGuard Home to deal with IP addresses (for devices connected through VPN) and hence support for firewall rules are also possible.
Author
Owner

@hplee0120 commented on GitHub (Apr 29, 2021):

Looking forward to the feature going live, two years have passed. .

@hplee0120 commented on GitHub (Apr 29, 2021): Looking forward to the feature going live, two years have passed. .
Author
Owner

@jm33-m0 commented on GitHub (May 27, 2021):

Hi, in https://github.com/AdguardTeam/AdGuardHome/wiki/Configuration#configuration-file, is http_proxy supposed to proxy AdGuard's DNS over HTTPS requests?

I have tested and it won't work reliably

@jm33-m0 commented on GitHub (May 27, 2021): Hi, in https://github.com/AdguardTeam/AdGuardHome/wiki/Configuration#configuration-file, is `http_proxy` supposed to proxy AdGuard's DNS over HTTPS requests? I have tested and it won't work reliably
Author
Owner

@savely-krasovsky commented on GitHub (Jun 1, 2021):

@jm33-m0 http_proxy is only used for HTTP-client. For example your AGH setup has internet access only through proxy.

@savely-krasovsky commented on GitHub (Jun 1, 2021): @jm33-m0 `http_proxy` is only used for HTTP-client. For example your AGH setup has internet access only through proxy.
Author
Owner

@jm33-m0 commented on GitHub (Jun 1, 2021):

@L11R

For example your AGH setup has internet access only through proxy

So it means all upstream DNS (over HTTPS) requests will go through the proxy configured in http_proxy field, but in my test it just ignores my http_proxy and connects to DoH server directly.

I turned to used other solutions in the end, two AGH servers, one of which is used as upstream for the other, both in the same VPN so not affected by DNS poisoning.

@jm33-m0 commented on GitHub (Jun 1, 2021): @L11R > For example your AGH setup has internet access only through proxy So it means all upstream DNS (over HTTPS) requests will go through the proxy configured in `http_proxy` field, but in my test it just ignores my `http_proxy` and connects to DoH server directly. I turned to used other solutions in the end, two AGH servers, one of which is used as upstream for the other, both in the same VPN so not affected by DNS poisoning.
Author
Owner

@Dominik-1980 commented on GitHub (Jun 23, 2021):

Hello.

I just saw this thread.
I am not so familiar with adguard.
Is it now possible to block youtube and other adds with the current version of adguard home over proxy?

@Dominik-1980 commented on GitHub (Jun 23, 2021): Hello. I just saw this thread. I am not so familiar with adguard. Is it now possible to block youtube and other adds with the current version of adguard home over proxy?
Author
Owner

@erdoukki commented on GitHub (Jul 13, 2021):

Héllo, is it still not integrated in AGH ?
Is there any advice to help testing ?

@erdoukki commented on GitHub (Jul 13, 2021): Héllo, is it still not integrated in AGH ? Is there any advice to help testing ?
Author
Owner

@ameshkov commented on GitHub (Jul 28, 2021):

Nope, not yet integrated. I'll be really-really happy if we do that until the end of the year.

@ameshkov commented on GitHub (Jul 28, 2021): Nope, not yet integrated. I'll be really-really happy if we do that until the end of the year.
Author
Owner

@Karmylr commented on GitHub (Sep 12, 2021):

When to integrate this feature?It was postponed many times and I cant wait.

@Karmylr commented on GitHub (Sep 12, 2021): When to integrate this feature?It was postponed many times and I cant wait.
Author
Owner

@cirfis commented on GitHub (Sep 13, 2021):

+1

@cirfis commented on GitHub (Sep 13, 2021): +1
Author
Owner

@ihuaer commented on GitHub (Sep 13, 2021):

good job
can not wait any more

@ihuaer commented on GitHub (Sep 13, 2021): good job can not wait any more
Author
Owner

@savely-krasovsky commented on GitHub (Sep 13, 2021):

If you cannot wait -- do it yourself.

@savely-krasovsky commented on GitHub (Sep 13, 2021): If you cannot wait -- do it yourself.
Author
Owner

@erdoukki commented on GitHub (Sep 13, 2021):

@mrbluecoat it's not yet integrated into AGH so the only way to experiment with the proxy is to follow the instruction there: https://github.com/AdguardTeam/urlfilter/tree/master/cmd

I.e. you'd need to build it yourself.

Thanks...
I will have get some tests on this...

@erdoukki commented on GitHub (Sep 13, 2021): > @mrbluecoat it's not yet integrated into AGH so the only way to experiment with the proxy is to follow the instruction there: https://github.com/AdguardTeam/urlfilter/tree/master/cmd > > I.e. you'd need to build it yourself. Thanks... I will have get some tests on this...
Author
Owner

@Dominik-1980 commented on GitHub (Nov 6, 2021):

Any progress on this?

@Dominik-1980 commented on GitHub (Nov 6, 2021): Any progress on this?
Author
Owner

@kurokawaikki commented on GitHub (Nov 29, 2021):

Is this feature going to implement soon? Thanks!

@kurokawaikki commented on GitHub (Nov 29, 2021): Is this feature going to implement soon? Thanks!
Author
Owner

@Karmylr commented on GitHub (Nov 29, 2021):

Is this feature going to implement soon? Thanks!

This plan keeps being postponed

@Karmylr commented on GitHub (Nov 29, 2021): > Is this feature going to implement soon? Thanks! This plan keeps being postponed
Author
Owner

@smaktacular commented on GitHub (Jul 7, 2022):

ACME support for people running step-ca would make certificate handling signifcantly easier imho.

See https://smallstep.com/docs/step-ca for further reference.

@smaktacular commented on GitHub (Jul 7, 2022): ACME support for people running step-ca would make certificate handling signifcantly easier imho. See [https://smallstep.com/docs/step-ca](https://smallstep.com/docs/step-ca) for further reference.
Author
Owner

@SaschaM-Dev commented on GitHub (Aug 23, 2022):

Is there any ETA for this feature? DNS blocking keeps getting worse, as - obviously - marketers / ad companies know about that.

@SaschaM-Dev commented on GitHub (Aug 23, 2022): Is there any ETA for this feature? DNS blocking keeps getting worse, as - obviously - marketers / ad companies know about that.
Author
Owner

@ainar-g commented on GitHub (Aug 23, 2022):

No ETA, unfortunately. Any work on this feature will have to wait until we fix a number of issues that have long been plaguing AGH in the v0.108 cycle.

@ainar-g commented on GitHub (Aug 23, 2022): No ETA, unfortunately. Any work on this feature will have to wait until we fix a number of issues that have long been plaguing AGH in the v0.108 cycle.
Author
Owner

@drdedus commented on GitHub (Nov 19, 2022):

something similar with this project out there?

@drdedus commented on GitHub (Nov 19, 2022): something similar with this project out there?
Author
Owner

@Karmylr commented on GitHub (Nov 19, 2022):

something similar with this project out there?

good-mitm

@Karmylr commented on GitHub (Nov 19, 2022): > something similar with this project out there? good-mitm
Author
Owner

@ghost commented on GitHub (Nov 28, 2022):

something similar with this project out there?

https://github.com/Barre/privaxy

@ghost commented on GitHub (Nov 28, 2022): > something similar with this project out there? https://github.com/Barre/privaxy
Author
Owner

@Karmylr commented on GitHub (Nov 28, 2022):

something similar with this project out there?

https://github.com/Barre/privaxy

Wow, this is so good!

@Karmylr commented on GitHub (Nov 28, 2022): > > something similar with this project out there? > > https://github.com/Barre/privaxy Wow, this is so good!
Author
Owner

@vs0055 commented on GitHub (Dec 21, 2022):

something similar with this project out there?

https://github.com/Barre/privaxy

Wow, this is so good!

@Karmylr @ghost any info if this can be used with adguard home?

@vs0055 commented on GitHub (Dec 21, 2022): > > > something similar with this project out there? > > > > > > https://github.com/Barre/privaxy > > Wow, this is so good! @Karmylr @ghost any info if this can be used with adguard home?
Author
Owner

@ShalokShalom commented on GitHub (Aug 11, 2023):

something similar with this project out there?

https://eblocker.org/

@ShalokShalom commented on GitHub (Aug 11, 2023): > something similar with this project out there? https://eblocker.org/
Author
Owner

@mon-jai commented on GitHub (Aug 11, 2023):

something similar with this project out there?

Maybe privoxy?

@mon-jai commented on GitHub (Aug 11, 2023): > something similar with this project out there? Maybe [privoxy](https://www.privoxy.org/)?
Author
Owner

@ShalokShalom commented on GitHub (Aug 12, 2023):

That was already recommended.

@ShalokShalom commented on GitHub (Aug 12, 2023): That was already recommended.
Author
Owner

@SD-fan commented on GitHub (Aug 14, 2023):

something similar with this project out there?

https://eblocker.org/

I'm using eBlocker for years and I find it's the best solution out there. Especially their malware blocker saved my a... quite a few times.👍

@SD-fan commented on GitHub (Aug 14, 2023): > > something similar with this project out there? > > https://eblocker.org/ I'm using eBlocker for years and I find it's the best solution out there. Especially their malware blocker saved my a... quite a few times.👍
Author
Owner

@Trung0246 commented on GitHub (Oct 14, 2023):

For anyone wants to rollout diy version this looks useful when combining with mitmproxy (especially with youtube recent shenanigan): https://ericdraken.com/pfsense-decrypt-ad-traffic

@Trung0246 commented on GitHub (Oct 14, 2023): For anyone wants to rollout diy version this looks useful when combining with mitmproxy (especially with youtube recent shenanigan): https://ericdraken.com/pfsense-decrypt-ad-traffic
Author
Owner

@thezilione commented on GitHub (Apr 10, 2024):

Waiting anxiously. For now, I recommend eBlocker to anyone interested.

@thezilione commented on GitHub (Apr 10, 2024): Waiting anxiously. For now, I recommend eBlocker to anyone interested.
Author
Owner

@ShalokShalom commented on GitHub (Apr 10, 2024):

hblock works without an external device. Just run it locally, same effect as a DNS hole.

@ShalokShalom commented on GitHub (Apr 10, 2024): [hblock](https://github.com/hectorm/hblock) works without an external device. Just run it locally, same effect as a DNS hole.
Author
Owner

@Planxnx commented on GitHub (Jul 14, 2024):

Is there any progress ??

@Planxnx commented on GitHub (Jul 14, 2024): Is there any progress ??
Author
Owner

@PACHAKUTlQ commented on GitHub (Oct 28, 2024):

waiting anxiously

@PACHAKUTlQ commented on GitHub (Oct 28, 2024): waiting anxiously
Author
Owner

@ovcrash commented on GitHub (May 24, 2025):

Any news on this feature?

@ovcrash commented on GitHub (May 24, 2025): Any news on this feature?
Author
Owner

@kirchmeyer commented on GitHub (Jul 15, 2025):

This sounds amazing. Do want!

@kirchmeyer commented on GitHub (Jul 15, 2025): This sounds amazing. Do want!
Author
Owner

@corazzam commented on GitHub (Aug 3, 2025):

Would be super cool!

@corazzam commented on GitHub (Aug 3, 2025): Would be super cool!
Author
Owner

@Saeid008 commented on GitHub (Oct 24, 2025):

Hi @code3-dev can you help in this project? Adguardhome team need to add support for socks5 & http proxy. So it's useful for people in Iran & China since plain DNS are useless and DOH & DOT domain are filtered. The user can install x-ui panel on it's server and create a simple socks5 then Adguardhome can route the DNS traffic through socks5.

@Saeid008 commented on GitHub (Oct 24, 2025): Hi @code3-dev can you help in this project? Adguardhome team need to add support for socks5 & http proxy. So it's useful for people in Iran & China since plain DNS are useless and DOH & DOT domain are filtered. The user can install x-ui panel on it's server and create a simple socks5 then Adguardhome can route the DNS traffic through socks5.
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
starred/AdGuardHome#1136
No description provided.