pixelserv-tls

pixelserv-tls

Docker app from pbear's Repository

Overview

pixelserv-tls is a tiny bespoke HTTP/1.1 webserver with HTTPS and SNI support. It acts on behalf of hundreds of thousands of advert/tracker servers and responds to all requests with nothing to speed up web browsing. pixelserv-tls supports TLSv1.0, TLSv1.2 and TLSv1.3 and thus could operate with a wide range of browsers and client devices. Server certificates for any given advert/tracker domains are generated automatically on first use and saved to disk.

pixelserv-tls

It will run the tiny pixelserv-tls web server which will respond to all requests with just a 1pxl image. More info here: https://github.com/kvic-z/pixelserv-tls

A certificate is automaticaly generated at built step. To get it: http://127.0.0.1/ca.crt

Best way to use it:

The best way is to stock the certificates ( the root certificates and the fake certificates that will be created on the fly) to a folder on the host. So you back it up easily. So you should proceed like that:

  1. You run the container once. It will generate a root certificates.
    docker run -d \
    --name pixelserv-tls \
    -p 80:80 -p 443:443 \
    --restart always \
    imthai/pixelserv-tls
    OR if you' r under linux, you can attach to the port of the host machine (best situation):
    docker run -d \
    --name pixelserv-tls \
    --net=host \
    --restart always \
    imthai/pixelserv-tls

  2. You copy the generated ca.crt & ca.key to your host.
    docker cp pixelserv-tls:/var/cache/pixelserv/ca.crt .
    docker cp pixelserv-tls:/var/cache/pixelserv/ca.key .

  3. You delete the container
    docker rm -f pixelserv-tls

  4. You create a dedicated folder on the host ( let's say ~/pixelserv) where you put the ca.crt & ca.key

  5. Then you run again the container, using this time a specific volume pointing to the folder where you've put the certs:
    docker run -d \
    --name pixelserv-tls \
    -p 80:80 -p 443:443 \
    -v ~/pixelserv:/var/cache/pixelserv \
    --restart always \
    imthai/pixelserv-tls
    OR if you' r under linux, you can attach to the port of the host machine (best situation):
    docker run -d \
    --name pixelserv-tls \
    --net=host \
    -v ~/pixelserv:/var/cache/pixelserv \
    --restart always \
    imthai/pixelserv-tls

Infos:

Shell access whilst the container is running: docker exec -it pixelserv-tls /bin/sh

Buy Me A Coffee

Install pixelserv-tls on Unraid in a few clicks.

Find pixelserv-tls in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for pixelserv-tls Review the template variables and paths Click Install

Download Statistics

122,451
Total Downloads
40
This Month
71
Avg / Month

Total Downloads Over Time

Loading chart...

Related apps

Explore more like this

Explore all

Details

Repository
imthai/pixelserv-tls
Last Updated2022-02-05
First Seen2022-02-09

Runtime arguments

Web UI
http://[IP]:[PORT:443]
Network
bridge
Shell
sh
Privileged
false

Template configuration

Certficates dirPathrw
Target
/var/cache/pixelserv
HTTPPorttcp

Webserver - Http

Target
80
Default
80
Value
80
HTTPSPorttcp

Webserver - Https

Target
443
Default
443
Value
443