Agent Zero VPS uzerinde nasil guvenli kurulur?

Agent Zero nedir ve tehlike nerede yatar

Agent Zero, Docker öncelikli, açık kaynaklı bir ajan çerçevesidir. Birincil ajan, bir işi odaklanmış parçalara bölmek için alt ajanlar oluşturabilir; bu ajanlar kod yürütebilir, tarayıcı yönetebilir ve shell komutları çalıştırabilir; tüm bunlar Agent Zero Docker container'ı içinde gerçekleşir. Sistemin tamamını bir Web UI üzerinden kontrol edersiniz. Yetenekli ve kullanımı gerçekten keyifli bir araçtır; altı dolarlık bir VPS kadar küçük donanımlarda bile çalışabilir. Eğer aradığınız şey çerçeveden ziyade çoklu ajan yapısı ise, aynı makine üzerindeki iki Claude Code oturumu doğrudan birbirine mesaj gönderebilir; bu, çalıştırılması ve güvenliğinin sağlanması çok daha kolay bir yöntemdir.

Tehlike, Web UI kısmındadır. Bu arayüz, komut çalıştıran ve dosya yazan bir sistemin kontrol panelidir; dolayısıyla dış dünyaya açık ve kimlik doğrulaması olmayan bir Web UI, tam olarak bu sisteme uzaktan erişim kapısı sağlar. Çoğu kurulum kılavuzunun sizi doğrudan içine çektiği tuzak şudur: docker run örnekleri, arayüzü herhangi bir adres belirtmeden yayınlar. 2026-10-12 itibarıyla README dosyasındaki doğrudan komut host port 80'i (-p 80:80) eşler, A0 Install başlatıcısı 5080 numaralı portu kullanır ve VPS dağıtım kılavuzu 50080 numaralı portu önerirken, v0.9.x sürüm serisine kadar yazılan kılavuzlar 50001 numaralı portu kullanır. Hangi portu seçerseniz seçin, adres belirtilmeyen bir eşleme tüm ağ arayüzlerinde dinleme yapar; bu da halka açık bir VPS üzerinde, container başladığı anda tüm internetten erişilebilir olduğu anlamına gelir. Bunu düzeltmek, yapmanız gereken son şey değil, ilk şey olmalıdır.

Gereksinimler

Docker kurulu bir VPS'e, bir dil modeli için API anahtarına veya yönlendirme yapabileceğiniz yerel bir modele ve başlangıç için birkaç gigabayt RAM'e ihtiyacınız vardır. Agent Zero, Docker'ın çalıştığı her yerde; küçük bir VPS'ten GPU sunucusuna kadar her ortamda çalışır. Docker sizin için yeniyse, Docker temel bilgiler kılavuzu aşağıda kullanılan komutların varsayımlarını açıklamaktadır.

Docker ile kurulum ve loopback adresine bağlama

Belgelenmiş hızlı başlangıç kılavuzu tek bir docker run komutundan ibarettir. Başka yerlerde bulacağınız kopyala-yapıştır sürümlerinden farklı olarak yapılması gereken önemli değişiklik, yayın yapacağınız adrestir. -p 80:80 komutunun yaptığı gibi tüm arayüzlere yayın yapmayın. Sadece loopback adresine yayın yapın:

docker run -d --name agent-zero \
  -p 127.0.0.1:5080:80 \
  -v a0_usr:/a0/usr \
  agent0ai/agent-zero

-p 127.0.0.1:5080:80, Web arayüzünü yalnızca sunucunun loopback adresine bağlar; bu sayede internet üzerinden erişilemez hale gelir. Arayüze kendi makinenizden bir SSH tüneli aracılığıyla erişin:

ssh -L 5080:127.0.0.1:5080 you@your-vps

