> ## Content Index
> Fetch the complete content index at: https://blog.esadax.com/llms.txt
> Use this file to discover other available public pages before exploring further.

# Wiki.js (englanniksi)
- URL: https://blog.esadax.com/fi/wikijs-fi-3/
- Published: 2026-11-15T05:12:02.000Z
- Updated: 2026-11-15T05:12:02.000Z
- Author: Esadax 
- Tags: #tr-apps-03-catalog-wikijs, #fi, #mdx-imported, Apps

# Mikä on Wiki.js?

Wiki.js on moderni, avoimen lähdekoodin wiki- ja tiedonhallinta-alusta, joka on rakennettu Node.js: llä. Se tarjoaa keskitetyn ympäristön dokumentaation, teknisten oppaiden, sisäisten tietokantojen ja yhteistyösisällön luomiseen, järjestämiseen, muokkaamiseen ja jakamiseen.

Yksityishenkilöille, kehitysryhmille ja organisaatioille suunniteltu Wiki.js yhdistää tehokkaan Markdown-editorin joustavaan visuaaliseen editoriin, kokotekstihakuun, käyttäjien hallintaan, käyttöoikeuksien hallintaan ja integraatioihin ulkoisten identiteettien tarjoajien kanssa.

Sisältö voidaan synkronoida Git-säilöjen kanssa, jolloin tiimit voivat hallita dokumentaatiota tuttujen versionhallinnan työnkulkujen avulla ja pitää samalla tietopohjansa käytettävissä verkkokäyttöliittymän kautta.

Wiki.js 3 esittelee uudelleen suunnitellun arkkitehtuurin, jossa on reaaliaikainen yhteistyö, useita wiki-sivustoja, dynaamisia sisältölohkoja, laajennettuja muokkausominaisuuksia ja moderni REST-sovellusliittymä. Se käyttää PostgreSQL: ää tietokantana ja Node.js: ää sovelluksen suoritusaikana.

Alusta on itse isännöity, erittäin laajennettavissa, ja jaellaan GNU Affero General Public License version 3 (AGPL-3.0).

## Wiki.js:n historia

Wiki.js:n loi alun perin Nicolas Giard, joka tunnetaan myös nimellä NGPixel, ja sitä on kehitetty avoimen lähdekoodin dokumentaatioalustana vuodesta 2017 lähtien.

Alkuperäiset versiot perustivat Wiki.js: n moderniksi vaihtoehdoksi perinteisille wiki-moottoreille, yhdistämällä Markdown-pohjaisen sisällön luomisen, Git-synkronoinnin, todennusintegraatiot ja muokattavan käyttöliittymän.

Projekti kehittyi 2.x-julkaisuissaan, joissa esiteltiin lisää toimittajia, tallennuspalveluntarjoajia, todennusmoduuleja, hakuintegraatioita ja hallintomahdollisuuksia.

1. marraskuuta 2026 projekti julkaisi virallisesti Wiki.js 3.0:n vakaana versiona. Tämä julkaisu edusti täydellistä uudelleenkirjoitusta frontendistä ja backendistä, joka esitteli merkittäviä arkkitehtonisia ja toiminnallisia parannuksia.

Wiki.js 3:n tärkeimpiä lisäyksiä ovat:

- Reaaliaikainen yhteismuokkaus.
- Usean sivuston wiki-hosting.
- Uudelleen suunniteltu Markdown-editori, joka perustuu Monaco-editoriin.
- Uusi visuaalinen editori.
- Laajennetut sisältölohkot.
- Sisäänrakennettu tiedostonhallintaohjelma.
- Parannetut käyttöoikeudet ja hyväksyntätyönkulut.
- Dokumentoitu REST API.
- Päivitetty todennusarkkitehtuuri.
- Parannettu haku ja PostgreSQL-integraatio.
1. marraskuuta 2026 mennessä viimeisin julkaistu versio on Wiki.js 3.3.1.

## Wiki.js:n tärkeimmät ominaisuudet

Wiki.js tarjoaa kattavan joukon ominaisuuksia yhteistyödokumentaation luomiseen ja ylläpitoon.

