Wiki.js

Författare:Esadax
Uppdaterad:14 nov. 2026

Vad är Wiki.js?

Wiki.js är en modern, öppen källkod wiki och kunskapshantering plattform byggd med Node.js. Det tillhandahåller en centraliserad miljö för att skapa, organisera, redigera och dela dokumentation, tekniska guider, interna kunskapsbaser och innehåll för samarbete.

Wiki.js är utformat för individer, utvecklingsteam och organisationer och kombinerar en kraftfull Markdown-redigerare med en flexibel visuell redigerare, fulltextsökning, användarhantering, åtkomstkontroller och integrationer med externa identitetsleverantörer.

Innehåll kan synkroniseras med Git-förråd, vilket gör det möjligt för team att hantera dokumentation genom välbekanta arbetsflöden för versionskontroll samtidigt som deras kunskapsbas är tillgänglig via ett webbgränssnitt.

Wiki.js 3 introducerar en omarbetad arkitektur med samarbete i realtid, flera wiki-webbplatser, dynamiska innehållsblock, utökade redigeringsfunktioner och ett modernt REST API. Den använder PostgreSQL som databas och Node.js som körtid för applikationen.

Plattformen är självhostad, mycket utbyggbar och distribuerad under GNU Affero General Public License version 3 (AGPL-3.0).

Historik för Wiki.js

Wiki.js skapades ursprungligen av Nicolas Giard, även känd som NGPixel, och har utvecklats som en dokumentationsplattform med öppen källkod sedan 2017.

De ursprungliga versionerna etablerade Wiki.js som ett modernt alternativ till traditionella wikimotorer, som kombinerar Markdown-baserat innehållsskapande, Git-synkronisering, autentiseringsintegrationer och ett anpassningsbart gränssnitt.

Projektet utvecklades genom sina 2.x-utgåvor och introducerade ytterligare redaktörer, lagringsleverantörer, autentiseringsmoduler, sökintegrationer och administrationsfunktioner.

Den 1 november 2026 släppte projektet officiellt Wiki.js 3.0 som en stabil version. Denna utgåva representerade en fullständig omskrivning av frontend och backend, vilket introducerade betydande arkitektoniska och funktionella förbättringar.

Större tillägg i Wiki.js 3 inkluderar:

  • Gemensam redigering i realtid.
  • Multi-site wiki hosting.
  • En omdesignad Markdown-redigerare baserad på Monaco-redigeraren.
  • En ny visuell redigerare.
  • Utökade innehållsblock.
  • En inbyggd filhanterare.
  • Förbättrade behörigheter och arbetsflöden för godkännande.
  • Ett dokumenterat REST API.
  • Uppdaterad autentiseringsarkitektur.
  • Förbättrad sökning och PostgreSQL-integration.

Från och med den 14 november 2026 är den senaste publicerade versionen Wiki.js 3.3.1.

Viktiga funktioner i Wiki.js

