Giriş
Hemen şimdi Windows 10’da bir ASP.NET sitesi çalıştırmanız mı gerekiyor? Yapabilirsiniz ve bu, IIS’te birkaç net adımla olur. Bu kılavuz, Windows 10’da IIS’te ASP.NET’i nasıl etkinleştireceğinizi, doğru özellikleri nasıl yapılandıracağınızı, uygulama havuzlarını nasıl hazırlayacağınızı ve kurulumu hızlı bir test sitesiyle nasıl doğrulayacağınızı gösterir. Ayrıca her şey çalıştıktan sonra yaygın hatalara hızlı çözümler ve pratik güvenlik ipuçları da bulacaksınız.
Tahmine gerek bırakmayan adımlara odaklanıyoruz. IIS ve ASP.NET özelliklerini açacak, işleyici (handler) eşlemelerini doğrulayacak ve basit bir web sitesi yayımlayacaksınız. ASP.NET Core barındırmayı planlıyorsanız, Hosting Bundle’ı yükleyip havuzu Yönetilen Kod Yok (No Managed Code) olarak ayarlayacaksınız. Tekrarlanabilir kurulumlar için betikler de dahil edilmiştir.
Önkoşullardan kuruluma, doğrulamadan sorun gidermeye ilerleyeceksiniz. Sırayı izleyin; IIS’te ASP.NET’i sorunsuz etkinleştirir ve sonradan ortaya çıkacak sürprizlerden kaçınırsınız.