- **Markdown Editor:** Kirjoita dokumentaatio käyttäen Markdown kanssa syntaksin korostus, automaattinen täydennys, ja live vierekkäin esikatselut.
- **Visual Editor:** Luo ja muotoilla sisältöä kautta rich-tekstin muokkaus käyttöliittymä ilman manuaalisesti kirjoittaa Markdown.
- **AsciiDoc tuki:** Käytä AsciiDoc vaihtoehtoisena dokumentaation muodossa.
- **Git-integraatio:** Synkronoi wiki-sisältö Git-säilöillä käyttämällä kaksisuuntaista synkronointia.
- **Todennuspalveluntarjoajat:** Tukee paikallisia tilejä, OpenID Connect-, LDAP- ja SAML-todennusta.
- **Granular Oikeudet:** Hallitse pääsy yksittäisille sivuille, polut, ryhmät, kieliversiot, ja wiki-sivustoja.
- **Real-Time Collaboration:** Salli useiden käyttäjien muokata asiakirjoja samanaikaisesti.
- **Kokotekstihaku:** Etsi tietoja dokumentaatiosta sisäänrakennettujen hakuominaisuuksien avulla.
- **Usean sivuston isännöinti:** Isännöi useita itsenäisiä wiki-sivustoja yhdestä Wiki.js-esiintymästä.
- **Sisältölohkot:** Upota dynaamisia komponentteja, kuten kaavioita, karttoja, gallerioita, tietolaatikoita ja muita vuorovaikutteisia elementtejä.
- **Sivuhistoria:** Seuraa versioita, vertaa muutoksia ja palauta aiemmat versiot.
- **Tiedostojen hallinta:** Järjestä dokumentaatiosivut ja ladatut resurssit yhtenäisessä käyttöliittymässä.
- **Lokalisointi:** Luo ja hallinnoi dokumentaatiota useilla kielillä.
- **Hyväksyntätyönkulut:** Käyttäjät voivat ehdottaa muokkauksia, kun taas määritetyt tarkistajat hallitsevat julkaisua.
- **Kommentit ja huomautukset:** Keskustele kokonaisista sivuista tai tietyistä dokumentaation osista.
- **Audit Logging:** Seuraa käyttäjän toimintaa ja hallinnollisia muutoksia.
- **REST API:** Integroi Wiki.js ulkoisiin sovelluksiin ja automaatiotyönkulkuihin.
- **Webhooks:** Lähetä ilmoituksia ulkoisiin järjestelmiin, kun wiki tapahtumia tapahtuu.
- **Omat teemat:** Määritä wikin ulkoasu, asettelu ja visuaalinen ilme.
- **Valinnainen MCP-integrointi:** Anna yhteensopivien tekoälyagenttien käyttää wikitietoja ja suorittaa tuettuja toimintoja yhdistetyn käyttäjän käyttöoikeuksilla.

## Esimerkkejä käytöstä

Wiki.js: ää voidaan käyttää monenlaisiin dokumentaatio- ja tiedonhallintaskenaarioihin.

Yleisiä käyttötapauksia ovat:

- **Tekninen dokumentaatio:** Ylläpidä asennusohjeita, API-viittauksia, arkkitehtuuridokumentaatiota ja kehitysoppaita.
- **Sisäiset tietokannat:** Keskitä yrityksen menettelyt, toimintaohjeet ja institutionaalinen tieto.
- **Team Collaboration:** Salli työntekijöiden ja osallistujien luoda ja ylläpitää jaettua dokumentaatiota.
- **IT-dokumentaatio:** Järjestä infrastruktuurin tiedot, verkkokaaviot, palvelinluettelot ja vianmääritystoimenpiteet.
- **Ohjelmistodokumentaatio:** Ylläpidä projektidokumentaatiota lähdekoodin rinnalla Git-synkronoinnin avulla.
- **Asiakastuki:** Luo hakukelpoisia ohjekeskuksia, tuoteoppaita ja usein kysyttyjä kysymyksiä.
- **Projektin dokumentaatio:** Hallitse projektin määritykset, kehitys muistiinpanoja, ja julkaisutiedot.
- **Yrityksen wikit:** Luo sisäinen resurssi käytäntöjä, perehdytysdokumentaatiota ja organisaation prosesseja varten.
- **Koulutusresurssit:** Julkaise kurssimateriaaleja, opetusohjelmia ja yhteistyöhön perustuvia oppimisresursseja.
- **Tutkimus Dokumentaatio:** Järjestää teknisiä havaintoja, tutkimus muistiinpanoja, ja viiteaineistoa.
- **Operatiiviset Runbooks:** Ylläpitää menettelyjä järjestelmän hallintaan, ylläpitoon ja tapaturmiin vastaamiseen.
- **Monen osaston dokumentointi:** Erilliset dokumentointitilat eri tiimeille tai liiketoimintayksiköille.

## Wiki.js:n hyödyt

- Keskitetty dokumentaation hallinta.
- Avoimen lähdekoodin ja itse isännöity arkkitehtuuri.
- Useita sisällön toimittajia.
- Markdown-pohjainen dokumentaatio.
- Git-tuettu synkronointi.
- Reaaliaikainen yhteismuokkaus.
- Tehokas kokotekstihaku.
- Rakeinen käyttöoikeuksien hallinta.
- Useita todennuspalveluntarjoajia.
- Tuki useille itsenäisille wiki-sivustoille.
- Sisäänrakennettu versiohistoria.
- Joustava sisällön organisointi.
- Muokattavissa oleva ulkonäkö.
- Integrointi ulkoisiin sovelluksiin.
- REST API ja webhook tuki.
- Laajat hallintomahdollisuudet.
- Ei riippuvuutta omisteisesta isännöidystä dokumentaatiopalvelusta.

## Kuinka asentaa Wiki.js

Asenna Wiki.js Esadaxin kautta noudattamalla seuraavia ohjeita:

1. Osta Wiki.js kautta Esadax.
2. Oston jälkeen anna tarvittavat sovelluksen kokoonpanotiedot.
3. Määritä sovelluksen URL-osoite ja järjestelmänvalvojan tili.
4. Määritä PostgreSQL-tietokantayhteys.
5. Valitse tarvittavat sovellusten käyttö- ja suojausasetukset.
6. Käynnistä sovellus valitsemalla **Ota käyttöön**.
7. Käytä Wiki.js:ää sille määritetyn URL-osoitteen kautta.
8. Kirjaudu sisään järjestelmänvalvojan tilillä.
9. Suorita sovelluksen alkuasetukset loppuun.
10. Määritä todennuksen tarjoajat, käyttäjäryhmät ja käyttöoikeudet tarpeen mukaan.
11. Luo ensimmäinen dokumentaatiotila ja aloita sivujen lisääminen.