Wiki.js tillhandahåller en omfattande uppsättning funktioner för att skapa och underhålla samarbetsdokumentation.

  • Markdown Editor: Skriv dokumentation med hjälp av Markdown med syntaxmarkering, autokomplettering, och levande sida vid sida förhandsvisningar.
  • Visual Editor: Skapa och formatera innehåll genom en rik text redigeringsgränssnitt utan att manuellt skriva Markdown.
  • AsciiDoc Support: Använd AsciiDoc som ett alternativt dokumentationsformat.
  • Git Integration: Synkronisera wiki innehåll med Git förråd med hjälp av tvåvägssynkronisering.
  • Autentiseringsleverantörer: Stöd för lokala konton, OpenID Connect, LDAP och SAML-autentisering.
  • Granulära behörigheter: Styr åtkomsten till enskilda sidor, sökvägar, grupper, språk och wiki-webbplatser.
  • Realtidssamarbete: Tillåt flera användare att redigera dokument samtidigt.
  • Fulltextsökning: Hitta information i hela dokumentationen med hjälp av inbyggda sökfunktioner.
  • Värdtjänst för flera webbplatser: Var värd för flera oberoende wiki-webbplatser från en enda Wiki.js-instans.
  • Innehållsblock: Bädda in dynamiska komponenter som diagram, kartor, gallerier, infoboxar och andra interaktiva element.
  • Sidhistorik: Spåra versioner, jämför ändringar och återställ tidigare versioner.
  • Filhanteraren: Organisera dokumentationssidor och uppladdade tillgångar i ett enhetligt gränssnitt.
  • Lokalisering: Skapa och hantera dokumentation på flera språk.
  • Arbetsflöden för godkännande: Låt användare föreslå ändringar medan utsedda granskare kontrollerar publiceringen.
  • Kommentarer och anteckningar: Diskutera hela sidor eller specifika avsnitt i dokumentationen.
  • Granskningsloggning: Håll koll på användaraktivitet och administrativa förändringar.
  • REST API: Integrera Wiki.js med externa program och automatiserade arbetsflöden.
  • Webhooks: Skicka meddelanden till externa system när wiki händelser inträffar.
  • Anpassade teman: Konfigurera utseendet, layouten och den visuella identiteten för wikin.
  • Valfri MCP-integration: Tillåt kompatibla AI-agenter att komma åt wiki-information och utföra åtgärder som stöds under den anslutna användarens behörigheter.

Användningsfall

Wiki.js kan användas för ett brett spektrum av dokumentation och kunskapshantering scenarier.

Vanliga användningsfall inkluderar:

  • Teknisk dokumentation: Underhåll installationsanvisningar, API-referenser, arkitekturdokumentation och utvecklingsguider.
  • Interna kunskapsbaser: Centralisera företagets rutiner, driftsinstruktioner och institutionell kunskap.
  • Team Collaboration: Tillåt anställda och bidragsgivare att skapa och underhålla delad dokumentation.
  • IT-dokumentation: Organisera infrastrukturinformation, nätverksdiagram, serverinventeringar och felsökningsprocedurer.
  • Programvarudokumentation: Underhåll projektdokumentationen tillsammans med källkoden med Git-synkronisering.
  • Kundsupport: Skapa sökbara hjälpcenter, produktguider och vanliga frågor.
  • Projektdokumentation: Hantera projektspecifikationer, utvecklingsanteckningar och utgivningsinformation.
  • Företagswikier: Bygg en intern resurs för policyer, introduktionsdokumentation och organisationsprocesser.
  • Utbildningsresurser: Publicera kursmaterial, handledning och gemensamma inlärningsresurser.
  • Forskningsdokumentation: Organisera tekniska fynd, forskningsanteckningar och referensmaterial.
  • Operational Runbooks: Upprätthålla rutiner för systemadministration, underhåll och incidentrespons.
  • Dokumentation för flera avdelningar: Separata dokumentationsutrymmen för olika team eller affärsenheter.

Fördelar med Wiki.js

  • Centraliserad dokumenthantering.
  • Arkitektur med öppen källkod och egen värd.
  • Flera innehållsredigerare.
  • Markdown-baserad dokumentation.
  • Git-stödd synkronisering.
  • Gemensam redigering i realtid.
  • Kraftfull fulltextsökning.
  • Granulär behörighetshantering.
  • Flera autentiseringsleverantörer.
  • Stöd för flera oberoende wiki webbplatser.
  • Inbyggd revisionshistorik.
  • Flexibel innehållsorganisation.
  • Anpassningsbart utseende.
  • Integration med externa applikationer.
  • REST API och webhook stöd.
  • Omfattande administrationsmöjligheter.
  • Inget beroende av en egenutvecklad värdtjänst för dokumentation.

Hur man installerar Wiki.js

