Haber

Walgo ile Walrus’a Site Nasıl Deploy Edilir? Başlangıç Rehberi

Walgo ile Walrus’a site deploy etme adımlarını öğren. Web3 site yayınlama ve Hugo deploy sürecine hemen başla.

Bora Gökçe19 Mayıs 2026 09:1011 dk okuma

Walgo ile Walrus’a Site Nasıl Deploy Edilir? Başlangıç Rehberi

Walgo ile Site Deploy Etmeden Önce Bilmeniz Gerekenler

Walgo ile site deploy etmek, klasik hosting servislerine dosya yüklemekten biraz farklıdır. Burada amaç, statik bir web sitesini Walrus adlı merkezi olmayan depolama ağı üzerinde yayınlamaktır.

Walrus, Sui blockchain üzerine inşa edilmiş merkezi olmayan bir depolama ağıdır. Web sitelerini ve uygulamaları kalıcı, sansüre karşı dayanıklı şekilde barındırmayı mümkün kılar. Walgo ise bu altyapıya site deploy etmeyi kolaylaştıran resmi geliştirici aracıdır.

Yani Walgo’yu şu şekilde düşünebilirsiniz:

Walgo, statik siteniz ile Walrus decentralized storage ağı arasında çalışan pratik bir yayınlama aracıdır.

Özellikle Hugo ile oluşturulan statik siteler için tasarlanmıştır. Bununla birlikte Walgo ekosisteminde CLI dışında, kurulum gerektirmeyen Walgo Web seçeneği de bulunur. Ancak bu rehberde ana odağımız Walgo CLI ile site deploy etme sürecidir.

Walgo Deploy Süreci Kime Uygun?

Walgo ile site deploy etmek özellikle şu kullanıcılar için uygundur:

Hugo ile blog veya dokümantasyon sitesi oluşturan geliştiriciler
Web3 projesi için landing page yayınlamak isteyen ekipler
Merkezi olmayan hosting’i test etmek isteyen kullanıcılar
Statik sitesini Walrus üzerinde yayınlamak isteyen teknik kullanıcılar
Obsidian notlarını siteye dönüştürmek isteyen içerik üreticileri
Sui ve Walrus ekosistemini pratik bir araçla denemek isteyenler

Eğer amacınız “Bir statik siteyi Web3 altyapısında nasıl yayınlarım?” sorusuna pratik bir cevap bulmaksa, Walgo iyi bir başlangıç noktasıdır.

Walgo ile Deploy Etmek İçin Neye İhtiyacınız Var?

Walgo ile deploy sürecinde ihtiyacınız olan şeyler, seçtiğiniz deploy moduna göre değişir.

Başlangıç seviyesinde test yapmak için şunlar yeterlidir:

Bilgisayarınızda terminal erişimi
Walgo kurulumu
Temel komut satırı bilgisi
İnternet bağlantısı

Kalıcı on-chain deploy yapmak için ek olarak şunlara ihtiyaç duyabilirsiniz:

Sui cüzdanı
SUI token
SuiNS kullanmak istiyorsanız uygun bir isim kaydı

Walgo’nun önemli avantajlarından biri, yeni kullanıcıların doğrudan cüzdan veya token ile başlamasını zorunlu kılmamasıdır. HTTP deployment modu sayesinde cüzdan veya kripto para gerekmeden geçici test deploy yapılabilir.

Walgo Deploy Modları: HTTP ve On-Chain Arasındaki Fark

Walgo’da iki temel deploy yaklaşımı vardır: HTTP test modu ve on-chain deploy modu.

Deploy Modu	Gereksinim	Kalıcılık	Kimler İçin Uygun?
HTTP / Ücretsiz Test	Cüzdan veya kripto gerekmez	Geçici, yaklaşık 30 gün	Walgo’yu denemek isteyenler
On-Chain	Sui cüzdanı + SUI token	Daha kalıcı, epoch bazlı	Gerçek proje yayınlamak isteyenler

Başlangıç için HTTP modu daha mantıklıdır. Çünkü bu modda teknik bariyer düşüktür. Siteyi oluşturur, deploy akışını görür ve Walrus üzerinde yayınlama deneyimini risksiz şekilde test edebilirsiniz.

Gerçek bir proje, portfolyo, dokümantasyon sitesi veya uzun süre yayında kalacak bir Web3 sayfası için ise on-chain deploy daha uygundur.

Walgo Nasıl Kurulur?

Walgo CLI kullanmak için önce aracı bilgisayarınıza kurmanız gerekir. Kurulum işletim sisteminize göre değişir.

macOS ve Linux için Walgo Kurulumu

