Skip to content
Railgun
Visit Railgun on GitHub
Set theme to dark (⇧+D)

Railguns via IP ranges

It is possible to make a Railgun available to domains via IP ranges. This can be done by setting one or more IP range(s) that a Railgun will use. Once the Railgun IP Range(s) have been set, any domains that have origin IP(s) that fall within a Railgun’s IP Range(s) will have the ability to select and enable the Railgun.

POST ipr_set

POST /api/v2/railgun/ipr_set

Set the IP range(s) for a Railgun. This will expose the railgun to domains whose origin IP(s) are contained within the Railgun’s IP range.

The ipr holds IPv4 or IPv6 host addresses, and optionally their subnet, all in one field. The subnet is represented by the number of network address bits present in the host address (the “netmask”). If the netmask is 32 AND the address is IPv4, then the value does not indicate a subnet, only a single host. In IPv6, the address length is 128 bits, so 128 bits specify a unique host address.

The input format for this type is address/y where address is an IPv4 or IPv6 address and y is the number of bits in the netmask. If the /y portion is missing, the netmask is 32 for IPv4 and 128 for IPv6, so the value represents just a single host. On display, the /y portion is suppressed if the netmask specifies a single host.

For internal reasons, Cloudflare restricts the netmask range of 8 < netmask < 32 for IPv4 and 112 < netmask < 128 for IPv6.

Form parameters

  • rtkn – Railgun token
  • ipr – One or more Railgun IP addresses/ranges. Use JSON array format.
Example request
POST /api/v2/railgun/ipr_set HTTP/1.1Host: www.cloudflare.comAccept: */*Content-Type: application/x-www-form-urlencoded
Example form parameters:
rtkn=7h8i9j0k1l2m3n4o5p6q7r8id9h0j1lipr=["203.0.0.0/8","208.0.0.0/8","207.0.0.7","BE81::02C3:B44F:FE1E:8329/112"]
Example response
HTTP/1.1 200 OKContent-Type: application/json
{     "msg": null,     "response": {        "act": "railgun_ipr_set",        "railgun_id": "1079",    },    "result": "success"}