adguard for safari github

AdGuard for Safari 4+

Adblock and privacy, adguard software limited.

• 4.6 • 21.5K Ratings

Screenshots

Description.

More than 35,000,000 AdGuard users enjoy the better, faster, and safer Internet. The ad blocker extension clears all ads in Safari and fights data tracking to protect privacy. Unlike other major ad blockers, AdGuard provides some extra features you are used to having with the traditional (now deprecated) extensions: ● Manage protection from Safari ● Choose among popular filter lists ● Add custom filter lists ● Create your own filtering rules ● Manual blocking tool ● Whitelist websites in one click AdGuard for Safari is based on the Safari native content blocking API, which makes it lightning fast. KEY FEATURES ◈ Blocking Ads Remove all kinds of ads from Safari browser easily. We have plenty of ad blocking filters and even an ability to manually remove ANY element on the page that you don't like. ◈ Blocking Trackers Make your personal information protected by blocking known trackers. ◈ Blocking Annoyances Tired of all the «Like» buttons and similar widgets infesting all of your frequented web pages? Just enable AdGuard "Social Media filter" and forget about them. ◈ Faster Browsing Speed By preventing ads, annoyances, and trackers from loading when you visit a certain page, AdGuard makes browsing smoother and faster. ◈ Free and Open Source AdGuard for Safari is a free and open source software. The source code is available on Github: https://github.com/AdguardTeam/AdguardForSafari

Version 1.11.17

As Sigmund Freud used to say: “Sometimes a new version is just a new version”. This time, we've gone with the standard set of changes: updated scriptlets, translations, and filters — without pomp and fanfare, but with a great sense of responsibility.

Ratings and Reviews

21.5K Ratings

Good Set & Forget Ad Blocker

Clean, simple, and easy to understand. I use on my Mac as well as my iOS devices. Great Apple citizen. Recent updates have made this much easier to use via the built in system controls. Also a big handy feature for me is the ability to quickly, permanently block elements on a webpage just by selecting them, great for navigating poorly designed websites with elements that cover others especially on mobile. However 4 out of 5 times when a website won't work or load it's because this is blocking some linked script or tracking redirect, which is sometimes annoying, especially when you have to do it several times every time such a link is clicked, but the app is just doing its job of blocking sketchy connections that I don't want and that's more a fault of the web at large.

Some annoying bugs, please fix!

This app appears to do a great job and what it sets out to do, but there is an annoying bug that renders this quite frustrating on a fresh boot: when this app is set to open at login, it does NOT honor the "hide" setting checkbox under System Preferences --> Users and Groups --> Current User --> Login Items --> "hide" checkbox next to AdGuard for Safari. Normally, when the system is rebooted and this box is checked, the app can launch, but without the application window opening in front of the user. Please fix this, so that the app can launch at login without popping up its preferences window each time! Finally, as a feature request, please support Catalina auto dark mode, and please allow for iCloud-based settings syncing... thanks!

BEST Ad Blocker for Mojave

After upgrading to Mojave, I found Safari has completely changed its mechanism of extensions. All of my ad block plug-ins now only function in very limited manners (no filter setting, no element inspections etc.). And I feel particularly annoyed -- I browse Chinese websites frequently, yet almost all ad blockers would never succeed in removing ads in foreign languages unless you set up filters manually. Yet as I said before, all most all ad blockers under Mojave are too succinct to offer such advanced features. Thankfully, I finally found this lovely, amazing, elegant, useful, powerful AdGuard. The pre-installed language-specific filer lists are totally incredible. To Mojave users, if you're reading this review, pls stop searching for other ad blockers. AdGuard is THE BEST!

App Privacy

The developer, Adguard Software Limited , indicated that the app’s privacy practices may include handling of data as described below. For more information, see the developer’s privacy policy .

Data Not Collected

The developer does not collect any data from this app.

Privacy practices may vary, for example, based on the features you use or your age. Learn More

Information