curl -fsSL https://raw.githubusercontent.com/ganbitlabs/walgo/main/install.sh | bash

Bu komut, Walgo kurulum script’ini indirip çalıştırır.

Windows için Walgo Kurulumu

irm https://raw.githubusercontent.com/ganbitlabs/walgo/main/install.ps1 | iex

Windows kullanıcıları PowerShell üzerinden bu komutla Walgo’yu kurabilir.

Go ile Walgo Kurulumu

Go yüklü olan kullanıcılar şu komutu kullanabilir:

go install github.com/ganbitlabs/walgo@latest

Walgo, Go 1.22+ ile geliştirilmiş bir araçtır. Teknik mimarisinde Cobra CLI framework’ü, Viper konfigürasyon yönetimi ve Hugo build aracı gibi bileşenler bulunur.

Kurulumdan sonra terminalde Walgo’nun çalışıp çalışmadığını kontrol etmek için şu komutu kullanabilirsiniz:

walgo doctor

walgo doctor, ortam sorunlarını teşhis etmek için kullanılan faydalı bir komuttur.

En Hızlı Yöntem: Walgo Quickstart ile Site Oluşturma ve Deploy Etme

Walgo’yu ilk kez deniyorsanız en kolay yöntem quickstart komutudur.

walgo quickstart my-blog

Bu komut, adından da anlaşılacağı gibi hızlı başlangıç için tasarlanmıştır. Tek komutla site oluşturma, build alma ve deploy sürecini başlatmanıza yardımcı olur.

Buradaki my-blog, oluşturmak istediğiniz projenin adıdır. İsterseniz bunu kendi projenize göre değiştirebilirsiniz:

walgo quickstart web3-portfolio

veya:

walgo quickstart my-docs

Bu yöntem özellikle şu kullanıcılar için idealdir:

Walgo’yu ilk kez test edenler
Boş bir Hugo sitesiyle başlamak isteyenler
Deploy akışını hızlıca görmek isteyenler
Teknik detaylara girmeden ilk siteyi yayına almak isteyenler

Ancak daha kontrollü ilerlemek istiyorsanız, adım adım Walgo deploy sürecini takip etmek daha iyi olabilir.

Adım Adım Walgo ile Site Deploy Etme

Bu bölümde Walgo ile bir siteyi sıfırdan oluşturup Walrus’a deploy etme sürecini adım adım inceleyelim.

1. Yeni Bir Walgo Projesi Oluşturun

İlk olarak yeni bir site projesi oluşturun:

walgo init my-site

Bu komut, my-site adında yeni bir proje başlatır.

Proje adını kendi kullanım senaryonuza göre seçebilirsiniz:

walgo init personal-blog

veya:

walgo init project-landing-page

Proje ismi seçerken kısa, anlaşılır ve projenizi temsil eden bir ad kullanmanız iyi olur. Bu ad daha sonra proje klasörünüzde ve deploy yönetiminde işinizi kolaylaştırır.

2. Proje Klasörüne Girin

Proje oluşturulduktan sonra klasöre girmeniz gerekir:

cd my-site

Bu aşamadan sonra çalıştıracağınız komutlar ilgili Walgo projesi içinde uygulanır.

Eğer farklı bir proje adı kullandıysanız komutu buna göre değiştirin:

cd personal-blog

3. Siteyi Build Edin

Deploy etmeden önce sitenizi build etmeniz gerekir:

walgo build

Build işlemi, sitenizin yayınlanmaya hazır statik çıktısını oluşturur.

Walgo build sürecinde HTML, CSS ve JavaScript dosyaları için optimizasyonlar yapılabilir. Walgo’nun temel özellikleri arasında otomatik minification ve Brotli sıkıştırma desteği bulunur. Bu da daha hızlı yüklenen statik sayfalar elde etmenize yardımcı olabilir.

Build süreci, özellikle SEO ve kullanıcı deneyimi açısından önemlidir. Çünkü hızlı yüklenen, temiz ve optimize edilmiş siteler ziyaretçiler için daha iyi bir deneyim sunar.

4. Deploy Sihirbazını Başlatın

Site build edildikten sonra deploy sürecini başlatmak için şu komutu kullanın:

walgo launch

walgo launch, Walgo’nun interaktif deploy sihirbazını başlatır. Bu sihirbaz kullanıcıyı adım adım yönlendirir ve deploy sürecini daha anlaşılır hale getirir.

Bu aşamada seçmeniz gerekebilecek bazı noktalar şunlar olabilir:

Deploy modu
Yayınlanacak site çıktısı
HTTP test deploy veya on-chain deploy tercihi
Cüzdan gerektiren işlemler
Site kaydı veya güncelleme seçenekleri

