MySQL ve MariaDB ilişkisel veritabanı yönetim sistemlerinin istemci ve web uygulaması (PHP, Python, Node.js vb.) bağlantılarını dinlediği varsayılan porttur.
MYSQL / MARIADB · 3306
MySQL / MariaDB bağlantı sorununuz için kontrol listesi
Hata türünü ve istemci ortamını seçin. Size uygun adımları ve komut örneklerini alın; sunucu adı, kullanıcı veya parola girmeniz gerekmez.
Bu bölüm komut çalıştırmaz veya sunucuya bağlanmaz. Komutlardaki örnek adresi ve portu kendi yetkili ortamınıza göre değiştirin. Paylaşılan bağlantıda yalnız seçilen hata, ortam ve istemci bulunur.
Seçiminize göre kontrol listesi
Hata türüne göre ilk kontroller
Bağlantı reddedildi / Connection refused
Tam mesaj bağlantı reddi gösteriyorsa bu dalı kullanın. MySQL 2003/10061, MariaDB istemcisi ise 2002 gösterebilir; socket yolu varsa yerel socket dalını seçin.
Kontrolü hatalı uygulamanın çalıştığı makine veya konteyner ağından yapın.
Hedef portta dinleyen servis ile uygulamanın sunucu ve port ayarlarını karşılaştırın.
Açık ret, dinleyici eksikliği veya ağ erişim kuralından kaynaklanabilir; yalnız hata koduyla neden seçmeyin.
Sonraki adım: TCP testi başarılıysa uygulamadaki tam hataya dönün. Başarısızsa sunucu yöneticisiyle dinleyiciyi ve izinli kaynak ağını kontrol edin.
Zaman aşımı / Connection timed out
İstemci bağlantı için bekliyor ve zaman aşımına düşüyorsa bu dalı kullanın.
Uygulamanın kullandığı sunucu adının beklenen IP adresine çözüldüğünü kontrol edin.
VPN, özel ağ ve bulut erişim kurallarını uygulamanın kaynak ağıyla karşılaştırın.
Süreyi artırmadan önce erişim yolunu inceleyin; zaman aşımı tek başına güvenlik duvarını kanıtlamaz.
Sonraki adım: Kendi ağınızdaki sonucu dışarıdan yapılan port testiyle ayrı değerlendirin. Özel veritabanının internete kapalı olması beklenen davranış olabilir.
1045 — Access denied
Veritabanı kimlik doğrulama isteğini reddediyorsa bu dalı kullanın.
İstemcinin doğru ortam ve sunucuya bağlandığını doğrulayın.
Yetkili yöneticiyle kullanıcı-hosta göre hesap eşleşmesini, yetkileri ve kimlik doğrulama yöntemini inceleyin.
Parolayı destek kaydına eklemeyin; başarısız girişleri otomatik olarak tekrarlamayın.
Sonraki adım: Ağ bağlantısı kurulduktan sonraki kimlik doğrulama hatası için rastgele port açmayın. Hesap ayarı düzeltildiğinde asıl uygulama isteğini yeniden kontrol edin.
2002 — Yerel socket bağlantısı
Mesajda socket yolu geçiyorsa TCP testiyle farklı bir bağlantı türünü sınadığınızı unutmayın.
İstemci ve sunucunun aynı makinede olup olmadığını belirleyin.
İstemcinin beklediği socket yolu ile sunucunun kullandığı yolu karşılaştırın.
TCP karşılaştırmasını yalnız yerel sunucunuz TCP dinliyorsa ve hesabınız bu bağlantıya yetkiliyse yapın.
Sonraki adım: Socket dosyasını gelişigüzel silmeyin. TCP ile başarı, socket yolunun veya izinlerinin doğru olduğunu göstermez.
2005 — Unknown server host
Sunucu adı çözümlenemiyorsa önce adlandırma yolunu inceleyin.
Sunucu adında yazım hatası veya yanlış ortam adı olup olmadığını kontrol edin.
Adı uygulamanın çalıştığı ağda çözümleyin; özel DNS veya konteyner servis adı dışarıdan çalışmayabilir.
DNS cevabını beklenen adresle karşılaştırın; DNS başarısı TCP veya oturum açma başarısı değildir.
Sonraki adım: Doğru ağda isim çözümleme çalıştıktan sonra aynı sunucu ve portla bağlantı adımına geçin.
Bu bir teşhis kontrol listesidir; nedenin bulunduğu veya sorunun çözüldüğü anlamına gelmez.
2002, 2003 ve 1045: gerçek deneyde ne değişiyor?
9 Kasım 2026’da MySQL 8.4.13 ve MariaDB 11.4.13 istemcilerini kendi sunucularıyla ayrı Linux Docker konteynerlerinde sınadık. Her motor için aynı dört kontrol çalıştı. Dış ağ ve yayımlanan host portu yoktu; testler konteynerin kendi loopback adresini kullandı. İki konteyner ve geçici verileri temizlendi. Bunlar müşteri vakası değil, tekrarlanabilir kontrollü deney sonuçlarıdır.
İki motor, sekiz doğrulanmış sonuç
Bağlantı
MySQL 8.4.13
MariaDB 11.4.13
Yorum
TCP 127.0.0.1:3307
2003 / HY000
2002 / HY000
Dinleyici yok; bağlantı reddi. Önce adres, port ve dinleyiciyi kontrol edin.
TCP 127.0.0.1:3306
1045 / 28000
1045 / 28000
Bilerek yanlış parola verildi; sunucuya ulaşıldı ve kimlik doğrulama reddedildi.
SOCKET /tmp/cybertool-absent.sock
2002 / HY000
2002 / HY000
Olmayan Unix soket yolu. TCP portunu değiştirmek bu yolu düzeltmez.
TCP 127.0.0.1:3306
SELECT 1 → 1; exit 0
SELECT 1 → 1; exit 0
Aynı sunucu ve port, doğru geçici parola: başarılı kontrol.
Aynı TCP reddi MySQL istemcisinde 2003, MariaDB istemcisinde 2002 verdi. Olmayan socket ise ikisinde de 2002 verdi. Bu yüzden yalnız hata numarasıyla katmanı belirlemeyin; istemciyi, transport türünü ve tam mesajı okuyun. 1045 bu deneyde yanlış parola nedeniyle üretildi; gerçek sistemde kullanıcı-host eşleşmesi veya kimlik doğrulama yöntemi de sebep olabilir. Sonuçlar bu sürümlere ve Linux ortamına aittir; Windows native istemcisi sınanmadı.
Docker içindeki localhost neden yanıltır?
Uygulama ile veritabanı ayrı konteynerlerdeyse, uygulamadaki 127.0.0.1 uygulama konteynerinin kendisidir. Aynı Docker ağındaki Compose servis adı ve konteyner portunu kullanın; örneğin db:3306. Host üzerinde 3307:3306 eşlemesi olması, diğer konteynerin db:3307 kullanması gerektiği anlamına gelmez. Yukarıdaki deney istemciyi bilerek veritabanı konteynerinin içinde çalıştırır; bu nedenle 127.0.0.1 burada doğrudur. Gerçek uygulama için testi uygulamanın ağından tekrarlayın.
Deneyi kendiniz tekrarlayın
Python 3 ve çalışan Docker gerekir. Paketi çıkarıp aşağıdaki komutları çalıştırın. Her çalıştırma bir geçici konteyner oluşturur; MySQL için 1 GB, MariaDB için 512 MB bellek ve 1 CPU sınırı kullanır. Dört sonucu denetler ve temizler. Betik parolaları çıktıya veya sonuç dosyalarına yazmaz. Çalışırken süreç/konteyner ortamında bulunurlar; Docker erişimi olan yöneticiler bunları görebilir. İlk imaj indirmesi internet gerektirir; deneyin ağı kapalıdır. İmaj etiketleri değişebilir; kullanılan sürüm ve digest paket içindeki iki sonuç JSON dosyasında kayıtlıdır.
Varsayımsal örnek: Windows uygulaması, yetkili özel ağdaki veritabanına bağlanamıyor. Aşağıdakiler gerçek sunucu çıktısı veya çözülmüş müşteri vakası değildir.
A — 2003 / Connection refused / 10061
TCP bağlantısı reddedilmiş. Uygulamanın çalıştığı ağdan hedef adres ve yapılandırılmış portu kontrol edin; yöneticiyle dinleyen servisi karşılaştırın. Farklı bir bilgisayardan başarılı test, uygulamanın erişimini kanıtlamaz.
Sunucu kimlik doğrulamayı reddetmiş. Önce doğru ortama ulaşıldığını, ardından kullanıcı-hosta göre hesap eşleşmesini ve kimlik doğrulama yöntemini yöneticiyle kontrol edin. Bu mesaj tek başına yanlış parola kanıtı değildir.
Hedef alan adı veya IP adresinde TCP Port 3306 bağlantısını gerçek zamanlı test edin:
Varsayılan Protokol
TCP
Kategori
Veritabanı
Popüler Yazılımlar
MySQL Community Server, MariaDB, Percona
MariaDB hangi portu kullanır?
MariaDB varsayılan olarak TCP 3306 üzerinden bağlantı kabul eder; kurulumda farklı bir port seçilebilir. Yetkili bir veritabanı oturumunda SHOW VARIABLES LIKE 'port'; ile kullanılan değeri kontrol edin.
3306 ile 33060 aynı şey mi?
MySQL’in klasik istemci protokolü için varsayılan port 3306, X Protocol için ise genellikle 33060’tır. Uygulamanın desteklediği protokole uygun port seçilmelidir.
Bağlanamıyorsanız hangi sırayla kontrol etmelisiniz?
Veritabanı servisinin çalıştığını ve beklenen ağ arayüzünde dinlediğini doğrulayın. Linux üzerinde ss -ltn dinleyen TCP soketlerini gösterir.
Uygulamadaki sunucu adı, port ve bağlantı türünü kontrol edin. Unix soketiyle başarılı yerel bağlantı, ağ üzerinden erişimin çalıştığını göstermez.
“Connection refused” dinleyen servis bulunmadığı veya bağlantının reddedildiği anlamına gelebilir. Zaman aşımında güvenlik duvarı, yönlendirme ve sunucunun erişilebilirliği ayrı ayrı incelenmelidir.
TCP bağlantısı kuruluyor fakat giriş reddediliyorsa veritabanı hata mesajına ve hesap yetkilerine bakın. Hatalı parolayı port açarak düzeltemezsiniz.
Yukarıdaki test yalnızca yönettiğiniz sistemler içindir. Sonuç bizim sunucumuzdan erişimi gösterir; uygulamanızın ağından farklı olabilir. Açık port, güvenli yapılandırma veya başarılı kimlik doğrulama kanıtı değildir. Özel ağ erişimini ve belirli kaynaklara izin veren kuralları tercih edin.
Bu sayfanın en üstündeki Canlı Port 3306 Test Aracına hedef alan adını veya IP adresini yazarak ya da terminalden 'nc -zv hedef-ip 3306' ve 'nmap -p 3306 hedef-ip' komutlarını kullanarak portun açık olup olmadığını anında öğrenebilirsiniz.
Port 3306 internete açık bırakılmalı mı?
Port 3306 (MySQL & MariaDB Database) yalnızca dış dünyadan doğrudan erişim gereken durumlarda ve güvenlik duvarı (Firewall / IP Whitelist / TLS) önlemleriyle açılmalıdır. Kullanılmayan açık portlar kapatılmalıdır.