diff --git a/docs/i18n/cs/API_REFERENCE.md b/docs/i18n/cs/API_REFERENCE.md index 8e1f623ae4..faa9628318 100644 --- a/docs/i18n/cs/API_REFERENCE.md +++ b/docs/i18n/cs/API_REFERENCE.md @@ -48,6 +48,8 @@ Content-Type: application/json | `X-OmniRoute-Idempotent` | Odpověď | `true` , pokud je odstraněna duplikace | | `X-OmniRoute-Progress` | Odpověď | `enabled` pokud je zapnuto sledování průběhu | +> Poznámka Nginx: pokud spoléháte na hlavičky s podtržítkem (například `x_session_id`), povolte `underscores_in_headers on;`. + --- ## Vložení diff --git a/docs/i18n/cs/CLI-TOOLS.md b/docs/i18n/cs/CLI-TOOLS.md index 05adf53eb9..ba6362c2ac 100644 --- a/docs/i18n/cs/CLI-TOOLS.md +++ b/docs/i18n/cs/CLI-TOOLS.md @@ -1,60 +1,79 @@ # Průvodce nastavením nástrojů CLI — OmniRoute -Tato příručka vysvětluje, jak nainstalovat a nakonfigurovat všechny podporované nástroje CLI pro kódování umělé inteligence tak, aby **OmniRoute** fungoval jako jednotný backend, což vám umožní centralizovanou správu klíčů, sledování nákladů, přepínání modelů a protokolování požadavků napříč všemi nástroji. +Tato příručka vysvětluje, jak nainstalovat a nakonfigurovat všechny podporované nástroje CLI pro kódování umělé inteligence +tak, aby **OmniRoute** fungoval jako jednotný backend, což vám umožní centralizovanou správu klíčů, +sledování nákladů, přepínání modelů a protokolování požadavků napříč všemi nástroji. --- ## Jak to funguje ``` -Claude / Codex / Gemini CLI / OpenCode / Cline / KiloCode / Continue / Kiro CLI - │ - ▼ (all point to OmniRoute) - http://YOUR_SERVER:20128/v1 - │ - ▼ (OmniRoute routes to the right provider) - Anthropic / OpenAI / Gemini / DeepSeek / Groq / Mistral / ... +Claude / Codex / OpenCode / Cline / KiloCode / Continue / Kiro / Cursor / Copilot + │ + ▼ (všechny ukazují na OmniRoute) + http://VASE_SERVER:20128/v1 + │ + ▼ (OmniRoute směruje ke správnému poskytovateli) + Anthropic / OpenAI / Gemini / DeepSeek / Groq / Mistral / ... ``` **Výhody:** -- Jeden klíč API pro správu všech nástrojů -- Sledování nákladů napříč všemi rozhraními příkazového řádku v dashboardu +- Jeden API klíč pro správu všech nástrojů +- Sledování nákladů napříč všemi CLI v dashboardu - Přepínání modelů bez nutnosti překonfigurování každého nástroje - Funguje lokálně i na vzdálených serverech (VPS) --- -## Podporované nástroje +## Podporované nástroje (Zdroj pravdy v dashboardu) -| Nástroj | Příkaz | Typ | Instalace | -| ---------------- | ------------------- | --------------- | -------------- | -| **Claude Code** | `claude` | CLI | npm | -| **OpenAI Codex** | `codex` | CLI | npm | -| **Gemini CLI** | `gemini` | CLI | npm | -| **OpenCode** | `opencode` | CLI | npm | -| **Cline** | `cline` | CLI + VS Code | npm | -| **KiloCode** | `kilocode` / `kilo` | CLI + VS Code | npm | -| **Continue** | průvodce | VS Code ext | VS kód | -| **Kiro CLI** | `kiro-cli` | CLI | curl instalace | -| **Kurzor** | `cursor` | Aplikace pro PC | Download | -| **Droid** | webový | Built-in agent | OmniRoute | -| **OpenClaw** | webový | Built-in agent | OmniRoute | +Karty dashboardu v `/dashboard/cli-tools` jsou generovány z `src/shared/constants/cliTools.ts`. +Aktuální seznam (v3.0.0-rc.16): + +| Nástroj | ID | Příkaz | Režim nastavení | Metoda instalace | +| ------------------ | ------------- | ------------ | --------------- | ---------------- | +| **Claude Code** | `claude` | `claude` | env | npm | +| **OpenAI Codex** | `codex` | `codex` | custom | npm | +| **Factory Droid** | `droid` | `droid` | custom | bundled/CLI | +| **OpenClaw** | `openclaw` | `openclaw` | custom | bundled/CLI | +| **Cursor** | `cursor` | aplikace | guide | desktop app | +| **Cline** | `cline` | `cline` | custom | npm | +| **Kilo Code** | `kilo` | `kilocode` | custom | npm | +| **Continue** | `continue` | rozšíření | guide | VS Code | +| **Antigravity** | `antigravity` | interní | mitm | OmniRoute | +| **GitHub Copilot** | `copilot` | rozšíření | custom | VS Code | +| **OpenCode** | `opencode` | `opencode` | guide | npm | +| **Kiro AI** | `kiro` | aplikace/CLI | mitm | desktop/CLI | + +### Synchronizace otisků CLI (Agenti + Nastavení) + +`/dashboard/agents` a `Nastavení > CLI Otisk` používají `src/shared/constants/cliCompatProviders.ts`. +To udržuje ID poskytovatelů v souladu s kartami CLI a staršími ID. + +| CLI ID | ID poskytovatele otisku | +| ---------------------------------------------------------------------------------------------------- | ----------------------- | +| `kilo` | `kilocode` | +| `copilot` | `github` | +| `claude` / `codex` / `antigravity` / `kiro` / `cursor` / `cline` / `opencode` / `droid` / `openclaw` | stejné ID | + +Starší ID jsou stále přijímána pro kompatibilitu: `copilot`, `kimi-coding`, `qwen`. --- -## Krok 1 – Získejte klíč OmniRoute API +## Krok 1 — Získejte OmniRoute API klíč -1. Otevřete dashboard OmniRoute → **Správce API** ( `/dashboard/api-manager` ) -2. Klikněte na **Vytvořit klíč API** -3. Pojmenujte to (např. `cli-tools` ) a vyberte všechna oprávnění. -4. Zkopírujte klíč – budete ho potřebovat pro každé níže uvedené rozhraní příkazového řádku. +1. Otevřete OmniRoute dashboard → **Správce API** (`/dashboard/api-manager`) +2. Klikněte na **Vytvořit API klíč** +3. Dejte mu název (např. `cli-tools`) a vyberte všechna oprávnění +4. Zkopírujte klíč — budete ho potřebovat pro každý CLI níže > Váš klíč vypadá takto: `sk-xxxxxxxxxxxxxxxx-xxxxxxxxx` --- -## Krok 2 – Instalace nástrojů CLI +## Krok 2 — Nainstalujte nástroje CLI Všechny nástroje založené na npm vyžadují Node.js 18+: @@ -65,9 +84,6 @@ npm install -g @anthropic-ai/claude-code # OpenAI Codex npm install -g @openai/codex -# Gemini CLI (Google) -npm install -g @google/gemini-cli - # OpenCode npm install -g opencode-ai @@ -75,47 +91,47 @@ npm install -g opencode-ai npm install -g cline # KiloCode -npm install -g kilecode +npm install -g kilocode -# Kiro CLI (Amazon — requires curl + unzip) -apt-get install -y unzip # on Debian/Ubuntu +# Kiro CLI (Amazon — vyžaduje curl + unzip) +apt-get install -y unzip # na Debian/Ubuntu curl -fsSL https://cli.kiro.dev/install | bash -export PATH="$HOME/.local/bin:$PATH" # add to ~/.bashrc +export PATH="$HOME/.local/bin:$PATH" # přidat do ~/.bashrc ``` -**Ověřit:** +**Ověření:** ```bash claude --version # 2.x.x codex --version # 0.x.x -gemini --version # 0.x.x opencode --version # x.x.x cline --version # 2.x.x -kilocode --version # x.x.x (or: kilo --version) +kilocode --version # x.x.x (nebo: kilo --version) kiro-cli --version # 1.x.x ``` --- -## Krok 3 – Nastavení globálních proměnných prostředí +## Krok 3 — Nastavte globální proměnné prostředí -Přidejte do `~/.bashrc` (nebo `~/.zshrc` ) a poté spusťte `source ~/.bashrc` : +Přidejte do `~/.bashrc` (nebo `~/.zshrc`), pak spusťte `source ~/.bashrc`: ```bash -# OmniRoute Universal Endpoint +# OmniRoute Univerzální koncový bod export OPENAI_BASE_URL="http://localhost:20128/v1" -export OPENAI_API_KEY="sk-your-omniroute-key" +export OPENAI_API_KEY="sk-vase-omniroute-klic" export ANTHROPIC_BASE_URL="http://localhost:20128/v1" -export ANTHROPIC_API_KEY="sk-your-omniroute-key" +export ANTHROPIC_API_KEY="sk-vase-omniroute-klic" export GEMINI_BASE_URL="http://localhost:20128/v1" -export GEMINI_API_KEY="sk-your-omniroute-key" +export GEMINI_API_KEY="sk-vase-omniroute-klic" ``` -> Pro **vzdálený server** nahraďte `localhost:20128` IP adresou nebo doménou serveru, např. `http://192.168.0.15:20128` . +> Pro **vzdálený server** nahraďte `localhost:20128` IP adresou nebo doménou serveru, +> např. `http://192.168.0.15:20128`. --- -## Krok 4 – Konfigurace jednotlivých nástrojů +## Krok 4 — Nakonfigurujte každý nástroj ### Claude Code @@ -123,11 +139,11 @@ export GEMINI_API_KEY="sk-your-omniroute-key" # Via CLI: claude config set --global api-base-url http://localhost:20128/v1 -# Or create ~/.claude/settings.json: +# Nebo vytvořte ~/.claude/settings.json: mkdir -p ~/.claude && cat > ~/.claude/settings.json << EOF { "apiBaseUrl": "http://localhost:20128/v1", - "apiKey": "sk-your-omniroute-key" + "apiKey": "sk-vase-omniroute-klic" } EOF ``` @@ -141,7 +157,7 @@ EOF ```bash mkdir -p ~/.codex && cat > ~/.codex/config.yaml << EOF model: auto -apiKey: sk-your-omniroute-key +apiKey: sk-vase-omniroute-klic apiBaseUrl: http://localhost:20128/v1 EOF ``` @@ -150,28 +166,13 @@ EOF --- -### Gemini CLI - -```bash -mkdir -p ~/.gemini && cat > ~/.gemini/settings.json << EOF -{ - "apiKey": "sk-your-omniroute-key", - "baseUrl": "http://localhost:20128/v1" -} -EOF -``` - -**Test:** `gemini "hello"` - ---- - ### OpenCode ```bash mkdir -p ~/.config/opencode && cat > ~/.config/opencode/config.toml << EOF [provider.openai] base_url = "http://localhost:20128/v1" -api_key = "sk-your-omniroute-key" +api_key = "sk-vase-omniroute-klic" EOF ``` @@ -179,7 +180,7 @@ EOF --- -### Cline (CLI nebo VS kód) +### Cline (CLI nebo VS Code) **Režim CLI:** @@ -188,41 +189,42 @@ mkdir -p ~/.cline/data && cat > ~/.cline/data/globalState.json << EOF { "apiProvider": "openai", "openAiBaseUrl": "http://localhost:20128/v1", - "openAiApiKey": "sk-your-omniroute-key" + "openAiApiKey": "sk-vase-omniroute-klic" } EOF ``` -**Režim VS Code:** Nastavení rozšíření Cline → Poskytovatel API: `OpenAI Compatible` → Základní URL: `http://localhost:20128/v1` +**Režim VS Code:** +Nastavení rozšíření Cline → API Provider: `OpenAI Compatible` → Base URL: `http://localhost:20128/v1` -Nebo použijte dashboard OmniRoute → **CLI Tools → Cline → Apply Config** . +Nebo použijte OmniRoute dashboard → **CLI Nástroje → Cline → Použít konfiguraci**. --- -### KiloCode (CLI nebo VS kód) +### KiloCode (CLI nebo VS Code) **Režim CLI:** ```bash -kilocode --api-base http://localhost:20128/v1 --api-key sk-your-omniroute-key +kilocode --api-base http://localhost:20128/v1 --api-key sk-vase-omniroute-klic ``` -**Nastavení VS kódu:** +**Nastavení VS Code:** ```json { "kilo-code.openAiBaseUrl": "http://localhost:20128/v1", - "kilo-code.apiKey": "sk-your-omniroute-key" + "kilo-code.apiKey": "sk-vase-omniroute-klic" } ``` -Nebo použijte dashboard OmniRoute → **CLI Tools → KiloCode → Apply Config** . +Nebo použijte OmniRoute dashboard → **CLI Nástroje → KiloCode → Použít konfiguraci**. --- -### Continue (rozšíření kódu VS) +### Continue (Rozšíření VS Code) -Upravit `~/.continue/config.yaml` : +Upravte `~/.continue/config.yaml`: ```yaml models: @@ -230,7 +232,7 @@ models: provider: openai model: auto apiBase: http://localhost:20128/v1 - apiKey: sk-your-omniroute-key + apiKey: sk-vase-omniroute-klic default: true ``` @@ -241,94 +243,95 @@ Po úpravě restartujte VS Code. ### Kiro CLI (Amazon) ```bash -# Login to your AWS/Kiro account: +# Přihlaste se ke svému AWS/Kiro účtu: kiro-cli login -# The CLI uses its own auth — OmniRoute is not needed as backend for Kiro CLI itself. -# Use kiro-cli alongside OmniRoute for other tools. +# CLI používá vlastní autentifikaci — OmniRoute není potřeba jako backend pro samotný Kiro CLI. +# Používejte kiro-cli společně s OmniRoute pro ostatní nástroje. kiro-cli status ``` --- -### Kurzor (aplikace pro stolní počítače) +### Cursor (Desktop aplikace) -> **Poznámka:** Cursor směruje požadavky přes svůj cloud. Pro integraci OmniRoute povolte **cloudový koncový bod** v nastavení OmniRoute a použijte URL adresu vaší veřejné domény. +> **Poznámka:** Cursor směruje požadavky přes své cloud. Pro integraci s OmniRoute, +> povolte **Cloud Endpoint** v nastavení OmniRoute a použijte vaši veřejnou doménu. -Přes GUI: **Nastavení → Modely → Klíč OpenAI API** +Via GUI: **Settings → Models → OpenAI API Key** -- Základní URL: `https://your-domain.com/v1` -- Klíč API: váš klíč OmniRoute +- Base URL: `https://vase-domena.com/v1` +- API Key: váš OmniRoute klíč --- -## Automatická konfigurace řídicího panelu +## Automatická konfigurace v dashboardu -Ovládací panel OmniRoute automatizuje konfiguraci většiny nástrojů: +OmniRoute dashboard automatizuje konfiguraci většiny nástrojů: -1. Přejděte na `http://localhost:20128/dashboard/cli-tools` -2. Rozbalit libovolnou kartu nástroje -3. Vyberte klíč API z rozbalovací nabídky -4. Klikněte **na Použít konfiguraci** (pokud je nástroj detekován jako nainstalovaný) -5. Nebo zkopírujte vygenerovaný konfigurační úryvek ručně +1. Jděte na `http://localhost:20128/dashboard/cli-tools` +2. Rozbalte libovolnou kartu nástroje +3. Vyberte svůj API klíč z rozbalovacího seznamu +4. Klikněte na **Použít konfiguraci** (pokud je nástroj detekován jako nainstalovaný) +5. Nebo ručně zkopírujte vygenerovaný konfigurační snippet --- -## Vestavění agenti: Droid a OpenClaw +## Vestavěný agenti: Droid & OpenClaw -**Droid** a **OpenClaw** jsou agenti umělé inteligence zabudovaní přímo do OmniRoute – není nutná žádná instalace. Běží jako interní trasy a automaticky používají modelové směrování OmniRoute. +**Droid** a **OpenClaw** jsou AI agenti vestavění přímo do OmniRoute — není potřeba žádná instalace. +Běží jako interní trasy a automaticky používají směrování modelů OmniRoute. - Přístup: `http://localhost:20128/dashboard/agents` -- Konfigurace: stejné kombinace a poskytovatelé jako u všech ostatních nástrojů -- Není vyžadována instalace klíče API ani příkazového řádku +- Konfigurace: stejné kombinace a poskytovatelé jako všechny ostatní nástroje +- Není potřeba API klíč ani instalace CLI --- -## Dostupné koncové body API +## Dostupné API koncové body | Koncový bod | Popis | Použití pro | | -------------------------- | --------------------------------------- | ------------------------------------- | | `/v1/chat/completions` | Standardní chat (všichni poskytovatelé) | Všechny moderní nástroje | -| `/v1/responses` | API pro odpovědi (formát OpenAI) | Kodex, agentické pracovní postupy | -| `/v1/completions` | Doplňování starších textů | Starší nástroje používající `prompt:` | -| `/v1/embeddings` | Vkládání textu | RAG, vyhledávání | -| `/v1/images/generations` | Generování obrázků | DALL-E, Flux atd. | -| `/v1/audio/speech` | Převod textu na řeč | ElevenLabs, OpenAI TTS | -| `/v1/audio/transcriptions` | Převod řeči na text | Deepgram, AssemblyAI | +| `/v1/responses` | Responses API (formát OpenAI) | Codex, agentní workflowy | +| `/v1/completions` | Legacy textové dokončení | Starší nástroje používající `prompt:` | +| `/v1/embeddings` | Textové vložení | RAG, vyhledávání | +| `/v1/images/generations` | Generování obrázků | DALL-E, Flux, atd. | +| `/v1/audio/speech` | Text-to-speech | ElevenLabs, OpenAI TTS | +| `/v1/audio/transcriptions` | Speech-to-text | Deepgram, AssemblyAI | --- -## Odstraňování problémů +## Řešení problémů -| Chyba | Příčina | Opravit | -| ---------------------------------- | ---------------------------------- | -------------------------------------------------------- | -| `Connection refused` | OmniRoute neběží | `pm2 start omniroute` | -| `401 Unauthorized` | Chybný klíč API | Zkontrolovat `/dashboard/api-manager` | -| `No combo configured` | Žádná aktivní routingová kombinace | Nastavení v `/dashboard/combos` | -| `invalid model` | Model není v katalogu | Použijte `auto` nebo zkontrolujte `/dashboard/providers` | -| CLI zobrazuje „není nainstalováno“ | Binární soubor není v cestě PATH | Zkontrolujte, `which ` | -| `kiro-cli: not found` | Není v PATH | `export PATH="$HOME/.local/bin:$PATH"` | +| Chyba | Příčina | Oprava | +| ----------------------------- | ----------------------- | -------------------------------------------------------- | +| `Connection refused` | OmniRoute neběží | `pm2 start omniroute` | +| `401 Unauthorized` | Špatný API klíč | Zkontrolujte v `/dashboard/api-manager` | +| `No combo configured` | Žádná aktivní kombinace | Nastavte v `/dashboard/combos` | +| `invalid model` | Model není v katalogu | Použijte `auto` nebo zkontrolujte `/dashboard/providers` | +| CLI zobrazuje "not installed" | Binárka není v PATH | Zkontrolujte `which ` | +| `kiro-cli: not found` | Není v PATH | `export PATH="$HOME/.local/bin:$PATH"` | --- -## Skript pro rychlé nastavení (jeden příkaz) +## Rychlý skript pro nastavení (jeden příkaz) ```bash -# Install all CLIs and configure for OmniRoute (replace with your key and server URL) +# Nainstalujte všechny CLI a nakonfigurujte pro OmniRoute (nahraďte svým klíčem a URL serveru) OMNIROUTE_URL="http://localhost:20128/v1" -OMNIROUTE_KEY="sk-your-omniroute-key" +OMNIROUTE_KEY="sk-vase-omniroute-klic" -npm install -g @anthropic-ai/claude-code @openai/codex @google/gemini-cli opencode-ai cline kilecode +npm install -g @anthropic-ai/claude-code @openai/codex opencode-ai cline kilocode # Kiro CLI apt-get install -y unzip 2>/dev/null; curl -fsSL https://cli.kiro.dev/install | bash -# Write configs -mkdir -p ~/.claude ~/.codex ~/.gemini ~/.config/opencode ~/.continue +# Zápis konfigurací +mkdir -p ~/.claude ~/.codex ~/.config/opencode ~/.continue cat > ~/.claude/settings.json <<< "{\"apiBaseUrl\":\"$OMNIROUTE_URL\",\"apiKey\":\"$OMNIROUTE_KEY\"}" cat > ~/.codex/config.yaml <<< "model: auto\napiKey: $OMNIROUTE_KEY\napiBaseUrl: $OMNIROUTE_URL" -cat > ~/.gemini/settings.json <<< "{\"apiKey\":\"$OMNIROUTE_KEY\",\"baseUrl\":\"$OMNIROUTE_URL\"}" cat >> ~/.bashrc << EOF export OPENAI_BASE_URL="$OMNIROUTE_URL" export OPENAI_API_KEY="$OMNIROUTE_KEY" @@ -337,5 +340,5 @@ export ANTHROPIC_API_KEY="$OMNIROUTE_KEY" EOF source ~/.bashrc -echo "✅ All CLIs installed and configured for OmniRoute" +echo "✅ Všechny CLI nainstalovány a nakonfigurovány pro OmniRoute" ``` diff --git a/docs/i18n/cs/README.md b/docs/i18n/cs/README.md index d00ed93ec4..9374a0ad20 100644 --- a/docs/i18n/cs/README.md +++ b/docs/i18n/cs/README.md @@ -1590,7 +1590,6 @@ opencode ### 🔐 OAuth na vzdáleném serveru - > **⚠️ Důležité pro uživatele, kteří provozují OmniRoute na VPS, Dockeru nebo jakémkoli vzdáleném serveru** diff --git a/docs/i18n/cs/VM_DEPLOYMENT_GUIDE.md b/docs/i18n/cs/VM_DEPLOYMENT_GUIDE.md index 98e078cb1e..c33bb94069 100644 --- a/docs/i18n/cs/VM_DEPLOYMENT_GUIDE.md +++ b/docs/i18n/cs/VM_DEPLOYMENT_GUIDE.md @@ -1,21 +1,23 @@ -# OmniRoute — Guia de Deploy em VM com Cloudflare +# Průvodce nasazením OmniRoute na VM s Cloudflare -Kompletní instalace a konfigurace OmniRoute u VM (VPS) s gerenciou přes Cloudflare. +🌐 **Jazyky:** 🇺🇸 [English](VM_DEPLOYMENT_GUIDE.md) | 🇧🇷 [Português (Brasil)](i18n/pt-BR/VM_DEPLOYMENT_GUIDE.md) | 🇪🇸 [Español](i18n/es/VM_DEPLOYMENT_GUIDE.md) | 🇫🇷 [Français](i18n/fr/VM_DEPLOYMENT_GUIDE.md) | 🇮🇹 [Italiano](i18n/it/VM_DEPLOYMENT_GUIDE.md) | 🇷🇺 [Русский](i18n/ru/VM_DEPLOYMENT_GUIDE.md) | 🇨🇳 [中文 (简体)](i18n/zh-CN/VM_DEPLOYMENT_GUIDE.md) | 🇩🇪 [Deutsch](i18n/de/VM_DEPLOYMENT_GUIDE.md) | 🇮🇳 [हिन्दी](i18n/in/VM_DEPLOYMENT_GUIDE.md) | 🇹🇭 [ไทย](i18n/th/VM_DEPLOYMENT_GUIDE.md) | 🇺🇦 [Українська](i18n/uk-UA/VM_DEPLOYMENT_GUIDE.md) | 🇸🇦 [العربية](i18n/ar/VM_DEPLOYMENT_GUIDE.md) | 🇯🇵 [日本語](i18n/ja/VM_DEPLOYMENT_GUIDE.md) | 🇻🇳 [Tiếng Việt](i18n/vi/VM_DEPLOYMENT_GUIDE.md) | 🇧🇬 [Български](i18n/bg/VM_DEPLOYMENT_GUIDE.md) | 🇩🇰 [Dansk](i18n/da/VM_DEPLOYMENT_GUIDE.md) | 🇫🇮 [Suomi](i18n/fi/VM_DEPLOYMENT_GUIDE.md) | 🇮🇱 [עברית](i18n/he/VM_DEPLOYMENT_GUIDE.md) | 🇭🇺 [Magyar](i18n/hu/VM_DEPLOYMENT_GUIDE.md) | 🇮🇩 [Bahasa Indonesia](i18n/id/VM_DEPLOYMENT_GUIDE.md) | 🇰🇷 [한국어](i18n/ko/VM_DEPLOYMENT_GUIDE.md) | 🇲🇾 [Bahasa Melayu](i18n/ms/VM_DEPLOYMENT_GUIDE.md) | 🇳🇱 [Nederlands](i18n/nl/VM_DEPLOYMENT_GUIDE.md) | 🇳🇴 [Norsk](i18n/no/VM_DEPLOYMENT_GUIDE.md) | 🇵🇹 [Português (Portugal)](i18n/pt/VM_DEPLOYMENT_GUIDE.md) | 🇷🇴 [Română](i18n/ro/VM_DEPLOYMENT_GUIDE.md) | 🇵🇱 [Polski](i18n/pl/VM_DEPLOYMENT_GUIDE.md) | 🇸🇰 [Slovenčina](i18n/sk/VM_DEPLOYMENT_GUIDE.md) | 🇸🇪 [Svenska](i18n/sv/VM_DEPLOYMENT_GUIDE.md) | 🇵🇭 [Filipino](i18n/phi/VM_DEPLOYMENT_GUIDE.md) | 🇨🇿 [Čeština](i18n/cs/VM_DEPLOYMENT_GUIDE.md) + +Kompletní průvodce instalací a konfigurací OmniRoute na virtuálním stroji (VPS) se správou domény prostřednictvím Cloudflare. --- ## Předpoklady -Položka | Mínimo | Doporučeno ---- | --- | --- -**Procesor** | 1 virtuální procesor | 2 vCPU -**BERAN** | 1 GB | 2 GB -**Disko** | 10GB SSD | 25GB SSD -**TAK** | Ubuntu 22.04 LTS | Ubuntu 24.04 LTS -**Domínio** | Registrován v Cloudflare | — -**Přístavní dělník** | Docker Engine 24+ | Docker 27+ +| Položka | Minimální | Doporučeno | +| ------------ | --------------------------- | ---------------- | +| **Procesor** | 1 virtuální procesor | 2 vCPU | +| **RAM** | 1 GB | 2 GB | +| **Disk** | 10GB SSD | 25GB SSD | +| **CPU** | Ubuntu 22.04 LTS | Ubuntu 24.04 LTS | +| **Doména** | Zaregistrována v Cloudflare | — | +| **Docker** | Docker Engine 24+ | Docker 27+ | -**Testados poskytovatelů** : Akamai (Linode), DigitalOcean, Vultr, Hetzner, AWS Lightsail. +**Testovaní poskytovatelé**: Akamai (Linode), DigitalOcean, Vultr, Hetzner, AWS Lightsail. --- @@ -23,12 +25,12 @@ Položka | Mínimo | Doporučeno ### 1.1 Vytvořit ihned -Žádný preferovaný poskytovatel seu VPS: +Žádný preferovaný poskytovatel VPS: - Vyberte si Ubuntu 24.04 LTS -- Výběr nebo plano minimo (1 vCPU / 1 GB RAM) -- Definujte sílu pro root nebo konfiguraci klíče SSH -- Anote o **IP público** (např.: `203.0.113.10` ) +- Vyberte minimální plán (1 vCPU / 1 GB RAM) +- Nastavte silné heslo pro root nebo konfiguraci SSH klíče +- Poznamenejte si **veřejnou IP** (např.: `203.0.113.10`) ### 1.2 Připojení přes SSH @@ -45,10 +47,10 @@ apt update && apt upgrade -y ### 1.4 Instalace Dockeru ```bash -# Instalar dependências +# Nainstalovat závislosti apt install -y ca-certificates curl gnupg -# Adicionar repositório oficial do Docker +# Přidat oficiální Docker repository install -m 0755 -d /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | gpg --dearmor -o /etc/apt/keyrings/docker.gpg chmod a+r /etc/apt/keyrings/docker.gpg @@ -74,29 +76,29 @@ ufw allow 443/tcp # HTTPS ufw enable ``` -> **Dica** : Maximální zabezpečení, omezení jako porty 80 a 443 přístupů pro IP Cloudflare. Veja a seção [Segurança Avançada](#seguran%C3%A7a-avan%C3%A7ada) . +> **Tip**: Pro maximální zabezpečení omezte porty 80 a 443 pouze na IP Cloudflare. Viz sekce [Pokročilé zabezpečení](#pokrocilé-zabezpečení). --- ## 2. Instalace OmniRoute -### 2.1 Criar diretório de configuração +### 2.1 Vytvořit konfigurační adresář ```bash mkdir -p /opt/omniroute ``` -### 2.2 Criar arquivo de variáveis ​​de ambiente +### 2.2 Vytvořit soubor s proměnnými prostředí ```bash cat > /opt/omniroute/.env << 'EOF' -# === Segurança === -JWT_SECRET=ALTERE-PARA-CHAVE-SECRETA-UNICA-64-CHARS -INITIAL_PASSWORD=SuaSenhaSegura123! -API_KEY_SECRET=ALTERE-PARA-OUTRA-CHAVE-SECRETA -STORAGE_ENCRYPTION_KEY=ALTERE-PARA-TERCEIRA-CHAVE-SECRETA +# === Bezpečnost === +JWT_SECRET=CHANGE-TO-A-UNIQUE-64-CHAR-SECRET-KEY +INITIAL_PASSWORD=YourSecurePassword123! +API_KEY_SECRET=REPLACE-WITH-ANOTHER-SECRET-KEY +STORAGE_ENCRYPTION_KEY=REPLACE-WITH-THIRD-SECRET-KEY STORAGE_ENCRYPTION_KEY_VERSION=v1 -MACHINE_ID_SALT=ALTERE-PARA-SALT-UNICO +MACHINE_ID_SALT=CHANGE-TO-A-UNIQUE-SALT # === App === PORT=20128 @@ -108,9 +110,9 @@ ENABLE_REQUEST_LOGS=true AUTH_COOKIE_SECURE=false REQUIRE_API_KEY=false -# === Domain (altere para seu domínio) === -BASE_URL=https://llms.seudominio.com -NEXT_PUBLIC_BASE_URL=https://llms.seudominio.com +# === Doména (změňte na vaši doménu) === +BASE_URL=https://llms.vasedomena.com +NEXT_PUBLIC_BASE_URL=https://llms.vasedomena.com # === Cloud Sync (opcional) === # CLOUD_URL=https://cloud.omniroute.online @@ -118,7 +120,7 @@ NEXT_PUBLIC_BASE_URL=https://llms.seudominio.com EOF ``` -> ⚠️ **DŮLEŽITÉ** : Gere chaves secretas únicas! Použijte `openssl rand -hex 32` para cada chave. +> ⚠️ **DŮLEŽITÉ**: Vygenerujte jedinečné tajné klíče! Použijte `openssl rand -hex 32` pro každý klíč. ### 2.3 Spuštění kontejneru @@ -147,19 +149,19 @@ Vývojový příklad: `[DB] SQLite database ready` a `listening on port 20128` . ## 3. Konfigurace nginx (reverzní proxy) -### 3.1 Gerar Certificado SSL (Cloudflare Origin) +### 3.1 Vygenerovat SSL certifikát (Cloudflare Origin) Cloudflare nic neřeší: 1. Používá **SSL/TLS → Origin Server** -2. **Certifikát Clique Create** -3. Deixe os padrões (15 ano, *.seudominio.com) +2. Klikněte na **Vytvořit certifikát** +3. Ponechte výchozí nastavení (15 let, \*.vasedomena.com) 4. Zkopírujte nebo zkopírujte **certifikát původu** a **soukromý klíč** ```bash mkdir -p /etc/nginx/ssl -# Colar o certificado +# Vložit certifikát nano /etc/nginx/ssl/origin.crt # Colar a chave privada @@ -188,7 +190,7 @@ server { server { listen 443 ssl; listen [::]:443 ssl; - server_name llms.seudominio.com; # Altere para seu domínio + server_name llms.vasedomena.com; # Změňte na vaši doménu ssl_certificate /etc/nginx/ssl/origin.crt; ssl_certificate_key /etc/nginx/ssl/origin.key; @@ -220,7 +222,7 @@ server { server { listen 80; listen [::]:80; - server_name llms.seudominio.com; + server_name llms.vasedomena.com; return 301 https://$server_name$request_uri; } NGINX @@ -245,11 +247,11 @@ nginx -t && systemctl reload nginx ### 4.1 Další DNS registr -No painel da Cloudflare → DNS: +V dashboardu Cloudflare → DNS: -Typ | Jméno | Obsah | Proxy ---- | --- | --- | --- -A | `llms` | `203.0.113.10` (IP adresa virtuálního počítače) | ✅ Proxy +| Typ | Jméno | Obsah | Proxy | +| --- | ------ | ----------------------------------------------- | -------- | +| A | `llms` | `203.0.113.10` (IP adresa virtuálního počítače) | ✅ Proxy | ### 4.2 Konfigurace SSL @@ -257,7 +259,7 @@ Em **SSL/TLS → Přehled** : - Režim: **Plný (Přísný)** -Em **SSL/TLS → Edge certifikáty** : +V **SSL/TLS → Edge Certificates**: - Vždy používat HTTPS: ✅ Zapnuto - Minimální verze TLS: TLS 1.2 @@ -266,7 +268,7 @@ Em **SSL/TLS → Edge certifikáty** : ### 4.3 Testar ```bash -curl -sI https://llms.seudominio.com/health +curl -sI https://llms.vasedomena.com/health # Deve retornar HTTP/2 200 ``` @@ -289,14 +291,14 @@ docker run -d --name omniroute --restart unless-stopped \ ### Verzovní protokoly ```bash -docker logs -f omniroute # Stream em tempo real +docker logs -f omniroute # Živý stream docker logs omniroute --tail 50 # Últimas 50 linhas ``` ### Ruční zálohování banky ```bash -# Copiar dados do volume para o host +# Kopírovat data z volume do hostitele docker cp omniroute:/app/data ./backup-$(date +%F) # Ou comprimir todo o volume @@ -321,7 +323,7 @@ docker start omniroute ```bash cat > /etc/nginx/cloudflare-ips.conf << 'CF' -# Cloudflare IPv4 ranges — atualizar periodicamente +# Cloudflare IPv4 ranges — aktualizovat pravidelně # https://www.cloudflare.com/ips-v4/ set_real_ip_from 173.245.48.0/20; set_real_ip_from 103.21.244.0/22; @@ -342,7 +344,7 @@ real_ip_header CF-Connecting-IP; CF ``` -Přidat `nginx.conf` dentro do bloco `http {}` : +Přidat do `nginx.conf` do bloku `http {}`: ```nginx include /etc/nginx/cloudflare-ips.conf; @@ -362,7 +364,7 @@ fail2ban-client status sshd ### Bloquear accesso direto na port do Docker ```bash -# Impedir acesso externo direto à porta 20128 +# Zamezit přímému externímu přístupu k portu 20128 iptables -I DOCKER-USER -p tcp --dport 20128 -j DROP iptables -I DOCKER-USER -i lo -p tcp --dport 20128 -j ACCEPT @@ -389,11 +391,11 @@ Dokumenty jsou kompletní pro [omnirouteCloud/README.md](../omnirouteCloud/READM --- -## Resumo de Portas +## Přehled portů -Porta | Služba | Přístup ---- | --- | --- -22 | SSH | Veřejné (s fail2ban) -80 | nginx HTTP | Přesměrování → HTTPS -443 | nginx HTTPS | Prostřednictvím proxy serveru Cloudflare -20128 | OmniRoute | Někdy na localhostu (přes nginx) +| Port | Služba | Přístup | +| ----- | ----------- | ---------------------------------------- | +| 22 | SSH | Veřejné (s fail2ban) | +| 80 | nginx HTTP | Přesměrování → HTTPS | +| 443 | nginx HTTPS | Prostřednictvím proxy serveru Cloudflare | +| 20128 | OmniRoute | Někdy na localhostu (přes nginx) | diff --git a/docs/i18n/cs/i18n/README.html b/docs/i18n/cs/i18n/README.html deleted file mode 100644 index 6e2b9407d8..0000000000 --- a/docs/i18n/cs/i18n/README.html +++ /dev/null @@ -1,164 +0,0 @@ - - - - - Vícejazyčná dokumentace - - - - - - - - - - - - -

Vícejazyčná dokumentace

-

Tento adresář obsahuje strojově asistované překlady založené na anglické dokumentaci.

- -

Nedávná poznámka: Zásady limitů pro účty Codex

-

Dokumentace nyní zahrnuje chování zásad kvót na úrovni účtu Codex:

- -

Vygenerováno 26. února 2026.

- - - - - \ No newline at end of file