Sık sorulan sorular SSS

Bu belge, paneli kullanırken en sık karşılaşılan sorunları ve sorun giderme yöntemlerini bir araya getirir.

Kurulum ve giriş

Q: Paneli kurmak için hangi koşullar gerekir?

Genel IP'li bir Linux sunucusu (Debian / Ubuntu / CentOS gibi ana akım dağıtımlar önerilir); 512MB ve üzeri bellek akıcı çalışma için yeterlidir. Yönetilen sunuculara hiçbir şey kurmak gerekmez, yalnızca SSH bağlantısı olması yeterlidir.

Q: Varsayılan hesap ve parola nedir?

Varsayılan hesap admin, parola 123456. İlk girişten sonra lütfen hemen değiştirin (panel sağ üst köşedeki kullanıcı simgesi → Kullanıcı ayarları).

Q: Giriş parolasını unuttum, ne yapmalıyım?

Parolayı değiştirdiyseniz ve unuttuysanız, panel sunucusunda sıfırlayabilirsiniz. Aşağıdaki komutları çalıştırarak varsayılan parolaya (veya belirlediğiniz yeni parolaya) sıfırlayın:

# Panel kurulum dizinine girin, yerleşik betikle parolayı sıfırlayın
cd /opt/ssh-everywhere
python3 -c "from app import reset_password; reset_password('<new-password>')"

> Betiğin adı sürüme göre değişebilir; doğrudan data/ssheverywhere.db veritabanındaki users tablosunu düzenleyebilirsiniz.

Q: Panel portunu (5501) nasıl değiştiririm?

systemd servisindeki Environment=PORT=5501 değerini değiştirin, ardından yeniden yükleyin:

systemctl edit ssh-everywhere.service
# Ekleyin veya değiştirin: Environment=PORT=<your-port>
systemctl daemon-reload && systemctl restart ssh-everywhere.service

Değişiklikten sonra bulut güvenlik duvarında/güvenlik grubunda yeni portu açmayı unutmayın.

Q: Panele erişemiyorum (5501 portu)?

Sırayla kontrol edin:

1. Panel servisinin çalıştığını doğrulayın: systemctl status ssh-everywhere.service

2. Panel sunucusunun bulut güvenlik duvarının/güvenlik grubunun 5501 portuna izin verip vermediğini kontrol edin (en sık görülen nedendir)

3. Erişim adresinin http://<server-public-ip>:5501 olduğunu doğrulayın (https değil; ters proxy yapılandırdıysanız bu kural geçerli değildir)

Sunucuyla ilgili

Q: Sunucu "çevrimdışı" görünüyor, ne yapmalıyım?

"Çevrimdışı" yalnızca panelin ona SSH ile bağlanamadığını gösterir, sunucunun çöktüğü anlamına gelmez. Sırayla kontrol edin:

1. Sunucunun kendisinin çevrimiçi olduğunu doğrulayın: sağlayıcı konsoluna gidip güç durumuna bakın

2. SSH portunun erişilebilirliğini test edin: panel sunucusundan nc -zv <target-IP> <port> komutunu çalıştırıp portun açık olup olmadığına bakın

3. Güvenlik duvarını/güvenlik grubunu kontrol edin: hedef sunucunun bulut güvenlik duvarı/güvenlik grubu SSH portuna izin veriyor mu

4. NAT sunucusunda port eşlemesini kontrol edin: NAT port eşlemesinin hâlâ var olduğunu ve hedef iç ağ IP'sinin doğru olduğunu doğrulayın

5. Kaynak IP beyaz listesini kontrol edin: bazı sağlayıcılar SSH portu için kaynak IP kısıtlaması uygular; panel sunucusunun IP'si beyaz listeye eklenmelidir

6. Hesap ve parolayı kontrol edin: kullanıcı adı, parola/özel anahtar doğru mu

Q: Sunucu eklerken bağlanamıyorum?

• SSH portunun, kullanıcı adının ve parolanın doğru olduğunu doğrulayın
• Hedef sunucuda sshd servisinin çalıştığını doğrulayın
• Güvenlik duvarının SSH portuna izin verdiğini doğrulayın
• Büyük bulut sağlayıcılarında (Tencent Cloud/Alibaba Cloud) root varsayılan olarak kapalıdır; normal bir kullanıcıyla (örn. ubuntu) giriş yapın

Q: NAT sunucusuna (22 dışındaki port) bağlanamıyorum?

NAT sunucusunun port eşlemesine, panel sunucusunun bulunduğu ağdan erişilebilmelidir. Sık görülen nedenler:

