SSH Unknown Terminal Type Hatası Nasıl Çözülür?
SSH bağlantılarında karşılaşılan unknown terminal type hatasını root yetkisi olmadan gidermek için kendi terminfo girdinizi ev dizininize nasıl derleyeceğinizi öğrenin.
"Unknown terminal type" hatasının anlamı
SSH üzerinden alınan bir "unknown terminal type" hatası, TERM içindeki ismin sunucudaki terminfo veritabanında eşleşen bir kaydının bulunmadığı anlamına gelir. Terminal emülatörünüz bu ismi dizüstü bilgisayarınızda belirler. Ancak bu ismi tanıması gereken veritabanı uzak makinede bulunur. Arama başarısız olduğunda, sunucudaki tüm curses tabanlı programlar, terminalinizin yeteneklerine dair bir açıklama bulamadıkları için herhangi bir çizim yapmadan durur.
Emülatörünüzün tüm özelliklerini koruyan çözüm tek bir komuttur: kendi terminfo girdinizi sunucudaki ~/.terminfo içine derleyin. Debian gibi standart yapılarda ncurses, herhangi bir sistem dizininden önce ev dizininizi arar (yalnızca ayarlanmışsa $TERMINFO değişkeni daha önce kontrol edilir); bu nedenle işlem root yetkisi gerektirmez ve diğer kullanıcılar için hiçbir şeyi değiştirmez. Ev dizini araması ncurses içinde isteğe bağlıdır, bu yüzden düzeltme sonrasındaki kontrol önemlidir.
TERM bir isimdir, terminfo ise veritabanıdır
TERM tek bir dizge tutar ve bu dizge yalnızca bir anahtardır. terminfo, terminal tanımlarının derlenmiş bir veritabanıdır ve anahtar, bir programın doğru tanımı nasıl bulacağını belirler. Bir tanım; terminalin kaç renk desteklediğini, imleci 12. satır 40. sütuna taşıyan bayt dizilerini, F5 tuşunun gönderdiği baytları ve stilize alt çizgi çizip çizemeyeceğini kaydeder. Linux üzerindeki hemen hemen tüm metin tabanlı kullanıcı arayüzlerinin üzerine inşa edildiği ncurses kütüphanesi, başlangıçta bu tanımı okur. top, less, nano ve watch gibi programlar, bu tanım olmadan tek bir ekranı bile çizemezler.
Kendi girdinizi inceleyin:
echo "$TERM"
tput longname
infocmp -1 | head -20tput longname, TERM ile belirtilen girdinin insan tarafından okunabilir tanımını yazdırır. xterm-256color için şu çıktıyı verir:
xterm with 256 colorsinfocmp -1, girdinin derlemesini çözer ve her bir yeteneği ayrı bir satıra yazdırır. infocmp -1 -x örneğinde olduğu gibi -x bayrağını eklemediğiniz sürece, genişletilmiş (kullanıcı tanımlı) yetenekleri hariç tutar. Her iki komut da çalışıyorsa, bu makinedeki veritabanı söz konusu terminali tanıyor demektir. Bir SSH bağlantısının diğer ucunda da sahip olmanız gereken durum budur.
Neden yalnızca SSH üzerinden hata veriyor
SSH yalnızca ismi gönderir, başka hiçbir şey iletmez. İstemci bir sözde uçbirim (pseudo-terminal) talep ettiğinde, TERM bu taleple birlikte iletilir. OpenSSH kılavuzu bu konuda nettir: "protokol gereği, bir sözde uçbirim talep edildiğinde TERM ortam değişkeni her zaman gönderilir". Bu nedenle VPS üzerindeki oturum kabuğunuz TERM=xterm-ghostty, xterm-kitty veya uçbirim öykünücünüzün kullandığı başka bir isim değerini alır. Bu ismin arkasındaki açıklama dizüstü bilgisayarınızda, yerel veritabanınızda kalır. Öykünücünüzün varlığından önce oluşturulmuş bir sunucu, bu ismi daha önce hiç duymamıştır. SSH bağlantısının kendisi içerisinde uçbirim açıklamalarını kopyalayan hiçbir mekanizma yoktur ve bu kasıtlı bir durumdur: protokol bir yetenek dökümü değil, yalnızca bir isim taşır.
Hatanın aynısını kendi makinenizde, kesinlikle var olmayan bir isimle yeniden oluşturun:
TERM=xterm-nosuchthing tput colors
echo "$?"tput: unknown terminal "xterm-nosuchthing"Çıkış durumu 3'dur; tput kılavuzu bunu "tanınmayan uçbirim türü" olarak tanımlar. Her curses programı aynı arama işlemini gerçekleştirir, bu nedenle tek bir eksik isim, her programda farklı bir hata mesajına yol açsa da hepsinin arkasında tek bir neden yatar. nano, başlangıçta bir açıklama yükleyemediğinde ortaya çıkan standart ncurses hatası olan Error opening terminal: xterm-nosuchthing. ile durur. vim, E558: Terminal entry not found in terminfo çıktısını verir. less, WARNING: terminal is not fully functional çıktısını verir. Kısmen çalışan bir sayfalayıcı (pager) ile başlamayı reddeden bir düzenleyici, birbirinden bağımsız hatalar gibi görünür. Oysa bunlar aynı eksik dosyadan kaynaklanmaktadır.
ncurses girişleri nerede arar
ncurses, terminfo(5) içinde belgelenen sabit bir sırada arama yapar:
- Eğer ayarlanmışsa
$TERMINFO. İlk olarak burası kontrol edilir. $HOME/.terminfo. Kılavuz bunu "kütüphaneden tamamen çıkarılabilecek isteğe bağlı bir özellik" veya ayrıcalıklı programların yanlışlıkla kullanmaması için sınırlandırılmış bir özellik olarak tanımlar.$TERMINFO_DIRSiçinde listelenen her dizin.- Debian ve Ubuntu üzerinde
/etc/terminfo,/lib/terminfove/usr/share/terminfodizinlerini içeren, derleme sırasında tanımlanmış konumlar.
Yukarıdaki yollara güvenmek yerine, sunucunuzun kendi ncurses derlemesinin kullandığı listeyi yazdırmak için sunucuda infocmp -D komutunu çalıştırın. 2. adım tüm işin püf noktasıdır. Debian'ın ncurses derlemesi bu özelliği kapatmaz ve bu özelliğin bulunduğu yerlerde ev dizininiz herhangi bir sistem dizininden önce aranır; bu nedenle ~/.terminfo altında bulunan tek bir dosya, paket kurulumu veya root yetkisi gerektirmeden hesabınız için arama yolunu düzeltir. Düzeltmeden sonra tput longname komutunu çalıştırmak, sunucunuzun derlemesinin bu ayarı dikkate alıp almadığını size söyler. Tek istisna 1. adımdır: Eğer sunucuda echo "$TERMINFO" bir çıktı veriyorsa, o konum ilk olarak kontrol edilir ve orada aynı ada sahip bir giriş varsa sizin girişinizden önce gelir.
Çözüm 1: Sunucunun halihazırda bildiği bir TERM kullanın
En hızlı engel kaldırma yöntemi, tek bir bağlantı için farklı bir terminal ismi tanımlamaktır:
TERM=xterm-256color ssh user@203.0.113.10Bunu dizüstü bilgisayarınızdaki ~/.ssh/config dosyasında ilgili sunucu için kalıcı hale getirin:
Host vps1
HostName 203.0.113.10
User deploy
SetEnv TERM=xterm-256colorTERM değerini geçersiz kılmak için SetEnv kullanmak, istemci tarafında Ağustos 2021'de yayınlanan OpenSSH 8.7 veya daha yeni bir sürümü gerektirir. Daha eski istemciler, bu satıra bakılmaksızın terminal emülatörünüzün kendi TERM değerini gönderir. TERM, sunucunun iznine ihtiyaç duymayan tek değişkendir: kılavuzda "SendEnv'e benzer şekilde, TERM değişkeni hariç, sunucunun ortam değişkenini kabul etmeye hazır olması gerekir" ifadesi yer alır. Bu nedenle, bu yöntem AcceptEnv satırı bulunmayan sıkılaştırılmış bir sshd üzerinde bile çalışır.
Maliyeti: Emülatörünüzün düz xterm-256color ötesinde tanımladığı her şeydir. Buna, RGB yeteneği aracılığıyla duyurulan 24-bit renk desteği ve Smulx aracılığıyla sağlanan biçimlendirilmiş alt çizgiler dahildir. terminfo girdisine dayanan programlar bu yetenekleri artık göremez; bu nedenle, dizileri yine de göndermeleri için yapılandırmadığınız sürece 256 renge ve düz alt çizgiye geri dönerler. Örneğin Vim, yerleşik t_8f ve t_8b dizileri çoğu terminalde çalıştığı için set termguicolors ile 24-bit renkleri hala çizebilir. Ekran çalışır. Sadece seçtiğiniz terminalden daha az yetenekli hale gelir.
Bu sorunu sunucudaki .bashrc dosyanıza export TERM=xterm-256color ekleyerek çözmeyin. Bu dosya, sunucunun ismini bildiği bir terminalden gelen bağlantılar da dahil olmak üzere her bağlantıda çalışır; bu nedenle zaten düzgün çalışan oturumların kalitesini düşürür. Geçersiz kılma işlemini, hangi emülatörü çalıştırdığınızı bildiğiniz istemci tarafında tutun.
Çözüm 2: terminfo girdinizi sunucuya bir kez gönderin
Bu çözüm, emülatörünüzü olduğu gibi korumanızı sağlar. Girdiyi yerel olarak derleyin, SSH üzerinden aktarın ve uzak tarafta tekrar derleyin:
infocmp -x | ssh user@203.0.113.10 -- tic -x -infocmp -x, mevcut TERM değeriniz için girdiyi, genişletilmiş (kullanıcı tanımlı) yetenekler dahil olmak üzere kaynak metin olarak yazdırır. tic -x, bu kaynağı sunucuda tekrar ikili bir açıklamaya dönüştürür. Her iki taraftaki -x kullanımı önemlidir; çünkü bu olmadan Smulx gibi yetenekler aktarım sırasında kaybolur ve kendi terminalinizin düşük özellikli bir kopyasını göndermiş olursunuz.
tic, mümkün olduğunda sistem dizinine yazar; yazma erişimi olmadığında ise $HOME/.terminfo konumuna geri döner. Bir VPS üzerindeki standart bir hesap, ev dizinini kullanır; bu da tam olarak istediğiniz durumdur. Hedef dizini de belirtebilirsiniz:
infocmp -x | ssh user@203.0.113.10 -- tic -x -o '~/.terminfo' /dev/stdin~/.terminfo etrafındaki tırnak işaretleri süs değildir. ssh, komut kelimelerini tek bir dizge halinde birleştirir ve uzak kabuğa iletir; bu nedenle tırnak içine alınmamış bir ~, önce yerel kabuğunuz tarafından genişletilir. Bu durumda, hesabınızın farklı bir isimde olabileceği bir makineye sabit bir /home/yourname/.terminfo göndermiş olursunuz. tic, izin hatası nedeniyle başarısız olur veya ncurses'ın asla aramadığı bir yola yazmaya çalışır. Tilde işaretini tırnak içine alın; böylece uzak kabuk bunu doğru şekilde genişletecektir.
Oturum açın ve kontrol edin:
ssh user@203.0.113.10
tput longname
ls -R ~/.terminfotput longname ile terminal açıklamanızın yazdırılması, aramanın başarılı olduğunu gösterir; ls ise derlenmiş dosyayı, terminal isminin ilk harfiyle adlandırılmış bir alt dizin altında gösterir. Ardından top komutunu veya ekranı aynı kütüphane üzerinden yeniden çizen watch -n1 uptime komutunu çalıştırarak gerçek bir curses programının ekranı düzgün çizdiğini doğrulayın.
Maliyeti: sunucu başına bir adım ve girdi, tek bir makinedeki tek bir hesabın ev dizininde yaşar. VPS'i yeniden kurduğunuzda girdi silinir. Yeni bir sunucu girdi hazır bir şekilde gelsin istiyorsanız, bu komutu birden fazla sunucuyu aynı anda hazırlamak ve yönetmek için kullandığınız araca ekleyin.
Çözüm 3: Genişletilmiş terminfo veritabanını yükleyin
root yetkisine sahipseniz ve terminal isminin sunucudaki her hesap için çözümlenmesini istiyorsanız:
sudo apt update
sudo apt install ncurses-term
tput -T xterm-ghostty longnamencurses-term, temel kurulumda eksik bırakılan terminal tanımlarını içerir. Bu çözüm, 2. çözümün aksine hem root hem de diğer tüm kullanıcılar için terminal ismini düzeltir.
Bu yöntem yalnızca terminalinizin tanımı, dağıtımınızın paketlediği ncurses sürümünde mevcutsa işe yarar; bu yüzden varsaymak yerine kontrol edin. Ubuntu 24.04, (Kasım 2026 itibarıyla) ncurses-bin 6.4+20240113-1ubuntu2.2 sürümüyle gelmektedir. Ghostty'nin tanımı upstream ncurses 6.5-20241228 sürümünde eklenmiştir; bu sürüm daha güncel olduğu için, ne kadar çalıştırırsanız çalıştırın Ubuntu 24.04 üzerindeki apt install ncurses-term bir xterm-ghostty tanımı üretemez. Kontrol için tput -T <name> longname kullanılır: tanım mevcutsa açıklamayı yazdırır, mevcut değilse 3 çıkış koduyla unknown terminal hatası verir.
Tüm paketi yüklemek yerine tek bir tanımı sistem genelinde kurmak için kaynak dosyasını kopyalayın ve root olarak derleyin:
infocmp -x | ssh user@203.0.113.10 -- 'cat > /tmp/term.src'
ssh -t user@203.0.113.10 -- sudo tic -x -o /usr/share/terminfo /tmp/term.srcİkinci komuttaki -t, bir pseudo terminal tahsis eder; böylece sudo parola isteminde bulunabilir. Bu parametre olmadan ssh, uzak bir komut için terminal tahsis etmez ve sudo, parola gerektiğinde sudo: a terminal is required to read the password; either use the -S option to read from standard input or configure an askpass helper hatasıyla durur. Bu hata, terminfo ile ilgili değil, eksik tty ile ilgilidir.
Aktarımı emülatöre bırakın
Bazı emülatörler, 2 numaralı düzeltmeyi sizin yerinize gerçekleştiren bir yardımcı araçla gelir. kitty, ssh kitten aracına sahiptir: kitten ssh myserver komutu, uzak sunucuya bağlanır ve kitty'nin terminfo dosyasını otomatik olarak kopyalar. Belgeleri, yukarıda açıklanan nedenlerden dolayı tilde işaretinin kaçış karakteriyle kullanıldığı infocmp -a xterm-kitty | ssh myserver tic -x -o \~/.terminfo /dev/stdin manuel biçimini de sunar. Ghostty, infocmp -x xterm-ghostty | ssh YOUR-SERVER -- tic -x - özelliğini belgeler ve 1.2.0 sürümünden itibaren her iki düzeltmeyi de otomatikleştiren isteğe bağlı kabuk entegrasyonu özelliklerini (ssh-env ve ssh-terminfo) içerir. 27 Ekim 2026 tarihinde yayınlanan Ghostty 1.4.0 sürümü, 1.3.x sürümlerinde bulunmayan bir ghostty +ssh sarmalayıcısı ekler ve söz konusu iki isteğe bağlı özellik artık bu sarmalayıcıyı çağırır. Bu araç, bağlantı kurulmadan önce Ghostty ile birlikte gelen terminfo dosyasını uzak sunucuya yükler; kurulum başarısız olduğunda (örneğin sunucuda tic bulunmadığında) TERM=xterm-256color yöntemine geri döner. 1.4 sürümünde ssh-env, ~/.ssh/config içindeki SetEnv satırlarını geçersiz kılmayı da durdurur; böylece 1 numaralı düzeltmeden gelen sunucu bazlı geçersiz kılma ayarları korunur.
Bu yardımcı araçlar, az önce manuel olarak çalıştırdığınız komutların aynısını yürütür. Manuel yöntemi bilmek hala önemlidir; çünkü bağlantı başka bir yerde, bir atlama sunucusunda (jump host) veya bir betik içinde başladığında yardımcı araç devreye giremez.
Hata geri döndüğünde
sudo -i altında. root olarak açılan bir oturum kabuğu HOME=/root değerine sahiptir ve sudo, TERM değerinizi korur. ncurses artık girişinizi barındırmayan /root/.terminfo dizinini arar, bu nedenle hata yalnızca root kullanıcısı için geri döner. sudo -i env ile doğrulama yapın ve HOME ile TERM satırlarını okuyun. Girişi sistem dizinine yükleyin. /root/.terminfo içindeki bir kopya da çalışabilir, ancak ncurses ayrıcalıklı süreçler için ev dizini aramalarını sınırlayabilir; bu nedenle doğrulamak için root olarak tput longname komutunu çalıştırın.
tmux veya screen içinde. Bunlar, içlerinde çalışan programlar için genellikle screen-256color veya tmux-256color olan kendi TERM değerlerini belirler. Eski bir sunucu screen-256color değerini bilir ancak tmux-256color değerini tanımayabilir; bu durumda dış kabuk sağlıklı çalışırken oturum içindeki her şey başarısız olur. Sebep aynı, ancak isim farklıdır. Sunucuda hangisinin mevcut olduğunu görmek için tput -T tmux-256color longname komutunu çalıştırın. tmux etrafında oluşturulmuş bir terminal çalışma alanı, siz henüz düzeltmediğiniz bir ana makineye bağlanana kadar bu durumu gizler.
Yeni bir sunucuda. ~/.terminfo hesap ve makine bazlıdır, bu nedenle yeniden oluşturulan bir VPS tekrar boş başlar.
Ekran çiziliyor ancak tuşlar hatalı çalışıyor. Eğer görüntü düzgünse ancak Home, End veya fonksiyon tuşları beklenmedik karakterler ekliyorsa, terminal ismi terminalinizle eşleşmeyen bir girdiye çözümlenmiş demektir. Tuş dizileri, çizim yetenekleriyle aynı terminfo girdisinden gelir; bu nedenle yaklaşık bir girdi, yaklaşık tuş sonuçları verir. Bu durum, tuş dizileri xterm değerinden farklı olan bir emülatörde 1. düzeltmenin uygulanmasının tipik sonucudur. 2. düzeltme en temiz çözümdür, çünkü emülatörünüzün gerçek girdisi tüm programlar için doğru dizileri aynı anda taşır. Bu tek yol değildir: Vim belgeleri, "tuş kodunu :set komutuyla değiştirebileceğinizi" belirtir ve Vim, yalnızca girdiye güvenmek yerine başlangıçta güncel bir xterm'den tuş kodlarını doğrudan ister.
FAQ
SSH üzerinden neden sadece "unknown terminal type" hatası alıyorum?
Çünkü terminalinizin girişini barındırması gereken veritabanı sunucuda bulunan veritabanıdır. Terminal emülatörünüz, kendi açıklamasını çalıştığı makineye yükler; bu sayede yerel programlar herhangi bir çaba gerektirmeden bu açıklamayı bulabilir. SSH, protokol isteğiyle birlikte sadece terminal adını taşıdığı için TERM değerini gönderir. Uzak sunucudaki ncurses, bu ismi uzak veritabanında arar ve hiçbir şey bulamaz; bu nedenle initscr başarısız olur ve program durur.
Bunu sunucuda root yetkisi olmadan düzeltebilir miyim?
Evet, Debian gibi standart bir yapıda düzeltebilirsiniz. ncurses, herhangi bir sistem dizininden önce $HOME/.terminfo yolunu arar. Sunucuda ayarlanmış bir $TERMINFO değişkeni daha önce kontrol edilir, bu yüzden normal durumlarda hesabınız için orada bir giriş olması yeterlidir. Ev dizini araması ncurses içinde isteğe bağlıdır, bu yüzden aşağıdaki tput longname kontrolü önemlidir. Sunucu başına bir kez infocmp -x | ssh user@host -- tic -x - komutunu çalıştırın. tic, sistem yoluna yazamadığı durumlarda (yetkisiz bir hesap için normal durum budur) ev dizininize yazar. Çıkış yapıp tekrar girin ve aramanın artık çözümlendiğini doğrulamak için tput longname komutunu çalıştırın.
Bir ana makine için TERM=xterm-256color ayarını yaptığımda ne kaybederim?
Emülatörünüzün xterm-256color girişinin ötesinde tanımladığı tüm yetenekleri kaybedersiniz; örneğin RGB üzerinden 24-bit renk desteği ve Smulx üzerinden stillendirilmiş alt çizgiler gibi. terminfo girişine dayanan programlar bu yetenekleri göremez, bu yüzden siz aksi bir yapılandırma yapmadıkça (Vim'in renk için termguicolors seçeneğinde olduğu gibi) en yakın yedekleme ayarını kullanırlar. Fonksiyon tuşu dizileri de gerçek terminalinizden farklı olabilir. Bu ayarı sunucudaki bir .bashrc dosyası yerine, istemci tarafındaki ~/.ssh/config dosyasında yapın; aksi takdirde zaten çalışan terminallerden gelen oturumların kalitesini düşürmüş olursunuz.
Hata neden sudo -i komutundan sonra geri geliyor?
sudo -i, TERM değerinizi korurken HOME=/root ile root olarak bir oturum açma kabuğu başlatır. ncurses bu durumda kendi ev dizininiz yerine /root/.terminfo yolunu arar ve hiçbir şey bulamaz; bu yüzden root, sizin hesabınızda artık görmediğiniz aynı hatayı alır. sudo -i env komutunu çalıştırın ve HOME ile TERM satırlarını kontrol edin. Girişi sudo tic -x -o /usr/share/terminfo ile sistem dizinine derleyin. /root/.terminfo içindeki bir kopya da çalışabilir, ancak ncurses ayrıcalıklı süreçler için ev dizini aramasını kısıtlayabilir; bu yüzden root olarak tput longname ile doğrulama yapın.
apt install ncurses-term her zaman sorunu çözer mi?
Hayır. Sadece dağıtımınızın paketlediği ncurses sürümünde var olan girişleri ekler. Ubuntu 24.04, ncurses 6.4 (Kasım 2026 itibarıyla ncurses-bin 6.4+20240113-1ubuntu2.2) ile gelir ve Ghostty girişi ncurses 6.5-20241228 sürümünde yukarı akışa (upstream) eklendiği için bu paket onu içeremez. Pakete güvenmeden önce tput -T <name> longname ile kontrol edin ve kontrol hala bilinmeyen bir terminal bildiriyorsa girişi kendiniz gönderin.