Ardından yerel makinenizde http://127.0.0.1:5080 adresini açın, arayüz üzerinden model sağlayıcınızı yapılandırın ve Ayarlar, Kimlik Doğrulama (Settings, Authentication) bölümünden bir kullanıcı adı ve parola belirleyin. Resmi belgeler, örneği başkalarının erişimine açmadan önce bu işlemin yapılmasını tavsiye eder. Kalıcı ve çok kullanıcılı bir kurulum için arayüzü bir VPN veya kimlik doğrulama yapan bir reverse proxy arkasına alın; ancak ham arayüzü asla doğrudan internete açmayın. Bu alışkanlık, sunucudaki hassas kontrolleri olan diğer tüm araçlar için de uygulanmalıdır. kendi kendine barındırılan bir open-kritt tarayıcısı gibi araçlara da yayınlanmış bir port yerine, arayüzüne kurulan bir tünel üzerinden erişilmelidir.

Diğer rehberlerin durduğu nokta ve neden durmamanız gerektiği

Agent Zero kurulumu için arama yaptığınızda, sizi yayınlanmış bir port (eskilerinde 50001, yenilerinde 80, 5080 veya 50080) üzerinden çalışan bir Web arayüzüne ulaştıran ve orada biten birçok rehber bulursunuz; bunların arasında barındırma şirketlerine ait olanlar da vardır. Risk, tam olarak orada başlar, bitmez. İşi tamamlayan iki unsur vardır. Birincisi, yukarıda belirtildiği gibi arayüzü gizli tutmaktır. İkincisi, sunucunun önüne varsayılan olarak reddeden (default-deny) bir güvenlik duvarı koymaktır; böylece unuttuğunuz bir servis internete yanıt veremez:

sudo ufw default deny incoming
sudo ufw allow 22/tcp
sudo ufw enable

Ancak sınırlarını bilin: Docker, yayınlanan container portlarına gelen trafiği UFW kuralları uygulanmadan önce yönlendirir; bu nedenle güvenlik duvarı, tüm arayüzlere yayınlanan bir container portunu kapsamaz. Yukarıda bahsedilen loopback bind işleminin önemli olmasının nedeni budur ve Docker portlarının UFW'yi nasıl baypas ettiği konusu detayları açıklar. Genel resmi görmek için güvenlik duvarı temellerini takip edin ve IPv6 açığına dikkat edin; çünkü IPv4 kurallarınız sıkı görünse bile :: üzerindeki bir servis IPv6 üzerinden erişilebilir durumdadır.

Container izolasyonu sunucunuzu değil, aracıları korur

Agent Zero'nun tasarımı, bir tür izolasyon konusunda oldukça başarılıdır: Çerçeve ve oluşturduğu her aracı, doğrudan ana makineniz üzerinde değil, kendi Docker container'ı içerisinde çalışır. Bu sayede yazdıkları ve çalıştırdıkları kod, ana dizininize değil, container içerisine kaydedilir. Bu, sahip olunması gereken bir özelliktir. Alt aracılar, birincil aracı ile aynı container'ı paylaşır; dolayısıyla aradaki duvar aracılar ile ana makineniz arasındadır, aracıların kendi aralarında değildir. Tüm bunları "sandbox içerisindedir, dolayısıyla güvendeyim" şeklinde okuyup burada durmak kolaydır. Container izolasyonu, aracıların yaptığı işleri ana makineden uzak tutar. Sunucunuzu internetten korumak veya açıkta bırakılmış bir Web UI'ın kontrolü bir yabancıya kaptırmasını engellemek için hiçbir şey yapmaz. Bunlar, ana makine üzerinde sizin sorumluluğunuzdadır. Kimse izlemiyorken bir aracının ne kadar işlem yapabileceğine en başta karar verin; bu, Claude Code'un izin modları arkasındaki mantıkla aynıdır; gözetimsiz bir sunucu, önünüzde duran bir dizüstü bilgisayara kıyasla daha sıkı bir ayarı hak eder.

Sırlar, kullanıcılar ve ana makine

