Přeskočit na obsah
DOPLŇKY

File Proxy — Proxy externích souborů přes vaši doménu

Servírujte externí soubory (fonty, skripty) přes vaší first-party doménu pro obejití blokování.

9 min čtení Pokročilý Aktualizováno 21.3.2026
File Proxy — Proxy externích souborů přes vaši doménu

Co je File Proxy?

File Proxy doplněk umožňuje servírovat externí JavaScript soubory (GA4 gtag.js, Meta Pixel, TikTok Pixel, atd.) přímo z vaší domény. Ad-blockery a ITP je nebudou blokovat, protože jsou na first-party URL.

Proč používat File Proxy?

  • Bypass ad-blockerů: track.vasedomeny.cz/ga4.js není blokován.
  • First-party cookies: Skripty nahrané z vaší domény = first-party cookies.
  • ITP bypass: Safari neblokuje first-party requests.
  • Compliance: Data neprocházejí přes 3rd party CDN.

Jak aktivovat

  1. Přejděte do Dashboard → Doplňky
  2. Zapněte toggle "File Proxy"
  3. Klikněte "Přidat proxy"
  4. Zadejte:

Konfigurace proxy záznamu

  • External URL: URL externího souboru (např. https://www.googletagmanager.com/gtag/js?id=G-XXXXXX)
  • Proxy Path: Lokální cesta na vaší doméně (např. /fp/ga4.js)
  • Cache Duration: Jak dlouho cachovat soubor (3600s = 1h, 86400s = 24h)

Příklady použití

1. GA4 gtag.js proxy

External URL: https://www.googletagmanager.com/gtag/js?id=G-XXXXXX
Proxy Path: /fp/ga4.js
Cache: 86400 (24h)

Použití na webu:

<script async src="https://track.vasedomeny.cz/fp/ga4.js"></script>

2. Meta Pixel proxy

External URL: https://connect.facebook.net/en_US/fbevents.js
Proxy Path: /fp/fbpixel.js
Cache: 3600 (1h)

Použití na webu:

<script async src="https://track.vasedomeny.cz/fp/fbpixel.js"></script>

3. TikTok Pixel proxy

External URL: https://analytics.tiktok.com/i18n/pixel/events.js?sdkid=XXXXXX
Proxy Path: /fp/tiktok.js
Cache: 3600 (1h)

Jak to funguje?

  1. Request přijde na https://track.vasedomeny.cz/fp/ga4.js
  2. DataNostro nginx location /fp/ → proxy_pass do tracking/views.py FileProxyView
  3. FileProxyView najde matching proxy entry v databázi
  4. Stáhne soubor z External URL (pokud není v cache)
  5. Uloží do Redis cache (TTL = Cache Duration)
  6. Vrátí soubor s hlavičkami: Content-Type: application/javascript, Cache-Control: max-age=86400

Performance

  • První request: 200-500ms (stahování z External URL)
  • Další requesty: 5-20ms (Redis cache hit)
  • Cache hit rate: 95-99%

💡 Doporučení:

Použijte File Proxy v kombinaci s Custom Loader pro maximální bypass ad-blockerů. Všechny tracking skripty (GTM + GA4 + Meta + TikTok) servirované z vaší domény = až 40% více dat.

Limitace

  • Max velikost souboru: 5 MB
  • Max počet proxy entries: 50
  • Nepodporuje dynamické query parametry (kromě ?id=XXX)