What If rule-provider Fails to Update or the Rule Set Is Empty?

Common causes include an unreachable URL, a format mismatch, insufficient path permissions, stale cache, or a provider response that does not contain rules.

  • Rule-Based Routing
  • Troubleshooting
Short answer

Common causes of rule-set update failures include an unreachable URL, a format mismatch, insufficient path permissions, a stale cache, or a provider response that is not rule content. After correcting the address, behavior, and cache-file permissions, update only that provider. Leave node subscriptions unchanged so the two problems remain separate.

Where do the status code, behavior, and response disagree?

Inspect the rule-set URL's status and body directly. An HTML login page, empty file, or behavior that does not match the content can make a provider appear downloaded but fail to load.

  • Does the log show an HTTP status or download error?
  • Is behavior domain, ipcidr, or classical?
  • Does the rule-set file have read and write permission?
  • Was the remote content redirected to an HTML error page?

Correct the rule-set address, format, and local cache

  1. Use a browser or curl to inspect the response from the rule-set URL
  2. Confirm that behavior matches the rule-set content format
  3. Clear the client's rule cache and update again
  4. Troubleshoot rule-set download failures separately from proxy-node connection failures

A rule-provider is not a proxy subscription and does not create nodes(See Rule providers, Subscription Import FAQ)

The rule-set provider may change the file path or format

Frequent rule-set updates may trigger server-side rate limiting