إعداد البروكسي في حاويات دوكر: دليل كامل مع أمثلة على الشيفرة

تتطلب حاويات Docker غالبًا الوصول إلى موارد خارجية عبر بروكسي - للتجميع، الاختبار من مناطق مختلفة أو لتجاوز القيود. تؤدي الإعدادات غير الصحيحة للبروكسي إلى أخطاء في الاتصال، تسرب عنوان IP الحقيقي، وتعطيل التطبيقات. في هذه المقالة، سنستعرض جميع طرق إعداد البروكسي في Docker: من المتغيرات البيئية البسيطة إلى السيناريوهات المتقدمة مع docker-compose والشبكات المخصصة.

لماذا تحتاج إلى بروكسي في حاويات Docker

تُستخدم حاويات Docker في سيناريوهات متنوعة حيث يصبح البروكسي ضرورة. دعونا نستعرض المهام الرئيسية التي يحلها البروكسي في التطبيقات المعبأة.

التجميع وجمع البيانات: إذا كنت تقوم بتشغيل مجمعات في حاويات Docker لجمع البيانات من الأسواق (Wildberries، Ozon)، الشبكات الاجتماعية أو محركات البحث، فإن البروكسي يحمي من الحظر بناءً على IP. تسمح الحاويات بتوسيع نطاق التجميع - تشغيل 10-50 مثيلًا في وقت واحد، كل منها مع بروكسي خاص به.

الاختبار من مناطق مختلفة: عند تطوير تطبيقات الويب أو واجهات برمجة التطبيقات المحمولة، غالبًا ما تحتاج إلى التحقق من كيفية عمل الخدمة من دول مختلفة. تتيح لك حاويات Docker مع بروكسي من مواقع جغرافية مختلفة أتمتة هذا الاختبار في خط أنابيب CI/CD.

الأتمتة والروبوتات: تتطلب الحاويات التي تستخدم Selenium أو Puppeteer أو Playwright لأتمتة المتصفحات بروكسي للعمل مع حسابات متعددة. يحصل كل حاوية على بروكسي خاص بها وبيئة معزولة.

تجاوز القيود المؤسسية: في بعض البنى التحتية، يجب أن تمر حاويات Docker عبر بروكسي مؤسسي للوصول إلى الإنترنت. بدون الإعداد الصحيح، لن تتمكن الحاويات من تنزيل الحزم أو الوصول إلى واجهات برمجة التطبيقات الخارجية.

الإعداد الأساسي عبر المتغيرات البيئية

أسهل طريقة لإعداد البروكسي في حاوية Docker هي تمرير المتغيرات البيئية عند التشغيل. تعمل هذه الطريقة مع معظم التطبيقات التي تحترم المتغيرات القياسية HTTP_PROXY و HTTPS_PROXY و NO_PROXY.

تشغيل الحاوية مع البروكسي عبر docker run:

docker run -d \
  -e HTTP_PROXY="http://username:password@proxy.example.com:8080" \
  -e HTTPS_PROXY="http://username:password@proxy.example.com:8080" \
  -e NO_PROXY="localhost,127.0.0.1,.local" \
  your-image:latest

شرح المعلمات:

