Wiozen Digital
Dijital ürünlerini kendi mağazanda satSürüm 1.0.0Henüz değerlendirme yok
Bir Ubuntu sunucu, alan adın ve Lisanslarım'dan aldığın paketle mağazan yaklaşık yarım saatte açılır. Bu sayfa paketteki INSTALL.md belgesinin özeti. Örneklerde alan adı magazan.com, sürüm 1.0.0; kendi alan adını ve indirdiğin sürümü yaz.
Gerekenler
Ubuntu 22.04 ya da 24.04 çalışan bir VPS (en az 1 GB bellek, 10 GB boş disk) ve sudo yetkili SSH bağlantısı. Alan adının A kaydı (www kullanacaksan www kaydı da) sunucunun IP adresini göstermeli. Paket Lisanslarım'dan iner ve sana özeldir; başkasıyla paylaşma.
Node.js 22 ve unzip
Wiozen Digital Node.js 22.13 ya da daha yeni bir 22 sürümüyle çalışır. node -v çıktısı v22.13.0 ya da daha büyük bir v22 sürümü olmalı.
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs unzip
node -v
Kullanıcı ve klasörler
Uygulama kendi kullanıcısıyla çalışır. Her sürüm /opt/wiozen-digital/releases/<sürüm> klasörüne açılır, current bağı çalışan sürümü gösterir. Veriler (DATA_DIR) /var/lib/wiozen-digital'de durur.
sudo useradd --system --home /opt/wiozen-digital --shell /usr/sbin/nologin wiozen
sudo mkdir -p /opt/wiozen-digital/releases /var/lib/wiozen-digital
sudo chown -R wiozen:wiozen /opt/wiozen-digital /var/lib/wiozen-digital
sudo chmod 700 /var/lib/wiozen-digital
Paketi aç
Paketi sunucuya getir: kendi bilgisayarından scp ile gönder ya da Lisanslarım'da "Sunucu bağlantısı al"a basıp çıkan bağlantıyı sunucuda wget ile indir (bağlantı 10 dakika geçerli ve tek kullanımlık). Sonra paketi sürüm klasörüne aç, current bağını kur ve bağımlılıkları yükle.
scp wiozen-digital-1.0.0.zip kullanici@sunucu-ip:/tmp/
# ya da sunucuda: wget -O /tmp/wiozen-digital-1.0.0.zip "<sunucu bağlantısı>"
sudo -u wiozen unzip -q /tmp/wiozen-digital-1.0.0.zip -d /opt/wiozen-digital/releases/1.0.0
sudo -u wiozen ln -sfn releases/1.0.0 /opt/wiozen-digital/current
cd /opt/wiozen-digital/current && sudo -u wiozen npm ci --omit=dev
rm /tmp/wiozen-digital-1.0.0.zip
systemd birimi
Paketteki hazır birimi kopyala. Uygulama wiozen kullanıcısıyla, yalnız 127.0.0.1:3200'de ve DATA_DIR=/var/lib/wiozen-digital ile çalışır; sunucu açılınca başlar, çökerse yeniden açılır. Durum active (running), son komutun çıktısı {"ok":true} olmalı.
sudo cp /opt/wiozen-digital/current/deploy/wiozen-digital.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now wiozen-digital
sudo systemctl status wiozen-digital
curl -s http://127.0.0.1:3200/health
nginx ve https
Paketteki örnek nginx dosyasını kopyala ve server_name satırına kendi alan adını yaz. Sonra siteyi aç ve sertifikayı Let's Encrypt'ten al. Dosyadaki X-Real-IP satırını silme: uygulama ziyaretçinin IP adresini bu başlıktan okur.
sudo apt-get install -y nginx certbot python3-certbot-nginx
sudo cp /opt/wiozen-digital/current/deploy/nginx.conf.example /etc/nginx/sites-available/wiozen-digital
sudo nano /etc/nginx/sites-available/wiozen-digital
sudo ln -s /etc/nginx/sites-available/wiozen-digital /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx
sudo certbot --nginx -d magazan.com -d www.magazan.com --redirect
İlk açılış ve lisans
Kurulum kodunu oku ve https://magazan.com'u aç. Sihirbaz bu kodu, sonra yönetici hesabını ve mağaza bilgilerini ister; genel adres olarak https://magazan.com yaz. Son adım lisansı etkinleştirmek: Lisanslarım'da "Etkinleştirme kodu al"a bas ve kodu sihirbaza gir (30 dakika geçerli, tek kullanımlık). Lisans sunucusu siteni https://magazan.com/.well-known/wiozen-proof adresinden doğrular; alan adı bu sunucuyu göstermeli ve https çalışmalı.
sudo cat /var/lib/wiozen-digital/setup-token.txt
Yedek
Bütün veriler /var/lib/wiozen-digital'de: shop.db (yanındaki -wal ve -shm ile), secret.key (panelde girilen şifreli ayarların anahtarı), install.key (kurulumun lisans anahtarı; kaybolursa lisansı yeniden etkinleştirirsin) ve media/. Klasörün tamamını düzenli yedekle ve yedeği sunucunun dışında sakla. Tutarlı bir kopya için uygulamayı birkaç saniye durdur.
sudo systemctl stop wiozen-digital
sudo tar czf /root/wiozen-digital-yedek-$(date +%F).tar.gz -C /var/lib wiozen-digital
sudo systemctl start wiozen-digital
Güncelleme
Yeni sürüm panelin Lisans sayfasında görünür. Güncelleme hakkın sürüyorsa (satın almadan sonra bir yıl) Lisanslarım'da "Sunucu bağlantısı al"a bas ve bağlantıyı hemen sunucuda kullan. Komut paketi indirir, imzasını yazılımın içindeki Wiozen anahtarıyla doğrular, veritabanını ve görselleri /var/lib/wiozen-digital/backups/ altına yedekler, yeni sürümü releases/<sürüm>'e açar, veritabanı göçlerini çalıştırır ve en son current bağını çevirir. Bir adım başarısız olursa current eski sürümü gösterir ve mağaza çalışmayı sürdürür. "Güncellendi: 1.0.0 → 1.1.0" yazınca hizmeti yeniden başlat.
cd /opt/wiozen-digital/current
sudo -u wiozen DATA_DIR=/var/lib/wiozen-digital npm run update -- --url "https://themes.wiozen.com/wiozen-digital/download/..."
sudo systemctl restart wiozen-digital
curl -s http://127.0.0.1:3200/health
Önceki sürüme dönmek
Eski sürüm releases/ altında durur; current bağını ona çevirip yeniden başlat. Yeni sürüm veritabanını değiştirdiyse veritabanını da backups/pre-update-<sürüm>-<tarih>/ yedeğinden geri al; yedekten sonra alınan siparişler geri alınan veritabanında olmaz. Disk dolmasın diye arada bir eski sürümleri ve yedekleri sil; çalışan sürümü ve bir öncekini bırak.
sudo -u wiozen ln -sfn releases/1.0.0 /opt/wiozen-digital/current
sudo systemctl restart wiozen-digital
Sorun giderme
İlk bakılacak yer uygulamanın günlüğü. Site 502 veriyorsa uygulama çalışmıyordur; node -v 22.13'ten eskiyse Node'u güncelle. Yaygın sorunların çözümü paketteki INSTALL.md'nin son bölümünde.
sudo systemctl status wiozen-digital
sudo journalctl -u wiozen-digital -n 100 --no-pager