معرفی Immich
Immich که جایگزین متنباز Google Photos است، عکسها و ویدیوهای گوشیهای شما را بهطور خودکار روی سروری که خودتان کنترل میکنید بکاپ میگیرد. این برنامه خط زمانی، آلبومهای اشتراکی، جستوجو بر اساس محتوا، تشخیص چهره و نقشهای از مکانهای عکاسی ارائه میدهد. کاربران آن افرادی هستند که میخواهند خاطراتشان را از یک ابر آمریکایی بیرون بیاورند، و همچنین خانوادهها، تیمهای کوچک و عکاسانی که یک کتابخانه متمرکز میخواهند.
هنگام تحویل، اسکریپت cloud-init، Docker Engine و افزونه Compose را از مخزن رسمی Docker نصب کرده، سپس فایل docker-compose.yml و نمونه .env آخرین نسخه Immich را در /opt/immich دانلود کرده است. یک رمز عبور تصادفی برای پایگاه داده ساخته شده و کانتینرها اجرا شدهاند. رابط وب روی پورت 2283 در دسترس است.
هیچ حساب مدیری از پیش ساخته نمیشود: اولین کاربری که ثبتنام کند مدیر میشود. اطلاعات لازم (URL، مسیرها، رمز عبور پایگاه داده) در /tmp/credentials.txt است که فقط root میتواند آن را بخواند.
با Immich چه کارهایی میتوانید انجام دهید
بکاپ خودکار از موبایل
اپلیکیشنهای iOS و Android عکسها و ویدیوها را در پسزمینه به سرور شما میفرستند. شما آلبومهایی را که باید همگام شوند انتخاب میکنید.
جستوجوی هوشمند و چهرهها
Immich محتوای تصاویر را فهرست میکند تا بتوانید عکسی را با توصیف آن پیدا کنید، و چهرهها را بر اساس فرد گروهبندی میکند. این پردازشها روی سرور شما انجام میشود، نه نزد شخص ثالث.
آلبوم و اشتراکگذاری تحت کنترل
آلبومهای اشتراکی با کاربران دیگر یا لینکهای عمومی بسازید. هر عضو خانواده حساب کاربری و کتابخانه مخصوص خودش را دارد.
استک رسمی با Docker Compose
نصب از فایلهایی استفاده میکند که همراه آخرین نسخه Immich منتشر شدهاند و در
/opt/immichقرار دارند. بهروزرسانی با دو دستور Compose انجام میشود.دادهها در پوشههای ساده
کتابخانه در
/opt/immich/libraryو پایگاه داده PostgreSQL در/opt/immich/postgresذخیره میشود. بکاپگیری یا انتقال یعنی کپیکردن دو پوشه.حساب مدیر اول، امن
هیچ نام کاربری پیشفرضی ساخته نمیشود. اولین کاربر ثبتنامشده مدیر میشود و از وجود حسابی که همه میشناسند روی یک سرور در معرض اینترنت جلوگیری میشود.
شروع کار با Immich
از سفارش تا راهاندازی نهایی، در چند دقیقه.
- 1
VPS را همراه با Immich سفارش دهید
یک VPS لینوکس (Debian 12 یا 13، Ubuntu 22.04 یا 24.04) در پاریس یا فرانکفورت انتخاب کنید، سپس در تب Applications فرم سفارش، Immich را تیک بزنید. برای کتابخانهتان دیسک کافی در نظر بگیرید و برای جستوجوی هوشمند دستکم 6 GB رم داشته باشید.
- 2
وارد شوید و اطلاعات را بردارید
پس از تحویل سرور، با SSH وارد شوید. نصب، ایمیجهای Docker را دانلود میکند و ممکن است چند دقیقه طول بکشد؛ آن را در گزارش دنبال کنید، سپس فایل اطلاعات را بخوانید و در مدیر رمز عبور خود کپی کنید، چون در /tmp است.
Bashssh USER@SERVER_IP tail -n 20 /var/log/immich-auto-install.log sudo cat /tmp/credentials.txt - 3
حساب مدیر را بسازید
آدرس http://SERVER_IP:2283 را در مرورگر باز کنید و راهنمای خوشامدگویی را اجرا کنید. اولین کاربر ثبتنامشده دسترسی مدیر میگیرد. سپس اپلیکیشن موبایل را نصب کنید و برای فعالسازی بکاپ، URL سرور را وارد کنید.
- 4
پیش از استفاده واقعی، امنسازی کنید
یک رکورد DNS از نوع A برای YOUR_DOMAIN به SERVER_IP بسازید، یک reverse proxy با HTTPS جلوی پورت 2283 قرار دهید و پورتهای باز را محدود کنید. یک بکاپ منظم از /opt/immich/library و /opt/immich/postgres هم در نظر بگیرید.
Bashsudo ufw allow OpenSSH sudo ufw allow 80,443/tcp sudo ufw enable
کاربردهای Immich
جایگزینی Google Photos یا iCloud
کتابخانه موجودتان را وارد میکنید و بکاپ خودکار را روی گوشیها فعال میکنید. عکسهایتان روی سروری در اروپا، در پاریس یا فرانکفورت، میماند.
آلبوم عکس خانوادگی مشترک
هر یک از نزدیکان حساب، آلبومها و بکاپ موبایل خودش را دارد. آلبومهای مشترک عکسهای تعطیلات را بدون نیاز به پیامرسان کنار هم جمع میکنند.
آرشیو برای عکاسان آماتور
خروجیهای دوربینتان را در یک خط زمانی واحد و قابل مرور متمرکز میکنید. جستوجو و دستهبندی بر اساس افراد یا مکانها، یک عکس را در چند ثانیه پیدا میکند.
محیط آزمایشی برای خودمیزبانی
پیش از انتقال یک کتابخانه بزرگ، Immich را ارزیابی میکنید، یا کار با یک استک Docker Compose همراه PostgreSQL را یاد میگیرید. سرور یکبارمصرف و قابل بازتولید است.
پرسشهای متداول درباره Immich
مستندات Immich دستکم 6 GB رم و 2 هسته را توصیه میکند و 4 هسته بهتر است. جستوجوی هوشمند و تشخیص چهره منابع زیادی مصرف میکنند، بهویژه هنگام واردکردن اولیه یک کتابخانه بزرگ. دیسک را هم بر اساس حجم عکسها و ویدیوهایتان انتخاب کنید.
درباره Immich بیشتر بدانید
آنچه روی سرور نصب شده است
همه چیز در /opt/immich است: docker-compose.yml، فایل .env (با دسترسی 600، شامل رمز عبور پایگاه داده)، پوشه library برای عکسها و postgres برای دادههای پایگاه داده. گزارش نصب در /var/log/immich-auto-install.log است.
دستورهای Compose را از همین پوشه اجرا کنید:
Bashcd /opt/immich docker compose ps docker compose logs -f immich-server
فعالسازی HTTPS با reverse proxy
سرویس روی پورت 2283 با HTTP ساده پاسخ میدهد. پیش از اتصال گوشیهایتان از بیرون، آن را پشت یک reverse proxy (Caddy، Nginx یا Traefik) قرار دهید که برای YOUR_DOMAIN گواهی دریافت کند. با Caddy، پیکربندی در چند خط جا میشود:
YOUR_DOMAIN {
reverse_proxy 127.0.0.1:2283
}
با Nginx حتماً client_max_body_size را بالا ببرید، وگرنه آپلود ویدیوهای حجیم با شکست روبهرو میشود.
نکته دیگر: Docker پورتها را با دور زدن قوانین UFW منتشر میکند. برای اینکه پس از راهاندازی پروکسی، پورت 2283 دیگر مستقیم در دسترس نباشد، خط ports سرویس immich-server را در docker-compose.yml طوری تغییر دهید که روی 127.0.0.1:2283 گوش دهد، سپس با docker compose up -d دوباره اجرا کنید.
بکاپها
باید هم کتابخانه و هم پایگاه داده را بکاپ بگیرید: یکی بدون دیگری بازیابی درست را ممکن نمیکند. سادهترین روش این است که کانتینرها را متوقف کنید، دو پوشه را روی یک فضای ذخیرهسازی خارجی کپی کنید و دوباره راهاندازی کنید.
Bashcd /opt/immich docker compose stop tar -czf /root/immich-backup.tar.gz library postgres .env docker compose start
برای یک کتابخانه بزرگ، rsync به یک ماشین دیگر را ترجیح دهید و دستکم یک بار بازیابی را آزمایش کنید. بکاپی که روی همان دیسک سرور باشد، شما را در برابر خرابی دیسک محافظت نمیکند.
بهروزرسانیها
فایلهای دانلودشده با نسخهای که هنگام تحویل منتشر شده بود مطابقت دارند. برای رفتن به نسخه جدیدتر، ابتدا یادداشتهای انتشار پروژه را بخوانید، چون Immich سریع پیشرفت میکند و برخی نسخهها به اقدام دستی نیاز دارند. سپس:
Bashcd /opt/immich docker compose pull docker compose up -d
پیش از هر بهروزرسانی major بکاپ بگیرید. برای آموزشهای بیشتر درباره مدیریت VPS به بخش Learn سر بزنید؛ پلنها در صفحه VPS لینوکس شرح داده شدهاند.
