immich Docker Compose (Geliştiriciler için Nasıl Çalışır)

Immich Docker, Immich'i Docker konteyneri içinde kendi kendine barındırılan bir fotoğraf ve video yedekleme çözümüdür. Docker, hem fiziksel hem de sanallaştırılmış sunucularla uygulamaların geliştirilmesi, dağıtılması ve çalıştırılması için hafif ve yaygın olarak benimsenmiş bir platformdur. Docker sayesinde, Immich karmaşık konfigürasyonlar ve bağımlılıkla ilgili sıkıntılar olmadan kolayca çoğu sistemde yüklenebilir ve çalışır hale gelir. Immich'i yönetmenin bu kapsayıcı yaklaşımı, kullanıcıların medya dosyalarını güvenli bir şekilde depolamasını, yedeklemesini ve yönetmesini daha kolay hale getirir.

Bunun yanı sıra, Docker farklı ortamlar arasında tutarlılık sağlar, bu nedenle kullanıcılar Immich örneğini kolayca taşıyabilir veya genişletebilir. Bu, Immich Docker'ın kendi medya yedekleme çözümünü kendi barındırmak isteyen herkes için en etkili ve sorunsuz yöntemleri sunacağı anlamına gelir.

Immich'in Özellikleri

Immich Docker, Immich fotoğraf ve video yedekleme çözümünün dağıtımını ve yönetimini çok daha kolay hale getiren birkaç özellik yükler. Bu, karşılığında, medya dosyalarını güvenli ve etkili bir şekilde kendi barındıracaklar için oldukça çekici hale getirir. Immich Docker'ın başlıca özelliklerinden bazıları şunlardır:

Kolay dağıtım: Standart Docker görüntüleri sağlamış olan Immich Docker, dağıtımı kolaylaştırır. Kullanıcıları bağımlı paketlerden ve karmaşık konfigürasyonlardan uzak tutar; böylece, kullanıcılar Immich'i hemen dağıtabilirler.

Çapraz platform: Her bir Docker konteyneri, cihazın Linux, macOS ve Windows OS üzerinde Docker ile çoğu sistemde çalıştırılabilmesini sağlar. Bu, projeyi farklı ortamlar arasında son derece taşınabilir hale getirir.

İzolasyon: Ayrıca, Docker konteynerinde çalışan Immich servisleri, ana makinedeki diğer uygulama ve servislerden izole edilecektir. Bu, çakışmaları, uyumluluk sorunlarını azaltacak ve Immich için işletim ortamını çok daha kararlı hale getirecektir.

Genel olarak, çok fazla medya verisi ile dağıtımlar yapıldığında ölçeklenebilirlik oldukça kolaydır, özellikle de Immich Docker kullanıcıları için. Docker doğal olarak ölçeklenebilir olduğundan, kaynakları artırmak veya genişletmek gerçekten oldukça kolay olabilir.

Güvenlik: Docker konteynerleri, alttaki sistemden uzakta bir kum havuzu katmanı oluşturarak ekstra güvenlik sağlar. Bunun yanı sıra, Immich kendi kendine barındırma, kullanıcıların verileri üzerinde tam kontrol sahibi olmalarını ve veritabanı depolama yerini sağlamaktadır, böylece gizlilik ve güvenliği artırır.

Otomatik Güncellemeler: Konteynerler nispeten hafif, güncellenmesi kolay ve bakım dostudur; Bu nedenle, Docker kullanıcıları en yeni güvenlik yamalarıyla yeni özelliklere çok az ya da hiç kesinti olmadan kolayca geçebilirler.

Yedekleme ve Geri Yükleme: Immich Docker, medya yedeklemesi söz konusu olduğunda doğru bir kaynak oluşturur, böylece fotoğrafları ve videoları geri yüklenebilir. Docker, tüm dağıtımların aynı veriye sahip olmasını sağlar.

Özelleştirilebilir: Immich kendi kendine barındırıldığı için, kullanıcılar kendi gereksinimlerine göre diğer hizmetlerle daha etkili entegrasyon ve ölçeklendirme seçenekleri için değiştirebilir.

Topluluk Desteği: Bu, açık kaynaklı bir projedir; bu nedenle, topluluk sürekli iyileştirmeler, hata düzeltmeleri ve kullanıcılara destek sağlar.

Immich Docker'ı Yükleyin

Önkoşullar

• Sisteminize Docker ve Docker Compose yükleyin.
• Makinenizin yeterli kaynağa sahip olduğundan emin olun: 4GB veya daha fazla RAM önerilir.

