π¦ ClawHub
Nginx Proxy Manager
by @weird-aftertaste
Manage Nginx Proxy Manager (NPM) hosts, certificates, and access lists. Use when the user wants to add a new domain, point a domain to a server/port, enable SSL, or check the status of proxy hosts.
TERMINAL
clawhub install npm-proxyπ About This Skill
name: npm-proxy description: Manage Nginx Proxy Manager (NPM) hosts, certificates, and access lists. Use when the user wants to add a new domain, point a domain to a server/port, enable SSL, or check the status of proxy hosts.
NPM Proxy Skill
Manage Nginx Proxy Manager (NPM) via its REST API.
Configuration
Set the following environment variables:
NPM_URL: The URL of your NPM instance (e.g., https://npm.example.com)NPM_EMAIL: Your NPM admin emailNPM_PASSWORD: Your NPM admin passwordUsage
# List all proxy hosts
python scripts/npm_client.py hostsGet details for a specific host
python scripts/npm_client.py host Enable/Disable a host
python scripts/npm_client.py enable
python scripts/npm_client.py disable Delete a host
python scripts/npm_client.py delete List certificates
python scripts/npm_client.py certs
Workflows
Adding a new Proxy Host
To add a new host, usecurl directly (the script is currently minimal).
Example payload for POST /api/nginx/proxy-hosts:
{
"domain_names": ["sub.example.com"],
"forward_scheme": "http",
"forward_host": "192.168.1.10",
"forward_port": 8080,
"access_list_id": 0,
"certificate_id": 0,
"ssl_forced": false,
"meta": {
"letsencrypt_email": "",
"letsencrypt_agree": false,
"dns_challenge": false
},
"advanced_config": "",
"locations": [],
"block_exploits": true,
"caching_enabled": false,
"allow_websocket_upgrade": true,
"http2_support": true,
"hsts_enabled": false,
"hsts_subdomains": false
}
Enabling SSL (Let's Encrypt)
1. List certs withcerts to see if one exists.
2. Update the host with certificate_id and ssl_forced: true.
π‘ Examples
# List all proxy hosts
python scripts/npm_client.py hostsGet details for a specific host
python scripts/npm_client.py host Enable/Disable a host
python scripts/npm_client.py enable
python scripts/npm_client.py disable Delete a host
python scripts/npm_client.py delete List certificates
python scripts/npm_client.py certs
βοΈ Configuration
Set the following environment variables:
NPM_URL: The URL of your NPM instance (e.g., https://npm.example.com)NPM_EMAIL: Your NPM admin emailNPM_PASSWORD: Your NPM admin password