Model API anahtarını ve diğer tüm kimlik bilgilerini Agent Zero yapılandırmasında veya yalnızca ilgili hesabın okuyabileceği bir ortam dosyasında tutun; bu bilgileri shell geçmişinizden ve herhangi bir depodan uzak tutun. Aynı mantık, sunucuda sırları koruyan diğer tüm öğeler için de geçerlidir; çünkü Vaultwarden için sıkılaştırma adımları, uygulamanın halihazırda iyi yaptığı şifrelemeden ziyade, yönetici belirteci ve yedekleme dosyası ile ilgilidir. Sunucuyu en düşük yetkili kullanıcılar prensibi gereği root yerine yetkisiz bir kullanıcı olarak yönetin ve SSH sıkılaştırma bölümünde belirtildiği gibi SSH erişimini yalnızca anahtar tabanlı kimlik doğrulamaya geçirin. Ardından hiçbir şeyin gözden kaçmaması için aşağıdaki kontrol listesini inceleyin.

Ajanları karşılaştırıyorsanız, bu güvenlik duruşu OpenClaw sıkılaştırma kılavuzu ve OpenHands kılavuzu ile aynıdır: kontrol yüzeyini gizli tutun, yetkisiz bir kullanıcı olarak çalıştırın, varsayılan olarak güvenlik duvarı kullanın ve ana makineyi kendi yazmadığı kodları çalıştıran bir sistem olarak değerlendirin. Beş ajanın yan yana karşılaştırması için 2026 yılının en iyi self-hosted yapay zeka ajanları bölümüne bakın.

Bunların temelindeki kavramlar VPS üzerinde kendi yapay zeka ajanı oluşturma bölümünde yer almaktadır ve Dify, karşılaştırmaya değer bir diğer self-host edilebilir platformdur.

FAQ

Agent Zero'yu kendi sunucumda barındırmak güvenli mi?

Web arayüzünü gizli tutar ve sunucuyu sıkılaştırırsanız güvenlidir. Agent Zero kod, tarayıcı ve kabuk çalıştırır; ayrıca yayınladığınız herhangi bir sunucu portu üzerinden Web arayüzü ile kontrol edilir. Bu nedenle risk, çerçevenin kendisinden değil, dışa açık bir arayüzden kaynaklanır. Arayüzü loopback adresine bağlayın ve SSH veya VPN üzerinden erişin, bir arayüz kullanıcı adı ve parolası belirleyin, ön tarafa varsayılan olarak reddeden bir güvenlik duvarı kurun ve uygulamayı yetkisiz bir kullanıcı ile çalıştırın.

Agent Zero varsayılan olarak internete bir Web arayüzü açar mı?

Belgelenen docker run komutları, arayüzü herhangi bir adres kısıtlaması olmadan yayınlar (README dosyasında -p 80:80 kullanılır). Bu tür bir eşleştirme tüm ağ arayüzlerini dinler; bu da halka açık bir VPS üzerinde, container başlar başlamaz arayüzün internetten erişilebilir olması anlamına gelir. Docker, yayınlanan portları UFW kurallarının dışından yönlendirdiği için UFW bu erişimi engellemez. Arayüzün yalnızca loopback üzerinde dinlemesi için yayınlanan adrese 127.0.0.1 ekleyin ve ardından SSH tüneli veya VPN üzerinden erişim sağlayın.

Agent Zero küçük bir VPS üzerinde çalışabilir mi?

Evet. Agent Zero, Docker'ın çalıştığı her yerde, küçük ve uygun maliyetli VPS'ler dahil olmak üzere çalışabilir. Ancak daha ağır görevler ve büyük yerel modeller daha fazla bellek gerektirir. Eğer uygulamayı barındırılan bir API yerine kendi sunucunuzda barındırdığınız bir modele yönlendirirseniz, sunucu kapasitesini sadece Agent Zero'ya göre değil, modele göre belirleyin.

Agent Zero, OpenClaw veya Hermes'ten nasıl farklıdır?

Bu araçlar benzer özelliklere sahip olsa da hedefleri farklıdır. Agent Zero, bir Web arayüzü üzerinden yönetilen ve container içinde alt ajanlar oluşturan, Docker öncelikli bir çerçevedir. OpenClaw ve Hermes ise sohbet uygulamaları üzerinden erişilen kişisel asistanlardır. Hepsi için güvenlik yaklaşımı aynıdır: kontrol yüzeyini gizli tutun ve sunucuyu sıkılaştırın.