Immich Deposu'nu Klonlayın

Docker-compose dosyasını GitHub'dan indirin.

git clone https://github.com/immich-app/immich.git
cd immich

git clone https://github.com/immich-app/immich.git
cd immich

Ortam Değişkenlerini Yapılandırın

Bunu değiştirmek için örnek ortam dosyasının ve docker-compose.yml dosyalarının bir kopyasını oluşturun:

cp .env.example .env

cp .env.example .env

[.env dosyasını açın ve değişkenleri (örn. port, depolama konumu ve veritabanı kimlik bilgileri) ayarlayın.] Çoğu yapılandırmada varsayılan ayarlar yeterlidir.

# You can find documentation for all the supported env variables at https://immich.app/docs/install/environment-variables
# The location where your uploaded files are stored
UPLOAD_LOCATION=./library
# The location where your database files are stored
DB_DATA_LOCATION=./postgres
# To set a timezone, uncomment the next line and change Etc/UTC to a TZ identifier from this list: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List
# TZ=Etc/UTC
# The Immich version to use. You can pin this to a specific version like "v1.71.0"
IMMICH_VERSION=release
# Connection secret for postgres. You should change it to a random password
# Please use only the characters `A-Za-z0-9`, without special characters or spaces
DB_PASSWORD=postgres
# The values below this line do not need to be changed
###################################################################################
DB_USERNAME=postgres
DB_DATABASE_NAME=postgres

# You can find documentation for all the supported env variables at https://immich.app/docs/install/environment-variables
# The location where your uploaded files are stored
UPLOAD_LOCATION=./library
# The location where your database files are stored
DB_DATA_LOCATION=./postgres
# To set a timezone, uncomment the next line and change Etc/UTC to a TZ identifier from this list: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List
# TZ=Etc/UTC
# The Immich version to use. You can pin this to a specific version like "v1.71.0"
IMMICH_VERSION=release
# Connection secret for postgres. You should change it to a random password
# Please use only the characters `A-Za-z0-9`, without special characters or spaces
DB_PASSWORD=postgres
# The values below this line do not need to be changed
###################################################################################
DB_USERNAME=postgres
DB_DATABASE_NAME=postgres

Immich'i Başlatın

Immich sunucusunu başlatmak için Docker Compose'u kullanın:

docker-compose up -d

docker-compose up -d

Bu komut gerekli tüm görüntüleri çeker ve gerekli konteynerleri başlatır:

• Arka uç
• Ön uç
• Veritabanı (PostgreSQL)
• Redis (önbellekleme için)
• Makine Öğrenim modelleri (yüz tanıma gibi özellikler için)

Immich'e Tarayıcınızdan Erişim

Tüm dosyalar indirildiğinde, ortamı yenilediğinizden emin olun. Konteynerler çalışır durumda olduğunda, tarayıcıyı açın ve aşağıdaki URL'ye girin.

http://localhost:2283

http://localhost:2283

[.env dosyasındaki bağlantı noktasını değiştirdiyseniz, belirli olan bağlantı noktasını 2283 ile değiştirin.]

Immich hesabı oluşturun veya giriş yapın

İlk kullanım: Immich URL'sine ilk kez eriştiğinizde web UI'yi gösterecektir.

Yönetici hesabı oluşturmanız istenecektir.

Gerekli bilgileri doldurun ve Immich sizi kurulum sürecinde yönlendirecektir.

Immich'i Web Arayüzünde Kurun

• Ayarlar: Yöneticiler paneli aracılığıyla Immich'in detaylı ayarlarına erişin.
• Medya Yükle: Artık test amaçlı bazı fotoğraf/video yükleyin.
• Özellikleri Keşfedin: Yüz tanıma, nesne etiketleme gibi diğer özelliklerin tadını çıkarın.

Kurulum tamamlandıktan sonra Immich'e doğrudan tarayıcınızdan erişebileceksiniz ve fotoğraf ve video kütüphanenizi yönetmeye başlayabilirsiniz.

IronSecureDoc nedir?

IronSecureDoc, güçlü şifreleme, gelişmiş PDF işlemleri ve dijital imzalama ile belge yönetimi ve güvenliği için ileri düzey bir yardımcı programdır. Şirketlere ve geliştiricilere, belge gizliliği ve bütünlüğü sağlar; bu nedenle PDF belgelerinin işlenmesini basitleştirir. İçerdiği özellikler, geliştiricilerin programlı olarak PDF dosyalarını ve belgelerini oluşturmasına, yüklemesine, manipüle etmesine ve güvenlik altına almasına olanak tanıdığında, agresif bir PDF API olarak da adlandırılabilir.

