clash_docker - Docker Proxy Management¶

A comprehensive Docker proxy management tool for enabling/disabling Docker proxy settings.

Usage:

clash_docker [OPTIONS] COMMAND [ARGS]...

Available Commands:

enable - Enable Docker proxy settings
disable - Disable Docker proxy settings
status - Check current proxy status
reset - Reset all proxy configurations

Detailed Commands¶

enable - Enable Docker Proxy¶

Enable Docker proxy settings:

clash_docker enable [OPTIONS]

Options:

-p, --proxy TEXT  Specify proxy URL (default: http://127.0.0.1:7890)
--help           Show help information

Examples:

# Use default proxy settings
clash_docker enable

# Use custom proxy
clash_docker enable --proxy http://192.168.1.100:8080

# Use SOCKS5 proxy
clash_docker enable -p socks5://127.0.0.1:1080

This command will:

Configure Docker client proxy (~/.docker/config.json)
If run with root privileges, also configure Docker daemon proxy (/etc/systemd/system/docker.service.d/http-proxy.conf)
Restart Docker service (only when configuring daemon proxy)

disable - Disable Docker Proxy¶

Disable Docker proxy settings:

clash_docker disable

This command will:

Remove Docker client proxy configuration
If run with root privileges, also remove Docker daemon proxy configuration
Restart Docker service (only when removing daemon proxy)

status - Check Docker Proxy Status¶

Check current Docker proxy status:

clash_docker status

Example output:

=== Docker Proxy Status ===
🟢 Docker client proxy: Enabled
   HTTP Proxy: http://127.0.0.1:7890
   HTTPS Proxy: http://127.0.0.1:7890
   No Proxy: localhost,127.0.0.1,::1
🟢 Docker daemon proxy: Enabled
   Configuration:
   Environment="HTTP_PROXY=http://127.0.0.1:7890"
   Environment="HTTPS_PROXY=http://127.0.0.1:7890"
   Environment="NO_PROXY=localhost,127.0.0.1,::1"

reset - Reset Docker Proxy Configuration¶

Reset all Docker proxy configurations:

clash_docker reset

This command will completely remove:

Docker client proxy configuration
Docker daemon proxy configuration

Permission Requirements¶

Client Proxy: Docker client proxy configuration doesn’t require special permissions and can be operated by regular users.

Daemon Proxy: Docker daemon proxy configuration requires root privileges because it needs to:

Modify systemd service configuration files
Restart Docker service

If you don’t have root privileges, the tool will display a warning message but will still configure the client proxy.

Troubleshooting¶

Issue: Docker Proxy Issues

For Docker proxy problems, see the detailed troubleshooting in the clash_docker section above.