Siirry pääsisältöön
Olemme koonneet tähän vastauksia usein kysyttyihin kysymyksiin Ayakaleaf Prosta.

Peruskysymykset

Ei. Ayakaleaf Pro on täysin ilmainen. Se ei ole kokeiluversio eikä vaadi lisenssiä.
Kyllä. Ayakaleaf Pro sisältää kaikki Overleaf Server Pron ominaisuudet, mukaan lukien Git-Bridge-integraation. Lisäksi se sisältää valikoituja ominaisuuksia Overleafin SaaS-alustalta. Jatkamme Ayakaleaf Pron kehittämistä ja parantamista.
Overleaf Server Pro maksaa noin $300 käyttäjää kohden vuodessa. Se vaatii vähintään 10 lisenssiä, joten käyttöönotot alkavat noin $3 000:sta vuodessa. Pienemmissä julkisissa yhdysvaltalaisissa sopimuksissa vuosikustannukset ovat noin $320–$370 käyttäjää kohden. Tämä tekee Server Prosta kalliin erityisesti pienille tiimeille. Dokumentoituja hankintoja ja hintoja on kohdassa #information-and-price-about-overleaf-server-pro.
Overleaf Server Prota käyttävät yleisesti julkishallinnon organisaatiot. Ne ottavat sen käyttöön yksityisissä verkoissa ja valvovat pääsyä tiukasti. Arkaluonteisten tietojen suojaamiseksi sen sisältämät ominaisuudet välttävät tietojen vaihtamista kolmansien osapuolten palveluiden kanssa. Jos tarvitset GitHub-synkronointia, tekoälyä tai vastaavia verkkoon kytkeytyviä ominaisuuksia, Overleaf suosittelee SaaS-alustansa tilausta.
Ayakaleaf Pro on avointa lähdekoodia. Tarkastamme koodin Codex Securityn kaltaisilla työkaluilla sen tietoturvan ja luotettavuuden vahvistamiseksi. Jos et ota käyttöön kolmannen osapuolen tietojen synkronointia, tietosi pysyvät palvelimellasi. Ayakaleaf Pro ei sisällä telemetriaa, joka lähettäisi tietojasi muualle.
Teemme parhaamme ylläpitääksemme tätä projektia pitkällä aikavälillä.
Ayakaleaf Pro on yhteisön ylläpitämä haara (fork). Sen koodi ja integroidut ominaisuudet ovat peräisin yhteisön kontribuutioista. Se on lisensoitu AGPL v3 -lisenssillä. Käyttöönotot voivat noudattaa tätä lisenssiä, kun ne täyttävät sen vaatimukset.
Projektin alkuperäinen nimi vuonna 2024 oli Overleaf Pro. Kehitys oli jonkin aikaa tauolla ja käynnistyi uudelleen loppuvuodesta 2025. Vuoden 2026 ensimmäisellä neljänneksellä Overleaf nimesi tekoälyä hyödyntävän tilauspakettinsa Proksi. Yhteisön palautteessa huomautettiin myös, että Overleaf Pro -nimi voisi aiheuttaa tavaramerkki- ja harhaanjohtamisriskejä. Se voisi saada käyttäjät luulemaan projektia viralliseksi.Nimesimme projektin uudelleen Ayakaleaf Proksi tämän sekaannuksen välttämiseksi. Nimen voi lukea muodossa “Ayaka-notes Overleaf Pro”. Ylläpitäjä (voit kutsua minua nimellä ayaka!) on osallistunut Overleaf-yhteisön kehitykseen opiskeluajoistaan lähtien, yli viiden vuoden ajan. Tämä kokemus tukee sitoutumistamme pitkäaikaiseen ylläpitoon.
Vuodesta 2026 lähtien avoimen lähdekoodin yhteisö on julkaissut monia tekoälyllä rakennettuja LaTeX-editoreja, kuten OpenAI Prismin. Ayakaleaf Pro pitää tietosi ja palvelusi omalla palvelimellasi. Näin hallitset käyttöönottoasi ja tietojasi suoraan.Monilla kokeellisilla yhteisön editoreilla ei ole vakiintunutta pitkän aikavälin ylläpitosuunnitelmaa. Kolmansien osapuolten LaTeX-käännösalustat voivat myös lopettaa toimintansa, jos niiden käyttäjäkunta tai tulot eivät riitä. Ayakaleaf Pro toimittaa kaiken lähdekoodin ja antaa sinun isännöidä jokaista palvelua itse. Vaikka ylläpito loppuisi, olemassa oleva itse isännöity palvelusi voisi jatkaa toimintaansa.
Se nimettiin uudelleen muotoon ayaka-notes/ayakaleaf-pro projektin nimenmuutoksen yhteydessä (katso K08). Sitä ei arkistoitu eikä korvattu: se on sama repositorio, ja GitHub ohjaa vanhat ayaka-notes/overleaf-pro-linkit ja Git-etärepositoriot uuteen nimeen. Docker-image säilyttää nimensä ghcr.io/ayaka-notes/overleaf-pro, joten sinun ei tarvitse muuttaa tiedostoja config/overleaf.rc tai config/version.

