Przejdź do treści

IPv4 Manager

Dedykowane adresy IPv4 dla tego, co hostujesz.

Otwórz IPv4 Manager
Sprawdzono z pulpitem dnia 18 listopada 2026

Wszystko, co Menedżer IPv4 robi z Twoimi adresami, ma swoją metodę. Wszystkie działają na Twoim własnym koncie i wymagają Twojego klucza API. Każde wywołanie to POST na /cpi/<method> z treścią JSON, która niesie klucz, a odpowiedź ma postać { "code": ..., "data": ... }. Odmowa ma ujemny code i zdanie w data.

bash
curl -s https://xuda.ai/cpi/ipv4_list \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY"}'

Co robi każdy ekran, jako wywołanie

Plan wybiera się w dashboardzie, z okna planów. Nie ma metody publicznej.

Odczyt Twoich adresów

ipv4_list odpowiada listą Twoich adresów w kolejności adresów. Każdy ma:

ipv4_pool_status odpowiada available, coming_soon, prices według internal, external i parked oraz caps, które Twój plan dopuszcza dla internal i external. Przeczytaj go przed zakupem: gdy coming_soon jest true, nic nie jest w sprzedaży.

Kupno adresu

Znajdź, na co może wskazywać

ipv4_attach_targets wymienia Twoje VPS, wdrożenia, centra danych i load balancery, każde z id, kind (vps, deployment, datacenter lub balancer) i label. Workspace VPS nigdy nie jest celem dla nowego adresu.

Kup go

ipv4_purchase przyjmuje state (internal dla czegoś na Xuda, external dla własnego serwera) i target_id. Dla internal podaj id z listy, z jego kind i label. Dla external podaj nazwę hosta swojej maszyny. Domyślna karta konta jest obciążana na jego następnej fakturze. Odpowiedzią jest wiersz nowego adresu.

Nadaj mu nazwę

ipv4_set_ptr przyjmuje address i nazwę hosta ptr.

curl -s https://xuda.ai/cpi/ipv4_purchase \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","state":"internal","target_id":"YOUR_TARGET_ID","kind":"vps","label":"My server"}'

curl -s https://xuda.ai/cpi/ipv4_set_ptr \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","address":"YOUR_ADDRESS","ptr":"mail.example.com"}'
const call = async (method, body) => {
  const res = await fetch(`https://xuda.ai/cpi/${method}`, {
    method: 'POST',
    headers: { 'content-type': 'application/json' },
    body: JSON.stringify({ api_key: 'YOUR_API_KEY', ...body }),
  });
  return res.json();
};

const bought = await call('ipv4_purchase', { state: 'internal', target_id: 'YOUR_TARGET_ID', kind: 'vps', label: 'My server' });
if (bought.code > 0) await call('ipv4_set_ptr', { address: bought.data.address, ptr: 'mail.example.com' });
import requests

def call(method, **body):
    res = requests.post(f'https://xuda.ai/cpi/{method}', json={'api_key': 'YOUR_API_KEY', **body})
    return res.json()

bought = call('ipv4_purchase', state='internal', target_id='YOUR_TARGET_ID', kind='vps', label='My server')
if bought['code'] > 0:
    call('ipv4_set_ptr', address=bought['data']['address'], ptr='mail.example.com')

Nazwa odwrotnego DNS jest zapisywana bez białych znaków na brzegach i małymi literami i musi być nazwą hosta z kropką, jak mail.example.com.

Przenoszenie, parkowanie i zwalnianie

  • ipv4_attach kieruje posiadany adres na inny cel, z target_type internal lub external, zmieniając jego stan i stawkę. Rachunek jest naliczany proporcjonalnie.
  • ipv4_park sprawia, że adres do niczego nie dociera, i zachowuje go dla Ciebie po stawce za parkowanie.
  • ipv4_release zwraca go do puli i kończy rozliczanie. Odpowiedź ma quarantine_until, czyli dzień, w którym wraca do puli. Tego adresu nie da się odzyskać.

Gdy wywołanie jest odrzucone

data mówi dlaczego. Zdania, które mają znaczenie:

Rozliczenia są sprawdzane, zanim cokolwiek zostanie zajęte. Jeśli po zakupie nie da się zaktualizować rozliczeń, zajęcie jest cofane, więc odrzucony zakup nie zostawia żadnego adresu.

Konfiguracja połączenia

ipv4_external_config odpowiada mode, status i note dla adresu na Twoim własnym serwerze. Dziś status to pending: kroki konfiguracji tunelu i przekierowania nie są jeszcze gotowe, a ekran o tym mówi. Wywołanie dla adresu, który nie wskazuje na Twój własny serwer, jest odrzucane.

Jak oceniasz ten poradnik?

Ostatnia aktualizacja: 19 listopada 2026