> This page is for Piattaforma, version Versione precedente.
> For other versions, use one of these documentation indexes:
> - V4 (default): https://next.developer.frame.io/platform/v4/llms.txt
> - V4 sperimentale: https://next.developer.frame.io/platform/v4-experimental/llms.txt
> - Versione precedente: https://next.developer.frame.io/platform/v2/llms.txt
> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://next.developer.frame.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://next.developer.frame.io/_mcp/server.
# Utilizzo di ngrok
ngrok è uno strumento facile da usare che consente di creare un tunnel sicuro sul computer locale insieme a un URL pubblico da utilizzare per testare il progetto locale o condividere il lavoro con un cliente o un collega. Puoi configurare HTTP o HTTPS e, data la popolarità di questo strumento, ci sono tantissimi articoli che descrivono diversi modi per risolvere un eventuale problema. Questo articolo spiega un paio di modi semplici per installare ngrok e cosa fare se non riesci a far comunicare l'applicazione web con ngrok.
I nostri amici di ngrok hanno scritto un ottimo articolo dedicato al supporto dei webhook Frame.io tramite ngrok. Dai un'occhiata [qui](https://ngrok.com/docs/integrations/frameio/webhooks).
## Installa ngrok
Puoi utilizzare ngrok in diversi modi
### Usa il programma di installazione ngrok
1. Vai al sito web di ngrok e segui le istruzioni: [https://ngrok.com/download](https://ngrok.com/download)
2. Se desideri le funzionalità offerte dalla connessione di un account, segui queste istruzioni per ottenere un account e un token.
Non è necessario ottenere un account o aggiungere il token, ma ti conviene dare un'occhiata alla pagina di download per vedere se potrebbe esserti utile in qualche modo.
Se usi questo metodo, ngrok viene eseguito dalla posizione in cui lo archivi, a meno che tu non lo renda disponibile in tutto il sistema.
### Installazione con Homebrew
Questo è il mio metodo preferito per installare ngrok. Se hai installato Homebrew, tutto quello che devi fare è digitare `homebrew cask install ngrok` . ngrok viene installato e puoi utilizzarlo da qualsiasi posizione! Soprattutto, non devi digitare `./ngrok` nel terminale all'inizio di ogni comando, puoi semplicemente digitare `ngrok`. Puoi leggere di più su questa opzione [qui](https://gist.github.com/wosephjeber/aa174fb851dfe87e644e).
## Utilizza ngrok
Dopo aver configurato ngrok, scegli una porta (ad esempio `3000`) e avviala dalla riga di comando del terminale con il comando ngrok http `3000`. Non devi obbligatoriamente usare la porta `3000`, ma questa è di quelle usate più comunemente nella configurazione. Se hai configurato ngrok per l'esecuzione da una cartella specifica, devi trovarti nella cartella in cui hai inserito ngrok e utilizzare il comando `./ngrok http 3000`.
Avvia il server in modo che il progetto rimanga in ascolto sulla stessa porta. Potrai accedere al lavoro utilizzando l'indirizzo pubblico fornito da ngrok.
### Risoluzione dei problemi di ngrok con la web app - Barra finale
Un problema che potresti riscontrare con ngrok è l'impossibilità di connetterti al server quando configuri un URL ngrok da utilizzare con la web app. L'aspetto frustrante di questo problema è che ngrok non registra l'invio di alcun contenuto. Puoi aprire localhost:4040 per vedere cosa sta succedendo e non verrà visualizzato nulla. localhost:4040 viene fornito da ngrok per monitorare le richieste in arrivo al server. ngrok sembra abbinare agli indirizzi a /(.*) anziché (/.*)\. Se non includi una barra finale alla fine dell'indirizzo e non vedi nulla negli strumenti di monitoraggio ngrok, il motivo è che ngrok non trova una corrispondenza per l'indirizzo elencato.
Ecco un esempio di aggiunta di una barra finale: `http://something.ngrok.io/` Puoi anche scrivere le applicazioni di esempio per risolverle in un endpoint che include una barra. Ricorda che, affinché l'app Frame.io possa raggiungere il server, devi aggiungere l'endpoint /actions alla fine dell'indirizzo ngrok se l'app di esempio utilizza l'endpoint `/actions`.Ad esempio, se l'indirizzo ngrok è `http://something.ngrok.io`, dovresti fornirlo nella configurazione dell'azione personalizzata come `http://something.ngrok.io/actions`.Questo potrebbe essere diverso per altre applicazioni web, quindi prova varie soluzioni per la fine dell'indirizzo ngrok se non riesci a far funzionare le cose subito.
### Posso usare qualcos'altro oltre a ngrok?Prova Glitch!
Glitch è un'alternativa davvero interessante a ngrok ed è più veloce da configurare. Glitch ti consente di creare un account e creare le tue app utilizzando i loro server con un URL accessibile pubblicamente. Puoi collaborare con altri, rendere il codice pubblico o privato e scegliere tra un'ampia varietà di linguaggi e piattaforme. Consulta [https://glitch.com/create](https://glitch.com/create) per vedere cosa è disponibile. Quando configuri il progetto su Glitch, per alcune applicazioni web si applica il problema della barra finale. Nel caso di Frame.io, quando configuri un'azione personalizzata in [developer.frame.io](/), devi includere la barra finale alla fine dell'URL fornito da Glitch. Non devi aggiungere nient'altro, nemmeno per l'endpoint /actions.
### Esiste qualche risorsa preconfigurata che posso provare subito?
Sì. Se non vuoi usare ngrok o creare il tuo progetto Glitch, abbiamo configurato un'applicazione di esempio che puoi provare qui: [https://frameio-custom-action.glitch.me](https://frameio-custom-action.glitch.me).Ricorda di includere una barra finale quando aggiungi questo indirizzo nell'area Azioni personalizzate di [developer.frame.io](/).
### Risorse
Questa sezione elenca le risorse indicate nell'articolo:
* **ngrok** [https://ngrok.com/](https://ngrok.com/)
* **Glitch** [https://glitch.com/](https://glitch.com/)
* **Piattaforme disponibili in Glitch** [https://glitch.com/create](https://glitch.com/create)
* **App di esempio Glitch per un'azione personalizzata in JavaScript** [https://frameio-custom-action.glitch.me](https://frameio-custom-action.glitch.me)
* **Registrazione come sviluppatore Frame.io e configurazione** [Sito per sviluppatori Frame.io](/)
* **Web app Frame.io**[https://app.frame.io/](https://app.frame.io/)