Yeni başlayanlar için en mantıklı seçenek önce HTTP test deploy ile ilerlemektir. Böylece cüzdan, token veya on-chain işlem detaylarına girmeden Walgo deneyimini görebilirsiniz.

5. Deploy Sonrası Sitenizi Kontrol Edin

Deploy tamamlandıktan sonra sitenizin yayın adresini kontrol edin. Eğer HTTP test modu kullandıysanız siteniz geçici olarak yayında olur. Eğer on-chain deploy yaptıysanız site Walrus üzerinde daha kalıcı bir yayın akışına sahip olur.

Deploy sonrası kontrol etmeniz gerekenler:

Ana sayfa düzgün açılıyor mu?
Görseller yükleniyor mu?
CSS ve JavaScript dosyaları çalışıyor mu?
Linkler doğru mu?
Mobil görünüm düzgün mü?
Sayfa başlıkları ve meta açıklamalar doğru mu?

Bu kontroller özellikle profesyonel bir proje yayınlıyorsanız önemlidir.

Deploy Edilen Siteleri Yönetme

Walgo ile deploy ettiğiniz projeleri takip etmek için şu komutu kullanabilirsiniz:

walgo projects

Bu komut, tüm sitelerinizi, deploy geçmişinizi ve güncellemelerinizi takip etmenize yardımcı olur.

Birden fazla proje yöneten kullanıcılar için bu özellik oldukça değerlidir. Örneğin bir kişisel blog, bir portfolyo ve bir proje landing page’i yayınlıyorsanız hepsini aynı araç üzerinden takip edebilirsiniz.

Walgo ile Site Güncelleme Mantığı

Bir siteyi deploy ettikten sonra içerik veya tasarım değişikliği yapmak isteyebilirsiniz. Genel akış şu şekilde ilerler:

Proje dosyalarını güncelleyin.
Siteyi yeniden build edin.
Deploy işlemini tekrar çalıştırın.
Yayındaki sürümü kontrol edin.

Örnek akış:

walgo build
walgo launch

Bu yapı, statik site geliştirme mantığına alışkın olan kullanıcılar için oldukça doğaldır. İçerik düzenlenir, build alınır ve güncel sürüm tekrar yayınlanır.

Walgo ile SuiNS Alan Adı Bağlama

Walgo’nun önemli özelliklerinden biri SuiNS desteği sunmasıdır. SuiNS, Sui Name Service anlamına gelir ve sitenizi daha okunabilir bir adrese bağlamanıza yardımcı olur.

Örneğin teknik bir hash veya uzun bir adres yerine şu tarz bir adres kullanmak isteyebilirsiniz:

yourname.wal.app

Bu, kullanıcı deneyimi açısından önemlidir. Çünkü ziyaretçilerin hatırlayabileceği, paylaşabileceği ve markanızla ilişkilendirebileceği bir adres sunar.

SuiNS entegrasyonu özellikle şu projeler için değerlidir:

Kişisel portfolyo siteleri
Web3 startup landing page’leri
Açık kaynak proje dokümantasyonları
DAO veya topluluk sayfaları
Teknik bloglar

Walgo Deploy Sürecinde Sık Karşılaşılan Sorunlar

Walgo kullanırken bazı yaygın sorunlarla karşılaşabilirsiniz. Bunların çoğu ortam ayarları, eksik bağımlılıklar veya yanlış proje klasörüyle ilgilidir.

Hugo Kurulu Değilse

Walgo, Hugo ile oluşturulan statik siteleri desteklediği için bazı senaryolarda Hugo kurulumuna ihtiyaç duyabilirsiniz. Eğer build sırasında Hugo ile ilgili hata alırsanız önce Hugo’nun sisteminizde yüklü olup olmadığını kontrol edin.

Yanlış Klasörde Komut Çalıştırmak

walgo build veya walgo launch komutlarını doğru proje klasöründe çalıştırdığınızdan emin olun.

Yanlış:

walgo build

Eğer proje klasörünün dışındaysanız hata alabilirsiniz.

Doğru:

cd my-site
walgo build

Build Hataları

Build hataları genellikle tema, içerik dosyası, config veya eksik bağımlılık kaynaklı olabilir. Bu durumda önce hata mesajını okuyun, ardından walgo doctor ile ortamınızı kontrol edin.

walgo doctor

Deploy Modunu Yanlış Seçmek

Sadece test yapmak istiyorsanız HTTP deploy ile başlayın. Kalıcı yayın istiyorsanız on-chain deploy modunu değerlendirin.

Cüzdan veya Token Hazırlığını Atlamak

