immich Docker Compose (Jak to działa dla programistów)

Immich Docker to konfiguracja Immich, otwartego oprogramowania do samodzielnego hostowania kopii zapasowych zdjęć i filmów w kontenerze Docker. Docker to lekka i powszechnie stosowana platforma do tworzenia, dystrybucji i uruchamiania aplikacji zarówno na serwerach fizycznych, jak i wirtualnych. Dzięki Dockerowi Immich można łatwo zainstalować na większości systemów i uruchomić bez skomplikowanej konfiguracji i problemów związanych z zależnościami. To kontenerowe podejście do zarządzania Immich ułatwia użytkownikom bezpieczne przechowywanie, tworzenie kopii zapasowych i zarządzanie plikami multimedialnymi.

Ponadto Docker zapewnia spójność w różnych środowiskach, dzięki czemu użytkownicy mogą łatwo przenosić lub skalować swoją instancję Immich przy minimalnym wysiłku. Oznacza to, że Immich Docker przedstawiłby najbardziej wydajne i płynne sposoby, jakie każdy, kto chciałby samodzielnie hostować swoje rozwiązanie do tworzenia kopii zapasowych multimediów, mógłby zastosować przy użyciu Docker.

Funkcje Immich

Immich Docker instaluje kilka gotowych funkcji, które znacznie ułatwiają wdrażanie i zarządzanie rozwiązaniem Immich do tworzenia kopii zapasowych zdjęć i filmów. To z kolei sprawia, że jest to dość atrakcyjne rozwiązanie dla tych, którzy chcą samodzielnie hostować swoje pliki multimedialne w bezpieczny i efektywny sposób. Wśród głównych funkcji Immich Docker znajdują się:

Łatwe wdrożenie: Immich Docker udostępnił standardowe obrazy Docker, co ułatwia wdrożenie. Ponadto pozwala to uniknąć zależności od dodatkowych pakietów i skomplikowanych konfiguracji; dzięki czemu użytkownicy mogą od razu wdrożyć Immich.

Wielopłatformowość: Każdy kontener Docker zapewnia, że urządzenie może działać na większości systemów z Dockerem w systemach operacyjnych Linux, macOS i Windows. Dzięki temu projekt jest wysoce przenośny w różnych środowiskach.

Izolacja: Ponadto usługi Immich działające w kontenerze Docker byłyby odizolowane od innych aplikacji i usług na komputerze hosta. Zmniejszyłoby to liczbę konfliktów i problemów z kompatybilnością, a także zdecydowanie zwiększyłoby stabilność środowiska operacyjnego dla Immich.

Ogólnie rzecz biorąc, skalowalność jest bardzo łatwa, zwłaszcza gdy wdrożenie dla użytkowników Immich Docker wiąże się z dużymi ilościami danych multimedialnych. Ponieważ Docker jest z natury skalowalny, aktualizacja lub zwiększenie zasobów może być naprawdę dość łatwe.

Bezpieczeństwo: Powodem jest to, że kontenery Docker wprowadzają warstwę izolacji od systemu bazowego, zapewniając dodatkowe bezpieczeństwo. Poza tym Immich self-hosting oferuje użytkownikom pełną kontrolę nad ich danymi oraz lokalizacją przechowywania bazy danych, co zwiększa prywatność i bezpieczeństwo.

Automatyczne aktualizacje: Kontenery są stosunkowo lekkie, łatwe do aktualizacji i przyjazne w utrzymaniu; Dzięki temu użytkownicy Docker mogą łatwo przejść na nowsze funkcje z najnowszymi poprawkami bezpieczeństwa, przy minimalnych lub żadnych zakłóceniach.

Tworzenie kopii zapasowych i przywracanie: Immich Docker tworzy jedno wiarygodne źródło informacji w zakresie tworzenia kopii zapasowych multimediów, dzięki czemu można przywrócić zdjęcia i filmy. Docker zapewnia, że wszystkie wdrożenia zawierają te same dane.