För att installera Wiki.js genom Esadax, följ dessa steg:

  1. Köp Wiki.js genom Esadax.
  2. Efter köpet anger du de nödvändiga programkonfigurationsuppgifterna.
  3. Konfigurera programadressen och administratörskontot.
  4. Konfigurera PostgreSQL-databasanslutningen.
  5. Välj de inställningar för programåtkomst och säkerhet som krävs.
  6. Klicka på Distribuera för att starta programmet.
  7. Få åtkomst till Wiki.js via dess tilldelade URL.
  8. Logga in med administratörskontot.
  9. Slutför den inledande programkonfigurationen.
  10. Konfigurera autentiseringsproviders, användargrupper och behörigheter efter behov.
  11. Skapa din första dokumentationsplats och börja lägga till sidor.

När det väl är installerat ger Wiki.js en centraliserad miljö för att organisera och publicera dokumentation.

Dokumentationsredaktörer

Wiki.js 3 innehåller flera redigeringsupplevelser utformade för olika typer av användare och dokumentationsarbetsflöden.

Markdown- redigerare

Markdown-redigeraren ger en strukturerad skrivmiljö med en live-förhandsgranskning.

Den använder Monaco-redigeraren, samma redigeringsmotor som används av Visual Studio Code, och erbjuder funktioner som:

  • Syntaxmarkering.
  • Komplettera automatiskt.
  • Inline redigeringshjälp.
  • Live dokument förhandsgranskning.
  • Kortkommandon på tangentbordet.
  • Markdown-formatering.
  • Kodblock och syntaxmarkering.
  • Tabeller och strukturerat innehåll.
  • Matematiska uttryck.
  • Diagramdefinitioner.

Markdown förblir ett vanligt textformat, vilket gör dokumentation lätt att granska, överföra och hantera genom Git.

Den visuella redigeraren

Den visuella redigeraren ger en rik textupplevelse för användare som föredrar att formatera innehåll utan att skriva Markdown direkt.

Den stöder vanliga dokumentationselement, inklusive:

  • Rubriker.
  • Stycken.
  • Listor.
  • Bord.
  • Bilder.
  • Vänster.
  • Kodblock.
  • Formatering av element.
  • Inbäddat innehåll från tredje part.

Innehåll som skapas med VisualEditor lagras med hjälp av Markdown-baserat innehåll bakom kulisserna.

AsciiDoc- redigerare

Wiki.js stöder också AsciiDoc för användare som föredrar dess strukturerade dokumentationssyntax.

AsciiDoc är lämpligt för tekniska manualer, strukturerade guider och större dokumentationsprojekt.

Redigering i samarbete

Wiki.js 3 stöder samtidig redigering av flera användare.

Bidragsgivare kan arbeta i samma dokument samtidigt som de ser andra deltagares markörer och ändringar i realtid.

Den gemensamma redigeringsfunktionen är särskilt användbar för team som förbereder tekniska specifikationer, incidentrapporter, operativ dokumentation och delade anteckningar.

Git-integration och versionskontroll

En av Wiki.js viktiga funktioner är dess integration med Git.

Git-synkronisering gör det möjligt att utbyta dokumentationsinnehåll med ett externt lagringsutrymme, vilket gör det möjligt att underhålla dokumentation tillsammans med programvaruprojekt och utvecklingsarbetsflöden.

Wiki.js 3 tillhandahåller tvåvägssynkronisering, vilket gör att innehållsändringar kan flyttas mellan wikin och det anslutna lagringsutrymmet.

Detta gör det möjligt för teamen att:

  • Underhålla dokumentation i ett Git-förråd.
  • Synkronisera wiki-ändringar med versionsstyrda filer.
  • Granska dokumentationsändringar genom välbekanta utvecklingsarbetsflöden.
  • Håll Markdown-innehåll tillgängligt utanför wiki-gränssnittet.
  • Integrera dokumentation i befintliga källkontrollprocesser.
  • Upprätthålla en extern kopia av dokumentationen.

Git-integration är särskilt användbar för utvecklingsteam som redan använder GitHub, GitLab eller andra kompatibla Git-värdplattformar.

Arbetsflöde för Git-synkronisering

