1. IronOCR
  2. 시작하기
  3. Docker 설정 가이드

Docker 컨테이너에서 IronOCR 설정하기

커티스 차우
커티스 차우
업데이트됨:
This article was translated from English: Does it need improvement?
Translated
View the article in English

C#에서 이미지 또는 PDF 파일을 OCR 하기를 원하십니까?

IronOCR는 이제 리눅스 및 윈도우를 위한 Azure Docker 컨테이너를 포함하여 Docker를 완전히 지원합니다.

Docker Linux AWS Windows

왜 Docker를 사용해야 하나요?

Docker는 개발자가 가볍고, 포터블하며, 자급자족 가능한 컨테이너로 쉽게 패키징하고, 발송하고, 실행할 수 있게 해주어 사실상 어디서나 작동할 수 있습니다.

IronOCR과 Linux 기초

.NET이 포함된 Docker가 처음이라면 Visual Studio 프로젝트와의 Docker 디버깅 및 통합 설정에 관한 이 훌륭한 기사를 추천합니다. https://docs.microsoft.com/en-us/visualstudio/containers/edit-and-refresh?view=vs-2019

IronOCR 리눅스 설치 및 호환성 가이드도 꼭 읽어보시길 강력히 추천합니다.

추천 리눅스 Docker 배포판

IronPDF의 "간편한 구성"을 위해 최신 64비트 리눅스 OS를 아래와 같이 추천합니다.

  • 우분투 20
  • 우분투 18
  • 데비안 11
  • Debian 10 [현재 Microsoft Azure 기본 리눅스 배포판]

Microsoft의 공식 Docker 이미지를 사용하는 것을 추천합니다. 다른 Linux 배포판도 부분적으로 지원되지만, apt-get를 사용하여 수동으로 구성해야 할 수 있습니다. "리눅스 수동 설정" 가이드를 참조하십시오.

Ubuntu 및 Debian을 위한 작동하는 Docker 파일들이 이 문서에 포함되어 있습니다:

IronOCR 리눅스 Docker 설치 필수 사항

NuGet 패키지 사용

IronOcr NuGet 패키지 사용을 추천합니다. 이것은 Windows, macOS, 리눅스에서 개발할 때 작동합니다.

Install-Package IronOcr

Ubuntu 리눅스 DockerFiles

Docker Linux Ubuntu

.NET 5가 포함된 Ubuntu 20

# Use the base runtime image for Ubuntu 20 with .NET runtime
FROM mcr.microsoft.com/dotnet/runtime:5.0-focal AS base
WORKDIR /app

# Install necessary packages
RUN apt-get update && apt-get install -y apt-utils libgdiplus libc6-dev

# Use the base development image for Ubuntu 20 with .NET SDK
FROM mcr.microsoft.com/dotnet/sdk:5.0-focal AS build
WORKDIR /src

# Restore NuGet packages
COPY ["Example/Example.csproj", "Example/"]
RUN dotnet restore "Example/Example.csproj"

# Build the project
COPY . .
WORKDIR "/src/Example"
RUN dotnet build "Example.csproj" -c Release -o /app/build

# Publish the project
FROM build AS publish
RUN dotnet publish "Example.csproj" -c Release -o /app/publish

# Run the application
FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "Example.dll"]

.NET 3.1 LTS가 포함된 Ubuntu 20

# Use the base runtime image for Ubuntu 20 with .NET runtime
FROM mcr.microsoft.com/dotnet/runtime:3.1-focal AS base
WORKDIR /app

# Install necessary packages
RUN apt-get update && apt-get install -y apt-utils libgdiplus libc6-dev

# Use the base development image for Ubuntu 20 with .NET SDK
FROM mcr.microsoft.com/dotnet/sdk:3.1-focal AS build
WORKDIR /src

# Restore NuGet packages
COPY ["Example/Example.csproj", "Example/"]
RUN dotnet restore "Example/Example.csproj"

# Build the project
COPY . .
WORKDIR "/src/Example"
RUN dotnet build "Example.csproj" -c Release -o /app/build

# Publish the project
FROM build AS publish
RUN dotnet publish "Example.csproj" -c Release -o /app/publish

# Run the application
FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "Example.dll"]

.NET 3.1 LTS가 포함된 Ubuntu 18

