설치 개요

This article was translated from English: Does it need improvement?
Translated
View the article in English

모든 플랫폼에서 IronPDF를 설치하고 구성하는 방법에 대한 완벽한 가이드입니다.

  1. NuGet 패키지 관리자를 사용하여 https://www.nuget.org/packages/IronPdf 설치하기

    PM > Install-Package IronPdf
  2. 다음 코드 조각을 복사하여 실행하세요.

    IronPdf.ChromePdfRenderer
           .StaticRenderHtmlAsPdf("<p>Hello World</p>")
           .SaveAs("pixelperfect.pdf");
  3. 실제 운영 환경에서 테스트할 수 있도록 배포하세요.

    무료 체험판으로 오늘 프로젝트에서 IronPDF 사용 시작하기

    arrow pointer

1. 플랫폼 요구사항

플랫폼 .NET 버전 하드웨어 추가 요구 사항, 호환성
Logo Table Windows related to 1. 플랫폼 요구사항
윈도우
.NET 10, 9, 8, 7, 6, 5, .NET Core, .NET Standard 및 .NET Framework.
  • 최소 사양: 1코어 및 1.75GB RAM
  • 권장 사양: 2코어 이상 및 8GB 이상의 RAM
  • 윈도우 10, 11 및 윈도우 서버
  • Visual C++ 재배포 가능 패키지(x86 및 x64)
Logo Table Linux related to 1. 플랫폼 요구사항
리눅스
  • 64비트 리눅스 OS: Ubuntu 22, Ubuntu 20, Ubuntu 18, Ubuntu 16, Debian 10-11m CentOS 8, Fedora 리눅스 33, Amazon, AWS, 리눅스 2
  • 아이언세프하위 프로세스
  • Chrome 종속성
Logo Table Mac related to 1. 플랫폼 요구사항
macOS
2020년 이후 모든 macOS 버전

2. 설치 방법

IronPDF를 설치하는 방법에는 네이티브 모드와 원격 엔진 모드 두 가지가 있습니다. 기본적으로 네이티브 모드를 권장합니다. Docker/Kubernetes를 사용하여 프로덕션 서버에 배포하려면 원격 엔진 모드를 사용하십시오.

원격 엔진 모드: gRPC 프로토콜을 통한 별도의 PDF 처리.
  • 클라우드 및 컨테이너 환경 배포, 기존 운영체제 지원 **에 가장 적합합니다** .
  • **패키지:** IronPdf.Slim
  • **크기:** 용량이 훨씬 가벼워 몇 MB 정도만 차지합니다.
  • **요구 사항:** 호스트와의 연결을 구성해야 합니다.

3. 설치 옵션

C# PDF 라이브러리 설치는 5분도 채 걸리지 않습니다. NuGet을 통해 무료로 받거나 직접 다운로드하여 Visual Studio에서 바로 사용해 보세요.

NuGet 패키지
수동 다운로드
원격 IronPDF엔진

IronPDF NuGet 라이브러리 (또는 Visual Studio의 패키지 관리자 콘솔)로 이동하세요.

  1. 솔루션 탐색기에서 참조를 마우스 오른쪽 버튼으로 클릭합니다.
  2. 'NuGet 패키지 관리' > '찾아보기' > IronPDF 검색을 선택합니다.
  3. 패키지를 선택하고 설치하세요.
Install-Package IronPdf
  1. 사용하시는 플랫폼(윈도우, 리눅스, macOS)에 맞는 IronPDF DLL 패키지를 다운로드하세요.
  2. 사용 중인 운영체제에 맞는 ZIP 파일의 압축을 풀어 솔루션 디렉터리 내의 원하는 위치에 저장하세요.
  3. Visual Studio 솔루션 탐색기에서 '종속성'을 마우스 오른쪽 버튼으로 클릭합니다.
  4. '프로젝트 참조 추가' > '찾아보기'를 선택하여 압축 파일에서 추출한 모든 DLL을 포함시키세요.

참고해 주세요참고: 각 IronPDF 릴리스에는 해당 버전의 IronPDFEngine이 필요합니다. 버전 간 호환성은 지원되지 않습니다. 예를 들어, IronPDF 2024.2.2는 IronPDFEngine 2024.2.2를 사용해야 합니다.

NuGet을 사용하여 IronPDF를 설치하세요.

Install-Package IronPdf.Slim

4. 추가 구성

라이선스 관리
Path & Permission
원격 엔진

IronPDF를 구매하거나 30일 무료 체험판에 가입한 후, 이메일로 발송된 라이선스 키를 확인하세요.

애플리케이션 시작 부분에 라이선스 키를 입력하세요.

IronPdf.License.LicenseKey = "KEY";
IronPdf.License.LicenseKey = "KEY";
Imports IronPdf

IronPdf.License.LicenseKey = "KEY"
$vbLabelText   $csharpLabel