Ett typiskt arbetsflöde består av följande steg:

  1. Konfigurera en Git-lagringsdestination som stöds.
  2. Anslut Wiki.js till en dedikerad lagringsplats.
  3. Konfigurera synkroniseringsbeteendet.
  4. Skapa eller uppdatera dokumentation i Wiki.js.
  5. Tillåt synkroniseringsprocessen att publicera ändringar.
  6. Hämta lagringsplatsändringar via det konfigurerade arbetsflödet för synkronisering.

Wiki.js kan också synkronisera innehåll med lokala och molnlagringsdestinationer som stöds.

Viktigt: Git-synkronisering ska behandlas som en mekanism för innehållssynkronisering, inte som en ersättning för en fullständig säkerhetskopiering av program och databas.

Autentisering och identitetshantering

Wiki.js stöder flera autentiseringsmetoder, vilket gör att organisationer kan integrera plattformen med befintliga identitetshanteringssystem.

Autentiseringsmetoder som stöds inkluderar:

Leverantör Beskrivning
Lokal autentisering Hantera användarkonton direkt i Wiki.js.
Logga in med OpenID Integrera med kompatibla identitetsleverantörer.
Google Stöd för inloggning via Googles identitetstjänster.
GitHub Tillåt autentisering via GitHub-konton.
LDAP Integrera med LDAP-katalogtjänster.
SAML 2.0 Anslut till företagsidentitetsleverantörer som stöder SAML.

Ytterligare autentiseringsintegreringar kan vara tillgängliga via identitetsleverantörskonfigurationer som stöds.

Logga in med OpenID

OpenID Connect tillhandahåller en standardautentiseringsmekanism för att ansluta Wiki.js till kompatibla identitetsleverantörer.

Den kan användas med identitetstjänster som Keycloak och andra OIDC-kompatibla plattformar.

LDAP- autentisering

Med LDAP-integration kan organisationer autentisera användare mot en befintlig katalogtjänst.

Detta är användbart för företag som redan har centraliserade användarkonton och katalogbaserade åtkomstpolicyer.

SAML-autentisering

SAML 2.0 gör det möjligt för Wiki.js att integreras med företagets infrastruktur för enkel inloggning.

Detta ger ett autentiseringsalternativ för organisationer som använder centraliserade identitetsplattformar.

Kartläggning av grupper

Autentiseringsintegrationer kan mappa användare till Wiki.js-grupper.

Detta gör det möjligt att associera extern identitetsinformation med interna wiki-behörigheter.

Behörigheter och åtkomstkontroll

Wiki.js innehåller ett flexibelt behörighetssystem för att kontrollera vem som kan läsa, skapa, redigera, hantera och administrera dokumentation.

Administratörer kan definiera grupper och tilldela behörigheter enligt organisationens krav.

Behörigheter kan utsträckas till:

  • Enskilda wikisidor.
  • Dokumentationsvägar.
  • Grupper av användare.
  • Lokaliserade sidor.
  • Enskilda wiki-webbplatser.
  • Administrativa funktioner.

Typiska behörighetsroller inkluderar:

Roll Typiska behörigheter
Läsare Visa auktoriserad dokumentation.
Medverkande Skapa och redigera tillåtna sidor.
Granskare Granska föreslagna ändringar och godkänn publicering.
Förvaltare Hantera dokumentation inom tilldelade områden.
Administratör Hantera användare, behörigheter, konfiguration och själva wikin.

Behörighetsmodellen stöder både ärvda och explicit definierade åtkomstregler.

Detta gör Wiki.js lämplig för miljöer där en del dokumentation är offentlig medan annan information måste förbli begränsad till specifika lag.

Wikihantering för flera webbplatser

Wiki.js 3 introducerar stöd för att vara värd för flera oberoende wiki-webbplatser genom en enda applikationsinstans.