Kun Wiki.js on asennettu, se tarjoaa keskitetyn ympäristön dokumentaation järjestämiseen ja julkaisemiseen.

## Dokumentaation toimittajat

Wiki.js 3 sisältää useita muokkauskokemuksia, jotka on suunniteltu erityyppisille käyttäjille ja dokumentaation työnkuluille.

### Markdown-editori

Markdown-editori tarjoaa jäsennellyn kirjoitusympäristön, jossa on suora esikatselu.

Se käyttää Monaco-editoria, samaa editorimoottoria, jota Visual Studio Code käyttää, ja tarjoaa ominaisuuksia, kuten:

- Syntaksin korostus.
- Automaattinen täydennys.
- Inline-muokkausapua.
- Live-asiakirjan esikatselu.
- Pikanäppäimet.
- Markdown-muotoilu.
- Koodilohkot ja syntaksin korostus.
- Taulukot ja jäsennelty sisältö.
- Matemaattiset lausekkeet.
- Kaavion määritelmät.

Markdown pysyy pelkkänä tekstimuotona, joten dokumentaatiota on helppo tarkastella, siirtää ja hallita Gitin kautta.

### Visuaalinen muokkain

Visuaalinen muokkain tarjoaa rich-text -kokemuksen käyttäjille, jotka haluavat muotoilla sisältöä kirjoittamatta suoraan Markdownia.

Se tukee yleisiä dokumentointielementtejä, kuten:

- Otsikot.
- Kappaleet.
- Listat.
- Pöydät.
- Kuvia.
- Vasemmalle.
- Koodi lohkoja.
- Elementtien muotoilu.
- Upotettu sisältö.

Visuaalisen muokkaimen kautta luotu sisältö tallennetaan käyttämällä Markdown-pohjaista sisältöä kulissien takana.

### AsciiDoc-editori

Wiki.js tukee myös AsciiDocia käyttäjille, jotka suosivat sen jäsenneltyä dokumentaatiosyntaksia.

AsciiDoc sopii teknisiin käsikirjoihin, jäsenneltyihin oppaisiin ja suurempiin dokumentointiprojekteihin.

### Yhteinen muokkaus

Wiki.js 3 tukee useiden käyttäjien samanaikaista muokkaamista.

Osallistujat voivat työstää samaa asiakirjaa samalla, kun he näkevät muiden osallistujien osoittimet ja muutokset reaaliajassa.

Yhteismuokkaustoiminto on erityisen hyödyllinen tiimeille, jotka valmistelevat teknisiä määrityksiä, tapausraportteja, operatiivista dokumentaatiota ja jaettuja muistiinpanoja.

## Git-integraatio ja versionhallinta

Yksi Wiki.js:n tärkeistä ominaisuuksista on sen integrointi Gitin kanssa.

Git-synkronoinnin avulla dokumentaation sisältöä voidaan vaihtaa ulkoisen tietovaraston kanssa, jolloin dokumentaatiota on mahdollista ylläpitää ohjelmistoprojektien ja kehitystyönkulkujen rinnalla.

Wiki.js 3 tarjoaa kaksisuuntaisen synkronoinnin, jolloin sisällön muutokset voivat liikkua wikin ja yhdistetyn säilön välillä.

Tämä mahdollistaa tiimien:

- Ylläpidä dokumentaatiota Git-tietovarastossa.
- Synkronoi wiki-muutokset versioitujen tiedostojen kanssa.
- Tarkista dokumentaation muutokset tuttujen kehitystyönkulkujen avulla.
- Pidä Markdown-sisältö käytettävissä wiki-käyttöliittymän ulkopuolella.
- Integroi dokumentaatio olemassa oleviin lähdekoodin hallintaprosesseihin.
- Ylläpitää ulkoista kopiota dokumentaatiosta.

Git-integraatio on erityisen hyödyllinen kehitystiimeille, jotka käyttävät jo GitHubia, GitLabia tai muita yhteensopivia Git-isännöintialustoja.

### Git-synkronoinnin työnkulku

Tyypillinen työnkulku koostuu seuraavista vaiheista:

1. Määritä tuettu Git-tallennuskohde.
2. Yhdistä Wiki.js erityiseen arkistoon.
3. Määritä synkronoinnin toiminta.
4. Luo tai päivitä dokumentaatiota Wiki.js:ssä.
5. Salli synkronointiprosessin julkaista muutokset.
6. Nouda tietovaraston muutokset määritetyn synkronointityönkulun kautta.

Wiki.js voi myös synkronoida sisältöä tuettujen paikallisten ja pilvitallennuskohteiden kanssa.

**Tärkeää:** Git-synkronointia tulee käsitellä sisällön synkronointimekanismina, ei täydellisen sovelluksen ja tietokannan varmuuskopion korvikkeena.