English, Amharic, Arabic, Bengali, Bulgarian, Catalan, Croatian, Czech, Danish, Dutch, Estonian, Filipino, Finnish, French, German, Greek, Gujarati, Hebrew, Hindi, Hungarian, Indonesian, Italian, Japanese, Kannada, Korean, Latvian, Lithuanian, Malay, Malayalam, Marathi, Norwegian Bokmål, Persian, Polish, Portuguese, Romanian, Russian, Serbian, Simplified Chinese, Slovak, Slovenian, Spanish, Swahili, Swedish, Tamil, Telugu, Thai, Traditional Chinese, Turkish, Ukrainian, Vietnamese

• Developer Website
• App Support
• Privacy Policy

More By This Developer

AdGuard — adblock&privacy

AdGuard VPN – Unlimited & Fast

AdGuard Pro — adblock&privacy

How to install

This article is about AdGuard Browser Extension, which safeguards only your browser. To protect your entire device, download the AdGuard app

How to install AdGuard Browser Extension for Google Chrome or Chromium browsers ​

Open the extension's page in Chrome Web Store and click Add to Chrome .

In the opened dialog box, click Add extension .

How to install AdGuard Browser Extension for Opera ​

Open the page addons.opera.com .

Click Add to Opera .

How to install AdGuard Browser Extension for Firefox ​

Open the page addons.mozilla.org .

Click Add to Firefox .

How to install AdGuard Browser Extension for Yandex Browser ​

Click the browser settings button in the upper right corner of the browser, then choose Add-ons in the drop-down menu.

Scroll down to find AdGuard, then click Install .

How to install AdGuard Browser Extension for Microsoft Edge ​

Find AdGuard Browser Extension in the Edge Add-ons store and click Get .

In the opened dialog window, press Add extension .

Alternatively, you can install AdGuard Browser Extension for Edge from the Chrome Web Store . Open its web page in your Edge browser and select Allow extensions from other stores on the banner at the top of the page.

In the opened dialog box, click Allow .

Click Add to Chrome .

In the opened dialog window, click Add extension to install AdGuard Browser Extension.

How to install AdGuard Browser Extension for Safari ​

AdGuard for Safari is not a browser extension in a common sense. You can read more about it in a dedicated article . Or you can download the installation file directly from this page.

• How to install AdGuard Browser Extension for Google Chrome or Chromium browsers
• How to install AdGuard Browser Extension for Opera
• How to install AdGuard Browser Extension for Firefox
• How to install AdGuard Browser Extension for Yandex Browser
• How to install AdGuard Browser Extension for Microsoft Edge
• How to install AdGuard Browser Extension for Safari

Navigation Menu

Search code, repositories, users, issues, pull requests..., provide feedback.

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly.

To see all available qualifiers, see our documentation .

• Notifications

AdGuard Home - FAQ

This article is outdated. See the up-to-date version in our Knowledge Base.

Why AdGuard Home doesn't block ads?

Where can i inspect the logs, how to configure adguard home to write verbose-level logs, how to show a custom block page, how to change dashboard interface's address, how to set up adguard home as default dns server, are there any known limitations, why am i getting bind: address already in use error when trying to install on ubuntu, how to configure a reverse proxy server for adguard home, how to fix permission denied errors on fedora, how to fix incompatible file system errors, how to update adguard home manually, how to uninstall adguard home.

This section is outdated. See the up-to-date version in our Knowledge Base.

Suppose that AdGuard Home must block somebadsite.com but for some reason it doesn't. Let's try to resolve this issue.

Most likely you didn't configure your device to use AdGuard Home as its default DNS server. To check if you're using AdGuard Home as the default DNS server:

On Windows, open a Terminal window (Start → Run → cmd.exe ). On other systems, open your Terminal application.

Execute nslookup example.org . It will print something like this:

Check if the Server IP address is the one on which AdGuard Home is running. If not, you need to configure your device, see below .

Ensure that your request to example.org appears in the AdGuard Home UI on the Query Log page. If not, you need to configure AdGuard Home to listen on the specified network interface. The most straightforward way to do so is to reinstall AdGuard Home with default settings.

If you are sure that your device uses AdGuard Home as its default DNS server, but the problem persists, it might have something to do with an AdGuard Home misconfiguration. Please check and ensure that:

You have the “Block domains using filters and hosts files” setting enabled on the “Settings → General settings” page.

You have the appropriate safety mechanisms, such as Parental Control, enabled on the “Settings → General settings”.

You have the appropriate filters enabled on the “Filters → DNS blocklists” page.

You don't have any exception rule lists that may allow the requests enabled on the “Filters → DNS allowlists” page.

You don't have any DNS rewrites that may interfere with the “Filters → DNS rewrites” page.

You don't have any custom filtering rules that may interfere with the “Filters → Custom filtering rules” page.

The default location of the plain-text logs (not to be confused with the query logs) depends on the operating system and installation mode:

OpenWrt Linux: use the logread -e AdGuardHome command.

Linux systems with systemd and other Unix systems with SysV-style init: /var/log/AdGuardHome.err .

macOS: /var/log/AdGuardHome.stderr.log .

Linux systems with Snapcraft use the snap logs adguard-home command.

FreeBSD: /var/log/daemon.log ( since v0.108.0-b.4 ). Before v0.108.0-b.4 no logs are written by default.

OpenBSD: /var/log/daemon ( since v0.108.0-b.4 ). Before v0.108.0-b.4 no logs are written by default.

On Windows: the Windows Event Log is used.

To troubleshoot a complicated issue, the verbose-level logging is sometimes required. Here's how to enable it:

Stop AdGuard Home:

Configure AdGuard Home to write verbose-level logs:

Open AdGuardHome.yaml in your editor.

• Set log.file to the desired path of the log file, for example /tmp/aghlog.txt . Note that the directory must exist.
• Set log.verbose to true .

NOTE: Before v0.107.34 use verbose and log_file properties.

Restart AdGuard Home and reproduce the issue:

A note about HTTPS

Before doing any of this, please note that modern browsers are set up to use HTTPS, so they validate the authenticity of the web server certificate. That means that using any of these will result in warning screens.

There are a couple of proposed extensions that, when they become reasonably well supported by clients, would allow for a better user experience, including the RFC 8914 Extended DNS Error codes and the DNS Access Denied Error Page RFC draft . We'll implement them when browsers actually start to support them.

Prerequisites

To use any of these ways to show a custom block page, you'll need an HTTP server running on some IP address and serving the page in question on all routes. Something like pixelserv-tls .

Custom block page for Parental Control and Safe Browsing filters

There is currently no way to set these parameters from the UI, so you'll need to edit the configuration file manually:

Set the dns.parental_block_host or dns.safebrowsing_block_host settings to the IP address of the server (in this example, 192.168.123.45 ):

Restart AdGuard Home:

Custom block page for other filters

Open the web UI.

Open the “Settings → DNS settings” page.

In the “DNS server configuration” section, select the “Custom IP” radio button in the “Blocking mode” selector and enter the IPv4 and IPv6 addresses of the server.

Click “Save”.

Set the http.address setting to a new network interface. For example:

0.0.0.0:0 to listen on all network interfaces.

0.0.0.0:8080 to listen on all network interfaces with port 8080 .

127.0.0.1:0 to listen on the local loopback interface only.

See the “Configuring Devices” section on the “Getting Started” page in the Knowledge Base.

Here are some examples of what cannot be blocked by a DNS-level blocker:

YouTube, Twitch ads.

Facebook, Twitter, Instagram sponsored posts.

Essentially, any advertising that shares a domain with content cannot be blocked by a DNS-level blocker.

Is there a chance to handle this in the future?

DNS will never be enough to do this. Your only option is to use a content blocking proxy like what we do in the standalone AdGuard applications. We're going to bring this feature support to AdGuard Home in the future. Unfortunately, even in this case, there still will be cases when this won't be enough or would require quite complicated configuration.

This happens because the port 53 on localhost , which is used for DNS, is already taken by another program. Ubuntu comes with a local DNS called systemd-resolved , which uses the address 127.0.0.53:53 and thus prevents AdGuard Home from binding to 127.0.0.1:53 . You can see that by running:

The output should be similar to:

To fix this, you need to either disable the systemd-resolved daemon or choose a different network interface and bind to an accessible IP address on it, for instance, the IP address of your router inside your network. But if you do need to listen on localhost , there are several solutions.

Firstly, AdGuard Home can detect such configurations and disable systemd-resolved for you if you press the “Fix” button, which is shown near the address already in use message on the installation screen.

Secondly, if that doesn't work, follow the guide below. Note that if you're using AdGuard Home with docker or snap, you'll have to do it yourself.

Create the /etc/systemd/resolved.conf.d directory, if necessary:

Deactivate DNSStubListener and update DNS server address. To do that, create a new file, /etc/systemd/resolved.conf.d/adguardhome.conf , with the following content:

Specifying 127.0.0.1 as DNS server address is necessary because otherwise the nameserver will be 127.0.0.53 which doesn't work without DNSStubListener .

Activate another resolv.conf file:

Restart DNSStubListener :

After that, systemd-resolved shouldn't be shown in the output of lsof , and AdGuard Home should be able to bind to 127.0.0.1:53 .

If you're already running a web server and want to access the AdGuard Home dashboard UI from a URL like http://YOUR_SERVER/aghome/ , you can use this configuration for your web server:

Or, if you just want to serve AdGuard Home with automatic TLS, use a configuration similar to the example shown below:

Disable DoH encryption on AdGuard Home

When you use TLS on your reverse proxy server, there's no need to use TLS on AdGuard Home. Set allow_unencrypted_doh: true in AdGuardHome.yaml to allow AdGuard Home respond to DoH requests without TLS encryption.

Real IP addresses of clients

Since v0.107.0, you can set the parameter trusted_proxies to the IP address(es) of your HTTP proxy to make AdGuard Home take the headers containing the real client IP address into account. See the configuration and encryption pages for more information.

Move the AdGuardHome binary to /usr/local/bin .

As root , execute the following command to change the security context of the file:

Add the required firewall rules in order to make it reachable through the network. For example:

If you are still getting code=exited status=203/EXEC or similar errors from systemctl , try uninstalling AdGuard Home and installing directly into /usr/local/bin by using the -o option of the install script:

See issue 765 and issue 3281 .

You should move your AdGuard Home installation or working directory to another location. See the limitations section on the “Getting Started” page.

In case the button isn't shown or an automatic update has failed, you can update manually. In the examples below, we'll use AdGuard Home releases for Linux and Windows for AMD64 CPUs.

Unix (Linux, macOS, BSD)

Download the new AdGuard Home package from the releases page . If you want to perform this step from the command line:

Or, with wget :

Navigate to the directory where AdGuard Home was installed. On most Unix systems the default directory is /opt/AdGuardHome , but on macOS it's /Applications/AdGuardHome .

(On OpenBSD you probably want to use doas instead of sudo .)

Backup your data. That is, your configuration file and the data directory ( AdGuardHome.yaml and data/ by default). For example, to backup your data to a new directory called ~/my-agh-backup :

Unpack the AdGuard Home archive to a temporary directory. For example, if you downloaded the archive to your ~/Downloads directory and want to unpack it to /tmp/ :

On macOS, something like:

Replace the old AdGuard Home executable file with the new one. On most Unix systems the command would look something like:

You may also want to copy the documentation parts of the package, such as the change log ( CHANGELOG.md ), the README file ( README.md ), and the license ( LICENSE.txt ).

You can now remove the temporary directory.

Windows (Using PowerShell)

In all examples below, the PowerShell must be run as Administrator.

Navigate to the directory where AdGuard Home was installed. In the examples below, we'll use C:\Program Files\AdGuardHome .

Backup your data. That is, your configuration file and the data directory ( AdGuardHome.yaml and data/ by default). For example, to backup your data to a new directory called my-agh-backup :

Unpack the AdGuard Home archive to a temporary directory. For example, if you downloaded the archive to your Downloads directory and want to unpack it to a temporary directory:

Replace the old AdGuard Home executable file with the new one. For example:

The way to uninstall AdGuard Home depends on how you installed it.