Varje webbplats kan ha sin egen konfiguration, inklusive:

  • Värdnamn.
  • Tema.
  • Lokalisering.
  • Konfiguration av autentisering.
  • Lagringskonfiguration.
  • Redaktörer.
  • Dokumentationsstruktur.

Användare och grupper kan delas över hela instansen, vilket förenklar identitets- och åtkomsthantering.

Funktionen för flera webbplatser är användbar för organisationer som behöver separata kunskapsbaser för olika avdelningar, produkter, kunder eller affärsenheter.

En organisation kan till exempel ha separata webbplatser för:

  • Intern företagsdokumentation.
  • Teknisk dokumentation.
  • Kundtjänst.
  • Produktdokumentation.
  • Utvecklingsgruppens resurser.

Varje webbplats kan ha sitt eget värdnamn och sin egen presentation samtidigt som den drar nytta av en delad programinfrastruktur.

Innehållsblock och dynamisk dokumentation

Wiki.js stöder innehållsblock som tillåter dynamiska och interaktiva element att bäddas in direkt i dokumentationssidor.

Istället för att begränsa sidor till text och bilder gör innehållsblock det möjligt att skapa rikare dokumentationsupplevelser.

Några exempel är:

  • Infoboxar.
  • Bildgallerier.
  • Kartor.
  • PDF-läsare.
  • Sidindex.
  • Spoilersektioner.
  • Inbäddade videor.
  • Mermaid diagram.
  • PlantUML-diagram.
  • KaTeX matematiska uttryck.
  • Draw.io diagram.
  • Anpassade applikationsspecifika block.

Mer än 25 inbyggda innehållsblock finns tillgängliga i Wiki.js 3.

Utvecklare kan också skapa anpassade innehållsblock för att utöka plattformen med ytterligare funktioner.

Detta är användbart för teknisk dokumentation som innehåller arkitekturdiagram, interaktiva referenser, visuella förklaringar och inbäddade resurser.

Sidhistorik och revisionshantering

Wiki.js upprätthåller en historik över dokumentationsändringar, vilket gör det möjligt för administratörer och bidragsgivare att granska hur sidor har utvecklats.

Revisionssystemet ger funktionalitet för:

  • Visa tidigare versioner.
  • Jämföra dokumentändringar.
  • Identifiera vem som gjort ändringar.
  • Återställa tidigare versioner.
  • Granska utvecklingen av dokumentation.

Wiki.js 3 introducerar också en papperskorg för att återställa raderade sidor.

Dessa funktioner hjälper till att förhindra oavsiktlig informationsförlust och ger insyn i dokumentationsändringar.

För organisationer som upprätthåller viktig operativ eller teknisk dokumentation är revisionshantering en viktig del av kunskapshanteringen.

Kommentarer, anteckningar och arbetsflöden för godkännande

Wiki.js 3 tillhandahåller samarbets- och granskningsfunktioner som hjälper team att upprätthålla dokumentationskvaliteten.

Kommentarer och anteckningar

Användare kan diskutera hela sidor eller lägga till anteckningar i specifika avsnitt och passager.

Det gör det enklare att identifiera inaktuell information, föreslå korrigeringar och diskutera tekniska detaljer utan att ändra det ursprungliga innehållet direkt.

Redigera förslag

Skrivskyddade användare kan tillåtas att föreslå ändringar i dokumentationen.

Auktoriserade granskare kan utvärdera dessa förslag och bestämma om de ska godkännas eller avvisas.

Regler för godkännande

Administratörer kan definiera godkännandeprinciper för utvalda sidor och dokumentationsområden.

Detta stöder kontrollerade publiceringsarbetsflöden där dokumentation måste granskas innan den blir tillgänglig för läsare.

Regler för livscykel

Livscykelregler kan utlösa åtgärder baserat på dokumentationsvillkor.

Administratörer kan till exempel konfigurera principer för att identifiera sidor som inte har uppdaterats under en viss period och meddela ägarna att en granskning krävs.

Dessa funktioner är särskilt användbara för efterlevnadsdokumentation, driftsrutiner och interna kunskapsbaser.

