Persiapan: Jalankan sebagai user biasa dengan sudo (jangan sudo -i), karena variabel NAMA hanya ada di shell Anda.
export NAMA=budi
sudo apt update
sudo apt install -y openssh-server tcpdump
ssh -V
systemctl is-active ssh
sudo ss -ltnp | grep ":22"
sudo ufw status
sudo ufw allow OpenSSH
Baris ufw allow hanya perlu jika UFW aktif. Jika UFW belum aktif, cukup catat statusnya. Hasil yang diharapkan: OpenSSH 9.x, layanan active, dan sshd listen di port 22.
Tahap 1: SFTP dasar dan bukti enkripsi
1.1 Cocokkan fingerprint host key. Server punya identitas kriptografis sendiri. Catat fingerprint-nya:
ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub
1.2 Tangkap paket sambil login SFTP. Lakukan hanya pada VM milik sendiri. Jalankan penangkap paket di latar belakang (90 detik), lalu login dengan akun admin Anda:
sudo -v
sudo timeout 90 tcpdump -i any -nn -A -l port 22 > ~/capture-sftp.txt 2>&1 &
sleep 3
sftp $USER@localhost
Pada pertanyaan pertama, bandingkan fingerprint yang ditampilkan dengan hasil 1.1 sebelum menjawab yes. Di dalam sftp> coba perintah berikut:
pwd
ls
cd /etc
ls
bye
Catat: akun admin biasa bisa menjelajah /etc, sama seperti user FTP tanpa chroot. Inilah alasan Tahap 2.
1.3 Periksa tangkapan paket:
sleep 5
grep -m3 "SSH-2.0" ~/capture-sftp.txt
grep -c "PASS" ~/capture-sftp.txt
rm ~/capture-sftp.txt
Yang terlihat hanya banner SSH-2.0-OpenSSH... di awal, sedangkan PASS berjumlah 0. Bandingkan dengan modul FTP, di mana USER dan PASS terbaca jelas.
1.4 Uji dari klien Windows: buka FileZilla, pilih protokol SFTP – SSH File Transfer Protocol, isi host (IP server), port 22, user admin, dan password. Cocokkan fingerprint pada dialog host key dengan hasil 1.1, lalu screenshot. Alternatifnya PowerShell: sftp user@IP_SERVER.
Tahap 2: User khusus SFTP dengan chroot
2.1 Buat grup dan user. User ini tidak punya shell, hanya boleh SFTP:
sudo groupadd sftponly
sudo useradd -m -s /usr/sbin/nologin -G sftponly ${NAMA}_sftp
sudo passwd ${NAMA}_sftp
id ${NAMA}_sftp
Home asli (/home/NAMA_sftp) tetap dibuat karena di sanalah authorized_keys dibaca pada Tahap 3.
2.2 Siapkan struktur folder. Aturan: setiap folder di jalur chroot harus dimiliki root dan tidak dapat ditulis grup atau orang lain. Hanya subfolder files yang dimiliki user:
sudo mkdir -p /srv/sftp/${NAMA}_sftp/files
sudo chown root:root /srv/sftp /srv/sftp/${NAMA}_sftp
sudo chmod 755 /srv/sftp /srv/sftp/${NAMA}_sftp
sudo chown ${NAMA}_sftp:${NAMA}_sftp /srv/sftp/${NAMA}_sftp/files
echo "Halo dari SFTP" | sudo -u ${NAMA}_sftp tee /srv/sftp/${NAMA}_sftp/files/selamat-datang.txt
namei -l /srv/sftp/${NAMA}_sftp/files
Perintah namei -l menampilkan pemilik dan mode tiap komponen jalur. Pastikan /, srv, sftp, dan NAMA_sftp semuanya root.
2.3 Tambahkan konfigurasi SSH. File drop-in dibaca otomatis dari /etc/ssh/sshd_config.d/. Tanda kutip pada 'EOF' penting agar %u tidak diubah oleh shell:
sudo tee /etc/ssh/sshd_config.d/50-sftp.conf > /dev/null <<'EOF'
Match Group sftponly
ChrootDirectory /srv/sftp/%u
ForceCommand internal-sftp
AllowTcpForwarding no
X11Forwarding no
PermitTunnel no
EOF
| Baris | Fungsi |
|---|---|
Match Group sftponly | Aturan di bawahnya hanya berlaku untuk anggota grup sftponly |
ChrootDirectory /srv/sftp/%u | Mengurung user di folder miliknya (%u diganti nama user) |
ForceCommand internal-sftp | Hanya SFTP, tanpa shell, dan tidak butuh file apa pun di dalam kurungan |
AllowTcpForwarding no, X11Forwarding no, PermitTunnel no | Menutup celah tunneling |
2.4 Validasi, lalu terapkan:
sudo sshd -t && echo "sintaks OK"
sudo sshd -T -C user=${NAMA}_sftp,host=localhost,addr=127.0.0.1 | grep -E "^(chrootdirectory|forcecommand|allowtcpforwarding|x11forwarding|permittunnel)"
sudo systemctl restart ssh
systemctl is-active ssh
Baris sshd -T -C menampilkan konfigurasi efektif untuk user itu, jadi Anda bisa memastikan blok Match benar-benar berlaku sebelum menguji.
2.5 Uji sebagai user SFTP:
sftp ${NAMA}_sftp@localhost
Di dalam sftp>, jalankan satu per satu dan catat hasilnya:
pwd
ls
cd /etc
put /etc/hostname uji-root.txt
cd files
put /etc/hostname uji-files.txt
ls -l
get selamat-datang.txt /tmp/unduhan.txt
bye
| Perintah | Hasil yang diharapkan |
|---|---|
pwd | / (akar kurungan, bukan /srv/sftp/...) |
ls | Hanya files |
cd /etc | Gagal |
put ... uji-root.txt | Ditolak (folder akar tidak dapat ditulis user) |
put ... uji-files.txt (di files) | Berhasil |
2.6 Uji bahwa shell ditolak:
ssh ${NAMA}_sftp@localhost
Hasil yang diharapkan: pesan This service allows sftp connections only. lalu koneksi ditutup.
2.7 Uji dari klien (FileZilla, protokol SFTP) dengan user NAMA_sftp. Screenshot: panel kanan hanya berisi files, unggahan ke files berhasil, dan unggahan ke folder akar ditolak.
Tahap 3: Login dengan kunci publik
3.1 Buat pasangan kunci di klien (Linux atau PowerShell Windows). Beri passphrase saat diminta:
ssh-keygen -t ed25519 -C "${NAMA}-sftp" -f ~/.ssh/id_ed25519_sftp
Di Windows PowerShell ganti path-nya dengan $env:USERPROFILE\.ssh\id_ed25519_sftp. Jika klien dan server adalah mesin yang sama, jalankan di server.
3.2 Tampilkan kunci publik (berkas berakhiran .pub) lalu salin barisnya:
cat ~/.ssh/id_ed25519_sftp.pub
(Windows: type $env:USERPROFILE\.ssh\id_ed25519_sftp.pub.)
3.3 Pasang kunci publik di server. Tempel baris kunci di antara tanda kutip. ssh-copy-id tidak akan berhasil untuk user ini karena ForceCommand melarang perintah shell, sehingga admin yang memasang kuncinya:
sudo mkdir -p /home/${NAMA}_sftp/.ssh
echo "TEMPEL_KUNCI_PUBLIK_DI_SINI" | sudo tee /home/${NAMA}_sftp/.ssh/authorized_keys
sudo chmod 700 /home/${NAMA}_sftp/.ssh
sudo chmod 600 /home/${NAMA}_sftp/.ssh/authorized_keys
sudo chown -R ${NAMA}_sftp:${NAMA}_sftp /home/${NAMA}_sftp/.ssh
sudo ls -la /home/${NAMA}_sftp/.ssh
3.4 Uji login dengan kunci (tidak ada permintaan password akun, hanya passphrase kunci):
sftp -i ~/.ssh/id_ed25519_sftp ${NAMA}_sftp@IP_SERVER
3.5 Matikan login password untuk grup ini (opsional, setelah 3.4 berhasil). Ubah blok Match menjadi:
sudo tee /etc/ssh/sshd_config.d/50-sftp.conf > /dev/null <<'EOF'
Match Group sftponly
ChrootDirectory /srv/sftp/%u
ForceCommand internal-sftp
AllowTcpForwarding no
X11Forwarding no
PermitTunnel no
PasswordAuthentication no
AuthenticationMethods publickey
EOF
sudo sshd -t && sudo systemctl restart ssh
Buktikan bahwa login password sekarang ditolak, sedangkan kunci tetap berhasil:
sftp -o PubkeyAuthentication=no -o PreferredAuthentications=password ${NAMA}_sftp@IP_SERVER
sftp -i ~/.ssh/id_ed25519_sftp ${NAMA}_sftp@IP_SERVER
Perintah pertama gagal dengan Permission denied (publickey). Hanya user di grup sftponly yang terpengaruh, dan akun admin tetap bisa login dengan password.
Log, bukti, dan pembersihan
sudo journalctl -u ssh -n 25 --no-pager
Catat baris Accepted password dan Accepted publickey, user, dan alamat IP klien. Jika Anda tidak sengaja menggagalkan login, baris Failed password atau Authentication refused akan memuat penyebabnya.
Bukti yang dikumpulkan:
- Fingerprint host key (server dibanding klien).
- Hasil tangkapan paket (banner saja, tanpa
PASS). namei -ldan isi50-sftp.conf.- Hasil
sshd -T -Cuntuk user SFTP. - Hasil lima perintah
sftp>di 2.5. - Pesan penolakan shell di 2.6.
- Login dengan kunci dan penolakan login password.
- Screenshot FileZilla (SFTP)
Pembersihan atau pemulihan (jika ingin mengembalikan ke kondisi awal):
sudo rm /etc/ssh/sshd_config.d/50-sftp.conf
sudo sshd -t && sudo systemctl restart ssh
sudo userdel -r ${NAMA}_sftp
sudo groupdel sftponly
sudo rm -rf /srv/sftp/${NAMA}_sftp
Troubleshooting
| Gejala | Penyebab umum | Perbaikan |
|---|---|---|
fatal: bad ownership or modes for chroot directory | Ada folder di jalur chroot yang bukan milik root atau dapat ditulis grup/orang lain | namei -l /srv/sftp/NAMA_sftp, lalu chown root:root dan chmod 755 |
| Koneksi langsung ditutup setelah login | Konfigurasi Match salah, atau chroot tidak valid | sudo sshd -t dan sudo journalctl -u ssh -n 30 |
Blok Match tidak berlaku | User belum di grup sftponly, atau sesi lama masih terbuka | id user, login ulang, dan cek dengan sshd -T -C |
Permission denied (publickey) | Kunci salah, atau izin .ssh dan authorized_keys terlalu longgar | sudo ls -la /home/NAMA_sftp/.ssh (700 dan 600, milik user), cek journalctl |
| Unggah ke folder akar ditolak | Memang diharapkan (folder akar tidak dapat ditulis) | Unggah ke files/ |
Peringatan host key berubah (REMOTE HOST IDENTIFICATION HAS CHANGED) | VM dibuat ulang atau kunci host berubah | Verifikasi fingerprint, lalu ssh-keygen -R IP_SERVER |
sshd -t galat Bad configuration option | Salah ketik | Perbaiki ejaan di 50-sftp.conf |
ssh-copy-id gagal untuk user SFTP | ForceCommand melarang perintah shell | Pasang kunci manual (3.3) |
Windows tidak punya perintah sftp | OpenSSH Client belum aktif | Pengaturan, Fitur Opsional, OpenSSH Client |
systemctl reload ssh tidak berefek | Aktivasi socket di Ubuntu 24.04 | Gunakan systemctl restart ssh |
Have Fun!

