本站支持搜索的镜像仓库:Docker Hub、gcr.io、ghcr.io、quay.io、k8s.gcr.io、registry.gcr.io、elastic.co、mcr.microsoft.com
Nextcloud 是一款开源的私有云存储与协作平台,允许用户在自选服务器(家庭、数据中心或服务提供商)上存储、同步和共享文件,并通过桌面或移动设备访问。本镜像是由 LinuxServer.io 团队构建的容器化版本,提供便捷的部署和管理方式。
通过Docker Manifest实现多平台支持,拉取 lscr.io/linuxserver/nextcloud:latest 即可自动匹配对应架构,也可通过标签指定:
| 架构 | 支持状态 | 标签格式 |
|---|---|---|
| x86-64 | ✅ | amd64-<version tag> |
| arm64 | ✅ | arm64v8-<version tag> |
| 标签 | 支持状态 | 描述 |
|---|---|---|
| latest | ✅ | Nextcloud稳定版发布 |
| develop | ✅ | Nextcloud测试版(仅预发布版本) |
| previous | ✅ | 上一个主要版本的稳定发布 |
通过 https://<your-ip>:443 访问Web界面,初始配置参考 Nextcloud官方文档。
容器内运行Nextcloud命令行工具(occ)无需前缀,直接执行:
docker exec -it nextcloud occ maintenance:mode --off
/config和/data卷会保留数据,启动脚本自动检测版本差异并触发升级)需修改 config/www/nextcloud/config/config.php 添加以下配置:
'enable_previews' => true, 'enabledPreviewProviders' => [ 'OC\Preview\PNG', 'OC\Preview\JPEG', 'OC\Preview\GIF', 'OC\Preview\BMP', 'OC\Preview\XBitmap', 'OC\Preview\MP3', 'OC\Preview\TXT', 'OC\Preview\MarkDown', 'OC\Preview\OpenDocument', 'OC\Preview\Krita', 'OC\Preview\HEIC', ],
修改后需重新登录生效(Nextcloud默认禁用HEIC预览以避免性能或隐私问题,启用需自行评估风险)。
若使用自定义应用目录,需通过卷挂载暴露目录:
volumes: - /path/to/your_custom_apps_folder:/app/www/public/your_custom_apps_folder
然后在 config.php 中设置:
"path" => OC::$SERVERROOT . "/your_custom_apps_folder",
镜像默认使用自签名证书(协议为https),若反向代理验证证书,需禁用容器证书检查。
--- services: nextcloud: image: lscr.io/linuxserver/nextcloud:latest container_name: nextcloud environment: - PUID=1000 # 容器内用户ID(需与宿主机目录权限匹配) - PGID=1000 # 容器内组ID - TZ=Etc/UTC # 时区(如Asia/Shanghai) volumes: - /path/to/nextcloud/config:/config # 配置文件存储 - /path/to/data:/data # 用户数据存储 ports: - 443:443 # Web访问端口(宿主机:容器) restart: unless-stopped
docker run -d \ --name=nextcloud \ -e PUID=1000 \ -e PGID=1000 \ -e TZ=Etc/UTC \ -p 443:443 \ -v /path/to/nextcloud/config:/config \ -v /path/to/data:/data \ --restart unless-stopped \ lscr.io/linuxserver/nextcloud:latest
| 参数 | 功能描述 |
|---|---|
-p 443:443 | WebUI访问端口映射(宿主机端口:容器端口) |
-e PUID=1000 | 容器内用户ID,用于权限映射(通过id your_user命令获取宿主机用户ID) |
-e PGID=1000 | 容器内组ID,同上 |
-e TZ=Etc/UTC | 容器时区,如Asia/Shanghai(完整列表见时区数据库) |
-v /config | 持久化配置文件存储路径 |
-v /data | 用户数据存储路径 |
通过 FILE__ 前缀可从文件加载环境变量,例如:
-e FILE__MYVAR=/run/secrets/mysecretvariable
容器会将 /run/secrets/mysecretvariable 文件内容作为 MYVAR 环境变量的值。
通过 -e UMASK=022 可覆盖容器内服务的默认umask值(注意:umask是权限掩码,并非直接设置权限,具体参考umask说明)。
卷挂载时,宿主机目录权限需与容器内用户权限匹配,避免权限问题。通过以下命令获取宿主机用户的PUID/PGID:
id your_user
示例输出:
uid=1000(your_user) gid=1000(your_user) groups=1000(your_user)
其中 uid=1000 为PUID,gid=1000 为PGID。
可通过Docker Mods扩展容器功能:
docker exec -it nextcloud /bin/bash
docker logs -f nextcloud
docker inspect -f '{{ index .Config.Labels "build_version" }}' nextcloud
docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/nextcloud:latest
# 更新镜像 docker-compose pull nextcloud # 重启容器 docker-compose up -d nextcloud # 清理旧镜像 docker image prune
# 更新镜像 docker pull lscr.io/linuxserver/nextcloud:latest # 停止并删除旧容器 docker stop nextcloud && docker rm nextcloud # 重新创建容器(保留卷数据) docker run -d [原参数...] lscr.io/linuxserver/nextcloud:latest # 清理旧镜像 docker image prune
推荐使用 Diun 接收更新通知,不建议使用自动更新容器的工具。
如需自定义镜像:
git clone [***] cd docker-nextcloud docker build \ --no-cache \ --pull \ -t lscr.io/linuxserver/nextcloud:latest .
跨架构构建(如x86_64构建ARM镜像)需先注册qemu-static:
docker run --rm --privileged lscr.io/linuxserver/qemu-static --reset
然后使用对应架构的Dockerfile(如 -f Dockerfile.aarch64)。
previous标签用于上一主版本config.php启用HEIC预览)site-confs/default.conf)site-confs/default.conf)/config/nginx/site-confs/default.conf)noindex, nofollowsite-confs/default.conf),修复LDAP连接php8测试标签site-confs/default.conf)site-confs/default.conf)site-confs/default.conf)site-confs/default.conf)site-confs/default.conf)site-confs/default.conf)免费版仅支持 Docker Hub 加速,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
免费版仅支持 docker.io;专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录方式配置轩辕镜像加速服务,包含7个详细步骤
在 Linux 系统上配置轩辕镜像源,支持主流发行版
在 Docker Desktop 中配置轩辕镜像加速,适用于桌面系统
在 Docker Compose 中使用轩辕镜像加速,支持容器编排
在 k8s 中配置 containerd 使用轩辕镜像加速
在宝塔面板中配置轩辕镜像加速,提升服务器管理效率
在 Synology 群晖NAS系统中配置轩辕镜像加速
在飞牛fnOS系统中配置轩辕镜像加速
在极空间NAS中配置轩辕镜像加速
在爱快ikuai系统中配置轩辕镜像加速
在绿联NAS系统中配置轩辕镜像加速
在威联通NAS系统中配置轩辕镜像加速
在 Podman 中配置轩辕镜像加速,支持多系统
配置轩辕镜像加速9大主流镜像仓库,包含详细配置步骤
无需登录即可使用轩辕镜像加速服务,更加便捷高效
需要其他帮助?请查看我们的 常见问题 或 官方QQ群: 13763429