نصب از طریق Docker

نکته زیرساخت

این راهنما از Docker Compose استفاده میکند و برای IaaS (زیرساخت به عنوان سرویس — سرورها یا ماشین های مجازی اختصاصی که Docker Engine را اجرا میکنند) طراحی شده است. اگر قصد استقرار روی پلتفرم های ابری مدیریت شده (PaaS / CaaS) مانند Render، Railway، AWS ECS، Google Cloud Run یا Kubernetes را دارید، به راهنمای استقرار ابری مراجعه کنید.

پیش‌نیازها (روی Ubuntu 22.04+ آزمایش شده):

• یک سرور Ubuntu با دسترسی sudo
• یک نام دامنه که به IP عمومی سرور شما اشاره می‌کند (توصیه‌شده)

۱. راه‌اندازی سیستم

این بسته‌ها را نصب کنید:

sudo apt install -y ca-certificates gnupg lsb-release

کلید رسمی GPG مربوط به Docker را اضافه کنید:

sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

مخزن apt مربوط به Docker را اضافه کنید:

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Docker Engine + افزونه Compose را نصب کنید:

sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

اختیاری: اجرای Docker بدون sudo:

sudo usermod -aG docker $USER
newgrp docker

اختیاری: بررسی نصب:

docker --version
docker compose version
docker run hello-world

۲. کلون‌کردن مخزن

sudo mkdir -p /opt/songbird
cd /opt/songbird
git clone https://github.com/bllackbull/Songbird.git .

۳. پیکربندی محیط

فایل نمونه محیطی را کپی کرده و ویرایش کنید:

cp .env.example .env
nano .env

استفاده از PostgreSQL در Docker

پایگاه داده پیشفرض Songbird بر پایه SQLite است (DB_CLIENT=sqlite3). برای استفاده از PostgreSQL، فایل .env را ویرایش کرده و DB_CLIENT=postgres را به همراه متغیرهای POSTGRES_* تنظیم کنید، یا سرویس و volume اختیاری postgres را در docker-compose.yaml از حالت کامنت خارج کنید.

کانتینر Media Worker

کانتینر یکپارچه (bllackbull/songbird:latest) به صورت پیشفرض شامل پروسه ورکر محلی است و آن را خودکار اجرا و مدیریت میکند. برای محیط های با بار کاری سنگین یا توزیع شده، میتوانید پردازش ویدیوها را به کانتینر مجزای (bllackbull/songbird-worker:latest) بسپارید یا سرویس اختیاری media-worker را در docker-compose.yaml از کامنت خارج نمایید. برای جزییات بیشتر به مستندات ورکر مدیا مراجعه کنید.

۴. راه‌اندازی گواهی‌نامه TLS

کانتینر nginx برای اجرا به فایل‌های گواهی‌نامه TLS نیاز دارد. گواهی‌نامه و کلید خصوصی خود را در مسیرهای زیر قرار دهید:

• certs/cert.pem — گواهی‌نامه (یا زنجیره کامل)
• certs/key.pem — کلید خصوصی

برای دیدن گزینه‌های موجود، به گواهی‌نامه‌های SSL مراجعه کنید.

۵. ساخت و اجرا

ایمیج از پیش ساخته‌شده را دریافت و کانتینرها را اجرا کنید:

cd /opt/songbird
docker compose up -d

ایمیج به‌طور خودکار از Docker Hub دریافت می‌شود. اگر ترجیح می‌دهید از سورس بسازید، docker-compose.yaml را ویرایش کرده و خط image: را با بلوک build: جایگزین کنید (دستورالعمل‌ها در کامنت‌های فایل موجود است).

کانتینر nginx قبل از پذیرش ترافیک منتظر می‌ماند تا بررسی سلامت اپلیکیشن موفق شود. این کار از خطاهای 502 در طول پنجره راه‌اندازی کوتاه هنگام اجرای migration جلوگیری می‌کند.

اختیاری: بررسی موفقیت‌آمیز بودن راه‌اندازی کانتینرها:

docker compose ps
docker compose logs -f

پیکربندی Nginx

کانتینر nginx با استفاده از گواهی‌نامه‌های موجود در پوشه certs/، HTTPS را روی پورت 443 ارائه می‌دهد. برای سفارشی‌سازی پیکربندی nginx، به صفحه پیکربندی Nginx مراجعه کنید. پس از ویرایش nginx/nginx.conf، کانتینر nginx را مجدداً راه‌اندازی کنید:

docker compose restart nginx

کاربر runtime و داده پایدار

استقرارهای Docker از songbird.service استفاده نمیکنند. Songbird با کاربر پیکربندی شده برای container اجرا میشود (در image فعلی root است، مگر آنکه user: در Compose آن را override کند) و دستورهای پایگاه داده با همان UID/GID ‏container اجرا میشوند:

docker compose exec songbird npm --prefix /app/server run db:inspect

برای اجرای container با یک UID/GID غیر root مشخص، user: را در service ‏Compose پیکربندی کنید:

services:
  songbird:
    user: "songbird:songbird"

اگر به جای named volume پیشفرض از bind mount استفاده میکنید، پیش از راه اندازی Songbird، پوشه host را برای همان UID:GID قابل نوشتن کنید. Songbird مالکیت bind mount روی host را به صورت خودکار تغییر نمیدهد:

mkdir -p ./data
sudo chown -R songbird:songbird ./data

کنترل سرویس در پنل مدیریت

اقدامات ریستارت سرویس و توقف سرویس در پنل مدیریت برای استقرار Docker با فراخوانی Docker Engine API از طریق سوکت mount‌شده (/var/run/docker.sock) کار می‌کنند. فایل compose متغیر SONGBIRD_CONTAINER_NAME=songbird را تنظیم می‌کند تا اپلیکیشن بداند کدام کانتینر را هدف قرار دهد.

اگر نام کانتینر را تغییر دادید یا از نام سفارشی استفاده می‌کنید، متغیر env را به‌روز کنید:

# docker-compose.yaml
environment:
  SONGBIRD_CONTAINER_NAME: my-custom-name

اگر به کنترل سرویس از پنل مدیریت نیاز ندارید، می‌توانید mount سوکت را از docker-compose.yaml حذف کنید:

# این خط را در بخش volumes مربوط به songbird حذف یا کامنت کنید:
# - /var/run/docker.sock:/var/run/docker.sock

به‌روزرسانی

ایمیج جدید را دریافت و مجدداً راه‌اندازی کنید:

cd /opt/songbird
docker compose pull
docker compose up -d

برای روش کامل به‌روزرسانی، صفحه به‌روزرسانی را ببینید.