• Port eşlemesi artık geçerli değil (sağlayıcı panelinden kontrol edip yeniden oluşturun)
• Sağlayıcı kaynak IP için beyaz liste uyguluyor (panel sunucusunun IP'sini beyaz listeye ekleyin)
• Eşlenen hedef iç ağ IP'si/portu yanlış girilmiş

Port tünelleme / yönlendirme ile ilgili

Q: Port tünelleme "çevrimdışı" gösteriyor?

• Tünelleme, Agent'ın çevrimiçi olmasına bağlıdır. Agent çevrimdışıysa (cihaz kapanmış, ağ kopmuş, Agent durdurulmuş) tünelleme kesintiye uğrar
• Panel servisi yeniden başlatıldıktan sonra tünelleme, Agent yeniden bağlandığında otomatik olarak geri gelir; kısa bir süre beklemeniz yeterlidir
• Panel sunucusunun bulut güvenlik duvarının dinleme portuna izin verdiğini doğrulayın

Q: 22 dışındaki portlara yönlendirme etkili olmuyor?

SSH dışındaki portları (örn. 9117) yönlendirmek için tünel sunucusunda yeni sürüm Agent kurulu olmalıdır (eski sürüm yalnızca 22'yi destekler). Agent'ı yeniden kurmanız yeterlidir.

Q: Port yönlendirmeyi oluşturdum ama etkili olmuyor?

Geleneksel port yönlendirme, bağımsız genel IP'ye sahip sunucunun kendi üzerinde yapılmalıdır. Kontrol edin:

1. Hedef sunucu/aradaki güvenlik duvarı hedef porta izin veriyor mu

2. Hedef IP olarak gerçekten erişilebilir bir adres mi girildi

3. Bulut güvenlik grubu dinleme portunu engelliyor mu

Q: Port tünelleme ile port yönlendirme arasındaki fark nedir?

• Port tünelleme: genel IP'si olmayan cihazlar içindir; ters tünel üzerinden çalışır ve panel sunucusunda genel bir port açar.
• Port yönlendirme: genel IP'li sunucular içindir; sistem güvenlik duvarı DNAT ile çalışır ve hedef sunucunun kendi üzerinde yapılır.

Ayrıntılar için Port tünelleme ve Port yönlendirme belgelerine bakın.

Docker / uygulama kurulumu ile ilgili

Q: Uygulama kataloğu/Docker kurulumu başarısız olursa ne yapmalı?

Panel hata mesajını olduğu gibi gösterir (başarılıymış gibi göstermez). Sık görülen nedenler:

1. Çok eski dağıtım: Fedora 32 gibi EOL sürümlerde yazılım kaynakları artık bakım görmüyor, kurulum zaman aşımına uğrar veya başarısız olur. Sistemi yükseltmeniz önerilir.

2. Ağa erişilemiyor: Docker resmî kaynakları (get.docker.com / download.docker.com) bazı ağ ortamlarında (örn. Çin ana karasındaki NAT sunucuları) erişilemez olabilir. Bu durumda Docker yurt içi imaj kaynağını yapılandırmanız veya "İmaj kaynağı" işleviyle Alibaba Cloud kaynağına geçmeniz gerekir.

3. Paket adı farklılıkları: bazı uygulamalar (örn. ufw, Node.js'in deb.nodesource kaynağı) belirli dağıtımlara bağlıdır; Debian/Ubuntu dışında kurulamayabilir; hata mesajı bunu açıkça belirtir.

Q: Çin içindeki sunucularda Docker imajı çekmek çok yavaş / zaman aşımına uğruyor?

Bu bir ağ sorunudur, panel sorunu değildir. Docker imaj hızlandırıcısını yapılandırmanız önerilir (genel hızlandırıcılar: docker.1ms.run / docker.m.daocloud.io); ya da sunucuda önce şunu çalıştırın:

# Örnek: Alibaba Cloud kişisel hızlandırıcısını yapılandırma (hızlandırıcı adresinizi yazın)
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<'EOF'
{ "registry-mirrors": ["https://<your-accelerator-url>"] }
EOF
sudo systemctl restart docker

Genel sorun giderme ipuçları

1. Önce portun açık olup olmadığını test edin, sonra hesap ve parolayı kontrol edin: nc -zv <IP> <port>

2. Diğer sunucularla karşılaştırın: aynı türden sunucular bağlanıyor da yalnızca bu bağlanmıyorsa, sorun bu sunucuya özgüdür (güvenlik duvarı/eşleme/beyaz liste)

3. Günlüklere bakın: panel günlüğü service.log dosyasındadır; tünelleme/Agent günlükleri bağlantı sorunlarının yerini belirlemeye yardımcı olur