Gå til innholdet
OpenSploit
app.header.homeapp.header.docs

Feilsøking

Vanlige problemer og hvordan de kan løses.

For å feilsøke problemer med OpenSploit, start med å sjekke loggene og lokale data den lagrer på disken.

Logger

Loggfiler skrives til:

  • macOS/Linux: ~/.local/share/opensploit/log/
  • Windows: Trykk WIN+R og lim inn %USERPROFILE%\.local\share\opensploit\log

Loggfiler navngis med tidsstempler (f.eks. 2025-01-09T123456.log) og de siste 10 loggfilene beholdes.

Du kan angi loggnivået med kommandolinjealternativet --log-level for å få mer detaljert feilsøkingsinformasjon. For eksempel opensploit --log-level DEBUG.

Lagring

OpenSploit lagrer øktdata og andre applikasjonsdata på disken på:

  • macOS/Linux: ~/.local/share/opensploit/
  • Windows: Trykk WIN+R og lim inn %USERPROFILE%\.local\share\opensploit

Denne katalogen inneholder:

  • auth.json - Autentiseringsdata som API-nøkler, OAuth-tokens
  • log/ - Applikasjonslogger
  • project/ - Prosjektspesifikke data som økt- og meldingsdata
    • Hvis prosjektet er innenfor en Git-repo, lagres det i ./<project-slug>/storage/
    • Hvis det ikke er en Git-repo, lagres det i ./global/storage/

Skrivebordsapp

OpenSploit Desktop kjører en lokal OpenSploit-server (opensploit-cli sidevognen) i bakgrunnen. De fleste problemene er forårsaket av en plugin som fungerer dårlig, en ødelagt cache eller en dårlig serverinnstilling.

Raske sjekker

  • Avslutt og start appen på nytt.
  • Hvis appen viser en feilskjerm, klikker du på Start på nytt og kopierer feildetaljene.
  • Bare macOS: OpenSploit-meny -> Last nettvisning på nytt (hjelper hvis UI er tom/frosset).

Deaktiver plugins

Hvis skrivebordsappen krasjer ved oppstart, henger eller oppfører seg merkelig, start med å deaktivere plugins.

Sjekk den globale konfigurasjonen

Åpne den globale konfigurasjonsfilen og se etter en plugin-nøkkel.

  • macOS/Linux: ~/.config/opensploit/opensploit.jsonc (eller ~/.config/opensploit/opensploit.json)
  • macOS/Linux (eldre installasjoner): ~/.local/share/opensploit/opensploit.jsonc
  • Windows: Trykk WIN+R og lim inn %USERPROFILE%\.config\opensploit\opensploit.jsonc

Hvis du har konfigurert plugins, deaktiver dem midlertidig ved å fjerne nøkkelen eller sette den til en tom matrise:

{
  "$schema": "https://opensploit.ai/config.json",
  "plugin": [],
}

Sjekk plugin-kataloger

OpenSploit kan også laste lokale plugins fra disken. Flytt disse midlertidig ut av veien (eller gi nytt navn til mappen) og start skrivebordsappen på nytt:

  • Globale plugins
    • macOS/Linux: ~/.config/opensploit/plugins/
    • Windows: Trykk WIN+R og lim inn %USERPROFILE%\.config\opensploit\plugins
  • Prosjektplugins (bare hvis du bruker konfigurasjon per prosjekt)
    • <your-project>/.opensploit/plugins/

Hvis appen begynner å fungere igjen, aktiverer du plugins én om gangen for å finne ut hvilken som forårsaker problemet.

Tøm hurtigbufferen

Hvis deaktivering av plugins ikke hjelper (eller en plugin-installasjon sitter fast), tøm hurtigbufferen slik at OpenSploit kan gjenoppbygge den.

  1. Avslutt OpenSploit Desktop helt.
  2. Slett hurtigbufferkatalogen:
  • macOS: Finder -> Cmd+Shift+G -> lim inn ~/.cache/opensploit
  • Linux: slett ~/.cache/opensploit (eller kjør rm -rf ~/.cache/opensploit)
  • Windows: Trykk WIN+R og lim inn %USERPROFILE%\.cache\opensploit
  1. Start OpenSploit Desktop på nytt.

Løs problemer med servertilkobling

OpenSploit Desktop kan enten starte sin egen lokale server (standard) eller koble til en server URL du har konfigurert.

