Przejdź do głównej zawartości

Instalacja bez dostępu do internetu

Pakiety offline zawierają obrazy jako pliki, więc host nie potrzebuje dostępu do rejestrów. Pobierz je z wydań mcp-platform-offline.

Pakiet Zawartość Rozmiar
mcp-platform-2.0.1-offline.zip Gateway, broker, portal, Keycloak, OpenBao, PostgreSQL, Redis, nginx, Eclipse Temurin, pakiet Compose około 1,0 GB
mcp-servers-2.0.0-offline.zip Serwery GitLab, Jira, Confluence, OpenSearch i service desk, serwer adaptera, ich katalogi deploy/ około 1,1 GB

Obrazy są dla linux/amd64. Obsługiwane hosty: Docker Engine na Linuksie x86_64 oraz Docker Desktop na Windows z backendem WSL 2. Na komputerze ARM obrazy działają tylko w emulacji. Sumy kontrolne zipów są w pliku SHA256SUMS przy wydaniu.

Układ każdego zipa:

Ścieżka Zawartość
images/ Obrazy zapisane przez docker save
SHA256SUMS Sumy kontrolne plików z images/
load-images.sh, load-images.ps1 Sprawdzają sumy i ładują obrazy (Linux, Windows)
mcp-platform/ (zip platformy) Pakiet Compose i compose.offline.yaml
servers/mcp-server-<system>/ (zip serwerów) Katalog deploy/ każdego serwera
  1. Rozpakuj zip platformy na hoście.

  2. Załaduj obrazy. Na Linuksie:

    Okno terminala
    ./load-images.sh

    Na Windows, przy działającym Docker Desktop, w PowerShell:

    Okno terminala
    powershell -ExecutionPolicy Bypass -File .\load-images.ps1

    Oba skrypty zatrzymują się przy niezgodnej sumie kontrolnej. Na Linuksie ostatnia linia to ok all images loaded.

  3. W katalogu mcp-platform/ wykonaj Instalację platformy do startu włącznie (certyfikaty w certs/, .env z platform.env) i przed docker compose up -d dopisz do .env dwie linie:

    Okno terminala
    COMPOSE_FILE=compose.yaml:compose.offline.yaml
    PULL_POLICY=never

    Na Windows separatorem w COMPOSE_FILE jest średnik:

    Okno terminala
    COMPOSE_FILE=compose.yaml;compose.offline.yaml

compose.offline.yaml jest wymagany. compose.yaml wskazuje obrazy firm trzecich po skrócie (digest), a Docker Engine z klasycznym magazynem obrazów nie zachowuje skrótu rejestru dla obrazu załadowanego przez docker load, więc próbowałby je pobrać. Plik wskazuje te same obrazy po tagu. PULL_POLICY=never blokuje każdą próbę pobrania.

  1. Rozpakuj zip serwerów i załaduj jego obrazy tak samo (load-images.sh lub load-images.ps1).

  2. Wejdź do katalogu serwera, na przykład servers/mcp-server-gitlab/.

  3. Wypełnij jego plik środowiska zgodnie z Instalacją serwera MCP.

  4. Wpisz PULL_POLICY=never do pliku .env obok compose.yaml:

    Okno terminala
    echo PULL_POLICY=never > .env
  5. Uruchom serwer:

    Okno terminala
    docker compose up -d

Obraz w wersji 2.0.0 jest już załadowany, więc nic nie jest pobierane ani budowane.

Obowiązują kroki z Instalacji lokalnej. Najpierw załaduj obrazy i dopisz do .env dwie linie offline.

  • Rozpakuj zip rozpakowywaczem Windows lub 7-Zip i zachowaj końce linii. Skrypty powłoki działają w kontenerach Linuksa i przestają działać, gdy edytor zamieni je na CRLF.
  • Windows musi ufać certyfikatowi z Twojego CA, dla przeglądarki i dla Claude Code: certutil -addstore -f Root ca.crt jako administrator oraz NODE_EXTRA_CA_CERTS dla Claude Code.
  • host.docker.internal istnieje w Docker Desktop, więc konfiguracja lokalna działa tak, jak opisano.

Jeśli host widzi wewnętrzny rejestr, skopiuj tam obrazy i ustaw MCP_REGISTRY oraz MCP_THIRD_PARTY_REGISTRY w .env (zobacz Konfiguracja). Pakiet offline nie jest wtedy potrzebny.

Obrazy platformy są na licencji Apache 2.0. Obrazy firm trzecich zachowują własne licencje: Keycloak (Apache 2.0), OpenBao (MPL 2.0), PostgreSQL (PostgreSQL License), Redis 8 (RSALv2, SSPLv1 lub AGPLv3, do wyboru), nginx (BSD 2-clause), Eclipse Temurin (GPLv2 z wyjątkiem Classpath). To niezmienione obrazy z oficjalnych źródeł.