Kurulum ve Yapılandırma

Proxy Dokümentasyonu Güncellendi Feb 28, 2026

Kurulum ve Yapılandırma

ArtadoProxy'yi yerel ortamınızda veya sunucunuzda sorunsuz bir şekilde çalıştırmak için aşağıdaki adımları izleyin.

Gereksinimler

  • Node.js: v20.x veya üzeri (LTS önerilir)
  • Paket Yöneticisi: npm veya yarn
  • İşletim Sistemi: Linux, macOS veya Windows (WSL önerilir)

Adımlar

  1. Depoyu Klonlayın: Projeyi yerel makinenize indirmek için terminale şu komutu yazın:

    git clone https://github.com/Sxinar/artstelve-proxy.git

cd artstelve-proxy

  1. Bağımlılıkları Yükleyin: Gerekli tüm kütüphaneleri yüklemek için:

    npm install

  2. Yapılandırma: Örnek yapılandırma dosyasını kopyalayarak kendi .env dosyanızı oluşturun:

    cp .env.example .env

Ardından .env dosyasını bir metin düzenleyici ile açarak ihtiyacınıza göre düzenleyin.

Ortam Değişkenleri (.env)

Aşağıdaki tabloda yapılandırabileceğiniz temel değişkenler yer almaktadır:

Değişken Varsayılan Açıklama
PORT 8787 Uygulamanın dinleyeceği ağ portu.
NODE_ENV development development veya production
GLOBAL_ENGINE_CONCURRENCY 10 Aynı anda yapılabilecek toplam motor isteği sayısı.
PER_ENGINE_CONCURRENCY 3 Her bir motorun aynı anda yapılabilecek maksimum istek sayısı.

Çalıştırma Komutları

Projenizi çalıştırmak için aşağıdaki komutları kullanabilirsiniz:

Geliştirme Modu

Kodda yaptığınız değişikliklerin anında yansıması için (Hot Reload):

npm run dev

Üretim (Build) İşlemleri

Uygulamayı canlıya almadan önce optimize edilmiş sürümü oluşturun:

Projeyi derle (Build)

npm run build

Derlenmiş uygulamayı başlat

npm run dev

Motor Yapılandırması Hakkında Notlar

Her motor (Scraper) kendi içinde özel ayarlara sahiptir. Bu ayarlar kaynak kod içerisindeki yapılandırma dosyalarından yönetilir:

  • User-Agent Rotasyonu: Engellenmeyi önlemek için otomatik değişir.
  • Zaman Aşımı: Her motor için özel timeoutMs değerleri belirlenebilir.
  • Hata Yönetimi: Captcha veya bloklanma durumunda motor otomatik olarak pasif duruma çekilir.