# kio-s3

## Inleiding

KIO S3 is een KIO-worker waarmee u bestanden die zijn opgeslagen in Amazon S3 en S3-compatibele opslagservices (zoals Cloudflare R2, DigitalOcean Spaces, MinIO en andere) rechtstreeks vanuit Dolphin en andere KDE-applicaties kunt bekijken en beheren.

Met KIO S3, kunt u:

- Blader door buckets en mappen.

- Bestanden up- en downloaden

- Bestanden en mappen kopiëren, hernoemen en verwijderen

- Mappen aanmaken binnen buckets

- Tegelijkertijd verbinding maken met meerdere S3-compatibele services met behulp van benoemde profielen

## Profielen configureren

KIO S3 ondersteunt het verbinden met meerdere S3-compatibele opslagservices via benoemde profielen. Elk profiel slaat de verbindingsinstellingen voor één service op. U kunt profielen beheren in Systeeminstellingen Netwerk S3-backends.

### Een profiel toevoegen

Klik op de knop Profiel toevoegen... en vul de volgende velden in:

Naam

- Een beschrijvende naam voor dit profiel (verplicht), bijvoorbeeld `Mijn cloudopslag`.

Eindpunt-URL

- De URL van de S3-compatibele service, bijvoorbeeld `https://s3.example.com`. Laat dit veld leeg om het standaard Amazon S3-eindpunt te gebruiken.

Regio

- De opslagregio, bijvoorbeeld `us-east-1` of `auto`. Laat dit veld leeg om de regio uit uw AWS-configuratie te gebruiken.

AWS-profiel

- De naam van het credentials-profiel uit `~/.aws/credentials`. Als dit veld leeg wordt gelaten, wordt de profiel-ID gebruikt als de naam van het credentials-profiel.

Gebruik pad-stijl S3 URL's

- Schakel dit in voor services die geen ondersteuning bieden voor virtueel gehoste adressering, zoals MinIO of bepaalde Ceph-implementaties. De meeste services, waaronder Amazon S3 en Cloudflare R2, hebben dit niet nodig.

Nadat u een profiel hebt toegevoegd, klik je op Toepassen om op te slaan. Het nieuwe profiel verschijnt als een snelkoppeling in het Dolphin-paneel Plaatsen.

### Profielen bewerken en verwijderen

Elk profiel in de lijst heeft een bewerkings- en een verwijderingsoptie. Bij het bewerken wordt hetzelfde dialoogvenster geopend, maar dan met de huidige waarden al ingevuld. Bij het verwijderen wordt om bevestiging gevraagd voordat het profiel wordt verwijderd. Vergeet niet op Toepassen te klikken om uw wijzigingen op te slaan.

## AWS-credentials

KIO S3 gebruikt de standaard AWS-referentieketen om te authenticeren met S3-services. De referenties worden gelezen uit `~/.aws/credentials`, waarin meerdere benoemde profielen kunnen worden opgeslagen:

    [default]
    aws_access_key_id = UW_SLEUTEL
    aws_secret_access_key = UW_GEHEIM

    [mijncloud]
    aws_access_key_id = UW_CLOUD_SLEUTEL
    aws_secret_access_key = UW_CLOUD_GEHEIM

Elk KIO S3-profiel gebruikt het veld AWS-profiel om te selecteren welke referentiesectie moet worden gebruikt. Een profiel met AWS-profiel ingesteld op `mijncloud` zal bijvoorbeeld de referenties uit de sectie `[mijncloud]` hierboven gebruiken.

Als er geen profielen zijn geconfigureerd, gebruikt KIO S3 de standaard AWS-referentieketen, die omgevingsvariabelen (`AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`), de `[default]`-sectie in `~/.aws/credentials` en EC2-instantierollen omvat.

U kunt de regio optioneel instellen met `~/.aws/config`:

    [default]
    region = eu-west-1

    [profile mijncloud]
    region = auto

In `~/.aws/config` gebruiken benoemde profielen het voorvoegsel `profile` (bijv. `[profile mijncloud]`), terwijl in `~/.aws/credentials` het voorvoegsel niet wordt gebruikt (bijv. `[mijncloud]`). Dit is een conventie van de AWS SDK.

## URL-schema

KIO S3 gebruikt het URL-schema `s3://`. U kunt deze URL's rechtstreeks in de adresbalk van Dolphin typen of ze gebruiken met commandoregelhulpmiddelen zoals `kioclient`.

`s3://`

- Toont een lijst van alle buckets die beschikbaar zijn met de standaard AWS-referenties.