## Todennus ja identiteetin hallinta

Wiki.js tukee useita todennusmenetelmiä, jolloin organisaatiot voivat integroida alustan olemassa oleviin identiteetinhallintajärjestelmiin.

Tuettuja todennusmenetelmiä ovat:

| Toimittaja                 | Kuvaus                                                                    |
| -------------------------- | ------------------------------------------------------------------------- |
| Paikallinen todennus       | Hallitse käyttäjätilejä suoraan Wiki.js:ssä.                              |
| Kirjaudu sisään OpenID:llä | Integroi yhteensopivien tunnistetietojen tarjoajien kanssa.               |
| Google.                    | Tukee kirjautumista Googlen identiteettipalveluiden kautta.               |
| GitHub                     | Salli todennus GitHub-tilien kautta.                                      |
| LDAP                       | Integroi LDAP-hakemistopalveluihin.                                       |
| SAML 2.0                   | Muodosta yhteys SAML-protokollaa tukeviin yritystunnuspalveluntarjoajiin. |

Muita todennusintegrointeja voi olla saatavilla tuettujen tunnistetietojen toimittajan määritysten kautta.

### Kirjaudu sisään OpenID:llä

OpenID Connect tarjoaa standardinmukaisen todennusmekanismin Wiki.js:n yhdistämiseksi yhteensopiviin tunnistetietojen tarjoajiin.

Sitä voidaan käyttää identiteettipalveluiden, kuten Keycloakin ja muiden OIDC-yhteensopivien alustojen kanssa.

### LDAP- todennus

LDAP-integroinnin avulla organisaatiot voivat todentaa käyttäjät olemassa olevaa hakemistopalvelua vasten.

Tästä on hyötyä yrityksille, jotka jo ylläpitävät keskitettyjä käyttäjätilejä ja hakemistopohjaisia käyttöoikeuksia.

### SAML-todennus

SAML 2.0 mahdollistaa Wiki.js:n integroinnin yrityksen kertakirjautumisen infrastruktuuriin.

Tämä tarjoaa todennusvaihtoehdon organisaatioille, jotka käyttävät keskitettyjä identiteettialustoja.

### Ryhmän kartoitus

Todennusintegraatiot voivat yhdistää käyttäjiä Wiki.js-ryhmiin.

Tämä mahdollistaa ulkoisten identiteettitietojen yhdistämisen sisäisiin wikien käyttöoikeuksiin.

## Käyttöoikeudet ja pääsynvalvonta

Wiki.js sisältää joustavan käyttöoikeusjärjestelmän, jolla hallitaan sitä, kuka voi lukea, luoda, muokata, hallita ja ylläpitää dokumentaatiota.

Järjestelmänvalvojat voivat määrittää ryhmiä ja myöntää käyttöoikeuksia organisaationsa vaatimusten mukaisesti.

Käyttöoikeudet voidaan määrittää seuraaviin:

- Yksittäiset wikisivut.
- Dokumentointipolkuja.
- Käyttäjäryhmät.
- Lokalisoidut sivut.
- Yksittäiset wikisivustot.
- Hallinnolliset tehtävät.

Tyypillisiä käyttöoikeusrooleja ovat esimerkiksi seuraavat:

| Rooli       | Tyypilliset käyttöoikeudet                                    |
| ----------- | ------------------------------------------------------------- |
| Lukija      | Tarkastele valtuutettua dokumentaatiota.                      |
| Osallistuja | Luo ja muokkaa sallittuja sivuja.                             |
| Tarkistaja  | Tarkista ehdotetut muutokset ja hyväksy julkaisu.             |
| Johtaja     | Hallinnoi dokumentaatiota määritettyjen alueiden sisällä.     |
| Ylläpitäjä  | Hallitse käyttäjiä, käyttöoikeuksia, asetuksia ja itse wikiä. |

Käyttöoikeusmalli tukee sekä periytyviä että eksplisiittisesti määriteltyjä käyttöoikeuksia.

Tämä tekee Wiki.js:stä sopivan ympäristöihin, joissa osa dokumentaatiosta on julkista, kun taas muiden tietojen on pysyttävä rajoitettuina tietyille tiimeille.

## Monen sivuston Wiki hallinta

Wiki.js 3 esittelee tuen useiden itsenäisten wiki-sivustojen isännöinnille yhden sovellusinstanssin kautta.

Jokaisella sivustolla voi olla oma kokoonpano, mukaan lukien:

- Isäntänimi.
- Teema.
- Lokalisointi.
- Todentamisen kokoonpano.
- Tallennustilan kokoonpano.
- Toimittajat.
- Dokumentaation rakenne.

Käyttäjät ja ryhmät voidaan jakaa koko instanssissa, mikä yksinkertaistaa identiteetin ja käyttöoikeuksien hallintaa.

Usean sivuston toiminta on hyödyllistä organisaatioille, jotka tarvitsevat erillisiä tietokantoja eri osastoille, tuotteille, asiakkaille tai liiketoimintayksiköille.

Organisaatio voi esimerkiksi ylläpitää erillisiä sivustoja seuraavia varten:

- Yrityksen sisäinen dokumentaatio.
- Tekninen dokumentaatio.
- Asiakaspalvelu ja tuki.
- Tuotedokumentaatio.
- Kehitystiimin resurssit.

