如何使用 C# 在 Windows 上託管 IronSecureDoc

Q: 如何下載 IronSecureDoc Docker 映像？

開啟指令提示字元並執行指令： docker pull ironsoftwareofficial/ironsecuredoc:latest 下載 IronSecureDoc 映像。

Q: IronSecureDoc 是否可以在沒有 SSL 憑證的情況下運作？

是的，您可以透過執行下列命令在沒有 SSL 憑證的情況下執行 IronSecureDoc 容器： docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey= -e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latest ，替換 使用您的實際許可證密鑰。

Q: 容器運作後，如何存取 IronSecureDoc 介面？

您可以透過開啟網頁瀏覽器並造訪 http://localhost:8080/swagger/index.html 來存取 IronSecureDoc 介面。

Q: 如何設定 IronSecureDoc 以使用 SSL 憑證？

使用 dotnet dev-certs 產生證書，然後執行 IronSecureDoc 容器，命令中包含證書路徑和密碼，以增強安全性。

Q: 在哪裡可以找到 IronSecureDoc REST API 的詳細文件？

IronSecureDoc 的完整 REST API 參考可在 /enterprise/securedoc/tutorials/use-rest-api/ 取得。

柯蒂斯·週

更新:1月 10, 2026

Translated

View the article in English

IronSecureDoc 是一個 Docker 容器，旨在透過簡單的 REST API 為您提供強大的 PDF 操作功能，而無需在線 SaaS 服務的麻煩和開銷。本指南將引導您完成在電腦上託管 IronSecureDoc 的步驟，包括設定環境變數和使用 REST API 的基本範例。如需查看完整的 API，請參閱我們的REST API 參考文件。

docker pull ironsoftwareofficial/ironsecuredoc:latest

docker pull ironsoftwareofficial/ironsecuredoc:latest

SHELL

先決條件

Windows作業系統
- Windows 10 或更高版本
- Windows Server（2016、2019、2022）注意：可能需要額外的步驟 -程式
- 已安裝並執行適用於 Windows 的 Docker Desktop

逐步指南

1. 安裝 Docker Desktop

如果您尚未安裝 Docker Desktop，請依照下列步驟操作：

前往Docker Desktop 下載頁面。
下載適用於 Windows 的 Docker Desktop 安裝程式。
執行安裝程式並依照螢幕上的指示進行操作。
安裝完成後，啟動 Docker Desktop 並確保其正在運作。

2. 拉取"IronSecureDoc"Docker映像

開啟命令提示符，從 Docker Hub 拉取最新的 IronSecureDoc 映像：

docker pull ironsoftwareofficial/ironsecuredoc:latest

docker pull ironsoftwareofficial/ironsecuredoc:latest

SHELL

3. 不含憑證運作容器

使用必要的環境變數來執行 Docker 容器：

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

SHELL

使用試用金鑰或許可證金鑰去除浮水印