Bunun dışında, IronPDF, herhangi bir veri girişinden PDF'ler oluşturulmasına olanak tanıyan bir PDF API'dir, metin, resim ve meta veriler gibi parametrelerle içerik ekleyip düzenlemeyi sağlar. Bu, birkaç PDF birleştirip dosyalar oluşturma, belgeleri bölme ve hatta açıklamalar, vurgulamalar veya filigranlar eklemenin tesisini içerir.

Güvenlik özellikleri arasında şifre koruması, AES şifrelemesi ve sertifika tabanlı erişim kontrolleri bulunur, bu da tüm hassas bilgi ve verileri güvence altına alır. Bunun yanı sıra, belgeleri doğrulamak ve inkâr edilemezlik sağlayan dijital imzalama, finansal, tıbbi ve hukuki gibi endüstrilerde çok önemli bir özelliktir. Denetim izi işlevselliği, belge üzerinde gerçekleştirilen tüm etkinlikleri takip etmesine olanak tanır, bu da daha iyi uyumluluk ve hesap verebilirlik sağlar.

IronSecureDoc Kurun ve Çalıştırın

IronSecureDoc'un Docker imajını aşağıdaki depodan Komut İsteminde veya açık bir terminal penceresinde bu komutu çalıştırarak çekin.

docker pull ironsoftwareofficial/ironsecuredoc

docker pull ironsoftwareofficial/ironsecuredoc

Çalışan bir konteyner olan IronSecureDoc'u başlatmak için başka bir komut kullanın.

docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> -e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latest

docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> -e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latest

Yukarıdaki Docker çalıştır komutu IronSecureDoc'un bir konteyner örneğini başlatacaktır.

Immich'ten İmzayı İndirin ve imzalı PDF belgesi ekleyin

IronSecureDoc'taki REST API, geliştiricilerin yazılımın belge yönetimi ve PDF işleme özellikleriyle güvenli bir şekilde etkileşim kurmasını sağlayan modern bir web arayüzüdür. RESTful prensiplerini kullanarak bu API, kullanıcıların IronSecureDoc'un işlevselliklerini teknoloji yığınından bağımsız olarak kendi uygulamalarına kolayca anlamasını ve standartlaştırmasını sağlar.

Immich'ten görüntüyü indirin

Aşağıda, Immich'e yüklenen örnek bir imza dosyası bulunmaktadır.

using System;
using System.Net.Http;
using System.Threading.Tasks;

class ImmichIntegration
{
    private static readonly HttpClient client = new HttpClient();

    public async Task<string> GetImageFromImmich(string imageId, string immichBaseUrl, string apiKey)
    {
        // Add authorization header
        client.DefaultRequestHeaders.Add("Authorization", $"Bearer {apiKey}");

        // Make a GET request to the Immich server
        var response = await client.GetAsync($"{immichBaseUrl}/api/media/{imageId}");
        response.EnsureSuccessStatusCode();

        // Read and return the response data
        var responseData = await response.Content.ReadAsStringAsync();
        Console.WriteLine("Image data retrieved successfully!");
        return responseData; // Contains image metadata or downloadable URL
    }
}

using System;
using System.Net.Http;
using System.Threading.Tasks;

class ImmichIntegration
{
    private static readonly HttpClient client = new HttpClient();

    public async Task<string> GetImageFromImmich(string imageId, string immichBaseUrl, string apiKey)
    {
        // Add authorization header
        client.DefaultRequestHeaders.Add("Authorization", $"Bearer {apiKey}");

        // Make a GET request to the Immich server
        var response = await client.GetAsync($"{immichBaseUrl}/api/media/{imageId}");
        response.EnsureSuccessStatusCode();

        // Read and return the response data
        var responseData = await response.Content.ReadAsStringAsync();
        Console.WriteLine("Image data retrieved successfully!");
        return responseData; // Contains image metadata or downloadable URL
    }
}

Imports System
Imports System.Net.Http
Imports System.Threading.Tasks