# Use the base runtime image for Ubuntu 18 with .NET runtime
FROM mcr.microsoft.com/dotnet/runtime:3.1-bionic AS base
WORKDIR /app

# Install necessary packages
RUN apt-get update && apt-get install -y apt-utils libgdiplus libc6-dev

# Use the base development image for Ubuntu 18 with .NET SDK
FROM mcr.microsoft.com/dotnet/sdk:3.1-bionic AS build
WORKDIR /src

# Restore NuGet packages
COPY ["Example/Example.csproj", "Example/"]
RUN dotnet restore "Example/Example.csproj"

# Build the project
COPY . .
WORKDIR "/src/Example"
RUN dotnet build "Example.csproj" -c Release -o /app/build

# Publish the project
FROM build AS publish
RUN dotnet publish "Example.csproj" -c Release -o /app/publish

# Run the application
FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "Example.dll"]

Debian 리눅스 DockerFiles

Docker Linux Debian

.NET 5가 포함된 Debian 11

# Use the base runtime image for Debian 10 with .NET runtime
FROM mcr.microsoft.com/dotnet/aspnet:5.0-bullseye-slim AS base
WORKDIR /app

# Install necessary packages
RUN apt-get update && apt-get install -y apt-utils libgdiplus libc6-dev

# Use the base development image for Debian 10 with .NET SDK
FROM mcr.microsoft.com/dotnet/sdk:5.0-bullseye-slim AS build
WORKDIR /src

# Restore NuGet packages
COPY ["Example/Example.csproj", "Example/"]
RUN dotnet restore "Example/Example.csproj"

# Build the project
COPY . .
WORKDIR "/src/Example"
RUN dotnet build "Example.csproj" -c Release -o /app/build

# Publish the project
FROM build AS publish
RUN dotnet publish "Example.csproj" -c Release -o /app/publish

# Run the application
FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "Example.dll"]

.NET 3.1 LTS가 포함된 Debian 11

# Use the base runtime image for Debian 10 with .NET runtime
FROM mcr.microsoft.com/dotnet/aspnet:3.1-bullseye-slim AS base
WORKDIR /app

# Install necessary packages
RUN apt-get update && apt-get install -y apt-utils libgdiplus libc6-dev

# Use the base development image for Debian 10 with .NET SDK
FROM mcr.microsoft.com/dotnet/sdk:3.1-bullseye-slim AS build
WORKDIR /src

# Restore NuGet packages
COPY ["Example/Example.csproj", "Example/"]
RUN dotnet restore "Example/Example.csproj"

# Build the project
COPY . .
WORKDIR "/src/Example"
RUN dotnet build "Example.csproj" -c Release -o /app/build

# Publish the project
FROM build AS publish
RUN dotnet publish "Example.csproj" -c Release -o /app/publish

# Run the application
FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "Example.dll"]

.NET 5가 포함된 Debian 10

# Use the base runtime image for Debian 10 with .NET runtime
FROM mcr.microsoft.com/dotnet/runtime:5.0 AS base
WORKDIR /app

# Install necessary packages
RUN apt-get update && apt-get install -y apt-utils libgdiplus libc6-dev

# Use the base development image for Debian 10 with .NET SDK
FROM mcr.microsoft.com/dotnet/sdk:5.0 AS build
WORKDIR /src

# Restore NuGet packages
COPY ["Example/Example.csproj", "Example/"]
RUN dotnet restore "Example/Example.csproj"

# Build the project
COPY . .
WORKDIR "/src/Example"
RUN dotnet build "Example.csproj" -c Release -o /app/build

# Publish the project
FROM build AS publish
RUN dotnet publish "Example.csproj" -c Release -o /app/publish

# Run the application
FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "Example.dll"]

.NET 3.1 LTS가 포함된 Debian 10

# Use the base runtime image for Debian 10 with .NET runtime
FROM mcr.microsoft.com/dotnet/runtime:3.1 AS base
WORKDIR /app

# Install necessary packages
RUN apt-get update && apt-get install -y apt-utils libgdiplus libc6-dev

# Use the base development image for Debian 10 with .NET SDK
FROM mcr.microsoft.com/dotnet/sdk:3.1 AS build
WORKDIR /src

# Restore NuGet packages
COPY ["Example/Example.csproj", "Example/"]
RUN dotnet restore "Example/Example.csproj"