IIS’te ASP.NET ve ASP.NET Core: Farkları ve Neden Önemli
Özellikleri etkinleştirmeden önce sitenizin hangi çerçeveyi (framework) kullandığına karar verin. Klasik ASP.NET 4.x, IIS işçi süreci içinde .NET Framework üzerinde çalışır. .NET Extensibility, ISAPI uzantıları ve ASP.NET 4.x özellik kümesini gerektirir. ASP.NET Core, çapraz platform .NET çalışma zamanı üzerinde çalışır ve IIS’te ters vekil olarak sıklıkla ANCM olarak adlandırılan ASP.NET Core Module’ü kullanır. Bu modelde IIS uygulama havuzu, .NET çalışma zamanı w3wp’de değil uygulama sürecinizde çalıştığı için Yönetilen Kod Yok (No Managed Code) seçeneğine ayarlanır.
Bu ayrım, kurulumunuzu ve sorun gidermenizi belirler. Web Forms veya MVC 5 barındırıyorsanız, ASP.NET 4.x özelliklerini etkinleştirin ve havuzu Entegre (Integrated) modda CLR v4.0 olarak ayarlayın. ASP.NET Core barındırıyorsanız, Hosting Bundle’ı yükleyin, havuz için Yönetilen Kod Yok (No Managed Code) seçeneğini seçin ve sorunlar ortaya çıktığında önce ANCM günlüklerini kontrol edin.
Çerçeve seçiminiz netleştiğinde, yalnızca ihtiyaç duyduğunuz özellikleri etkinleştirip makinenizi yalın tutabilirsiniz.
Önkoşullar: Windows 10 Sürümü, Yönetici Yetkileri ve Gerekli .NET Bileşenleri
Önceki bölüm iki barındırma yolunu özetledi. Şimdi makinenizin bunları destekleyebildiğinden emin olun. IIS; Windows 10 Pro, Enterprise ve Education sürümlerinde mevcuttur. Windows 10 Home IIS içermez. Windows özelliklerini eklemek/çıkarmak ve yükleyicileri çalıştırmak için yönetici haklarına da ihtiyacınız vardır.
Sırada çalışma zamanlarını doğrulayın. Klasik ASP.NET için Windows 10 zaten .NET Framework 4.8 içerir. Bazı eski uygulamalar .NET Framework 3.5 de gerektirir. ASP.NET Core için uygulamanıza uygun .NET çalışma zamanını ve ASP.NET Core Hosting Bundle’ını eklemeyi planlayın.
80 veya 443 portlarını kullanan araçları, örneğin geliştirici proxy’leri veya yerel konteynerleri kapatın. Küçük bir test projesi, portlar ve yükleyici dosyalarını hazırlayın. Önkoşullar hazır olduğunda, IIS’i etkinleştirip ASP.NET bileşenlerini sorunsuz ekleyebilirsiniz.
Adım 1 — Windows Özellikleri üzerinden IIS ve Gerekli Web Sunucusu Özelliklerini Etkinleştirin
IIS’i ve asgari web sunucusu bileşenlerini etkinleştirerek başlayacaksınız. Bu, çekirdek HTTP hattını ve yönetim konsolunu kurar.
1) Windows tuşuna basın, Windows Özellikleri yazın ve Windows özelliklerini aç veya kapat’ı seçin.
2) Internet Information Services’ı işaretleyin. Doğru alt bileşenleri seçmek için genişletin.
3) Web Yönetim Araçları altında IIS Yönetim Konsolu’nu seçin.
4) World Wide Web Services altında şunları etkinleştirin:
– Common HTTP Features: Static Content, Default Document, HTTP Errors
– Health and Diagnostics: HTTP Logging, Request Monitor
– Performance: Static and Dynamic Compression
– Security: Request Filtering, Basic Authentication, Windows Authentication
5) FTP Hizmetini gerekmedikçe devre dışı bırakın.
Tamam’a tıklayın ve Windows’un özellikleri yüklemesini bekleyin. İstenirse yeniden başlatın.
Bir tarayıcı açıp https://localhost adresine giderek sonucu doğrulayın. Varsayılan IIS sayfasını görmelisiniz. Görmüyorsanız 80 numaralı port başka bir şey tarafından kullanılıyor olabilir. Çakışan hizmeti durdurup yeniden deneyin.
Sağlıklı bir IIS temeliyle artık klasik ASP.NET’in gerektirdiği uygulama geliştirme özelliklerini etkinleştirebilirsiniz.
Adım 2 — Windows Özelliklerinde ASP.NET 4.x ve .NET Extensibility’yi Açın
Şimdi ASP.NET 4.x’i IIS ile bütünleştiren özellikleri ekleyin. Bu bileşenler çalışma zamanının .aspx, .ashx ve diğer yönetilen uç noktaları işlemesine olanak tanır.
1) Windows Özelliklerini tekrar açın. Internet Information Services > World Wide Web Services > Application Development Features yoluna gidin.
2) Şu öğeleri seçin:
– .NET Extensibility 4.8
– ASP.NET 4.8
– ISAPI Extensions
– ISAPI Filters
– CGI (yalnızca uygulamanız gerektiriyorsa)
3) Değişiklikleri uygulayın ve tamamlanmasını bekleyin.
IIS Yöneticisi’ni açın ve sunucunuz için Özellikler Görünümü’nü inceleyin. Handler Mappings içinde PageHandlerFactory-Integrated ve SimpleHandlerFactory-Integrated gibi girdiler görmelisiniz. Modules içinde yönetilen hat bütünleşmesi ve statik dosya işleme için girdiler bulun. Bunlar eksikse özellik seçiminizi tekrar kontrol edin.
Yalnızca ASP.NET Core barındırıyorsanız bunları atlayabilir ve yerine bir sonraki adımda açıklandığı gibi Hosting Bundle’ı kurabilirsiniz.
Adım 3 — Eski Web Uygulamaları için .NET Framework 3.5’i Kurun
Bazı eski ASP.NET uygulamaları .NET Framework 3.5 veya daha öncesini hedefleyen kitaplıklar kullanır. Windows 10 bunu isteğe bağlı bir özellik olarak etkinleştirebilir.
1) Windows Özelliklerini açın, ardından .NET Framework 3.5 ( .NET 2.0 ve 3.0’ı içerir ) seçeneğini işaretleyin.
2) Windows dosya isterse internete bağlanın veya yerel bir kaynak sağlayın.
Ortamınız indirmeleri engelliyorsa Windows kurulum medyasını bağlayın ve şu yetkili komutu çalıştırın:
- dism /online /enable-feature /featurename:NetFx3 /All /Source:X:\sources\sxs /LimitAccess
X’i kurulum medyasını barındıran sürücü harfiyle değiştirin.
3.5’i yalnızca uygulamanız gerektiriyorsa ekleyin. Gereksiz özellikleri kapalı tutmak yamalama yüzeyini ve başlangıç süresini azaltır.
Adım 4 — ASP.NET Core Hosting Bundle’ı Kurun (Yalnızca ASP.NET Core Dağıtıyorsanız)
ASP.NET Core uygulamaları çalıştırmayı planlıyorsanız, ANCM ve gerekli .NET çalışma zamanını eklemek için Hosting Bundle’ı kurun.
1) Hosting Bundle’ı resmi .NET web sitesinden indirin. Uygulamanıza ve mimarisine uygun çalışma zamanını seçin.
2) Yükleyiciyi yönetici olarak çalıştırın. İstendiğinde ASP.NET Core Module ve URL Rewrite eklenmesine izin verin.
3) ANCM’nin IIS’te temizce yüklenmesi için makineyi yeniden başlatın.
Kurulumdan sonra Core uygulamanızın uygulama havuzunu Yönetilen Kod Yok (No Managed Code) olarak ayarlayın. ASP.NET Core uygulamaları süreç dışında çalışır; IIS istekleri ANCM üzerinden sizin sürecinize iletir. Dağıtım modelinize bağlı olarak processPath’i çalıştırılabilir dosyanıza veya dll’nize işaret eden bir aspNetCore işleyicisinin web.config içinde bulunduğunu doğrulayın.
Çerçeve bileşenleri halledildikten sonra, bir site oluşturmadan önce IIS’in doğru işleyici ve modüllere sahip olduğunu doğrulayın.

