a6-plugin-ip-restriction

Configure Apache APISIX ip-restriction plugin with IP whitelists or blacklists.

1|2|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/moonming/a6 --skill a6-plugin-ip-restriction
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: a6-plugin-ip-restriction
Source: https://github.com/moonming/a6/tree/main/skills/a6-plugin-ip-restriction
Command: npx skills add https://github.com/moonming/a6 --skill a6-plugin-ip-restriction

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill allows you to precisely control network access to your API routes by defining specific IP addresses or ranges that are permitted or denied.

Core Features & Use Cases

  • IP Whitelisting/Blacklisting: Define explicit lists of allowed or blocked IP addresses and CIDR ranges.
  • IPv4/IPv6 Support: Works seamlessly with both IPv4 and IPv6 addressing.
  • Customizable Responses: Configure custom error messages and HTTP response codes for denied access.
  • Use Case: Secure your internal admin API by only allowing access from your company's corporate IP ranges, while blocking all external traffic.

Quick Start

Create a route that only allows access from the specified internal IP ranges.

Frequently Asked Questions about a6-plugin-ip-restriction

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I restrict access to APISIX routes by IP address?

You can restrict APISIX route access by configuring the ip-restriction plugin with IP whitelists or blacklists. This enables route-level network access control using explicit allowed or blocked IP addresses.

Can I use CIDR notation for IP whitelisting and blacklisting in APISIX?

Yes, you can use CIDR notation for IP whitelisting and blacklisting in APISIX. The ip-restriction plugin supports both CIDR ranges and individual IPv4 or IPv6 addresses to filter network traffic.

Does the APISIX ip-restriction plugin support IPv6 addresses?

Yes, the APISIX ip-restriction plugin fully supports IPv6 addresses. It works seamlessly with both IPv4 and IPv6 addressing for defining IP whitelists or blacklists on your routes.

How do I return a custom error message when APISIX blocks an IP?

To return a custom error message when APISIX blocks an IP, configure the customizable response options in the ip-restriction plugin. You can define specific denial messages and HTTP response codes for denied access.

How do I get the real client IP for APISIX access control behind a proxy?

To get the real client IP for APISIX access control behind a proxy, use the real-ip plugin for real client IP extraction. This ensures the ip-restriction plugin evaluates the actual origin address.