# Build the project
COPY . .
WORKDIR "/src/Example"
RUN dotnet build "Example.csproj" -c Release -o /app/build

# Publish the project
FROM build AS publish
RUN dotnet publish "Example.csproj" -c Release -o /app/publish

# Run the application
FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "Example.dll"]

자주 묻는 질문

C# OCR 애플리케이션을 Docker 컨테이너에 배포하려면 어떻게 해야 하나요?

Docker와 통합된 C# OCR 라이브러리인 IronOCR을 사용하면 C# OCR 애플리케이션을 Docker 컨테이너에 배포할 수 있습니다. Docker 컨테이너를 설정하려면 apt-utils , libgdiplus , libc6-dev 와 같은 필수 패키지를 설치해야 하며, 최적의 성능을 위해 Microsoft의 공식 Docker 이미지를 사용하는 것이 좋습니다.

Docker에서 IronOCR을 실행하는 데 가장 적합한 운영 체제는 무엇입니까?

Docker에서 IronOCR을 실행하려면 Ubuntu 20, Ubuntu 18, Debian 11, Debian 10과 같은 최신 64비트 Linux 배포판을 사용하는 것이 좋습니다. 이러한 배포판은 구성이 쉽고 지원도 잘 됩니다.

Azure Docker 컨테이너에서 IronOCR을 구성하는 방법은 무엇인가요?

Azure Docker 컨테이너에서 IronOCR을 구성하려면 다른 Docker 환경과 동일한 단계를 따르면 됩니다. IronOCR NuGet 패키지를 사용하고, 권장되는 Linux 배포판을 설정하고, 필요한 모든 종속성이 Dockerfile에 포함되어 있는지 확인하십시오.

Docker 환경에서 .NET 5를 사용하여 IronOCR을 설정하는 단계는 무엇인가요?

Docker에서 .NET 5를 사용하여 IronOCR을 설정하려면 IronOcr NuGet 패키지를 설치하고, apt-utils 및 libgdiplus 와 같은 필수 패키지를 추가하고, Microsoft의 공식 .NET 5 Docker 이미지를 기본 이미지로 사용하는 Dockerfile을 생성해야 합니다.

IronOCR은 Windows의 Docker 환경에서 사용할 수 있습니까?

네, IronOCR은 Windows의 Docker 환경에서 사용할 수 있습니다. 이를 위해서는 IronOCR NuGet 패키지를 설치하고 Dockerfile에 필요한 종속성 및 Windows 운영 체제에 특화된 설정을 포함시켜야 합니다.

.NET OCR 애플리케이션 호스팅에 Docker를 사용하면 어떤 이점이 있습니까?

Docker를 사용하여 .NET OCR 애플리케이션을 호스팅하면 배포가 간편해지고 리소스 관리가 향상되며 다양한 환경에서 뛰어난 이식성을 확보할 수 있습니다. Docker 컨테이너는 자체적으로 모든 기능을 수행하므로 애플리케이션이 배포 위치에 관계없이 일관되게 실행됩니다.

Docker에서 권장하지 않는 Linux 배포판을 사용할 경우 수동 구성이 필요한가요?

네, 권장 배포판(Ubuntu 20, Ubuntu 18, Debian 11, Debian 10) 이외의 Linux 배포판을 사용하는 경우 apt-get 사용하여 수동으로 구성해야 할 수 있습니다. 수동 설정에 대한 자세한 내용은 IronOCR에서 제공하는 'Linux 수동 설정' 가이드를 참조하십시오.

커티스 차우
커티스 차우
  지금 바로 엔지니어링 팀과 채팅하세요
기술 문서 작성자

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

커티스는 개발 분야 외에도 사물 인터넷(IoT)에 깊은 관심을 가지고 있으며, 하드웨어와 소프트웨어를 통합하는 혁신적인 방법을 연구합니다. 여가 시간에는 게임을 즐기거나 디스코드 봇을 만들면서 기술에 대한 애정과 창의성을 결합합니다.

시작할 준비 되셨나요?
Nuget 다운로드 5,525,971 | 버전: 2026.3 방금 출시되었습니다
Still Scrolling Icon

아직도 스크롤하고 계신가요?

빠른 증거를 원하시나요? PM > Install-Package IronOcr
샘플을 실행하세요 이미지가 검색 가능한 텍스트로 바뀌는 것을 확인해 보세요.