Nextcloud Docker镜像

!Nextcloud Logo

![Docker Repository on Quay]([***]

用于Nextcloud（OwnCloud的社区分支）的易用Docker镜像。

核心功能

• 使用最新稳定版Alpine Linux，集成PHP 7和NGinx
• 构建过程中进行GPG校验
• 已配置APCu
• 支持LDAP
• 每15分钟运行Cron（无需Web或AJAX Cron）
• 数据、配置和应用的持久化存储
• Nextcloud包含的持久化应用在启动时自动更新
• 支持MySQL/MariaDB和PostgreSQL（数据库服务器需单独提供）
• 支持最大10GB文件上传
• 镜像也可通过Quay.io获取
• 新增！ 多架构支持（x86、amd64、armv6、armv7、arm64、ppc64le、s390x）

容器环境

包含软件

• Alpine Linux
• PHP 7
• APCu
• NGinx
• cron
• SupervisorD

所有组件均为最新稳定版本。

标签说明

• latest: 最新稳定版Nextcloud（PHP 7）
• X.X.X: Nextcloud稳定版本标签（如v9.0.52，版本≥12.0.0使用PHP 7）
• develop: 最新开发分支（可能不稳定）
• TAG-ARCHITECTURE（示例：develop-arm64）: 指定处理器架构的标签

构建时参数

• NEXTCLOUD_GPG: Nextcloud签名密钥指纹
• NEXTCLOUD_VERSION: 要安装的Nextcloud版本
• UID: nextcloud用户ID（默认1501）
• GID: nextcloud组ID（默认1501）

暴露端口

• 80: 运行Nextcloud的NGinx Web服务器

数据卷

• /data : 所有数据，包括配置和用户下载的应用（位于子文件夹中）

使用方法

独立运行

可在不使用单独数据库的情况下运行Nextcloud，但不建议生产环境使用（因使用SQLite）。也可使用外部数据库，在安装向导中输入凭据。

1. 拉取镜像：docker pull rootlogin/nextcloud
2. 运行容器：docker run -d --name nextcloud -p 80:80 -v 本地数据文件夹:/data rootlogin/nextcloud（将本地数据文件夹替换为存储持久化数据的路径）
3. 打开localhost即可使用！

首次运行时，可通过Nextcloud设置向导完成安装，之后将直接启动。

配合数据库容器

标准部署建议使用MariaDB（比SQLite更可靠），可使用***MariaDB Docker镜像。

bash
# 拉取镜像
docker pull rootlogin/nextcloud && docker pull mariadb:10

# 启动数据库容器
docker run -d --name nextcloud_db \
  -v 数据库持久化文件夹:/var/lib/mysql \
  -e MYSQL_ROOT_PASSWORD=超级密码 \
  -e MYSQL_DATABASE=nextcloud \
  -e MYSQL_USER=nextcloud \
  -e MYSQL_PASSWORD=数据库密码 \
  mariadb:10

# 启动Nextcloud容器（链接数据库）
docker run -d --name nextcloud \
  --link nextcloud_db:nextcloud_db \
  -p 80:80 \
  -v 本地数据文件夹:/data \
  rootlogin/nextcloud

数据库与Nextcloud的自动连接尚未实现，需手动配置。

配置说明

可通过occ命令配置Nextcloud：

bash
docker exec -ti nextcloud occ [...命令...]

该命令使用与Web服务器相同的用户权限。

其他说明

从OwnCloud迁移

可轻松将现有OwnCloud实例迁移到此Nextcloud Docker镜像。

迁移前务必备份旧OwnCloud实例！

1. 在旧OwnCloud实例启用维护模式：sudo -u www-data ./occ maintenance:mode --on
2. 创建新文件夹（如/var/my_nextcloud_data）
3. 在新文件夹中创建"config"子文件夹，复制旧实例的config.php到其中
4. 将旧实例的"data"文件夹复制到*/var/my_nextcloud_data/data*
5. 启动容器：docker run -d --name nextcloud -p 80:80 -v /var/my_nextcloud_data:/data rootlogin/nextcloud
6. 等待容器启动完成
7. 执行迁移命令：docker exec nextcloud occ upgrade
8. 禁用维护模式：docker exec nextcloud occ maintenance:mode --off
9. 完成迁移！

使用systemd运行容器

可通过systemd管理容器，配置示例：

ini
[Unit]
Description=Docker - Nextcloud容器
Requires=docker.service
After=docker.service

[Service]
Restart=always
ExecStart=/usr/bin/docker run -p 127.0.0.1:8000:80 -v /data/nextcloud:/data --name nextcloud rootlogin/nextcloud
ExecStop=/usr/bin/docker stop -t 2 nextcloud ; /usr/bin/docker rm -f nextcloud

[Install]
WantedBy=default.target

NGinx前端代理

此容器不直接支持SSL，建议使用前端代理（如另一NGinx）。配置示例：

nginx
server {
    listen 80;
    server_name cloud.example.net;

    # Let's Encrypt ACME验证
    location /.well-known/acme-challenge {
        alias /var/www/letsencrypt/;
        default_type "text/plain";
        try_files $uri =404;
    }

    location / {
        return 301 [***]
    }
}

server {
    listen 443 ssl spdy;
    server_name cloud.example.net;

    ssl_certificate /etc/letsencrypt.sh/certs/cloud.example.net/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt.sh/certs/cloud.example.net/privkey.pem;
    ssl_trusted_certificate /etc/letsencrypt.sh/certs/cloud.example.net/chain.pem;
    ssl_dhparam /etc/nginx/dhparam.pem;
    ssl_protocols TLSv1 TLSv1.1 TLSv1.2;

    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 30m;

    ssl_prefer_server_ciphers on;
    ssl_ciphers "ECDHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES256-SHA:ECDHE-RSA-AES128-SHA:DHE-RSA-AES256-SHA256:DHE-RSA-AES128-SHA256:DHE-RSA-AES256-SHA:DHE-RSA-AES128-SHA:ECDHE-RSA-DES-CBC3-SHA:EDH-RSA-DES-CBC3-SHA:AES256-GCM-SHA384:AES128-GCM-SHA256:AES256-SHA256:AES128-SHA256:AES256-SHA:AES128-SHA:DES-CBC3-SHA:HIGH:!aNULL:!eNULL:!EXPORT:!DES:!MD5:!PSK:!RC4";

    ssl_stapling on;
    ssl_stapling_verify on;

    add_header Strict-Transport-Security "max-age=31536000";

    access_log  /var/log/nginx/docker-nextcloud_access.log;
    error_log   /var/log/nginx/docker-nextcloud_error.log;

    location / {
        proxy_buffers 16 4k;
        proxy_buffer_size 2k;

        proxy_read_timeout 300;
        proxy_connect_timeout 300;
        proxy_redirect     off;

        proxy_set_header   Host              $http_host;
        proxy_set_header   X-Real-IP         $remote_addr;
        proxy_set_header   X-Forwarded-For   $proxy_add_x_forwarded_for;
        proxy_set_header   X-Frame-Options   SAMEORIGIN;

        client_max_body_size 10G;

        proxy_pass [***]
    }
}

常见问题

为什么启动时间很长？

容器启动时会重置/data文件夹权限。若数据量大，此过程耗时较长，可避免权限问题。

覆盖配置

Nextcloud配置中的部分参数会被root/opt/nextcloud/config/docker.config.php文件覆盖。

用户/组ID修改

可通过构建参数修改用户ID和组ID：

bash
git clone [***] && cd docker-nextcloud
docker build -t rootlogin/nextcloud --build-arg UID=1000 --build-arg GID=1000 .
docker run -p 80:80 rootlogin/nextcloud

贡献

本项目基于GPL协议发布，欢迎提交PR改进。

***

若想支持本项目，可通过以下地址***：

*******: ***