Jokaisella sivustolla voi olla oma isäntänimi ja esitystapa hyödyntäen samalla jaettua sovellusinfrastruktuuria.

## Sisältölohkot ja dynaaminen dokumentointi

Wiki.js tukee sisältölohkoja, joiden avulla dynaamisia ja vuorovaikutteisia elementtejä voidaan upottaa suoraan dokumentaatiosivuille.

Sen sijaan, että sivut rajoittuisivat tekstiin ja kuviin, sisältölohkojen avulla on mahdollista luoda monipuolisempia dokumentointikokemuksia.

Esimerkkeinä voidaan mainita:

- Tietolaatikot.
- Kuvagallerioita.
- Kartat.
- PDF-katsojat.
- Sivujen hakemistot.
- Spoileriosiot.
- Upotetut videot.
- Merenneito kaaviot.
- PlantUML-kaaviot.
- KaTeXin matemaattiset lausekkeet.
- Draw.io kaaviot.
- Mukautetut sovelluskohtaiset lohkot.

Wiki.js 3:ssa on saatavilla yli 25 sisäänrakennettua sisältölohkoa.

Kehittäjät voivat myös luoda mukautettuja sisältölohkoja laajentaakseen alustaa lisätoiminnoilla.

Tämä on hyödyllistä tekniselle dokumentaatiolle, joka sisältää arkkitehtuurikaavioita, vuorovaikutteisia viitteitä, visuaalisia selityksiä ja upotettuja resursseja.

## Sivun historia ja versioiden hallinta

Wiki.js ylläpitää dokumentaation muutoshistoriaa, jonka avulla ylläpitäjät ja muokkaajat voivat tarkastella, miten sivut ovat kehittyneet.

Revisiojärjestelmä tarjoaa toiminnot mm.

- Aiempien versioiden tarkasteleminen.
- Dokumenttimuutosten vertailu.
- Tunnistaminen, kuka teki muutoksia.
- Aiempien versioiden palauttaminen.
- Dokumentoinnin kehityksen tarkastelu.

Wiki.js 3 esittelee myös roskakorin poistettujen sivujen palauttamiseksi.

Nämä ominaisuudet auttavat estämään vahingossa tapahtuvan tiedon menetyksen ja tarjoavat näkyvyyttä dokumentaation muutoksiin.

Organisaatioille, jotka ylläpitävät tärkeää operatiivista tai teknistä dokumentaatiota, versionhallinta on olennainen osa tiedonhallintaa.

## Kommentit, huomautukset ja hyväksyntätyönkulut

Wiki.js 3 tarjoaa yhteistyö- ja tarkistusominaisuuksia, jotka auttavat tiimejä ylläpitämään dokumentaation laatua.

### Kommentit ja huomautukset

Käyttäjät voivat keskustella kokonaisista sivuista tai lisätä huomautuksia tiettyihin osioihin ja kappaleisiin.

Näin on helpompi tunnistaa vanhentuneet tiedot, ehdottaa korjauksia ja keskustella teknisistä yksityiskohdista muokkaamatta alkuperäistä sisältöä välittömästi.

### Muokkaa ehdotuksia

Vain luku -käyttäjille voidaan antaa lupa ehdottaa muutoksia dokumentaatioon.

Valtuutetut tarkistajat voivat arvioida näitä ehdotuksia ja päättää, hyväksyvätkö vai hylkäävätkö he ne.

### Hyväksyntäsäännöt

Järjestelmänvalvojat voivat määrittää hyväksymiskäytäntöjä valituille sivuille ja dokumentointialueille.

Tämä tukee hallittuja julkaisutyönkulkuja, joissa dokumentaatio on tarkistettava ennen kuin se tulee lukijoiden saataville.

### Elinkaaren säännöt

Elinkaarisäännöt voivat käynnistää toimintoja dokumentointiehtojen perusteella.

Järjestelmänvalvojat voivat esimerkiksi määrittää käytäntöjä, joilla tunnistetaan sivut, joita ei ole päivitetty tiettyyn aikaan, ja ilmoittaa niiden omistajille, että tarkistus on tarpeen.

Nämä ominaisuudet ovat erityisen hyödyllisiä vaatimustenmukaisuuden dokumentoinnissa, toimintatavoissa ja sisäisissä tietokannoissa.

## Haku- ja dokumentointiorganisaatio

Wiki.js sisältää sisäänrakennetun kokotekstihaun PostgreSQL:n avulla.

Käyttäjät voivat hakea dokumentaatiota vaatimatta erillistä hakualustaa.

Haku toiminto tukee:

- Kokotekstihaku.
- Sijoitetut hakutulokset.
- Boolean-haku.
- Tunnistepohjainen suodatus.
- Dokumentaation löytäminen.
- Etsiminen valtuutetuilla sivuilla.

Alusta tarjoaa myös jäsennellyn tiedostonhallinnan dokumentaatiosivujen ja niihin liittyvien resurssien hallintaan.

Sivut ja tiedostot voidaan järjestää kansioiden avulla, nimetä uudelleen, siirtää ja poistaa hallintaliittymän kautta.

Haun, sivujen järjestämisen, tunnisteiden ja navigoinnin yhdistelmä helpottaa suurten dokumentaatiokokoelmien ylläpitoa.