Sök- och dokumentationsorganisation

Wiki.js innehåller inbyggd fulltextsökning som drivs av PostgreSQL.

Användarna kan söka i dokumentationen utan att behöva en separat sökplattform.

Sökfunktionen stöder:

  • Fulltextsökning.
  • Rankade sökresultat.
  • Boolesk sökning.
  • Taggbaserad filtrering.
  • Dokumentation upptäckt.
  • Söka över auktoriserade sidor.

Plattformen tillhandahåller också en strukturerad filhanterare för hantering av dokumentationssidor och tillhörande tillgångar.

Sidor och filer kan organiseras genom mappar, byta namn, flyttas och raderas via administrationsgränssnittet.

Kombinationen av sökning, sidorganisation, taggar och navigering gör stora dokumentationssamlingar enklare att underhålla.

API och automatisering

Wiki.js 3 tillhandahåller ett REST API dokumenterat med OpenAPI-specifikationen.

API tillåter externa applikationer och skript att interagera med wiki-resurser programmatiskt.

Möjliga integrationer inkluderar:

  • Automatiserad dokumentationspublicering.
  • Interna kunskapshanteringssystem.
  • CI/CD-arbetsflöden.
  • Externa rapporteringssystem.
  • Anpassade administrativa verktyg.
  • Dokumentationssynkroniseringstjänster.
  • Automatiserade processer för innehållshantering.

API kan användas för att bygga integrationer utan att användarna behöver utföra varje åtgärd via webbgränssnittet.

Wiki.js stöder också webhooks för att meddela externa system när specifika wiki-händelser inträffar.

Integrering av MCP

Wiki.js 3 inkluderar en valfri Model Context Protocol (MCP) server.

När det är aktiverat och korrekt konfigurerat kan kompatibla AI-agenter interagera med wiki-innehåll genom åtgärder som stöds.

Beroende på behörigheter kan dessa åtgärder inkludera att söka efter sidor, läsa dokumentation och föreslå redigeringar.

Integreringen är inaktiverad tills den uttryckligen aktiveras och följer behörigheterna för den anslutna användaren.

Detta gör det möjligt för organisationer att införa AI-assisterad kunskapssökning utan att automatiskt ge agenter obegränsad åtkomst till dokumentationsplattformen.

Säkerhet / administration / konfiguration

Wiki.js tillhandahåller ett administrationsgränssnitt för att hantera programinställningar, användare, autentisering, behörigheter och dokumentationspolicyer.

Viktiga säkerhetsöverväganden inkluderar:

  • Aktivera HTTPS för extern åtkomst.
  • Använd starka administratörsautentiseringsuppgifter.
  • Begränsa administrativa behörigheter.
  • Konfigurera autentiseringsleverantörer noggrant.
  • Aktivera flerfaktorautentisering där det stöds.
  • Tillämpa gruppbaserade åtkomstprinciper.
  • Granska behörigheter på sidnivå.
  • Håll programberoenden uppdaterade.
  • Övervaka administrativ aktivitet genom granskningsloggar.
  • Begränsa åtkomsten till databastjänster.
  • Skydda Git-lagringsplatsens autentiseringsuppgifter.
  • Säkerhetskopiera PostgreSQL-databasen regelbundet.
  • Granska externa integrationer och API-åtkomst.
  • Konfigurera betrodda proxyhuvuden när du arbetar bakom en omvänd proxy.

Autentisering med flera faktorer

Wiki.js 3.3 inkluderar upprätthållande av tvåfaktorsautentisering på gruppnivå.

Administratörer kan använda den här funktionen för att kräva starkare autentisering för utvalda grupper i stället för att enbart förlita sig på frivillig användarregistrering.

Granskningsloggning

I granskningsloggen registreras relevant programaktivitet.

Administratörer kan använda den för att granska ändringar och undersöka användaråtgärder.

Säkerhet och omvända proxies

