IRONSOFTWAREHOME

Hosting IronSecureDoc on Linux Using C#

Curtis Chau
Curtis Chau
Updated: 2026年6月29日
IronSecureDoc on Docker

IronSecureDoc は、オンライン SaaS サービスの手間やオーバーヘッドなしに、シンプルな REST API の背後で強力な PDF 操作を実現するように設計された Docker コンテナーです。 このガイドでは、環境変数の設定や REST API の基本的な使用例など、IronSecureDoc をマシン上でホストする手順について説明します。 完全な API については、 REST API リファレンスをご覧ください。

docker pull ironsoftwareofficial/ironsecuredoc:latest
SHELL

前提条件

警告: Docker Desktop on Linux は仮想マシン (VM) を実行し、起動時にカスタムの docker コンテキスト desktop-linux を作成および使用します。

つまり、Linux Docker Engine (インストール前) にデプロイされたイメージとコンテナは、Docker Desktop for Linux では利用できません。

プラットフォーム

ステップバイステップガイド

1. Dockerデスクトップをインストールする

まだDocker Desktopをインストールしていない場合は、以下の手順に従ってください:

  1. Docker Desktop のダウンロード ページにアクセスします。
  2. Linux 用の Docker Desktop インストーラーをダウンロードします。
  3. インストーラーを実行し、画面の指示に従います。
  4. インストール後、Docker Desktop を起動し、実行されていることを確認します。

2. "IronSecureDoc"Dockerイメージをプルする

コマンドプロンプトを開き、Docker Hub から最新の IronSecureDoc イメージをプルします。

docker pull ironsoftwareofficial/ironsecuredoc:latest
SHELL

3. 証明書なしでコンテナを実行する

必要な環境変数を使用して Docker コンテナを実行します。

Swagger UI in Browser
docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> -e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latest
SHELL

透かしを削除するには試用版またはライセンスキーを適用します

ヒント:

実際の IronSecureDoc ライセンスキーで <IRONSECUREDOC_LICENSE_KEY> を置き換えます。 それ以外の場合、エンタープライズ機能に透かしが適用されます。

Swagger UI in Browser

)}]

4. コンテナにアクセスする

コンテナが実行されると、Web ブラウザを開いて次の場所に移動し、IronSecureDoc にアクセスできます。

http://localhost:8080/swagger/index.html
Text
Swagger UI in Browser

コンテナが正常に実行されていることを示す IronSecureDoc インターフェースが表示されます。

5. 証明書を使用してIronSecureDocコンテナを実行する

証明書を使用してコンテナを実行する必要がある場合は、以下の手順に従って証明書を生成し、ローカル・マシンを設定してください:

1.証明書を生成する:

dotnet dev-certs https -ep $HOME/.aspnet/https/ironsecuredoc.pfx -p <CREDENTIAL_PLACEHOLDER>
dotnet dev-certs https --trust
SHELL

パスワードで <CREDENTIAL_PLACEHOLDER> を置き換えます。

  1. 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 $HOME/.aspnet/https:/https:ro \
    -e CERTIFICATE_PATH=$HOME/.aspnet/https/ironsecuredoc.pfx \
    -e CERTIFICATE_PASSWORD=<CERTIFICATE_PASSWORD> \
    ironsoftwareofficial/ironsecuredoc:latest
    SHELL

    実際の IronSecureDoc ライセンスキーと証明書パスワードで、それぞれ <IRONSECUREDOC_LICENSE_KEY> および <CERTIFICATE_PASSWORD> を置き換えます。

6. コンテナの管理

Docker コマンドを使用して実行中のコンテナを管理できます。 便利なコマンドをいくつか紹介します:

-コンテナを停止します:

docker stop <container_id>
SHELL
  • コンテナを開始する:

    docker start <container_id>
    SHELL

-コンテナを削除します:

docker rm -f <container_id>
SHELL

実際のコンテナ ID または名前で <container_id> を置き換えます。

環境変数

コンテナは、以下の環境変数を使用して設定できます:

  • PDF_MAX_SIZE_MB (デフォルト: 30): PDF アップロードの最大許容ファイルサイズをメガバイトで設定します。
  • REQUEST_TIMEOUT_SECONDS (デフォルト: 5): API リクエストのタイムアウト時間を秒で設定します。 値が -1 の場合、リクエストは無期限に実行されます。
  • ALLOWED_ORIGINS: 許可されたオリジン URL を指定してクロスオリジンリソース共有 (CORS) を設定します。 複数のURLはカンマで区切ってください。 任意のオリジンからのリクエストを許可するには、* または"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'
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'
SHELL