Możliwość dostosowania: Immich jest hostowany samodzielnie, więc użytkownicy mogą go modyfikować zgodnie ze swoimi wymaganiami w celu skuteczniejszej integracji z innymi usługami i opcjami skalowania.

Wsparcie społeczności: Jest to projekt typu open source; Dlatego społeczność zapewnia ciągłe ulepszenia, naprawianie błędów i wsparcie dla swoich użytkowników.

Zainstaluj Immich Docker

Wymagania wstępne

• Zainstaluj Docker i Docker Compose w swoim systemie.
• Upewnij się, że Twój komputer ma wystarczające zasoby: zalecane jest co najmniej 4 GB pamięci RAM.

Sklonuj repozytorium Immich

Pobierz plik docker-compose z serwisu GitHub.

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

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

Konfiguracja zmiennych środowiskowych

Aby to zmienić, utwórz kopię przykładowego pliku środowiska oraz plików docker-compose.yml:

cp .env.example .env

cp .env.example .env

Otworz plik .env i skonfiguruj zmienne (takie jak port, lokalizacja przechowywania i dane uwierzytelniajace do bazy danych). W większości konfiguracji wystarczające są ustawienia domyślne.

# 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

Uruchom Immich

Użyj Docker Compose, aby uruchomić serwer Immich:

docker-compose up -d

docker-compose up -d

To polecenie pobiera wszystkie wymagane obrazy i uruchamia niezbędne kontenery:

• Backend
• Frontend
• Baza danych (PostgreSQL)
• Redis (do buforowania)
• Modele uczenia maszynowego (do funkcji takich jak rozpoznawanie twarzy)

Uzyskaj dostęp do Immich w przeglądarce

Po pobraniu wszystkich plików należy odświeżyć Środowisko. Gdy kontenery będą już działać, otwórz przeglądarkę i wpisz poniższy adres URL.

http://localhost:2283

http://localhost:2283

Zamien 2283 na okreslony port, jesli zmieniles port w pliku .env.

Załóż konto Immich lub zaloguj się

Pierwsze użycie: po pierwszym wejściu na adres URL Immich wyświetli się interfejs użytkownika.

Zostaniesz poproszony o utworzenie konta administratora.

Wprowadź wymagane informacje, a Immich przeprowadzi Cię przez proces konfiguracji.

Skonfiguruj Immich w interfejsie internetowym

• Ustawienia: Dostęp do szczegółowych ustawień Immich można uzyskać za pośrednictwem panelu administracyjnego.
• Prześlij multimedia: Prześlij teraz kilka zdjęć/filmów do przetestowania.
• Poznaj funkcje: Korzystaj z innych funkcji, takich jak wykrywanie twarzy, oznaczanie obiektów i wiele innych.

Po skonfigurowaniu będziesz mógł uzyskać dostęp do Immich bezpośrednio z przeglądarki i rozpocząć zarządzanie swoją biblioteką zdjęć i filmów.

Czym jest IronSecureDoc?

IronSecureDoc to zaawansowane narzędzie do zarządzania dokumentami i zapewniania ich bezpieczeństwa, oferujące solidne szyfrowanie, zaawansowaną edycję plików PDF oraz podpisywanie cyfrowe. Zapewnia firmom i programistom poufność i integralność dokumentów, a także płynny dostęp, co w konsekwencji upraszcza przetwarzanie dokumentów PDF. Można ją również nazwać agresywnym API PDF w przypadkach, gdy jej funkcje pozwalają programistom programowo tworzyć, przesyłać, modyfikować i zabezpieczać pliki i dokumenty PDF.

Poza tym IronPDF to API PDF umożliwiające tworzenie plików PDF na podstawie dowolnych danych wejściowych, dodawanie i edycję treści przy użyciu parametrów takich jak tekst, obrazy i metadane. Obejmuje to możliwość łączenia kilku plików PDF w jeden, dzielenia dokumentów, a nawet dodawania komentarzy, zaznaczeń lub znaków wodnych.

