透過使用憑證執行容器在 C# 中使用 HTTPS

Curtis Chau
Curtis Chau
已更新: 2026年8月2日

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

使用憑證運行 IronSecureDoc 容器

  1. 生成證書:

    # Generates a new HTTPS certificate for use with ASP.NET Core.
    # Saves the certificate at the specified path and protects it with a password.
    dotnet dev-certs https -ep %USERPROFILE%\.aspnet\https\ironsecuredoc.pfx -p <CREDENTIAL_PLACEHOLDER>
    
    # Trusts the generated certificate on your local machine.
    dotnet dev-certs https --trust
    SHELL

    將<CREDENTIAL_PLACEHOLDER>替換為密碼。

  2. 運行Docker容器:

    # Runs the IronSecureDoc Docker container with both HTTP and HTTPS ports exposed.
    docker container run -d \
      -p 8081:8081 -p 8080:8080 \ # Maps container ports to host ports for HTTP and HTTPS.
      -e HTTP_PORTS=8080 \ # Sets the HTTP port for the application.
      -e HTTPS_PORTS=8081 \ # Sets the HTTPS port for the application.
      -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> \ # Provides the IronSecureDoc license key.
      -e ENVIRONMENT=Production \ # Configures the environment as Production.
      -v %USERPROFILE%\.aspnet\https:/https:ro \ # Mounts the directory to the container as read-only.
      -e CERTIFICATE_PATH=%USERPROFILE%\.aspnet\https\ironsecuredoc.pfx \ # Specifies the path to the certificate in the container.
      -e CERTIFICATE_PASSWORD=<CERTIFICATE_PASSWORD> \ # Password for the certificate.
      ironsoftwareofficial/ironsecuredoc:latest # Specifies the Docker image to use.
    SHELL

    將<IRONSECUREDOC_LICENSE_KEY>和<CERTIFICATE_PASSWORD>分別替換為您的實際IronSecureDoc授權金鑰和憑證密碼。

常見問題

我如何為 IronSecureDoc 生成新的 HTTPS 憑證?

您可以使用 dotnet dev-certs https -ep 命令來生成新的 HTTPS 憑證以與 ASP.NET Core 一起使用,並將其儲存在指定路徑中,同時用密碼保護。

如何在我的本機電腦上信任生成的 HTTPS 憑證?

要在您的本機電腦上信任生成的憑證,請使用命令 dotnet dev-certs https --trust。

運行 IronSecureDoc Docker 容器需要哪些步驟?

要運行 IronSecureDoc Docker 容器,您需要將容器端口映射到 HTTP 和 HTTPS 的主機端口,設置環境變量(包括 IronSecureDoc_LicenseKey),並將 HTTPS 憑證的目錄掛載為只讀。

哪個環境變量用於設置 IronSecureDoc 應用程式的 HTTPS 端口?

環境變量 HTTPS_PORTS 用於設置 IronSecureDoc 應用程式的 HTTPS 端口。

為什麼我需要在 Docker 容器中添加 HTTPS 憑證的路徑?

在 Docker 容器中添加由 CERTIFICATE_PATH 指定的 HTTPS 憑證路徑,確保容器可以訪問憑證以進行安全通信。

IronSecureDoc 設置命令中我應該替換什麼?

在設置命令中,將 <CREDENTIAL_PLACEHOLDER>、<IRONSECUREDOC_LICENSE_KEY> 和 <CERTIFICATE_PASSWORD> 替換為您的實際憑證和密碼資訊。

我應該使用什麼 Docker 映像來部署 IronSecureDoc?

您應該使用 Docker 映像 ironsoftwareofficial/IronSecureDoc:latest 來部署 IronSecureDoc。

我如何將 IronSecureDoc 的環境配置為生產?

設置環境變量 ENVIRONMENT=Production 以將 IronSecureDoc 應用程式配置為生產環境。

Curtis Chau 擁有卡爾頓大學計算機科學學士學位,專注於前端開發,擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面,喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

閱讀更多

準備好開始了嗎?

版本:2024.10剛剛發布