라이선스 상태를 확인하세요.

bool valid = IronPdf.License.IsLicensed;
bool valid = IronPdf.License.IsLicensed;
Imports IronPdf

Dim valid As Boolean = IronPdf.License.IsLicensed
$vbLabelText   $csharpLabel

IronPdf.Installation 개체의 TempFolderPath 속성을 설정합니다.

IronPdf.Installation.TempFolderPath = @"C:\My\Safe\Path";
IronPdf.Installation.TempFolderPath = @"C:\My\Safe\Path";
IronPdf.Installation.TempFolderPath = "C:\My\Safe\Path"
$vbLabelText   $csharpLabel

경로를 업데이트한 후에는 개발 환경과 서버의 임시 및 캐시 폴더를 모두 지우고 애플리케이션의 깨끗한 버전을 다시 배포하십시오.

애플리케이션 범위에서 임시 폴더 환경 변수를 설정합니다.

using IronPdf;

// Adjusts System.IO.Path.GetTempFileName and System.IO.Path.GetTempPath behavior for the application
var MyTempPath = @"C:\Safe\Path\";
Environment.SetEnvironmentVariable("TEMP", MyTempPath, EnvironmentVariableTarget.Process);
Environment.SetEnvironmentVariable("TMP", MyTempPath, EnvironmentVariableTarget.Process);

// Set IronPDF Temp Path
IronPdf.Installation.TempFolderPath = System.IO.Path.Combine(MyTempPath, "IronPdf");

// Your PDF Generation and editing code
var Renderer = new IronPdf.ChromePdfRenderer();
using var Doc = Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>");
Doc.SaveAs("example.pdf");
using IronPdf;

// Adjusts System.IO.Path.GetTempFileName and System.IO.Path.GetTempPath behavior for the application
var MyTempPath = @"C:\Safe\Path\";
Environment.SetEnvironmentVariable("TEMP", MyTempPath, EnvironmentVariableTarget.Process);
Environment.SetEnvironmentVariable("TMP", MyTempPath, EnvironmentVariableTarget.Process);

// Set IronPDF Temp Path
IronPdf.Installation.TempFolderPath = System.IO.Path.Combine(MyTempPath, "IronPdf");

// Your PDF Generation and editing code
var Renderer = new IronPdf.ChromePdfRenderer();
using var Doc = Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>");
Doc.SaveAs("example.pdf");
Imports IronPdf
Imports System.IO

' Adjusts System.IO.Path.GetTempFileName and System.IO.Path.GetTempPath behavior for the application
Dim MyTempPath As String = "C:\Safe\Path\"
Environment.SetEnvironmentVariable("TEMP", MyTempPath, EnvironmentVariableTarget.Process)
Environment.SetEnvironmentVariable("TMP", MyTempPath, EnvironmentVariableTarget.Process)

' Set IronPDF Temp Path
IronPdf.Installation.TempFolderPath = Path.Combine(MyTempPath, "IronPdf")

' Your PDF Generation and editing code
Dim Renderer As New IronPdf.ChromePdfRenderer()
Using Doc = Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>")
    Doc.SaveAs("example.pdf")
End Using
$vbLabelText   $csharpLabel

보안이 강화된 서버에서는 IIS 사용자(IUSER)에게 설치 경로 폴더와 윈도우 및 임시 폴더에 대한 읽기 및 쓰기 권한을 부여하십시오.

[원격 IronPDFEngine] IronPdf.Slim 패키지를 설치한 후, 엔진 컨테이너에 연결하고 앱 시작 시 또는 IronPDF 메서드를 호출하기 전에 연결을 구성하십시오.

IronPDFEngine이 123.456.7.8:33350에서 원격으로 실행된다고 가정합니다.

Installation.ConnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);
Installation.ConnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);
Installation.ConnectToIronPdfHost( _
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350") _
)
$vbLabelText   $csharpLabel

[리눅스] IronPDF가 필요한 모든 리눅스 종속성을 자동으로 설치하도록 설정합니다. HTML을 PDF로 변환하는 첫 번째 작업은 평소보다 시간이 더 오래 걸릴 수 있습니다.

Installation.리눅스AndDockerDependenciesAutoConfig = true;
Installation.리눅스AndDockerDependenciesAutoConfig = true;
$vbLabelText   $csharpLabel

[Docker] Docker 환경에서 Chrome 엔진을 사전 초기화하여 필수 구성 요소를 미리 로드하고 최초 사용 속도를 향상시킵니다.

IronPdf.Installation.Initialize();
IronPdf.Installation.Initialize();
IronPdf.Installation.Initialize()
$vbLabelText   $csharpLabel

5. 배포 시나리오

Logo Azure related to 5. 배포 시나리오

IronPDF .NET을 실행 및 배포하세요