On-chain deploy yapacaksanız Sui cüzdanınızın ve gerekli SUI token bakiyenizin hazır olduğundan emin olun.

Walgo ile Daha İyi Deploy İçin İpuçları

Walgo ile daha temiz ve sorunsuz bir yayın süreci için şu önerileri takip edebilirsiniz:

Önce HTTP Test Deploy Yapın

İlk deploy denemenizde doğrudan on-chain sürece geçmek yerine HTTP test modunu kullanmak daha güvenlidir. Böylece sitenizin düzgün çalışıp çalışmadığını görebilirsiniz.

Build Öncesi İçeriği Kontrol Edin

Deploy’dan önce sayfa başlıklarını, menüleri, linkleri ve görselleri kontrol edin. Küçük hatalar yayına çıktıktan sonra daha görünür hale gelir.

SEO Alanlarını Unutmayın

Statik sitenizde her sayfa için şu alanları kontrol edin:

H1 başlığı
Meta title
Meta description
Temiz URL yapısı
Görsel alt metinleri
İç linkler

SEO içerik rehberlerinde, meta title’ın 60 karakter altında tutulması ve meta description’ın 150-160 karakter aralığında yazılması önerilir.

Proje Adlarını Düzenli Tutun

Birden fazla site yönetecekseniz proje adlarını açık ve düzenli seçin. Örneğin:

personal-blog
web3-landing
docs-site
portfolio

Bu, walgo projects çıktısını daha okunabilir hale getirir.

Yayın Sonrası Mobil Kontrol Yapın

Siteniz masaüstünde düzgün görünse bile mobilde sorun yaşayabilir. Deploy sonrası mutlaka telefon veya tarayıcı mobil görünümünden kontrol edin.

Walgo Web ile Deploy Etmek Daha Kolay mı?

Eğer terminal kullanmak istemiyorsanız Walgo Web daha kolay bir seçenek olabilir. Walgo Web, herhangi bir kurulum gerektirmeden tamamen tarayıcıdan Walrus’a statik site deploy etmeyi sağlar.

Walgo Web ile genel akış şöyledir:

Sui cüzdanınızı bağlayın.
Şablon seçin, AI ile site oluşturun veya klasör yükleyin.
Tarayıcıdaki editör ve canlı önizleme ile siteyi düzenleyin.
Deploy edin.
İsterseniz SuiNS adı bağlayın.

Walgo Web özellikle şu kullanıcılar için daha uygundur:

Terminal kullanmak istemeyenler
Hızlı landing page yayınlamak isteyenler
Hazır build klasörünü deploy etmek isteyenler
Canlı önizleme ile düzenleme yapmak isteyenler
Portfolyo veya bio link sayfası oluşturmak isteyenler

Ancak Hugo entegrasyonu, gelişmiş proje yönetimi, Obsidian import ve asset optimizasyonu gibi konular sizin için önemliyse Walgo CLI daha iyi bir seçenek olabilir.

Walgo CLI mı Walgo Web mi Kullanmalısınız?

Karar vermek için aşağıdaki basit rehberi kullanabilirsiniz:

İhtiyaç	Önerilen Araç
Hugo sitesi deploy etmek	Walgo CLI
Kurulum yapmadan site yayınlamak	Walgo Web
Terminalden çalışmak	Walgo CLI
Klasör yükleyerek deploy etmek	Walgo Web
Obsidian vault’tan site üretmek	Walgo CLI
Canlı önizleme ile düzenleme yapmak	Walgo Web
AI ile içerik üretmek	İkisi de
Gelişmiş proje yönetimi	Walgo CLI

Kısacası, teknik kontrol istiyorsanız Walgo CLI; kolaylık ve hız istiyorsanız Walgo Web daha mantıklı olabilir.

Walgo ile Deploy Etmenin SEO Açısından Avantajları

Walgo doğrudan bir SEO platformu değildir. Ancak SEO uyumlu statik site yayınlama sürecini destekleyen bazı avantajlara sahiptir.

Hızlı Statik Sayfalar

Statik siteler genellikle dinamik sistemlere göre daha hızlı yüklenebilir. Walgo’nun asset optimizasyonu ve Brotli sıkıştırma özellikleri de performansı destekleyebilir.

Temiz Site Yapısı

Hugo gibi statik site üreticileriyle çalışmak, düzenli URL yapısı, Markdown tabanlı içerik ve net başlık hiyerarşisi oluşturmayı kolaylaştırır.

AI ile İçerik Üretimi

