وسوم صورة 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.
الأداء بعد التسخين
| الأداة | CPU | GPU | التسريع |
|---|---|---|---|
| إزالة الخلفية (u2net) | 2,415ms | 879ms | 2.7x |
| إزالة الخلفية (isnet) | 2,457ms | 1,137ms | 2.2x |
| تكبير 2x | 350ms | 309ms | 1.1x |
| تكبير 4x | 910ms | 310ms | 2.9x |
| تمويه الوجوه | 139ms | 122ms | 1.1x |
البدء البارد (أول طلب بعد بدء الحاوية)
| الأداة | CPU | GPU | التسريع |
|---|---|---|---|
| إزالة الخلفية | 22,286ms | 4,792ms | 4.7x |
| تكبير 2x | 3,957ms | 2,318ms | 1.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/amd64 | NVIDIA CUDA | تسريع CUDA كامل لأدوات الذكاء الاصطناعي |
| linux/arm64 | CPU فقط | Raspberry Pi 4/5، وApple Silicon عبر Docker Desktop |
الانتقال من الوسوم السابقة
إذا كنت تستخدم الوسم :cuda، فانتقل إلى :latest واحتفظ بـ --gpus all. الدعم نفسه لـ GPU، في صورة موحدة.
تُحفظ بياناتك وإعداداتك في وحدات التخزين.