## API ja automaatio

Wiki.js 3 tarjoaa REST API:n, joka on dokumentoitu OpenAPI-määrityksen mukaisesti.

API mahdollistaa ulkoisten sovellusten ja komentosarjojen vuorovaikutuksen wiki-resurssien kanssa ohjelmallisesti.

Mahdollisia integraatioita ovat mm.

- Automatisoitu dokumentaation julkaiseminen.
- Sisäiset tiedonhallintajärjestelmät.
- CI/CD-työnkulut.
- Ulkoiset raportointijärjestelmät.
- Mukautetut hallinnolliset työkalut.
- Dokumentaation synkronointipalvelut.
- Automatisoidut sisällönhallintaprosessit.

API:n avulla voidaan rakentaa integraatioita ilman, että käyttäjiltä edellytetään jokaisen toiminnon suorittamista verkkokäyttöliittymän kautta.

Wiki.js tukee myös webhookeja, jotka ilmoittavat ulkoisille järjestelmille, kun tiettyjä wiki-tapahtumia tapahtuu.

### MCP-integraatio

Wiki.js 3 sisältää valinnaisen Model Context Protocol (MCP) -palvelimen.

Kun se on otettu käyttöön ja määritetty oikein, yhteensopivat tekoälyagentit voivat olla vuorovaikutuksessa wiki-sisällön kanssa tuettujen toimintojen kautta.

Oikeuksista riippuen näihin toimintoihin voi kuulua sivujen etsiminen, dokumentaation lukeminen ja muokkausehdotusten tekeminen.

Integraatio on poistettu käytöstä, kunnes se otetaan nimenomaisesti käyttöön, ja se noudattaa yhdistetyn käyttäjän käyttöoikeuksia.

Tämän ansiosta organisaatiot voivat ottaa käyttöön tekoälyn avustaman tiedonhaun ilman, että agenteille myönnetään automaattisesti rajoittamaton pääsy dokumentointialustaan.

## Tietoturva / ylläpito / konfigurointi

Wiki.js tarjoaa ylläpitokäyttöliittymän sovellusasetusten, käyttäjien, tunnistautumisen, käyttöoikeuksien ja dokumentointikäytäntöjen hallintaan.

Tärkeitä turvallisuusnäkökohtia ovat:

- Ota HTTPS käyttöön ulkoista käyttöä varten.
- Käytä vahvoja järjestelmänvalvojan tunnistetietoja.
- Rajoita järjestelmänvalvojan oikeuksia.
- Määritä todennuspalveluntarjoajat huolellisesti.
- Ota monivaiheinen todennus käyttöön, jos sitä tuetaan.
- Ota käyttöön ryhmäpohjaiset käyttöoikeuskäytännöt.
- Tarkista sivutason käyttöoikeudet.
- Pidä sovellusriippuvuudet ajan tasalla.
- Valvo hallinnollista toimintaa tarkastuslokien avulla.
- Rajoita pääsyä tietokantapalveluihin.
- Suojaa Git-tietovaraston tunnistetiedot.
- Varmuuskopioi PostgreSQL-tietokanta säännöllisesti.
- Tarkista ulkoiset integraatiot ja API-käyttöoikeudet.
- Määritä luotetut välityspalvelimen otsikot, kun toimitaan käänteisen välityspalvelimen takana.

### Multi-Factor Authentication -todennus

Wiki.js 3.3 sisältää ryhmätason kaksivaiheisen todennuksen valvonnan.

Järjestelmänvalvojat voivat käyttää tätä ominaisuutta vaatiakseen vahvempaa todennusta valituille ryhmille sen sijaan, että luottaisivat pelkästään vapaaehtoiseen käyttäjien rekisteröitymiseen.

### Tarkastuksen kirjaaminen

Tarkastusloki tallentaa asiaankuuluvan sovellustoiminnan.

Järjestelmänvalvojat voivat sen avulla tarkastella muutoksia ja tutkia käyttäjien toimia.

### Turvallisuus ja käänteiset välityspalvelimet

Kun Wiki.js otetaan käyttöön käänteisen välityspalvelimen takana, tarvittavat edelleenlähetetyt otsikot ja WebSocket-tuki on määritettävä oikein.

Sovellus tarjoaa luotetun välityspalvelimen asetuksen välitettyjen pyyntötietojen käsittelyä varten.

Tämä on tärkeää oikean todennuskäyttäytymisen, nopeuden rajoittamisen, tarkastuksen kirjaamisen ja reaaliaikaisen yhteistyön kannalta.

## Parhaat käytännöt Wiki.js:lle

