migoller/nextcloud

关于此Nextcloud自定义镜像

本文档介绍基于https://hub.docker.com/_/nextcloud/构建的自定义Docker镜像。特别感谢https://nextcloud.com/开发团队的杰出工作！

什么是Nextcloud？

为您所有数据提供安全的存储空间。从任何设备按您的方式访问和共享文件、日历、联系人、邮件等。

支持的标签

目前支持基于Apache的Nextcloud Docker镜像标签。

apache标签包含基础的Nextcloud安装及Apache Web服务器，设计为易于使用且能快速启动，也是latest标签和未指定具体类型的版本标签的默认选项。

您可选择以下不同功能版本：

• apache：在官方Nextcloud Apache镜像基础上，添加推荐的PHP设置及每15分钟运行Nextcloud cron.php的推荐定时任务
• imap：在apache镜像基础上增加IMAP认证功能
• smb：在apache镜像基础上增加SAMBA认证功能
• preview：在apache镜像基础上增加基于Imagik的图片和视频文件预览功能（不包含Libre Office）
• full：在apache镜像基础上整合imap、smb和preview的所有功能

如何使用此镜像

本镜像设计用于微服务环境。建议创建卷或挂载本地文件夹存储Nextcloud的数据、配置和应用，否则删除容器时将丢失数据和配置。关于如何使用docker-compose、docker run及systemd运行Docker容器，可参考https://github.com/MiGoller/dc-systemd-template。

使用docker run快速部署Nextcloud

apache镜像包含Web服务器并暴露80端口，启动容器命令如下：

console
$ docker run -d -p 8080:80 migoller/nextcloud

此时可通过http://localhost:8080/访问Nextcloud，但需连接现有MySQL服务器。

可在命令行挂载卷并设置环境变量：

console
$ docker run -it --name <container_name> \
       --link <your_MySql_containter>:db_nextcloud \
       -v <local_path_to_nextcloud_storage_folder>:/var/www/html/data \
       -v <local_path_to_nextcloud_config_folder>/config:/var/www/html/config \
       -v <local_path_to_nextcloud_config_folder>/apps:/var/www/html/custom_apps \
       -e NEXTCLOUD_ADMIN_USER=<your_nextcloud_admin_username> \
       -e NEXTCLOUD_ADMIN_PASSWORD=<your_nextcloud_admin_password> \
       -e MYSQL_DATABASE=<your_MySql_database_name> \
       -e MYSQL_USER=<your_MySql_username> \
       -e MYSQL_PASSWORD=<your_MySql_password> \
       -e MYSQL_HOST=db_nextcloud \
       -p 8080:80 \
       migoller/nextcloud

使用docker-compose构建Nextcloud栈

如前所述，apache镜像包含Apache Web服务器，但不含MySQL或MariaDB等数据库管理系统。可通过docker-compose轻松创建、部署和运行Nextcloud栈。docker-compose cli用于管理多容器应用，将docker run cli中的选项移至docker-compose.yml文件便于复用，详见https://docs.docker.com/compose/overview/。建议在`env-files`中声明环境变量以便复用。示例文件及更多详情见docker-compose示例，确保为容器设置不同密码。

创建自定义docker-compose.yml

首先需创建符合本地需求的docker-compose.yml，可基于示例文件修改：

yaml
version: '2'
services:
  db:
    image: docker.xuanyuan.run/mysql
    env_file:
      - MySQL.env
    volumes:
      - ./datadir:/var/lib/mysql
  app:
    image: docker.xuanyuan.run/migoller/nextcloud:apache
    env_file:
      - MySQL.env
      - Nextcloud.env
    volumes:
      - ./data:/var/www/html/data
      - ./config:/var/www/html/config
      - ./apps:/var/www/html/custom_apps
    depends_on:
      - db
    ports:
      - "8080:80"

调整卷的本地路径以适应系统，环境变量在env-files中定义，可在运行时供两个容器使用。

启动docker-compose管理的Nextcloud栈

在docker-compose.yml所在路径执行以下命令启动栈：

console
$ docker-compose up -d

停止docker-compose管理的栈

停止栈同样简单：

console
$ docker-compose down

添加功能

许多用户需要Nextcloud的额外功能。若镜像未包含所需包，可基于此镜像构建自己的镜像。以FROM语句开始派生镜像，添加所需内容：

yaml
FROM docker.xuanyuan.run/migoller/nextcloud

RUN ...

https://github.com/nextcloud/docker/blob/master/.examples提供了添加定时任务、smb支持或imap认证等功能的示例。更多详情见https://github.com/nextcloud/docker/blob/master/.examples/dockerfiles/full/apache/Dockerfile。

通过环境变量自动配置

Nextcloud镜像支持通过环境变量自动配置，可预配置首次运行安装页面的所有选项。启用自动配置需通过以下环境变量设置数据库连接，仅使用一种数据库类型！

官方Nextcloud环境变量

官方Nextcloud Docker镜像的环境变量列表见https://github.com/nextcloud/docker#auto-configuration-via-environment-variables。

Nextcloud管理员

• NEXTCLOUD_ADMIN_USER：设置Nextcloud管理员账户用户名
• NEXTCLOUD_ADMIN_PASSWORD：设置Nextcloud管理员账户的复杂密码

MySQL配置

• MYSQL_USER：设置运行时访问数据库的MySQL用户名
• MYSQL_PASSWORD：设置MYSQL_USER账户的复杂密码
• MYSQL_HOST：设置远程MySQL服务器的主机名
• MYSQL_DATABASE：设置Nextcloud数据库名称
• MYSQL_ROOT_USER：设置MySQL服务器root用户账户名（通常为"root"）
• MYSQL_ROOT_PASSWORD：设置MySQL的密码

额外环境变量

未来此自定义镜像将支持通过环境变量配置：

• 定时任务周期
• APCU调优
• OPCACHE调优

HTTPS - SSL加密

根据您的设置，有多种加密实现方式。推荐在Nextcloud前使用反向代理，如流行的https://github.com/jwilder/nginx-proxy和https://github.com/JrCs/docker-letsencrypt-nginx-proxy-companion容器，使用前请查阅相关文档。