> ## Documentation Index > Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # S3 Det här dokumentet beskriver hur S3 konfigureras i Server CE och Ayakaleaf Pro. En [separat guide](/sv/on-premises/maintenance/s3-migration) beskriver hur befintliga data migreras till S3-kompatibel lagring. Om du driftsätter Ayakaleaf Pro med [s3.md](/sv/on-premises/configuration/overleaf-toolkit/s3 "mention")-lagring aktiverad, är då de data som lagras i S3 krypterade? *Nej.* Data krypteras inte. Alla historikdelar (chunks), mallfiler, PDF-filer och andra filer lagras i klartext. Om du använder en extern S3-lagringsleverantör från tredje part bör du vara mycket uppmärksam på datasäkerhet och integritet. ## När du bör överväga att använda S3 för datalagring För instanser med färre än 1000 platser rekommenderar vi lokal disklagring med regelbundna [konsekventa säkerhetskopior](https://docs.overleaf.com/on-premises/maintenance/data-and-backups#performing-a-consistent-backup). För större instanser med fler än 1000 platser som når gränserna för sin lokala lagring (storlek eller genomströmning) rekommenderar vi en S3-kompatibel objektlagringsbackend framför andra nätverksbaserade lagringslösningar som NFS. ## Alternativ för S3-kompatibel objektlagring Här är de populäraste alternativen för S3-kompatibel objektlagring: * [AWS S3](https://aws.amazon.com/s3/), hanterad tjänst; vi föreslår AWS S3 när du kör Overleaf CE/Server Pro på AWS * [MINIO](https://min.io/), egen drift * [Ceph](https://ceph.io/en/), egen drift * Andra hostingleverantörer erbjuder också någon form av hanterad S3-kompatibel objektlagring. Om du redan kör Overleaf CE/Server Pro hos en sådan leverantör kan det vara bättre att använda den än att driva en egen. ## Latens att tänka på vid val av S3-kompatibel objektlagring Latensen mellan Server CE/Server Pro-instansen och din S3-kompatibla objektlagring bidrar i hög grad till hur lång tid migreringen tar. Latensen påverkar också prestandan vid filuppladdning i Server CE/Server Pro, och långsamma filnedladdningar kan dessutom ha stor inverkan på PDF-kompileringstiderna. Vi föreslår att du minimerar det geografiska avståndet mellan din Server CE/Server Pro-instans och den S3-kompatibla objektlagringen. I en hanterad miljö innebär det att skapa en bucket i samma region, och för en lokal lösning att köra båda på samma campus. ## Konfiguration av S3 Vi behöver fyra "buckets" och två användarkonton med begränsad behörighet. `overleaf-user-files` och `OVERLEAF_FILESTORE_USER_FILES_BUCKET_NAME` behövs endast före v6. Buckets ska **inte** vara offentligt åtkomliga
BucketAnvändningTjänstTidigare i `/var/lib/overleaf/data`
`overleaf-user-files`användarfiler i projektfilestore`user_files`
`overleaf-template-files`mallfilerfilestore`template_files`
`overleaf-project-blobs`blobbar för projekthistorikhistory och skrivskyddad filestore`history/overleaf-project-blobs`
`overleaf-chunks`historikdelar (chunks)history`history/overleaf-chunks`
Du kan vilja eller behöva välja andra namn; se i så fall till att använda dina egna buckets i alla kommandon. I det följande används platshållare för de faktiska inloggningsuppgifterna:
MiljövariabelBeskrivning
`OVERLEAF_FILESTORE_S3_ACCESS_KEY_ID`Åtkomstnyckeln/användarnamnet för filestore-tjänstens begränsade användare.
`OVERLEAF_FILESTORE_S3_SECRET_ACCESS_KEY`Den hemliga nyckeln/lösenordet för filestore-tjänstens begränsade användare.
`OVERLEAF_HISTORY_S3_ACCESS_KEY_ID`Åtkomstnyckeln/användarnamnet för history-tjänstens begränsade användare.
`OVERLEAF_HISTORY_S3_SECRET_ACCESS_KEY`Den hemliga nyckeln/lösenordet för history-tjänstens begränsade användare.
Server CE och Server Pro behöver endast ett fåtal behörigheter för varje bucket: * skapa objekt * hämta objekt * ta bort objekt * lista bucket ### Åtkomstpolicyer Så här kan en policy för filestore-användaren se ut: ```json theme={null} { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "s3:ListBucket" ], "Resource": "arn:aws:s3:::overleaf-user-files" }, { "Effect": "Allow", "Action": [ "s3:PutObject", "s3:GetObject", "s3:DeleteObject" ], "Resource": "arn:aws:s3:::overleaf-user-files/*" }, { "Effect": "Allow", "Action": [ "s3:GetObject" ], "Resource": "arn:aws:s3:::overleaf-project-blobs/*" }, { "Effect": "Allow", "Action": [ "s3:ListBucket" ], "Resource": "arn:aws:s3:::overleaf-template-files" }, { "Effect": "Allow", "Action": [ "s3:PutObject", "s3:GetObject", "s3:DeleteObject" ], "Resource": "arn:aws:s3:::overleaf-template-files/*" } ] } ``` Så här kan en policy för history-användaren se ut: ```json theme={null} { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "s3:ListBucket" ], "Resource": "arn:aws:s3:::overleaf-project-blobs" }, { "Effect": "Allow", "Action": [ "s3:PutObject", "s3:GetObject", "s3:DeleteObject" ], "Resource": "arn:aws:s3:::overleaf-project-blobs/*" }, { "Effect": "Allow", "Action": [ "s3:ListBucket" ], "Resource": "arn:aws:s3:::overleaf-chunks" }, { "Effect": "Allow", "Action": [ "s3:PutObject", "s3:GetObject", "s3:DeleteObject" ], "Resource": "arn:aws:s3:::overleaf-chunks/*" } ] } ``` ### Översikt över variabler #### Vid användning av AWS S3 ```bash theme={null} # Enable S3 backend for filestore OVERLEAF_FILESTORE_BACKEND=s3 # Bucket name for project files OVERLEAF_FILESTORE_USER_FILES_BUCKET_NAME=overleaf-user-files # Bucket name for template files OVERLEAF_FILESTORE_TEMPLATE_FILES_BUCKET_NAME=overleaf-template-files # Key for filestore user OVERLEAF_FILESTORE_S3_ACCESS_KEY_ID=... # Secret for filestore user OVERLEAF_FILESTORE_S3_SECRET_ACCESS_KEY=... # Bucket region you picked when creating the buckets. OVERLEAF_FILESTORE_S3_REGION="" # Enable S3 backend for history OVERLEAF_HISTORY_BACKEND=s3 # Bucket name for project history blobs OVERLEAF_HISTORY_PROJECT_BLOBS_BUCKET=overleaf-project-blobs # Bucket name for history chunks OVERLEAF_HISTORY_CHUNKS_BUCKET=overleaf-chunks # Key for history user OVERLEAF_HISTORY_S3_ACCESS_KEY_ID=... # Secret for history user OVERLEAF_HISTORY_S3_SECRET_ACCESS_KEY=... # Bucket region you picked when creating the buckets. OVERLEAF_HISTORY_S3_REGION="" ``` #### Vid användning av ett alternativ i egen drift ```bash theme={null} # Enable S3 backend for filestore OVERLEAF_FILESTORE_BACKEND=s3 # Bucket name for project files OVERLEAF_FILESTORE_USER_FILES_BUCKET_NAME=overleaf-user-files # Bucket name for template files OVERLEAF_FILESTORE_TEMPLATE_FILES_BUCKET_NAME=overleaf-template-files # Key for filestore user OVERLEAF_FILESTORE_S3_ACCESS_KEY_ID=... # Secret for filestore user OVERLEAF_FILESTORE_S3_SECRET_ACCESS_KEY=... # S3 provider endpoint OVERLEAF_FILESTORE_S3_ENDPOINT=http://10.10.10.10:9000 # Path style addressing of buckets. Most likely you need to set this to "true". OVERLEAF_FILESTORE_S3_PATH_STYLE="true" # Bucket region. Most likely you do not need to configure this. OVERLEAF_FILESTORE_S3_REGION="" # Enable S3 backend for history OVERLEAF_HISTORY_BACKEND=s3 # Bucket name for project history blobs OVERLEAF_HISTORY_PROJECT_BLOBS_BUCKET=overleaf-project-blobs # Bucket name for history chunks OVERLEAF_HISTORY_CHUNKS_BUCKET=overleaf-chunks # Key for history user OVERLEAF_HISTORY_S3_ACCESS_KEY_ID=... # Secret for history user OVERLEAF_HISTORY_S3_SECRET_ACCESS_KEY=... # S3 provider endpoint OVERLEAF_HISTORY_S3_ENDPOINT=http://10.10.10.10:9000 # Path style addressing of buckets. Most likely you need to set this to "true". OVERLEAF_HISTORY_S3_PATH_STYLE="true" # Bucket region. Most likely you do not need to configure this. OVERLEAF_HISTORY_S3_REGION="" ``` ### Konfiguration av MINIO `MINIO_ROOT_USER` och `MINIO_ROOT_PASSWORD` är root-inloggningsuppgifterna för MINIO-instansen. Följ den [officiella dokumentationen](https://min.io/docs/minio/linux/reference/minio-mc.html#quickstart) för att skaffa en kopia av `mc`. ```bash theme={null} mc alias set s3 http://10.10.10.10:9000 MINIO_ROOT_USER MINIO_ROOT_PASSWORD # Put the contents of the policies from the previous section in the # respective json file policy-filestore.json and policy-history.json. # Reminder: Replace the bucket names and credentials accordingly. # filestore buckets, user and policy mc mb --ignore-existing s3/overleaf-user-files mc mb --ignore-existing s3/overleaf-template-files mc admin user add s3 \ OVERLEAF_FILESTORE_S3_ACCESS_KEY_ID \ OVERLEAF_FILESTORE_S3_SECRET_ACCESS_KEY mc admin policy create s3 overleaf-filestore policy-filestore.json mc admin policy attach s3 overleaf-filestore \ --user=OVERLEAF_FILESTORE_S3_ACCESS_KEY_ID # history buckets, user and policy mc mb --ignore-existing s3/overleaf-project-blobs mc mb --ignore-existing s3/overleaf-chunks mc admin user add s3 \ OVERLEAF_HISTORY_S3_ACCESS_KEY_ID \ OVERLEAF_HISTORY_S3_SECRET_ACCESS_KEY mc admin policy create s3 overleaf-history policy-history.json mc admin policy attach s3 overleaf-history \ --user=OVERLEAF_HISTORY_S3_ACCESS_KEY_ID ``` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.