- Käytä wikille omaa isäntänimeä.
- Määritä HTTPS ennen ulkoisen käytön sallimista.
- Käytä PostgreSQL: ää sovellustietoihin.
- Luo oma tietokantatili.
- Käytä ulkoisia tunnistetietojen toimittajia, kun tarvitaan keskitettyä todennusta.
- Järjestä käyttäjät ryhmiin heidän vastuualueidensa mukaan.
- Sovelletaan pienimmän etuoikeuden periaatetta.
- Määritä sivutason käyttöoikeudet arkaluontoiselle dokumentaatiolle.
- Käytä Git-synkronointia, kun dokumentaation versionhallinta on tärkeää.
- Määritä erillinen varmuuskopiointistrategia tietokannalle ja ladatuille resursseille.
- Testaa tietokannan ja tiedostojen palautusmenettelyt.
- Käytä hyväksynnän työnkulkuja kriittiseen dokumentaatioon.
- Määritä elinkaarikäytännöt usein tarkistetuille sivuille.
- Pidä toimintadokumentaatio ajan tasalla.
- Valvo sovelluksen ja tietokannan resurssien kulutusta.
- Tarkista tarkastuslokit säännöllisesti.
- Pidä Wiki.js ja sen riippuvuudet ajan tasalla.
- Testaa merkittävät päivitykset varmuuskopiota vasten ennen niiden käyttöönottoa tuotannossa.

## Konfigurointi ja hallinta

Kun olet ostanut Wiki.js:n **Esadaxista**, voit käyttää sovellusta ja määrittää sen käytettävissä olevat asetukset.

Ylläpitokäyttöliittymä tarjoaa keskitetyn hallinnan wikiin ja sen ominaisuuksiin.

Tärkeitä kokoonpanoalueita ovat:

| Kokoonpanoalue              | Kuvaus                                                                       |
| --------------------------- | ---------------------------------------------------------------------------- |
| Yleiset asetukset           | Määritä sivuston nimi, isäntänimi ja sovelluksen yleinen toiminta.           |
| Käyttäjät ja ryhmät         | Luo käyttäjiä ja järjestä ne käyttöoikeusryhmiin.                            |
| Käyttöoikeudet              | Määritä käyttöoikeudet dokumentaatioon, sivustoihin ja hallintatoimintoihin. |
| Todentaminen                | Määritä paikallinen todennus ja ulkoiset tunnistetietojen toimittajat.       |
| Toimittajat                 | Ota käyttöön ja hallinnoi tuettuja dokumentaatioeditoreita.                  |
| Varastointi                 | Määritä Git-synkronointi ja tuetut tallennuskohteet.                         |
| Googlen hakukoneoptimointi  | Hallitse hakukäyttäytymistä ja indeksointiominaisuuksia.                     |
| Navigointi                  | Wikin siirtymisrakenteen määrittäminen.                                      |
| Teema                       | Mukauta sovelluksen ulkoasua ja asettelua.                                   |
| Lokalisointi                | Hallitse tuettuja kieliä ja käännöksiä.                                      |
| Sähköpostin asetukset       | Määritä sähköpostin toimitus sovellusilmoituksia varten.                     |
| Webhooks                    | Yhdistä wikitapahtumat ulkoisiin sovelluksiin.                               |
| Turvallisuus                | Hallitse todennuskäytäntöjä ja suojausasetuksia.                             |
| Metrics                     | Määritä sovellusten valvonta ja Prometheus-mittarit.                         |
| Sivuston hallinnan työkalut | Hallitse useita saman esiintymän isännöimiä wikisivustoja.                   |

Käytettävissä olevat asetusvaihtoehdot riippuvat asennetusta Wiki.js-versiosta ja käytössä olevista toiminnoista.

## Tietokanta ja pysyvä tallennus

Wiki.js 3 käyttää PostgreSQL:ää vaadittuna tietokantamoottorina.

Toisin kuin aikaisemmat Wiki.js-sukupolvet, versio 3 ei enää tue vaihtoehtoisia tietokantamoottoreita.

Tietokanta tallentaa sovelluksen tarvitsemat tiedot, mukaan lukien wiki-sisällön, käyttäjätilit, käyttöoikeudet, sovelluksen kokoonpanon ja muut järjestelmätiedot.

### Tietokannan vaatimukset

Wiki.js 3 vaatii:

| Komponentti                   | Vaatimus                        |
| ----------------------------- | ------------------------------- |
| Tietokanta                    | PostgreSQL                      |
| Tuettujen versioiden luettelo | PostgreSQL 17 tai PostgreSQL 18 |
| Vaaditut laajennukset         | ltree ja pg\_trgm               |
| Sovelluksen suorituksenaika   | Node.js 26                      |

Sovellusta varten tulee käyttää omaa PostgreSQL-tietokantaa ja tietokantatiliä.

### Git ja ulkoinen tallennustila

Git-synkronointi tarjoaa ylimääräisen tavan ylläpitää dokumentaatiota ensisijaisen tietokannan ulkopuolella.

Wiki.js voi synkronoida sisältöä tuettujen Git-säilöjen ja muiden tallennuskohteiden kanssa.

Ulkoinen tallennustila on erityisen hyödyllinen kannettavan Markdown-dokumentaation ylläpitämisessä ja wiki-sisällön integroinnissa olemassa oleviin kehitystyönkulkuihin.

### Varmuuskopiointisuositukset

Luotettavan varmuuskopiointistrategian tulisi sisältää:

- PostgreSQL-tietokannan varmuuskopiot.
- Ladatut kuvat ja asiakirjaresurssit.
- Tärkeä sovelluskokoonpano.
- Ulkoiset Git-säilöt.
- Mahdollinen erikseen ylläpidettävä pysyvä tallennustila.

