macOS ARM의 IronPdfEngine Docker 연결 실패 수정

Updated: 2026년 6월 10일

.NET 애플리케이션을 Apple Silicon (macOS ARM)에서 Docker를 통해 IronPdfEngine에 연결할 때 애플리케이션은 다음과 같은 오류를 발생시킵니다:

Unhandled exception. System.IO.FileNotFoundException: Error loading native library.
Not found in any of the possible locations

Unhandled exception. System.IO.FileNotFoundException: Error loading native library.
Not found in any of the possible locations

Text

IronPdfConnectionType.Docker은(는) ARM 아키텍처를 지원하지 않는 오래된 gRPC 구현을 사용합니다. macOS ARM (Apple Silicon)에서는 .NET 클라이언트가 필요한 네이티브 gRPC 바이너리를 로드할 수 없으며, 심지어 Docker 이미지가 --platform linux/amd64로 실행되도록 강제된 경우에도 그렇습니다. Windows 및 Linux x64 플랫폼은 영향을 받지 않습니다.

해결책

연결 구성에서 IronPdfConnectionType.Docker을(를) IronPdfConnectionType.RemoteServer으로 교체하십시오. RemoteServer은(는) ARM과 호환되는 최신 gRPC 구현을 사용합니다:

using IronPdf;

var config = new IronPdfConnectionConfiguration
{
    ConnectionType = IronPdfConnectionType.RemoteServer,
    Host = "http://127.0.0.1",
    Port = 33350
};

IronPdf.Installation.ConnectToIronPdfHost(config);

IronPdf.License.LicenseKey = Environment.GetEnvironmentVariable("IRONPDF_LICENSE_KEY");

var renderer = new ChromePdfRenderer();
var pdf = await renderer.RenderHtmlAsPdfAsync("<h1>Hello from IronPdfEngine</h1>");
pdf.SaveAs("output.pdf");

using IronPdf;

var config = new IronPdfConnectionConfiguration
{
    ConnectionType = IronPdfConnectionType.RemoteServer,
    Host = "http://127.0.0.1",
    Port = 33350
};

IronPdf.Installation.ConnectToIronPdfHost(config);

IronPdf.License.LicenseKey = Environment.GetEnvironmentVariable("IRONPDF_LICENSE_KEY");

var renderer = new ChromePdfRenderer();
var pdf = await renderer.RenderHtmlAsPdfAsync("<h1>Hello from IronPdfEngine</h1>");
pdf.SaveAs("output.pdf");

Imports IronPdf

Dim config As New IronPdfConnectionConfiguration With {
    .ConnectionType = IronPdfConnectionType.RemoteServer,
    .Host = "http://127.0.0.1",
    .Port = 33350
}

IronPdf.Installation.ConnectToIronPdfHost(config)

IronPdf.License.LicenseKey = Environment.GetEnvironmentVariable("IRONPDF_LICENSE_KEY")

Dim renderer As New ChromePdfRenderer()
Dim pdf = Await renderer.RenderHtmlAsPdfAsync("<h1>Hello from IronPdfEngine</h1>")
pdf.SaveAs("output.pdf")

Imports IronPdf

Dim config As New IronPdfConnectionConfiguration With {
    .ConnectionType = IronPdfConnectionType.RemoteServer,
    .Host = "http://127.0.0.1",
    .Port = 33350
}

IronPdf.Installation.ConnectToIronPdfHost(config)

IronPdf.License.LicenseKey = Environment.GetEnvironmentVariable("IRONPDF_LICENSE_KEY")

Dim renderer As New ChromePdfRenderer()
Dim pdf = Await renderer.RenderHtmlAsPdfAsync("<h1>Hello from IronPdfEngine</h1>")
pdf.SaveAs("output.pdf")

요구 사항:

ConnectToIronPdfHost을 호출하기 전에 IronPdfEngine Docker 컨테이너가 실행 중이며 지정된 호스트와 포트에서 접근 가능해야 합니다.
http://을 사용하고, https://은 사용하지 마십시오; 유효한 SSL 인증서 없이 https://을 사용하는 것은 gRPC 채널에서 프레임 손상 오류를 초래합니다.

또한 다음을 보십시오: Docker의 Vulkan/ANGLE 초기화 오류 해결 및 Azure 컨테이너의 gRPC 연결 오류 수정.

Curtis Chau

지금 바로 엔지니어링 팀과 채팅하세요

기술 문서 작성자

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

...

더 읽어보기