`s3://`mijnbucket`/`

- Geeft een overzicht van de inhoud van `mijnbucket`.

`s3://`mijnbucket`/`pad/naar/bestand.txt``

- Geeft toegang tot een specifiek bestand in de bucket.

`s3://@`profiel`/`

- Toont een lijst van alle buckets die beschikbaar zijn op het opgegeven profiel.

`s3://`mijnbucket`@`profiel`/`

- Toont de inhoud van `mijnbucket` op het genoemde profiel.

`s3://`mijnbucket`@`profiel`/`pad/naar/bestand.txt``

- Geeft toegang tot een specifiek bestand op het opgegeven profiel.

Wanneer u een profiel toevoegt in Systeeminstellingen, wordt er automatisch een snelkoppeling aangemaakt in het Dolphin-paneel 'Plaatsen'. U kunt er eenvoudig op klikken om de buckets van dat profiel te bekijken.

## Bestanden bekijken

Open Dolphin en typ `s3://` in de adresbalk om uw S3-buckets te bekijken. Klik op een bucket om de inhoud ervan te bekijken. Mappen en bestanden worden weergegeven zoals op een lokaal bestandssysteem.

Om een ​​specifiek profiel te bekijken, typt u `s3://@`profile`/` of klikt u op de profielsnelkoppeling in het paneel 'Plaatsen'.

De navigatie werkt zoals verwacht: u kunt de broodkruimel-balk, de terug- en vooruitknoppen en de locatiebalk gebruiken. U kunt S3-locaties ook in nieuwe tabbladen openen.

## Bestandsoperaties

### Bestanden uploaden

Sleep bestanden vanaf uw lokale bestandssysteem naar een S3-map in Dolphin. U kunt ook kopiëren en plakken. Grote bestanden worden automatisch geüpload met behulp van multipart-upload om overmatig geheugengebruik te voorkomen.

### Bestanden downloaden

Sleep bestanden vanuit een S3-map naar een lokale map, of gebruik kopiëren en plakken. U kunt S3-bestanden ook rechtstreeks in toepassingen openen — het bestand wordt dan gedownload naar een tijdelijke locatie en geopend.

### Kopiëren

U kunt bestanden binnen dezelfde S3-service kopiëren met behulp van kopiëren en plakken of slepen en loslaten. Het kopiëren gebeurt aan de serverzijde, dus het is niet nodig om het bestand te downloaden en opnieuw te uploaden.

### Hernoemen

Druk op F2 in Dolphin om een bestand of map te hernoemen. Aangezien S3 geen ingebouwde hernoemfunctie heeft, voert KIO S3 een serverzijdige kopie uit naar de nieuwe naam en verwijdert vervolgens het origineel. Voor mappen worden alle bestanden in de map afzonderlijk gekopieerd en verwijderd.

### Verwijderen

Selecteer bestanden of mappen en druk op Del. Bij het verwijderen van een map worden alle bestanden en submappen daarin recursief verwijderd.

### Mappen aanmaken

Druk op F10 of gebruik Nieuwe map maken Map... om een ​​nieuwe map te maken in een bucket.

## Werken met meerdere profielen

Als u meerdere S3-compatibele services gebruikt (bijvoorbeeld een voor back-ups en een andere voor website-bezittingen), kunt u voor elk een profiel configureren en ertussen schakelen zonder configuratiebestanden of omgevingsvariabelen te wijzigen.

Elk profiel verschijnt als een aparte snelkoppeling in het paneel 'Plaatsen' van de toepassing Dolphin. Door op een profielsnelkoppeling te klikken, worden de buckets weergegeven die beschikbaar zijn op die service. Alle bewerkingen (uploaden, downloaden, kopiëren, hernoemen, verwijderen) werken onafhankelijk van elkaar binnen elk profiel.

Het kopiëren of hernoemen van bestanden tussen verschillende profielen wordt niet ondersteund. Kopiëren in de S3-server werkt alleen binnen één service. Om bestanden tussen profielen te verplaatsen, kopieert u ze eerst naar een lokale map en uploadt u ze vervolgens naar het andere profiel.

## Bekende beperkingen

- Het aanmaken en verwijderen van buckets wordt niet ondersteund. Gebruik de webconsole of CLI-tools van de provider om buckets te beheren.

- De bestandsrechten die in Dolphin worden weergegeven, zijn slechts cosmetisch. S3 gebruikt een eigen toegangscontrolemodel (IAM-beleid en bucketbeleid), dat niet overeenkomt met Unix-rechten.