編集したいドキュメントの実際のパスで /path/to/your/document.pdf を置き換え、一致させて編集したい正規表現で [0-9] を置き換えます。

結論

マシン上で IronSecureDoc をホストし、必要な環境変数を設定しました。 また、基本操作と高度な操作の両方で cURL を使用して IronSecureDoc REST API と対話する方法も学習しました。 さらなる構成と使用方法の詳細については、完全なREST API リファレンスを参照してください。

よくある質問

IronSecureDocとは何か、その機能は?

IronSecureDocは、REST APIを介して強力なPDF操作を提供し、SaaSサービスに依存せずにオフラインのドキュメントセキュリティを可能にするDockerコンテナです。

LinuxサーバーでIronSecureDocを設定するための要件は何ですか?

LinuxサーバーでIronSecureDocを設定するには、Ubuntu, Debian, Fedora, Red Hat Enterprise LinuxなどのLinuxディストリビューションにDocker Desktopがインストールされていることを確認してください。

IronSecureDocのDockerイメージをダウンロードする方法は?

ターミナルで次のコマンドを実行することでIronSecureDocのDockerイメージをダウンロードします: docker pull ironsoftwareofficial/ironsecuredoc:latest

SSL証明書なしでIronSecureDocコンテナを実行することは可能ですか?

はい、次のコマンドを使用することでSSL証明書なしでコンテナを実行できます: docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> -e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latest

どうやってブラウザでIronSecureDocインターフェースにアクセスできますか?

コンテナを起動後、Webブラウザーでhttp://localhost:8080/swagger/index.htmlを訪れることでIronSecureDocインターフェースにアクセスします。

IronSecureDocのSSL証明書を生成して信頼する方法は?

次を使用してSSL証明書を生成します: dotnet dev-certs https -ep $HOME/.aspnet/https/ironsecuredoc.pfx -p <CREDENTIAL_PLACEHOLDER> そして次を使用して信頼します: dotnet dev-certs https --trust

IronSecureDocで設定可能な環境変数は何ですか?

IronSecureDocで設定可能な環境変数にはPDF_MAX_SIZE_MB, REQUEST_TIMEOUT_SECONDS, ALLOWED_ORIGINS, HTTP_PORTS, HTTPS_PORTS, IronSecureDoc_LicenseKeyがあります。

IronSecureDoc を使用して PDF 内のテキストをどのようにレダクトしますか?

必要なフォームデータとともに次のcURLコマンドを使用してPDF内のテキストを編集します: curl -X POST 'http://localhost:8080/v1/document-services/pdfs/redact-text'

実行中のIronSecureDoc Dockerコンテナを停止するコマンドは何ですか?

次のコマンドを使用して実行中のDockerコンテナを停止します: docker stop <container_id>

IronSecureDocの完全なAPIエンドポイントのリストはどこにありますか?

完全なAPIエンドポイントのリストは、IronSecureDocウェブサイトのREST APIリファレンスにあります。

Curtis Chau
テクニカルライター

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

...
詳しく読む

準備はできましたか?

バージョン:2024.10リリースされたばかり

あなたの無料30日間の試用キーをすぐに入手。
クレジットカードやアカウントの作成は不要です。
Key in blue circle

無料の30日間トライアルキーをすぐに入手してください。

Your trial license will be sent to your email address

制限なし。100% ロック解除済み。クレジットカード不要。

bullet_checkedクレジットカードやアカウントの作成は不要です。制限なし。100% ロック解除済み。クレジットカード不要。
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
無料のライブデモを予約する
Booking Badge

世界中の数百万人のエンジニアから信頼されています。

ライセンスはより安く
義務のない相談を受ける
下記のフォームを記入するか、sales@ironsoftware.comにメールしてください。
あなたの詳細は常に守秘されます。
世界中の数百万人のエンジニアから信頼されています。
ライセンスはより安く
あなたの無料30日間の試用キーをすぐに入手。
クレジットカードやアカウントの作成は不要です。