Adım 5 — IIS Yöneticisi’nde Handler Mappings, Modules ve ISAPI Filters’ı Doğrulayın
Doğrulama, dağıtım sırasında yaşanacak karışıklığı önler. Buradaki hızlı bir kontrol saatlerce sürecek sorun gidermeyi engelleyebilir.
1) IIS Yöneticisi’ni açın ve sunucu düğümünüzü seçin.
2) Handler Mappings’e çift tıklayın. PageHandlerFactory-Integrated, SimpleHandlerFactory-Integrated ve StaticFile gibi ASP.NET işleyicileri için girdileri doğrulayın.
3) Modules’ı açın ve managedPipelineHandler, StaticFileModule, RequestFilteringModule ve uygulamanızın ihtiyaç duyduğu diğerlerini kontrol edin.
4) ISAPI Filters’ı açın ve klasik ASP.NET için aspnet_filter’ın mevcut olduğunu doğrulayın.
Bu listelerde bir özellik eksikse, karşılık gelen Windows özelliği muhtemelen kurulmamıştır. Adım 1 ve Adım 2’ye dönün ve gereken öğeleri ekleyin.
Core uygulamalar farklı eşlemeler gösterecektir çünkü tümleştirme katmanına ANCM sahiptir. Bu durumda, site düzeyindeki web.config’inizde aspNetCore bulunduğunu doğrulayın ve Windows Olay Günlüğü’nü ve varsa stdout günlüklerini başlangıç hataları için kontrol edin.
Adım 6 — Uygulama Havuzlarını Yapılandırın (CLR Sürümü, Hat Modu, 32/64-bit, Geri Dönüşüm)
Modüller yerindeyken, uygulamalarınızı izole etmek ve doğru çalışma zamanını seçmek için uygulama havuzlarını ayarlayın.
1) IIS Yöneticisi’nde Application Pools’u açın ve her uygulama için ayrılmış bir havuz oluşturun.
2) Klasik ASP.NET 4.x için .NET CLR sürümünü v4.0 ve Hat (Pipeline) modunu Entegre (Integrated) olarak ayarlayın. Classic hattı yalnızca bunu gerektiren eski yapılandırmalar için kullanın.
3) ASP.NET Core için .NET CLR sürümünü Yönetilen Kod Yok (No Managed Code) olarak ayarlayın.
4) 32 bit mi 64 bit mi karar verin. Yalnızca uygulamanız veya yerel (native) bir bağımlılık gerektiriyorsa 32 biti etkinleştirin. Aksi halde varsayılan 64 bit ayarını koruyun.
5) Geri dönüşüm ve boşta kalma zaman aşımlarını ayarlayın. Varsayılanlar çoğu durum için uygundur; ancak geliştirme makinelerinde kodlarken yeniden başlatmaları azaltmak için boşta kalma zaman aşımını uzatabilirsiniz.
6) Kimliği ApplicationPoolIdentity olarak bırakın ve site klasörünüzde bu kimliğe veya gerektiğinde IIS_IUSRS’e NTFS izinleri verin.
Doğru havuz ayarları 500.0 çalışma zamanı çökmelerini ve yapılandırma çakışmalarını önler. Havuzlar hazırken, uçtan uca akışı doğrulamak için bir test sitesi oluşturun.
Adım 7 — IIS Yöneticisi’nde Bir Test Web Sitesi Oluşturun ve Bağlamaları (Bindings) Ayarlayın
Basit bir test sitesi, IIS’in, işleyicilerin, izinlerin ve bağlamaların beklendiği gibi çalıştığını kanıtlar.
1) C:\inetpub\testsite gibi bir klasör oluşturun. İçine bir index.html ve ASP.NET için basit sunucu tarafı içerik üreten bir default.aspx koyun.
2) IIS Yöneticisi’nde Sites üzerine sağ tıklayın ve Add Website’ı seçin.
– Site adı: TestSite
– Fiziksel yol: oluşturduğunuz klasör
– Binding: 80 numaralı portta http, ya da boş bir port seçin
3) Siteyi oluşturmak için Tamam’a tıklayın.
4) Site dosyaları okuyamazsa, içerik klasöründe IIS_IUSRS’e veya uygulama havuzu kimliğine okuma izinleri verin.
https://localhost veya https://localhost:port adresine gidin ve sayfayı yükleyin. Bağlamalarda bir ana bilgisayar adı ayarladıysanız, makinenizde buna uygun bir hosts kaydı ekleyin. Çalışan bir test sitesiyle bir sonraki adımda işleyicileri ve SSL’i doğrulayabilirsiniz.