Ominaisuudet

Katso ajantasainen ominaisuusluettelo dokumentaatiostamme. Jos haluaisit meidän lisäävän jonkin ominaisuuden, avaa rohkeasti issue (ominaisuuspyyntö) GitHubissa. Teemme parhaamme toteuttaaksemme pyydetyt ominaisuudet, mutta kehitys vie aikaa, emmekä voi taata, että jokainen ominaisuus toimitetaan heti.
Kontribuutiot ovat tervetulleita, mutta hyväksyntää ei taata. Arvioimme jokaisen PR:n sen perusteella, miten se vaikuttaa taustalla olevaan Overleaf-koodikantaan, millainen ylläpitotaakka siitä aiheutuu ja mitä arvoa se tuo käyttäjille. Teemme parhaamme yhdistääksemme ja ylläpitääksemme arvokkaita kontribuutioita.Voimme kuitenkin hylätä PR:t, jotka tuovat liikaa muutoksia, koostuvat tarkastamattomasta tai huonosti ymmärretystä tekoälyn tuottamasta koodista (“vibe coding”) tai lisäävät ominaisuuksia, joita olisi vaikea ylläpitää pitkällä aikavälillä.
Päivitämme yleensä dokumentaation aina, kun julkaisemme uuden ominaisuuden. Katso tarkat määritysohjeet ja käytettävissä olevien ympäristömuuttujien selitykset asiaankuuluvasta dokumentaatiosta.
Python Runner ajaa Pythonia käyttäjän selaimessa Pyodiden versiolla 0.29.3, ei palvelimella. Se lataa koodisi tuomat paketit Pyodideen sisäänrakennetuista paketeista, kuten NumPy, pandas ja Matplotlib. pip-komennolla asennetut ja muut paketit eivät ole käytettävissä. Palvelimella ei tarvitse määrittää mitään.
Ei. Oikeinkirjoituksen tarkistimessa ei ole sanakirjaa japanille tai kiinalle, joten nämä kielet eivät ole oikeinkirjoituksen tarkistuksen kieliluettelossa. Käyttäjät voivat poistaa oikeinkirjoituksen tarkistuksen käytöstä projektikohtaisesti editorin asetuksissa.Jos haluat, ettei sanaa merkitä virheelliseksi, napsauta sitä hiiren oikealla painikkeella ja valitse Add to dictionary. Lisätyt sanat tallennetaan tilillesi, ja ne koskevat kaikkia projektejasi. Voit tarkastella tai poistaa niitä avaamalla editorin asetukset ja valitsemalla Spelling and language → Dictionary → Edit. Sanojen lisääminen ei lisää uutta oikeinkirjoituksen tarkistuksen kieltä.
Liitännäisten asennusohjelmaa ei ole. Ominaisuudet ovat lähdekoodin hakemistossa services/web/modules olevia moduuleja, jotka on rakennettu Docker-imageen ja otetaan käyttöön tämän dokumentaation asetuksilla. Jos haluat lisätä omasi, lisää moduuli lähdekoodiin ja rakenna oma imagesi.

Käyttöönotto

