Jak v roce 2026 provozovat ConvertX ve vlastní infrastruktuře: uploady, JWT secrets a limity prostředků

„Spuštění ConvertX“ může znamenat dvě různé věci: kontejner existuje, nebo služba skutečně dokončuje svou práci. Důležitá je pouze druhá možnost. Důkazem je nahrát několik reprezentativních formátů, každý převést, stáhnout výsledky a u deterministických operací porovnat hashe nebo vlastnosti médií.

ConvertX slouží jako browserová služba pro převod souborů. Nasazení musí zachovat části, které toto chování zajišťují; port, volume a certifikát jsou vstupy, nikoli výsledek.

Zvolte nejmenší použitelnou topologii ConvertX

Začněte síťovým namespace ConvertX: jeho webový listener naslouchá na portu 3000, nikoli na hostitelském portu zkopírovaném z návodu pro notebook. Požadavkem lokálního runtime je CPU, paměť a dočasné úložiště odpovídající zvoleným konvertorům. Zdokumentujte očekávanou kapacitu, vlastnictví a scénář selhání, místo abyste tyto parametry ponechali na výchozím nastavení image.

Po splnění požadavků spusťte celý scénář — nahrajte několik reprezentativních formátů, každý převeďte, stáhněte výsledky a u deterministických operací porovnejte hashe nebo vlastnosti médií. Zaznamenejte logy a měření CPU, paměti, dočasného úložiště, velikosti souborů a binárních souborů konvertorů použitých pro jednotlivé dvojice formátů. Tyto údaje se stanou první známou funkční architekturou a umožní testovat pozdější přesuny mezi výpočetní infrastrukturou Dockup a připojeným serverem.

Rozlišujte interní a externí URL

Vyhněte se dočasným i trvalým veřejným originům pro ConvertX. Místo toho zpřístupněte UI přes HTTPS s promyšlenými limity uploadů, nasměrujte zvolený DNS název na route platformy a proxyujte pouze na port 3000.

Tuto operaci otestujte zvenčí hostitele: nahrajte několik reprezentativních formátů, každý převeďte, stáhněte výsledky a u deterministických operací porovnejte hashe nebo vlastnosti médií. Pokud ingress selže, průvodce řešením problémů s chybou 502 popisuje chyby v portech a listenerech. Pokud ConvertX požadavek přijme, ale chybí binární soubor konvertoru nebo proxy odmítne velký upload, důkazy nyní ukazují mimo proxy.

Nastavení kontejneru, které stojí za kontrolu

Spusťte ConvertX tak, aby route zůstala během bootstrapu privátní.

docker run -d \
  --name convertx \
  --restart unless-stopped \
  -p 127.0.0.1:3000:3000 \
  -v convertx-data:/app/data \
  -e JWT_SECRET=replace-with-a-long-random-value \
  ghcr.io/c4illin/convertx:latest

Pokud proces opakovaně padá a startuje, porovnejte očekávaného uživatele image s vlastníkem každé připojené cesty. Pokud zůstane běžet, otestujte lokálně port 3000 a poté rovnou přejděte k workflow: nahrajte několik reprezentativních formátů, každý převeďte, stáhněte výsledky a u deterministických operací porovnejte hashe nebo vlastnosti médií. Image připněte na konkrétní verzi až po úspěšném end-to-end ověření a přesnou konfiguraci uložte spolu se službou.

Nacvičte rizikovou změnu ConvertX

Nečinný health check o ConvertX mnoho nevypovídá. Sledujte CPU, paměť, dočasné úložiště, velikost souborů a binární soubory konvertorů použité pro jednotlivé dvojice formátů. Alerty nastavte na příznak, který uživatel skutečně zažije: selhání operace „nahrát několik reprezentativních formátů, každý převést, stáhnout výsledky a u deterministických operací porovnat hashe nebo vlastnosti médií“. Liveness ponechte lokální a nenáročný; readiness by měl informovat o migracích nebo inicializaci, aniž by způsobil restartovací smyčku.

Rizikovou oblastí upgradu je skutečnost, že nové verze image mohou přidávat nebo odebírat konvertory, proto otestujte přesnou matici formátů, na které se uživatelé spoléhají. Prostudujte release notes, vytvořte snapshot stavu, nasaďte cílovou verzi nad obnovenou kopií a akceptační operaci zopakujte. Pokud chybí binární soubor konvertoru nebo proxy odmítne velký upload, spojte požadavek klienta s prvním relevantním aplikačním logem, místo abyste naslepo mazali stav nebo přidávali redirecty.

Pět kontrol důkladnějších než health kontejneru

Nepoužívejte první provoz skutečných uživatelů jako akceptační test ConvertX. Připravte neškodná vzorová data a spusťte celou operaci „nahrát několik reprezentativních formátů, každý převést, stáhnout výsledky a u deterministických operací porovnat hashe nebo vlastnosti médií“. Poznamenejte si přesnou veřejnou URL, výsledek, referenci image a interval logů spojený s během testu.

Nahraďte kontejner a operaci zopakujte bez opětovného sestavení dat. Poté proveďte obnovu na prázdném hostiteli; podmínkou úspěšné obnovy je návrat účtů a nastavení a dokončení pevně definované matice formátů ve zvolených limitech. Při každém průchodu sledujte CPU, paměť, dočasné úložiště, velikost souborů a binární soubory konvertorů použité pro jednotlivé dvojice formátů. Alert nastavte na zhoršení transakce, nikoli na metriky nečinného kontejneru.

