← Přehled / ai-search / configuration / retrieval / public-endpoint

Vlastní domény

Vlastní doména obsluhuje váš veřejný koncový bod z hostitelského názvu, který vlastníte, například search.example.com, místo výchozího <PUBLIC_ENDPOINT_ID>.search.ai.cloudflare.com název hostitele.

Endpointy a formáty požadavků se nemění. Mění se pouze hostitelský název:

https://search.example.com/search
https://search.example.com/chat/completions
https://search.example.com/mcp

Vlastní domény jsou zároveň základem pro omezení přístupu pomocí Cloudflare Access, který uživatelům umožňuje ověřit se u vašeho poskytovatele identity, než budou moci dotazovat váš indexovaný obsah.

• Veřejný endpoint musí být na instanci nebo jmenném prostoru již povolený. Přidání vlastní domény k instanci bez aktivního veřejného endpointu vrátí chybu 7093.
• Hostitelský název musí patřit do zóny, která je přidány do stejného účtu Cloudflare a je aktivní. Hostitelský název patřící jinému účtu vrátí chybu 7090.
• Každá instance nebo jmenný prostor podporuje jednu vlastní doménu.
• Hostitelský název lze najednou připojit pouze k jednomu veřejnému endpointu. Opětovné použití hostitelského názvu vrátí chybu 7091.
• Hostitelský název musí být plně kvalifikovaný název domény o délce až 253 znaků, například search.example.com. Zástupné znaky nejsou podporovány. Hostitelské názvy se ukládají malými písmeny.

Nastavte public_endpoint_params.custom_domains při vytváření nebo aktualizaci instance.

curl -X PUT "https://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/ai-search/namespaces/default/instances/<INSTANCE_ID>" \
  -H "Authorization: Bearer <API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "public_endpoint_params": {
      "enabled": true,
      "custom_domains": ["search.example.com"]
    }
  }'

Stejné pole je dostupné i u jmenných prostorů. Více informací najdete v Veřejné endpointy jmenného prostoru.

Cloudflare vystaví certifikát pro hostitelský název a zahájí ověření vlastnictví domény.

Vytvořte proxováno CNAME záznam v zóně, která vlastní vaši vlastní doménu. Cílem je výchozí hostitelský název veřejného endpointu, kterým je <PUBLIC_ENDPOINT_ID>.search.ai.cloudflare.com.

curl -X POST "https://api.cloudflare.com/client/v4/zones/<ZONE_ID>/dns_records" \
  -H "Authorization: Bearer <API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "CNAME",
    "name": "search",
    "content": "<PUBLIC_ENDPOINT_ID>.search.ai.cloudflare.com",
    "proxied": true
  }'

Vlastní doména začne obsluhovat provoz, jakmile se dokončí ověření vlastnictví domény.

Veřejný endpoint ve výchozím nastavení odpovídá jak na vlastní doméně, tak na výchozí <PUBLIC_ENDPOINT_ID>.search.ai.cloudflare.com hostitelský název. Nastavte default_domain_enabled na false a použít tak jen vlastní doménu. Výchozí hostitelský název poté vrací 404 s chybou 60018.

curl -X PUT "https://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/ai-search/namespaces/default/instances/<INSTANCE_ID>" \
  -H "Authorization: Bearer <API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "public_endpoint_params": {
      "enabled": true,
      "custom_domains": ["search.example.com"],
      "default_domain_enabled": false
    }
  }'

Tuto možnost vypněte vždy, když před vlastní doménu umístíte bezpečnostní kontroly. Tyto kontroly běží ve vaší vlastní zóně, takže veškerý provoz, který dosáhne výchozího hostitelského názvu, je obchází. Další informace najdete v Cloudflare Access.

Platí tři pravidla:

• Výchozí hostitelský název nelze vypnout bez alespoň jedné vlastní domény. Požadavek vrátí chybu 7096.
• Protože public_endpoint_params se nahrazuje celý, vynechání default_domain_enabled při pozdější aktualizaci je resetuje na true a znovu zpřístupní výchozí hostitelský název.
• Ponechte CNAME záznam směřující na výchozí hostitelský název. AI Search směruje podle hostitelského názvu, který klient požadoval, nikoli podle CNAME cíl, takže záznam funguje dál i po vypnutí výchozího hostitelského názvu.

Odešlete custom_domains jako prázdné pole. Cloudflare odstraní certifikát a přestane směrovat provoz na tento hostitelský název.

curl -X PUT "https://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/ai-search/namespaces/default/instances/<INSTANCE_ID>" \
  -H "Authorization: Bearer <API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "public_endpoint_params": {
      "enabled": true,
      "custom_domains": []
    }
  }'

Pokud default_domain_enabled je false, odebrání poslední vlastní domény ve stejném požadavku vrátí chybu 7096. Nejprve znovu povolte výchozí hostitelský název a poté doménu odeberte.

Odstranění instance nebo jmenného prostoru odstraní i jeho vlastní domény a certifikáty.