Friend Class ImmichIntegration
	Private Shared ReadOnly client As New HttpClient()

	Public Async Function GetImageFromImmich(ByVal imageId As String, ByVal immichBaseUrl As String, ByVal apiKey As String) As Task(Of String)
		' Add authorization header
		client.DefaultRequestHeaders.Add("Authorization", $"Bearer {apiKey}")

		' Make a GET request to the Immich server
		Dim response = Await client.GetAsync($"{immichBaseUrl}/api/media/{imageId}")
		response.EnsureSuccessStatusCode()

		' Read and return the response data
		Dim responseData = Await response.Content.ReadAsStringAsync()
		Console.WriteLine("Image data retrieved successfully!")
		Return responseData ' Contains image metadata or downloadable URL
	End Function
End Class

Imports System
Imports System.Net.Http
Imports System.Threading.Tasks

Friend Class ImmichIntegration
	Private Shared ReadOnly client As New HttpClient()

	Public Async Function GetImageFromImmich(ByVal imageId As String, ByVal immichBaseUrl As String, ByVal apiKey As String) As Task(Of String)
		' Add authorization header
		client.DefaultRequestHeaders.Add("Authorization", $"Bearer {apiKey}")

		' Make a GET request to the Immich server
		Dim response = Await client.GetAsync($"{immichBaseUrl}/api/media/{imageId}")
		response.EnsureSuccessStatusCode()

		' Read and return the response data
		Dim responseData = Await response.Content.ReadAsStringAsync()
		Console.WriteLine("Image data retrieved successfully!")
		Return responseData ' Contains image metadata or downloadable URL
	End Function
End Class

Kod, Immich sunucusundan görüntünün indirilmesine olanak tanır. Immich sunucusundan bir API anahtarı oluşturduğunuzdan emin olun.

IronSecureDoc'a Görüntü Yükleyin

using System.IO;
using System.Net.Http;
using System.Threading.Tasks;

class IronSecureDocIntegration
{
    private static readonly HttpClient client = new HttpClient();

    public async Task UploadImageTo IronSecureDoc(string imagePath)
    {
        var request = new HttpRequestMessage(HttpMethod.Post, "http://localhost:8080/v1/document-services/pdfs/sign?sign_specific_page=0&signature_image_x=100&signature_image_y=150&signature_image_w=300&signature_image_h=400&certificate_password=********&certificate_permissions=1");
        
        // Set headers to simulate a browser request
        request.Headers.Add("sec-ch-ua-platform", "\"Windows\"");
        request.Headers.Add("User-Agent", "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36");
        request.Headers.Add("accept", "*/*");
        request.Headers.Add("sec-ch-ua", "\"Google Chrome\";v=\"131\", \"Chromium\";v=\"131\", \"Not_A Brand\";v=\"24\"");
        request.Headers.Add("sec-ch-ua-mobile", "?0");
        request.Headers.Add("Sec-Fetch-Site", "same-origin");
        request.Headers.Add("Sec-Fetch-Mode", "cors");
        request.Headers.Add("Sec-Fetch-Dest", "empty");
        request.Headers.Add("host", "localhost");
        
        // Create and add image and certificate files to the request content
        var content = new MultipartFormDataContent();
        content.Add(new StreamContent(File.OpenRead(imagePath)), "signature_image_file", Path.GetFileName(imagePath));
        content.Add(new StreamContent(File.OpenRead("IronsecureDoc.pfx")), "certificate_file", "IronsecureDoc.pfx");
        content.Add(new StreamContent(File.OpenRead("Input.pdf")), "pdf_file", "Input.pdf");
        request.Content = content;

        // Send the request and ensure success
        var response = await client.SendAsync(request);
        response.EnsureSuccessStatusCode();

        // Output the result of the PDF signing
        Console.WriteLine(await response.Content.ReadAsStringAsync());
    }
}

using System.IO;
using System.Net.Http;
using System.Threading.Tasks;

class IronSecureDocIntegration
{
    private static readonly HttpClient client = new HttpClient();