Hvis du ser en “Tilkobling mislyktes”-dialogboks (eller appen kommer aldri forbi splash-skjermen), se etter en tilpasset server URL.

Slett skrivebordsappens standardserver-URL

Fra startskjermen klikker du på servernavnet (med statusprikken) for å åpne servervelgeren. I delen Standardserver klikker du på Slett.

Fjern server.port / server.hostname fra konfigurasjonen din

Hvis opensploit.json(c) inneholder en server-del, fjern den midlertidig og start skrivebordsappen på nytt.

Sjekk miljøvariabler

Hvis du har OPENCODE_PORT satt i miljøet ditt, vil skrivebordsappen prøve å bruke den porten for den lokale serveren.

  • Deaktiver OPENCODE_PORT (eller velg en ledig port) og start på nytt.

Linux: Wayland / X11 problemer

På Linux kan noen Wayland-oppsett forårsake tomme vinduer eller kompositorfeil.

  • Hvis du er på Wayland og appen er tom/krasj, prøv å starte med OC_ALLOW_WAYLAND=1.
  • Hvis det gjør ting verre, fjern det og prøv å starte under en X11-økt i stedet.

Windows: WebView2 kjøretid

På Windows krever OpenSploit Desktop Microsoft Edge WebView2 Runtime. Hvis appen åpnes i et tomt vindu eller ikke starter, installer/oppdater WebView2 og prøv igjen.

Windows: Generelle ytelsesproblemer

Hvis du opplever treg ytelse, problemer med filtilgang eller terminalproblemer på Windows, kan du prøve å bruke WSL (Windows Subsystem for Linux). WSL gir et Linux-miljø som fungerer mer sømløst med funksjonene til OpenSploit.

Varsler vises ikke

OpenSploit Desktop viser bare systemvarsler når:

  • varsler er aktivert for OpenSploit i OS-innstillingene dine, og
  • appvinduet er ikke fokusert.

Tilbakestill skrivebordsapplagring (siste utvei)

Hvis appen ikke starter og du ikke kan slette innstillingene fra UI-et, tilbakestill skrivebordsappens lagrede tilstand.

  1. Avslutt OpenSploit Desktop.
  2. Finn og slett disse filene (de finnes i OpenSploit Desktop-appens datakatalog):
  • opensploit.settings.dat (stasjonær standardserver URL)
  • opensploit.global.dat og opensploit.workspace.*.dat (UI tilstand som nylige servere/prosjekter)

Modellen er ikke tilgjengelig

  1. Sjekk at du har autentisert deg med leverandøren
  2. Kontroller at modellnavnet i konfigurasjonen er riktig
  3. Noen modeller kan kreve spesifikk tilgang eller abonnement

Hvis du støter på ProviderModelNotFoundError refererer du mest sannsynlig feil til en modell et sted. Modeller skal refereres slik: <providerId>/<modelId>

AI_APICallError og leverandørpakkeproblemer

Hvis du støter på API-anropsfeil, kan dette skyldes utdaterte provider-pakker. OpenSploit installerer dynamisk provider-pakker (OpenAI, Anthropic, Google, etc.) etter behov og cacher dem lokalt.

For å løse problemer med leverandørpakke:

  1. Tøm leverandørens pakkebuffer:

    Terminal window
    rm -rf ~/.cache/opensploit

    På Windows, trykk WIN+R og slett: %USERPROFILE%\.cache\opensploit

  2. Start OpenSploit på nytt for å installere de nyeste provider-pakkene på nytt

Dette vil tvinge OpenSploit til å laste ned de nyeste versjonene av provider-pakkene, som ofte løser kompatibilitetsproblemer med modellparametere og API-endringer.

Kopier/lim inn fungerer ikke på Linux

Linux-brukere må ha ett av følgende utklippstavle-verktøy installert for at kopier/lim inn-funksjonalitet skal fungere:

For X11-systemer:

Terminal window
apt install -y xclip
# or
apt install -y xsel

For Wayland-systemer:

Terminal window
apt install -y wl-clipboard

For headless-miljøer:

Terminal window
apt install -y xvfb
# and run:
Xvfb :99 -screen 0 1024x768x24 > /dev/null 2>&1 &
export DISPLAY=:99.0

OpenSploit vil oppdage om du bruker Wayland og foretrekker wl-clipboard, ellers vil den prøve å finne utklippstavle-verktøy i rekkefølgen: xclip og xsel.