تُرجمت هذه الصفحة آليًا. هل لاحظت خطأً؟ساعد في تحسينها.
Skip to content

وسوم صورة Docker ​

يُشحن SnapOtter كصورة Docker واحدة. عند تشغيلها بمفردها تبدأ PostgreSQL 17 وRedis مضمَّنتين على واجهة loopback (الوضع المضمَّن)، أما في بيئة الإنتاج فشغّلها إلى جانب حاويتين منفصلتين لـ PostgreSQL 17 وRedis 8 باستخدام Compose. تعمل صورة التطبيق على جميع المنصات.

البدء السريع ​

bash
docker run -d --name SnapOtter -p 1349:1349 -v SnapOtter-data:/data snapotter/snapotter:latest

عند عدم ضبط DATABASE_URL، يعمل هذا في الوضع المضمَّن: تبدأ PostgreSQL وRedis داخل الحاوية على loopback، مع وجود جميع البيانات ضمن وحدة التخزين SnapOtter-data. اضبط DATABASE_URL وREDIS_URL (كما تفعل حزمة Compose) لاستخدام خدمات خارجية بدلاً من ذلك. راجع الإعدادات.

تسريع NVIDIA CUDA ​

تتضمن الصورة دعم NVIDIA CUDA على amd64. إذا كان لديك وحدة معالجة رسومية من NVIDIA مع تثبيت NVIDIA Container Toolkit، فأضف --gpus all:

bash
docker run -d --name SnapOtter --gpus all -p 1349:1349 -v SnapOtter-data:/data snapotter/snapotter:latest

تكتشف الصورة CUDA تلقائياً أثناء التشغيل. بدون --gpus all، أو عند عدم توفر CUDA، تعمل أدوات الذكاء الاصطناعي على وحدة المعالجة المركزية. الصورة نفسها في الحالتين.

تسريع وحدات iGPU من Intel/AMD عبر VA-API أو Quick Sync أو OpenCL غير مدعوم حالياً في استدلال الذكاء الاصطناعي في SnapOtter. قد يؤدي ربط /dev/dri داخل الحاوية إلى إتاحة جهاز العرض، لكن بيئة تشغيل الذكاء الاصطناعي ستظل تستخدم وحدة المعالجة المركزية ما لم يتوفر CUDA.

مقاييس الأداء ​

أُجريت الاختبارات على NVIDIA RTX 4070 (ذاكرة VRAM بسعة 12 GB) مع صورة JPEG بورتريه بأبعاد 572x1024.

الأداء بعد التسخين ​

الأداةCPUGPUالتسريع
إزالة الخلفية (u2net)2,415ms879ms2.7x
إزالة الخلفية (isnet)2,457ms1,137ms2.2x
تكبير 2x350ms309ms1.1x
تكبير 4x910ms310ms2.9x
تمويه الوجوه139ms122ms1.1x

البدء البارد (أول طلب بعد بدء الحاوية) ​

الأداةCPUGPUالتسريع
إزالة الخلفية22,286ms4,792ms4.7x
تكبير 2x3,957ms2,318ms1.7x

لا يشمل مقارنة CUDA التعرف الضوئي على الحروف (OCR). تستخدم كل من طبقة Tesseract المدمجة وطبقات RapidOCR/ONNX الاختيارية وحدة المعالجة المركزية، بما في ذلك عندما تملك الحاوية صلاحية الوصول إلى GPU من NVIDIA.

فحص سلامة CUDA ​

بعد أول طلب للذكاء الاصطناعي، تُبلغ نقطة نهاية الصحة الخاصة بالمسؤول عن حالة CUDA GPU:

GET /api/v1/admin/health
{"ai": {"gpu": true}}

Docker Compose ​

تتضمن حزمة Compose الكاملة التطبيق وPostgreSQL 17 وRedis 8. راجع النشر للاطلاع على docker-compose.yml الكامل. مثال مبسط:

yaml
services:
  SnapOtter:
    image: snapotter/snapotter:latest
    ports:
      - "1349:1349"
    volumes:
      - SnapOtter-data:/data
      - SnapOtter-workspace:/tmp/workspace
    environment:
      # Runtime role (rows only), then the boot-only owner connection.
      - DATABASE_URL=postgres://${POSTGRES_APP_USER:-snapotter_app}:${POSTGRES_APP_PASSWORD:-snapotter_app}@postgres:5432/${POSTGRES_DB:-snapotter}
      - DATABASE_MIGRATION_URL=postgres://${POSTGRES_USER:-snapotter}:${POSTGRES_PASSWORD:-snapotter}@postgres:5432/${POSTGRES_DB:-snapotter}
      - REDIS_URL=redis://redis:6379
    depends_on:
      postgres:
        condition: service_healthy
      redis:
        condition: service_healthy
    restart: unless-stopped
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"

  postgres:
    image: postgres:17-alpine
    environment:
      POSTGRES_USER: ${POSTGRES_USER:-snapotter}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-snapotter}     # Change this for non-local deployments
      POSTGRES_DB: ${POSTGRES_DB:-snapotter}
    volumes:
      - SnapOtter-pgdata:/var/lib/postgresql/data
    restart: unless-stopped
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-snapotter} -d ${POSTGRES_DB:-snapotter}"]
      interval: 10s
      timeout: 5s
      retries: 12

  redis:
    image: redis:8-alpine
    command: ["redis-server", "--maxmemory-policy", "noeviction", "--appendonly", "yes"]
    volumes:
      - SnapOtter-redisdata:/data
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 10s
      timeout: 5s
      retries: 12

volumes:
  SnapOtter-data:
  SnapOtter-workspace:
  SnapOtter-pgdata:
  SnapOtter-redisdata:

لتسريع NVIDIA CUDA عبر Docker Compose، أضف قسم deploy إلى خدمة SnapOtter:

yaml
    deploy:
      resources:
        reservations:
          devices:
            - driver: nvidia
              count: 1
              capabilities: [gpu]

تثبيت الإصدار ​

الوسمالوصف
latestأحدث إصدار
2.2.0إصدار محدد بدقة
2.2أحدث تصحيح في 2.2.x
2أحدث إصدار فرعي في 2.x

المنصات ​

المعماريةدعم GPUملاحظات
linux/amd64NVIDIA CUDAتسريع CUDA كامل لأدوات الذكاء الاصطناعي
linux/arm64CPU فقطRaspberry Pi 4/5، وApple Silicon عبر Docker Desktop

الانتقال من الوسوم السابقة ​

إذا كنت تستخدم الوسم :cuda، فانتقل إلى :latest واحتفظ بـ --gpus all. الدعم نفسه لـ GPU، في صورة موحدة.

تُحفظ بياناتك وإعداداتك في وحدات التخزين.