Blog’a Dön

Port Kullanımda Hatası: Portu Kullanan Süreci Bulma

Port kullanımda hatası mı alıyorsunuz? ss, lsof ve fuser ile portu tutan süreci bulma, düzgünce durdurma, portu değiştirme ve ilgili hataların çözümü.

Nodesty Ekibi6 dk okumaSunucular
Koyu Nodesty arka planında Port in Use yazısı ile ss, lsof ve fuser ifadeleri

Port kullanımda hatası ("address already in use"), uygulamanızın istediği portun başka bir süreç tarafından zaten kullanıldığı anlamına gelir. Hata farklı biçimlerde karşınıza çıkar: Node.js EADDRINUSE der, nginx başlamayı reddeder, Minecraft sunucusu FAILED TO BIND TO PORT yazar, Docker ise port is already allocated hatası verir. Hepsinde çözüm aynı soruyla başlar: Portu hangi süreç tutuyor?

Bu rehberde bu süreci ss, lsof ve fuser ile bulmayı, çıktıyı okumayı, en sık suçluları ve onları doğru şekilde durdurmayı anlatıyoruz. Sonunda da tersi durumu, yani hiçbir şeyin dinlemediği durumu ele alıyoruz.

Hata nasıl görünür?

Belirli bir portu, IP adresi ve protokolde aynı anda yalnızca bir süreç dinleyebilir. İkinci bir süreç denediğinde şu hatalardan birini alır:

# Node.js
Error: listen EADDRINUSE: address already in use :::3000

# nginx
nginx: [emerg] bind() to 0.0.0.0:80 failed (98: Address already in use)

# Minecraft (Java Edition)
**** FAILED TO BIND TO PORT!
The exception was: java.net.BindException: Address already in use

# Docker
Bind for 0.0.0.0:80 failed: port is already allocated

Mesajdaki sayı (3000, 80, 25565) incelemeniz gereken porttur. Portun ne olduğundan emin değilseniz Port nedir? rehberimizle başlayın.

Süreci bulma: ss, lsof ve fuser

Sunucunuza SSH ile bağlandıktan sonra en hızlı araç, bütün güncel dağıtımlarda kurulu gelen ss komutudur:

sudo ss -tulpn | grep :80

-t ve -u TCP ve UDP'yi, -l yalnızca dinleyen soketleri, -p süreci, -n ise sayısal port numaralarını gösterir. Komutu sudo ile çalıştırın; aksi hâlde başka kullanıcılara ait servislerde süreç sütunu boş kalır. Tipik bir satır şöyle görünür:

tcp   LISTEN 0      511      0.0.0.0:80      0.0.0.0:*    users:(("nginx",pid=1234,fd=6))

Burada süreç nginx, PID'si ise 1234'tür. İki araç daha aynı cevabı verir:

sudo lsof -nP -iTCP:80 -sTCP:LISTEN
sudo fuser -v 80/tcp

