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%

Limitace

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