Adım 8 — Kurulumu Doğrulayın: Localhost Testleri, HTTPS Bağlama ve Ağ Erişimi
Doğrulama, çerçevenizin, işleyicilerin ve güvenliğin doğru şekilde bağlandığını onaylamalıdır.
1) Klasik ASP.NET: DateTime.Now yazdırmak gibi sunucu tarafı kodu tetikleyen basit bir .aspx sayfasını ziyaret edin. 500 hataları olmadan işlenmiş bir sayfa görmelisiniz. Başarısız olursa Handler Mappings’i ve uygulama havuzu CLR sürümünü kontrol edin.
2) ASP.NET Core: Uygulamayı başlatın veya yayımlanmış çıktının mevcut olduğundan emin olun. Siteyi IIS üzerinden ziyaret edin. Başarısız olursa Windows Olay Günlüğü’nü ve ANCM’nin yazdığı stdout günlüklerini kontrol edin. Eksik bağımlılıkları görmek için uygulamayı komut satırından çalıştırın.
3) Mümkünse HTTPS’i etkinleştirin. Yerel testler için kendinden imzalı bir sertifika kullanın. Bunu sitenize bağlayın ve karışık içerik uyarıları olmadan kilit simgesinin göründüğünü doğrulayın.
4) Yerel ağınızdaki başka bir makineden test edin. Seçtiğiniz port için Windows Defender Güvenlik Duvarı’nı açın veya netsh advfirewall komutlarıyla bir kural ekleyin.
Doğrulanmış bir siteyle, sorun gidermeye güvenle ve temiz bir temel üzerinden yaklaşabilirsiniz.
Sorun Giderme: Yaygın IIS ve ASP.NET Hataları ve Hızlı Çözümler
Dikkatli bir kurulum bile hatalara takılabilir. Yaygın sorunları hızla izole etmek için bu kısa listeyi kullanın.
- 404.3 Not Found: Bu genellikle eksik bir MIME türü veya işleyici anlamına gelir. Static Content ve doğru ASP.NET işleyicilerini etkinleştirin. Klasik uygulamalar için ASP.NET 4.8 ve .NET Extensibility’nin yüklü olduğunu doğrulayın.
- 500.19 Configuration Error: web.config seçilen hat için geçersiz bölümler içeriyor. Uygulama havuzu hat modunu eşleştirin ve desteklenmeyen öğeleri kaldırın. Sitenin hedeflenen uygulama havuzunda çalıştığından emin olun.
- 500.0 Runtime Error: Windows Olay Günlüğü’nü inceleyin, Failed Request Tracing’i açın ve uygulama günlüklerini gözden geçirin. ApplicationPoolIdentity için klasör izinlerini kontrol edin ve sitenin web.config ve içeriği okuyabildiğini doğrulayın.
- ASP.NET Core’da 502.5 veya 500.30: Süreç başlamadı. Hosting Bundle sürümünü ve mimarisini doğrulayın, ortam değişkenlerini kontrol edin ve eksik derlemeleri veya başlangıç özel durumlarını görmek için uygulamayı elle çalıştırın.
Değişkenleri tek tek düzeltin, havuzu geri dönüştürün ve yeniden test edin. Tutarlı değişiklikler ve hızlı testler, hatalı bileşeni izole edecektir.
İsteğe Bağlı: IIS ve ASP.NET Özelliklerini Etkinleştirmeyi PowerShell veya DISM ile Otomatikleştirin
Kurulumları birden çok makinede tekrarlıyorsanız, tutarlılık ve hız için betikleyin.
-
Yükseltilmiş Komut İstemi’nde DISM:
dism /online /enable-feature /featurename:IIS-WebServerRole /All
dism /online /enable-feature /featurename:IIS-ManagementConsole /All
dism /online /enable-feature /featurename:IIS-ASPNET45 /All
dism /online /enable-feature /featurename:IIS-NetFxExtensibility45 /All -
Yönetici olarak PowerShell:
Enable-WindowsOptionalFeature -Online -FeatureName IIS-WebServerRole,IIS-ManagementConsole,IIS-ASPNET45,IIS-NetFxExtensibility45 -All -
appcmd ile siteler oluşturun:
appcmd add apppool /name:TestPool /managedRuntimeVersion:v4.0
appcmd add site /name:TestSite /bindings:http/*:8080: /physicalPath:C:\inetpub\testsite
appcmd set app TestSite/ /applicationPool:TestPool -
Özellikleri doğrulayın:
Get-WindowsOptionalFeature -Online | Where-Object { $_.FeatureName -like ‘IIS*’ }
ASP.NET Core için, gözetimsiz kurulumlar adına Hosting Bundle yükleyicisini sessiz anahtarlarla çalıştırın; ardından dotnet –info ve bir test uygulamasıyla doğrulayın.
Güvenlik Temelleri: Windows 10’da IIS’i Sıkılaştırın
Siteniz çalışmaya başladığında, üretim senaryolarına geçmeden önce temel güvenliği sağlayın.
- TLS: Bir sertifika ekleyin ve HTTPS’i bağlayın. Modern TLS sürümlerini ve güçlü şifre takımlarını tercih edin. Zayıf protokolleri kaldırın.
- Kimlik Doğrulama: Gerekmediği yerlerde Anonymous’u kapatın. Kurumiçi uygulamalar için Windows Authentication kullanın. Genel uygulamalar için Forms veya harici bir kimlik sağlayıcısını HTTPS ile birleştirin.
- Request Filtering: Tehlikeli fiilleri (verbs) reddedin, azami URL uzunluğunu sınırlayın ve çift kaçışlı dizileri engelleyin. İhtiyaç duymadığınız işleyici eşlemelerini kaldırın.
- Günlükleme ve Sınırlar: HTTP günlüklemeyi etkinleştirin, günlükleri düzenli olarak gözden geçirin, yükleme boyutu sınırları belirleyin ve kaynakları korumak için bağlantı ve istek sınırlarını tanımlayın.
Güvenliği sıkılaştırmak saldırı yüzeyini azaltır ve güvenilirliği artırır. Güvenli bir temel ile kısa bir gözden geçirme ve sonraki adımlarla tamamlayabilirsiniz.
Sonuç
IIS’i etkinleştirdiniz, doğru ASP.NET özelliklerini eklediniz, uygulama havuzlarını yapılandırdınız ve kurulumu bir test sitesiyle doğruladınız. Ayrıca gerektiğinde ASP.NET Core Hosting Bundle’ı nasıl kuracağınızı, işleyici ve modülleri nasıl doğrulayacağınızı ve yaygın hataları nasıl hızlıca gidereceğinizi öğrendiniz. Birkaç betik ve temel güvenlik sıkılaştırmasıyla, Windows 10 makineniz uygulamaları güvenilir ve tekrarlanabilir şekilde barındırabilir.
Yüklü özelliklerin, havuz ayarlarının ve port bağlamalarının kaydını tutun. Çalışma zamanlarını ve Hosting Bundle’ı küçük, test edilmiş adımlarla güncelleyin ve her değişiklikten sonra yeniden test edin. Net bir süreç ve temiz bir temel ile, geliştirmeden üretime devreye almaya kadar Windows 10’da ASP.NET’i güvenle barındırabilirsiniz.
Sıkça Sorulan Sorular
ASP.NET neden İşleyici Eşlemeleri altında veya Uygulama Havuzu seçeneklerinde görünmüyor?
Eksik eşlemeler veya .NET seçenekleri genellikle özelliklerin yüklü olmadığını gösterir. Windows Özellikleri’ni açın, IIS-ManagementConsole, IIS-ASPNET45 ve IIS-NetFxExtensibility45’i etkinleştirin, değişiklikleri uygulayın, ardından IIS Yöneticisi’ni yeniden başlatın. ASP.NET Core için, klasik girdiler yerine uygulama havuzunda ‘No Managed Code’u ve web.config içinde aspNetCore işleyicisini kullanmanız gerekir.
Hem ASP.NET 4.x özelliklerine hem de ASP.NET Core Hosting Bundle’a ihtiyacım var mı?
Genellikle her ikisine de gerek yoktur. Uygulamanıza göre seçim yapın. Web Forms veya MVC 5 uygulamaları ASP.NET 4.x özelliklerine ve .NET Extensibility’ye ihtiyaç duyar. ASP.NET Core uygulamaları Hosting Bundle’a ve ‘No Managed Code’ olarak ayarlanmış bir uygulama havuzuna ihtiyaç duyar. Geliştirme makinesinde her ikisini de kurabilirsiniz, ancak üretim ortamını sade tutun ve yalnızca uygulamalarınızın gerektirdiklerini ekleyin.
GUI yerine PowerShell ile IIS ve ASP.NET’i nasıl etkinleştirebilirim?
PowerShell’i Yönetici olarak çalıştırın ve şu komutu yürütün: Enable-WindowsOptionalFeature -Online -FeatureName IIS-WebServerRole,IIS-ManagementConsole,IIS-ASPNET45,IIS-NetFxExtensibility45 -All. Siteleri betiklemek için appcmd ile bir havuz ve bir site oluşturun, ardından Get-WindowsOptionalFeature ile doğrulayın. Kabukları her zaman yönetici yetkileriyle çalıştırın.
