nextcloud/all-in-one

⭐ 7,239 🍴 801 PHP📄 GNU Affero General Public License v3.0 GitHubで見る →

主な特徴

ワンコマンドでの完全なNextcloudスタックのデプロイ
ウェブベースの管理インターフェース（ポート8080）
自動TLS証明書管理（Let's Encrypt統合）
BorgBackupによる組み込みバックアップソリューション
すべてのコンテナの自動アップデート機能
マイクロサービスアーキテクチャによる高い拡張性
A+セキュリティレーティングを達成する堅牢なセキュリティ設定

リポジトリ解析: nextcloud/all-in-one

基本情報

リポジトリ名: nextcloud/all-in-one
主要言語: PHP
スター数: 7,239
フォーク数: 801
最終更新: 現在も活発に開発中
ライセンス: GNU Affero General Public License v3.0
トピックス: Nextcloud、Docker、オールインワン、自己ホスト型クラウド、コンテナ

概要

一言で言うと

NextcloudのDockerベースの公式インストール方法で、必要なすべてのサービスを含む完全パッケージを1つのコマンドでデプロイできるソリューション。

詳細説明

Nextcloud All-in-One（AIO）は、Nextcloudの公式インストール方法として開発された、すべての主要機能を含むオールインワンソリューションです。従来の複雑なNextcloudのセットアップを簡素化し、データベース、キャッシュ、ウェブサーバー、およびオプションの追加機能をすべて事前設定済みのDockerコンテナとして提供します。

マスターコンテナがすべての他のコンテナを管理し、ウェブベースの管理インターフェースを通じて、アップデート、バックアップ、サービスの有効化/無効化などの管理タスクを簡単に実行できます。企業グレードのセキュリティとパフォーマンス最適化が標準で組み込まれており、個人から中規模組織まで幅広いユースケースに対応します。

主な特徴

ワンコマンドでの完全なNextcloudスタックのデプロイ
ウェブベースの管理インターフェース（ポート8080）
自動TLS証明書管理（Let's Encrypt統合）
BorgBackupによる組み込みバックアップソリューション
すべてのコンテナの自動アップデート機能
マイクロサービスアーキテクチャによる高い拡張性
A+セキュリティレーティングを達成する堅牢なセキュリティ設定

使用方法

インストール

前提条件

標準インストール

Docker（最新版）
64ビットLinuxシステム
最小2GB RAM（推奨4GB以上）
インターネット接続（Let's Encrypt証明書取得用）

Docker Compose版

Docker
Docker Compose

インストール手順

# 方法1: 標準Dockerインストール（推奨）
sudo docker run \
--init \
--sig-proxy=false \
--name nextcloud-aio-mastercontainer \
--restart always \
--publish 80:80 \
--publish 8080:8080 \
--publish 8443:8443 \
--volume nextcloud_aio_mastercontainer:/mnt/docker-aio-config \
--volume /var/run/docker.sock:/var/run/docker.sock:ro \
ghcr.io/nextcloud-releases/all-in-one:latest

# 方法2: Docker Composeによるデプロイ
git clone https://github.com/nextcloud/all-in-one.git
cd all-in-one
docker compose up -d

基本的な使い方

Hello World相当の例

# AIOマスターコンテナを起動後
# ブラウザで https://your-domain:8080 にアクセス
# 初期設定ウィザードに従って設定を完了
# Nextcloudインスタンスが https://your-domain で利用可能に

実践的な使用例

# リバースプロキシ背後での設定例（Apache）
<VirtualHost *:443>
    ServerName your-domain.com
    
    SSLEngine on
    SSLCertificateFile /path/to/cert.pem
    SSLCertificateKeyFile /path/to/key.pem
    
    # Nextcloud AIOプロキシ設定
    ProxyPreserveHost On
    ProxyPass / http://localhost:11000/
    ProxyPassReverse / http://localhost:11000/
    
    # WebSocket対応（Collabora/Talk用）
    RewriteEngine On
    RewriteCond %{HTTP:Upgrade} websocket [NC]
    RewriteCond %{HTTP:Connection} upgrade [NC]
    RewriteRule ^/?(.*) "ws://localhost:11000/$1" [P,L]
</VirtualHost>

高度な使い方

# カスタムデータディレクトリの指定
docker run ... \
-e NEXTCLOUD_DATADIR="/mnt/external-storage/nextcloud" \
ghcr.io/nextcloud-releases/all-in-one:latest

# 追加のバックアップディレクトリ設定
docker run ... \
-e NEXTCLOUD_ADDITIONAL_BACKUP_DIRECTORIES="/mnt/important-data" \
ghcr.io/nextcloud-releases/all-in-one:latest

# GPUアクセラレーション有効化（AIアプリ用）
docker run ... \
--gpus all \
ghcr.io/nextcloud-releases/all-in-one:latest

ドキュメント・リソース

公式ドキュメント

README.md: プロジェクト概要とクイックスタートガイド
reverse-proxy.md: 様々なリバースプロキシの設定方法
local-instance.md: ローカル環境でのセットアップ手順
docker-rootless.md: Rootlessモードでの実行方法
migration.md: 既存Nextcloudからの移行ガイド

サンプル・デモ

compose.yaml: Docker Compose設定例
manual-install/sample.conf: 手動インストール用設定テンプレート
tests/QA/: 品質保証テストシナリオ集

チュートリアル・ガイド

初期セットアップガイド（tests/QA/001-initial-setup.md）
バックアップとリストア手順（tests/QA/020-backup-and-restore.md）
オプションアドオンの設定（tests/QA/050-optional-addons.md）

