> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/unigetui/it/per-i-team-it/organization/network-and-proxy.md).

# Usare UniGetUI dietro un proxy o un firewall

Instradi il traffico di UniGetUI attraverso il proxy, sappia quali server deve raggiungere e impedisca che gli aggiornamenti vengano eseguiti su connessioni a consumo.

In una rete aziendale, UniGetUI e i gestori di pacchetti che guida hanno bisogno di un'uscita verso Internet. Questa pagina mostra come puntare UniGetUI al proxy, quali server consentire nel firewall e come tenere gli aggiornamenti automatici fuori dalle connessioni a consumo.

## Configurare un proxy

{% stepper %}
{% step %}

### Attivare il proxy

1. Vada in ***Impostazioni*** – ***Impostazioni connessione Internet***.
2. Attivi ***Connettiti a Internet utilizzando un proxy personalizzato***.
3. In ***URL proxy***, immetta l'indirizzo del proxy, inclusi lo schema e la porta, per esempio `http://proxy.contoso.com:3128`.
   {% endstep %}

{% step %}

### Aggiungere le credenziali (se il proxy le richiede)

1. Attivi ***Autentica il proxy con un nome utente e una password***.
2. In ***Credenziali***, immetta ***Nome utente*** e ***Password di accesso***. Vengono salvati mentre digita.

{% hint style="danger" %}
UniGetUI avvisa che non può garantire che le credenziali siano archiviate in modo sicuro. In Windows sono conservate in Windows Credential Manager. Su macOS e Linux sono salvate come file in chiaro nella cartella `SecureStorage` della cartella dati di UniGetUI. Usi un account proxy dedicato con il minor numero di diritti possibile.
{% endhint %}
{% endstep %}

{% step %}

### Verificare quali gestori di pacchetti lo seguono

Scorra fino a ***Tabella di compatibilità dei proxy***. Per ogni gestore di pacchetti, indica se è ***Compatibile con proxy*** e ***Compatibile con autenticazione*** (***Sì***, ***Parzialmente*** o ***No***).

UniGetUI passa il proxy a ogni gestore nel modo che quel gestore supporta, per esempio come opzione della riga di comando. I gestori contrassegnati ***No*** non lo ricevono da UniGetUI: configuri le loro impostazioni proxy, o il proxy di sistema, separatamente.
{% endstep %}
{% endstepper %}

Al momento della scrittura, la tabella ha questo aspetto. La versione nell'applicazione è quella di cui fidarsi.

<table><thead><tr><th width="250">SUPPORTO PROXY</th><th>GESTORI DI PACCHETTI</th></tr></thead><tbody><tr><td><strong>Sì</strong>, con autenticazione</td><td>Chocolatey, pip</td></tr><tr><td><strong>Parzialmente</strong>, con autenticazione</td><td>.NET Tool, Cargo, PowerShell 5.x, PowerShell 7.x</td></tr><tr><td><strong>Parzialmente</strong>, senza autenticazione</td><td>WinGet</td></tr><tr><td><strong>No</strong></td><td>Scoop, npm, Bun, vcpkg, Homebrew, APT, DNF, Pacman, Snap, Flatpak</td></tr></tbody></table>

{% hint style="warning" %}
**WinGet e i proxy autenticati:** WinGet non accetta credenziali del proxy. Se ***Autentica il proxy con un nome utente e una password*** è attivo, UniGetUI non passa affatto il proxy a WinGet, e WinGet si connette direttamente. Se il traffico di WinGet deve passare dal proxy, usi un indirizzo proxy che non richieda autenticazione, oppure configuri il proxy in Windows.
{% endhint %}

### Impostare il proxy su molti computer

Le opzioni del proxy sono impostazioni normali, quindi può impostarle da uno script di distribuzione con l'[interfaccia della riga di comando](/unigetui/it/riferimento/cli.md):

```powershell
UniGetUI.exe --enable-setting EnableProxy
UniGetUI.exe --set-setting-value ProxyURL http://proxy.contoso.com:3128
```

Le credenziali non si possono impostare in questo modo. Le digiti in ***Credenziali*** su ogni computer, oppure usi un proxy che non le richiede.

## Che cosa consentire nel firewall

UniGetUI parla con alcuni server propri. I gestori di pacchetti ne contattano molti altri, e i programmi di installazione che scaricano provengono dai server di ogni editore.