Suosittelemme useimmille käyttäjille käyttöönottoa Toolkitin avulla. Kubernetes-tuki on kokeellinen: Kubernetesin käyttäminen esittelee manifestit, joita testasimme yhdellä tai useammalla replikalla, mutta klusteri lisää operatiivista monimutkaisuutta ja ylläpitotyötä. Hiekkalaatikoidut käännökset luovat käännöskonttinsa Docker-socketin kautta, joten jokainen solmu, jossa Ayakaleaf Pro on käynnissä, tarvitsee Docker Enginen. Emme tarjoa CRI-O-, Podman- tai Quadlet-määrityksiä.
Katso horisontaalisen skaalauksen opas. Voit ottaa käyttöön useita Overleaf-instansseja ja määrittää kuormantasaajan jakamaan liikenteen niiden kesken.
Jos sinulla on olemassa oleva Overleaf Server Pro -instanssi, autamme mielellämme siirtymään Ayakaleaf Proon. Ota yhteyttä sähköpostitse tai issueiden kautta.
Et. Ayakaleaf Prota on tarjottava verkkotunnuksen juuresta. Käytä omaa verkkotunnusta tai aliverkkotunnusta, kuten https://overleaf.example.com.
Kyllä. Toolkit toimii Linuxissa, macOS:ssä Docker Desktopin kanssa ja Windowsissa WSL 2:n ja Docker Desktopin kanssa. Suosittelemme Linuxia jaetuille ja tuotantopalvelimille. macOS- ja Windows-oppaat sisältävät hiekkalaatikkokäännösten määrityksen.Emme tarjoa erillistä docker-compose.yml-tiedostoa. Näet Toolkitin käyttämän Compose-konfiguraation ajamalla Toolkit-hakemistossa komennon bin/docker-compose config.
Asennuksen poistoskriptiä ei ole. Toimi Toolkit-hakemistossa seuraavasti:
  1. Pysäytä ja poista kontit komennolla bin/docker-compose down.
  2. Poista data. Oletuksena se on Toolkitin data/-hakemistossa. Jos muutit OVERLEAF_DATA_PATH-, MONGO_DATA_PATH-, REDIS_DATA_PATH- tai GIT_BRIDGE_DATA_PATH-arvoa tiedostossa config/overleaf.rc, poista myös nämä hakemistot. Tätä ei voi perua, joten varmuuskopioi ensin, jos saatat tarvita dataa.
  3. Poista Toolkit-hakemisto.
  4. Poista Docker-imaget, jotka voit luetella komennolla docker images: ghcr.io/ayaka-notes/overleaf-pro, git-bridge-image, mongo, redis ja TeX Live -imaget.
Aja nämä Toolkit-hakemistossa:
  • bin/stop pysäyttää kaikki kontit, bin/start käynnistää ne uudelleen. Kontit säilyvät, joten käyttäjät pysyvät kirjautuneina.
  • bin/up -d luo kontit ja käynnistää ne taustalla. Aja se, kun olet muuttanut tiedostoa config/variables.env, config/overleaf.rc tai config/version: se luo uudelleen kontit, joiden konfiguraatio on muuttunut, ja vasta silloin muutokset tulevat voimaan. bin/stop ja bin/start eivät ota niitä käyttöön.
  • bin/docker-compose restart sharelatex käynnistää uudelleen vain Overleaf-kontin ottamatta konfiguraatiomuutoksia käyttöön.
