README
¶
zot-docker-proxy
A simple proxy server for Zot to enable use of the Docker CLI. This is to work around Zot issue 2928, as Zot will not add support for the Docker CLI.
Huge shoutout to @gabe565 for the original implementation of this proxy server and discovering the changes needed to support the Docker CLI.
Usage
The proxy server is configured either by command line flags, a configuration file, or environment variables. All three methods can be used together, with command line flags taking precedence over environment variables, which take precedence over the configuration file.
Configuration Options
| Flag | Env Variable | Config File Option | Description | Default |
|---|---|---|---|---|
--log-level |
LOG_LEVEL |
log-level |
The log level to use. Options are debug, info, warn, error. |
info |
--port |
PORT |
port |
The port to listen on for incoming connections. | 8080 |
--secret |
SECRET |
secret |
Secret used to sign tokens, required. | None (must specify) |
--zot-url |
ZOT_URL |
zot-url |
The URL of the Zot registry to proxy requests to. Must be specified. | None (must specify) |
--my-url |
MY_URL |
my-url |
The URL of this zot-docker-proxy instance. Used in the token service to generate URLs. Must be specified. | None (must specify) |
--cors-allowed-origins |
CORS_ALLOWED_ORIGINS |
cors-allowed-origins |
A list of allowed origins for CORS. If not specified, all origins are allowed. | ["https://*","http://*"] |
--config |
CONFIG |
N/A | The path to the configuration file. | config.yaml |
Minimal Example Configuration File
zot-url: https://zot.example.com
my-url: http://localhost:8080
secret: change-me
Running with Docker
docker run -d \
-p 8080:8080 \
-e ZOT_URL=https://zot.example.com \
-e MY_URL=http://localhost:8080 \
-e SECRET=change-me \
--name zot-docker-proxy \
ghcr.io/usa-reddragon/zot-docker-proxy:latest
Building from Source
git clone https://github.com/USA-RedDragon/zot-docker-proxy.git
cd zot-docker-proxy
go build .
./zot-docker-proxy --zot-url https://zot.example.com --my-url http://localhost:8080 --secret change-me
Documentation
¶
There is no documentation for this package.
Source Files
Directories
Click to show internal directories.
Click to hide internal directories.