### UniGetUI stesso

<table><thead><tr><th width="250">CHE COSA</th><th>SERVER</th><th>QUANDO</th></tr></thead><tbody><tr><td>Controllo degli aggiornamenti di UniGetUI</td><td><code>devolutions.net</code> (<code>https://devolutions.net/productinfo.json</code>)</td><td>Quando <em><strong>Aggiorna UniGetUI automaticamente</strong></em> è attivo, o quando controlla gli aggiornamenti.</td></tr><tr><td>Download di un aggiornamento di UniGetUI</td><td><code>devolutions.net</code> and its subdomains, <code>github.com</code>, <code>objects.githubusercontent.com</code>, <code>release-assets.githubusercontent.com</code></td><td>Quando viene trovato un aggiornamento. UniGetUI rifiuta di scaricare i propri aggiornamenti da qualsiasi altro host.</td></tr><tr><td>Database di icone e schermate</td><td><code>github.com</code> (file nel repository UniGetUI)</td><td>All'avvio, a meno che non sia impostato un indirizzo personalizzato in <em><strong>Usa un URL personalizzato per il database di icone e screenshot</strong></em>.</td></tr><tr><td>Icone e schermate dei pacchetti</td><td>Gli indirizzi elencati in quel database, su molti host diversi</td><td>Quando vengono mostrate le icone. Disattivi <em><strong>Mostra icone dei pacchetti negli elenchi dei pacchetti</strong></em> se preferisce non caricarle.</td></tr><tr><td>Dati di utilizzo anonimi</td><td><code>telemetry2.devolutions.net</code>, port <code>9200</code></td><td>Solo nelle build ufficiali, e solo se non ha rifiutato in <em><strong>Gestisci le impostazioni di telemetria</strong></em>. Veda <a href="/unigetui/it/guide/understand/privacy.md">Quali dati invia UniGetUI</a>.</td></tr><tr><td>Backup nel cloud</td><td><code>github.com</code>, <code>api.github.com</code></td><td>Solo se accede con GitHub per i <a href="/unigetui/it/guide/new-computer/backup.md">backup</a>.</td></tr></tbody></table>

Tutte queste richieste usano HTTPS. Passano dal proxy che ha configurato, tranne il programma di aggiornamento di UniGetUI, che usa le impostazioni proxy predefinite del sistema.

{% hint style="info" %}
In Windows, un amministratore può puntare il programma di aggiornamento di UniGetUI a un diverso `productinfo.json` con il valore `UpdaterProductInfoUrl` sotto `HKEY_LOCAL_MACHINE\Software\Devolutions\UniGetUI`. Il programma di installazione che scarica deve comunque provenire da uno degli host sopra tramite HTTPS, e hash e firma vengono comunque controllati.
{% endhint %}

### I gestori di pacchetti

Ogni gestore di pacchetti deve raggiungere i propri cataloghi, chiamati origini, e poi il server che ospita ogni programma di installazione. UniGetUI non controlla queste connessioni. Per esempio, queste sono le origini predefinite che UniGetUI conosce per alcuni gestori:

<table><thead><tr><th width="250">GESTORE DI PACCHETTI</th><th>ORIGINE PREDEFINITA</th></tr></thead><tbody><tr><td>WinGet</td><td><code>cdn.winget.microsoft.com</code> (<code>winget</code> source), <code>storeedgefd.dsx.mp.microsoft.com</code> (<code>msstore</code> source)</td></tr><tr><td>Chocolatey</td><td><code>community.chocolatey.org</code></td></tr><tr><td>PowerShell 5.x, PowerShell 7.x</td><td><code>www.powershellgallery.com</code></td></tr><tr><td>.NET Tool</td><td><code>api.nuget.org</code></td></tr><tr><td>pip</td><td><code>pypi.org</code></td></tr><tr><td>npm, Bun</td><td><code>registry.npmjs.org</code></td></tr><tr><td>Cargo</td><td><code>index.crates.io</code></td></tr><tr><td>Scoop</td><td>Bucket ospitati su <code>github.com</code></td></tr><tr><td>Flatpak</td><td><code>dl.flathub.org</code></td></tr></tbody></table>

Questo elenco non è completo. Anche le origini che aggiunge lei, i server di download dei programmi di installazione e i controlli di aggiornamento dei gestori hanno bisogno di accesso. L'indirizzo del programma di installazione di un pacchetto è mostrato in ***Dettagli pacchetto*** – ***URL installer***, e può aggiungere una colonna ***Host del programma di installazione*** agli elenchi con ***Mostra l'host del programma di installazione negli elenchi dei pacchetti*** in ***Impostazioni*** – ***Preferenze dell'interfaccia utente***. Per tutti i requisiti di rete di un gestore, consulti la sua documentazione.

{% hint style="info" %}
Consente solo un elenco fisso di host? Si aspetti che alcune installazioni non riescano: gli editori ospitano i programmi di installazione sui propri server e sulle reti di distribuzione dei contenuti, e questi cambiano nel tempo. L'output dell'operazione non riuscita mostra quale indirizzo non è stato raggiunto.
{% endhint %}

## Niente Internet, o una rete limitata

Per impostazione predefinita, ***Attendi che il dispositivo sia connesso a Internet prima di provare a svolgere attività che richiedono la connettività Internet.*** è attivo. UniGetUI attende allora che il sistema operativo segnali una connessione funzionante prima di caricare ***Esplora pacchetti***, ***Aggiorna pacchetti*** e ***Pacchetti installati***, e prima di controllare i propri aggiornamenti.

Su alcune reti isolate o molto filtrate, Windows non segnala mai un accesso completo a Internet, quindi gli elenchi continuano ad attendere. Disattivi l'impostazione in ***Impostazioni*** – ***Impostazioni connessione Internet***, poi riavvii UniGetUI. I gestori di pacchetti provano allora a connettersi subito e segnalano i propri errori se non ci riescono.

## Non aggiornare su connessioni a consumo

Per impedire che gli aggiornamenti automatici usino un hotspot del telefono o un'altra connessione limitata:

1. Vada in ***Impostazioni*** – ***Preferenze di aggiornamento dei pacchetti***.
2. Attivi ***Non installare automaticamente gli aggiornamenti quando la connessione di rete è a consumo***.

Questo riguarda solo gli aggiornamenti installati dall'attività ***Installa gli aggiornamenti disponibili*** della [manutenzione pianificata](/unigetui/it/guide/updates/schedule.md). Quando la connessione è a consumo, UniGetUI la avvisa che sono disponibili aggiornamenti invece di installarli, e riprova al controllo successivo. Gli aggiornamenti che avvia lei vengono sempre eseguiti.

{% hint style="warning" %}
UniGetUI rileva le connessioni a consumo solo in Windows, usando l'impostazione Windows della connessione (***Metered connection*** nelle proprietà di rete). Su macOS e Linux, l'opzione non ha effetto.
{% endhint %}

## Se non funziona

* **Gli elenchi restano vuoti o continuano a caricarsi dietro il proxy:** apra ***Altro*** – ***Log gestore pacchetti*** e cerchi errori di connessione del gestore interessato. Controlli la sua riga in ***Tabella di compatibilità dei proxy***.
* **Un'installazione non riesce con un errore di download o di connessione:** l'host del programma di installazione è probabilmente bloccato. Veda [Un aggiornamento o un'installazione non riesce](/unigetui/it/aiuto/troubleshooting/update-or-install-fails.md).
* **UniGetUI non può aggiornarsi:** verifichi che gli host in [UniGetUI stesso](#unigetui-itself) siano consentiti. Veda [Installare UniGetUI](/unigetui/it/riferimento/installation.md#update-unigetui).
* **Gli aggiornamenti pianificati non si installano mai:** una regola di connessione a consumo o di batteria potrebbe trattenerli. Veda [Gli aggiornamenti pianificati non vengono eseguiti](/unigetui/it/aiuto/troubleshooting/scheduled-updates-dont-run.md).

## Passo successivo

* [Distribuire UniGetUI in modo invisibile](/unigetui/it/per-i-team-it/organization/deploy.md)
* [Bloccare le impostazioni rischiose](/unigetui/it/per-i-team-it/organization/restrict-settings.md)
* [Tutte le impostazioni](/unigetui/it/riferimento/settings.md#internet-connection-settings)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.devolutions.net/unigetui/it/per-i-team-it/organization/network-and-proxy.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.