--- read_when: - OpenClaw'ın bir bulut VPS üzerinde 7/24 çalışmasını istiyorsunuz (dizüstü bilgisayarınızda değil) - Kendi VPS'inizde üretim düzeyinde, her zaman açık bir Gateway istiyorsunuz - Kalıcılık, ikili dosyalar ve yeniden başlatma davranışı üzerinde tam denetim istiyorsunuz - OpenClaw'ı Hetzner veya benzer bir sağlayıcı üzerinde Docker'da çalıştırıyorsunuz summary: Kalıcı durum ve yerleşik ikili dosyalarla düşük maliyetli bir Hetzner VPS (Docker) üzerinde OpenClaw Gateway'i 7/24 çalıştırın title: Hetzner x-i18n: generated_at: "2026-05-06T17:57:42Z" model: gpt-5.5 provider: openai source_hash: 6102649b381b3b1ecd6f52e1cf518fc36147fe143ebc8fd4be5f44ab26cb3b4d source_path: install/hetzner.md workflow: 16 --- ## Hedef Docker kullanarak Hetzner VPS üzerinde kalıcı durum, görüntüye dahil edilmiş ikili dosyalar ve güvenli yeniden başlatma davranışıyla sürekli çalışan bir OpenClaw Gateway çalıştırın. "~$5 karşılığında 7/24 OpenClaw" istiyorsanız en basit güvenilir kurulum budur. Hetzner fiyatları değişebilir; en küçük Debian/Ubuntu VPS'i seçin ve OOM sorunlarıyla karşılaşırsanız ölçeği büyütün. Güvenlik modeli hatırlatması: - Şirket içinde paylaşılan agent'lar, herkes aynı güven sınırı içindeyse ve çalışma zamanı yalnızca iş amaçlıysa uygundur. - Katı ayrım sağlayın: özel VPS/çalışma zamanı + özel hesaplar; bu ana makinede kişisel Apple/Google/tarayıcı/parola yöneticisi profilleri bulunmamalıdır. - Kullanıcılar birbirine karşı saldırgan olabilecekse Gateway/ana makine/OS kullanıcısına göre ayırın. Bkz. [Güvenlik](/tr/gateway/security) ve [VPS barındırma](/tr/vps). ## Ne yapıyoruz (basitçe)? - Küçük bir Linux sunucusu kiralayın (Hetzner VPS) - Docker'ı kurun (yalıtılmış uygulama çalışma zamanı) - OpenClaw Gateway'i Docker içinde başlatın - `~/.openclaw` + `~/.openclaw/workspace` dizinlerini ana makinede kalıcı hale getirin (yeniden başlatmalarda/yeniden derlemelerde korunur) - Dizüstü bilgisayarınızdan bir SSH tüneliyle Control UI'ye erişin Bağlanan `~/.openclaw` durumu `openclaw.json`, agent başına `agents//agent/auth-profiles.json` ve `.env` dosyasını içerir. Gateway'e şu yollarla erişilebilir: - Dizüstü bilgisayarınızdan SSH bağlantı noktası yönlendirme - Güvenlik duvarını ve token'ları kendiniz yönetiyorsanız doğrudan bağlantı noktası açma Bu kılavuz Hetzner üzerinde Ubuntu veya Debian varsayar. Başka bir Linux VPS kullanıyorsanız paketleri buna göre eşleştirin. Genel Docker akışı için bkz. [Docker](/tr/install/docker). --- ## Hızlı yol (deneyimli operatörler) 1. Hetzner VPS hazırlayın 2. Docker'ı kurun 3. OpenClaw deposunu klonlayın 4. Kalıcı ana makine dizinleri oluşturun 5. `.env` ve `docker-compose.yml` dosyalarını yapılandırın 6. Gerekli ikili dosyaları görüntüye dahil edin 7. `docker compose up -d` 8. Kalıcılığı ve Gateway erişimini doğrulayın --- ## Gerekenler - Root erişimi olan Hetzner VPS - Dizüstü bilgisayarınızdan SSH erişimi - SSH + kopyala/yapıştır konusunda temel rahatlık - ~20 dakika - Docker ve Docker Compose - Model kimlik doğrulama bilgileri - İsteğe bağlı sağlayıcı kimlik bilgileri - WhatsApp QR - Telegram bot token'ı - Gmail OAuth --- Hetzner'de bir Ubuntu veya Debian VPS oluşturun. Root olarak bağlanın: ```bash ssh root@YOUR_VPS_IP ``` Bu kılavuz VPS'in durum bilgisi tutan bir sistem olduğunu varsayar. Bunu atılabilir altyapı gibi ele almayın. ```bash apt-get update apt-get install -y git curl ca-certificates curl -fsSL https://get.docker.com | sh ``` Doğrulayın: ```bash docker --version docker compose version ``` ```bash git clone https://github.com/openclaw/openclaw.git cd openclaw ``` Bu kılavuz, ikili dosya kalıcılığını garanti etmek için özel bir görüntü derleyeceğinizi varsayar. Docker container'ları geçicidir. Uzun ömürlü tüm durum ana makinede bulunmalıdır. ```bash mkdir -p /root/.openclaw/workspace # Set ownership to the container user (uid 1000): chown -R 1000:1000 /root/.openclaw ``` Depo kökünde `.env` oluşturun. ```bash OPENCLAW_IMAGE=openclaw:latest OPENCLAW_GATEWAY_TOKEN= OPENCLAW_GATEWAY_BIND=lan OPENCLAW_GATEWAY_PORT=18789 OPENCLAW_CONFIG_DIR=/root/.openclaw OPENCLAW_WORKSPACE_DIR=/root/.openclaw/workspace GOG_KEYRING_PASSWORD= XDG_CONFIG_HOME=/home/node/.openclaw ``` Kararlı Gateway token'ını `.env` üzerinden yönetmek istediğinizde `OPENCLAW_GATEWAY_TOKEN` değerini ayarlayın; aksi halde yeniden başlatmalar arasında istemcilere güvenmeden önce `gateway.auth.token` değerini yapılandırın. Hiçbir kaynak yoksa OpenClaw bu başlangıç için yalnızca çalışma zamanına ait bir token kullanır. Bir anahtarlık parolası oluşturun ve `GOG_KEYRING_PASSWORD` içine yapıştırın: ```bash openssl rand -hex 32 ``` **Bu dosyayı commit'lemeyin.** Bu `.env` dosyası, `OPENCLAW_GATEWAY_TOKEN` gibi container/çalışma zamanı ortam değişkenleri içindir. Saklanan sağlayıcı OAuth/API anahtarı kimlik doğrulaması, bağlanan `~/.openclaw/agents//agent/auth-profiles.json` içinde yaşar. `docker-compose.yml` oluşturun veya güncelleyin. ```yaml services: openclaw-gateway: image: ${OPENCLAW_IMAGE} build: . restart: unless-stopped env_file: - .env environment: - HOME=/home/node - NODE_ENV=production - TERM=xterm-256color - OPENCLAW_GATEWAY_BIND=${OPENCLAW_GATEWAY_BIND} - OPENCLAW_GATEWAY_PORT=${OPENCLAW_GATEWAY_PORT} - OPENCLAW_GATEWAY_TOKEN=${OPENCLAW_GATEWAY_TOKEN} - GOG_KEYRING_PASSWORD=${GOG_KEYRING_PASSWORD} - XDG_CONFIG_HOME=${XDG_CONFIG_HOME} - PATH=/home/linuxbrew/.linuxbrew/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin volumes: - ${OPENCLAW_CONFIG_DIR}:/home/node/.openclaw - ${OPENCLAW_WORKSPACE_DIR}:/home/node/.openclaw/workspace ports: # Recommended: keep the Gateway loopback-only on the VPS; access via SSH tunnel. # To expose it publicly, remove the `127.0.0.1:` prefix and firewall accordingly. - "127.0.0.1:${OPENCLAW_GATEWAY_PORT}:18789" command: [ "node", "dist/index.js", "gateway", "--bind", "${OPENCLAW_GATEWAY_BIND}", "--port", "${OPENCLAW_GATEWAY_PORT}", "--allow-unconfigured", ] ``` `--allow-unconfigured` yalnızca başlangıç kolaylığı içindir; uygun bir Gateway yapılandırmasının yerine geçmez. Dağıtımınız için yine de kimlik doğrulamayı (`gateway.auth.token` veya parola) ayarlayın ve güvenli bind ayarları kullanın. Ortak Docker ana makine akışı için paylaşılan çalışma zamanı kılavuzunu kullanın: - [Gerekli ikili dosyaları görüntüye dahil edin](/tr/install/docker-vm-runtime#bake-required-binaries-into-the-image) - [Derleyin ve başlatın](/tr/install/docker-vm-runtime#build-and-launch) - [Nerede ne kalıcı olur](/tr/install/docker-vm-runtime#what-persists-where) - [Güncellemeler](/tr/install/docker-vm-runtime#updates) Paylaşılan derleme ve başlatma adımlarından sonra tüneli açmak için aşağıdaki kurulumu tamamlayın: **Ön koşul:** VPS sshd yapılandırmanızın TCP yönlendirmeye izin verdiğinden emin olun. SSH yapılandırmanızı sertleştirdiyseniz `/etc/ssh/sshd_config` dosyasını kontrol edin ve şunu ayarlayın: ``` AllowTcpForwarding local ``` `local`, sunucudan uzak yönlendirmeleri engellerken dizüstü bilgisayarınızdan `ssh -L` yerel yönlendirmelerine izin verir. Bunu `no` olarak ayarlamak tünelin şu hatayla başarısız olmasına neden olur: `channel 3: open failed: administratively prohibited: open failed` TCP yönlendirmenin etkin olduğunu doğruladıktan sonra SSH hizmetini yeniden başlatın (`systemctl restart ssh`) ve tüneli dizüstü bilgisayarınızdan çalıştırın: ```bash ssh -N -L 18789:127.0.0.1:18789 root@YOUR_VPS_IP ``` Açın: `http://127.0.0.1:18789/` Yapılandırılmış paylaşılan sırrı yapıştırın. Bu kılavuz varsayılan olarak Gateway token'ını kullanır; parola kimlik doğrulamasına geçtiyseniz bunun yerine o parolayı kullanın. Paylaşılan kalıcılık haritası [Docker VM Runtime](/tr/install/docker-vm-runtime#what-persists-where) içinde bulunur. ## Kod Olarak Altyapı (Terraform) Kod olarak altyapı iş akışlarını tercih eden ekipler için topluluk tarafından sürdürülen bir Terraform kurulumu şunları sağlar: - Uzak durum yönetimiyle modüler Terraform yapılandırması - cloud-init aracılığıyla otomatik hazırlama - Dağıtım betikleri (bootstrap, deploy, backup/restore) - Güvenlik sertleştirmesi (güvenlik duvarı, UFW, yalnızca SSH erişimi) - Gateway erişimi için SSH tüneli yapılandırması **Depolar:** - Altyapı: [openclaw-terraform-hetzner](https://github.com/andreesg/openclaw-terraform-hetzner) - Docker yapılandırması: [openclaw-docker-config](https://github.com/andreesg/openclaw-docker-config) Bu yaklaşım, yukarıdaki Docker kurulumunu tekrarlanabilir dağıtımlar, sürüm kontrollü altyapı ve otomatik felaket kurtarma ile tamamlar. Topluluk tarafından sürdürülür. Sorunlar veya katkılar için yukarıdaki depo bağlantılarına bakın. ## Sonraki adımlar - Mesajlaşma kanallarını kurun: [Kanallar](/tr/channels) - Gateway'i yapılandırın: [Gateway yapılandırması](/tr/gateway/configuration) - OpenClaw'ı güncel tutun: [Güncelleme](/tr/install/updating) ## İlgili - [Kurulum genel bakışı](/tr/install) - [Fly.io](/tr/install/fly) - [Docker](/tr/install/docker) - [VPS barındırma](/tr/vps)