Condividi tramite

Connessioni di connessione <FTP predefinite>

Panoramica

L'elemento <connections> specifica le impostazioni correlate alla connessione per i siti FTP. In particolare, le impostazioni nell'elemento <connections> controllano il comportamento del servizio FTP per la gestione dei client che si connettono a un sito FTP.

Ad esempio, gli unauthenticatedTimeoutattributi , controlChannelTimeoute dataChannelTimeout specificano i timeout per un sito FTP. Le impostazioni specificano, rispettivamente, quando il servizio FTP disconnetterà un client FTP che non ha eseguito correttamente l'accesso o è inattiva o quando disconnettere una connessione dati inattiva. La specifica dei valori per gli attributi nell'elemento <connections> può influire direttamente sulle prestazioni complessive del server, consentendo di controllare il numero di sessioni client attive per i siti FTP.

Compatibilità

Versione Note
IIS 10.0 L'elemento <connections> non è stato modificato in IIS 10.0.
IIS 8,5 L'elemento <connections> non è stato modificato in IIS 8.5.
IIS 8,0 L'elemento <connections> non è stato modificato in IIS 8.0.
IIS 7,5 L'elemento <connections> dell'elemento <ftpServer> viene fornito come funzionalità di IIS 7.5.
IIS 7.0 L'elemento <connections> dell'elemento <ftpServer> è stato introdotto in FTP 7.0, che è stato un download separato per IIS 7.0.
IIS 6.0 N/D

Nota

I servizi FTP 7.0 e FTP 7.5 sono stati forniti fuori banda per IIS 7.0, che hanno richiesto il download e l'installazione dei moduli dall'URL seguente:

https://www.iis.net/expand/FTP

Con Windows 7 e Windows Server 2008 R2, il servizio FTP 7.5 viene fornito come funzionalità per IIS 7.5, quindi il download del servizio FTP non è più necessario.

Installazione

Per supportare la pubblicazione FTP per il server Web, è necessario installare il servizio FTP. A tale scopo, seguire questa procedura.

Windows Server 2012 o Windows Server 2012 R2

  1. Sulla barra delle applicazioni fare clic su Server Manager.

  2. In Server Manager fare clic sul menu Gestisci e quindi su Aggiungi ruoli e funzionalità.

  3. Nella procedura guidata Aggiungi ruoli e funzionalità fare clic su Avanti. Selezionare il tipo di installazione e fare clic su Avanti. Selezionare il server di destinazione e fare clic su Avanti.

  4. Nella pagina Ruoli server espandere Server Web (IIS) e quindi selezionare FTP Server.

    Nota

    Per supportare ASP. L'autenticazione di appartenenza o l'autenticazione di GESTIONE IIS per il servizio FTP, sarà necessario selezionare FTP Extensibility, oltre al servizio FTP.
    Screenshot della pagina Ruoli server. Server Web I S è espanso. F T P Server è espanso. L'estendibilità F T P è evidenziata e selezionata. .

  5. Fare clic su Avanti e quindi nella pagina Seleziona funzionalità fare di nuovo clic su Avanti .

  6. Nella pagina Conferma selezioni per l'installazione fare clic su Installa.

  7. Nella pagina Risultati fare clic su Chiudi.

Windows 8 o Windows 8.1

  1. Nella schermata Start spostare il puntatore nell'angolo inferiore sinistro, fare clic con il pulsante destro del mouse sul pulsante Start e quindi fare clic su Pannello di controllo.

  2. In Pannello di controllo fare clic su Programmi e funzionalità e quindi su Attiva o disattiva le funzionalità di Windows.

  3. Espandere Internet Information Services e quindi selezionare SERVER FTP.

    Nota

    Per supportare ASP. L'autenticazione di appartenenza o l'autenticazione di GESTIONE IIS per il servizio FTP, sarà anche necessario selezionare FTP Extensibility.
    Screenshot dell'albero di spostamento. F T P Server è espanso. La cartella F T P Extensibility è evidenziata e selezionata.

  4. Fare clic su OK.

  5. Fare clic su Close.

Windows Server 2008 R2

  1. Nella barra delle applicazioni fare clic su Start, scegliere Strumenti di amministrazione e quindi fare clic su Server Manager.

  2. Nel riquadro della gerarchia di Server Manager espandere Ruoli e quindi fare clic su Server Web (IIS).

  3. Nel riquadro Server Web (IIS) scorrere fino alla sezione Servizi ruolo e quindi fare clic su Aggiungi servizi ruolo.

  4. Nella pagina Seleziona servizi ruolo della Procedura guidata Aggiungi servizi ruolo espandere SERVER FTP.

  5. Selezionare Servizio FTP.

    Nota

    Per supportare ASP. L'autenticazione di appartenenza o l'autenticazione di GESTIONE IIS per il servizio FTP, sarà anche necessario selezionare FTP Extensibility.
    Screenshot della pagina Seleziona servizi ruolo. F T P Server è espanso. Il servizio F T P è evidenziato e selezionato.

  6. Fare clic su Avanti.

  7. Nella pagina Conferma selezioni per l'installazione fare clic su Installa.

  8. Nella pagina Risultati fare clic su Chiudi.