När du distribuerar Wiki.js bakom en omvänd proxy måste de nödvändiga vidarebefordrade rubrikerna och WebSocket-stödet konfigureras korrekt.

Programmet tillhandahåller en betrodd proxyinställning för hantering av vidarebefordrad begärandeinformation.

Detta är viktigt för korrekt autentiseringsbeteende, hastighetsbegränsning, granskningsloggning och samarbete i realtid.

Bästa praxis för Wiki.js

  • Använd ett dedikerat värdnamn för wikin.
  • Konfigurera HTTPS innan du tillåter extern åtkomst.
  • Använd PostgreSQL för applikationsdata.
  • Skapa ett dedikerat databaskonto.
  • Använd externa identitetsleverantörer när centraliserad autentisering krävs.
  • Organisera användare i grupper enligt deras ansvarsområden.
  • Tillämpa principen om minsta privilegium.
  • Konfigurera behörigheter på sidnivå för känslig dokumentation.
  • Använd Git-synkronisering när versionskontroll av dokumentation är viktigt.
  • Konfigurera en separat säkerhetskopieringsstrategi för databasen och uppladdade resurser.
  • Testa databas- och filåterställningsprocedurer.
  • Använd arbetsflöden för godkännande för kritisk dokumentation.
  • Definiera livscykelprinciper för sidor som granskas ofta.
  • Håll driftsdokumentationen uppdaterad.
  • Övervaka program- och databasresursförbrukning.
  • Granska granskningsloggar regelbundet.
  • Håll Wiki.js och dess beroenden uppdaterade.
  • Testa större uppgraderingar mot en säkerhetskopia innan du använder dem i produktionen.

Konfiguration och administration

Efter att ha köpt Wiki.js på Esadax, kan du komma åt programmet och konfigurera dess tillgängliga inställningar.

Administrationsgränssnittet ger centraliserad hantering av wikin och dess funktioner.

Viktiga konfigurationsområden inkluderar:

Konfigurationsområde Beskrivning
Allmänna inställningar Konfigurera platsnamnet, värdnamnet och det allmänna programbeteendet.
Användare och grupper Skapa användare och organisera dem i behörighetsgrupper.
Behörigheter Definiera åtkomst till dokumentation, webbplatser och administrativa funktioner.
Autentisering Konfigurera lokal autentisering och externa identitetsleverantörer.
Redaktörer Aktivera och hantera dokumentationsredigerare som stöds.
Lagring Konfigurera Git-synkronisering och lagringsmål som stöds.
Sökmotor för hemsidor Hantera sökbeteende och indexeringsfunktioner.
Navigering Konfigurera wiki-navigeringsstrukturen.
Tema Anpassa programmets utseende och layout.
Lokalisering Hantera språk och översättningar som stöds.
Konfiguration av e-post Konfigurera e-postleverans för programmeddelanden.
Webbhook Koppla wiki-händelser till externa program.
Säkerhet Hantera autentiseringsprinciper och säkerhetsinställningar.
Metrik Konfigurera programövervakning och Prometheus-mätvärden.
Hantering av webbplats Hantera flera wiki-webbplatser som drivs av samma instans.

De tillgängliga konfigurationsalternativen beror på den installerade Wiki.js-versionen och aktiverad funktionalitet.

Databas och beständig lagring

Wiki.js 3 använder PostgreSQL som sin nödvändiga databasmotor.

Till skillnad från tidigare Wiki.js-generationer stöder version 3 inte längre alternativa databasmotorer.

Databasen lagrar den information som krävs av programmet, inklusive wiki-innehåll, användarkonton, behörigheter, programkonfiguration och andra systemdata.

Krav på databas

Wiki.js 3 kräver:

Beståndsdel Krav
Databas PostgreSQL
Versioner som stöds PostgreSQL 17 eller 18
Nödvändiga tillägg ltree och pg_trgm
Körtid för program Node.js 26

En dedikerad PostgreSQL-databas och ett databaskonto bör användas för programmet.

