Nextcloud Docker Compose（開發者使用指南）

Nextcloud 的功能

Nextcloud Docker 提供便利的部署和管理功能，其主要功能如下：

*簡化設定：*由於 Docker 能夠將所有依賴項（例如 PHP 和 Web 伺服器）打包在一個容器中，因此安裝非常簡便，從而簡化了安裝和設定過程。 可攜性： Docker 容器可以在不同的環境和節點之間移植，從而防止在伺服器或雲端環境之間移動 Nextcloud 實例時出現相容性問題。 隔離：容器與主機系統和其他容器隔離，確保依賴關係和配置不會與同一台機器上的其他服務發生衝突。 可擴充性：利用 Docker Compose，您可以輕鬆擴展 Nextcloud，透過部署額外的容器來提供資料庫、快取或負載平衡服務，從而在大規模環境中實現卓越的效能。 持久儲存：透過將儲存磁碟區掛載到容器外部，即使容器重新啟動或升級後，資料也能保留。 輕鬆升級：**透過 Docker 拉取新的映像版本並重新啟動容器，即可無縫升級 Nextcloud 或其相依性； 無需進行複雜的遷移。 *安全性： Docker 固有的隔離性將 Nextcloud 的環境與其主機和其他應用程式隔離開來，從而最大限度地減少了攻擊面。

Nextcloud Docker 的所有這些功能使其成為託管私有雲基礎架構的高效解決方案。

先決條件

• 支援 WSL 2 的 Windows 10/11（專業版、企業版或教育版）。
• Docker Desktop 已安裝並運作在 Windows 系統上。
• 具備使用終端機或命令提示字元的基本知識。

拉取 Nextcloud Docker 映像

從 Docker Hub 拉取官方 Nextcloud Docker 映像，方法是在終端機中執行以下命令：

docker pull nextcloud

docker pull nextcloud

或者，打開 Docker 應用程序，在搜尋框中搜尋"nextcloud"。

若要執行 Nextcloud 安裝程序，請在命令提示字元中使用下列命令：

docker run -d -p 8080:80 nextcloud

docker run -d -p 8080:80 nextcloud

此命令將下載 Nextcloud 映像並建立一個新容器，將其暴露在 8080 連接埠上。

為資料庫設定 MariaDB

Nextcloud 需要資料庫來儲存資料。 我們可以使用 MariaDB 作為 MySQL 的直接替代品。

首先，拉取 MariaDB 鏡像：

docker pull mariadb

docker pull mariadb

使用以下命令建立 MariaDB 容器：

docker run -d \
  --name nextcloud-db \
  -e MYSQL_ROOT_PASSWORD=your_root_password \
  -e MYSQL_DATABASE=nextcloud \
  -e MYSQL_USER=nextcloud_user \
  -e MYSQL_PASSWORD=your_password \
  mariadb

docker run -d \
  --name nextcloud-db \
  -e MYSQL_ROOT_PASSWORD=your_root_password \
  -e MYSQL_DATABASE=nextcloud \
  -e MYSQL_USER=nextcloud_user \
  -e MYSQL_PASSWORD=your_password \
  mariadb

請將your_root_password和your_password替換為您選擇的強密碼。此指令會建立一個名為nextcloud-db的 MariaDB 容器，其中包含一個名為nextcloud資料庫和一個名為nextcloud_user使用者。

Nextcloud Web介面

開啟網頁瀏覽器，輸入 Nextcloud 主機伺服器的 IP 位址或域名，即可造訪 Nextcloud 安裝。 本地安裝請使用：

http://localhost:8080/

設定管理員帳戶

進入設定頁面後，建立一個管理員使用者。 如有需要，也可以使用 Nextcloud CLI 來管理設定和設定。

輸入所需資訊後，設定資料庫連線：

1. 資料庫主機：對於本機資料庫，請使用localhost如果使用 Docker，請使用資料庫容器名稱（例如， nextcloud-db ）。
2. 資料庫使用者名稱和密碼：在 MariaDB 設定過程中提供。
3. 資料庫名稱：本例中為nextcloud 。

填寫所有必要信息，然後點擊"完成設定"以完成安裝。

安裝並執行 IronSecureDoc

使用以下指令拉取 IronSecureDoc Docker 映像：

docker pull ironsoftwareofficial/ironsecuredoc

docker pull ironsoftwareofficial/ironsecuredoc

若要執行 IronSecureDoc 容器，請使用：

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

代替<IRONSECUREDOC_LICENSE_KEY>使用您的實際許可證密鑰。 此命令啟動 IronSecureDoc 容器，並將其暴露在 8080 連接埠上。

將 IronSecureDoc 與 Docker 容器結合使用

安裝完成後，可以透過其 REST API 存取 IronSecureDoc。 文件和 API 端點可在http://localhost:8080/swagger/index.html找到。

若要提交文件進行加密，請使用curl傳送 POST 請求：

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/encrypt?user_password=demo' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf'

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/encrypt?user_password=demo' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf'

這會將文件轉送給 IronSecureDoc，並套用對應的加密。