• HTTP_PROXY — البروكسي لطلبات HTTP
• HTTPS_PROXY — البروكسي لطلبات HTTPS (استخدم http://، وليس https://)
• NO_PROXY — قائمة العناوين التي لا يجب أن تمر عبر البروكسي

مثال مع بروكسي SOCKS5:

docker run -d \
  -e HTTP_PROXY="socks5://username:password@proxy.example.com:1080" \
  -e HTTPS_PROXY="socks5://username:password@proxy.example.com:1080" \
  your-image:latest

إعداد البروكسي لخدمة Docker (يؤثر على جميع الحاويات):

إذا كنت بحاجة إلى أن تستخدم جميع الحاويات البروكسي بشكل افتراضي، قم بإعداد خدمة Docker. أنشئ ملف /etc/systemd/system/docker.service.d/http-proxy.conf:

[Service]
Environment="HTTP_PROXY=http://proxy.example.com:8080"
Environment="HTTPS_PROXY=http://proxy.example.com:8080"
Environment="NO_PROXY=localhost,127.0.0.1,.local"

بعد إجراء التغييرات، أعد تشغيل Docker:

sudo systemctl daemon-reload
sudo systemctl restart docker

إعداد البروكسي في Dockerfile

عندما تقوم ببناء صورة Docker التي يجب أن تقوم بتنزيل الحزم عبر البروكسي (مثل apt-get، pip، npm)، يجب إعداد البروكسي في مرحلة البناء. يدعم Docker المعلمات في وقت البناء لهذا الغرض.

مثال على Dockerfile يدعم البروكسي:

FROM python:3.11-slim

# المعلمات للبروكسي (تُمرر عند البناء)
ARG HTTP_PROXY
ARG HTTPS_PROXY
ARG NO_PROXY

# تعيين المتغيرات البيئية للبناء
ENV HTTP_PROXY=${HTTP_PROXY}
ENV HTTPS_PROXY=${HTTPS_PROXY}
ENV NO_PROXY=${NO_PROXY}

# تثبيت الاعتماديات عبر البروكسي
RUN apt-get update && apt-get install -y curl

# تثبيت حزم Python
COPY requirements.txt .
RUN pip install --proxy ${HTTP_PROXY} -r requirements.txt

# نسخ التطبيق
COPY . /app
WORKDIR /app

# إزالة متغيرات البروكسي لوقت التشغيل (اختياري)
ENV HTTP_PROXY=
ENV HTTPS_PROXY=

CMD ["python", "app.py"]

بناء الصورة مع تمرير البروكسي:

docker build \
  --build-arg HTTP_PROXY=http://proxy.example.com:8080 \
  --build-arg HTTPS_PROXY=http://proxy.example.com:8080 \
  --build-arg NO_PROXY=localhost,127.0.0.1 \
  -t my-app:latest .

لتطبيقات Node.js (npm عبر البروكسي):

FROM node:18-alpine

ARG HTTP_PROXY
ARG HTTPS_PROXY

# إعداد npm للعمل عبر البروكسي
RUN npm config set proxy ${HTTP_PROXY}
RUN npm config set https-proxy ${HTTPS_PROXY}

COPY package*.json ./
RUN npm install

# تنظيف إعدادات البروكسي لـ npm
RUN npm config delete proxy
RUN npm config delete https-proxy

COPY . .
CMD ["node", "server.js"]

تكوين البروكسي في docker-compose.yml

يسهل Docker Compose إدارة البروكسي للتطبيقات متعددة الحاويات. يمكنك إعداد البروكسي بشكل عالمي أو لخدمات فردية.

التكوين الأساسي مع البروكسي لخدمة واحدة:

version: '3.8'

services:
  parser:
    image: python:3.11-slim
    environment:
      - HTTP_PROXY=http://username:password@proxy.example.com:8080
      - HTTPS_PROXY=http://username:password@proxy.example.com:8080
      - NO_PROXY=localhost,127.0.0.1,db
    volumes:
      - ./app:/app
    working_dir: /app
    command: python parser.py
    
  db:
    image: postgres:15
    # قاعدة البيانات لا تستخدم البروكسي
    environment:
      - POSTGRES_PASSWORD=secret

استخدام ملف .env لتخزين بيانات الاعتماد بشكل آمن:

أنشئ ملف .env في الدليل الذي يحتوي على docker-compose.yml:

PROXY_URL=http://username:password@proxy.example.com:8080
NO_PROXY=localhost,127.0.0.1

اشير إلى المتغيرات في docker-compose.yml:

version: '3.8'

services:
  parser:
    image: python:3.11-slim
    environment:
      - HTTP_PROXY=${PROXY_URL}
      - HTTPS_PROXY=${PROXY_URL}
      - NO_PROXY=${NO_PROXY}
    volumes:
      - ./app:/app
    working_dir: /app
    command: python parser.py

تكوين البروكسي لبناء الصورة في docker-compose:

version: '3.8'

services:
  app:
    build:
      context: .
      dockerfile: Dockerfile
      args:
        - HTTP_PROXY=${PROXY_URL}
        - HTTPS_PROXY=${PROXY_URL}
        - NO_PROXY=${NO_PROXY}
    environment:
      - HTTP_PROXY=${PROXY_URL}
      - HTTPS_PROXY=${PROXY_URL}
    ports:
      - "3000:3000"

توسيع مع بروكسي مختلف لكل مثيل:

إذا كنت بحاجة إلى تشغيل عدة مجمعات، كل منها مع بروكسي خاص به، استخدم خدمات منفصلة:

version: '3.8'

services:
  parser-1:
    image: my-parser:latest
    environment:
      - PROXY_URL=http://user:pass@proxy1.example.com:8080
    volumes:
      - ./data:/data
    
  parser-2:
    image: my-parser:latest
    environment:
      - PROXY_URL=http://user:pass@proxy2.example.com:8080
    volumes:
      - ./data:/data
    
  parser-3:
    image: my-parser:latest
    environment:
      - PROXY_URL=http://user:pass@proxy3.example.com:8080
    volumes:
      - ./data:/data

إعداد البروكسي على مستوى التطبيق

بعض التطبيقات لا تدعم المتغيرات البيئية القياسية HTTP_PROXY. في هذه الحالات، يجب إعداد البروكسي في كود التطبيق أو ملفات التكوين.

Python (مكتبة requests):

import os
import requests

# الحصول على البروكسي من المتغير البيئي
proxy_url = os.getenv('PROXY_URL', 'http://proxy.example.com:8080')

proxies = {
    'http': proxy_url,
    'https': proxy_url
}

# استخدام البروكسي في الطلبات
response = requests.get('https://api.example.com/data', proxies=proxies)
print(response.json())

# للبروكسي SOCKS5، قم بتثبيت pip install requests[socks]
# proxies = {
#     'http': 'socks5://user:pass@proxy.example.com:1080',
#     'https': 'socks5://user:pass@proxy.example.com:1080'
# }

Python (aiohttp للطلبات غير المتزامنة):

import os
import aiohttp
import asyncio

async def fetch_with_proxy():
    proxy_url = os.getenv('PROXY_URL')
    
    async with aiohttp.ClientSession() as session:
        async with session.get(
            'https://api.example.com/data',
            proxy=proxy_url
        ) as response:
            data = await response.json()
            print(data)

asyncio.run(fetch_with_proxy())

Node.js (مكتبة axios):

const axios = require('axios');
const { HttpsProxyAgent } = require('https-proxy-agent');

const proxyUrl = process.env.PROXY_URL || 'http://proxy.example.com:8080';
const agent = new HttpsProxyAgent(proxyUrl);

axios.get('https://api.example.com/data', {
  httpsAgent: agent
})
.then(response => {
  console.log(response.data);
})
.catch(error => {
  console.error('Error:', error.message);
});

Node.js (وحدة https المدمجة):

const https = require('https');
const { HttpsProxyAgent } = require('https-proxy-agent');

const proxyUrl = process.env.PROXY_URL;
const agent = new HttpsProxyAgent(proxyUrl);

const options = {
  hostname: 'api.example.com',
  port: 443,
  path: '/data',
  method: 'GET',
  agent: agent
};

const req = https.request(options, (res) => {
  let data = '';
  res.on('data', (chunk) => data += chunk);
  res.on('end', () => console.log(JSON.parse(data)));
});

req.on('error', (error) => console.error(error));
req.end();

Selenium مع البروكسي في حاوية Docker:

from selenium import webdriver
from selenium.webdriver.common.proxy import Proxy, ProxyType
import os

proxy_url = os.getenv('PROXY_URL', 'proxy.example.com:8080')

# إعداد البروكسي لـ Chrome
chrome_options = webdriver.ChromeOptions()
chrome_options.add_argument(f'--proxy-server={proxy_url}')

# للتوثيق، استخدم ملحقًا أو نفق SSH
driver = webdriver.Chrome(options=chrome_options)
driver.get('https://example.com')
print(driver.title)
driver.quit()

Puppeteer مع البروكسي:

const puppeteer = require('puppeteer');

(async () => {
  const proxyUrl = process.env.PROXY_URL || 'proxy.example.com:8080';
  
  const browser = await puppeteer.launch({
    args: [`--proxy-server=${proxyUrl}`],
    headless: true
  });
  
  const page = await browser.newPage();
  
  // التوثيق للبروكسي
  await page.authenticate({
    username: 'your-username',
    password: 'your-password'
  });
  
  await page.goto('https://example.com');
  console.log(await page.title());
  
  await browser.close();
})();

أي نوع من البروكسي تختار لـ Docker

يعتمد اختيار نوع البروكسي على المهمة التي يقوم بها تطبيقك في حاوية Docker. دعونا نستعرض السيناريوهات الرئيسية والتوصيات.

توصيات للاختيار لمهام معينة:

تجميع الأسواق وكatalogs المنتجات: إذا كنت تقوم بتجميع Wildberries، Ozon أو أسواق أخرى عبر حاويات Docker، استخدم بروكسي سكنية. تقوم هذه المنصات بحظر IP لمراكز البيانات بنشاط. قم بإعداد تدوير البروكسي كل 5-10 دقائق لمحاكاة مستخدمين مختلفين.

اختبار واجهة برمجة التطبيقات والتطوير: لاختبار واجهات برمجة التطبيقات الخاصة بك أو التكامل مع الخدمات الخارجية، استخدم بروكسي مراكز البيانات. توفر سرعة عالية واستقرار في الاتصال، وهو أمر مهم للاختبارات الآلية في CI/CD.

أتمتة Selenium/Puppeteer: عند تشغيل أتمتة المتصفح في الحاويات للعمل مع المواقع المحمية (الشبكات الاجتماعية، البنوك، التطبيقات الويب المعقدة)، اختر بروكسي سكنية. تقلل من احتمال ظهور CAPTCHA والحظر.

اختبار جغرافي موزع: إذا كنت بحاجة إلى التحقق من توفر الخدمة من دول مختلفة، استخدم بروكسي سكنية مع اختيار موقع جغرافي محدد. قم بتشغيل عدة حاويات Docker، كل منها مع بروكسي خاص بدولتها.

حل المشكلات الشائعة

عند العمل مع البروكسي في حاويات Docker، تظهر مشاكل شائعة. دعونا نستعرض الأكثر شيوعًا وطرق حلها.

المشكلة 1: الحاوية لا تستطيع الاتصال بالبروكسي

الأعراض: أخطاء "Connection refused"، "Proxy connection failed"، مهلات عند تشغيل الحاوية.

الحلول:

• تحقق من توفر البروكسي من المضيف: curl -x http://proxy:port https://example.com
• تأكد من أن خادم البروكسي متاح من شبكة Docker. إذا كان البروكسي على localhost المضيف، استخدم host.docker.internal (Mac/Windows) أو IP المضيف في شبكة bridge
• تحقق من قواعد جدار الحماية - قد تكون حاويات Docker محظورة للاتصالات الصادرة
• للبروكسي مع التوثيق، تحقق من صحة اسم المستخدم وكلمة المرور، وقم بتشفير الرموز الخاصة في عنوان URL

مثال على الوصول إلى البروكسي على المضيف:

# Mac/Windows
docker run -e HTTP_PROXY=http://host.docker.internal:8080 my-image

# Linux (اكتشف IP المضيف في شبكة bridge)
ip addr show docker0  # عادة 172.17.0.1
docker run -e HTTP_PROXY=http://172.17.0.1:8080 my-image

المشكلة 2: DNS لا يتم حله عبر البروكسي

الأعراض: أخطاء "Could not resolve host"، طلبات DNS لا تمر عبر البروكسي.

الحلول:

• استخدم بروكسي SOCKS5 بدلاً من HTTP - يقوم SOCKS5 بتمرير طلبات DNS
• قم بإعداد DNS في Docker: أضف --dns 8.8.8.8 عند تشغيل الحاوية
• بالنسبة للتطبيقات التي لا تدعم DNS عبر البروكسي، استخدم proxychains داخل الحاوية

# Dockerfile مع proxychains
FROM python:3.11-slim

RUN apt-get update && apt-get install -y proxychains4

# تكوين proxychains
RUN echo "strict_chain\nproxy_dns\n[ProxyList]\nsocks5 proxy.example.com 1080" > /etc/proxychains4.conf

# تشغيل التطبيق عبر proxychains
CMD ["proxychains4", "python", "app.py"]

المشكلة 3: تسرب عنوان IP الحقيقي للحاوية

الأعراض: ترى الخدمة المستهدفة IP المضيف أو الحاوية بدلاً من IP البروكسي.

الحلول:

• تحقق من أن التطبيق يستخدم البروكسي بالفعل - قم بإجراء طلب إلى https://api.ipify.org
• تأكد من أن جميع عملاء HTTP في الكود معدة لاستخدام البروكسي
• بالنسبة لاتصالات WebRTC و WebSocket، قد لا يعمل البروكسي - قم بإيقاف WebRTC في المتصفحات
• تحقق من رؤوس الطلبات - تضيف بعض المكتبات X-Forwarded-For مع IP الحقيقي

اختبار تسرب IP في الحاوية:

# بدون بروكسي
docker run --rm curlimages/curl:latest curl https://api.ipify.org

# مع بروكسي
docker run --rm \
  -e HTTPS_PROXY=http://proxy.example.com:8080 \
  curlimages/curl:latest curl https://api.ipify.org

المشكلة 4: عمل بطيء عبر البروكسي

الأعراض: تأخيرات عالية، مهلات، تحميل بطيء للبيانات.

الحلول:

• تحقق من سرعة البروكسي مباشرة من المضيف - ربما تكون المشكلة في البروكسي نفسه
• قم بزيادة المهلات في التطبيق للعمل مع البروكسيات البطيئة
• استخدم اتصالات keep-alive لإعادة استخدام اتصالات TCP
• بالنسبة للبروكسي السكنية، فإن السرعة البطيئة هي القاعدة، قم بتحسين عدد الطلبات
• قم بإعداد مجموعة اتصالات في عملاء HTTP للطلبات المتوازية

المشكلة 5: يعمل البروكسي لـ HTTP، لكن ليس لـ HTTPS

الأعراض: تمر طلبات HTTP، بينما تعيد HTTPS أخطاء SSL/TLS.

الحلول:

• تأكد من تعيين المتغير HTTPS_PROXY (ليس فقط HTTP_PROXY)
• استخدم http:// في عنوان البروكسي لـ HTTPS_PROXY، وليس https://
• تحقق مما إذا كان البروكسي يدعم طريقة CONNECT لتوجيه HTTPS
• للبروكسي مع الشهادات الموقعة ذاتيًا، قم بإيقاف التحقق من SSL (فقط للاختبارات!)

الأمان وإدارة بيانات الاعتماد

يتطلب تخزين بيانات اعتماد البروكسي في حاويات Docker اهتمامًا خاصًا بالأمان. يمكن أن تؤدي الإدارة غير الصحيحة لكلمات المرور إلى تسربها في السجلات، الصور أو المستودعات.

استخدم أسرار Docker للإنتاج:

يدعم Docker Swarm آلية الأسرار لتخزين كلمات المرور بشكل آمن. أنشئ سرًا:

echo "http://username:password@proxy.example.com:8080" | docker secret create proxy_url -

استخدمه في docker-compose لـ Swarm:

version: '3.8'

services:
  app:
    image: my-app:latest
    secrets:
      - proxy_url
    environment:
      - PROXY_URL_FILE=/run/secrets/proxy_url
    command: sh -c 'export HTTP_PROXY=$(cat $$PROXY_URL_FILE) && python app.py'

secrets:
  proxy_url:
    external: true

المتغيرات البيئية عبر الملفات (.env):

للتطوير، استخدم ملفات .env، لكن لا تقم أبدًا بإدخالها في Git. أضف إلى .gitignore:

# .gitignore
.env
.env.local
*.env

أنشئ .env.example بدون بيانات اعتماد حقيقية:

# .env.example
PROXY_URL=http://username:password@proxy.example.com:8080
NO_PROXY=localhost,127.0.0.1

تجنب كتابة بيانات الاعتماد بشكل ثابت في الصور:

# ❌ سيء - ستبقى كلمة المرور في الصورة
FROM python:3.11
ENV HTTP_PROXY=http://user:secretpass@proxy.com:8080
COPY . /app

# ✅ جيد - مررها عبر معلمات البناء أو المتغيرات في وقت التشغيل
FROM python:3.11
ARG HTTP_PROXY
# تُستخدم فقط أثناء البناء، ولا يتم حفظها في الصورة النهائية

استخدم بناء متعدد المراحل لتنظيف بيانات الاعتماد:

# مرحلة البناء مع البروكسي
FROM python:3.11 AS builder
ARG HTTP_PROXY
ENV HTTP_PROXY=${HTTP_PROXY}
COPY requirements.txt .
RUN pip install -r requirements.txt

# المرحلة النهائية بدون متغيرات البروكسي
FROM python:3.11-slim
COPY --from=builder /usr/local/lib/python3.11/site-packages /usr/local/lib/python3.11/site-packages
COPY . /app
WORKDIR /app
CMD ["python", "app.py"]

تدوير بيانات اعتماد البروكسي:

إذا كان مزود البروكسي الخاص بك يدعم واجهة برمجة التطبيقات لإنشاء بيانات اعتماد مؤقتة، استخدمها بدلاً من كلمات المرور الثابتة. أنشئ سكربت init في الحاوية:

#!/bin/bash
# entrypoint.sh

# الحصول على بيانات اعتماد مؤقتة من واجهة برمجة التطبيقات
PROXY_CREDS=$(curl -s https://api.proxyservice.com/generate-temp-auth)
export HTTP_PROXY="http://${PROXY_CREDS}@proxy.example.com:8080"

# تشغيل التطبيق
exec python app.py

تسجيل بدون تسرب كلمات المرور:

قم بإعداد التسجيل بحيث لا تتسرب المتغيرات المتعلقة بالبروكسي إلى الإخراج:

import os
import re

def safe_log_env():
    """تسجيل المتغيرات البيئية بدون كلمات المرور"""
    for key, value in os.environ.items():
        if 'PROXY' in key:
            # إخفاء كلمة المرور في عنوان URL
            safe_value = re.sub(r'://([^:]+):([^@]+)@', r'://\1:****@', value)
            print(f"{key}={safe_value}")
        else:
            print(f"{key}={value}")

safe_log_env()

الخاتمة

إعداد البروكسي في حاويات Docker هو مهارة مهمة للمطورين الذين يعملون مع التجميع، الأتمتة والأنظمة الموزعة. لقد تعلمت كيفية إعداد البروكسي عبر المتغيرات البيئية، Dockerfile و docker-compose، كيفية دمج البروكسي في كود التطبيقات في Python و Node.js، وكيفية حل المشكلات الشائعة المتعلقة بالاتصال والأمان.

النقاط الرئيسية للعمل الناجح مع البروكسي في Docker: استخدم المتغيرات البيئية للمرونة، خزّن بيانات الاعتماد بأمان عبر الأسرار أو ملفات .env، اختر نوع البروكسي بناءً على المهمة، ودوماً اختبر عدم تسرب IP الحقيقي قبل التشغيل في الإنتاج.

لمعظم مهام التجميع والأتمتة في حاويات Docker، نوصي باستخدام بروكسي سكنية - فهي توفر أعلى درجات الخصوصية وأقل خطر للحظر عند العمل مع المواقع المحمية وواجهات برمجة التطبيقات. إذا كنت بحاجة إلى أقصى سرعة لاختبار واجهات برمجة التطبيقات أو المهام الداخلية، انظر إلى بروكسي مراكز البيانات.