lsof komut adını, PID'yi ve kullanıcıyı listeler; fuser portu kullanan PID'leri yazdırır. Biri eksikse sudo apt install lsof psmisc ile kurun (AlmaLinux'ta sudo dnf install lsof psmisc). 19132 portundaki bir Bedrock sunucusu gibi UDP portları için sudo fuser -v 19132/udp kullanın.

Bir PID hakkında daha fazla bilgi almak, tam komut satırını ve hangi systemd servisine ait olduğunu görmek için:

ps -fp 1234
systemctl status 1234

ss çıktısını okuma

Local Address:Port sütunu sürecin nerede dinlediğini söyler:

AdresAnlamı
0.0.0.0:80Bütün IPv4 adresleri, dışarıdan erişilebilir
[::]:80 / *:80Bütün IPv6 adresleri (uygulamaya göre çoğu zaman IPv4 de dahil)
127.0.0.1:3306Yalnızca sunucunun kendisinden (localhost)
203.0.113.10:80Yalnızca sunucunun bu IP adresinde

LISTEN, sürecin bağlantı beklediği anlamına gelir. Süreç sütununda bir uygulama yerine systemd görünüyorsa portu bir systemd soket birimi tutuyordur; hangisi olduğunu systemctl list-sockets gösterir. docker-proxy görünüyorsa portu bir Docker konteyneri yayınlıyordur.

En sık suçlular

  • Apache ve nginx bir arada: İkisi de 80 ve 443 portlarını ister. Apache'nin (Ubuntu'da apache2, AlmaLinux'ta httpd) zaten çalıştığı bir sunucuya nginx kurmak, nginx bind hatasının en yaygın sebebidir.
  • Oyun sunucusunun ikinci kopyası: Daha önce tmux ya da screen içinde başlatılan bir Minecraft veya başka bir oyun sunucusu, bağlantınızı kestikten sonra da çalışmaya devam eder. tmux ls ve screen -ls ile kontrol edin.
  • Kapanmayan bir süreç: Bir çökme ya da zorla yeniden başlatma sonrasında eski bir Java veya Node.js süreci portu açık tutarak asılı kalabilir.
  • Bir Docker konteyneri: Aynı portu -p 80:80 ile yayınlayan, belki de restart: always politikasına sahip bir konteyner.
  • Bir systemd servisi: Restart=always ayarlı bir servis, siz sonlandırdıktan birkaç saniye sonra geri gelir.

Doğru şekilde durdurma

Port bir systemd servisine aitse servisi systemd üzerinden durdurun. Açılışta tekrar başlamaması gerekiyorsa disable da kullanın:

sudo systemctl stop apache2
sudo systemctl disable apache2

Docker konteyneri için yayınlanan porta göre konteyneri bulup durdurun:

docker ps --filter "publish=80"
docker stop konteyner-adi

Yeniden başlatma politikası olan bir konteyner Docker yeniden başladığında tekrar çalışır; ihtiyacınız yoksa docker rm ile kaldırın ya da port eşlemesini değiştirin. tmux ya da screen içindeki bir oyun sunucusunda oturuma bağlanıp dünyanın kaydedilmesi için sunucuyu kendi stop komutuyla kapatın.

Sürecin arkasında bir yönetici yoksa ancak o zaman kendiniz sonlandırın:

kill 1234
# yalnızca birkaç saniye sonra hâlâ çalışıyorsa:
kill -9 1234

Düz kill komutu SIGTERM gönderir ve uygulamanın düzgünce kapanmasına izin verir. kill -9 süreci anında sonlandırır ve kaydedilmemiş verilerin kaybolmasına yol açabilir; bu yüzden son çare olarak saklayın. sudo fuser -k 80/tcp porttaki bütün süreçleri tek seferde sonlandırır, ama neyi sonlandırdığınızı önceden kontrol etme şansı bırakmaz.

Bunun yerine portu değiştirme

Bazen iki uygulamanın da çalışması gerekir. Bu durumda birine farklı bir port verin: nginx server bloğunda listen 8080;, Apache'nin ports.conf dosyasında Listen 8080, Minecraft'ın server.properties dosyasında server-port, Node.js'te PORT değişkeni ya da listen() çağrısı, Docker'da ise -p 8080:80. 1024'ün altındaki portlar root yetkisi gerektirir; normal kullanıcıyla çalışan uygulamalar için daha yüksek bir port seçin. Yeni portu güvenlik duvarında açmayı unutmayın; bkz. UFW kullanımı.

80 ve 443 portlarında aynı anda birden fazla site çalıştırmak istiyorsanız önüne ters vekil olarak nginx koyun; bunu Nginx kurulumu rehberimizde anlattık.

TIME_WAIT ve SO_REUSEADDR

Bir sunucu bağlantıları kapattıktan sonra ss -tan bu bağlantıları yaklaşık bir dakika boyunca TIME_WAIT durumunda gösterebilir. Bu normalde yeniden başlatmayı engellemez: nginx ve Node.js dahil çoğu sunucu SO_REUSEADDR soket seçeneğini ayarlar ve hemen yeniden dinlemeye başlayabilir. Kendi uygulamanız hatayı yalnızca yeniden başlatmanın hemen ardından veriyor ve bir dakika sonra çalışıyorsa, dinleyen soketinde SO_REUSEADDR ayarlayın.

Güvenlik kontrolü olarak dinleyen bütün portları listeleme

Aynı komut, süzgeç olmadan sunucunuzun dışarıya açtığı her şeyi gösterir:

sudo ss -tulpn

Listeyi gözden geçirin ve 0.0.0.0 ya da [::] üzerindeki her satır için gerçekten internetten erişilebilir olması gerekip gerekmediğini sorun. MySQL (3306), PostgreSQL (5432) ve Redis (6379) gibi veritabanları genellikle yalnızca 127.0.0.1 üzerinde dinlemelidir. Kullanmadığınız servisleri kaldırın, geri kalanını güvenlik duvarıyla engelleyin. Bu tür kontroller için işe yarayan diğer araçları Linux komutları rehberimizde bulabilirsiniz.

Tersi durum: connection refused

İstemciler Connection refused hatası ya da zaman aşımı alıyorsa önce bir şeyin dinleyip dinlemediğine bakın:

sudo ss -tulpn | grep :3000
curl -I http://127.0.0.1:3000
  • Çıktı yok: Hiçbir şey dinlemiyor. Uygulama durmuş ya da çökmüştür; günlüklerine bakın (journalctl -u servis-adi). systemd'nin onu otomatik olarak yeniden başlatması için systemd servisi oluşturma rehberimize göz atın.
  • 127.0.0.1 üzerinde dinliyor: Uygulama yerelde çalışıyor ama dışarıdan erişilemiyor. Dinleme adresini 0.0.0.0 yapın ya da önüne nginx koyun.
  • 0.0.0.0 üzerinde dinliyor ama dışarıdan erişilemiyor: Güvenlik duvarı engelliyordur. Hızlı gelen bir Connection refused genellikle hiçbir şeyin dinlemediği ya da güvenlik duvarının paketi reddettiği anlamına gelir; zaman aşımı ise çoğu zaman güvenlik duvarının paketi sessizce düşürdüğünü gösterir. Portu sudo ufw allow 3000/tcp ile, AlmaLinux'ta ise firewall-cmd ile açın.

Docker kullanıyorsanız yayınlanan portların UFW'yi atlayabileceğini unutmayın; ayrıntılar Docker kurulumu rehberimizde.

Nodesty sunucularında portlar

Nodesty AMD Ryzen 9 9950X VDS ve AMD EPYC 7763 VDS paketleri NVMe disk ve tam root erişimiyle gelir; dinleyen bütün portları görebilir ve hangi servisin hangi portta çalışacağına kendiniz karar verebilirsiniz. VDS paketlerinde günlük yedekler ücretsizdir ve 7 gün saklanır.

Sıkça Sorulan Sorular

"Address already in use" hatası ne anlama gelir?

Uygulamanın dinlemeye çalıştığı portu başka bir sürecin zaten dinlediği anlamına gelir. Aynı IP adresi ve protokolde bir portu aynı anda yalnızca bir süreç dinleyebilir, bu yüzden ikinci süreç başlayamaz. Çözüm, portu tutan süreci bulup durdurmak ya da yeni uygulamaya farklı bir port vermektir.

Linux'ta bir portu hangi sürecin kullandığını nasıl bulurum?

sudo ss -tulpn komutunu çalıştırıp port numarasına göre süzün, örneğin sudo ss -tulpn | grep :80. Son sütunda sürecin adı ve PID'si görünür. sudo lsof -i :80 ve sudo fuser -v 80/tcp komutları da aynı bilgiyi farklı bir biçimde verir.

Süreci sonlandırdım ama port yine dolu, neden?

Süreç büyük ihtimalle systemd, Docker ya da onu otomatik olarak yeniden başlatan bir süreç yöneticisi tarafından yönetiliyordur. Süreci kendi yöneticisi üzerinden durdurun, örneğin sudo systemctl stop servis-adi ya da docker stop konteyner-adi ile; açılışta başlamaması gerekiyorsa devre dışı da bırakın.

Portu boşaltmak için kill -9 kullanmalı mıyım?

Yalnızca son çare olarak. Düz kill komutu SIGTERM gönderir; uygulama verilerini kaydedip düzgünce kapanabilir. kill -9 süreci anında sonlandırır, bu yüzden bir oyun sunucusu ya da veritabanı kaydedilmemiş verileri kaybedebilir. Önce systemctl stop ya da düz kill deneyin ve birkaç saniye bekleyin.

Apache ve nginx aynı sunucuda çalışabilir mi?

Evet, ama ikisi birden 80 ve 443 portlarında çalışamaz. Ya ihtiyacınız olmayanı kaldırın ya da birini başka bir porta taşıyın; örneğin Apache'yi 8080 portunda çalıştırıp önüne ters vekil olarak nginx koyabilirsiniz.

Port kullanımda değil ama yine de bağlanamıyorum, sorun ne?

Önce ss -tulpn ile gerçekten bir şeyin dinleyip dinlemediğine bakın. Uygulama yalnızca 127.0.0.1 adresinde dinliyorsa ona sadece sunucunun kendisinden erişilebilir. 0.0.0.0 adresinde dinlediği hâlde dışarıdan bağlanamıyorsanız portu büyük ihtimalle güvenlik duvarı engelliyordur.

Nodesty

Yazar hakkında

Nodesty Ekibi · Altyapı ve Destek

Nodesty ekibi sunucularımızı, ağımızı ve DDoS korumamızı her gün işletir ve müşteri destek taleplerini 7/24 yanıtlar. Bu rehberler o deneyimden yazılır.

İlgili yazılar

Sunucunuzu şimdi başlatın.

Nodesty'nin üstün altyapısı ile projelerinizi özgürce inşa edin ve sınır tanımadan ölçeklendirin.

                                                                                                                                                                                                                            
                                                                                                                                                                                                                            
                                                                                                                                                                                                                            
                                                                                                                             ············································                                                   
                                                ··································································································..........···························                                     
                                       ················..........................................................................................................................··············                             
                                  ·············.................::::::::::::::::::::::::::::::::::::::::::::::....................:::::::::::::::::::::::::::::::::::::::................···········                        
                             ············................:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::............·········                     
                         ············.................:::::::::::::::::::::::::::::::::::::::::::::::::::------------::::::::::::::::::::::::::::::----------------:::::::::::::::::::::..........········                  
                    ············......................::::::::::::::::::::::::::::::::::::------------------------------------------------------------------------------------:::::::::::::.........········                
                ··········.............................................::::::::::::::::::-------------==========================================-----------------------------------:::::::::::........·······               
             ········..................:.....................................::::::::::--------=======+++++++++++++++++++++++++++++++++++++=========================------------------::::::::::.......·······              
           ······.........::::::::::::::::::::................................:::::::-----=====++++xxxxxx**************************xxxxxxxxx++++++++++++++===================------------::::::::.......·······             
          ·····.......:::::::::::::::::::::::::::.............................:::::----===+++xxx****%%%%&&&&&&#############&&&&&&&%%%%%*******xxxxxxxx++++++++++++++==============----------:::::::......······             
         ····......::::::::-------------:::::::::::..........................::::---===+++xx***%%%&&&####@@@@@@@@@@@@@@@@@@@@@@@@####&&&&&%%%%*******xxxxxxxxx+++++++++++++===========--------::::::......·····             
        ····.....:::::::--------------------:::::::::.......................::::---===++xxx**%%&&&###@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@###&&&&%%%%%********xxxxxxxxxxx++++++++++++========------::::::.....······            
        ····.....:::::--------------------------::::::::....................::::---===++xx***%%&&&####@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@###&&&&&%%%%%**********xxxxxxxxxxxxx+++++++++=======------:::::.....·····            
        ····....::::::-------=============---------:::::::::................:::::---===+++xx***%%%&&&#####@@@@@@@@@@@@@@@@@@@@@@@@@#####&&&&&%%%%%%*************xxxxxxxxxxxxxx+++++++++======-----:::::....·····            
         ····....:::::-------================---------:::::::::...............:::::----===++++xxx***%%%%&&&&&&#################&&&&&&%%%%%%%*******************xxxxxxxxxxxxxxxxx++++++++======----:::::....·····            
         ·····....:::::--------=================---------::::::::::..............:::::::-----====+++++xxxxxx**************************xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx++++++++=====-----::::....·····            
          ·····.....:::::--------=================----------:::::::::::.................:::::::::-------=============++++++++++++++++++++++++++++++++++++xxxxxxxxxxxxxxxxxxxxxxx++++++++======-----::::....·····            
            ·····.....:::::::----------===========-------------::::::::::::.........................::::::::::::::::::------------------=============+++++++++++++++++++++++++++++++++=======-----::::.....·····            
              ······......:::::::---------------------------------:::::::::::::........................................:::::::::::::::-----------============+++++++++++++++++++++========------:::::.....·····             
                 ······........:::::::::---------------------------:::::::::::::::::...........................................:::::::::::::------------=============================--------::::::.....······              
                    ·········.........:::::::::::::::-------------::::::::::::::::::::::::.......................................::::::::::::::::--------------------------------------::::::::......·······                
                          ··········............::::::::::::::::::::::::::::::::::::::::::::::::::................................::::::::::::::::::::::::::-------------:::::::::::::::.........········                   
                                  ············..................:::::::::::::::::::::::::::::::::::::::::::.........................:::::::::::::::::::::::::::::::::::::................···········                        
                                             ················.............................................................................................................·················                                 
                                                           ······················................................................................···························                                                
                                                                               ·········································································