Siirry pääsisältöön

Doctor

Overleaf Toolkitin mukana tulee kätevä doctor-skripti vianmäärityksen avuksi. Suorita bin/doctor, niin skripti tulostaa tietoja isäntäympäristöstäsi, konfiguraatiostasi ja Toolkitin tarvitsemista riippuvuuksista. Tämä tuloste voi myös auttaa meitä diagnosoimaan Ayakaleaf Pro -asennustesi ongelmia.
Overleaf Pron käyttäjät voivat avata issuen GitHubissa.On hyvä idea liittää viestiisi bin/doctor-skriptin tuloste.

Doctorin konsultointi

Suorita doctor-skripti:
Run doctor
Näet alla olevan esimerkin kaltaisen tulosteen.

Isäntäkoneen tiedot

Host Information -osio sisältää tietoja Toolkitia ajavasta koneesta (esimerkiksi Linux-jakelu ja sen versio).

Riippuvuudet

Dependencies-osiossa luetellaan työkalut, joita Toolkit tarvitsee toimiakseen. Jos työkalu on asennettu, se näytetään muodossa status: present versiotietoineen. Jos se puuttuu, se näytetään muodossa status: MISSING!, ja doctor-tulosteen loppuun lisätään varoitus.
Jos riippuvuuksia puuttuu, Toolkit ei lähes varmasti toimi.

Konfiguraatio

Configuration-osio sisältää tietoja config/-hakemiston tiedostoista. Tiedostosta config/overleaf.rc doctor tulostaa joitakin keskeisiä arvoja. Puuttuvat tiedostot näytetään muodossa status: MISSING!, ja doctor-tulosteen loppuun lisätään varoitus.
Huomioita yllä olevasta esimerkistä:
  • OVERLEAF_DATA_PATH, jonka arvo on /tmp/overleaf, ei välttämättä ole turvallinen sijainti tärkeälle datalle.
  • MONGO_ENABLED: false tarkoittaa, että Toolkit ei luo omaa MongoDB:tä; varmista tarvittaessa, että MONGO_URL osoittaa ulkoisesti hallinnoituun MongoDB:hen.
  • config/variables.env puuttuu esimerkissä.

Varoitukset

Warnings-osio tiivistää doctor-skriptin havaitsemat ongelmat. Jos ongelmia ei ole, osio ilmoittaa siitä.

Q&A

Vastaus: Ei, kaikki kolme ovat vain tiedoksi. bin/doctor tulostaa ainoastaan raportin, eikä se estä bin/up-komentoa.
  • logged in to quay.io: false ja varoitus Server Pro enabled, but not logged in to quay.io repository: tämä tarkistus on peräisin virallisesta Toolkitista, jossa Server Pro -image on yksityisessä quay.io-rekisterissä. Kun SERVER_PRO=true, Toolkit hakee imagen ghcr.io/ayaka-notes/overleaf-pro, joka on julkinen, joten kirjautumista ei tarvita. Voit jättää tämän varoituksen huomiotta.
  • grep: /root/.docker/config.json: No such file or directory (tai jokin muu kotihakemisto): quay.io-tarkistus etsii tiedostosta merkkijonoa quay.io. Docker kirjoittaa tiedoston vain, kun sillä on tallennettavia asetuksia, esimerkiksi docker login -komennon jälkeen, joten se puuttuu monilta palvelimilta. Sitä ei tarvita.
  • perl: warning: Setting locale failed: Toolkit käyttää perl-ohjelmaa vain tässä, bin/doctor-komennossa, sen version tulostamiseen, ja Perl varoittaa, kun LANG tai LC_ALL viittaa lokaaliin, jota ei ole asennettu isäntäkoneelle. Versio tulostetaan silti. Voit vaientaa varoituksen asettamalla nämä muuttujat lokaaliin, jonka locale -a luettelee, esimerkiksi C.UTF-8.
Varoitukset, kuten Docker daemon is not running, docker not found, Docker Compose not found tai puuttuva tiedosto hakemistossa config/, on sen sijaan korjattava: Toolkit ei käynnisty ilman niitä.
Viimeksi muokattu 2. marraskuuta 2026