Wśród funkcji bezpieczeństwa znajdują się ochrona hasłem, szyfrowanie AES oraz kontrola dostępu oparta na certyfikatach, które zabezpieczają wszystkie poufne informacje i dane. Poza tym umożliwia podpisywanie cyfrowe w celu uwierzytelniania dokumentów i zapewnienia nieodwołalności, co jest bardzo ważną funkcją w branżach takich jak finansowa, medyczna i prawna. Funkcja ścieżki audytu pozwala śledzić wszystkie czynności wykonywane na dokumentach, co zapewnia lepszą zgodność z przepisami i rozliczalność.

Zainstaluj i uruchom IronSecureDoc

Pobierz obraz Docker IronSecureDoc z poniższego repozytorium, uruchamiając to polecenie w wierszu poleceń lub otwartym oknie terminala.

docker pull ironsoftwareofficial/ironsecuredoc

docker pull ironsoftwareofficial/ironsecuredoc

Użyj innego polecenia, aby uruchomić IronSecureDoc, kontener operacyjny.

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

Powyższe polecenie Docker run uruchomi instancję kontenera IronSecureDoc.

Pobierz podpis od Immich i dodaj podpisany dokument PDF

Interfejs API REST w IronSecureDoc to nowoczesny interfejs internetowy, który umożliwia programistom bezpieczną interakcję z funkcjami oprogramowania do zarządzania dokumentami i przetwarzania plików PDF. Wykorzystując zasady RESTful, ten interfejs API pozwala użytkownikom łatwo zrozumieć i ujednolicić integrację funkcji IronSecureDoc z ich niestandardowymi aplikacjami, niezależnie od używanego stosu technologicznego.

Pobierz obrazek z Immich

Poniżej znajduje się przykładowy plik podpisu, który jest przesyłany do Immich.

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 pozwala nam pobrać obraz z serwera Immich. Pamiętaj, aby wygenerować klucz API z serwera Immich.

Prześlij obraz do IronSecureDoc

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());
    }
}

Wywołanie Immich i IronSecureDoc

Poniższy kod pomoże nam to zintegrować.

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);
    }
}

Użyj API IronSecureDoc, aby dołączać zdjęcia i stosować podpisy cyfrowe. Dodaj konieczne wywolanie API w klasie IronSecureDocIntegration, aby uzupelnic dokument. Poniżej znajduje się przykładowy plik PDF wygenerowany przez IronSecureDoc po dodaniu podpisu.

Wnioski

Chociaż zarówno Immich, jak i IronSecureDoc świetnie radzą sobie z konkretnymi potrzebami, najlepiej sprawdzają się w różnych sytuacjach. Immich dobrze radzi sobie z samodzielnym hostowaniem oraz bogatym w funkcje zarządzaniem zdjęciami i filmami, takimi jak rozpoznawanie twarzy, wykrywanie obiektów i usprawniona organizacja plików multimedialnych. Jest to idealne rozwiązanie do zarządzania lokalizacjami przechowywania multimediów na potrzeby osobiste lub w małej skali, gdzie potrzebne jest rozwiązanie dokładnie dostosowane do indywidualnych potrzeb.

IronSecureDoc to rozwiązanie do bezpiecznego podpisywania dokumentów w całej organizacji, które łączy fantastyczne zalety zaawansowanego szyfrowania z prostotą integracji przepływu pracy, umożliwiając połączenie bezpieczeństwa, skalowalności i profesjonalnej obsługi dokumentów.

Niezawodność i zgodność z normami: Ponieważ oferuje pełne możliwości audytowe przy zachowaniu wysokiego poziomu bezpieczeństwa, jest niezawodny i zgodny z normami. Korzystając z interfejsu API REST IronSecureDoc, programiści systemów internetowych, mobilnych i korporacyjnych mogą teraz łatwo zintegrować bezpieczne drukowanie oraz wydajną obsługę formatu PDF ze swoimi aplikacjami. Aby dowiedzieć się więcej o licencjonowaniu IronSecureDoc, sprawdź stronę poświęconą licencjom. Aby dowiedzieć się więcej o ofercie Iron Software, odwiedź stronę Iron Suite.