Windows 7

  1. Nella barra delle applicazioni fare clic su Start e quindi fare clic su Pannello di controllo.

  2. In Pannello di controllo fare clic su Programmi e funzionalità e quindi su Attiva o disattiva funzionalità di Windows.

  3. Espandere Internet Information Services e quindi FTP Server.

  4. Selezionare Servizio FTP.

    Nota

    Per supportare ASP. L'autenticazione di appartenenza o l'autenticazione di GESTIONE IIS per il servizio FTP, sarà anche necessario selezionare FTP Extensibility.
    Screenshot dell'albero di spostamento Programmi e funzionalità. Il servizio F T P è selezionato.

  5. Fare clic su OK.

Windows Server 2008 o Windows Vista

  1. Scaricare il pacchetto di installazione dall'URL seguente:

  2. Seguire le istruzioni riportate nella procedura dettagliata seguente per installare il servizio FTP:

Procedure

Come configurare i timeout predefiniti del canale dati e del controllo per tutti i siti FTP

  1. Aprire Gestione Internet Information Services (IIS):

    • Se si usa Windows Server 2012 o Windows Server 2012 R2:

      • Nella barra delle applicazioni fare clic su Server Manager, scegliere Strumenti e quindi fare clic su Gestione Internet Information Services (IIS).

    • Se si usa Windows 8 o Windows 8.1:

      • Tenere premuto il tasto Windows, premere la lettera X e quindi fare clic su Pannello di controllo.
      • Fare clic su Strumenti di amministrazione e quindi fare doppio clic su Gestione Internet Information Services (IIS).

    • Se si usa Windows Server 2008 o Windows Server 2008 R2:

      • Nella barra delle applicazioni fare clic su Start, scegliere Strumenti di amministrazione e quindi fare clic su Gestione Internet Information Services (IIS).

    • Se si usa Windows Vista o Windows 7:

      • Nella barra delle applicazioni fare clic su Start e quindi fare clic su Pannello di controllo.
      • Fare doppio clic su Strumenti di amministrazione e quindi fare doppio clic su Gestione Internet Information Services (IIS).

  2. Nel riquadro Connessioni fare clic sul nome del server e quindi fare clic sul nodo Siti .

  3. Nel riquadro Siti fare clic su Imposta impostazioni predefinite sito FTP... nel riquadro Azioni .

  4. Nella finestra di dialogo Impostazioni avanzate espandere Connessioni, specificare i timeout nei campi Timeout del canale di controllo e Timeout canale dati e quindi fare clic su OK.

Configurazione

Attributi

Attributo Descrizione
controlChannelTimeout Attributo facoltativo int.

Specifica il timeout, in secondi, quando una connessione verrà timeout a causa dell'inattività nel canale di controllo. Nota: Il servizio FTP disconnetterà la sessione quando viene raggiunto questo timeout.

Il valore predefinito è 120.
dataChannelTimeout Attributo facoltativo int.

Specifica il timeout, in secondi, quando una connessione verrà timeout a causa dell'inattività nel canale dati. Nota: Il servizio FTP disconnetterà solo il canale dati quando viene raggiunto questo timeout.

Il valore predefinito è 30.
disableSocketPooling Attributo Boolean facoltativo. true se il pooling socket è disabilitato; in caso contrario, false. L'attributo specifica se il pool di socket viene usato per i siti che sono distinti dall'indirizzo disableSocketPooling IP anziché dal numero di porta o dal nome host. Se disableSocketPooling è impostato su false, il pooling socket è abilitato e i socket vengono condivisi tra siti che usano lo stesso numero di socket ma indirizzi IP diversi. In questa situazione, il servizio FTP diventa il proprietario esclusivo della porta su ogni indirizzo associato al server. Ad esempio, se il pool di socket è abilitato in un server con due indirizzi IP, 10.0.0.1 e 10.0.0.2 e un sito FTP è associato all'indirizzo 10.0.0.1 sulla porta 21, il servizio FTP sarà anche la porta 21 sull'indirizzo 10.0.0.2. Se disableSocketPooling è impostato su true, non esiste alcuna condivisione socket per i siti in base all'indirizzo IP. Il valore predefinito è false.
maxBandwidth Attributo uint inutilizzato.