IMPORTANT: After uninstalling AdGuard Home, don't forget to change your devices configuration and point them to a different DNS server.

Regular installation

In this case you need to do the following:

Unregister AdGuard Home service: ./AdGuardHome -s uninstall .

Remove the AdGuard Home directory.

Simply stop and remove the image.

• How to write hosts blocklists
• Comparing AdGuard Home to other solutions
• Supported platforms
• How to install and run AdGuard Home on a Raspberry Pi
• How to install and run AdGuard Home on a virtual private server
• Configuring AdGuard Home clients
• AdGuard Home as a DoH, DoT, or DoQ server
• AdGuard Home as a DNSCrypt server
• AdGuard Home as a DHCP server
• Verifying releases

Clone this wiki locally

Safari Web extension

Web extensions add custom functionality to Safari. You can find more information about Web extensions here .

AdGuard's Safari Web extension is a tool that takes advantage of the new features of iOS 15. It serves to enhance the capabilities of AdGuard for iOS. With it, AdGuard can apply advanced filtering rules and ultimately block more ads.

What it does ​

By default, Safari provides only basic tools to content blockers. These tools don't allow the level of performance that can be found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such effective weapons against ads as CSS rules , CSS selectors , and scriptlets . Unfortunately, these instruments are absolutely irreplaceable when dealing with more complex cases such as pre-roll ads on YouTube, for example.

AdGuard's Safari Web extension compliments AdGuard by giving it the ability to employ these types of filtering rules.

Besides that, AdGuard's Safari Web extension can be used to quickly manage AdGuard for iOS right from the browser. Tap the Extensions button — it's the one with a jigsaw icon, depending on your device type it may be located to the left or to the right of the address bar. Find AdGuard in the list and tap it.

On iPads AdGuard's Safari Web extension is accessible directly by tapping the AdGuard icon in the browser's address bar.

You will see the following list of options:

Enabling/disabling protection on the website . Turning the switch off will disable AdGuard completely for the current website and add a respective exclusion rule. Turning the switch back on will resume protection for the website and delete the rule. Any such change will require some time to take effect.

Blocking elements on the page manually . Tap the Block elements on this page button to prompt a pop-up for element blocking. Select any element on the page you want to hide, adjust the selection zone, then preview changes and confirm the removal. A corresponding filtering rule will be added to AdGuard (that you can later disable or delete to revert the change).

Report an issue . Swipe up to bring out the Report an issue button. Use it to report a missed ad or any other problem that you encountered on the current page.

How to enable AdGuard's Safari Web extension ​

AdGuard's Safari Web extension requires access to the web pages' content to operate, but doesn't use it for any purpose other than blocking ads.

In the iOS settings ​

The Web extension is not a standalone tool and requires AdGuard for iOS. If you don't have AdGuard for iOS installed on your device, please install it first and complete the onboarding process to prepare it for work.

Once done, open Settings → Safari → Extensions .

Find ALLOW THESE EXTENSIONS section and then find AdGuard among the available extensions.

Tap it, then toggle the switch. On the same screen, set the All Websites permission for AdGuard to either Allow or Ask . If you choose Allow , you won't have to give permission every time you visit a new website. If you are unsure, choose Ask to grant permissions on a per-site basis.

In Safari ​

Alternitavely, you can also turn AdGuard extension on from the Safari browser. Tap the Extensions button (if you don't see it next to the address bar, tap the aA icon).

Then find the Manage Extensions option in the list and tap it. In the opened window turn on the switch next to AdGuard .

If you use this method, you may have to go to Safari settings to grant AdGuard extension the necessary permissions anyway.

You should now be able to see AdGuard among the available extensions. Tap it and then the yellow i icon. Enable Advanced protection by tapping the Turn on button and confirming the action.

If you use AdGuard for iOS without Premium subscription, you won't be able to enable Advanced protection .

Alternatively, you can enable Advanced protection directly from the app, in the Protection tab (second from the left in the bottom icon row).

AdGuard's Safari Web extension only works on iOS versions 15 and later.

• What it does
• In the iOS settings