npm, yarn ve p için proxy kurulumu

npm, yarn ve pnpm için proxy yapılandırması

Giriş

Node.js paket yöneticileri (npm, yarn, pnpm) paketleri npm registry'den indirir. Kurumsal bir ağda veya anonimlik için proxy kullanırken, bu paket yöneticilerinin doğru çalışması adına bir proxy yapılandırmanız gerekir.

Temel yapılandırma

npm

npm config set proxy http://proxy_ip:port
npm config set https-proxy http://proxy_ip:port

Kimlik doğrulama ile:
npm config set proxy http://user:pass@proxy_ip:port

Doğrulama:
npm config get proxy

Kaldırma:
npm config delete proxy
npm config delete https-proxy

yarn

yarn config set proxy http://proxy_ip:port
yarn config set https-proxy http://proxy_ip:port

pnpm

pnpm config set proxy http://proxy_ip:port
pnpm config set https-proxy http://proxy_ip:port

Alternatif olarak ortam değişkenleri üzerinden: HTTP_PROXY, HTTPS_PROXY — bu üç yöneticide de çalışır.

Gelişmiş yapılandırma

Ortam değişkenleri

Çoğu araç proxy'ler için standart ortam değişkenlerini destekler:
- HTTP_PROXY / http_proxy — HTTP istekleri için proxy
- HTTPS_PROXY / https_proxy — HTTPS istekleri için proxy
- NO_PROXY / no_proxy — istisna listesi (proxy'yi atlayan adresler)
- ALL_PROXY / all_proxy — tüm protokoller için proxy

SSL ve kendinden imzalı sertifikalar

Kurumsal proxy'ler genellikle kendi SSL sertifikalarını kullanır. Bunların üzerinden çalışmak için şunları yapmanız gerekir:
1. Yöneticiden proxy'nin CA sertifikasını alın
2. Sertifikayı sisteminizin sertifika deposuna ekleyin
3. Veya SSL doğrulamasını devre dışı bırakın (yalnızca test için)

Kimlik doğrulama

İki temel kimlik doğrulama yöntemi desteklenir:

Kullanıcı adı ve parola — standart HTTP Basic kimlik doğrulaması. Kimlik bilgileri her istekle birlikte gönderilir. URL biçimi: http://user:pass@proxy_ip:port

IP adresine göre (whitelist) — IP adresiniz beyaz listeye eklenir. Kimlik bilgisi göndermeye gerek kalmaz.

Kurulumu doğrulama

Yapılandırmadan sonra şunları doğrulayın:
1. Proxy üzerinden bir test isteği gönderin
2. IP adresinizin değiştiğinden emin olun
3. Bağlantı hızını kontrol edin
4. DNS sızıntısı olmadığını doğrulayın

Sorun giderme

Proxy bağlanamıyor

• Adres ve portun doğruluğunu kontrol edin
• Güvenlik duvarınızın bağlantıyı engellemediğinden emin olun
• Proxy'nin ağınızdan erişilebilir olduğunu doğrulayın

SSL hataları

• Kurumsal proxy'ler için CA sertifikasını ekleyin
• Test için SSL doğrulamasını geçici olarak devre dışı bırakın
• SSL kütüphanelerini en son sürüme güncelleyin

Kimlik doğrulama hataları

• Kullanıcı adınızı ve parolanızı kontrol edin
• Kimlik bilgisi biçiminin doğru olduğundan emin olun
• Paroladaki özel karakterleri URL kodlamasıyla yazmayı deneyin

En iyi uygulamalar

1. Ortam değişkenleri kullanın — esneklik ve güvenlik için
2. Kimlik bilgilerini koda gömmeyin — ortam değişkenleri veya yapılandırma dosyaları kullanın
3. İstisnaları yapılandırın — localhost ve dahili adresleri proxy'den geçirmeyin
4. Ayarları belgeleyin — projenizin README dosyasında veya ekip wiki'sinde
5. Değişiklikten sonra test edin — her yapılandırma değişikliği doğrulama gerektirir

Sonuç

Doğru proxy yapılandırması, araçların kararlı çalışmasını ve güvenli bağlantıları sağlar. Bu kılavuzdaki önerileri izleyin ve kurulumdan sonra çalışırlığı her zaman doğrulayın.