Categorygithub.com/tarampampam/mikrotik-hosts-parser
module
3.1.0-RC1+incompatible
Repository: https://github.com/tarampampam/mikrotik-hosts-parser.git
Documentation: pkg.go.dev

# README

Logo

MikroTik hosts parser

Release version Build Status Coverage Go Report Docker Build License

This application provides HTTP server, that can generate script for RouterOS-based routers for blocking "AD" hosts.

More information can be found here.

Previous version (PHP) can be found in php-version branch.

Usage

// TODO redis server can be used from redis.io

For local application starting using binary file, you must compile application (after repository cloning) using GOOS=linux GOARCH=amd64 go build -ldflags="-s -w" -o ./mikrotik-hosts-parser ./cmd/mikrotik-hosts-parser/ or make build, and then execute:

$ ./mikrotik-hosts-parser serve \
    --config ./config.yml \
    --listen 0.0.0.0 \
    --port 8080 \
    --resources-dir ./web

This command will start HTTP server using configuration from ./config.yml on port 8080 and use directory ./web for serving static files. Configuration file well-documented, so, feel free to change any settings on your choice!

Configuration file allows you to use environment variables with default values!

After that you can navigate your browser to http://127.0.0.1:8080/ and you will see something like that:

screenshot

Special endpoint /script/source?sources_urls=... generates RouterOS-based script using passed http-get parameters (watch examples on index page).

Using docker

Just execute in your terminal:

$ docker run --rm -p 8080:8080/tcp tarampampam/mikrotik-hosts-parser:X.X.X

Where X.X.X is image tag (application version). All available docker image tags can be found here.

Demo

I can't guarantee that this links will available forever, but you can use this application on following links:

Testing

For application testing we use built-in golang testing feature and docker-ce + docker-compose as develop environment. So, just write into your terminal after repository cloning:

$ make test

Changes log

Release date Commits since latest release

Changes log can be found here.

Support

Issues Issues

If you will find any package errors, please, make an issue in current repository.

License

This is open-sourced software licensed under the MIT License.

# Packages

No description provided by the author
No description provided by the author