Kurulum

quickssh'ı kendi bilgisayarınıza, tek container olarak ya da ekibiniz için merkezi bir sunucuya kurabilirsiniz. Hangisini seçerseniz seçin gereken temel şey Docker'dır.

Gereksinimler

Ne	Neden
Linux (x86_64)	Sunucu yalnızca Linux'ta çalışır. Hazır paket glibc 2.30 ve üstünü ister (Ubuntu 20.04+, Debian 11+).
Docker	VPN'ler ve uzak masaüstü servisi container olarak çalışır.
`ssh`, `ssh-keygen`	Bağlantılar sistemin OpenSSH'ı ile kurulur.
`sftp`, `curl`, `tar`	Dosya oturumları (SFTP, FTP) ve dosya aktarımı için.

FortiGate VPN'leri için çekirdekte ppp_async modülü yüklü olmalıdır.

Kendi bilgisayarınıza (Linux)

Paketi İndir sayfasından alın ya da doğrudan en son sürümü indirin; sonra iki dosyayı aynı dizine kurun:

curl -fLO https://quick-ssh.earthquick.dev/indir/quickssh-linux-x86_64.tar.gz
tar -xzf quickssh-linux-x86_64.tar.gz
sudo install -m 755 quickssh-*-linux-x86_64/quicksshd quickssh-*-linux-x86_64/quickssh /usr/local/bin/

Kullanıcınızın Docker'ı çalıştırabildiğinden emin olun:

docker info

Sonra uygulamayı açın:

quickssh

İlk açılışta VPN imajı derlenir; bu birkaç dakika sürebilir ve yalnızca bir kez yapılır. Uygulamayı masaüstünün uygulama menüsüne eklemek için:

quickssh install-desktop

Not: İstemci, sunucu uygulamasını (quicksshd) kendi yanında, yoksa PATH içinde arar. İkisini aynı dizine kurmak en kolayıdır.

Kaynaktan derleme

İki depo yan yana durmalıdır; ortak kod sunucu deposundadır.

quickssh/
├── quickssh-client/
└── quickssh-server/

cd quickssh-server && cargo build --release
cd ../quickssh-client && cargo build --release

Çıktıları tek dizinde toplamak için üst dizine şu dosyayı koyun:

# quickssh/.cargo/config.toml
[build]
target-dir = "target"

Tek container olarak (Docker imajı)

Sunucuyu kurulumla uğraşmadan çalıştırmanın yolu budur. İçinde kendi Docker engine'i vardır; VPN'ler onun içinde açılır ve üzerinde çalıştığı makinenin Docker'ına dokunmaz.

QUICKSSH_ADMIN_KEY="$(cat ~/.ssh/id_ed25519.pub)" docker compose up -d --build

İstemcide Ayarlar → Merkezi sunucu: [email protected], port 2222, anahtar olarak yukarıdaki açık anahtarın gizli yarısı.
Yönetim paneli http://127.0.0.1:8822 adresindedir. Yöneticinin geçici panel parolası ilk açılışta container günlüğüne yazılır: docker logs quickssh-server.
Saat dilimi TZ ile verilir: TZ=Europe/Istanbul docker compose up -d.

Port	Ne için
22 (dışarıda 2222)	İstemciler
8822	Yönetim paneli
42000–42019	Kullanıcılara açılan dış erişim ve veritabanı portları

Dikkat: Container --privileged çalışır, çünkü içinde Docker çalıştırır. Kalıcı veriler /data ve /var/lib/docker birimlerindedir; bu birimleri yedekleyin.

Merkezi sunucu (ekip için)

Sunucuyu ortak bir Linux makinesine kurun, sonra kullanıcıları ekleyin:

quicksshd user-add yonetici --admin --secrets --key ~/yonetici.pub
quicksshd user-add ayse --key ~/ayse.pub --access group:Acme

Her komut, kullanıcının panele ilk girişi için geçici bir parola yazar. Yönetim panelini sistem hizmeti olarak çalıştırmak için:

sudo cp systemd/[email protected] /etc/systemd/system/
sudo systemctl enable --now quickssh-panel@quickssh

Panel düz HTTP konuşur ve yalnızca sunucunun kendisinden erişilir; ağa açacaksanız önüne TLS sonlandıran bir ters vekil koyun. Ayrıntılar: Merkezi sunucu.

İstemciyi merkezi sunucuya bağlama

Arayüzde Ayarlar → Merkezi sunucu bölümüne sunucunun adresini girin ya da komut satırından:

quickssh server set [email protected] -i ~/.ssh/id_ed25519
quickssh server show

Komut kaydetmeden önce bağlanmayı dener; adres ya da anahtar yanlışsa ayarı bozmaz.

Güncelleme

Yeni paketteki iki dosyayı eskilerinin üzerine kurun. Sunucu ile istemciyi birlikte güncelleyin. Docker imajında docker compose up -d --build yeterlidir; kayıtlar birimlerde kalır.