    public async Task UploadImageTo IronSecureDoc(string imagePath)
    {
        var request = new HttpRequestMessage(HttpMethod.Post, "http://localhost:8080/v1/document-services/pdfs/sign?sign_specific_page=0&signature_image_x=100&signature_image_y=150&signature_image_w=300&signature_image_h=400&certificate_password=********&certificate_permissions=1");
        
        // Set headers to simulate a browser request
        request.Headers.Add("sec-ch-ua-platform", "\"Windows\"");
        request.Headers.Add("User-Agent", "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36");
        request.Headers.Add("accept", "*/*");
        request.Headers.Add("sec-ch-ua", "\"Google Chrome\";v=\"131\", \"Chromium\";v=\"131\", \"Not_A Brand\";v=\"24\"");
        request.Headers.Add("sec-ch-ua-mobile", "?0");
        request.Headers.Add("Sec-Fetch-Site", "same-origin");
        request.Headers.Add("Sec-Fetch-Mode", "cors");
        request.Headers.Add("Sec-Fetch-Dest", "empty");
        request.Headers.Add("host", "localhost");
        
        // Create and add image and certificate files to the request content
        var content = new MultipartFormDataContent();
        content.Add(new StreamContent(File.OpenRead(imagePath)), "signature_image_file", Path.GetFileName(imagePath));
        content.Add(new StreamContent(File.OpenRead("IronsecureDoc.pfx")), "certificate_file", "IronsecureDoc.pfx");
        content.Add(new StreamContent(File.OpenRead("Input.pdf")), "pdf_file", "Input.pdf");
        request.Content = content;

        // Send the request and ensure success
        var response = await client.SendAsync(request);
        response.EnsureSuccessStatusCode();

        // Output the result of the PDF signing
        Console.WriteLine(await response.Content.ReadAsStringAsync());
    }
}

Immich ve IronSecureDoc'u Çağırma

Aşağıdaki kod, entegrasyonumuza yardımcı olacak.

using System.Threading.Tasks;

class Integration
{
    public async Task IntegrateImmichWith IronSecureDoc(string immichImageId, string immichBaseUrl, string immichApiKey, string imagePath)
    {
        var immich = new ImmichIntegration();
        var ironSecureDoc = new IronSecureDocIntegration();

        // Step 1: Fetch image metadata or download from Immich
        string imageData = await immich.GetImageFromImmich(immichImageId, immichBaseUrl, immichApiKey);

        // Step 2: Optionally download the image locally using imageData URL (not shown here)
        // Assume imagePath is the downloaded image file path

        // Step 3: Upload the image to IronSecureDoc
        await ironSecureDoc.UploadImageTo IronSecureDoc(imagePath);
    }
}

using System.Threading.Tasks;

class Integration
{
    public async Task IntegrateImmichWith IronSecureDoc(string immichImageId, string immichBaseUrl, string immichApiKey, string imagePath)
    {
        var immich = new ImmichIntegration();
        var ironSecureDoc = new IronSecureDocIntegration();

        // Step 1: Fetch image metadata or download from Immich
        string imageData = await immich.GetImageFromImmich(immichImageId, immichBaseUrl, immichApiKey);

        // Step 2: Optionally download the image locally using imageData URL (not shown here)
        // Assume imagePath is the downloaded image file path

        // Step 3: Upload the image to IronSecureDoc
        await ironSecureDoc.UploadImageTo IronSecureDoc(imagePath);
    }
}

Fotoğraf eklemek ve dijital imzalar uygulamak için IronSecureDoc'un API'sini kullanın. Belgeleri tamamlamak için gerekli API çağrısını IronSecureDocIntegration sınıfına ekleyin. Aşağıda, imza eklendikten sonra IronSecureDoc tarafından üretilen örnek PDF bulunmaktadır.

Sonuç

Hem Immich hem de IronSecureDoc belirli ihtiyaçlara etkili bir şekilde yanıt verirken, en iyi farklı kullanım durumlarına hizmet ederler. Immich, yüz tanıma, nesne algılama ve multimedya dosyalarının akıcı bir şekilde düzenlenmesi gibi kendi kendine barındırılan, zengin özellikli fotoğraf ve video yönetimi konusunda başarılıdır. Kişisel veya küçük ölçekli medya depolama lokasyonu yönetimi için, ihtiyaçlara tam olarak uyacak bir çözüm arandığında idealdir.

IronSecureDoc, organizasyon çapında güvenli bir belge ve imzalama çözümüdür ve gelişmiş şifrelemenin harika faydalarını, entegrasyonla gelen basitlik ile birleştirerek güvenlik, ölçeklenebilirlik ve profesyonel düzeyde belge işleme sağlamayı amaçlar.

Güvenilir ve Uyumlu: Tam denetim yetenekleri ve güçlü güvenlik sunduğundan, güvenilir ve uyumludur. IronSecureDoc REST API'sini kullanarak, web, mobil ve kurumsal sistem geliştiricileri, güvenli yazdırma ve verimli PDF formatı ve işleme işlemlerini uygulamalarına kolayca entegre edebilirler. IronSecureDoc lisanslaması hakkında daha fazla bilgi edinmek için lisanslama sayfasını kontrol edin. Iron Software'in sunduğu çözümler hakkında daha fazla bilgi almak için Iron Suite sayfasını ziyaret edin.