설치 개요
모든 플랫폼에서 IronPDF를 설치하고 구성하는 방법에 대한 완벽한 가이드입니다.
1. 플랫폼 요구사항
| 플랫폼 | .NET 버전 | 하드웨어 | 추가 요구 사항, 호환성 |
|---|---|---|---|
|
|
.NET 10, 9, 8, 7, 6, 5, .NET Core, .NET Standard 및 .NET Framework. |
|
|
|
|
|
||
|
|
2020년 이후 모든 macOS 버전 |
2. 설치 방법
IronPDF를 설치하는 방법에는 네이티브 모드와 원격 엔진 모드 두 가지가 있습니다. 기본적으로 네이티브 모드를 권장합니다. Docker/Kubernetes를 사용하여 프로덕션 서버에 배포하려면 원격 엔진 모드를 사용하십시오.
- 클라우드 및 컨테이너 환경 배포, 기존 운영체제 지원 **에 가장 적합합니다** .
- **패키지:** IronPdf.Slim
- **크기:** 용량이 훨씬 가벼워 몇 MB 정도만 차지합니다.
- **요구 사항:** 호스트와의 연결을 구성해야 합니다.
- **최적 사용 환경:** 최신 윈도우, macOS 및 리눅스 배포판.
- **패키지:** IronPDF 전체 NuGet 패키지입니다.
- **크기:** Chrome 및 PDFium 바이너리를 포함하여 크기가 상당히 큽니다(수백 MB).
- **요구 사항:** 최신 운영 체제에서 작동합니다.
3. 설치 옵션
C# PDF 라이브러리 설치는 5분도 채 걸리지 않습니다. NuGet을 통해 무료로 받거나 직접 다운로드하여 Visual Studio에서 바로 사용해 보세요.
IronPDF NuGet 라이브러리 (또는 Visual Studio의 패키지 관리자 콘솔)로 이동하세요.
- 솔루션 탐색기에서 참조를 마우스 오른쪽 버튼으로 클릭합니다.
- 'NuGet 패키지 관리' > '찾아보기' > IronPDF 검색을 선택합니다.
- 패키지를 선택하고 설치하세요.
Install-Package IronPdf
- 사용하시는 플랫폼(윈도우, 리눅스, macOS)에 맞는 IronPDF DLL 패키지를 다운로드하세요.
- 사용 중인 운영체제에 맞는 ZIP 파일의 압축을 풀어 솔루션 디렉터리 내의 원하는 위치에 저장하세요.
- Visual Studio 솔루션 탐색기에서 '종속성'을 마우스 오른쪽 버튼으로 클릭합니다.
- '프로젝트 참조 추가' > '찾아보기'를 선택하여 압축 파일에서 추출한 모든 DLL을 포함시키세요.
NuGet을 사용하여 IronPDF를 설치하세요.
Install-Package IronPdf.Slim
4. 추가 구성
IronPDF를 구매하거나 30일 무료 체험판에 가입한 후, 이메일로 발송된 라이선스 키를 확인하세요.
애플리케이션 시작 부분에 라이선스 키를 입력하세요.
IronPdf.License.LicenseKey = "KEY";
IronPdf.License.LicenseKey = "KEY";
Imports IronPdf
IronPdf.License.LicenseKey = "KEY"
라이선스 상태를 확인하세요.
bool valid = IronPdf.License.IsLicensed;
bool valid = IronPdf.License.IsLicensed;
Imports IronPdf
Dim valid As Boolean = IronPdf.License.IsLicensed
IronPdf.Installation 개체의 TempFolderPath 속성을 설정합니다.
IronPdf.Installation.TempFolderPath = @"C:\My\Safe\Path";
IronPdf.Installation.TempFolderPath = @"C:\My\Safe\Path";
IronPdf.Installation.TempFolderPath = "C:\My\Safe\Path"
애플리케이션 범위에서 임시 폴더 환경 변수를 설정합니다.
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
[원격 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") _
)
[리눅스] IronPDF가 필요한 모든 리눅스 종속성을 자동으로 설치하도록 설정합니다. HTML을 PDF로 변환하는 첫 번째 작업은 평소보다 시간이 더 오래 걸릴 수 있습니다.
Installation.리눅스AndDockerDependenciesAutoConfig = true;
Installation.리눅스AndDockerDependenciesAutoConfig = true;
[Docker] Docker 환경에서 Chrome 엔진을 사전 초기화하여 필수 구성 요소를 미리 로드하고 최초 사용 속도를 향상시킵니다.
IronPdf.Installation.Initialize();
IronPdf.Installation.Initialize();
IronPdf.Installation.Initialize()
5. 배포 시나리오
IronPDF .NET을 실행 및 배포하세요
Azure FunctionIronPDF .NET을 실행 및 배포하세요
AWS 람다IronPDF를 실행하세요
리눅스 Docker 컨테이너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 패키지를 사용하는 것이 좋습니다.

