Was ist Wiki.js?
Wiki.js ist eine moderne, Open-Source-Wiki- und Wissensmanagement-Plattform, die mit Node.js erstellt wurde. Es bietet eine zentrale Umgebung zum Erstellen, Organisieren, Bearbeiten und Freigeben von Dokumentationen, technischen Anleitungen, internen Wissensdatenbanken und kollaborativen Inhalten.
Wiki.js wurde für Einzelpersonen, Entwicklungsteams und Organisationen entwickelt und kombiniert einen leistungsstarken Markdown-Editor mit einem flexiblen visuellen Editor, Volltextsuche, Benutzerverwaltung, Zugriffskontrollen und Integrationen mit externen Identitätsanbietern.
Inhalte können mit Git-Repositories synchronisiert werden, sodass Teams die Dokumentation über vertraute Versionskontroll-Workflows verwalten können, während ihre Wissensdatenbank über eine Weboberfläche zugänglich bleibt.
Wiki.js 3 führt eine überarbeitete Architektur mit Echtzeit-Zusammenarbeit, mehreren Wiki-Sites, dynamischen Inhaltsblöcken, erweiterten Bearbeitungsfunktionen und einer modernen REST-API ein. Es verwendet PostgreSQL als Datenbank und Node.js als Anwendungslaufzeit.
Die Plattform wird selbst gehostet, ist hochgradig erweiterbar und wird unter der GNU Affero General Public License Version 3 (AGPL-3.0) vertrieben.
Geschichte von Wiki.js
Wiki.js wurde ursprünglich von Nicolas Giard, auch bekannt als NGPixel, erstellt und wird seit 2017 als Open-Source-Dokumentationsplattform entwickelt.
Die ursprünglichen Versionen etablierten Wiki.js als moderne Alternative zu traditionellen Wiki-Engines und kombinierten Markdown-basierte Inhaltserstellung, Git-Synchronisierung, Authentifizierungsintegrationen und eine anpassbare Benutzeroberfläche.
Das Projekt entwickelte sich durch seine 2.x-Versionen weiter und führte zusätzliche Editoren, Speicheranbieter, Authentifizierungsmodule, Suchintegrationen und Verwaltungsfunktionen ein.
Am 1. November 2026 veröffentlichte das Projekt offiziell Wiki.js 3.0 als stabile Version. Diese Version stellte eine komplette Umschreibung des Frontends und Backends dar und führte erhebliche architektonische und funktionale Verbesserungen ein.
Zu den wichtigsten Neuerungen in Wiki.js 3 gehören:
- Kollaborative Bearbeitung in Echtzeit
- Multi-Site-Wiki-Hosting.
- Ein neu gestalteter Markdown-Editor basierend auf dem Monaco-Editor.
- Ein neuer visueller Editor.
- Erweiterte Inhaltsblöcke.
- Ein eingebauter Dateimanager.
- Verbesserte Berechtigungen und Genehmigungsworkflows.
- Eine dokumentierte REST API.
- Aktualisierte Authentifizierungsarchitektur.
- Verbesserte Suche und PostgreSQL-Integration.
Ab dem 14. November 2026 ist die neueste veröffentlichte Version Wiki.js 3.3.1.
Hauptmerkmale von Wiki.js
Wiki.js bietet eine umfassende Reihe von Funktionen für die Erstellung und Pflege kollaborativer Dokumentation.
- Markdown-Editor: Schreiben Sie Dokumentationen mit Markdown mit Syntaxhervorhebung, Autovervollständigung und Live-Vorschauen nebeneinander.
- Visueller Editor: Erstellen und formatieren Sie Inhalte über eine Rich-Text-Bearbeitungsoberfläche, ohne Markdown manuell zu schreiben.
- AsciiDoc-Unterstützung: Verwenden Sie AsciiDoc als alternatives Dokumentationsformat.
- Git-Integration: Synchronisieren Sie Wiki-Inhalte mit Git-Repositories mithilfe der Zwei-Wege-Synchronisierung.
- Authentifizierungsanbieter: Unterstützung lokaler Konten, OpenID Connect, LDAP und SAML-Authentifizierung.
- Granulare Berechtigungen: Steuern Sie den Zugriff auf einzelne Seiten, Pfade, Gruppen, Gebietsschemata und Wiki-Sites.
- Zusammenarbeit in Echtzeit: Mehrere Benutzer können Dokumente gleichzeitig bearbeiten.
- Volltextsuche: Finden Sie Informationen in der gesamten Dokumentation mithilfe der integrierten Suchfunktionen.
- Multi-Site-Hosting: Hosten Sie mehrere unabhängige Wiki-Sites von einer einzigen Wiki.js-Instanz aus.
- Inhaltsblöcke: Betten Sie dynamische Komponenten wie Diagramme, Karten, Galerien, Infoboxen und andere interaktive Elemente ein.
- Seitenverlauf: Verfolgen Sie Überarbeitungen, vergleichen Sie Änderungen und stellen Sie frühere Versionen wieder her.
- Dateimanager: Organisieren Sie Dokumentationsseiten und hochgeladene Assets in einer einheitlichen Oberfläche.
- Lokalisierung: Dokumentation in mehreren Sprachen erstellen und verwalten.
- Genehmigungs-Workflows: Ermöglichen Sie es Benutzern, Änderungen vorzuschlagen, während bestimmte Prüfer die Veröffentlichung steuern.
- Kommentare und Anmerkungen: Diskutieren Sie ganze Seiten oder bestimmte Abschnitte der Dokumentation.
- Audit-Protokollierung: Verfolgen Sie Benutzeraktivitäten und administrative Änderungen.
- REST API: Integrieren Sie Wiki.js mit externen Anwendungen und Automatisierungs-Workflows.
- Webhooks: Senden Sie Benachrichtigungen an externe Systeme, wenn Wiki-Ereignisse auftreten.
- Benutzerdefinierte Designs: Konfigurieren Sie das Aussehen, Layout und die visuelle Identität des Wikis.
- Optionale MCP-Integration: Ermöglichen Sie kompatiblen KI-Agenten, auf Wiki-Informationen zuzugreifen und unterstützte Aktionen unter den Berechtigungen des verbundenen Benutzers auszuführen.
Beispiele für Use Cases
Wiki.js kann für eine Vielzahl von Dokumentations- und Wissensmanagementszenarien verwendet werden.
Häufige Anwendungsfälle sind:
- Technische Dokumentation: Pflege von Installationsanweisungen, API-Referenzen, Architekturdokumentation und Entwicklungsleitfäden.
- Interne Wissensdatenbanken: Zentralisieren Sie Unternehmensverfahren, Betriebsanweisungen und institutionelles Wissen.
- Teamzusammenarbeit: Ermöglichen Sie es Mitarbeitern und Mitwirkenden, gemeinsame Dokumentationen zu erstellen und zu pflegen.
- IT-Dokumentation: Organisieren Sie Infrastrukturinformationen, Netzwerkdiagramme, Serverinventare und Verfahren zur Fehlerbehebung.
- Software-Dokumentation: Pflegen Sie die Projektdokumentation neben dem Quellcode mithilfe der Git-Synchronisierung.
- Kundensupport: Erstellen Sie durchsuchbare Hilfe-Center, Produkthandbücher und häufig gestellte Fragen.
- Projektdokumentation: Verwalten Sie Projektspezifikationen, Entwicklungshinweise und Release-Informationen.
- Unternehmens-Wikis: Erstellen Sie eine interne Ressource für Richtlinien, Onboarding-Dokumentation und Organisationsprozesse.
- Bildungsressourcen: Veröffentlichen Sie Kursmaterialien, Tutorials und kollaborative Lernressourcen.
- Forschungsdokumentation: Organisieren Sie technische Erkenntnisse, Forschungsnotizen und Referenzmaterial.
- Operative Runbooks: Pflegen Sie Verfahren für die Systemverwaltung, Wartung und Reaktion auf Vorfälle.
- Abteilungsübergreifende Dokumentation: Separate Dokumentationsbereiche für verschiedene Teams oder Geschäftsbereiche.
Vorteile von Wiki.js
- Zentrales Dokumentenmanagement.
- Open-Source- und selbst gehostete Architektur.
- Mehrere Inhaltseditoren.
- Markdown-basierte Dokumentation.
- Git-gestützte Synchronisierung.
- Kollaborative Bearbeitung in Echtzeit
- Leistungsstarke Volltextsuche.
- Granulare Berechtigungsverwaltung.
- Mehrere Authentifizierungsanbieter.
- Unterstützung für mehrere unabhängige Wiki-Sites.
- Integrierter Revisionsverlauf.
- Flexible Inhaltsorganisation.
- Anpassbares Erscheinungsbild.
- Integration mit externen Anwendungen.
- REST API und Webhook-Unterstützung.
- Umfangreiche Verwaltungsfunktionen.
- Keine Abhängigkeit von einem proprietären gehosteten Dokumentationsdienst.
Wie man Wiki.js installiert
Um Wiki.js über Esadax zu installieren, gehen Sie wie folgt vor:
- Kaufen Sie Wiki.js über Esadax.
- Geben Sie nach dem Kauf die erforderlichen Anwendungskonfigurationsdetails an.
- Konfigurieren Sie die Anwendungs-URL und das Administratorkonto.
- Konfigurieren Sie die PostgreSQL-Datenbankverbindung.
- Wählen Sie die erforderlichen Anwendungszugriffs- und Sicherheitseinstellungen aus.
- Klicken Sie auf Bereitstellen, um die Anwendung zu starten.
- Greifen Sie über die zugewiesene URL auf Wiki.js zu.
- Melden Sie sich mit dem Administratorkonto an.
- Schließen Sie die erste Anwendungskonfiguration ab.
- Konfigurieren Sie Authentifizierungsanbieter, Benutzergruppen und Berechtigungen nach Bedarf.
- Erstellen Sie Ihren ersten Dokumentationsbereich und fügen Sie Seiten hinzu.
Nach der Installation bietet Wiki.js eine zentrale Umgebung zum Organisieren und Veröffentlichen von Dokumentation.
Redakteure der Dokumentation
Wiki.js 3 umfasst mehrere Bearbeitungserfahrungen, die für verschiedene Arten von Benutzern und Dokumentations-Workflows entwickelt wurden.
Markdown Editor herunterladen
Der Markdown-Editor bietet eine strukturierte Schreibumgebung mit Live-Vorschau.
Es verwendet den Monaco Editor, die gleiche Editor-Engine, die von Visual Studio Code verwendet wird, und bietet Funktionen wie:
- Syntax-Highlighting.
- Autovervollständigung.
- Inline-Bearbeitungshilfe.
- Live-Dokumentvorschau.
- Tastaturbefehle.
- Markdown-Formatierung.
- Codeblöcke und Syntaxhervorhebung.
- Tabellen und strukturierte Inhalte.
- Mathematische Ausdrücke.
- Definitionen von Diagrammen.
Markdown bleibt ein Klartextformat, sodass Dokumentationen einfach über Git überprüft, übertragen und verwaltet werden können.
Der visuelle Editor
Der Visual Editor bietet eine Rich-Text-Erfahrung für Benutzer, die es vorziehen, Inhalte zu formatieren, ohne direkt Markdown zu schreiben.
Es unterstützt gängige Dokumentationselemente, einschließlich:
- Überschriften.
- Absätze.
- Listen.
- Tische.
- Bilder.
- Links.
- Code-Blöcke.
- Formatierung von Elementen.
- Eingebettete Inhalte.
Inhalte, die mit dem Visual Editor erstellt werden, werden hinter den Kulissen mit Markdown-basierten Inhalten gespeichert.
AsciiDoc
Wiki.js unterstützt auch AsciiDoc für Benutzer, die seine strukturierte Dokumentationssyntax bevorzugen.
AsciiDoc eignet sich für technische Handbücher, strukturierte Anleitungen und größere Dokumentationsprojekte.
Collaborative Editing
Wiki.js 3 unterstützt die gleichzeitige Bearbeitung durch mehrere Benutzer.
Mitwirkende können am selben Dokument arbeiten, während sie die Cursor und Änderungen anderer Teilnehmer in Echtzeit sehen.
Die kollaborative Bearbeitungsfunktion ist besonders nützlich für Teams, die technische Spezifikationen, Vorfallsberichte, Betriebsdokumentationen und gemeinsame Notizen erstellen.
Git-Integration und Versionskontrolle
Eine der wichtigsten Fähigkeiten von Wiki.js ist die Integration mit Git.
Die Git-Synchronisierung ermöglicht den Austausch von Dokumentationsinhalten mit einem externen Repository, sodass die Dokumentation neben Softwareprojekten und Entwicklungsabläufen gepflegt werden kann.
Wiki.js 3 bietet eine Zwei-Wege-Synchronisierung, die es ermöglicht, Inhaltsänderungen zwischen dem Wiki und dem verbundenen Repository zu verschieben.
Dadurch können Teams:
- Pflegen Sie die Dokumentation in einem Git-Repository.
- Synchronisieren Sie Wiki-Änderungen mit versionierten Dateien.
- Überprüfen Sie Dokumentationsänderungen über vertraute Entwicklungs-Workflows.
- Halten Sie Markdown-Inhalte außerhalb der Wiki-Oberfläche zugänglich.
- Integrieren Sie die Dokumentation in bestehende Quellcode-Kontrollprozesse.
- Pflegen Sie eine externe Kopie der Dokumentation.
Die Git-Integration ist besonders nützlich für Entwicklungsteams, die bereits GitHub, GitLab oder andere kompatible Git-Hosting-Plattformen verwenden.
Workflow für die Git-Synchronisierung
Ein typischer Workflow besteht aus folgenden Schritten:
- Konfigurieren Sie ein unterstütztes Git-Speicherziel.
- Verbinden Sie Wiki.js mit einem dedizierten Repository.
- Konfigurieren Sie das Synchronisationsverhalten.
- Dokumentation in Wiki.js erstellen oder aktualisieren.
- Lassen Sie den Synchronisierungsprozess Änderungen veröffentlichen.
- Rufen Sie Repository-Änderungen über den konfigurierten Synchronisierungs-Workflow ab.
Wiki.js kann auch Inhalte mit unterstützten lokalen und Cloud-Speicherzielen synchronisieren.
Wichtig: Die Git-Synchronisierung sollte als Mechanismus zur Synchronisierung von Inhalten und nicht als Ersatz für eine vollständige Sicherung von Anwendungen und Datenbanken betrachtet werden.
Authentifizierung und Identitätsmanagement
Wiki.js unterstützt mehrere Authentifizierungsmethoden, sodass Organisationen die Plattform in bestehende Identitätsmanagementsysteme integrieren können.
Zu den unterstützten Authentifizierungsmethoden gehören:
| Provider | Beschreibung |
|---|---|
| Lokale Authentifizierung | Verwalten Sie Benutzerkonten direkt in Wiki.js. |
| Was ist OpenID Connect? | Integration mit kompatiblen Identitätsanbietern. |
| Unterstützung der Anmeldung über Google-Identitätsdienste. | |
| GitHub | Authentifizierung über GitHub-Konten zulassen. |
| LDAP | Integration mit LDAP-Verzeichnisdiensten. |
| SAML 2.0 | Stellen Sie Verbindungen zu Identitätsanbietern für Unternehmen her, die SAML unterstützen. |
Zusätzliche Authentifizierungsintegrationen sind möglicherweise über unterstützte Identitätsanbieterkonfigurationen verfügbar.
Was ist OpenID Connect?
OpenID Connect bietet einen Standard-Authentifizierungsmechanismus, um Wiki.js mit kompatiblen Identitätsanbietern zu verbinden.
Es kann mit Identitätsdiensten wie Keycloak und anderen OIDC-kompatiblen Plattformen verwendet werden.
LDAP-Authentifizierung
Die LDAP-Integration ermöglicht es Unternehmen, Benutzer anhand eines vorhandenen Verzeichnisdienstes zu authentifizieren.
Dies ist nützlich für Unternehmen, die bereits zentralisierte Benutzerkonten und verzeichnisbasierte Zugriffsrichtlinien verwalten.
Authentifizierung mit SAML
SAML 2.0 ermöglicht die Integration von Wiki.js in die Single-Sign-On-Infrastruktur von Unternehmen.
Dies bietet eine Authentifizierungsoption für Organisationen, die zentralisierte Identitätsplattformen verwenden.
Zuordnung von Gruppen
Authentifizierungsintegrationen können Benutzern Wiki.js-Gruppen zuordnen.
Dadurch ist es möglich, externe Identitätsinformationen mit internen Wiki-Berechtigungen zu verknüpfen.
Berechtigungen und Zugriffskontrolle
Wiki.js enthält ein flexibles Berechtigungssystem, um zu steuern, wer Dokumentation lesen, erstellen, bearbeiten, verwalten und verwalten kann.
Administratoren können Gruppen definieren und Berechtigungen entsprechend ihren organisatorischen Anforderungen zuweisen.
Berechtigungen können folgenden Bereichen zugewiesen werden:
- Einzelne Wiki-Seiten.
- Dokumentationswege.
- Benutzergruppen.
- Lokalisierte Seiten.
- Einzelne Wiki-Sites.
- Verwaltungsaufgaben.
Zu den typischen Berechtigungsrollen gehören:
| Rolle | Die typischen Berechtigungen |
|---|---|
| Reader | Autorisierte Dokumentation anzeigen. |
| Contributor | Erlaubte Seiten erstellen und bearbeiten. |
| Reviewer | Überprüfen Sie vorgeschlagene Änderungen und genehmigen Sie die Veröffentlichung. |
| Manager | Verwaltung der Dokumentation innerhalb der zugewiesenen Bereiche. |
| Administrator | Verwalten Sie Benutzer, Berechtigungen, Konfiguration und das Wiki selbst. |
Das Berechtigungsmodell unterstützt sowohl vererbte als auch explizit definierte Zugriffsregeln.
Dies macht Wiki.js für Umgebungen geeignet, in denen einige Dokumentation öffentlich ist, während andere Informationen auf bestimmte Teams beschränkt bleiben müssen.
Verwaltung von Multi-Site Wikis
Wiki.js 3 führt Unterstützung für das Hosting mehrerer unabhängiger Wiki-Sites über eine einzige Anwendungsinstanz ein.
Jeder Standort kann seine eigene Konfiguration haben, einschließlich:
- Hostname.
- Thema.
- Lokalisierung.
- Konfiguration der Authentifizierung.
- Speicherkonfiguration.
- Herausgeber.
- Struktur der Dokumentation.
Benutzer und Gruppen können über die gesamte Instanz hinweg gemeinsam genutzt werden, was die Identitäts- und Zugriffsverwaltung vereinfacht.
Die Multi-Site-Funktionalität ist nützlich für Unternehmen, die separate Wissensdatenbanken für verschiedene Abteilungen, Produkte, Kunden oder Geschäftsbereiche benötigen.
Eine Organisation könnte beispielsweise separate Websites für Folgendes verwalten:
- Firmeninterne Dokumentation.
- Die technische Dokumentation.
- Kundenbetreuung.
- Dokumentation der Produkte.
- Ressourcen des Entwicklungsteams.
Jeder Standort kann seinen eigenen Hostnamen und seine eigene Präsentation haben und gleichzeitig von einer gemeinsamen Anwendungsinfrastruktur profitieren.
Inhaltsblöcke und dynamische Dokumentation
Wiki.js unterstützt Inhaltsblöcke, mit denen dynamische und interaktive Elemente direkt in Dokumentationsseiten eingebettet werden können.
Anstatt Seiten auf Text und Bilder zu beschränken, ermöglichen Inhaltsblöcke die Erstellung umfangreicherer Dokumentationserfahrungen.
Dazu gehören beispielsweise:
- Infoboxen.
- Bildergalerien.
- Karten.
- PDF-Betrachter.
- Seitenverzeichnisse.
- Spoiler-Abschnitte.
- Eingebettete Videos.
- Meerjungfrau Diagramme.
- PlantUML Diagramme erstellen.
- KaTeX mathematische Ausdrücke.
- Draw.io Diagramme erstellen.
- Benutzerdefinierte anwendungsspezifische Blöcke.
Mehr als 25 integrierte Inhaltsblöcke sind in Wiki.js 3 verfügbar.
Entwickler können auch benutzerdefinierte Inhaltsblöcke erstellen, um die Plattform um zusätzliche Funktionen zu erweitern.
Dies ist nützlich für technische Dokumentationen, die Architekturdiagramme, interaktive Referenzen, visuelle Erklärungen und eingebettete Ressourcen enthalten.
Seitenverlauf und Revisionsverwaltung
Wiki.js verwaltet eine Historie der Dokumentationsänderungen, die es Administratoren und Mitwirkenden ermöglicht, zu überprüfen, wie sich Seiten entwickelt haben.
Das Revisionssystem bietet Funktionen für:
- Anzeigen früherer Revisionen.
- Dokumentänderungen vergleichen.
- Identifizierung, wer Änderungen vorgenommen hat.
- Wiederherstellen früherer Versionen.
- Überprüfung der Entwicklung der Dokumentation.
Wiki.js 3 führt auch einen Papierkorb zur Wiederherstellung gelöschter Seiten ein.
Diese Funktionen verhindern versehentliche Informationsverluste und bieten Transparenz bei Dokumentationsänderungen.
Für Organisationen, die wichtige betriebliche oder technische Dokumentationen pflegen, ist das Revisionsmanagement ein wesentlicher Bestandteil der Wissenssteuerung.
Kommentare, Anmerkungen und Genehmigungsworkflows
Wiki.js 3 bietet Funktionen für die Zusammenarbeit und Überprüfung, die Teams dabei helfen, die Dokumentationsqualität zu erhalten.
Kommentare und Anmerkungen
Benutzer können ganze Seiten diskutieren oder Anmerkungen zu bestimmten Abschnitten und Passagen hinzufügen.
So können veraltete Informationen leichter erkannt, Korrekturen vorgeschlagen und technische Details besprochen werden, ohne dass der ursprüngliche Inhalt sofort geändert werden muss.
Vorschläge zum Bearbeiten
Schreibgeschützte Benutzer können Änderungen an der Dokumentation vorschlagen.
Autorisierte Prüfer können diese Vorschläge bewerten und entscheiden, ob sie genehmigt oder abgelehnt werden.
Regeln für die Genehmigung
Administratoren können Genehmigungsrichtlinien für ausgewählte Seiten und Dokumentationsbereiche definieren.
Dies unterstützt kontrollierte Veröffentlichungs-Workflows, bei denen Dokumentationen überprüft werden müssen, bevor sie den Lesern zur Verfügung stehen.
Regeln für den Lebenszyklus
Lebenszyklusregeln können Aktionen basierend auf Dokumentationsbedingungen auslösen.
Administratoren können beispielsweise Richtlinien konfigurieren, um Seiten zu identifizieren, die für einen bestimmten Zeitraum nicht aktualisiert wurden, und deren Besitzer darüber zu informieren, dass eine Überprüfung erforderlich ist.
Diese Funktionen sind besonders nützlich für Compliance-Dokumentationen, Betriebsverfahren und interne Wissensdatenbanken.
Recherche- und Dokumentationsorganisation
Wiki.js enthält eine integrierte Volltextsuche, die von PostgreSQL unterstützt wird.
Benutzer können Dokumentationen durchsuchen, ohne eine separate Suchplattform zu benötigen.
Die Suchfunktion unterstützt:
- Volltextsuche.
- Rangliste der Suchergebnisse.
- Boolesche Suche.
- Tag-basierte Filterung.
- Entdeckung der Dokumentation.
- Suche über autorisierte Seiten hinweg.
Die Plattform bietet auch einen strukturierten Dateimanager zur Verwaltung von Dokumentationsseiten und zugehörigen Assets.
Seiten und Dateien können über die Administrationsoberfläche in Ordnern organisiert, umbenannt, verschoben und gelöscht werden.
Die Kombination aus Suche, Seitenorganisation, Tags und Navigation erleichtert die Pflege großer Dokumentationssammlungen.
API und Automatisierung
Wiki.js 3 bietet eine REST-API, die unter Verwendung der OpenAPI-Spezifikation dokumentiert ist.
Die API ermöglicht es externen Anwendungen und Skripts, programmgesteuert mit Wiki-Ressourcen zu interagieren.
Mögliche Integrationen sind unter anderem:
- Automatisierte Dokumentationsveröffentlichung.
- Interne Wissensmanagementsysteme.
- CI/CD-Workflows.
- Externe Berichtssysteme.
- Benutzerdefinierte Verwaltungstools.
- Dokumentationssynchronisierungsdienste.
- Automatisierte Inhaltsverwaltungsprozesse.
Die API kann zum Erstellen von Integrationen verwendet werden, ohne dass Benutzer jede Operation über die Weboberfläche ausführen müssen.
Wiki.js unterstützt auch Webhooks zur Benachrichtigung externer Systeme, wenn bestimmte Wiki-Ereignisse auftreten.
Integration von MCP
Wiki.js 3 enthält einen optionalen Model Context Protocol (MCP) Server.
Wenn aktiviert und ordnungsgemäß konfiguriert, können kompatible KI-Agenten über unterstützte Vorgänge mit Wiki-Inhalten interagieren.
Abhängig von den Berechtigungen können diese Vorgänge das Durchsuchen von Seiten, das Lesen der Dokumentation und das Vorschlagen von Bearbeitungen umfassen.
Die Integration ist bis zur expliziten Aktivierung deaktiviert und folgt den Berechtigungen des verbundenen Benutzers.
Dies ermöglicht es Unternehmen, KI-gestützte Wissensrecherche einzuführen, ohne Agenten automatisch uneingeschränkten Zugriff auf die Dokumentationsplattform zu gewähren.
Sicherheit / Verwaltung / Konfiguration
Wiki.js bietet eine Administrationsoberfläche für die Verwaltung von Anwendungseinstellungen, Benutzern, Authentifizierung, Berechtigungen und Dokumentationsrichtlinien.
Zu den wichtigen Sicherheitsaspekten gehören:
- Aktivieren Sie HTTPS für den externen Zugriff.
- Verwenden Sie starke Administratoranmeldeinformationen.
- Beschränken Sie administrative Berechtigungen.
- Konfigurieren Sie Authentifizierungsanbieter sorgfältig.
- Aktivieren Sie die Multi-Faktor-Authentifizierung, sofern sie unterstützt wird.
- Wenden Sie gruppenbasierte Zugriffsrichtlinien an.
- Überprüfen Sie die Berechtigungen auf Seitenebene.
- Halten Sie Anwendungsabhängigkeiten auf dem neuesten Stand.
- Überwachen Sie Verwaltungsaktivitäten mithilfe von Audit-Protokollen.
- Beschränken Sie den Zugriff auf Datenbankdienste.
- Schützen Sie Git-Repository-Anmeldeinformationen.
- Sichern Sie die PostgreSQL-Datenbank regelmäßig.
- Überprüfen Sie externe Integrationen und API-Zugriffe.
- Konfigurieren Sie vertrauenswürdige Proxy-Header, wenn Sie hinter einem Reverse-Proxy arbeiten.
Multi-Faktor-Authentifizierung
Wiki.js 3.3 beinhaltet die Durchsetzung der Zwei-Faktor-Authentifizierung auf Gruppenebene.
Administratoren können diese Funktion verwenden, um eine stärkere Authentifizierung für ausgewählte Gruppen zu verlangen, anstatt sich ausschließlich auf die freiwillige Benutzerregistrierung zu verlassen.
Protokollierung von Audits
Das Überwachungsprotokoll zeichnet relevante Anwendungsaktivitäten auf.
Administratoren können es verwenden, um Änderungen zu überprüfen und Benutzeraktionen zu untersuchen.
Sicherheit und Reverse Proxies
Bei der Bereitstellung von Wiki.js hinter einem Reverse-Proxy müssen die erforderlichen weitergeleiteten Header und die WebSocket-Unterstützung korrekt konfiguriert werden.
Die Anwendung bietet eine vertrauenswürdige Proxyeinstellung für die Verarbeitung weitergeleiteter Anforderungsinformationen.
Dies ist wichtig für das korrekte Authentifizierungsverhalten, die Ratenbegrenzung, die Auditprotokollierung und die Zusammenarbeit in Echtzeit.
Best Practices für Wiki.js
- Verwenden Sie einen dedizierten Hostnamen für das Wiki.
- Konfigurieren Sie HTTPS, bevor Sie externen Zugriff zulassen.
- Verwenden Sie PostgreSQL für Anwendungsdaten.
- Erstellen Sie ein dediziertes Datenbankkonto.
- Verwenden Sie externe Identitätsanbieter, wenn eine zentrale Authentifizierung erforderlich ist.
- Organisieren Sie Benutzer entsprechend ihrer Verantwortlichkeiten in Gruppen.
- Wenden Sie das Prinzip des geringsten Privilegs an.
- Konfigurieren Sie Berechtigungen auf Seitenebene für sensible Dokumentationen.
- Verwenden Sie die Git-Synchronisierung, wenn die Versionskontrolle der Dokumentation wichtig ist.
- Konfigurieren Sie eine separate Sicherungsstrategie für die Datenbank und hochgeladene Assets.
- Testen Sie Datenbank- und Dateiwiederherstellungsverfahren.
- Verwenden Sie Genehmigungsworkflows für kritische Dokumentationen.
- Definieren Sie Lebenszyklusrichtlinien für häufig überprüfte Seiten.
- Halten Sie die Betriebsdokumentation auf dem neuesten Stand.
- Überwachen Sie den Ressourcenverbrauch von Anwendungen und Datenbanken.
- Überprüfen Sie Audit-Protokolle regelmäßig.
- Halten Sie Wiki.js und seine Abhängigkeiten auf dem neuesten Stand.
- Testen Sie größere Upgrades mit einem Backup, bevor Sie sie in der Produktion anwenden.
Konfiguration und Administration
Nach dem Kauf von Wiki.js auf Esadax können Sie auf die Anwendung zugreifen und die verfügbaren Einstellungen konfigurieren.
Die Administrationsoberfläche bietet eine zentrale Verwaltung des Wikis und seiner Funktionen.
Wichtige Konfigurationsbereiche sind:
| Bereich für die Konfiguration | Beschreibung |
|---|---|
| Allgemeine Einstellungen | Konfigurieren Sie den Standortnamen, den Hostnamen und das allgemeine Anwendungsverhalten. |
| Benutzer und Gruppen | Erstellen Sie Benutzer und organisieren Sie sie in Berechtigungsgruppen. |
| Berechtigungen | Definieren Sie den Zugriff auf Dokumentation, Sites und Verwaltungsfunktionen. |
| Authentifizierung | Konfigurieren Sie die lokale Authentifizierung und externe Identitätsanbieter. |
| Herausgeber | Aktivieren und verwalten Sie unterstützte Dokumentations-Editoren. |
| Lagerung | Konfigurieren Sie die Git-Synchronisierung und unterstützte Speicherziele. |
| Suchmaschinenoptimierung | Verwalten Sie Suchverhalten und Indexierungsfunktionen. |
| Navigation | Konfigurieren Sie die Wiki-Navigationsstruktur. |
| Theme | Passen Sie das Erscheinungsbild und Layout der Anwendung an. |
| Lokalisierung | Verwalten Sie unterstützte Sprachen und Übersetzungen. |
| Mail-Konfiguration | Konfigurieren Sie die E-Mail-Zustellung für Anwendungsbenachrichtigungen. |
| Webhook | Verbinden Sie Wiki-Ereignisse mit externen Anwendungen. |
| Sicherheit | Verwalten Sie Authentifizierungsrichtlinien und Sicherheitseinstellungen. |
| Metrik | Konfigurieren Sie die Anwendungsüberwachung und Prometheus-Metriken. |
| Standortverwaltung | Verwalten Sie mehrere Wiki-Sites, die von derselben Instanz gehostet werden. |
Die verfügbaren Konfigurationsoptionen hängen von der installierten Wiki.js-Version und der aktivierten Funktionalität ab.
Datenbank und persistenter Speicher
Wiki.js 3 verwendet PostgreSQL als erforderliche Datenbank-Engine.
Im Gegensatz zu früheren Wiki.js-Generationen unterstützt Version 3 keine alternativen Datenbank-Engines mehr.
Die Datenbank speichert die von der Anwendung benötigten Informationen, einschließlich Wiki-Inhalt, Benutzerkonten, Berechtigungen, Anwendungskonfiguration und andere Systemdaten.
Anforderungen an die Datenbank
Wiki.js 3 erfordert:
| Komponente | Anforderung |
|---|---|
| Datenbank | PostgreSQL |
| Unterstützte Versionen von Windows | PostgreSQL 17 oder höher |
| Erforderliche Erweiterungen | ltree und pg_trgm |
| Application Runtime | Node.js 26 |
Für die Anwendung sollte eine dedizierte PostgreSQL-Datenbank und ein Datenbankkonto verwendet werden.
Git und externer Speicher
Die Git-Synchronisierung bietet eine zusätzliche Möglichkeit, Dokumentation außerhalb der primären Datenbank zu pflegen.
Wiki.js kann Inhalte mit unterstützten Git-Repositories und anderen Speicherorten synchronisieren.
Externer Speicher ist besonders nützlich für die Pflege von portabler Markdown-Dokumentation und die Integration von Wiki-Inhalten in bestehende Entwicklungsabläufe.
Empfehlungen für Backups
Eine zuverlässige Backup-Strategie sollte Folgendes beinhalten:
- PostgreSQL-Datenbank-Backups.
- Hochgeladene Bilder und Dokumentenelemente.
- Wichtige Anwendungskonfiguration.
- Externe Git-Repositorys.
- Jeder separat verwaltete persistente Speicher.
Git-Synchronisierung allein sollte nicht als vollständige Sicherung der Wiki.js-Installation betrachtet werden.
Leistungs- und Systemanforderungen
Wiki.js ist so konzipiert, dass es auf einer Vielzahl von Serverkonfigurationen ausgeführt werden kann.
Der Ressourcenbedarf hängt von der Anzahl der Benutzer, der Dokumentationsgröße, der Suchaktivität, den Hintergrundaufträgen und der Arbeitsbelastung bei der Zusammenarbeit ab.
Zu den empfohlenen Basisanforderungen aus der offiziellen Dokumentation gehören:
| Ressource | Empfehlung |
|---|---|
| CPU | Mindestens 1 Kern; 2 oder mehr empfohlen |
| RAM | Mindestens 1 GB unter Linux |
| Speicher für Anwendungen | Mindestens 1 GB |
| Node.js | Version 26 |
| Datenbank | PostgreSQL 17 oder 18 |
| Netzwerk | HTTP- und WebSocket-Konnektivität |
Zusätzliche Ressourcen können für größere Installationen erforderlich sein, insbesondere wenn mehrere Wiki-Sites gehostet werden oder viele gleichzeitige Benutzer unterstützt werden.
Überlegungen zur Leistung
Wiki.js verwendet Hintergrundarbeiter für Aufgaben wie Wartung, Suchindizierung, Webhooks und Seitenrendering.
Für größere Installationen:
- Weisen Sie ausreichend CPU-Ressourcen für die Hintergrundverarbeitung zu.
- Überwachen Sie die PostgreSQL-Leistung.
- Verwenden Sie einen geeigneten dauerhaften Speicher.
- Überwachen Sie Datenbankverbindungen und Abfrageaktivitäten.
- Stellen Sie sicher, dass Hintergrundaufträge erfolgreich abgeschlossen werden können.
- Konfigurieren Sie den Reverse-Proxy für WebSocket-Verbindungen.
- Überwachen Sie Anwendungskennzahlen.
- Verwenden Sie eine PostgreSQL-Bereitstellung mit angemessener Größe für hohe Verfügbarkeit.
Lizenzierung und Open-Source-Modell
Wiki.js ist unter der GNU Affero General Public License Version 3 (AGPL-3.0) veröffentlicht.
Der Quellcode ist öffentlich verfügbar, und die Anwendung kann selbst gehostet und angepasst werden.
Organisationen können die Anwendung unter Einhaltung der geltenden Lizenzbestimmungen modifizieren und in ihre eigene Infrastruktur integrieren.
Das Projekt wird von der Community gesteuert und bietet öffentliche Dokumentation, Quellcode, Issue-Tracking und Beitragskanäle.
Schlussfolgerung
Wiki.js ist eine umfassende Open-Source-Plattform für den Aufbau von selbst gehosteten Wissensdatenbanken und kollaborativen Dokumentationsumgebungen.
Seine Kombination aus Markdown-Bearbeitung, visueller Bearbeitung, Git-Synchronisierung, Authentifizierungsintegrationen, granularen Berechtigungen, Volltextsuche und Verwaltungswerkzeugen macht es sowohl für das persönliche Wissensmanagement als auch für die Unternehmensdokumentation geeignet.
Wiki.js 3 erweitert die Plattform erheblich mit Echtzeit-Zusammenarbeit, Multi-Site-Hosting, dynamischen Inhaltsblöcken, Genehmigungs-Workflows und einer OpenAPI-konformen REST-API.
Mit PostgreSQL als Datenbankgrundlage und Unterstützung für externe Identitätsanbieter bietet Wiki.js eine flexible Lösung für Teams, die die volle Kontrolle über ihre Dokumentationsinfrastruktur wünschen.
Ob für technische Dokumentation, internes Unternehmenswissen, Kundensupport oder operative Runbooks – Wiki.js bietet eine strukturierte und erweiterbare Umgebung zum Erstellen und Pflegen von Unternehmenswissen.

