https://github.com/wollomatic/socket-proxy-configurator
A tool to configure wollomatic/socket-proxy
https://github.com/wollomatic/socket-proxy-configurator
docker-socket-proxy socket-proxy
Last synced: 22 days ago
JSON representation
A tool to configure wollomatic/socket-proxy
- Host: GitHub
- URL: https://github.com/wollomatic/socket-proxy-configurator
- Owner: wollomatic
- License: mit
- Created: 2026-05-26T17:17:39.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-06-05T11:18:59.000Z (about 1 month ago)
- Last Synced: 2026-06-05T12:23:29.978Z (about 1 month ago)
- Topics: docker-socket-proxy, socket-proxy
- Language: TypeScript
- Homepage: https://socket-proxy-configurator.wollomatic.dev/
- Size: 314 KB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# socket-proxy-configurator
A static web application for converting
[`docker-socket-proxy`](https://github.com/Tecnativa/docker-socket-proxy)
environment-style configuration into allowlist configuration for
[`wollomatic/socket-proxy`](https://github.com/wollomatic/socket-proxy).
The application runs entirely in the browser. It does not require a backend,
does not call external APIs, and does not send pasted configuration data away
from the user's machine.
URL: https://socket-proxy-configurator.wollomatic.dev/
> [!NOTE]
> This is an early release. The resulting allowlists should be carefully
> reviewed before use in production.
## What It Does
Some docker-socket-proxies use section-based environment variables such as
`CONTAINERS=1`, `IMAGES=0`, `PING=1`, and `POST=0` to control access to Docker
API paths.
`wollomatic/socket-proxy` uses explicit regular-expression allowlists per HTTP
method instead. This converter translates the familiar `docker-socket-proxy`
toggles into compatible `wollomatic/socket-proxy` rules.
For example, this input:
```env
CONTAINERS=1
EVENTS=1
PING=1
VERSION=1
POST=0
```
can be converted into command-line allowlist arguments such as:
```text
- '-allowGET=(/v[\d.]+)?/_ping'
- '-allowGET=(/v[\d.]+)?/events.*'
- '-allowGET=(/v[\d.]+)?/version'
- '-allowHEAD=(/v[\d.]+)?/_ping'
- '-allowHEAD=(/v[\d.]+)?/events.*'
- '-allowHEAD=(/v[\d.]+)?/version'
```
The generated output is meant to emulate `docker-socket-proxy` behavior as
closely as possible while using the allowlist model provided by
`wollomatic/socket-proxy`.
## Supported Input
The converter accepts pasted configuration in common formats:
- plain environment variable files
- `docker-compose.yml` environment snippets
- lines prefixed with `export`
- quoted values
- comments and empty lines
Boolean values are normalized case-insensitively. Supported enabled values
include `1`, `true`, `yes`, `on`, `enable`, and `enabled`. Supported disabled
values include `0`, `false`, `no`, `off`, `disable`, and `disabled`.
Unknown or invalid environment-style variables are ignored and shown as
warnings so the generated result remains auditable.
## Output Formats
The web app can generate:
- command-line arguments
- environment variables
- Docker labels
It also supports optional network listener compatibility settings for setups
that previously exposed `docker-socket-proxy` over a Docker network.
## Compatibility Notes
- `POST=0` generates only `GET` and `HEAD` allowlists.
- When `POST=1` and **Omit HTTP methods not used by Docker** is enabled, only
`POST`, `PUT`, and `DELETE` are generated because these are the write methods
used by the Docker API.
- When `POST=1` and **Omit HTTP methods not used by Docker** is disabled, all HTTP methods supported by
`wollomatic/socket-proxy` are allowed for the enabled Docker API sections.
- Regular expressions are emitted without explicit `^` and `$` anchors because
`wollomatic/socket-proxy` adds those internally.
- Generated rules should be reviewed and tested before use in production.
## Technology
- Svelte 5
- Vite
- TypeScript
- Static single-page application
## AI Assistance Notice
This application was created with the help of artificial intelligence.
## License
MIT