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

Download Statistics

122,613
Total Downloads
59
This Month
50
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