File ~/.ssh/config: nama pendek alih-alih perintah panjang

Cara mendeskripsikan mesin sekali dan terhubung dengan perintah dua kata, mengatur key, user, port, dan menjaga koneksi tetap hidup.

Diperbarui 23 Agustus 2026

Daripada ssh -i ~/.ssh/id_ed25519 -p 22 root@203.0.113.10, Anda bisa mengetik ssh vds. Anda cukup mengaturnya sekali di komputer Anda.

Di mana file ini berada

Di macOS dan Linux, file ini ada di ~/.ssh/config. Di Windows, C:\Users\<you>\.ssh\config (jalur ~/.ssh/config yang sama di Windows Terminal). File ini mungkin belum ada — buatlah:

mkdir -p ~/.ssh
nano ~/.ssh/config
chmod 600 ~/.ssh/config

Izin akses itu penting: jika file ini bisa dibaca oleh semua orang, klien bisa menolak membacanya.

Entri minimal

Host vds
    HostName 203.0.113.10
    User root
    IdentityFile ~/.ssh/id_ed25519

Sekarang ini berfungsi:

ssh vds

Alat lain juga mengenali nama pendek ini:

scp dump.sql vds:/root/
sftp vds
rsync -avz ./site/ vds:/var/www/site/

Untuk menyalin file, lihat scp dan rsync dan SFTP.

Parameter yang berguna

Host vds
    HostName 203.0.113.10
    User artem
    Port 22
    IdentityFile ~/.ssh/id_ed25519
    IdentitiesOnly yes
    ServerAliveInterval 30
    ServerAliveCountMax 3

Parameter	Mengapa Anda membutuhkannya
`IdentitiesOnly yes`	Klien hanya menawarkan kunci yang ditentukan. Menyelamatkan Anda saat punya banyak kunci dan server memutus percobaan
`ServerAliveInterval`	Mengirim paket setiap 30 detik agar koneksi tidak terputus karena tidak ada aktivitas
`Port`	Jika Anda memindahkan SSH ke port non-standar
`User`	Nama pengguna default untuk host ini

Beberapa mesin

Host vds-web
    HostName 203.0.113.10
    User root
    IdentityFile ~/.ssh/id_ed25519

Host vds-db
    HostName 203.0.113.20
    User artem
    IdentityFile ~/.ssh/id_ed25519

Host *
    ServerAliveInterval 30

Blok Host * menetapkan pengaturan bersama untuk semua entri. Urutan itu penting: kecocokan pertama untuk setiap parameter yang menang, jadi letakkan blok bersama di bagian bawah.

Kesalahan umum

Indentasi tab dan spasi di akhir baris — sebagian klien mengeluh soal ini. Gunakan empat spasi.
Jalur kunci dengan backslash di Windows — tulis ~/.ssh/id_ed25519.
HostName tidak ada — klien kemudian akan mencoba terhubung ke host bernama vds dan tidak menemukannya.
Izin 644 pada file — ubah menjadi 600.

Untuk memeriksa apa yang sebenarnya berlaku pada sebuah host:

ssh -G vds
ssh -v vds

Perintah pertama mencetak parameter yang dihasilkan, perintah kedua menunjukkan proses koneksi — ini memberi tahu Anda kunci mana yang ditawarkan.

File config hanya menjelaskan sisi Anda. Apa yang diterima mesin ditentukan oleh /etc/ssh/sshd_config miliknya, lihat Kunci SSH.