Nota: Questo attributo non viene implementato per FTP 7.
maxConnections Attributo unità facoltativo.

Specifica il numero massimo di connessioni simultanee per un sito FTP.

Nota: Usare l'attributo maxClientsMessage dell'elemento <messaggi> per specificare un messaggio che il servizio FTP restituirà ai client quando è stato superato il numero massimo di connessioni simultanee.

Il valore predefinito è 4294967295 (illimitato).
minBytesPerSecond Attributo facoltativo int.

Specifica i requisiti minimi di larghezza di banda per i trasferimenti di dati. Nota: Il servizio FTP disconnetterà il canale dati quando la larghezza di banda minima non viene soddisfatta.

Il valore predefinito è 240.
resetOnMaxConnections Attributo Boolean facoltativo.

true se il servizio FTP deve disconnettere rapidamente una sessione FTP anziché inviare una risposta massima di connessioni; in caso contrario false.

Nota: L'attributo resetOnMaxConnections ottimizza il sovraccarico durante l'elaborazione delle connessioni che non sono consentite per la connessione perché è stato raggiunto il limite maxConnection .

Il valore predefinito è false.
serverListenBacklog Attributo facoltativo int.

Specifica il numero di socket in sospeso che possono essere inseriti nella coda.

Il valore predefinito è 60.
unauthenticatedTimeout Attributo facoltativo int.

Specifica il timeout inattiva, in secondi, tra quando viene effettuata una nuova connessione e l'autenticazione ha esito positivo. Se il client non esegue correttamente l'autenticazione entro il periodo di tempo specificato, il servizio FTP disconnetterà la sessione.

Il valore predefinito è 30.

Elementi figlio

Nessuno.

Esempio di configurazione

Nell'esempio di configurazione seguente viene visualizzato un elemento di esempio <connections> per un server con timeout del canale di controllo predefinito impostato su 300 secondi.

<siteDefaults>
   <ftpServer>
      <connections controlChannelTimeout="300" />
   </ftpServer>
</siteDefaults>

Codice di esempio

Gli esempi di codice seguenti illustrano come impostare il timeout predefinito del canale di controllo su 300 secondi.

AppCmd.exe

appcmd.exe set config -section:system.applicationHost/sites /siteDefaults.ftpServer.connections.controlChannelTimeout:"300" /commit:apphost

Nota

È necessario assicurarsi di impostare il parametro commit su apphost quando si usa AppCmd.exe per configurare queste impostazioni. Questa operazione esegue il commit delle impostazioni di configurazione nella sezione percorso appropriata nel file di ApplicationHost.config.

C#

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample
{
   private static void Main()
   {
      using (ServerManager serverManager = new ServerManager())
      {
         Configuration config = serverManager.GetApplicationHostConfiguration();
         ConfigurationSection sitesSection = config.GetSection("system.applicationHost/sites");
         ConfigurationElement siteDefaultsElement = sitesSection.GetChildElement("siteDefaults");
         ConfigurationElement ftpServerElement = siteDefaultsElement.GetChildElement("ftpServer");

         ConfigurationElement connectionsElement = ftpServerElement.GetChildElement("connections");
         connectionsElement["controlChannelTimeout"] = 300;

         serverManager.CommitChanges();
      }
   }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration

Module Sample
   Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim config As Configuration = serverManager.GetApplicationHostConfiguration
      Dim sitesSection As ConfigurationSection = config.GetSection("system.applicationHost/sites")
      Dim siteDefaultsElement As ConfigurationElement = sitesSection.GetChildElement("siteDefaults")
      Dim ftpServerElement As ConfigurationElement = siteDefaultsElement.GetChildElement("ftpServer")

      Dim connectionsElement As ConfigurationElement = ftpServerElement.GetChildElement("connections")
      connectionsElement("controlChannelTimeout") = 300

      serverManager.CommitChanges()
   End Sub

End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";

var sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST");
var siteDefaultsElement = sitesSection.ChildElements.Item("siteDefaults");
var ftpServerElement = siteDefaultsElement.ChildElements.Item("ftpServer");

var connectionsElement = ftpServerElement.ChildElements.Item("connections");
connectionsElement.Properties.Item("controlChannelTimeout").Value = 300;

adminManager.CommitChanges();

VBScript

Set adminManager = createObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST")
Set siteDefaultsElement = sitesSection.ChildElements.Item("siteDefaults")
Set ftpServerElement = siteDefaultsElement.ChildElements.Item("ftpServer")

Set connectionsElement = ftpServerElement.ChildElements.Item("connections")
connectionsElement.Properties.Item("controlChannelTimeout").Value = 300

adminManager.CommitChanges()