Come creare il tuo GitHub Gist usando Opengist

Opengist è un server Github Gist leggero e auto-ospitato per Linux. A differenza di altre soluzioni, sfrutta le funzionalità specifiche di Git per caricare, esplorare e rivedere rapidamente i file di testo. Qui, ti mostriamo come installare e ospitare il tuo server Opengist su Ubuntu Linux.

Perché ospitare il tuo server Gist con Opengist

Uno dei maggiori punti di forza di Opengist è che è un servizio simile a Pastebin che usa Git per il suo backend. Questo rende Opengist facile da prendere e ospitare su Linux per chiunque abbia già familiarità con servizi simili a Git con supporto Gist come Github e Gitlab.

Un altro punto di forza di Opengist è la sua capacità di tracciare gli incollamenti specifici dell’utente e di fornire controlli per gestire la visibilità degli incollamenti.

Infine, Opengist non richiede overhead per funzionare. La sua configurazione predefinita si basa solo su un singolo contenitore Docker e un archivio dati, che puoi impostare come volume interno o come mount di bind al tuo file system. Ciò significa che puoi eseguire Opengist anche su sistemi di fascia bassa senza molte risorse di riserva.

Preparazione del sistema per Opengist

Presupposto: questo tutorial è stato eseguito su un VPS Ubuntu 24.04 con almeno 2 GB di RAM e 25 GB di spazio su disco. Si presume inoltre che tu possieda attualmente un nome di dominio e che tu possa aggiungervi un record DNS “A”.

Il primo passo per distribuire Opengist sulla tua macchina è ottenere e installare Docker, Nginx e Certbot. Per farlo, prima recupera la chiave di firma per il progetto Docker:

Crea un nuovo file repository in “/etc/apt/sources.list.d/”:

Incolla la seguente riga di codice all’interno del tuo nuovo file repository:

Salva il file del repository, quindi aggiorna e potenzia tutti i pacchetti esistenti nel tuo sistema:

Recupera il binario Docker insieme al suo plugin Compose e alle dipendenze:

Assicurati che il pacchetto snap “core” sia presente nel tuo sistema:

Installare il pacchetto snap Certbot dalla Electronic Frontier Foundation (EFF):

Installazione ed esecuzione di Opengist

Crea una nuova cartella per Opengist nella directory home dell’utente corrente, quindi accedi al suo interno:

Utilizza il tuo editor di testo preferito per creare un nuovo “docker-compose.yml” all’interno della tua cartella Opengist:

Incolla il seguente blocco di codice all’interno del tuo nuovo file di composizione:

Salva il file “docker-compose.yml”, quindi esegui il seguente comando per compilare e installare Opengist sul tuo sistema:

Verifica che Opengist sia attivo e funzionante elencando tutti i contenitori Docker attivi sulla tua macchina:

Creazione di un proxy inverso SSL per Opengist

A questo punto, hai un’istanza Opengist parzialmente funzionante in esecuzione sulla porta 6157. Per utilizzarla in modo sicuro su Internet, devi passarla attraverso un proxy inverso SSL utilizzando Nginx.

Per farlo, crea un nuovo record DNS “A” sul tuo nome di dominio che punti all’indirizzo IPv4 della tua macchina Opengist.

Torna al terminale del tuo server, quindi crea un nuovo file di configurazione del sito per Opengist:

Incolla il seguente blocco di codice all’interno del tuo nuovo file di configurazione:

Salva il file di configurazione del tuo sito, quindi crea un collegamento simbolico da “/etc/nginx/sites-available/” a “/etc/nginx/sites-enabled/”:

Verifica che la configurazione Nginx funzioni correttamente, quindi avvia il server web utilizzando systemctl:

Registra il tuo sistema Opengist utilizzando il tuo indirizzo email all’EFF:

Genera un nuovo certificato SSL per il tuo nome di dominio utilizzando Certbot:

Verifica che il tuo sito web sia accessibile tramite Internet aprendo un browser web e navigando fino al tuo nome di dominio.

Creazione del tuo primo Gist con Opengist

Di default, Opengist non fornisce un account amministratore per la tua istanza personale. Per crearne uno, devi prima registrarlo tramite l’interfaccia web della tua istanza.

Per prima cosa accedi al sottodominio di Opengist, quindi clicca sul pulsante Registra nell’angolo in alto a destra della pagina.

Inserisci un nome utente e una password per il tuo account amministratore, quindi clicca su Registrati per crearlo.

Facendo questo, accederai automaticamente all’interfaccia di Opengist e ti verrà chiesto di creare la tua prima pagina gist. Digita o incolla un frammento di testo nella casella di input, quindi fai clic su Create Public Gist per generare il tuo primo gist.

Ora puoi condividere il tuo nuovo file gist con chiunque copiando il collegamento dalla barra degli indirizzi del tuo browser e inviandolo al destinatario.

Creazione e aggiornamento di un Gist tramite SSH

Oltre all’interfaccia web, Opengist supporta anche l’invio e la modifica di gist direttamente dal client Git CLI. Questo è utile se stai lavorando su una sessione solo terminale e non hai accesso a un’interfaccia grafica.

Crea una nuova cartella per la tua pagina gist nella directory home del tuo utente:

Copia o crea un nuovo file di testo contenente i tuoi dati gist, quindi inizializza un nuovo repository Git all’interno della tua nuova cartella:

Aggiungi i file della tua cartella al tuo nuovo repository Git, quindi crea il suo primo commit:

Imposta l’endpoint remoto per il tuo repository Git locale sul tuo server Opengist:

Invia il tuo nuovo repository al tuo server Opengist:

Inserisci le tue credenziali Opengist, quindi premi Enterper confermare il comando push.

Copia il comando Git che Opengist restituisce nella sessione del terminale, quindi eseguilo per impostare la nuova origine remota per il tuo repository.

Verifica di aver salvato correttamente il tuo gist guardando l’interfaccia web del tuo server.

Ospitare il tuo server Opengist su Linux e creare pagine gist simili a Github sono solo alcune delle cose che puoi fare con software self-hostable. Esplora di più sull’auto-hosting esaminando alcune delle migliori alternative self-hosted a Github oggi.

Credito immagine: Joan Gamell tramite Unsplash . Tutte le modifiche e gli screenshot sono di Ramces Red.