Walgo’nun AI özellikleriyle blog yazısı veya sayfa içeriği üretmek mümkündür. Ancak AI ile üretilen içerik mutlaka insan editör tarafından kontrol edilmeli, özgünleştirilmeli ve SEO açısından optimize edilmelidir.

Web3 Projeleri İçin Hızlı Yayın

Web3 projeniz için hızlı bir landing page veya dokümantasyon yayınlamak, erken görünürlük kazanmanıza yardımcı olabilir.

Örnek Walgo Deploy Akışı

Yeni başlayan bir kullanıcı için basit deploy akışı şöyle olabilir:

# 1. Yeni site oluştur
walgo init my-site

# 2. Proje klasörüne gir
cd my-site

# 3. Siteyi build et
walgo build

# 4. Deploy sihirbazını başlat
walgo launch

# 5. Projeleri kontrol et
walgo projects

Daha hızlı yöntem:

walgo quickstart my-blog

Sorun yaşarsanız:

walgo doctor

Bu üç komut seti, Walgo ile başlangıç için en temel yapıyı oluşturur.

Walgo ile İlk Deploy İçin Önerilen Yol Haritası

Walgo’yu ilk kez kullanıyorsanız şu sırayı takip etmek iyi olur:

Walgo CLI’ı kurun.
walgo doctor ile ortamı kontrol edin.
walgo quickstart my-blog komutuyla test sitesi oluşturun.
HTTP test deploy ile süreci deneyin.
Yayınlanan siteyi kontrol edin.
İçerik ve tasarım düzenlemeleri yapın.
Gerçek proje için on-chain deploy’u değerlendirin.
Gerekirse SuiNS adı bağlayın.

Bu yol haritası, gereksiz karmaşıklığa girmeden Walgo mantığını öğrenmenizi sağlar.

Sonuç

Walgo ile Walrus’a site deploy etmek, Web3 yayıncılığına başlamak isteyen kullanıcılar için pratik bir yoldur. Normalde merkezi olmayan depolama, blockchain cüzdanı, site kaydı ve deploy işlemleri karmaşık görünebilir. Walgo bu süreci komutlar ve interaktif sihirbazlarla daha yönetilebilir hale getirir.

Yeni başlayanlar için en kolay başlangıç walgo quickstart my-blog komutudur. Daha kontrollü ilerlemek isteyenler ise walgo init, walgo build ve walgo launch adımlarını takip edebilir.

Eğer sadece deneme yapmak istiyorsanız HTTP test deploy iyi bir başlangıçtır. Gerçek bir proje yayınlamak istiyorsanız on-chain deploy ve SuiNS bağlantısını değerlendirebilirsiniz.

Kısacası Walgo, “Web3 üzerinde site yayınlamak istiyorum ama nereden başlayacağımı bilmiyorum” diyen kullanıcılar için güçlü, pratik ve öğrenmesi kolay bir araçtır.

Walgo ile Site Deploy Etme Hakkında Sık Sorulan Sorular

Walgo ile site deploy etmek ücretsiz mi?

Walgo’da ücretsiz HTTP test modu bulunur. Bu modda cüzdan veya kripto para gerekmeden geçici deploy yapılabilir. Daha kalıcı on-chain deploy için Sui cüzdanı ve SUI token gerekir.

Walgo kullanmak için Sui cüzdanı gerekir mi?

HTTP test deploy için Sui cüzdanı gerekmez. Ancak on-chain deploy yapmak ve SuiNS gibi özellikleri kullanmak istiyorsanız Sui cüzdanına ihtiyaç duyabilirsiniz.

Walgo ile hangi tür siteler deploy edilebilir?

Walgo özellikle Hugo ile oluşturulan statik web siteleri için tasarlanmıştır. Bloglar, portfolyolar, dokümantasyon siteleri ve landing page’ler için uygundur.

Walgo quickstart ne işe yarar?

walgo quickstart, tek komutla site oluşturma, build alma ve deploy sürecini başlatmak için kullanılan hızlı başlangıç komutudur.

Walgo launch komutu ne yapar?

walgo launch, interaktif deploy sihirbazını başlatır. Kullanıcıyı adım adım yönlendirerek siteyi Walrus’a deploy etmeyi kolaylaştırır.

Walgo CLI yerine Walgo Web kullanılabilir mi?

Evet. Terminal kullanmak istemeyen kullanıcılar Walgo Web ile tarayıcı üzerinden site oluşturabilir, düzenleyebilir ve Walrus’a deploy edebilir.

Walgo ile deploy edilen siteye özel alan adı bağlanabilir mi?

Evet. Walgo, SuiNS desteği sunar. Bu sayede siteyi daha okunabilir ve paylaşılabilir bir adrese bağlamak mümkündür.