Cara Selesai Ralat 'unknown terminal type' SSH
Ralat unknown terminal type berlaku apabila pelayan tidak mengenali tetapan TERM anda. Selesaikan isu ini tanpa akses root dengan memuat naik entri terminfo ke direktori rumah.
Apakah maksud "unknown terminal type"
Ralat "unknown terminal type" melalui SSH bermaksud nama dalam TERM tidak mempunyai entri yang sepadan dalam pangkalan data terminfo pada pelayan. Emulator anda menetapkan nama tersebut pada komputer riba anda. Pangkalan data yang perlu mengecamnya berada pada mesin jauh. Apabila carian gagal, setiap program curses pada pelayan tersebut berhenti sebelum ia melukis apa-apa, kerana ia tidak mempunyai deskripsi tentang keupayaan terminal anda.
Penyelesaian yang mengekalkan semua ciri emulator anda adalah satu arahan: kompil entri terminfo anda sendiri ke dalam ~/.terminfo pada pelayan. Pada binaan standard seperti Debian, ncurses mencari direktori rumah anda sebelum mana-mana direktori sistem (hanya pemboleh ubah $TERMINFO, jika ditetapkan, disemak lebih awal), jadi ini tidak memerlukan root dan tidak mengubah apa-apa untuk pengguna lain. Carian direktori rumah itu adalah pilihan dalam ncurses, itulah sebabnya semakan selepas pembaikan adalah penting.
TERM ialah satu nama, manakala terminfo ialah pangkalan datanya
TERM menyimpan satu rentetan, dan rentetan itu hanyalah satu kunci. terminfo ialah pangkalan data yang dikompilasi bagi deskripsi terminal, dan kunci tersebut merupakan cara program mencari deskripsi yang tepat. Satu deskripsi merekodkan bilangan warna yang dimiliki oleh terminal, bait yang menggerakkan kursor ke baris 12 lajur 40, bait yang dihantar oleh kekunci F5, serta sama ada ia boleh melukis garis bawah bergaya. ncurses, iaitu pustaka yang menjadi asas kepada hampir setiap antara muka pengguna teks pada Linux, membaca deskripsi tersebut semasa permulaan. Program seperti top, less, nano dan watch tidak boleh memaparkan satu skrin pun tanpanya.
Lihat entri anda sendiri:
echo "$TERM"
tput longname
infocmp -1 | head -20tput longname mencetak deskripsi yang boleh dibaca manusia bagi apa sahaja yang dinamakan oleh TERM. Bagi xterm-256color, ia mencetak:
xterm with 256 colorsinfocmp -1 menyahkompilasi entri tersebut dan mencetak satu keupayaan bagi setiap baris. Ia meninggalkan keupayaan lanjutan (yang ditakrifkan pengguna) melainkan anda menambah -x, seperti dalam infocmp -1 -x. Jika kedua-dua arahan berfungsi, pangkalan data pada mesin ini mengenali terminal ini. Itulah keadaan yang anda perlukan pada bahagian hujung sambungan SSH juga.
Mengapa ia hanya tergendala melalui SSH
SSH menghantar nama tersebut dan tiada yang lain. Apabila klien meminta pseudo terminal, TERM dihantar bersama permintaan tersebut. Manual OpenSSH menyatakan dengan jelas: "pemboleh ubah persekitaran TERM sentiasa dihantar apabila pseudo-terminal diminta kerana ia diperlukan oleh protokol". Jadi, shell log masuk anda pada VPS menerima TERM=xterm-ghostty, atau xterm-kitty, atau apa jua nama yang digunakan oleh emulator anda. Huraian di sebalik nama itu kekal pada komputer riba anda, dalam pangkalan data komputer riba anda. Pelayan yang dibina sebelum emulator anda wujud tidak pernah mengenali nama tersebut. Tiada apa-apa dalam sambungan SSH itu sendiri menyalin huraian terminal, dan itu adalah disengajakan: protokol tersebut membawa nama, bukan lambakan keupayaan.
Ulangi kegagalan tersebut pada mesin anda sendiri dengan nama yang sememangnya tidak wujud:
TERM=xterm-nosuchthing tput colors
echo "$?"tput: unknown terminal "xterm-nosuchthing"Status keluar adalah 3, yang didokumenkan oleh manual tput sebagai "jenis terminal tidak dikenali". Setiap program curses menjalankan carian yang sama, jadi satu nama yang hilang menghasilkan mesej berbeza daripada setiap program dengan satu punca di sebalik kesemuanya. nano berhenti dengan Error opening terminal: xterm-nosuchthing., kegagalan ncurses standard apabila ia tidak dapat memuatkan huraian semasa permulaan. vim mencetak E558: Terminal entry not found in terminfo. less mencetak WARNING: terminal is not fully functional. Pager yang berfungsi separuh jalan dan editor yang enggan bermula kelihatan seperti pepijat yang tidak berkaitan. Ia sebenarnya adalah fail hilang yang sama.
Lokasi ncurses mencari entri
ncurses membuat carian mengikut urutan tetap, seperti yang didokumentasikan dalam terminfo(5):
$TERMINFO, jika ia ditetapkan. Ia diperiksa terlebih dahulu.$HOME/.terminfo. Manual memanggil ini sebagai "ciri pilihan yang mungkin ditinggalkan sepenuhnya daripada pustaka", atau dihadkan supaya program yang mempunyai keistimewaan tidak menggunakannya secara tidak sengaja.- setiap direktori yang disenaraikan dalam
$TERMINFO_DIRS. - lokasi yang dikompilasi masuk, yang pada Debian dan Ubuntu merangkumi
/etc/terminfo,/lib/terminfodan/usr/share/terminfo.
Jalankan infocmp -D pada pelayan untuk mencetak senarai yang digunakan oleh binaan ncurses miliknya, daripada mempercayai laluan di atas. Langkah 2 adalah helah keseluruhannya. Binaan ncurses Debian tidak mematikannya, dan di mana ia wujud, direktori rumah anda dicari sebelum mana-mana direktori sistem, jadi satu fail di bawah ~/.terminfo membetulkan carian untuk akaun anda tanpa pemasangan pakej dan tanpa root. Menjalankan tput longname selepas pembetulan memberitahu anda sama ada binaan pelayan anda mematuhinya. Satu pengecualian ialah langkah 1: jika echo "$TERMINFO" mencetak sesuatu pada pelayan, lokasi tersebut diperiksa terlebih dahulu, dan entri di sana dengan nama yang sama akan mengatasi entri anda.
Pembaikan 1: gunakan TERM yang sudah dikenali oleh pelayan
Cara terpantas untuk menyahsekat adalah dengan menamakan terminal yang berbeza untuk satu sambungan:
TERM=xterm-256color ssh user@203.0.113.10Jadikannya kekal untuk hos tersebut dalam ~/.ssh/config pada komputer riba anda:
Host vps1
HostName 203.0.113.10
User deploy
SetEnv TERM=xterm-256colorMenggunakan SetEnv untuk mengatasi TERM memerlukan OpenSSH 8.7 atau lebih baharu pada klien, yang dikeluarkan pada Ogos 2021. Klien yang lebih lama akan menghantar TERM emulator anda sendiri tanpa mengira baris ini. TERM ialah satu-satunya pemboleh ubah yang tidak memerlukan kebenaran pelayan: manual menyatakan "Sama seperti SendEnv, kecuali untuk pemboleh ubah TERM, pelayan mesti bersedia untuk menerima pemboleh ubah persekitaran". Jadi, ini berfungsi walaupun terhadap sshd yang diperketatkan tanpa sebarang baris AcceptEnv.
Kosnya: segala yang diterangkan oleh emulator anda selain daripada xterm-256color biasa. Ini termasuk warna 24-bit yang diiklankan melalui keupayaan RGB dan garis bawah bergaya melalui Smulx. Program yang bergantung pada entri terminfo tidak lagi dapat melihat keupayaan tersebut, jadi ia kembali kepada 256 warna dan garis bawah biasa melainkan anda mengkonfigurasinya untuk menghantar jujukan tersebut. Vim, sebagai contoh, masih boleh memaparkan warna 24-bit dengan set termguicolors, kerana jujukan t_8f dan t_8b terbina dalamnya berfungsi untuk kebanyakan terminal. Skrin berfungsi. Ia hanya kurang berkeupayaan berbanding terminal yang anda pilih.
Jangan selesaikan masalah ini dengan menambah export TERM=xterm-256color ke dalam .bashrc anda pada pelayan. Fail tersebut dijalankan untuk setiap sambungan, termasuk sambungan daripada terminal yang namanya dikenali oleh pelayan, jadi ia akan menurunkan taraf sesi yang sebenarnya sudah berfungsi dengan baik. Kekalkan penggantian pada klien, di mana anda tahu emulator mana yang anda jalankan.
Pembaikan 2: hantar entri terminfo anda ke pelayan sekali sahaja
Ini adalah pembaikan yang mengekalkan emulator anda dalam keadaan asal. Nyahkompil entri tersebut secara setempat, salurkan melalui SSH, dan kompil ia di bahagian pelayan:
infocmp -x | ssh user@203.0.113.10 -- tic -x -infocmp -x mencetak entri untuk TERM semasa anda sebagai teks sumber, termasuk keupayaan lanjutan (yang ditakrifkan pengguna). tic -x mengkompil semula sumber tersebut menjadi deskripsi binari di pelayan. -x pada kedua-dua belah pihak adalah penting, kerana tanpanya keupayaan seperti Smulx akan digugurkan semasa transit dan anda menghantar salinan terminal anda yang telah diturun taraf.
tic menulis ke dalam direktori sistem apabila ia boleh, dan kembali kepada $HOME/.terminfo apabila pengguna tidak mempunyai akses tulis di sana. Akaun biasa pada VPS akan mendapat direktori rumah, yang merupakan apa yang anda mahukan. Anda juga boleh menamakan destinasi:
infocmp -x | ssh user@203.0.113.10 -- tic -x -o '~/.terminfo' /dev/stdinTanda petikan di sekeliling ~/.terminfo bukan sekadar hiasan. ssh mencantumkan perkataan arahan menjadi satu rentetan dan menyerahkannya kepada shell jauh, jadi ~ yang tidak bertanda petikan akan dikembangkan oleh shell setempat anda terlebih dahulu. Anda kemudian menghantar /home/yourname/.terminfo literal ke mesin di mana akaun anda mungkin dipanggil dengan nama lain. tic akan gagal dengan ralat kebenaran, atau ia menulis ke dalam laluan yang tidak pernah dicari oleh ncurses. Letakkan tanda petikan pada tilde dan shell jauh akan mengembangkannya.
Log masuk dan semak:
ssh user@203.0.113.10
tput longname
ls -R ~/.terminfotput longname yang mencetak deskripsi terminal anda bermakna carian kini berjaya, dan ls menunjukkan fail yang telah dikompil di bawah subdirektori yang dinamakan mengikut huruf pertama nama terminal. Kemudian jalankan top, atau watch -n1 uptime, yang melukis semula melalui pustaka yang sama, untuk mengesahkan program curses sebenar memaparkan skrin.
Kosnya: satu langkah bagi setiap pelayan, dan entri tersebut kekal dalam direktori rumah satu akaun pada satu mesin. Bina semula VPS dan ia akan hilang. Masukkan arahan tersebut ke dalam apa sahaja yang anda gunakan untuk memperuntukkan dan mengurus beberapa pelayan serentak supaya hos baharu tiba dengan entri yang telah dikompil.
Pembaikan 3: pasang pangkalan data terminfo lanjutan
Jika anda mempunyai akses root dan mahu nama tersebut diselesaikan untuk setiap akaun pada mesin tersebut:
sudo apt update
sudo apt install ncurses-term
tput -T xterm-ghostty longnamencurses-term menyimpan deskripsi terminal yang tidak disertakan dalam pemasangan asas. Ia membetulkan nama untuk root dan untuk setiap pengguna lain, sesuatu yang tidak dilakukan oleh pembaikan 2.
Ia hanya membantu apabila entri terminal anda wujud dalam keluaran ncurses yang dibungkus oleh pengedaran anda, jadi semak dahulu dan jangan terus membuat andaian. Ubuntu 24.04 membekalkan ncurses-bin 6.4+20240113-1ubuntu2.2 (sehingga November 2026). Entri Ghostty telah ditambah dalam ncurses 6.5-20241228, yang lebih baharu, jadi apt install ncurses-term pada Ubuntu 24.04 tidak dapat menghasilkan entri xterm-ghostty tidak kira berapa kerap anda menjalankannya. tput -T <name> longname ialah cara semakan: ia mencetak deskripsi apabila entri tersebut hadir, dan unknown terminal dengan status keluar 3 apabila ia tidak hadir.
Untuk memasang satu entri secara sistem-luas dan bukannya keseluruhan pakej, salin sumber tersebut dan kompil ia sebagai root:
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-t pada arahan kedua memperuntukkan pseudo terminal, supaya sudo boleh meminta kata laluan. Tanpanya, ssh tidak memperuntukkan terminal untuk arahan jauh, dan sudo berhenti dengan sudo: a terminal is required to read the password; either use the -S option to read from standard input or configure an askpass helper apabila ia memerlukan kata laluan. Ralat tersebut adalah mengenai ketiadaan tty, bukan mengenai terminfo.
Biarkan emulator melakukan pemindahan
Beberapa emulator menyertakan pembantu yang melaksanakan pembaikan 2 untuk anda. kitty mempunyai ssh kitten: kitten ssh myserver menyambung dan menyalin terminfo kitty ke hos jauh secara automatik. Dokumentasinya juga memberikan bentuk manual, infocmp -a xterm-kitty | ssh myserver tic -x -o \~/.terminfo /dev/stdin, dengan tilde yang di-escape atas sebab yang diterangkan di atas. Ghostty mendokumentasikan infocmp -x xterm-ghostty | ssh YOUR-SERVER -- tic -x -, dan sejak versi 1.2.0 menyertakan ciri integrasi shell pilihan (ssh-env dan ssh-terminfo) yang mengautomasikan kedua-dua pembaikan tersebut. Ghostty 1.4.0, yang dikeluarkan pada 27 Oktober 2026, menambah pembungkus ghostty +ssh yang tidak dimiliki oleh keluaran 1.3.x, dan kedua-dua ciri pilihan tersebut kini memanggilnya. Ia memasang terminfo yang dibundel oleh Ghostty pada hos jauh sebelum menyambung, dan kembali kepada TERM=xterm-256color apabila pemasangan itu gagal, contohnya apabila pelayan tidak mempunyai tic. Dalam versi 1.4, ssh-env juga berhenti mengatasi baris SetEnv dalam ~/.ssh/config, jadi penggantian per-hos daripada pembaikan 1 akan dihormati.
Pembantu ini menjalankan arahan yang sama seperti yang anda baru jalankan secara manual. Mengetahui bentuk manual masih penting, kerana pembantu tidak boleh bertindak apabila sambungan bermula di tempat lain, pada jump host atau di dalam skrip.
Apabila ralat kembali muncul
Di bawah sudo -i. Shell log masuk sebagai root mempunyai HOME=/root, dan sudo mengekalkan TERM anda. ncurses kini mencari /root/.terminfo, yang tidak mengandungi entri anda, jadi kegagalan berlaku untuk root sahaja. Sahkan dengan sudo -i env dan baca baris HOME serta TERM. Pasang entri tersebut ke dalam direktori sistem. Salinan dalam /root/.terminfo juga boleh berfungsi, tetapi ncurses mungkin mengehadkan carian direktori home untuk proses yang mempunyai keistimewaan, jadi jalankan tput longname sebagai root untuk mengesahkan.
Di dalam tmux atau screen. Ini menetapkan TERM mereka sendiri untuk program yang berjalan di dalamnya, biasanya screen-256color atau tmux-256color. Pelayan yang lebih lama mengenali screen-256color dan mungkin tidak mengenali tmux-256color, jadi shell luaran berada dalam keadaan baik manakala segala-galanya di dalam sesi gagal. Punca yang sama, nama yang berbeza. Jalankan tput -T tmux-256color longname pada pelayan untuk melihat yang mana satu daripada kedua-duanya yang ada. terminal workbench built around tmux menyembunyikan perkara ini sehingga hari anda membuat sambungan pada hos yang belum anda baiki.
Pada pelayan baharu. ~/.terminfo adalah mengikut akaun dan mengikut mesin, jadi VPS yang dibina semula bermula dengan kosong semula.
Skrin memaparkan, kekunci tidak berfungsi dengan betul. Jika paparan adalah baik tetapi Home, End atau kekunci fungsi memasukkan aksara yang tidak sepatutnya, nama tersebut diselesaikan kepada entri yang tidak sepadan dengan terminal anda. Jujukan kekunci datang daripada entri terminfo yang sama seperti keupayaan melukis, jadi entri yang hampir tepat memberikan kekunci yang hampir tepat. Itu adalah hasil biasa daripada pembaikan 1 pada emulator yang jujukan kekuncinya berbeza daripada xterm. Pembaikan 2 adalah jawapan yang paling bersih, kerana entri sebenar emulator anda membawa jujukan yang betul untuk setiap program serentak. Ia bukan satu-satunya laluan: dokumentasi Vim menyatakan anda boleh "menukar kod kekunci dengan arahan :set", dan Vim meminta xterm terkini untuk kod kekuncinya secara terus semasa permulaan dan bukannya bergantung pada entri itu sahaja.
FAQ
Mengapa saya hanya melihat "unknown terminal type" melalui SSH?
Ini kerana pangkalan data yang menyimpan entri terminal anda berada pada pelayan. Emulator anda memasang deskripsinya pada mesin tempat ia dijalankan, jadi program tempatan menemuinya tanpa sebarang usaha daripada anda. SSH hanya menghantar nilai TERM, kerana protokol tersebut membawa nama itu bersama permintaan pseudo-terminal. ncurses pada pelayan jauh mencari nama tersebut dalam pangkalan data jauh dan tidak menemui apa-apa, jadi initscr gagal dan program terhenti.
Bolehkah saya membaiki ini tanpa akses root pada pelayan?
Boleh, pada binaan standard seperti Debian. ncurses mencari $HOME/.terminfo sebelum mana-mana direktori sistem, dan hanya pemboleh ubah $TERMINFO yang ditetapkan pada pelayan disemak lebih awal, jadi dalam kes biasa, entri di sana sudah memadai untuk akaun anda. Carian direktori home adalah pilihan dalam ncurses, itulah sebabnya semakan tput longname di bawah adalah penting. Jalankan infocmp -x | ssh user@host -- tic -x - sekali bagi setiap pelayan. tic menulis ke dalam direktori home anda apabila ia tidak dapat menulis ke laluan sistem, yang merupakan kes biasa bagi akaun tanpa keistimewaan. Log masuk dan jalankan tput longname untuk mengesahkan carian kini selesai.
Apa yang saya rugi dengan menetapkan TERM=xterm-256color untuk hos?
Setiap keupayaan yang diterangkan oleh emulator anda selain daripada entri xterm-256color, seperti warna 24-bit melalui RGB dan garis bawah bergaya melalui Smulx. Program yang bergantung pada entri terminfo tidak dapat melihat keupayaan tersebut, jadi ia menggunakan sandaran terdekat melainkan anda mengkonfigurasinya secara berbeza, seperti yang dilakukan oleh pilihan termguicolors pada Vim untuk warna. Jujukan kekunci fungsi juga mungkin berbeza daripada terminal sebenar anda. Letakkan tetapan tersebut pada klien dalam ~/.ssh/config dan bukannya dalam .bashrc pada pelayan, yang akan menurunkan taraf sesi daripada terminal yang sudah berfungsi.
Mengapa ralat kembali selepas sudo -i?
sudo -i memulakan shell log masuk sebagai root dengan HOME=/root, sambil mengekalkan nilai TERM anda. ncurses kemudian mencari /root/.terminfo dan bukannya direktori home anda sendiri dan tidak menemui apa-apa, jadi root melihat kegagalan yang sama yang tidak lagi dilihat oleh akaun anda. Jalankan sudo -i env dan semak baris HOME dan TERM. Kompil entri tersebut ke dalam direktori sistem dengan sudo tic -x -o /usr/share/terminfo. Salinan dalam /root/.terminfo juga boleh berfungsi, tetapi ncurses mungkin mengehadkan carian direktori home untuk proses berkeistimewaan, jadi sahkan dengan tput longname sebagai root.
Adakah apt install ncurses-term sentiasa membaikinya?
Tidak. Ia hanya menambah entri yang wujud dalam keluaran ncurses yang dibungkus oleh pengedaran anda. Ubuntu 24.04 membekalkan ncurses 6.4 (ncurses-bin 6.4+20240113-1ubuntu2.2, setakat November 2026), dan entri Ghostty telah ditambah dalam ncurses 6.5-20241228, jadi pakej tersebut tidak dapat memuatkannya. Semak dengan tput -T <name> longname sebelum bergantung pada pakej tersebut, dan bekalkan entri itu sendiri apabila semakan masih melaporkan terminal tidak diketahui.