Git och extern lagring

Git-synkronisering ger ytterligare ett sätt att underhålla dokumentation utanför den primära databasen.

Wiki.js kan synkronisera innehåll med Git-förråd som stöds och andra lagringsdestinationer.

Extern lagring är särskilt användbar för att upprätthålla bärbar Markdown-dokumentation och integrera wiki-innehåll i befintliga utvecklingsarbetsflöden.

Rekommendationer för säkerhetskopior

En pålitlig säkerhetskopieringsstrategi bör innehålla:

  • PostgreSQL-databassäkerhetskopior.
  • Uppladdade bilder och dokumentresurser.
  • Viktig applikationskonfiguration.
  • Externa Git-förråd.
  • Eventuell separat underhållen beständig lagring.

Enbart Git-synkronisering bör inte betraktas som en fullständig säkerhetskopia av Wiki.js-installationen.

Prestanda och systemkrav

Wiki.js är utformad för att köras på ett brett utbud av serverkonfigurationer.

Dess resurskrav beror på antalet användare, dokumentationsstorlek, sökaktivitet, bakgrundsjobb och arbetsbelastning för samarbete.

Rekommenderade grundkrav från den officiella dokumentationen inkluderar:

Resurs Rekommendation
Processor Minst 1 kärna; 2 eller fler rekommenderas
RAM- minne Minst 1 GB på Linux
Lagring av applikationer Minst 1 GB
Vad är Node.js? Version 26
Databas PostgreSQL 17 eller 18
Nätverk HTTP- och WebSocket-anslutning

Ytterligare resurser kan behövas för större installationer, särskilt när du är värd för flera wiki-webbplatser eller stöder många samtidiga användare.

Överväganden om prestanda

Wiki.js använder bakgrundsarbetare för uppgifter som underhåll, sökindexering, webhooks och sidvisning.

För större installationer:

  • Tilldela tillräckligt med processorresurser för bakgrundsbearbetning.
  • Övervaka PostgreSQL-prestanda.
  • Använd lämplig beständig lagring.
  • Övervaka databasanslutningar och frågeaktivitet.
  • Se till att bakgrundsjobb kan slutföras.
  • Konfigurera omvänd proxy för WebSocket-anslutningar.
  • Övervaka programmätvärden.
  • Använd en PostgreSQL-distribution med lämplig storlek för hög tillgänglighet.

Licensiering och öppen källkodsmodell

Wiki.js är släppt under GNU Affero General Public License version 3 (AGPL-3.0).

Källkoden är offentligt tillgänglig, och applikationen kan vara självvärd och anpassad.

Organisationer kan modifiera applikationen och integrera den i sin egen infrastruktur samtidigt som de respekterar tillämpliga licenskrav.

Projektet drivs av gemenskapen och tillhandahåller offentlig dokumentation, källkod, ärendehantering och bidragskanaler.

Slutsats

Wiki.js är en omfattande plattform med öppen källkod för att bygga självhostade kunskapsbaser och samarbetsdokumentationsmiljöer.

Dess kombination av Markdown-redigering, visuell redigering, Git-synkronisering, autentiseringsintegrationer, granulära behörigheter, fulltextsökning och administrationsverktyg gör den lämplig för både personlig kunskapshantering och företagsdokumentation.

Wiki.js 3 utökar plattformen avsevärt med samarbete i realtid, värdtjänster för flera webbplatser, dynamiska innehållsblock, arbetsflöden för godkännande och ett OpenAPI-kompatibelt REST API.

Med PostgreSQL som databasgrund och stöd för externa identitetsleverantörer ger Wiki.js en flexibel lösning för team som vill ha full kontroll över sin dokumentationsinfrastruktur.

Oavsett om det används för teknisk dokumentation, intern företagskunskap, kundsupport eller operativa runbooks, erbjuder Wiki.js en strukturerad och utökningsbar miljö för att skapa och underhålla organisatorisk kunskap.

Läs mer Officiella resurser