[{t:(替換<IRONSECUREDOC_LICENSE_KEY>使用您實際的 IronSecureDoc 授權金鑰。否則，企業功能將會新增浮水印。

4. 訪問容器

容器運行後，您可以透過開啟網頁瀏覽器並導航至以下位址來存取 IronSecureDoc：

http://localhost:8080/swagger/index.html

您應該會看到 IronSecureDoc 介面，這表示您的容器正在成功運行。

5. 使用憑證執行 IronSecureDoc 容器

如果需要使用憑證執行容器，請依照下列步驟產生憑證並設定本機：

1.生成證書：

   dotnet dev-certs https -ep %USERPROFILE%\.aspnet\https\ironsecuredoc.pfx -p <CREDENTIAL_PLACEHOLDER>
   dotnet dev-certs https --trust

   dotnet dev-certs https -ep %USERPROFILE%\.aspnet\https\ironsecuredoc.pfx -p <CREDENTIAL_PLACEHOLDER>
   dotnet dev-certs https --trust

SHELL

代替<CREDENTIAL_PLACEHOLDER>使用密碼。

2.運行 Docker 容器：

   docker container run -d -p 8081:8081 -p 8080:8080 -e HTTP_PORTS=8080 -e HTTPS_PORTS=8081 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> -e ENVIRONMENT=Production -v %USERPROFILE%\.aspnet\https:/https:ro -e CERTIFICATE_PATH=%USERPROFILE%\.aspnet\https\ironsecuredoc.pfx -e CERTIFICATE_PASSWORD=<CERTIFICATE_PASSWORD> ironsoftwareofficial/ironsecuredoc:latest

   docker container run -d -p 8081:8081 -p 8080:8080 -e HTTP_PORTS=8080 -e HTTPS_PORTS=8081 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> -e ENVIRONMENT=Production -v %USERPROFILE%\.aspnet\https:/https:ro -e CERTIFICATE_PATH=%USERPROFILE%\.aspnet\https\ironsecuredoc.pfx -e CERTIFICATE_PASSWORD=<CERTIFICATE_PASSWORD> ironsoftwareofficial/ironsecuredoc:latest

SHELL

代替<IRONSECUREDOC_LICENSE_KEY>和<CERTIFICATE_PASSWORD>請分別使用您的 IronSecureDoc 授權金鑰和憑證密碼。

6. 管理容器

您可以使用 Docker 命令管理正在執行的容器。以下是一些常用指令：

-停止容器：

  docker stop <container-id>

  docker stop <container-id>

SHELL

-啟動容器：

  docker start <container-id>

  docker start <container-id>

SHELL

-移除容器：

  docker rm -f <container-id>

  docker rm -f <container-id>

SHELL

代替<container-id>使用實際的容器 ID 或名稱。

環境變數

可以使用以下環境變數配置容器：

PDF_MAX_SIZE_MB （預設值：30）：設定 PDF 上傳允許的最大檔案大小（以兆位元組為單位）。
REQUEST_TIMEOUT_SECONDS （預設值：5）：設定 API 請求的逾時時間（以秒為單位）。 -1 的值允許請求無限期執行。
ALLOWED_ORIGINS ：透過指定允許的來源 URL 設定跨網域資源共用 (CORS)。多個網址之間以逗號分隔。使用*或all表示允許來自任何來源的請求。
HTTP_PORTS ：定義容器公開的 HTTP 連接埠。這應該與使用 -p 標誌（例如 8080 ）的連接埠對應相符。多個連接埠之間以分號（ ; ）分隔。
HTTPS_PORTS ：定義容器公開的 HTTPS 連接埠。這應與使用 -p 標誌的連接埠對應相符 (例如：8081)。多個連接埠之間以分號（ ; ）分隔。
IronSecureDoc_LicenseKey （必要）：設定 IronSecureDoc 授權金鑰。重要提示：請勿公開此數值。

基本範例：編輯文件中的文本

有關 API 端點的完整列表，請參閱完整的REST API 參考文件。

編輯文字

curl -X POST 'http://localhost:8080/v1/document-services/pdfs/redact-text' -H 'accept: */*' -H 'Content-Type: multipart/form-data' -F 'pdf_file=@/path/to/your/document.pdf;type=application/pdf' -F 'words_to_redact="sensitiveWord"' -F 'draw_black_box=true' -F 'match_whole_word=true' -F 'match_case=true'

curl -X POST 'http://localhost:8080/v1/document-services/pdfs/redact-text' -H 'accept: */*' -H 'Content-Type: multipart/form-data' -F 'pdf_file=@/path/to/your/document.pdf;type=application/pdf' -F 'words_to_redact="sensitiveWord"' -F 'draw_black_box=true' -F 'match_whole_word=true' -F 'match_case=true'

SHELL

將/path/to/your/document.pdf替換為要編輯的文檔的實際路徑，將sensitiveWord替換為要編輯的單字。

編輯正規表示式

curl -X POST 'http://localhost:8080/v1/document-services/pdfs/redact-regular-expression' -H 'accept: */*' -H 'Content-Type: multipart/form-data' -F 'pdf_file=@/path/to/your/document.pdf;type=application/pdf' -F 'regular_expression="[0-9]"' -F 'draw_black_box=true'

curl -X POST 'http://localhost:8080/v1/document-services/pdfs/redact-regular-expression' -H 'accept: */*' -H 'Content-Type: multipart/form-data' -F 'pdf_file=@/path/to/your/document.pdf;type=application/pdf' -F 'regular_expression="[0-9]"' -F 'draw_black_box=true'

SHELL

將/path/to/your/document.pdf替換為要編輯的文檔的實際路徑，並將[0-9]替換為要匹配和編輯的正規表示式。

結論

您已成功在您的機器上託管 IronSecureDoc，並為其配置了必要的環境變數。您也學習如何使用 cURL 與 IronSecureDoc REST API 進行基本和進階操作。如需更多設定和使用詳情，請參閱完整的REST API 參考文件。

常見問題解答

IronSecureDoc是什麼？

IronSecureDoc 是一個 Docker 容器，它透過簡單的 REST API 提供強大的 PDF 操作功能，專為離線文件安全性和合規性而設計。

在Windows系統上執行IronSecureDoc需要哪些系統需求？

要在 Windows 上託管 IronSecureDoc，您需要 Windows 10 或更高版本，或 Windows Server 版本（2016、2019、2022）以及已安裝的 Docker Desktop for Windows。

如何在我的Windows電腦上安裝Docker Desktop？

從 Docker 官方網站下載 Docker Desktop，運行安裝程序，並按照安裝說明進行操作。安裝完成後，啟動 Docker Desktop 即可開始使用。

如何下載 IronSecureDoc Docker 映像？

開啟指令提示字元並執行指令： docker pull ironsoftwareofficial/ironsecuredoc:latest下載 IronSecureDoc 映像。

IronSecureDoc 是否可以在沒有 SSL 憑證的情況下運作？

是的，您可以透過執行下列命令在沒有 SSL 憑證的情況下執行 IronSecureDoc 容器： docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey=-e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latest ，替換使用您的實際許可證密鑰。

容器運作後，如何存取 IronSecureDoc 介面？

您可以透過開啟網頁瀏覽器並造訪http://localhost:8080/swagger/index.html來存取 IronSecureDoc 介面。

如何設定 IronSecureDoc 以使用 SSL 憑證？

使用dotnet dev-certs產生證書，然後執行 IronSecureDoc 容器，命令中包含證書路徑和密碼，以增強安全性。

有哪些環境變數可用於設定 IronSecureDoc 容器？

您可以設定各種環境變量，例如 PDF_MAX_SIZE_MB、REQUEST_TIMEOUT_SECONDS、ALLOWED_ORIGINS、HTTP_PORTS、HTTPS_PORTS 和 IronSecureDoc_LicenseKey。

如何使用 IronSecureDoc 對 PDF 中的敏感資訊進行編輯？

若要編輯 PDF 中的文本，請使用 cURL 指令向 IronSecureDoc REST API 發送 POST 請求，指定 PDF 檔案和要編輯的文字或模式。

在哪裡可以找到 IronSecureDoc REST API 的詳細文件？

IronSecureDoc 的完整 REST API 參考可在/enterprise/securedoc/tutorials/use-rest-api/取得。

柯蒂斯·週

現在就和工程團隊聊天吧

技術撰稿人

Curtis Chau擁有卡爾頓大學電腦科學學士學位，專長於前端開發，精通Node.js、TypeScript、JavaScript和React。他熱衷於打造直覺美觀的使用者介面，喜歡使用現代框架，並擅長撰寫結構清晰、視覺效果出色的使用者手冊。

除了開發工作之外，柯蒂斯對物聯網 (IoT) 也抱有濃厚的興趣，致力於探索硬體和軟體整合的創新方法。閒暇時，他喜歡玩遊戲和製作 Discord 機器人，將他對科技的熱愛與創造力結合。

準備好開始了嗎？

版本： 2024.10 剛剛發布

查看許可證

客戶亮點：

開發者對焦：

網路研討會：

本頁內容

如何使用 C# 在 Windows 上託管 IronSecureDoc

先決條件

逐步指南

1. 安裝 Docker Desktop

2. 拉取"IronSecureDoc"Docker映像

3. 不含憑證運作容器

使用試用金鑰或許可證金鑰去除浮水印

4. 訪問容器

5. 使用憑證執行 IronSecureDoc 容器

6. 管理容器

環境變數

基本範例：編輯文件中的文本

編輯文字

編輯正規表示式

結論

常見問題解答

IronSecureDoc是什麼？

在Windows系統上執行IronSecureDoc需要哪些系統需求？

如何在我的Windows電腦上安裝Docker Desktop？

如何下載 IronSecureDoc Docker 映像？

IronSecureDoc 是否可以在沒有 SSL 憑證的情況下運作？

容器運作後，如何存取 IronSecureDoc 介面？

如何設定 IronSecureDoc 以使用 SSL 憑證？

有哪些環境變數可用於設定 IronSecureDoc 容器？

如何使用 IronSecureDoc 對 PDF 中的敏感資訊進行編輯？

在哪裡可以找到 IronSecureDoc REST API 的詳細文件？

本頁內容

如何使用 C# 在 Windows 上託管 IronSecureDoc

先決條件

逐步指南

1. 安裝 Docker Desktop

2. 拉取"IronSecureDoc"Docker映像

3. 不含憑證運作容器

使用試用金鑰或許可證金鑰去除浮水印

4. 訪問容器

5. 使用憑證執行 IronSecureDoc 容器

6. 管理容器

環境變數

基本範例：編輯文件中的文本

編輯文字

編輯正規表示式

結論

常見問題解答

IronSecureDoc是什麼？

在Windows系統上執行IronSecureDoc需要哪些系統需求？

如何在我的Windows電腦上安裝Docker Desktop？

如何下載 IronSecureDoc Docker 映像？

IronSecureDoc 是否可以在沒有 SSL 憑證的情況下運作？

容器運作後，如何存取 IronSecureDoc 介面？

如何設定 IronSecureDoc 以使用 SSL 憑證？

有哪些環境變數可用於設定 IronSecureDoc 容器？

如何使用 IronSecureDoc 對 PDF 中的敏感資訊進行編輯？

在哪裡可以找到 IronSecureDoc REST API 的詳細文件？

下一步：開始30天免費試用

下一步：開始30天免費試用

深受全球數百萬工程師信賴