Så åtgärdar du Moonraker-autentiserings- och API-nyckelfel i Printer Tools
Felsökning av Moonrakers autentisering
Det korta svaret
De flesta Moonraker-installationer på ett pålitligt lokalt nätverk kräver inga uppgifter alls. Om din gör det, på grund av inställningarna trusted_clients eller force_logins i moonraker.conf, kan Printer Tools skicka en API key, en Bearer-token eller Basic Auth-uppgifter med anslutningen, men de måste matcha exakt det Moonraker förväntar sig, annars avvisas varje begäran.
Vad du behöver
- Tillgång till din moonraker.conf, eller till Mainsails eller Fluidds inställningar, för att kontrollera den aktuella autentiseringskonfigurationen
- Den aktuella API key, Bearer-token eller Basic Auth-användarnamnet och lösenordet, beroende på vad din Moonraker-installation använder
- En Klipper-skrivare redan tillagd i Printer Tools
- Bekräftelse på om din enhets IP faller inom något trusted_clients-intervall konfigurerat i moonraker.conf
Åtgärda ett autentiseringsfel
- 1
Kontrollera om autentisering faktiskt krävs
Titta på trusted_clients och force_logins i moonraker.conf. Om din enhets nätverk redan faller inom ett pålitligt intervall bör inga uppgifter behövas, och ett autentiseringsfel pekar i stället på en nätverks- eller IP-intervallmissmatchning.
- 2
Hämta den aktuella autentiseringsuppgiften
Skapa eller kopiera API-nyckeln från Moonrakers egna verktyg, vanligtvis tillgänglig via Mainsails eller Fluidds inställningssida, eller bekräfta Bearer-token eller Basic Auth-användarnamnet och lösenordet som konfigurerats på servern.
- 3
Ange den exakt i Printer Tools
Öppna skrivarens inställningar i Printer Tools och ange uppgiften utan inledande eller avslutande blanksteg. Ett enda extra tecken räcker för att orsaka en avvisning som ser identisk ut med en saknad nyckel.
- 4
Återanslut och kontrollera resultatet
Återanslut skrivaren och bekräfta att panelen laddas. Om det fortfarande misslyckas, testa samma uppgift direkt mot Moonrakers API med en enkel begäran för att bekräfta att nyckeln i sig är giltig.
- 5
Skapa en ny nyckel om den försvann eller roterades
Om nyckeln skapades om på servern efter att du kopierade den, skapa en ny och uppdatera den överallt den används, inklusive Printer Tools och andra Moonraker-klienter.
Anslutningsstatus i Printer Tools
Autentiseringsfält visas tillsammans med värdadressen när du lägger till eller redigerar en Klipper-skrivare i Printer Tools.
Vad Printer Tools stöder
- En valfri API key skickad som en standardheader med varje Moonraker-begäran
- Valfri Bearer-token-autentisering för installationer konfigurerade på det sättet
- Valfritt Basic Auth-användarnamn och lösenord för installationer konfigurerade på det sättet
- Inga uppgifter krävs alls när ditt nätverk redan ligger inom Moonrakers trusted_clients-intervall
Vad som inte stöds
- Printer Tools implementerar inte Moonrakers oneshot-token eller webbläsarens sessionsinloggningsflöde
- Det kan inte upptäcka eller generera en Moonraker API-nyckel på egen hand, nyckeln måste redan finnas på servern
- En uppgift som är giltig men inte matchar Moonrakers aktuellt konfigurerade metod avvisas ändå
Vanliga autentiseringsfel
Unauthorized trots att en nyckel angavs
Bekräfta att nyckeln inte skapades om på servern efter att du kopierade den, och kontrollera om det finns extra blanksteg eller dolda tecken när den angavs i Printer Tools.
Det fungerade tidigare och slutade plötsligt
En omstart av Moonraker kan rotera nyckeln om den inte sparas korrekt, eller så kan din enhets IP ha ändrats och inte längre falla inom ett trusted_clients-intervall. Kontrollera båda igen.
Basic Auth avvisas
Bekräfta att moonraker.conf faktiskt definierar Basic Auth för din installation i stället för en API-nyckel. Att skicka fel typ av autentiseringsuppgift ger samma avvisade resultat som att inte skicka något alls.
Autentisering fungerar i Mainsail eller Fluidd men inte i Printer Tools
Webbläsarklienter förlitar sig ofta på en session som skapas efter ett inloggningssteg. Printer Tools behöver i stället den underliggande statiska API key, Bearer-token eller Basic Auth-uppgiften i stället för den sessionen.
Autentisering för fjärråtkomst
Samma uppgifter gäller oavsett om du ansluter direkt på ditt lokala nätverk eller via en VPN tillbaka till det. OctoEverywhere och Obico hanterar sitt eget auktoriseringslager separat från Moonrakers API-nyckel.
Vanliga frågor
Krävs en API-nyckel alltid?
Nej. Många lokala Moonraker-installationer kräver ingen alls. Den blir bara nödvändig om din moonraker.conf tvingar fram autentisering för klienter utanför trusted_clients.
Var hittar jag min Moonraker API-nyckel?
Den finns vanligtvis tillgänglig via Mainsails eller Fluidds inställningssida, eller direkt från Moonrakers egen databas om du hanterar servern utan ett webbgränssnitt.
Stöder Printer Tools Moonrakers inloggnings- och sessionstoken?
Nej. Printer Tools använder statiska uppgifter, antingen en API-nyckel, en Bearer-token eller Basic Auth, i stället för det interaktiva sessionsflödet webbläsarklienter använder.
Kan jag ta bort autentisering helt?
Det beror på dina egna val i moonraker.conf och för nätverkssäkerhet. Printer Tools följer helt enkelt vilken autentisering din Moonraker-instans för närvarande kräver.
Påverkar det pågående utskriften om jag ändrar API-nyckeln?
Nej. En pågående utskrift fortsätter på skrivaren själv. Endast appens förmåga att hämta live-uppdateringar påverkas tills rätt uppgift anges igen.
Relaterade guider
Se fullständig kompatibilitet med Klipper och Moonraker
Granska de Moonraker-funktioner som stöds, valfria krav för kamera och Spoolman, alternativ för fjärråtkomst och aktuella begränsningar.
Alla dina 3D-skrivare i en enda panel
Övervaka Bambu Lab-, Klipper-, OctoPrint-, Creality-, Snapmaker-, Anycubic-, Flashforge-, Elegoo- och Prusa-skrivare från en app
Tillgänglig på Android, iPhone, iPad och Mac, med följeappar för Apple Watch och Wear OS samt valfri fjärråtkomst via VPN, OctoEverywhere eller Obico