Pelkkää Git-synkronointia ei pidä pitää täydellisenä Wiki.js-asennuksen varmuuskopiona.

## Suorituskyky- ja järjestelmävaatimukset

Wiki.js on suunniteltu toimimaan laajalla valikoimalla palvelinkokoonpanoja.

Sen resurssivaatimukset riippuvat käyttäjien määrästä, dokumentaation koosta, hakutoiminnasta, taustatöistä ja yhteistyön työmäärästä.

Suositellut perusvaatimukset virallisesta dokumentaatiosta sisältävät:

| Resurssi                  | Suositus                                          |
| ------------------------- | ------------------------------------------------- |
| Suoritin                  | Vähintään 1 ydin; suositellaan vähintään 2 ydintä |
| RAM-muisti                | Vähintään 1 Gt Linuxissa                          |
| Sovelluksen tallennustila | Vähintään 1 Gt                                    |
| Node.js                   | Versio 26                                         |
| Tietokanta                | PostgreSQL 17 tai 18                              |
| Verkko                    | HTTP- ja WebSocket-yhteydet                       |

Lisäresurssit saattavat olla tarpeen suuremmissa asennuksissa, erityisesti isännöitäessä useita wikisivustoja tai tuettaessa monia samanaikaisia käyttäjiä.

### Suorituskykyyn liittyvät näkökohdat

Wiki.js käyttää taustatyöntekijöitä tehtäviin, kuten ylläpitoon, haun indeksointiin, webhookeihin ja sivun renderöintiin.

Suuremmille asennuksille:

- Varaa riittävästi suorittimen resursseja taustakäsittelyyn.
- Tarkkaile PostgreSQL-suorituskykyä.
- Käytä asianmukaista pysyvää tallennustilaa.
- Seuraa tietokantayhteyksiä ja kyselytoimintaa.
- Varmista, että taustatyöt voivat suorittaa onnistuneesti.
- Määritä käänteinen välityspalvelin WebSocket-yhteyksille.
- Valvo sovellusmittareita.
- Käytä sopivan kokoista PostgreSQL-käyttöönottoa korkean käytettävyyden saavuttamiseksi.

## Lisensointi ja avoimen lähdekoodin malli

Wiki.js on julkaistu GNU Affero General Public License -lisenssin version 3 (AGPL-3.0) mukaisesti.

Lähdekoodi on julkisesti saatavilla, ja sovellus voidaan itse isännöidä ja mukauttaa.

Organisaatiot voivat muokata sovellusta ja integroida sen omaan infrastruktuuriinsa noudattaen samalla sovellettavia lisenssivaatimuksia.

Projekti on yhteisöpohjainen ja tarjoaa julkisen dokumentaation, lähdekoodin, ongelmien seurannan ja osallistumiskanavat.

## Johtopäätös

Wiki.js on kattava avoimen lähdekoodin alusta itseisännöityjen tietokantojen ja yhteistyöhön perustuvien dokumentointiympäristöjen rakentamiseen.

Sen yhdistelmä Markdown-muokkausta, visuaalista muokkausta, Git-synkronointia, todennusintegraatioita, rakeisia käyttöoikeuksia, kokotekstihakua ja hallintotyökaluja tekee siitä sopivan sekä henkilökohtaiseen tiedonhallintaan että yrityksen dokumentaatioon.

Wiki.js 3 laajentaa alustaa merkittävästi reaaliaikaisella yhteistyöllä, usean sivuston isännöinnillä, dynaamisilla sisältölohkoilla, hyväksyntätyönkuluilla ja OpenAPI-yhteensopivalla REST-sovellusliittymällä.

Kun PostgreSQL on sen tietokannan perusta ja tuki ulkoisille identiteettipalveluntarjoajille, Wiki.js tarjoaa joustavan ratkaisun tiimeille, jotka haluavat hallita täysin dokumentaatioinfrastruktuuriaan.

Käytettiinpä sitä tekniseen dokumentaatioon, yrityksen sisäiseen tietoon, asiakastukeen tai operatiivisiin runbookeihin, Wiki.js tarjoaa jäsennellyn ja laajennettavan ympäristön organisaation tiedon luomiseen ja ylläpitämiseen.

## Viralliset resurssit

- [Viralliset kotisivut](https://js.wiki/?ref=blog.esadax.com)
- \[Virallinen dokumentaatio\] ([https://docs.js.wiki/](https://docs.js.wiki/?ref=blog.esadax.com))
- [Käytön aloittaminen](https://js.wiki/get-started/?ref=blog.esadax.com)
- [Asennusopas](https://docs.js.wiki/setup/installation?ref=blog.esadax.com)
- \[Järjestelmävaatimukset\] ([https://docs.js.wiki/setup/requirements](https://docs.js.wiki/setup/requirements?ref=blog.esadax.com))
- [Wiki.js 3.0 -julkaisuilmoitus](https://js.wiki/blog/2026-wiki-js-3-release/?ref=blog.esadax.com)
- [GitHub-säilö](https://github.com/requarks/wiki?ref=blog.esadax.com)
- [GitHub-julkaisut](https://github.com/requarks/wiki/releases?ref=blog.esadax.com)
- [Lisenssi](https://github.com/requarks/wiki/blob/main/LICENSE?ref=blog.esadax.com)