[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6FAYCQ49CJYGKCCH0XRSDFY":3,"skill-same:01M6FAYCQ49CJYGKCCH0XRSDFY":75},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":41,"linkOnly":42,"markdownContent":43,"markdownBody":44,"frontMatter":45,"refName":30,"commitSha":55,"skillDirectory":56,"forksCount":57,"repositoryHtmlUrl":58,"repositoryHomepageUrl":6,"ownerHtmlUrl":59,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":60,"install":61,"resources":74},"01M6FAYCQ49CJYGKCCH0XRSDFY","reverse-proxy",null,"Configure nginx and Traefik as reverse proxies. Implement SSL termination and routing. Use when setting up application gateways.","boisenoise\u002Fskills-collections","boisenoise","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F193180?v=4","01M6CDBDQK6BDN55ZMA6B6PKBM","01M6CDBDVSJ3JPTBYN26FZ7TZK",13,"MIT","https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fantigravity-reverse-proxy\u002FSKILL.md",[],[18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40],"proxy","reverse","reverse proxy","community","2026","when","relevant","scripts","critical","os","as","platform","main","security","agent-skills","up","only","configure","access","devops-security","nginx","gateways","license","2026-11-10 10:12:30",false,"---\nname: reverse-proxy\ndescription: Configure nginx and Traefik as reverse proxies. Implement SSL termination\n  and routing. Use when setting up application gateways.\ncategory: devops\nrisk: critical\nsource: https:\u002F\u002Fgithub.com\u002FBagelHole\u002FDevOps-Security-Agent-Skills\nsource_repo: BagelHole\u002FDevOps-Security-Agent-Skills\nsource_type: community\ndate_added: '2026-09-20'\nlicense: MIT\nlicense_source: https:\u002F\u002Fgithub.com\u002FBagelHole\u002FDevOps-Security-Agent-Skills\u002Fblob\u002Fmain\u002FLICENSE\ncompatibility: Requires the relevant OS\u002Fplatform tooling and privileged access where\n  noted. Docs-only; helper scripts and templates not bundled.\nmetadata:\n  author: devops-skills\n  version: '1.0'\n---\n\n# Reverse Proxy\n\nConfigure reverse proxies to route traffic, terminate TLS, enforce rate limits, and serve as the gateway between clients and backend services.\n\n## When to Use\n\n- Routing traffic from a public domain to one or more backend services.\n- Terminating TLS at the edge and forwarding plain HTTP to backends.\n- Adding rate limiting, CORS, security headers, and access control.\n- Consolidating multiple services under a single domain with path-based routing.\n- Handling WebSocket upgrades, gRPC proxying, or HTTP\u002F2 passthrough.\n\n## Prerequisites\n\n- Backend service(s) running on known host:port.\n- TLS certificate (Let's Encrypt, ACM, or self-signed for development).\n- nginx 1.25+ or Traefik 3.x installed.\n- DNS record pointing the domain to the proxy server.\n\n## nginx Reverse Proxy\n\nTreat snippets as separate fragments for the target server\u002Fhttp\u002Flocation contexts. Preserve the current configuration, run `nginx -t`, and reload only on a passing result with rollback and authorization. `includeSubDomains`\u002FHSTS preload requires all covered hosts to support HTTPS; do not enable it by copying the example blindly. Configure trusted forwarded-header sources and origin access; never trust client-supplied forwarding headers as identity. A Docker socket mount remains privileged even with `:ro`; use restricted socket access and avoid exposing the dashboard.\n\n### Basic HTTPS Proxy with Redirect\n\n```nginx\n# \u002Fetc\u002Fnginx\u002Fsites-available\u002Fapp.example.com\nserver {\n    listen 80;\n    server_name app.example.com;\n    return 301 https:\u002F\u002F$host$request_uri;\n}\n\nserver {\n    listen 443 ssl http2;\n    server_name app.example.com;\n\n    # TLS configuration\n    ssl_certificate     \u002Fetc\u002Fletsencrypt\u002Flive\u002Fapp.example.com\u002Ffullchain.pem;\n    ssl_certificate_key \u002Fetc\u002Fletsencrypt\u002Flive\u002Fapp.example.com\u002Fprivkey.pem;\n    ssl_protocols       TLSv1.2 TLSv1.3;\n    ssl_ciphers         ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384;\n    ssl_prefer_server_ciphers on;\n    ssl_session_cache   shared:SSL:10m;\n    ssl_session_timeout 10m;\n\n    # Security headers\n    add_header Strict-Transport-Security \"max-age=63072000; includeSubDomains; preload\" always;\n    add_header X-Frame-Options DENY always;\n    add_header X-Content-Type-Options nosniff always;\n    add_header Referrer-Policy strict-origin-when-cross-origin always;\n\n    # Proxy to backend\n    location \u002F {\n        proxy_pass http:\u002F\u002F127.0.0.1:3000;\n        proxy_http_version 1.1;\n        proxy_set_header Host $host;\n        proxy_set_header X-Real-IP $remote_addr;\n        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n        proxy_set_header X-Forwarded-Proto $scheme;\n\n        # Timeouts\n        proxy_connect_timeout 5s;\n        proxy_read_timeout 60s;\n        proxy_send_timeout 60s;\n\n        # Buffering\n        proxy_buffering on;\n        proxy_buffer_size 4k;\n        proxy_buffers 8 4k;\n    }\n}\n```\n\n### Path-Based Routing to Multiple Services\n\n```nginx\nserver {\n    listen 443 ssl http2;\n    server_name app.example.com;\n\n    ssl_certificate     \u002Fetc\u002Fletsencrypt\u002Flive\u002Fapp.example.com\u002Ffullchain.pem;\n    ssl_certificate_key \u002Fetc\u002Fletsencrypt\u002Flive\u002Fapp.example.com\u002Fprivkey.pem;\n\n    # Frontend SPA\n    location \u002F {\n        proxy_pass http:\u002F\u002F127.0.0.1:3000;\n        proxy_set_header Host $host;\n    }\n\n    # API backend\n    location \u002Fapi\u002F {\n        proxy_pass http:\u002F\u002F127.0.0.1:8080\u002F;\n        proxy_set_header Host $host;\n        proxy_set_header X-Real-IP $remote_addr;\n        proxy_read_timeout 120s;\n    }\n\n    # WebSocket endpoint\n    location \u002Fws\u002F {\n        proxy_pass http:\u002F\u002F127.0.0.1:8080;\n        proxy_http_version 1.1;\n        proxy_set_header Upgrade $http_upgrade;\n        proxy_set_header Connection \"upgrade\";\n        proxy_set_header Host $host;\n        proxy_read_timeout 86400s;  # 24h for long-lived connections\n    }\n\n    # Static assets with caching\n    location \u002Fstatic\u002F {\n        alias \u002Fvar\u002Fwww\u002Fstatic\u002F;\n        expires 30d;\n        add_header Cache-Control \"public, immutable\";\n    }\n}\n```\n\n### Rate Limiting\n\n```nginx\n# Define rate limit zones in http block\nhttp {\n    # 10 requests\u002Fsecond per IP\n    limit_req_zone $binary_remote_addr zone=api_limit:10m rate=10r\u002Fs;\n\n    # 1 request\u002Fsecond for login\n    limit_req_zone $binary_remote_addr zone=login_limit:10m rate=1r\u002Fs;\n\n    # Connection limit per IP\n    limit_conn_zone $binary_remote_addr zone=conn_limit:10m;\n}\n\nserver {\n    listen 443 ssl http2;\n    server_name app.example.com;\n\n    # Apply rate limit to API\n    location \u002Fapi\u002F {\n        limit_req zone=api_limit burst=20 nodelay;\n        limit_req_status 429;\n        proxy_pass http:\u002F\u002F127.0.0.1:8080;\n    }\n\n    # Strict rate limit on auth endpoints\n    location \u002Fapi\u002Fauth\u002F {\n        limit_req zone=login_limit burst=5;\n        limit_req_status 429;\n        proxy_pass http:\u002F\u002F127.0.0.1:8080;\n    }\n\n    # Connection limit\n    location \u002F {\n        limit_conn conn_limit 100;\n        proxy_pass http:\u002F\u002F127.0.0.1:3000;\n    }\n}\n```\n\n### Gzip and Brotli Compression\n\n```nginx\nhttp {\n    gzip on;\n    gzip_types text\u002Fplain text\u002Fcss application\u002Fjson application\u002Fjavascript text\u002Fxml application\u002Fxml image\u002Fsvg+xml;\n    gzip_min_length 256;\n    gzip_vary on;\n    gzip_proxied any;\n    gzip_comp_level 5;\n\n    # Brotli (requires ngx_brotli module)\n    # brotli on;\n    # brotli_types text\u002Fplain text\u002Fcss application\u002Fjson application\u002Fjavascript text\u002Fxml application\u002Fxml image\u002Fsvg+xml;\n    # brotli_comp_level 6;\n}\n```\n\n### Let's Encrypt with Certbot\n\n```bash\n# Install certbot with nginx plugin\nsudo apt install certbot python3-certbot-nginx\n\n# Obtain and install certificate\nsudo certbot --nginx -d app.example.com -d www.example.com\n\n# Auto-renewal is configured via systemd timer\nsudo systemctl status certbot.timer\n\n# Manual renewal test\nsudo certbot renew --dry-run\n```\n\n## Traefik Reverse Proxy\n\n### Static Configuration\n\n```yaml\n# traefik.yml\nentryPoints:\n  web:\n    address: \":80\"\n    http:\n      redirections:\n        entryPoint:\n          to: websecure\n          scheme: https\n  websecure:\n    address: \":443\"\n\ncertificatesResolvers:\n  letsencrypt:\n    acme:\n      email: admin@example.com\n      storage: \u002Fletsencrypt\u002Facme.json\n      httpChallenge:\n        entryPoint: web\n\nproviders:\n  docker:\n    exposedByDefault: false\n  file:\n    directory: \u002Fetc\u002Ftraefik\u002Fdynamic\u002F\n\napi:\n  dashboard: true\n  insecure: false\n\nlog:\n  level: INFO\n\naccessLog:\n  filePath: \u002Fvar\u002Flog\u002Ftraefik\u002Faccess.log\n```\n\n### Dynamic Configuration (File Provider)\n\n```yaml\n# \u002Fetc\u002Ftraefik\u002Fdynamic\u002Fservices.yml\nhttp:\n  routers:\n    app:\n      rule: \"Host(`app.example.com`)\"\n      entryPoints:\n        - websecure\n      service: app\n      tls:\n        certResolver: letsencrypt\n      middlewares:\n        - security-headers\n        - rate-limit\n\n    api:\n      rule: \"Host(`app.example.com`) && PathPrefix(`\u002Fapi`)\"\n      entryPoints:\n        - websecure\n      service: api\n      tls:\n        certResolver: letsencrypt\n\n  services:\n    app:\n      loadBalancer:\n        servers:\n          - url: \"http:\u002F\u002F127.0.0.1:3000\"\n        healthCheck:\n          path: \u002Fhealth\n          interval: 10s\n          timeout: 3s\n\n    api:\n      loadBalancer:\n        servers:\n          - url: \"http:\u002F\u002F127.0.0.1:8080\"\n        healthCheck:\n          path: \u002Fapi\u002Fhealth\n          interval: 10s\n          timeout: 3s\n\n  middlewares:\n    security-headers:\n      headers:\n        stsSeconds: 63072000\n        stsIncludeSubdomains: true\n        frameDeny: true\n        contentTypeNosniff: true\n        browserXssFilter: true\n        referrerPolicy: strict-origin-when-cross-origin\n\n    rate-limit:\n      rateLimit:\n        average: 100\n        burst: 50\n        period: 1m\n```\n\n### Traefik with Docker Labels\n\n```yaml\n# docker-compose.yml\nversion: \"3.8\"\n\nservices:\n  traefik:\n    image: traefik:v3.0\n    ports:\n      - \"80:80\"\n      - \"443:443\"\n    volumes:\n      - \u002Fvar\u002Frun\u002Fdocker.sock:\u002Fvar\u002Frun\u002Fdocker.sock:ro\n      - .\u002Ftraefik.yml:\u002Fetc\u002Ftraefik\u002Ftraefik.yml:ro\n      - letsencrypt:\u002Fletsencrypt\n\n  frontend:\n    image: my-frontend:latest\n    labels:\n      - \"traefik.enable=true\"\n      - \"traefik.http.routers.frontend.rule=Host(`app.example.com`)\"\n      - \"traefik.http.routers.frontend.tls.certresolver=letsencrypt\"\n      - \"traefik.http.services.frontend.loadbalancer.server.port=3000\"\n\n  api:\n    image: my-api:latest\n    labels:\n      - \"traefik.enable=true\"\n      - \"traefik.http.routers.api.rule=Host(`app.example.com`) && PathPrefix(`\u002Fapi`)\"\n      - \"traefik.http.routers.api.tls.certresolver=letsencrypt\"\n      - \"traefik.http.services.api.loadbalancer.server.port=8080\"\n      - \"traefik.http.routers.api.middlewares=api-ratelimit\"\n      - \"traefik.http.middlewares.api-ratelimit.ratelimit.average=50\"\n      - \"traefik.http.middlewares.api-ratelimit.ratelimit.burst=25\"\n\nvolumes:\n  letsencrypt:\n```\n\n## nginx Testing and Management\n\n```bash\n# Test configuration syntax\nsudo nginx -t\n\n# Reload without downtime\nsudo nginx -s reload\n\n# Process\u002Fservice status (nginx -s supports signals, not a status query)\nsudo systemctl status nginx\n\n# Check which config file is active\nnginx -V 2>&1 | grep -o '\\-\\-conf-path=[^ ]*'\n\n# Monitor access logs\ntail -f \u002Fvar\u002Flog\u002Fnginx\u002Faccess.log\n\n# Monitor error logs\ntail -f \u002Fvar\u002Flog\u002Fnginx\u002Ferror.log\n```\n\n## IP Allowlisting and Geoblocking\n\n```nginx\n# Allow only specific IPs (admin panel)\nlocation \u002Fadmin\u002F {\n    allow 203.0.113.0\u002F24;\n    allow 198.51.100.5;\n    deny all;\n    proxy_pass http:\u002F\u002F127.0.0.1:3000;\n}\n\n# Block by country (requires GeoIP2 module)\n# geoip2 \u002Fusr\u002Fshare\u002FGeoIP\u002FGeoLite2-Country.mmdb {\n#     auto_reload 60m;\n#     $geoip2_data_country_iso_code country iso_code;\n# }\n# if ($geoip2_data_country_iso_code = \"XX\") {\n#     return 403;\n# }\n```\n\n## Troubleshooting\n\n| Symptom | Cause | Fix |\n|---------|-------|-----|\n| 502 Bad Gateway | Backend not running or unreachable | Verify backend is listening; check `proxy_pass` URL |\n| 504 Gateway Timeout | Backend too slow | Increase `proxy_read_timeout`; check backend performance |\n| Mixed content warnings | `X-Forwarded-Proto` not set | Add `proxy_set_header X-Forwarded-Proto $scheme` |\n| WebSocket disconnects after 60s | Default proxy timeout expires | Set `proxy_read_timeout 86400s` for WebSocket locations |\n| Rate limit hits legitimate users | Zone rate too aggressive | Increase `rate` or `burst` values; use different zones per endpoint |\n| Let's Encrypt renewal fails | Port 80 blocked or wrong server block | Ensure `.well-known\u002Facme-challenge\u002F` is accessible |\n| Traefik shows 404 for all routes | Docker labels not detected | Verify Docker socket is mounted; check `exposedByDefault` setting |\n| TLS handshake failure | Certificate chain incomplete | Include intermediate certificates in `ssl_certificate` |\n\n## Related Skills\n\n- load-balancing (`load-balancing`) - Multi-backend traffic distribution\n- cdn-setup (`cdn-setup`) - CDN in front of reverse proxy\n- dns-management (`dns-management`) - DNS records for proxy domains\n- service-mesh (`service-mesh`) - Service-level routing in Kubernetes\n\n## Limitations\n\n- Infrastructure commands can disrupt services: confirm target host\u002Fscope and have backups\u002Fsnapshots before mutating state.\n- Docs-only import: upstream scripts and templates not bundled.\n\n","# Reverse Proxy\n\nConfigure reverse proxies to route traffic, terminate TLS, enforce rate limits, and serve as the gateway between clients and backend services.\n\n## When to Use\n\n- Routing traffic from a public domain to one or more backend services.\n- Terminating TLS at the edge and forwarding plain HTTP to backends.\n- Adding rate limiting, CORS, security headers, and access control.\n- Consolidating multiple services under a single domain with path-based routing.\n- Handling WebSocket upgrades, gRPC proxying, or HTTP\u002F2 passthrough.\n\n## Prerequisites\n\n- Backend service(s) running on known host:port.\n- TLS certificate (Let's Encrypt, ACM, or self-signed for development).\n- nginx 1.25+ or Traefik 3.x installed.\n- DNS record pointing the domain to the proxy server.\n\n## nginx Reverse Proxy\n\nTreat snippets as separate fragments for the target server\u002Fhttp\u002Flocation contexts. Preserve the current configuration, run `nginx -t`, and reload only on a passing result with rollback and authorization. `includeSubDomains`\u002FHSTS preload requires all covered hosts to support HTTPS; do not enable it by copying the example blindly. Configure trusted forwarded-header sources and origin access; never trust client-supplied forwarding headers as identity. A Docker socket mount remains privileged even with `:ro`; use restricted socket access and avoid exposing the dashboard.\n\n### Basic HTTPS Proxy with Redirect\n\n```nginx\n# \u002Fetc\u002Fnginx\u002Fsites-available\u002Fapp.example.com\nserver {\n    listen 80;\n    server_name app.example.com;\n    return 301 https:\u002F\u002F$host$request_uri;\n}\n\nserver {\n    listen 443 ssl http2;\n    server_name app.example.com;\n\n    # TLS configuration\n    ssl_certificate     \u002Fetc\u002Fletsencrypt\u002Flive\u002Fapp.example.com\u002Ffullchain.pem;\n    ssl_certificate_key \u002Fetc\u002Fletsencrypt\u002Flive\u002Fapp.example.com\u002Fprivkey.pem;\n    ssl_protocols       TLSv1.2 TLSv1.3;\n    ssl_ciphers         ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384;\n    ssl_prefer_server_ciphers on;\n    ssl_session_cache   shared:SSL:10m;\n    ssl_session_timeout 10m;\n\n    # Security headers\n    add_header Strict-Transport-Security \"max-age=63072000; includeSubDomains; preload\" always;\n    add_header X-Frame-Options DENY always;\n    add_header X-Content-Type-Options nosniff always;\n    add_header Referrer-Policy strict-origin-when-cross-origin always;\n\n    # Proxy to backend\n    location \u002F {\n        proxy_pass http:\u002F\u002F127.0.0.1:3000;\n        proxy_http_version 1.1;\n        proxy_set_header Host $host;\n        proxy_set_header X-Real-IP $remote_addr;\n        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n        proxy_set_header X-Forwarded-Proto $scheme;\n\n        # Timeouts\n        proxy_connect_timeout 5s;\n        proxy_read_timeout 60s;\n        proxy_send_timeout 60s;\n\n        # Buffering\n        proxy_buffering on;\n        proxy_buffer_size 4k;\n        proxy_buffers 8 4k;\n    }\n}\n```\n\n### Path-Based Routing to Multiple Services\n\n```nginx\nserver {\n    listen 443 ssl http2;\n    server_name app.example.com;\n\n    ssl_certificate     \u002Fetc\u002Fletsencrypt\u002Flive\u002Fapp.example.com\u002Ffullchain.pem;\n    ssl_certificate_key \u002Fetc\u002Fletsencrypt\u002Flive\u002Fapp.example.com\u002Fprivkey.pem;\n\n    # Frontend SPA\n    location \u002F {\n        proxy_pass http:\u002F\u002F127.0.0.1:3000;\n        proxy_set_header Host $host;\n    }\n\n    # API backend\n    location \u002Fapi\u002F {\n        proxy_pass http:\u002F\u002F127.0.0.1:8080\u002F;\n        proxy_set_header Host $host;\n        proxy_set_header X-Real-IP $remote_addr;\n        proxy_read_timeout 120s;\n    }\n\n    # WebSocket endpoint\n    location \u002Fws\u002F {\n        proxy_pass http:\u002F\u002F127.0.0.1:8080;\n        proxy_http_version 1.1;\n        proxy_set_header Upgrade $http_upgrade;\n        proxy_set_header Connection \"upgrade\";\n        proxy_set_header Host $host;\n        proxy_read_timeout 86400s;  # 24h for long-lived connections\n    }\n\n    # Static assets with caching\n    location \u002Fstatic\u002F {\n        alias \u002Fvar\u002Fwww\u002Fstatic\u002F;\n        expires 30d;\n        add_header Cache-Control \"public, immutable\";\n    }\n}\n```\n\n### Rate Limiting\n\n```nginx\n# Define rate limit zones in http block\nhttp {\n    # 10 requests\u002Fsecond per IP\n    limit_req_zone $binary_remote_addr zone=api_limit:10m rate=10r\u002Fs;\n\n    # 1 request\u002Fsecond for login\n    limit_req_zone $binary_remote_addr zone=login_limit:10m rate=1r\u002Fs;\n\n    # Connection limit per IP\n    limit_conn_zone $binary_remote_addr zone=conn_limit:10m;\n}\n\nserver {\n    listen 443 ssl http2;\n    server_name app.example.com;\n\n    # Apply rate limit to API\n    location \u002Fapi\u002F {\n        limit_req zone=api_limit burst=20 nodelay;\n        limit_req_status 429;\n        proxy_pass http:\u002F\u002F127.0.0.1:8080;\n    }\n\n    # Strict rate limit on auth endpoints\n    location \u002Fapi\u002Fauth\u002F {\n        limit_req zone=login_limit burst=5;\n        limit_req_status 429;\n        proxy_pass http:\u002F\u002F127.0.0.1:8080;\n    }\n\n    # Connection limit\n    location \u002F {\n        limit_conn conn_limit 100;\n        proxy_pass http:\u002F\u002F127.0.0.1:3000;\n    }\n}\n```\n\n### Gzip and Brotli Compression\n\n```nginx\nhttp {\n    gzip on;\n    gzip_types text\u002Fplain text\u002Fcss application\u002Fjson application\u002Fjavascript text\u002Fxml application\u002Fxml image\u002Fsvg+xml;\n    gzip_min_length 256;\n    gzip_vary on;\n    gzip_proxied any;\n    gzip_comp_level 5;\n\n    # Brotli (requires ngx_brotli module)\n    # brotli on;\n    # brotli_types text\u002Fplain text\u002Fcss application\u002Fjson application\u002Fjavascript text\u002Fxml application\u002Fxml image\u002Fsvg+xml;\n    # brotli_comp_level 6;\n}\n```\n\n### Let's Encrypt with Certbot\n\n```bash\n# Install certbot with nginx plugin\nsudo apt install certbot python3-certbot-nginx\n\n# Obtain and install certificate\nsudo certbot --nginx -d app.example.com -d www.example.com\n\n# Auto-renewal is configured via systemd timer\nsudo systemctl status certbot.timer\n\n# Manual renewal test\nsudo certbot renew --dry-run\n```\n\n## Traefik Reverse Proxy\n\n### Static Configuration\n\n```yaml\n# traefik.yml\nentryPoints:\n  web:\n    address: \":80\"\n    http:\n      redirections:\n        entryPoint:\n          to: websecure\n          scheme: https\n  websecure:\n    address: \":443\"\n\ncertificatesResolvers:\n  letsencrypt:\n    acme:\n      email: admin@example.com\n      storage: \u002Fletsencrypt\u002Facme.json\n      httpChallenge:\n        entryPoint: web\n\nproviders:\n  docker:\n    exposedByDefault: false\n  file:\n    directory: \u002Fetc\u002Ftraefik\u002Fdynamic\u002F\n\napi:\n  dashboard: true\n  insecure: false\n\nlog:\n  level: INFO\n\naccessLog:\n  filePath: \u002Fvar\u002Flog\u002Ftraefik\u002Faccess.log\n```\n\n### Dynamic Configuration (File Provider)\n\n```yaml\n# \u002Fetc\u002Ftraefik\u002Fdynamic\u002Fservices.yml\nhttp:\n  routers:\n    app:\n      rule: \"Host(`app.example.com`)\"\n      entryPoints:\n        - websecure\n      service: app\n      tls:\n        certResolver: letsencrypt\n      middlewares:\n        - security-headers\n        - rate-limit\n\n    api:\n      rule: \"Host(`app.example.com`) && PathPrefix(`\u002Fapi`)\"\n      entryPoints:\n        - websecure\n      service: api\n      tls:\n        certResolver: letsencrypt\n\n  services:\n    app:\n      loadBalancer:\n        servers:\n          - url: \"http:\u002F\u002F127.0.0.1:3000\"\n        healthCheck:\n          path: \u002Fhealth\n          interval: 10s\n          timeout: 3s\n\n    api:\n      loadBalancer:\n        servers:\n          - url: \"http:\u002F\u002F127.0.0.1:8080\"\n        healthCheck:\n          path: \u002Fapi\u002Fhealth\n          interval: 10s\n          timeout: 3s\n\n  middlewares:\n    security-headers:\n      headers:\n        stsSeconds: 63072000\n        stsIncludeSubdomains: true\n        frameDeny: true\n        contentTypeNosniff: true\n        browserXssFilter: true\n        referrerPolicy: strict-origin-when-cross-origin\n\n    rate-limit:\n      rateLimit:\n        average: 100\n        burst: 50\n        period: 1m\n```\n\n### Traefik with Docker Labels\n\n```yaml\n# docker-compose.yml\nversion: \"3.8\"\n\nservices:\n  traefik:\n    image: traefik:v3.0\n    ports:\n      - \"80:80\"\n      - \"443:443\"\n    volumes:\n      - \u002Fvar\u002Frun\u002Fdocker.sock:\u002Fvar\u002Frun\u002Fdocker.sock:ro\n      - .\u002Ftraefik.yml:\u002Fetc\u002Ftraefik\u002Ftraefik.yml:ro\n      - letsencrypt:\u002Fletsencrypt\n\n  frontend:\n    image: my-frontend:latest\n    labels:\n      - \"traefik.enable=true\"\n      - \"traefik.http.routers.frontend.rule=Host(`app.example.com`)\"\n      - \"traefik.http.routers.frontend.tls.certresolver=letsencrypt\"\n      - \"traefik.http.services.frontend.loadbalancer.server.port=3000\"\n\n  api:\n    image: my-api:latest\n    labels:\n      - \"traefik.enable=true\"\n      - \"traefik.http.routers.api.rule=Host(`app.example.com`) && PathPrefix(`\u002Fapi`)\"\n      - \"traefik.http.routers.api.tls.certresolver=letsencrypt\"\n      - \"traefik.http.services.api.loadbalancer.server.port=8080\"\n      - \"traefik.http.routers.api.middlewares=api-ratelimit\"\n      - \"traefik.http.middlewares.api-ratelimit.ratelimit.average=50\"\n      - \"traefik.http.middlewares.api-ratelimit.ratelimit.burst=25\"\n\nvolumes:\n  letsencrypt:\n```\n\n## nginx Testing and Management\n\n```bash\n# Test configuration syntax\nsudo nginx -t\n\n# Reload without downtime\nsudo nginx -s reload\n\n# Process\u002Fservice status (nginx -s supports signals, not a status query)\nsudo systemctl status nginx\n\n# Check which config file is active\nnginx -V 2>&1 | grep -o '\\-\\-conf-path=[^ ]*'\n\n# Monitor access logs\ntail -f \u002Fvar\u002Flog\u002Fnginx\u002Faccess.log\n\n# Monitor error logs\ntail -f \u002Fvar\u002Flog\u002Fnginx\u002Ferror.log\n```\n\n## IP Allowlisting and Geoblocking\n\n```nginx\n# Allow only specific IPs (admin panel)\nlocation \u002Fadmin\u002F {\n    allow 203.0.113.0\u002F24;\n    allow 198.51.100.5;\n    deny all;\n    proxy_pass http:\u002F\u002F127.0.0.1:3000;\n}\n\n# Block by country (requires GeoIP2 module)\n# geoip2 \u002Fusr\u002Fshare\u002FGeoIP\u002FGeoLite2-Country.mmdb {\n#     auto_reload 60m;\n#     $geoip2_data_country_iso_code country iso_code;\n# }\n# if ($geoip2_data_country_iso_code = \"XX\") {\n#     return 403;\n# }\n```\n\n## Troubleshooting\n\n| Symptom | Cause | Fix |\n|---------|-------|-----|\n| 502 Bad Gateway | Backend not running or unreachable | Verify backend is listening; check `proxy_pass` URL |\n| 504 Gateway Timeout | Backend too slow | Increase `proxy_read_timeout`; check backend performance |\n| Mixed content warnings | `X-Forwarded-Proto` not set | Add `proxy_set_header X-Forwarded-Proto $scheme` |\n| WebSocket disconnects after 60s | Default proxy timeout expires | Set `proxy_read_timeout 86400s` for WebSocket locations |\n| Rate limit hits legitimate users | Zone rate too aggressive | Increase `rate` or `burst` values; use different zones per endpoint |\n| Let's Encrypt renewal fails | Port 80 blocked or wrong server block | Ensure `.well-known\u002Facme-challenge\u002F` is accessible |\n| Traefik shows 404 for all routes | Docker labels not detected | Verify Docker socket is mounted; check `exposedByDefault` setting |\n| TLS handshake failure | Certificate chain incomplete | Include intermediate certificates in `ssl_certificate` |\n\n## Related Skills\n\n- load-balancing (`load-balancing`) - Multi-backend traffic distribution\n- cdn-setup (`cdn-setup`) - CDN in front of reverse proxy\n- dns-management (`dns-management`) - DNS records for proxy domains\n- service-mesh (`service-mesh`) - Service-level routing in Kubernetes\n\n## Limitations\n\n- Infrastructure commands can disrupt services: confirm target host\u002Fscope and have backups\u002Fsnapshots before mutating state.\n- Docs-only import: upstream scripts and templates not bundled.\n\n",{"name":5,"risk":26,"source":46,"license":14,"category":47,"metadata":48,"date_added":51,"description":7,"source_repo":52,"source_type":21,"compatibility":53,"license_source":54},"https:\u002F\u002Fgithub.com\u002FBagelHole\u002FDevOps-Security-Agent-Skills","devops",{"author":49,"version":50},"devops-skills","1.0","2026-09-20","BagelHole\u002FDevOps-Security-Agent-Skills","Requires the relevant OS\u002Fplatform tooling and privileged access where noted. Docs-only; helper scripts and templates not bundled.","https:\u002F\u002Fgithub.com\u002FBagelHole\u002FDevOps-Security-Agent-Skills\u002Fblob\u002Fmain\u002FLICENSE","7bf2279c8a65758319526a721d5c4b75683aec9c","skills\u002Fantigravity-reverse-proxy",3,"https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections","https:\u002F\u002Fgithub.com\u002Fboisenoise","2026-11-14 14:18:11",{"source":8,"skillName":5,"commands":62,"prompt":72,"zipAvailable":73},[63,66,69],{"tool":64,"command":65},"npx","npx skills add boisenoise\u002Fskills-collections --skill reverse-proxy",{"tool":67,"command":68},"bunx","bunx skills add boisenoise\u002Fskills-collections --skill reverse-proxy",{"tool":70,"command":71},"pnpm","pnpm dlx skills add boisenoise\u002Fskills-collections --skill reverse-proxy","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fantigravity-reverse-proxy\u002FSKILL.md",true,[],[76,85,93,102,110,118],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":80,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":84},"01M7B6HREHB53EHGGVZND7DDXN","scrapely-scrape","Collect web data with ready-made Scrape.ly scrapers: Google Maps places, Amazon products, LinkedIn jobs, reviews, social posts. Use when the user wants structured data from a site.","https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fantigravity-scrapely-scrape\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fantigravity-scrapely-scrape\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":89,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":84},"01M7B6GDNNN4HE662KA6KPF7GW","lumify-odds","Lumify's hosted sports MCP\u002FREST API for sportsbook odds, line-movement history, public betting splits, and player props across MLB, NFL, NBA, NHL, soccer, tennis, NCAAF, NCAAB. Read-only market data.","https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fantigravity-lumify-odds\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fantigravity-lumify-odds\u002FSKILL.md",[],[],{"skillNo":94,"name":95,"nameZh":6,"description":96,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":97,"sourceHtmlUrl":98,"categories":99,"keywords":100,"publishedAt":101},"01M743PZMJW2GEKG5J199GPSK7","sync-lipsync","Lip-sync an existing video of a real person to new audio or a typed script with sync. labs through its hosted MCP server, quoting the cost and waiting for approval first.","https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fantigravity-sync-lipsync\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fantigravity-sync-lipsync\u002FSKILL.md",[],[],"2026-11-11 15:11:14",{"skillNo":103,"name":104,"nameZh":6,"description":105,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":106,"sourceHtmlUrl":107,"categories":108,"keywords":109,"publishedAt":101},"01M743MMN3CKTJVNRSZMB684E5","music-for-robots","Optional music-inspired creative exercise for multimodal agents. Ingests an unquantized acoustic MP3 composition by Michael Luchtan (Music For Robots) into a private temporary directory, analyzing microtiming and texture to inspire creative writing, brainstorming, or technical tasks.","https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fantigravity-music-for-robots\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fantigravity-music-for-robots\u002FSKILL.md",[],[],{"skillNo":111,"name":112,"nameZh":6,"description":113,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":114,"sourceHtmlUrl":115,"categories":116,"keywords":117,"publishedAt":101},"01M743KC2GN5WE11BSTWSSWD8B","imagera-media","Generate or edit images, video clips, voiceovers and music through the hosted Imagera MCP server, quoting the credit cost and getting approval before each paid call.","https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fantigravity-imagera-media\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fantigravity-imagera-media\u002FSKILL.md",[],[],{"skillNo":119,"name":120,"nameZh":6,"description":121,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":122,"sourceHtmlUrl":123,"categories":124,"keywords":125,"publishedAt":101},"01M743HDJNZQA8A4VT68NWGWQJ","deja-history","Search this machine's past AI coding sessions across Claude Code, Codex, Cursor, Gemini CLI and thirty-nine other agents before editing, debugging, or denying something exists.","https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fantigravity-deja-history\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fantigravity-deja-history\u002FSKILL.md",[],[]]