Azure Function
Logo Aws related to 5. 배포 시나리오

IronPDF .NET을 실행 및 배포하세요

AWS 람다
Logo Linux related to 5. 배포 시나리오

IronPDF를 실행하세요

리눅스 Docker 컨테이너
Logo Remote related to 5. 배포 시나리오

IronPDF를 다음과 같이 실행하세요.

원격 컨테이너

다음 단계


자주 묻는 질문

IronPDFEngine을 사용하여 원격으로 PDF를 생성하려면 어떻게 설정해야 하나요?

원격 PDF 생성을 위해 IronPDFEngine을 설정하려면 NuGet에서 IronPdf.Slim 패키지를 설치하고 IronPDFConnectionConfiguration 클래스를 사용하여 연결 설정을 구성하십시오. 이 설정을 통해 애플리케이션을 IronPDFEngine 인스턴스에 원격으로 연결할 수 있습니다.

IronPDFEngine을 애플리케이션과 함께 사용할 때의 주요 이점은 무엇입니까?

IronPDFEngine을 애플리케이션과 함께 사용하면 PDF 작업을 원격으로 실행할 수 있으므로 특히 구형 시스템 및 모바일 플랫폼에서 플랫폼별 호환성 문제를 방지하는 데 도움이 됩니다. 또한 실행 중에 .NET 런타임이 필요하지 않습니다.

PDF 기본 라이브러리 대신 IronPDFEngine을 사용하는 것을 선택할 수 있는 이유는 무엇일까요?

IronPDFEngine을 선택하면 성능 집약적인 PDF 기능을 원격으로 실행할 수 있으며, 이를 통해 다양한 운영 체제와의 호환성 문제를 줄이고 Chrome과 동일한 HTML-PDF 변환 렌더러를 활용하여 성능을 향상시킬 수 있습니다.

IronPDFEngine에서 수평 확대/축소가 지원되나요?

아니요, IronPDFEngine은 현재 수평 확장을 지원하지 않습니다. 즉, 서버 메모리에서 PDF 파일 바이너리가 처리되는 방식 때문에 여러 인스턴스에 걸쳐 로드 밸런싱이 불가능합니다.

IronPDFEngine은 다양한 운영 체제에서 실행될 수 있습니까?

IronPDFEngine은 Docker 컨테이너를 사용하여 Linux 시스템에서 실행되도록 설계되었습니다. 하지만 바이너리 파일은 플랫폼별로 다르므로 사용 중인 운영 체제에 맞는 버전을 사용해야 합니다.

IronPDFEngine을 사용할 때 PDF 출력 결과가 다르게 나오면 어떻게 해야 하나요?

운영 체제의 동작 방식에 따라 PDF 출력 결과가 약간씩 다를 수 있습니다. 차이를 최소화하려면 올바른 Docker 이미지를 사용하고 렌더링에 영향을 줄 수 있는 운영 체제별 설정을 확인하십시오.

내 애플리케이션이 올바른 버전의 IronPDFEngine을 사용하고 있는지 어떻게 확인할 수 있습니까?

호환성을 보장하기 위해 IronPDF의 각 버전에는 해당 버전의 IronPDFEngine이 필요합니다. 버전 간 문제를 방지하려면 두 구성 요소를 동시에 업데이트하십시오.

Windows에서 IronPDFEngine을 사용할 때의 제한 사항은 무엇입니까?

Windows에서 IronPDFEngine을 사용하려면 Docker용 Linux 컨테이너가 필요하며 서버 포트에 접근 가능한지 확인해야 합니다. 바이너리는 플랫폼별로 다르므로 Linux 컨테이너로 전환해야 합니다.

IronPDF가 원격 IronPDFEngine 서버에 연결되도록 구성하려면 어떻게 해야 합니까?

원격 서버에 대한 IronPDF를 구성하려면 Installation.ConnectToIronPDFHost IronPdf.GrpcLayer.IronPDFConnectionConfiguration.RemoteServer 메서드와 함께 사용하고 서버의 IP 주소와 포트 정보를 지정하십시오.

IronPDFEngine을 사용할 때 애플리케이션 크기를 최소화하려면 어떤 패키지를 사용해야 할까요?

IronPDFEngine을 사용하여 IronPDF를 실행하는 데 필요한 구성 요소만 포함되어 있으므로 애플리케이션 크기를 줄이려면 NuGet에서 IronPdf.Slim 패키지를 사용하는 것이 좋습니다.

커티스 차우
기술 문서 작성자

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

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

시작할 준비 되셨나요?
Nuget 다운로드 18,318,263 | 버전: 2026.4 방금 출시되었습니다
Still Scrolling Icon

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

빠른 증거를 원하시나요? PM > Install-Package IronPdf
샘플을 실행하세요 HTML이 PDF로 변환되는 것을 지켜보세요.