Jos käyttäjät kirjataan ulos aina, kun bin/up luo kontin uudelleen, aseta OVERLEAF_SESSION_SECRET, katso kysymykset ja vastaukset sivulla Ympäristömuuttujat.
Palveluntarjoajalla luomaasi sovellukseen, ei Ayakaleaf Prohon. Tiedostossa config/variables.env ei ole takaisinkutsuasetusta yhdellekään näistä integraatioista: Ayakaleaf Pro muodostaa jokaisen takaisinkutsu-URL-osoitteen OVERLEAF_SITE_URL-muuttujasta ja lähettää sen palveluntarjoajalle, joka hylkää sen, ellei se vastaa sovellukselle rekisteröityä osoitetta. Rekisteröit sen siis vain palveluntarjoajalla ja asetat OVERLEAF_SITE_URL-muuttujaan osoitteen, jonka käyttäjät avaavat.Jos muutat OVERLEAF_SITE_URL-arvoa, esimerkiksi uuteen verkkotunnukseen, päivitä URL-osoite myös jokaisella palveluntarjoajalla, muuten linkittäminen epäonnistuu.
Oletuksena kaikki säilyy palvelimen paikallisella levyllä Toolkitin data/-hakemistossa: data/overleaf (projektitiedostot, historia ja käännöstulosteet), data/mongo ja data/redis. Alle 1000 käyttäjän instansseille suosittelemme paikallista levyä ja säännöllisiä varmuuskopioita.Ayakaleaf Pro -image vie noin 5 Gt. Johdannossa mainittu 40 Gt:n vähimmäismäärä koskee hiekkalaatikoituja käännöksiä, joiden texlive-full-imaget vievät kukin noin 28 Gt. Ilman hiekkalaatikoituja käännöksiä käännökset ajetaan sharelatex-kontin sisällä TeX Liven basic-skeemalla sekä paketeilla latexmk, texcount, synctex, etoolbox ja xetex, joten monet projektit epäonnistuvat puuttuvien pakettien vuoksi. data/-hakemisto kasvaa tämän jälkeen projektiesi ja niiden historian mukana; tarkista sen koko komennolla du -sh data/*.
Kyllä, kunhan Windows pysyy hereillä ja Docker Desktop pysyy käynnissä. Ota käyttöön Start Docker Desktop when you sign in to your computer, säilytä Toolkitin restart: always -käytännöt ja poista automaattinen lepotila ja horrostila käytöstä verkkovirralla. Näyttö saa sammua; kannettavan kannen toiminta on erillinen asetus. Ubuntu-päätteen sulkeminen komennon bin/up -d jälkeen ei pysäytä taustalla toimivia kontteja. Docker Desktopin sulkeminen, sen moottorin keskeyttäminen tai komennon wsl --shutdown suorittaminen keskeyttää palvelun.Docker Desktopin Resource Saver on eri asia kuin Windowsin lepotila: se on voimassa, kun yhtään konttia ei ole käynnissä, joten käynnissä oleva Ayakaleaf-kokonaisuus ei ole joutokäynnillä vain siksi, ettei kukaan muokkaa. Windowsin uudelleenkäynnistyksen jälkeen kirjautumisen yhteydessä tapahtuva käynnistys vaatii silti, että joku kirjautuu sisään. Noudata kohtaa Pidä instanssi saatavilla tarkistuksia ja palautusvaiheita varten. Suosittelemme edelleen Linuxia, kun saatavuus ei saa riippua interaktiivisesta työpöytäkirjautumisesta.
Tämä opas käyttää WSL 2 -taustajärjestelmää. Se vaatii suorittimen virtualisoinnin käyttöön BIOS/UEFI-asetuksissa, Windowsin Virtual Machine Platform -ominaisuuden ja toimivan WSL 2 -asennuksen. Täysi Hyper-V-ominaisuus on Docker Desktopin erillinen taustajärjestelmä, eikä se ole tämän WSL-kokoonpanon edellytys.Tarkista Task Manager → Performance → CPU → Virtualization ja komento wsl --list --verbose PowerShellissä. Virheet, kuten 0x80370102, voivat tarkoittaa, että virtualisointi, Windowsin ominaisuus tai käynnistyksen hypervisor on poistettu käytöstä. Katso Windows-asennuksen vianmääritysvaiheet, joissa on Microsoftin ja Dockerin korjauslinkit. Käynnistä Windows uudelleen tarvittavien ominaisuuksien käyttöönoton jälkeen; Ayakaleafin uudelleenasentaminen ei voi korjata Docker-moottoria, joka ei käynnisty.

LaTeX

Kun otat käyttöön Sandbox Compiles -toiminnon, kunkin käyttäjän käännös ajetaan erillisessä Docker-kontissa ja se on eristetty muiden käyttäjien käännöksistä. Shell Escape on oletuksena käytössä Sandbox Compiles -käännöksissä.
Olemme parantaneet Sandbox Compiles -toiminnon TeX Live Full -imagea kolmen viime vuoden ajan. Useimmissa tapauksissa projektit, jotka kääntyvät overleaf.comissa, kääntyvät oikein myös Ayakaleaf Prolla. Jos tarvittava fontti ei ole saatavilla, lataa fontti projektiisi manuaalisesti.
Lataa projektisi viralliselle Overleaf-sivustolle, ota käyttöön vain luku -oikeuden linkkijako ja liitä linkki GitHub-issueen.Tutkimme ja korjaamme kaikki bugit, jotka estävät projektia kääntymästä Ayakaleaf Prossa, kun se kääntyy onnistuneesti virallisella Overleaf-sivustolla. Tämän ulkopuoliset käännösongelmat eivät kuulu tukemme piiriin.
Viimeksi muokattu 8. marraskuuta 2026