Siirry pääsisältöön
Tämä dokumentti käsittelee S3:n määrittämistä Server CE:ssä ja Ayakaleaf Prossa. Olemassa olevan datan siirtämisestä S3-yhteensopivaan tallennustilaan on oma erillinen oppaansa.
Jos otat Ayakaleaf Pron käyttöön s3.md -tallennustila käytössä, onko S3:een tallennettu data salattu?Ei. Dataa ei salata. Kaikki historiapalat (history chunks), mallitiedostot, PDF-tiedostot ja muut tiedostot tallennetaan selväkielisinä. Jos käytät kolmannen osapuolen ulkoista S3-tallennuspalvelua, kiinnitä erityistä huomiota tietoturvaan ja yksityisyyteen.

Milloin S3:n käyttöä datan tallennukseen kannattaa harkita

Alle 1000 käyttäjäpaikan instansseille suosittelemme paikallista levytallennusta yhdessä säännöllisten yhtenäisten varmuuskopioiden kanssa. Suuremmille, yli 1000 käyttäjäpaikan instansseille, jotka saavuttavat paikallisen tallennustilansa rajat (koko tai läpäisykyky), suosittelemme S3-yhteensopivaa objektitallennustaustajärjestelmää muiden verkkopohjaisten tallennusratkaisujen, kuten NFS:n, sijaan.

S3-yhteensopivan objektitallennuksen vaihtoehdot

Tässä ovat suosituimmat vaihtoehdot S3-yhteensopivaan objektitallennukseen:
  • AWS S3, hallinnoitu palvelu; suosittelemme AWS S3:a, kun Ayakaleaf Pro ajetaan AWS:ssä
  • MINIO, itse isännöity
  • Ceph, itse isännöity
  • Myös muilla palveluntarjoajilla on jonkinlainen hallinnoitu S3-yhteensopiva objektitallennus. Voit halutessasi käyttää niitä oman ratkaisun ylläpitämisen sijaan, jos ajat jo Overleaf CE:tä/Server Prota kyseisen palveluntarjoajan ympäristössä.

Viivenäkökohdat S3-yhteensopivaa objektitallennusta valittaessa

Instanssisi ja S3-yhteensopivan objektitallennuksen välinen viive vaikuttaa merkittävästi siirron kestoon. Viive vaikuttaa myös tiedostojen latausnopeuteen Ayakaleaf Prossa, ja hitaat tiedostolataukset voivat pidentää myös PDF-käännösaikoja huomattavasti. Suosittelemme minimoimaan maantieteellisen etäisyyden instanssisi ja S3-yhteensopivan objektitallennuksen välillä. Hallinnoidussa ympäristössä tämä tarkoittaa bucketin luomista samalle alueelle, ja paikallisessa ratkaisussa molempien ajamista samalla kampuksella.

S3-määritys

Tarvitsemme kolme “buckettia” ja kaksi rajoitettua käyttäjätiliä. overleaf-user-files-bucket ja OVERLEAF_FILESTORE_USER_FILES_BUCKET_NAME olivat Overleafin käytössä vain ennen versiota v6.0.0. Ayakaleaf Pro ei käytä niitä versiosta v6.0.0 alkaen. Ayakaleaf Pro ei käytä myöskään globaalia blobs-säilöä (OVERLEAF_HISTORY_BLOBS_BUCKET) eikä zips-säilöä (OVERLEAF_HISTORY_ZIPS_BUCKET), joten niitä ei tarvitse luoda.
Bucketit eivät saa olla julkisesti saatavilla
BucketKäyttöPalveluAiemmin hakemistossa /var/lib/overleaf/data
overleaf-template-filesmallitiedostotfilestoretemplate_files
overleaf-project-blobsprojektihistorian blobithistory ja vain luku -tilassa oleva filestorehistory/overleaf-project-blobs
overleaf-chunkshistoriapalathistoryhistory/overleaf-chunks
Saatat haluta tai joutua valitsemaan eri nimen. Varmista tällöin, että käytät mukautettuja bucketteja kaikissa komennoissa. Seuraavassa käytetään varsinaisten tunnistetietojen paikkamerkkejä:
YmpäristömuuttujaKuvaus
OVERLEAF_FILESTORE_S3_ACCESS_KEY_IDFilestore-palvelun rajoitetun käyttäjän käyttöavain/käyttäjänimi.
OVERLEAF_FILESTORE_S3_SECRET_ACCESS_KEYFilestore-palvelun rajoitetun käyttäjän salainen avain/salasana.
OVERLEAF_HISTORY_S3_ACCESS_KEY_IDHistory-palvelun rajoitetun käyttäjän käyttöavain/käyttäjänimi.
OVERLEAF_HISTORY_S3_SECRET_ACCESS_KEYHistory-palvelun rajoitetun käyttäjän salainen avain/salasana.
Ayakaleaf Pro tarvitsee kuhunkin buckettiin vain pienen joukon käyttöoikeuksia:
  • objektin luominen
  • objektin hakeminen
  • objektin poistaminen
  • bucketin listaaminen

Käyttöoikeuskäytännöt

Filestore-käyttäjän käytäntö voisi näyttää tältä:
History-käyttäjän käytäntö voisi näyttää tältä:

Muuttujien yleiskatsaus

AWS S3:a käytettäessä

Itse isännöityä vaihtoehtoa käytettäessä

MINIO-määritys

MINIO_ROOT_USER ja MINIO_ROOT_PASSWORD ovat MINIO-instanssin pääkäyttäjän tunnistetiedot.
Noudata virallista dokumentaatiota hankkiaksesi mc-työkalun.
Viimeksi muokattu 21. marraskuuta 2026