Cos'è Wiki.js?
Wiki.js è una piattaforma wiki e di gestione della conoscenza moderna e open source costruita con Node.js. Fornisce un ambiente centralizzato per creare, organizzare, modificare e condividere documentazione, guide tecniche, basi di conoscenza interne e contenuti collaborativi.
Progettato per individui, team di sviluppo e organizzazioni, Wiki.js combina un potente editor Markdown con un editor visivo flessibile, ricerca full-text, gestione degli utenti, controlli di accesso e integrazioni con provider di identità esterni.
I contenuti possono essere sincronizzati con i repository Git, consentendo ai team di gestire la documentazione attraverso flussi di lavoro di controllo delle versioni familiari mantenendo la propria knowledge base accessibile tramite un'interfaccia web.
Wiki.js 3 introduce un'architettura riprogettata con collaborazione in tempo reale, più siti wiki, blocchi di contenuti dinamici, funzionalità di modifica ampliate e una moderna API REST. Utilizza PostgreSQL come database e Node.js come runtime dell'applicazione.
La piattaforma è self-hosted, altamente estensibile e distribuita sotto la GNU Affero General Public License versione 3 (AGPL-3.0).
Storia di Wiki.js
Wiki.js è stato originariamente creato da Nicolas Giard, noto anche come NGPixel, ed è stato sviluppato come piattaforma di documentazione open source dal 2017.
Le versioni originali hanno stabilito Wiki.js come alternativa moderna ai motori wiki tradizionali, combinando la creazione di contenuti basati su Markdown, la sincronizzazione Git, le integrazioni di autenticazione e un'interfaccia personalizzabile.
Il progetto si è evoluto attraverso le sue versioni 2.x, introducendo editor aggiuntivi, fornitori di storage, moduli di autenticazione, integrazioni di ricerca e capacità di amministrazione.
Il 1 novembre 2026, il progetto ha rilasciato ufficialmente Wiki.js 3.0 come versione stabile. Questa versione ha rappresentato una completa riscrittura del frontend e del backend, introducendo significativi miglioramenti architettonici e funzionali.
Le principali aggiunte in Wiki.js 3 includono:
- Modifica collaborativa in tempo reale.
- Hosting wiki multisito.
- Un editor Markdown ridisegnato basato sull'editor Monaco.
- Un nuovo editor visivo.
- Blocchi di contenuto espansi.
- Un file manager integrato.
- Permessi e flussi di lavoro di approvazione migliorati.
- Un'API REST documentata.
- Architettura di autenticazione aggiornata.
- Migliorata la ricerca e l'integrazione PostgreSQL.
Al 14 novembre 2026, l'ultima versione pubblicata è Wiki.js 3.3.1.
Caratteristiche principali di Wiki.js
Wiki.js fornisce un set completo di funzionalità per la creazione e la manutenzione della documentazione collaborativa.
- Markdown Editor: Scrivi la documentazione utilizzando Markdown con evidenziazione della sintassi, completamento automatico e anteprime live side-by-side.
- Visual Editor: Crea e formatta il contenuto attraverso un'interfaccia di modifica rich-text senza scrivere manualmente Markdown.
- Supporto AsciiDoc: Usa AsciiDoc come formato di documentazione alternativo.
- Integrazione Git: Sincronizza i contenuti wiki con i repository Git utilizzando la sincronizzazione bidirezionale.
- Fornitori di autenticazione: Supporta account locali, OpenID Connect, LDAP e autenticazione SAML.
- Permessi granulari: Controlla l'accesso a singole pagine, percorsi, gruppi, impostazioni locali e siti wiki.
- Collaborazione in tempo reale: Consentire a più utenti di modificare i documenti contemporaneamente.
- Ricerca full-text: Trova informazioni in tutta la documentazione utilizzando le funzionalità di ricerca integrate.
- Hosting multisito: Ospita più siti wiki indipendenti da una singola istanza di Wiki.js.
- Content Blocks: Incorpora componenti dinamici come diagrammi, mappe, gallerie, infobox e altri elementi interattivi.
- Cronologia pagina: Tieni traccia delle revisioni, confronta le modifiche e ripristina le versioni precedenti.
- File Manager: Organizza le pagine della documentazione e le risorse caricate in un'interfaccia unificata.
- Localizzazione: Creare e gestire la documentazione in più lingue.
- Flussi di lavoro di approvazione: Consenti agli utenti di suggerire modifiche mentre i revisori designati controllano la pubblicazione.
- Commenti e annotazioni: Discutere intere pagine o sezioni specifiche della documentazione.
- Audit Logging: Tieni traccia delle attività degli utenti e delle modifiche amministrative.
- REST API: Integra Wiki.js con applicazioni esterne e flussi di lavoro di automazione.
- Webhooks: Invia notifiche a sistemi esterni quando si verificano eventi wiki.
- Temi personalizzati: Configura l'aspetto, il layout e l'identità visiva della wiki.
- Integrazione MCP opzionale: Consenti agli agenti AI compatibili di accedere alle informazioni wiki ed eseguire azioni supportate con le autorizzazioni dell'utente connesso.
Casi di utilizzo
Wiki.js può essere utilizzato per una vasta gamma di scenari di gestione della documentazione e della conoscenza.
I casi d'uso comuni includono:
- Documentazione tecnica: Mantenere le istruzioni di installazione, i riferimenti API, la documentazione sull'architettura e le guide allo sviluppo.
- Basi di conoscenza interne: Centralizzare le procedure aziendali, le istruzioni operative e le conoscenze istituzionali.
- Collaborazione in team: Consenti a dipendenti e collaboratori di creare e gestire la documentazione condivisa.
- Documentazione: Organizzare le informazioni sull'infrastruttura, i diagrammi di rete, gli inventari dei server e le procedure di risoluzione dei problemi.
- Documentazione software: Mantieni la documentazione del progetto insieme al codice sorgente utilizzando la sincronizzazione Git.
- Assistenza clienti: Crea centri di assistenza ricercabili, guide ai prodotti e domande frequenti.
- Documentazione del progetto: Gestire le specifiche del progetto, note di sviluppo, e le informazioni di rilascio.
- Wiki aziendali: Crea una risorsa interna per le politiche, la documentazione di onboarding e i processi organizzativi.
- Risorse didattiche: Pubblicare materiali didattici, tutorial e risorse di apprendimento collaborativo.
- Documentazione di ricerca: Organizzare risultati tecnici, note di ricerca e materiale di riferimento.
- Runbook operativi: Mantenere le procedure per l'amministrazione del sistema, la manutenzione e la risposta agli incidenti.
- Documentazione multi-dipartimento: Spazi di documentazione separati per diversi team o unità aziendali.
Vantaggi di Wiki.js
- Gestione centralizzata della documentazione.
- Architettura open source e self-hosted.
- Editor di contenuti multipli.
- Documentazione basata su Markdown.
- Sincronizzazione supportata da Git.
- Modifica collaborativa in tempo reale.
- Potente ricerca full-text.
- Gestione granulare delle autorizzazioni.
- Più provider di autenticazione.
- Supporto per più siti wiki indipendenti.
- Cronologia delle revisioni integrata.
- Organizzazione flessibile dei contenuti.
- Aspetto personalizzabile.
- Integrazione con applicazioni esterne.
- REST API e supporto webhook.
- Ampie capacità di amministrazione.
- Nessuna dipendenza da un servizio di documentazione in hosting proprietario.
Come installare Wiki.js
Per installare Wiki.js tramite Esadax, seguire questi passaggi:
- Acquista Wiki.js tramite Esadax.
- Dopo l'acquisto, fornire i dettagli di configurazione dell'applicazione richiesti.
- Configurare l'URL dell'applicazione e l'account amministratore.
- Configurare la connessione al database PostgreSQL.
- Selezionare le impostazioni di sicurezza e di accesso alle applicazioni necessarie.
- Fare clic su Distribuisci per avviare l'applicazione.
- Accedi a Wiki.js attraverso il suo URL assegnato.
- Accedi utilizzando l'account amministratore.
- Completare la configurazione iniziale dell'applicazione.
- Configurare i provider di autenticazione, i gruppi di utenti e le autorizzazioni come richiesto.
- Crea il tuo primo spazio di documentazione e inizia ad aggiungere pagine.
Una volta installato, Wiki.js fornisce un ambiente centralizzato per l'organizzazione e la pubblicazione della documentazione.
Redattori della documentazione
Wiki.js 3 include diverse esperienze di modifica progettate per diversi tipi di utenti e flussi di lavoro della documentazione.
Editor di Markdown
L'editor Markdown fornisce un ambiente di scrittura strutturato con un'anteprima dal vivo.
Utilizza l'editor Monaco, lo stesso motore di editor utilizzato da Visual Studio Code, offrendo funzionalità come:
- Evidenziazione della sintassi.
- Autocompletamento.
- Assistenza alla modifica in linea.
- Anteprima dal vivo del documento.
- Scorciatoie da tastiera.
- Formattazione Markdown.
- Blocchi di codice ed evidenziazione della sintassi.
- Tabelle e contenuti strutturati.
- Espressioni matematiche.
- Definizioni dei diagrammi.
Markdown rimane un formato di testo semplice, rendendo la documentazione facile da rivedere, trasferire e gestire attraverso Git.
Visual Editor
Visual Editor fornisce un'esperienza di rich text per gli utenti che preferiscono formattare il contenuto senza scrivere direttamente Markdown.
Supporta elementi di documentazione comuni, tra cui:
- Intestazioni.
- Paragrafi.
- Elenchi.
- Tavoli.
- Immagini.
- A sinistra.
- Blocchi di codice.
- Formattazione degli elementi.
- Contenuto incorporato.
Il contenuto creato tramite Visual Editor viene memorizzato utilizzando il contenuto basato su Markdown dietro le quinte.
AsciiDoc Editor
Wiki.js supporta anche AsciiDoc per gli utenti che preferiscono la sua sintassi di documentazione strutturata.
AsciiDoc è adatto per manuali tecnici, guide strutturate e progetti di documentazione più grandi.
Modifica collaborativa
Wiki.js 3 supporta la modifica simultanea da parte di più utenti.
I collaboratori possono lavorare sullo stesso documento mentre vedono i cursori e le modifiche degli altri partecipanti in tempo reale.
La funzionalità di modifica collaborativa è particolarmente utile per i team che preparano specifiche tecniche, rapporti sugli incidenti, documentazione operativa e note condivise.
Integrazione Git e controllo delle versioni
Una delle capacità importanti di Wiki.js è la sua integrazione con Git.
La sincronizzazione Git consente di scambiare il contenuto della documentazione con un repository esterno, rendendo possibile la manutenzione della documentazione insieme ai progetti software e ai flussi di lavoro di sviluppo.
Wiki.js 3 fornisce una sincronizzazione bidirezionale, consentendo alle modifiche di contenuto di spostarsi tra il wiki e il repository connesso.
Ciò consente ai team di:
- Mantenere la documentazione in un repository Git.
- Sincronizza le modifiche wiki con i file controllati in base alla versione.
- Rivedi le modifiche alla documentazione attraverso flussi di lavoro di sviluppo familiari.
- Mantenere il contenuto Markdown accessibile al di fuori dell'interfaccia wiki.
- Integrare la documentazione nei processi di controllo sorgente esistenti.
- Conservare una copia esterna della documentazione.
L'integrazione Git è particolarmente utile per i team di sviluppo che utilizzano già GitHub, GitLab o altre piattaforme di hosting Git compatibili.
Flusso di lavoro di sincronizzazione Git
Un flusso di lavoro tipico è costituito dai seguenti passaggi:
- Configurare una destinazione di archiviazione Git supportata.
- Collegare Wiki.js a un repository dedicato.
- Configurare il comportamento di sincronizzazione.
- Creare o aggiornare la documentazione in Wiki.js.
- Consentire al processo di sincronizzazione di pubblicare le modifiche.
- Recupera le modifiche del repository attraverso il flusso di lavoro di sincronizzazione configurato.
Wiki.js può anche sincronizzare il contenuto con le destinazioni di archiviazione locali e cloud supportate.
Importante: La sincronizzazione Git deve essere trattata come un meccanismo di sincronizzazione dei contenuti, non come sostituto di un backup completo dell'applicazione e del database.
Autenticazione e gestione delle identità
Wiki.js supporta diversi metodi di autenticazione, consentendo alle organizzazioni di integrare la piattaforma con i sistemi di gestione delle identità esistenti.
I metodi di autenticazione supportati includono:
| Fornitore | Descrizione |
|---|---|
| Autenticazione locale | Gestire gli account utente direttamente all'interno di Wiki.js. |
| Accedi con OpenID Connect | Integrazione con provider di identità compatibili. |
| Supporta l'accesso tramite i servizi di identità di Google. | |
| GitHub | Consenti l'autenticazione tramite account GitHub. |
| LDAP | Integrazione con i servizi di directory LDAP. |
| SAML 2.0 | Collegati ai provider di identità aziendali che supportano SAML. |
Ulteriori integrazioni di autenticazione potrebbero essere disponibili tramite configurazioni di provider di identità supportate.
Accedi con OpenID Connect
OpenID Connect fornisce un meccanismo di autenticazione standard per collegare Wiki.js a provider di identità compatibili.
Può essere utilizzato con servizi di identità come Keycloak e altre piattaforme compatibili con OIDC.
Autenticazione LDAP
L'integrazione LDAP consente alle organizzazioni di autenticare gli utenti rispetto a un servizio di directory esistente.
Ciò è utile per le aziende che gestiscono già account utente centralizzati e criteri di accesso basati su directory.
Autenticazione SAML
SAML 2.0 consente a Wiki.js di integrarsi con l'infrastruttura di accesso singolo aziendale.
Ciò fornisce un'opzione di autenticazione per le organizzazioni che utilizzano piattaforme di identità centralizzate.
Mappatura di gruppo
Le integrazioni di autenticazione possono mappare gli utenti in gruppi Wiki.js.
Ciò rende possibile associare informazioni di identità esterne con permessi wiki interni.
Autorizzazioni e controllo degli accessi
Wiki.js include un sistema di permessi flessibile per controllare chi può leggere, creare, modificare, gestire e amministrare la documentazione.
Gli amministratori possono definire gruppi e assegnare autorizzazioni in base ai requisiti dell'organizzazione.
Le autorizzazioni possono essere estese a:
- Pagine wiki individuali.
- Percorsi di documentazione.
- Gruppi di utenti.
- Pagine localizzate.
- Siti wiki individuali.
- Le funzioni amministrative.
I ruoli di autorizzazione tipici includono:
| Ruolo | Autorizzazioni tipiche |
|---|---|
| Lettore | Visualizza la documentazione autorizzata. |
| Contributore | Creare e modificare pagine consentite. |
| Revisore | Esamina le modifiche proposte e approva la pubblicazione. |
| Gestore | Gestire la documentazione all’interno delle aree assegnate. |
| Amministratore | Gestire gli utenti, i permessi, la configurazione e il wiki stesso. |
Il modello di autorizzazione supporta sia regole di accesso ereditate che esplicitamente definite.
Ciò rende Wiki.js adatto per ambienti in cui parte della documentazione è pubblica, mentre altre informazioni devono rimanere riservate a team specifici.
Gestione Wiki multi-sito
Wiki.js 3 introduce il supporto per ospitare più siti wiki indipendenti attraverso una singola istanza di applicazione.
Ogni sito può avere una propria configurazione, tra cui:
- Nome host.
- Tema.
- Localizzazione.
- Configurazione dell'autenticazione.
- Configurazione di archiviazione.
- Editori.
- Struttura della documentazione.
Utenti e gruppi possono essere condivisi in tutta l'istanza, semplificando la gestione delle identità e degli accessi.
La funzionalità multisito è utile per le organizzazioni che necessitano di basi di conoscenza separate per diversi reparti, prodotti, clienti o unità aziendali.
Ad esempio, un'organizzazione potrebbe gestire siti separati per:
- Documentazione aziendale interna.
- La documentazione tecnica.
- Supporto al cliente.
- Documentazione del prodotto.
- Risorse del team di sviluppo.
Ogni sito può avere il proprio hostname e la propria presentazione, beneficiando di un'infrastruttura applicativa condivisa.
Blocchi di contenuto e documentazione dinamica
Wiki.js supporta i blocchi di contenuto che consentono di incorporare elementi dinamici e interattivi direttamente nelle pagine di documentazione.
Invece di limitare le pagine a testo e immagini, i blocchi di contenuto rendono possibile creare esperienze di documentazione più ricche.
Gli esempi includono:
- Infobox.
- Gallerie di immagini.
- Mappe.
- Visualizzatori di PDF.
- Indici di pagina.
- Sezioni di spoiler.
- Video incorporati.
- Sirena diagrammi.
- Diagrammi di PlantUML.
- Espressioni matematiche KaTeX.
- Diagrammi di Draw.io.
- Blocchi personalizzati specifici per l'applicazione.
Più di 25 blocchi di contenuto integrati sono disponibili in Wiki.js 3.
Gli sviluppatori possono anche creare blocchi di contenuti personalizzati per estendere la piattaforma con funzionalità aggiuntive.
Ciò è utile per la documentazione tecnica contenente diagrammi di architettura, riferimenti interattivi, spiegazioni visive e risorse incorporate.
Cronologia delle pagine e gestione delle revisioni
Wiki.js mantiene una cronologia delle modifiche alla documentazione, consentendo agli amministratori e ai collaboratori di rivedere come si sono evolute le pagine.
Il sistema di revisione fornisce funzionalità per:
- Visualizzazione delle revisioni precedenti.
- Confronto delle modifiche ai documenti.
- Identificare chi ha apportato le modifiche.
- Ripristino delle versioni precedenti.
- Rivedere l’evoluzione della documentazione.
Wiki.js 3 introduce anche un cestino per recuperare le pagine cancellate.
Queste funzionalità aiutano a prevenire la perdita accidentale di informazioni e forniscono visibilità sulle modifiche della documentazione.
Per le organizzazioni che mantengono documentazione operativa o tecnica importante, la gestione delle revisioni è una parte essenziale della governance della conoscenza.
Commenti, annotazioni e flussi di lavoro di approvazione
Wiki.js 3 fornisce funzionalità di collaborazione e revisione che aiutano i team a mantenere la qualità della documentazione.
Commenti e annotazioni
Gli utenti possono discutere intere pagine o aggiungere annotazioni a sezioni e passaggi specifici.
In questo modo è più facile identificare informazioni obsolete, suggerire correzioni e discutere dettagli tecnici senza modificare immediatamente il contenuto originale.
Suggerimenti di modifica
Gli utenti di sola lettura possono essere autorizzati a suggerire modifiche alla documentazione.
I revisori autorizzati possono valutare questi suggerimenti e decidere se approvarli o rifiutarli.
Norme di approvazione
Gli amministratori possono definire criteri di approvazione per pagine e aree di documentazione selezionate.
Ciò supporta i flussi di lavoro di pubblicazione controllati in cui la documentazione deve essere rivista prima di diventare disponibile per i lettori.
Regole del ciclo di vita
Le regole del ciclo di vita possono attivare azioni in base alle condizioni della documentazione.
Ad esempio, gli amministratori possono configurare criteri per identificare le pagine che non sono state aggiornate per un periodo specificato e notificare ai relativi proprietari che è necessaria una revisione.
Queste funzionalità sono particolarmente utili per la documentazione di conformità, le procedure operative e le basi di conoscenza interne.
Organizzazione di ricerca e documentazione
Wiki.js include una ricerca full-text integrata alimentata da PostgreSQL.
Gli utenti possono cercare la documentazione senza richiedere una piattaforma di ricerca separata.
La funzionalità di ricerca supporta:
- Ricerca full-text.
- Risultati di ricerca classificati.
- Ricerca booleana.
- Filtraggio basato su tag.
- Scoperta della documentazione.
- Ricerca attraverso pagine autorizzate.
La piattaforma fornisce inoltre un file manager strutturato per la gestione delle pagine di documentazione e degli asset associati.
Pagine e file possono essere organizzati attraverso cartelle, rinominati, spostati ed eliminati attraverso l'interfaccia di amministrazione.
La combinazione di ricerca, organizzazione delle pagine, tag e navigazione rende le grandi raccolte di documentazione più facili da gestire.
API e automazione
Wiki.js 3 fornisce un'API REST documentata utilizzando le specifiche OpenAPI.
L'API consente ad applicazioni e script esterni di interagire con le risorse wiki in modo programmatico.
Le possibili integrazioni includono:
- Pubblicazione automatizzata della documentazione.
- Sistemi interni di gestione della conoscenza.
- Flussi di lavoro CI/CD.
- Sistemi di segnalazione esterna.
- Strumenti amministrativi personalizzati.
- Servizi di sincronizzazione della documentazione.
- Processi di gestione dei contenuti automatizzati.
L’API può essere utilizzata per costruire integrazioni senza richiedere agli utenti di eseguire ogni operazione attraverso l’interfaccia web.
Wiki.js supporta anche i webhook per notificare i sistemi esterni quando si verificano eventi wiki specifici.
Integrazione di MCP
Wiki.js 3 include un server opzionale Model Context Protocol (MCP).
Se abilitati e configurati correttamente, gli agenti AI compatibili possono interagire con il contenuto wiki tramite operazioni supportate.
A seconda dei permessi, queste operazioni possono includere la ricerca di pagine, la lettura della documentazione e la proposta di modifiche.
L'integrazione è disabilitata fino a quando non viene esplicitamente abilitata e segue le autorizzazioni dell'utente connesso.
Ciò consente alle organizzazioni di introdurre il recupero delle conoscenze assistito dall'IA senza concedere automaticamente agli agenti l'accesso illimitato alla piattaforma di documentazione.
Sicurezza / amministrazione / configurazione
Wiki.js fornisce un'interfaccia di amministrazione per gestire le impostazioni dell'applicazione, gli utenti, l'autenticazione, i permessi e le politiche di documentazione.
Importanti considerazioni sulla sicurezza includono:
- Abilita HTTPS per l'accesso esterno.
- Utilizzare credenziali di amministratore complesse.
- Limitare le autorizzazioni amministrative.
- Configurare i provider di autenticazione con attenzione.
- Abilita l'autenticazione a più fattori laddove supportata.
- Applicare criteri di accesso basati su gruppo.
- Esaminare le autorizzazioni a livello di pagina.
- Mantenere aggiornate le dipendenze delle applicazioni.
- Monitorare l'attività amministrativa attraverso i registri di controllo.
- Limitare l'accesso ai servizi di database.
- Proteggi le credenziali del repository Git.
- Eseguire regolarmente il backup del database PostgreSQL.
- Esamina le integrazioni esterne e l'accesso alle API.
- Configurare le intestazioni proxy attendibili quando si opera dietro un proxy inverso.
Autenticazione a più fattori
Wiki.js 3.3 include l'applicazione a livello di gruppo dell'autenticazione a due fattori.
Gli amministratori possono utilizzare questa funzionalità per richiedere un'autenticazione più forte per gruppi selezionati anziché affidarsi esclusivamente alla registrazione volontaria degli utenti.
Registrazione di audit
Il registro di controllo registra l'attività dell'applicazione pertinente.
Gli amministratori possono utilizzarlo per rivedere le modifiche e indagare sulle azioni degli utenti.
Sicurezza e Reverse Proxy
Quando si distribuisce Wiki.js dietro un proxy inverso, le intestazioni inoltrate richieste e il supporto WebSocket devono essere configurati correttamente.
L'applicazione fornisce un'impostazione proxy attendibile per la gestione delle informazioni di richiesta inoltrate.
Ciò è importante per un corretto comportamento di autenticazione, limitazione della velocità, registrazione degli audit e collaborazione in tempo reale.
Migliori pratiche per Wiki.js
- Usare un hostname dedicato per il wiki.
- Configura HTTPS prima di consentire l'accesso esterno.
- Usa PostgreSQL per i dati delle applicazioni.
- Creare un account database dedicato.
- Utilizza provider di identità esterni quando è necessaria un'autenticazione centralizzata.
- Organizzare gli utenti in gruppi in base alle loro responsabilità.
- Applicare il principio del minor privilegio.
- Configurare le autorizzazioni a livello di pagina per la documentazione sensibile.
- Usa la sincronizzazione Git quando il controllo delle versioni della documentazione è importante.
- Configurare una strategia di backup separata per il database e le risorse caricate.
- Testare le procedure di ripristino di database e file.
- Utilizza i flussi di lavoro di approvazione per la documentazione critica.
- Definisci i criteri del ciclo di vita per le pagine revisionate frequentemente.
- Tenere aggiornata la documentazione operativa.
- Monitorare il consumo di risorse di applicazioni e database.
- Rivedere regolarmente i registri di controllo.
- Mantenere Wiki.js e le sue dipendenze aggiornate.
- Testare gli aggiornamenti principali rispetto a un backup prima di applicarli alla produzione.
Configurazione e amministrazione
Dopo aver acquistato Wiki.js su Esadax, è possibile accedere all'applicazione e configurare le sue impostazioni disponibili.
L'interfaccia di amministrazione fornisce una gestione centralizzata del wiki e delle sue funzionalità.
Importanti aree di configurazione includono:
| Area di configurazione | Descrizione |
|---|---|
| Impostazioni generali | Configurare il nome del sito, il nome host e il comportamento generale dell'applicazione. |
| Utenti e gruppi | Crea utenti e organizzali in gruppi di autorizzazioni. |
| Permessi | Definisci l'accesso alla documentazione, ai siti e alle funzioni amministrative. |
| Autenticazione | Configurare l'autenticazione locale e i provider di identità esterni. |
| Editori | Abilita e gestisci gli editor di documentazione supportati. |
| Stoccaggio | Configurare la sincronizzazione Git e le destinazioni di archiviazione supportate. |
| Motore di ricerca | Gestire il comportamento di ricerca e le funzionalità di indicizzazione. |
| Navigazione | Configurare la struttura di navigazione del wiki. |
| Tema | Personalizza l'aspetto e il layout dell'applicazione. |
| Localizzazione | Gestire le lingue e le traduzioni supportate. |
| Configurazione della posta | Configurare la consegna e-mail per le notifiche delle applicazioni. |
| Webhook | Collegare eventi wiki ad applicazioni esterne. |
| Sicurezza | Gestire i criteri di autenticazione e le impostazioni di sicurezza. |
| Metrica | Configurare il monitoraggio delle applicazioni e le metriche Prometheus. |
| Gestione del sito | Gestire più siti wiki ospitati dalla stessa istanza. |
Le opzioni di configurazione disponibili dipendono dalla versione di Wiki.js installata e dalle funzionalità abilitate.
Database e archiviazione persistente
Wiki.js 3 utilizza PostgreSQL come motore di database richiesto.
A differenza delle precedenti generazioni di Wiki.js, la versione 3 non supporta più motori di database alternativi.
Il database memorizza le informazioni richieste dall'applicazione, inclusi contenuti wiki, account utente, autorizzazioni, configurazione dell'applicazione e altri dati di sistema.
Requisiti del database
Wiki.js 3 richiede:
| Componente | Requisito |
|---|---|
| Banca dati | PostgreSQL |
| Versioni supportate | PostgreSQL 17 o PostgreSQL 18 |
| Estensioni richieste | ltree e pg_trgm |
| Tempo di esecuzione dell'applicazione | Node.js 26 |
Un database PostgreSQL dedicato e un account database devono essere utilizzati per l'applicazione.
Git e archiviazione esterna
La sincronizzazione Git fornisce un ulteriore modo per mantenere la documentazione al di fuori del database primario.
Wiki.js può sincronizzare il contenuto con i repository Git supportati e altre destinazioni di archiviazione.
L'archiviazione esterna è particolarmente utile per mantenere la documentazione Markdown portatile e integrare il contenuto wiki nei flussi di lavoro di sviluppo esistenti.
Raccomandazioni di backup
Una strategia di backup affidabile dovrebbe includere:
- Backup di database PostgreSQL.
- Immagini e risorse di documenti caricate.
- Configurazione importante dell'applicazione.
- Repository Git esterni.
- Qualsiasi archiviazione persistente gestita separatamente.
La sincronizzazione Git da sola non dovrebbe essere considerata un backup completo dell'installazione di Wiki.js.
Prestazioni e requisiti di sistema
Wiki.js è progettato per funzionare su una vasta gamma di configurazioni di server.
I requisiti di risorse dipendono dal numero di utenti, dalle dimensioni della documentazione, dall'attività di ricerca, dai processi in background e dal carico di lavoro di collaborazione.
I requisiti di base consigliati dalla documentazione ufficiale includono:
| Risorsa | Raccomandazione |
|---|---|
| CPU | Almeno 1 core; consigliati 2 o più core |
| RAM | Almeno 1 GB su Linux |
| Storage delle applicazioni | Almeno 1 GB |
| Node.js | Versione 26 |
| Banca dati | PostgreSQL 17 o 18 |
| Rete | Connettività HTTP e WebSocket |
Risorse aggiuntive possono essere necessarie per installazioni di grandi dimensioni, in particolare quando si ospitano più siti wiki o si supportano molti utenti simultanei.
Considerazioni sulle prestazioni
Wiki.js utilizza i lavoratori in background per attività come manutenzione, indicizzazione di ricerca, webhook e rendering della pagina.
Per installazioni più grandi:
- Allocare risorse CPU sufficienti per l'elaborazione in background.
- Monitorare le prestazioni di PostgreSQL.
- Utilizzare uno storage persistente appropriato.
- Monitorare le connessioni al database e l'attività di query.
- Assicurati che i lavori in background possano essere completati correttamente.
- Configurare il proxy inverso per le connessioni WebSocket.
- Monitorare le metriche delle applicazioni.
- Utilizzare una distribuzione PostgreSQL di dimensioni appropriate per la disponibilità elevata.
Licenze e modello open source
Wiki.js è rilasciato sotto la GNU Affero General Public License versione 3 (AGPL-3.0).
Il codice sorgente è pubblicamente disponibile e l'applicazione può essere auto-ospitata e personalizzata.
Le organizzazioni possono modificare l'applicazione e integrarla nella propria infrastruttura nel rispetto dei requisiti di licenza applicabili.
Il progetto è guidato dalla comunità e fornisce documentazione pubblica, codice sorgente, tracciamento dei problemi e canali di contributo.
Conclusione
Wiki.js è una piattaforma open source completa per la creazione di basi di conoscenza self-hosted e ambienti di documentazione collaborativa.
La sua combinazione di modifica Markdown, modifica visiva, sincronizzazione Git, integrazioni di autenticazione, autorizzazioni granulari, ricerca full-text e strumenti di amministrazione lo rende adatto sia per la gestione della conoscenza personale che per la documentazione aziendale.
Wiki.js 3 espande significativamente la piattaforma con collaborazione in tempo reale, hosting multisito, blocchi di contenuti dinamici, flussi di lavoro di approvazione e un'API REST conforme a OpenAPI.
Con PostgreSQL come base del database e il supporto per i provider di identità esterni, Wiki.js fornisce una soluzione flessibile per i team che desiderano il pieno controllo sulla propria infrastruttura di documentazione.
Sia che venga utilizzato per la documentazione tecnica, la conoscenza aziendale interna, l'assistenza clienti o i runbook operativi, Wiki.js offre un ambiente strutturato ed estensibile per la creazione e la manutenzione della conoscenza organizzativa.

