Skip to content

Commit 3f77d2c

Browse files
committed
2 parents 934cd2c + 2dba73f commit 3f77d2c

1 file changed

Lines changed: 17 additions & 15 deletions

File tree

README.md

Lines changed: 17 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
![banner](https://github.com/11notes/defaults/blob/main/static/img/banner.png?raw=true)
22

3-
# 🇨🇭 SOCKET-PROXY
4-
[<img src="https://img.shields.io/badge/github-source-blue?logo=github&color=040308">](https://github.com/11notes/docker-SOCKET-PROXY)![size](https://img.shields.io/docker/image-size/11notes/socket-proxy/2.0.0?color=0eb305)![version](https://img.shields.io/docker/v/11notes/socket-proxy/2.0.0?color=eb7a09)![pulls](https://img.shields.io/docker/pulls/11notes/socket-proxy?color=2b75d6)[<img src="https://img.shields.io/github/issues/11notes/docker-SOCKET-PROXY?color=7842f5">](https://github.com/11notes/docker-SOCKET-PROXY/issues)
3+
# SOCKET-PROXY
4+
[<img src="https://img.shields.io/badge/github-source-blue?logo=github&color=040308">](https://github.com/11notes/docker-SOCKET-PROXY)![5px](https://github.com/11notes/defaults/blob/main/static/img/transparent5x2px.png?raw=true)![size](https://img.shields.io/docker/image-size/11notes/socket-proxy/2.0.0?color=0eb305)![5px](https://github.com/11notes/defaults/blob/main/static/img/transparent5x2px.png?raw=true)![version](https://img.shields.io/docker/v/11notes/socket-proxy/2.0.0?color=eb7a09)![5px](https://github.com/11notes/defaults/blob/main/static/img/transparent5x2px.png?raw=true)![pulls](https://img.shields.io/docker/pulls/11notes/socket-proxy?color=2b75d6)![5px](https://github.com/11notes/defaults/blob/main/static/img/transparent5x2px.png?raw=true)[<img src="https://img.shields.io/github/issues/11notes/docker-SOCKET-PROXY?color=7842f5">](https://github.com/11notes/docker-SOCKET-PROXY/issues)![5px](https://github.com/11notes/defaults/blob/main/static/img/transparent5x2px.png?raw=true)![swiss_made](https://img.shields.io/badge/Swiss_Made-FFFFFF?labelColor=FF0000&logo=data:image/svg%2bxml;base64,PHN2ZyB2ZXJzaW9uPSIxIiB3aWR0aD0iNTEyIiBoZWlnaHQ9IjUxMiIgdmlld0JveD0iMCAwIDMyIDMyIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPjxwYXRoIGQ9Im0wIDBoMzJ2MzJoLTMyeiIgZmlsbD0iI2YwMCIvPjxwYXRoIGQ9Im0xMyA2aDZ2N2g3djZoLTd2N2gtNnYtN2gtN3YtNmg3eiIgZmlsbD0iI2ZmZiIvPjwvc3ZnPg==)
55

66
Access your docker socket safely as read-only, rootless and distroless
77

@@ -18,14 +18,15 @@ These are the main tags for the image. There is also a tag for each commit and i
1818
# UNIQUE VALUE PROPOSITION 💶
1919
**Why should I run this image and not the other image(s) that already exist?** Good question! All the other images on the market that do exactly the same don’t do or offer these options:
2020

21-
* This image runs the proxy part as a specific UID/GID (not root), all other images run everything as root
22-
* This image uses a single binary, all other images use apps like Nginx or HAProxy (bloat)
23-
* This image has no shell since it is 100% distroless, all other images run on a distro like Debian or Alpine with full shell access (security)
24-
* This image does not ship with any CVE and is automatically maintained via CI/CD, all other images mostly have no CVE scanning or code quality tools in place
25-
* This image has no upstream dependencies, all other images have upstream dependencies
26-
* This image exposes the socket as a UNIX socket and TCP socket, all other images only expose it via a TCP socket
21+
> [!IMPORTANT]
22+
>* This image runs the proxy part as a specific UID/GID (not root), all other images run everything as root
23+
>* This image uses a single binary, all other images use apps like Nginx or HAProxy (bloat)
24+
>* This image has no shell since it is 100% distroless, all other images run on a distro like Debian or Alpine with full shell access (security)
25+
>* This image does not ship with any CVE and is automatically maintained via CI/CD, all other images mostly have no CVE scanning or code quality tools in place
26+
>* This image has no upstream dependencies, all other images have upstream dependencies
27+
>* This image exposes the socket as a UNIX socket and TCP socket, all other images only expose it via a TCP socket
2728
28-
If you value security, simplicity and the ability to interact with the maintainer and developer of an image. Then using my images is a great start in the right direction.
29+
If you value security, simplicity and the ability to interact with the maintainer and developer of an image. Using my images is a great start in that direction.
2930

3031
# COMPOSE ✂️
3132
```yaml
@@ -105,16 +106,17 @@ networks:
105106
* [11notes/socket-proxy](https://github.com/11notes/docker-SOCKET-PROXY)
106107

107108
# PARENT IMAGE 🏛️
108-
* [scratch](https://hub.docker.com/_/scratch)
109+
> [!IMPORTANT]
110+
This image is not based on another image but uses [scratch](https://hub.docker.com/_/scratch) as the starting layer. It is distroless and contains no shell or any other tools that could be a potential attack vector.
111+
109112

110-
# BUILT WITH 🧰
111-
* [11notes/util](https://github.com/11notes/docker-util)
112113

113114
# GENERAL TIPS 📌
114-
* Use a reverse proxy like Traefik, Nginx, HAproxy to terminate TLS and to protect your endpoints
115-
* Use Let’s Encrypt DNS-01 challenge to obtain valid SSL certificates for your services
115+
> [!TIP]
116+
>* Use a reverse proxy like Traefik, Nginx, HAproxy to terminate TLS and to protect your endpoints
117+
>* Use Let’s Encrypt DNS-01 challenge to obtain valid SSL certificates for your services
116118

117119
# ElevenNotes™️
118120
This image is provided to you at your own risk. Always make backups before updating an image to a different version. Check the [releases](https://github.com/11notes/docker-socket-proxy/releases) for breaking changes. If you have any problems with using this image simply raise an [issue](https://github.com/11notes/docker-socket-proxy/issues), thanks. If you have a question or inputs please create a new [discussion](https://github.com/11notes/docker-socket-proxy/discussions) instead of an issue. You can find all my other repositories on [github](https://github.com/11notes?tab=repositories).
119121

120-
*created 24.03.2025, 09:25:13 (CET)*
122+
*created 24.03.2025, 13:29:58 (CET)*

0 commit comments

Comments
 (0)