Jedna závěrečná kontrola by měla záměrně selhat: odešlete neškodný vstup blízko limitu prostředků nebo formátu spojeného s touto hranicí: chybí binární soubor konvertoru nebo proxy odmítne velký upload. Ověřte, že výsledná zpráva ConvertX identifikuje příslušnou hranici, místo aby spustila mazání dat nebo nekonečný restart. Obnovte platný stav a potvrďte, že stejná vzorová transakce opět proběhne úspěšně. Toto krátké cvičení zařaďte do checklistu pro release.

Najděte každý trvalý byte v ConvertX

Sada dat určených k obnově zahrnuje aplikační data, účty a případná uchovávaná nastavení převodů. Připojte /app/data ještě před bootstrapem, zapište neškodná vzorová data a nahraďte kontejner, abyste ověřili, že tato cesta je skutečně persistentní. Volume chrání data před nahrazením kontejneru, nikoli však před ztrátou hostitele, náhodným smazáním nebo poškozením na úrovni aplikace.

Vytvářejte zálohy s ohledem na zdroj dat: u živých databází podle potřeby používejte logické dumpy a soubory kopírujte pouze z konzistentního stavu. Jednu zašifrovanou kopii uchovávejte mimo hostitele ConvertX. Akceptační kritérium obnovy musí být konkrétní — účty a nastavení se vrátí a pevně definovaná matice formátů se dokončí ve zvolených limitech. Průvodce zálohami ověřenými obnovou vysvětluje, proč samotný úspěch úlohy nestačí.

Omezte oprávnění, která ConvertX má

Po prvním přihlášení zkontrolujte, co může dělat anonymní návštěvník, běžný uživatel a administrátor. Selháním, kterému se u ConvertX musíte vyhnout, je použití ukázkového JWT secretu nebo nabídka neomezených veřejných převodů. Zamýšlená politika je používat skutečný JWT secret, vyžadovat přihlášení a nastavit limity uploadů ještě před přijetím nedůvěryhodných souborů z internetu.

Vygenerujte JWT_SECRET jako dlouhou náhodnou hodnotu; její rotace obvykle zneplatní sessions nebo tokeny, proto naplánujte dopad na uživatele, místo abyste ji označovali za migraci šifrování. Účty používané závislostmi držte odděleně od lidských účtů, kde je to praktické zakažte nepotřebný odchozí provoz a omezte práci ovlivněnou CPU, pamětí, dočasným úložištěm, velikostí souborů a binárními soubory konvertorů použitými pro jednotlivé dvojice formátů.

Nasaďte ConvertX na Dockup bez ztráty jeho hranic

Dockup odstraňuje ruční práci s reverse proxy a životním cyklem kolem ConvertX. Služba během nahrazování získá stabilní HTTPS route na port 3000, injektovanou konfiguraci a persistentní úložiště. Připojený zákaznický server funguje podle stejného modelu jako výpočetní infrastruktura hostovaná na Dockup.

Po spuštění splňte aplikační kontrakt: zpřístupněte UI přes HTTPS s promyšlenými limity uploadů, potvrďte lokální požadavek — CPU, paměť a dočasné úložiště odpovídající zvoleným konvertorům — a proveďte tento důkaz: nahrajte několik reprezentativních formátů, každý převeďte, stáhněte výsledky a u deterministických operací porovnejte hashe nebo vlastnosti médií. Díky tomu zůstane one-click prostředí užitečné, aniž by zjednodušilo detaily, které zajišťují obnovitelnost a bezpečnost ConvertX.

Často kladené otázky

Co ConvertX potřebuje pro produkční nasazení?

Veďte kontejner ConvertX na portu 3000 přes jediný HTTPS origin. Požadavkem lokálního runtime je CPU, paměť a dočasné úložiště odpovídající zvoleným konvertorům. ConvertX nepovažujte za připravený, dokud nemůžete nahrát několik reprezentativních formátů, každý převést, stáhnout výsledky a u deterministických operací porovnat hashe nebo vlastnosti médií.

Která data ConvertX patří do zálohy?

Zachovejte /app/data a do stejného recovery manifestu zahrňte aplikační data, účty a případná uchovávaná nastavení převodů. Obnovení ConvertX je čisté pouze tehdy, když se vrátí účty a nastavení a pevně definovaná matice formátů se stále dokončí ve zvolených limitech.

Vyžaduje ConvertX HTTPS za reverse proxy?

Pro veřejný origin ConvertX použijte HTTPS a port 3000 ponechte na interní route. Nastavení ConvertX aplikujte správně: zpřístupněte UI přes HTTPS s promyšlenými limity uploadů. U ConvertX HTTPS chrání přihlašovací údaje nebo obsah uživatelů při přenosu a udržuje konzistentní chování klienta citlivé na origin.

Jak testovat upgrade ConvertX?

Obnovte aktuální stav ConvertX do izolovaného nasazení, aplikujte kandidátní verzi a zopakujte akceptační transakci. Věnujte zvláštní pozornost tomu, že nové verze image mohou přidávat nebo odebírat konvertory, proto otestujte přesnou matici formátů, na které se uživatelé spoléhají. Předchozí image ConvertX si ponechte, dokud nebudete rozumět hranici migrace dat a rollbacku.