portmaster-plugin-hosts

README

portmaster-plugin-hosts

DISCLAIMER: This is not an official Safing product!

This repository provides a Safing Portmaster resolver plugin that resolves DNS queries using the hosts file.

Warning: This repository is based on the experimental Portmaster Plugin System which is available in safing/portmaster#834 but has not been merged and released yet.

Installation

Using the install command

This plugin uses the cmds.InstallCommand() from the portmaster plugin framework so installation is as simple as:

go build .
sudo ./portmaster-plugin-hosts install --data /opt/safing/portmaster

Manual Installation

To manually install the plugin follow these steps:

1. Build the plugin from source code: go build .

2. Move the plugin /opt/safing/portmaster/plugins/portmaster-plugin-hosts

3. Edit /opt/safing/portmaster/plugins.json to contain the following content:

   [
        {
            "name": "portmaster-plugin-hosts",
            "types": [
                "decider"
            ],
            "config": {
                "path": "/etc/hosts"
            }
        }
   ]
   

Configuration

Important: Before being able to use plugins in the Portmaster you must enable the "Plugin System" in the global settings page. Note that this setting is still marked as "Experimental" and "Developer-Only" so you'r Portmaster needs the following settings adjusted to even show the "Plugin System" setting:

• Developer Mode
• Feature Stability

The plugin can either be configured using static configuration in plugins.json.

Just specify the static configuration when using portmaster-plugin-hosts install. For example:

sudo ./portmaster-plugin-hosts install --path /path/to/hosts/file