技術的詳細

アーキテクチャ

全体構造

マスターコンテナが中心となり、他のすべてのサービスコンテナを管理するマイクロサービスアーキテクチャを採用。各サービスは独立したコンテナとして動作し、内部Dockerネットワークで通信。

ディレクトリ構成

all-in-one/
├── Containers/              # 各サービスのDockerfile定義
│   ├── mastercontainer/     # 管理用マスターコンテナ
│   ├── nextcloud/           # Nextcloudアプリケーション本体
│   ├── apache/              # リバースプロキシ（HTTP/2,HTTP/3対応）
│   ├── postgresql/          # データベース
│   ├── redis/               # キャッシュとファイルロック
│   ├── borgbackup/          # バックアップシステム
│   └── [optional services]  # オプションサービス群
├── php/                     # マスターコンテナのPHPアプリケーション
├── community-containers/    # コミュニティ提供の追加コンテナ
└── manual-install/          # 手動インストール用リソース

主要コンポーネント

マスターコンテナ: PHP 8.4 + Caddy、全コンテナ管理とWebUI提供
- 場所: Containers/mastercontainer/
- 依存: Docker API
- インターフェース: Web管理画面（ポート8080）
Apacheコンテナ: HTTP/2,HTTP/3対応のリバースプロキシ
- 場所: Containers/apache/
- 依存: Nextcloudコンテナ
- インターフェース: HTTP/HTTPS（ポート80/443）
PostgreSQLコンテナ: メインデータベース
- 場所: Containers/postgresql/
- 依存: なし
- インターフェース: PostgreSQL接続（内部ネットワークのみ）

技術スタック

コア技術

言語: PHP 8.4（Nextcloud本体）、Shell Script（管理スクリプト）
フレームワーク: Nextcloudフレームワーク
主要ライブラリ:
- Symfony Components: HTTPカーネル、ルーティング
- Doctrine DBAL: データベース抽象化レイヤー
- Sabre/DAV: WebDAV実装

開発・運用ツール

ビルドツール: Docker multi-stage builds
テスト: Playwright（E2Eテスト）、Psalm（静的解析）
CI/CD: GitHub Actions（自動テスト、リリース）
デプロイ: Docker、Docker Compose、Kubernetes（Helm）

設計パターン・手法

マイクロサービスアーキテクチャ
Supervisorによるプロセス管理
ヘルスチェックによる自己修復
ボリュームベースの永続化戦略
環境変数による設定の外部化

データフロー・処理フロー

ユーザーリクエスト → Apacheリバースプロキシ
静的ファイル配信またはPHP-FPMへのプロキシ
PHP-FPMでNextcloudアプリケーション実行
PostgreSQLへのデータ永続化
Redisによるセッション/キャッシュ管理
レスポンス生成 → ユーザーへ返却

API・インターフェース

公開API

Web管理インターフェース（ポート8080）

目的: コンテナ管理、設定変更、バックアップ管理
使用例:

https://your-domain:8080
# ログイン後、以下の操作が可能：
# - コンテナの起動/停止
# - オプションサービスの有効化/無効化
# - バックアップの設定と実行
# - ログの確認

設定・カスタマイズ

設定ファイル

# 環境変数による主要設定
NEXTCLOUD_DATADIR="/custom/data/path"         # データディレクトリ
NEXTCLOUD_UPLOAD_LIMIT="32G"                  # アップロード上限
NEXTCLOUD_MAX_TIME="7200"                     # 最大実行時間（秒）
NEXTCLOUD_MEMORY_LIMIT="1024M"                # PHPメモリ上限
APACHE_PORT="11000"                           # Apacheポート
NEXTCLOUD_STARTUP_APPS="deck twofactor_totp" # 初期インストールアプリ

拡張・プラグイン開発

コミュニティコンテナフレームワークを使用して追加サービスを統合可能。JSONファイルでコンテナ定義を記述し、AIOエコシステムに組み込む。

パフォーマンス・スケーラビリティ

パフォーマンス特性

PHP OPcacheとJIT有効化による高速実行
Redisによる効率的なキャッシング
Brotli圧縮による転送量削減
PostgreSQLの最適化された設定

スケーラビリティ

単一ノードでの垂直スケーリングに最適化。水平スケーリングが必要な場合は手動インストールを推奨。

制限事項

単一ホストでの動作に限定
Docker Socketアクセスが必要（セキュリティ考慮事項）
最小2GB RAM必要

評価・所感

技術的評価

強み

包括的なオールインワンソリューション
優れたドキュメントとサポート
エンタープライズグレードのセキュリティ設定
自動化された管理タスク
活発な開発とメンテナンス

改善の余地

マルチノードクラスタリング未対応
Docker依存による制約
初期セットアップ時のリソース使用量

向いている用途

個人・家庭用のプライベートクラウド
中小規模組織のファイル共有・コラボレーション
開発・テスト環境
セルフホスティング愛好家

向いていない用途

大規模エンタープライズ環境（数千ユーザー以上）
マルチノードが必須の高可用性要件
リソース制約の厳しい環境

総評

Nextcloud All-in-Oneは、複雑なNextcloudスタックを驚くほどシンプルにデプロイできる優れたソリューションです。セキュリティ、パフォーマンス、管理性のバランスが取れており、メンテナンスの手間を最小限に抑えながら、フル機能のクラウドストレージソリューションを提供します。特に自己ホスティングを始めたい個人や、ITリソースが限られた組織にとって理想的な選択肢です。