martmaiste/nextcloud

Nextcloud Docker（基于php-fpm、Nginx反向代理，支持SSL和Let's Encrypt）

镜像概述

本Nextcloud Docker镜像采用php-fpm与Nginx反向代理架构，内置SSL支持及Let's Encrypt证书生成工具。默认使用SQLite数据库，可通过配置切换至外部MySQL或PostgreSQL数据库。安装时自动生成自签名SSL证书，后续可通过内置工具替换为Let's Encrypt证书。

核心功能与特性

• 架构设计：采用php-fpm处理PHP请求，Nginx作为反向代理，提升性能与稳定性
• 安全支持：内置SSL加密，支持自签名证书及Let's Encrypt证书生成与续期
• 数据库灵活性：默认使用SQLite，可配置外部MySQL或PostgreSQL数据库
• 数据持久化：支持通过卷挂载实现数据、配置及应用的持久化存储
• 可定制化配置：通过环境变量调整上传大小、内存分配、定时任务周期等参数

使用场景与适用范围

适用于个人或企业搭建私有云存储服务，需满足以下需求：

• 安全的HTTPS访问
• 可定制的存储与数据库配置
• 简单的部署与维护流程
• 需要数据持久化与备份能力

详细使用方法

前置条件

• 已安装Docker及Docker Compose
• 具备外部存储卷（用于数据持久化）

步骤1：部署数据库（以MariaDB为例）

bash
docker run -d --name nextcloud-db \
       -v /mnt2/nextcloud-db:/var/lib/mysql \  # 挂载数据库存储卷
       -e MYSQL_RANDOM_ROOT_PASSWORD=yes \     # 自动生成随机root密码
       -e MYSQL_DATABASE=nextcloud \           # 创建Nextcloud数据库
       -e MYSQL_USER=nextcloud \               # 创建Nextcloud数据库用户
       -e MYSQL_PASSWORD=password \            # 数据库用户密码
       mariadb:10                              # 使用MariaDB 10镜像

注意：安装时会生成随机MySQL root密码并输出到日志中，建议记录。

步骤2：部署Nextcloud容器

bash
docker run -d --name nextcloud -p 80:8080 -p 443:8443 \  # 映射80/443端口
       --link nextcloud-db:nextcloud-db \                # 链接数据库容器
       -v /mnt2/nextcloud-data:/data \                  # 数据存储卷
       -v /mnt2/nextcloud-config:/config \              # 配置存储卷
       -v /mnt2/nextcloud-app:/apps2 \                  # 应用存储卷
       -e UID=1000 -e GID=1000 \                        # 运行用户ID/组ID
       -e UPLOAD_MAX_SIZE=10G \                         # 最大上传文件大小
       -e APC_SHM_SIZE=128M \                           # APC共享内存大小
       -e OPCACHE_MEM_SIZE=128 \                        # OPCache内存大小（MB）
       -e CRON_PERIOD=15m \                             # 定时任务周期（15分钟）
       -e DB_TYPE=mysql \                               # 数据库类型（mysql/postgresql/sqlite）
       -e DB_HOST=nextcloud-db \                        # 数据库主机
       -e DB_USER=nextcloud \                           # 数据库用户
       -e DB_PASSWORD=password \                        # 数据库密码
       -e TZ=Etc/UTC \                                  # 时区设置
       -e DOMAIN=localhost \                            # 域名（用于Let's Encrypt）
       -e EMAIL=hostmaster@localhost \                  # 邮箱（用于Let's Encrypt）
       martmaiste/nextcloud                             # 镜像名称

手动构建镜像

步骤1：克隆仓库

bash
git clone https://github.com/martmaiste/nextcloud.git

步骤2：构建镜像

bash
docker build -t nextcloud nextcloud

步骤3：运行构建的镜像

bash
docker run -d --name nextcloud -p 80:8080 -p 443:8443 \
       --link nextcloud-db:nextcloud-db \
       -v /mnt2/nextcloud-data:/data \
       -v /mnt2/nextcloud-config:/config \
       -v /mnt2/nextcloud-app:/apps2 \
       -e UID=1000 -e GID=1000 \
       -e UPLOAD_MAX_SIZE=10G \
       -e APC_SHM_SIZE=128M \
       -e OPCACHE_MEM_SIZE=128 \
       -e CRON_PERIOD=15m \
       -e DB_TYPE=mysql \
       -e DB_HOST=nextcloud-db \
       -e DB_USER=nextcloud \
       -e DB_PASSWORD=password \
       -e TZ=Etc/UTC \
       -e DOMAIN=localhost \
       -e EMAIL=hostmaster@localhost \
       -t nextcloud  # 使用本地构建的镜像

说明：DOMAIN和EMAIL主要用于后续生成Let's Encrypt证书，若不需要可移除。Nextcloud需通过80和443端口对外访问以完成Let's Encrypt验证（80端口用于域名验证）。

Let's Encrypt证书配置

生成Let's Encrypt证书

bash
docker exec -ti nextcloud letsencrypt-setup

手动续期证书

bash
docker exec -ti nextcloud letsencrypt-renew

参考与致谢

• https://github.com/Wonderfall/dockerfiles/tree/master/nextcloud/
• https://github.com/ngineered/nginx-php-fpm
• https://github.com/paulczar/omgwtfssl