schleyk/nextcloud

schleyk/nextcloud 镜像文档

镜像概述与主要用途

schleyk/nextcloud是一个基于Alpine Linux 3.18的Docker镜像，用于部署Nextcloud——最广泛使用的本地文件共享和协作平台。该镜像集成nginx和PHP 8.2/8.3环境，支持Nextcloud 27/28/29版本，提供自动安装、数据持久化、安全配置及丰富扩展支持，适合个人或企业快速搭建私有云存储与协作系统。

核心功能与特性

• 支持Nextcloud 27/28/29版本
• 基于Alpine Linux 3.18，集成nginx和PHP 8.2/8.3（schleyk/nginx-php基础镜像）
• 通过环境变量实现自动安装
• 构建过程中验证包完整性（SHA512）和真实性（PGP）
• 数据与应用持久化存储
• 已配置OPCache、APCu（本地缓存）
• 运行系统定时任务（cron）
• 支持MySQL、PostgreSQL（需外部服务器）和sqlite3数据库
• 支持OnlyOffice、Nextcloud Office（Collabora Online，需外部服务器）
• 支持ClamAV杀毒（需外部服务）、Redis、FTP、SMB、LDAP(s)、IMAP、SMTP
• 包含GNU Libiconv，解决部分应用的php iconv扩展错误
• 完全无root进程，提升安全性
• 提供丰富环境变量配置（详见下文）

安全提示：即使使用最新版本Nextcloud，也应定期更新容器以保障安全。

构建时变量

• NEXTCLOUD_VERSION：Nextcloud版本号
• GPG_nextcloud：签名密钥指纹

环境变量

端口说明

• 8888：HTTP访问端口

卷挂载说明

数据库配置

推荐使用外部数据库容器（如MariaDB），可通过Docker Hub官方mariadb镜像创建，并与Nextcloud容器链接。支持MySQL、PostgreSQL（需外部服务器）和sqlite3，其中sqlite3适合测试，生产环境建议使用MariaDB/MySQL。

部署与使用方法

基本部署步骤

1. 创建容器（示例使用外部卷确保数据持久化，/docker为宿主机目录示例）：

   bash
   docker run -d \
     --name nextcloud \
     -p 8888:8888 \
     -e UID=1000 \
     -e GID=1000 \
     -e ADMIN_USER=admin \
     -e ADMIN_PASSWORD=StrongPass123 \
     -e DOMAIN=cloud.example.com \
     -e DB_TYPE=mysql \
     -e DB_NAME=nextcloud \
     -e DB_USER=ncuser \
     -e DB_PASSWORD=dbpass \
     -e DB_HOST=mariadb \
     -v /docker/nextcloud/data:/data \
     -v /docker/nextcloud/config:/config \
     -v /docker/nextcloud/apps2:/apps2 \
     --link mariadb:mariadb \
     schleyk/nextcloud
   

2. 反向代理配置：需通过反向代理（如Nginx）暴露服务至互联网，具体配置参考官方文档。

3. 若未设置ADMIN_USER和ADMIN_PASSWORD，可通过浏览器访问完成管理员账户配置。

系统配置建议

• 在管理面板中，将定时任务从"AJAX cron"切换为"cron"（系统定时任务）以提升性能。

更新方法

1. 拉取新版本镜像：docker pull schleyk/nextcloud
2. 按部署步骤重新创建容器（使用相同卷挂载），数据不会丢失
3. 若Nextcloud执行完整升级，应用可能被禁用，需重新启用（12.0.x及以上版本自动启用）

Redis缓存配置

Redis可提升性能，配置步骤：

1. 部署Redis服务器（如通过Docker容器）
2. 在config.php中添加：

   php
   'memcache.distributed' => '\OC\Memcache\Redis',
   'memcache.locking' => '\OC\Memcache\Redis',
   'memcache.local' => '\OC\Memcache\APCu',
   'redis' => array(
     'host' => 'redis',  // Redis容器名称/IP
     'port' => 6379,     // Redis端口
   ),
   

Nextant配置

1. 部署Solr服务器（可通过docker-compose集成）
2. 安装Nextant应用后，在管理面板"附加设置"中设置Solr地址：http://solr:8983/solr

occ命令使用

通过容器脚本快速执行occ命令：

bash
docker-compose exec nextcloud occ [command]
# 示例：查看状态
docker-compose exec nextcloud occ status

安全提示

出于安全考虑，即使使用最新版本Nextcloud，也应定期更新容器以修复基础镜像安全漏洞。