Circa 5 minuti
Come caricare file su MinIO e condividere link
MinIO ti permette di gestire uno storage compatibile con S3 sul tuo server. Il preset MinIO di Aktar usa l’indirizzamento in stile percorso (https://server/bucket/file), che è quello che si aspetta la maggior parte delle installazioni self-hosted.
Cosa ti serve
- Un server MinIO raggiungibile dal tuo Mac, idealmente via HTTPS
- Il MinIO Client (mc) o l’accesso alla MinIO Console
- Aktar installata sul tuo Mac
Passo passo
- 1
Crea un bucket
Con il MinIO Client e un alias per il tuo server:
mc mb myminio/screenshots - 2
Consenti i download anonimi
Assegna al bucket una policy di lettura pubblica, così i link condivisi si aprono per chiunque:
mc anonymous set download myminio/screenshots - 3
Crea una access key
Nella MinIO Console, crea una access key (o un utente dedicato con accesso in lettura e scrittura al bucket) e copia l’Access Key e la Secret Key.
- 4
Aggiungi la destinazione in Aktar
In Impostazioni → Destinazioni → Aggiungi destinazione, scegli MinIO e inserisci i valori qui sotto. Dato che MinIO usa URL in stile percorso, l’URL di base pubblico include il nome del bucket.
- 5
Verifica e salva
Clicca Verifica connessione, poi Salva.
Impostazioni in Aktar
Inserisci questi valori in Impostazioni → Destinazioni → Aggiungi destinazione. I nomi dei campi corrispondono a quelli dell’app.
| Campo | Valore di esempio |
|---|---|
| Provider | MinIO |
| Endpoint | https://minio.example.comL’indirizzo dell’API di MinIO (spesso sulla porta 9000). |
| Regione | us-east-1La regione configurata sul tuo server; us-east-1 se non ne hai mai impostata una. |
| ID chiave di accesso | aktar |
| Chiave di accesso segreta | •••••••• |
| Bucket | screenshots |
| URL di base pubblico | https://minio.example.com/screenshotsInclude il nome del bucket. |
Suggerimenti
- Metti MinIO dietro un reverse proxy con HTTPS, così i link funzionano in ogni browser e app di chat.
- Per caricare basta che il tuo Mac raggiunga il server (va bene una VPN o la rete locale), ma per i link condivisi l’URL pubblico deve essere raggiungibile da chi li apre.
Risoluzione dei problemi
Verifica connessione segnala un errore di regione o di firma
Imposta la Regione su quella configurata sul tuo server MinIO. Se non ne hai mai configurata una, usa us-east-1.
I link restituiscono 403
Il bucket non ha una policy di lettura anonima, oppure all’URL di base pubblico manca il nome del bucket. Vedi errori Access Denied.
Sei ancora bloccato?Consulta le FAQ o chiedi su GitHub.