Cos'è Limo?
Limo è un leggero server di caricamento file self-hosted progettato per rendere la condivisione di file sul web semplice e conveniente.
Fornisce un endpoint rivolto al Web in cui gli utenti e le applicazioni possono caricare file e renderli disponibili tramite collegamenti condivisibili. Invece di affidarsi a piattaforme esterne di condivisione di file, Limo consente alle organizzazioni e agli individui di gestire la propria infrastruttura di caricamento dei file.
Limo si concentra sulla fornitura di un flusso di lavoro di condivisione dei file semplice senza la complessità di un cloud storage completo o di una piattaforma di collaborazione dei documenti.
La sua architettura leggera e la distribuzione basata su Docker lo rendono adatto per server personali, laboratori domestici, ambienti di sviluppo e infrastrutture che richiedono un servizio di caricamento file dedicato.
Storia di Limo
Limo è un server di upload di file open-source sviluppato da Gabe Cook (gabe565).
Il progetto è implementato in Go e fornisce un'applicazione server dedicata per la gestione dei caricamenti di file e dei dati associati.
La sua architettura separa il server di upload dal suo database di supporto, consentendo di gestire in modo indipendente i file e le informazioni sulle applicazioni.
Il progetto fornisce il supporto alla distribuzione di Docker e un grafico Helm per gli ambienti Kubernetes.
Caratteristiche principali di Limo
Limo fornisce un insieme mirato di funzionalità per la ricezione e la condivisione di file.
- Caricamento file: Accetta file tramite un endpoint di caricamento rivolto al Web.
- Condivisione file: Rendi disponibili i file caricati tramite link condivisibili.
- Infrastruttura self-hosted: Ospita il tuo servizio di caricamento file senza dipendere da piattaforme esterne di condivisione file.
- Architettura leggera: Costruito con Go per una distribuzione lato server compatta.
- Supporto Docker: Distribuisci l'applicazione utilizzando Docker e Docker Compose.
- Archiviazione persistente: Archivia i file caricati in una directory di dati persistente.
- Integrazione database: Utilizzare PostgreSQL per mantenere i dati delle applicazioni.
- Supporto Kubernetes: Distribuisci Limo in ambienti Kubernetes utilizzando un grafico Helm disponibile.
- Compatibilità con proxy inverso: Esponi il servizio tramite un proxy inverso per l'accesso HTTPS e a domini personalizzati.
- Distribuzione indipendente: Esegui Limo come servizio dedicato insieme ad altre applicazioni self-hosted.
Casi di utilizzo
Limo è adatto ad ambienti che richiedono un servizio di upload di file semplice e centralizzato.
I casi d'uso comuni includono:
- Condivisione file personale: Carica i file e condividili tramite link diretti.
- Flussi di lavoro di sviluppo: Fornire un endpoint per le applicazioni che devono caricare e distribuire file.
- Infrastruttura Homelab: Ospitare un servizio di condivisione file dedicato su infrastruttura personale.
- Distribuzione interna dei file: Consente alle applicazioni interne e agli utenti di scambiare file.
- Consegna temporanea di file: Fornire un modo conveniente per distribuire i file senza stabilire una piattaforma completa di gestione dei documenti.
- Integrazioni di applicazioni: Utilizza un servizio di caricamento centralizzato come parte di flussi di lavoro automatizzati.
- Servizi self-hosted: Fornire funzionalità di caricamento dei file ad altre applicazioni ospitate sulla stessa infrastruttura.
Vantaggi di Limo
- Funzionalità di caricamento file semplice e focalizzata
- Infrastruttura di condivisione file self-hosted
- Link condivisibili per i file caricati
- Implementazione leggera basata su Go
- Supporto per Docker e Docker Compose
- Archiviazione persistente dei file
- Integrazione con PostgreSQL
- Supporto alla distribuzione di Kubernetes
- Adatto per flussi di lavoro di condivisione di file personali e interni
- Maggiore controllo sui file caricati e sull'infrastruttura di hosting
Come installare Limo
Per installare Limo tramite Esadax, segui questi passaggi:
- Acquista l'applicazione tramite Esadax.
- Dopo l'acquisto, ti verrà richiesto di fornire i parametri di configurazione richiesti.
- Inserire i valori di configurazione richiesti.
- Configurare la connessione al database se richiesto dal pacchetto di distribuzione.
- Configurare l'archiviazione persistente per i file caricati.
- Fare clic su Distribuisci per avviare l'applicazione.
- Accedi al servizio Limo distribuito tramite l'URL dell'applicazione assegnato.
- Verificare che l'endpoint di caricamento sia accessibile.
- Carica un file di prova e verifica che il link di condivisione generato funzioni.
- Inizia a utilizzare Limo per il caricamento e la condivisione di file.
Una volta distribuito, Limo fornisce un endpoint centralizzato per ricevere file e renderli disponibili tramite link.
Gestione caricamento file
Limo fornisce un server dedicato per la ricezione dei file caricati.
L'applicazione è progettata per gestire i flussi di lavoro di condivisione dei file senza richiedere una piattaforma di cloud storage completa.
Il flusso di lavoro generale consiste in:
- Un utente o un'applicazione esterna invia un file al server Limo.
- Il server riceve ed elabora il file caricato.
- Il file viene memorizzato nella directory dati configurata.
- Le informazioni sull'applicazione corrispondente vengono mantenute nel database.
- Il file caricato diventa accessibile attraverso il suo link di condivisione generato.
- Il link può essere condiviso con altri utenti o integrato in applicazioni esterne.
Questo approccio rende Limo adatto per applicazioni che necessitano di una posizione centralizzata per ricevere file e distribuirli attraverso URL accessibili.
Condivisione e accesso ai file
Uno degli scopi primari di Limo è quello di rendere i file caricati disponibili tramite link.
Una volta che un file è stato caricato, il suo link di condivisione può essere fornito ad altri utenti o consumato da applicazioni esterne.
Questo è utile per distribuire:
- Documenti e relazioni
- Immagini e file multimediali
- Pacchetti di software
- Archivi e file compressi
- Artefatti di sviluppo
- Altri tipi di file supportati
Il servizio può essere esposto tramite un dominio personalizzato utilizzando un proxy inverso.
Quando si rende Limo accessibile pubblicamente, trattare i collegamenti generati come risorse accessibili esternamente a meno che non siano configurati controlli di accesso aggiuntivi nella distribuzione.
Docker e distribuzione
Limo fornisce una distribuzione basata su Docker utilizzando servizi di applicazione e database separati.
La configurazione upstream di Docker Compose include:
- Limo Server: Esegue l'applicazione di caricamento dei file.
- PostgreSQL: Memorizza informazioni relative all'applicazione.
- Volume dati persistente: Memorizza i file caricati e i dati delle applicazioni.
L'immagine ufficiale di Docker è disponibile all'indirizzo:
ghcr.io/gabe565/limo
L'applicazione è in ascolto sulla porta 80 per impostazione predefinita e utilizza /data come directory dei dati dell'applicazione.
Docker Compose consente di distribuire l'applicazione e il relativo database insieme mantenendo lo storage persistente.
Database e archiviazione
Limo utilizza PostgreSQL per i dati delle applicazioni e una directory di filesystem dedicata per l'archiviazione persistente delle applicazioni.
La configurazione predefinita di Docker Compose utilizza PostgreSQL 15 e crea un volume persistente per il database.
Le principali sedi di stoccaggio sono:
| Percorso | Descrizione |
|---|---|
/data |
Directory dei dati dell'applicazione utilizzata da Limo. |
| Volume di dati PostgreSQL | Memorizza file di database e metadati dell'applicazione. |
Per distribuzioni affidabili:
- Utilizzare l'archiviazione persistente per
/data. - Configurare l'archiviazione del database persistente.
- Esegui regolarmente il backup dei file caricati.
- Backup di PostgreSQL in modo indipendente.
- Assicurarsi che l'applicazione abbia le autorizzazioni appropriate per il filesystem.
- Monitorare la capacità di archiviazione disponibile.
I file delle applicazioni e le informazioni del database devono essere entrambi inclusi nelle procedure di backup.
Sicurezza / amministrazione / configurazione
I servizi di caricamento file devono essere distribuiti con controlli di sicurezza appropriati perché accettano contenuti forniti esternamente.
Quando si espone Limo attraverso un dominio pubblico, considerare le seguenti pratiche:
- Configurare HTTPS utilizzando un proxy inverso.
- Limitare l'accesso al servizio quando non sono richiesti caricamenti pubblici.
- Applicare i limiti di dimensione di caricamento appropriati al proxy inverso.
- Monitorare il consumo del disco e lo spazio di archiviazione disponibile.
- Limitare l'accesso al database PostgreSQL.
- Utilizzare credenziali di database forti e univoche.
- Evitare di esporre le porte del database pubblicamente.
- Esaminare il contenuto caricato prima di utilizzarlo in altre applicazioni.
- Mantenere l'applicazione e il database aggiornati.
- Esegui regolarmente il backup dei file caricati e del contenuto del database.
Il file Docker Compose upstream include credenziali di database di esempio destinate alla configurazione iniziale della distribuzione. Sostituire questi valori con credenziali sicure prima di utilizzare il servizio in produzione.
Non dare per scontato che i file caricati siano privati o protetti da autenticazione, a meno che la distribuzione non fornisca e configuri esplicitamente tali controlli.
Migliori pratiche per Limo
- Utilizzare un dominio o sottodominio dedicato per i caricamenti di file.
- Abilita HTTPS per l'accesso esterno.
- Configurare l'archiviazione persistente per i file caricati.
- Impostare limiti di dimensione di caricamento appropriati.
- Monitorare il consumo di storage.
- Proteggi le credenziali del database.
- Limitare l'accesso al database ai servizi attendibili.
- Configurare i limiti del proxy inverso in base alle dimensioni dei file previste.
- Eseguire regolarmente il backup dei dati delle applicazioni e di PostgreSQL.
- Evita di esporre file sensibili tramite link di condivisione pubblici.
- Mantenere l'immagine dell'applicazione aggiornata.
- Monitorare i log del server per attività di caricamento impreviste.
Parametri di configurazione
Dopo aver acquistato questa applicazione su Esadax, ti verrà richiesto di fornire i parametri di configurazione richiesti dalla distribuzione.
Esadax aggiunge le variabili fornite al deployment in modo che l'applicazione possa essere lanciata con la configurazione richiesta.
La distribuzione Limo Docker upstream supporta le seguenti variabili di ambiente:
| Parametri | Descrizione |
|---|---|
LIMOD_ADDRESS |
Indirizzo di rete e porta utilizzati dal server Limo. Il valore predefinito è :80. |
LIMOD_DATA_DIR |
Directory utilizzata per i dati dell'applicazione. Il valore predefinito è /data. |
LIMOD_DB_HOST |
Nome host del server di database PostgreSQL. |
LIMOD_DB_USERNAME |
Nome utente usato per connettersi a PostgreSQL. |
LIMOD_DB_PASSWORD |
Password utilizzata per l'autenticazione PostgreSQL. |
LIMOD_DB_DATABASE |
Nome del database PostgreSQL utilizzato da Limo. |
Il servizio PostgreSQL corrispondente può anche richiedere:
| Parametri | Descrizione |
|---|---|
POSTGRES_USER |
Account PostgreSQL creato per l'applicazione. |
POSTGRES_PASSWORD |
Password assegnata all'account PostgreSQL. |
POSTGRES_DB |
Database creato per Limo. |
Le credenziali PostgreSQL configurate per Limo devono corrispondere alle credenziali configurate nel servizio di database.
I parametri di configurazione esatti dipendono dal pacchetto di distribuzione Esadax. Utilizzare i valori presentati durante il processo di acquisto e distribuzione.
Una volta configurati i valori richiesti, fare clic su Distribuisci per avviare Limo.
Proxy inverso e accesso esterno
Limo può essere esposto tramite un proxy inverso per fornire un endpoint HTTPS pubblico.
Un proxy inverso come Nginx, Traefik o Caddy può gestire i certificati TLS e inoltrare le richieste in arrivo all'applicazione Limo.
L'utilizzo di un sottodominio dedicato fornisce un modo conveniente per separare i caricamenti di file da altri servizi ospitati sulla stessa infrastruttura.
Per esempio:
https://files.example.com
Quando si configura un proxy inverso, assicurarsi che i limiti del corpo della richiesta e le impostazioni di timeout supportino le dimensioni dei file previste dagli utenti.
Il servizio PostgreSQL dovrebbe rimanere accessibile solo all'applicazione e all'infrastruttura attendibile.
Conclusione
Limo è un server di caricamento file leggero e self-hosted progettato per semplificare la ricezione e la condivisione di file tramite collegamenti accessibili dal web.
Con la sua implementazione basata su Go, la distribuzione Docker, l'integrazione PostgreSQL e il supporto per lo storage persistente, fornisce una soluzione semplice per le organizzazioni e gli individui che necessitano di un'infrastruttura di caricamento file dedicata.
A differenza delle piattaforme di archiviazione cloud e collaborazione documentale complete, Limo si concentra su uno scopo specifico: accettare file e renderli disponibili tramite collegamenti.
È una scelta pratica per laboratori domestici, ambienti di sviluppo, applicazioni interne e infrastrutture self-hosted che richiedono un semplice endpoint di condivisione file.

