dlandon/owncloud

镜像概述和主要用途

ownCloud Docker镜像提供通用文件访问功能，用户可通过Web、电脑或移动设备随时随地访问文件。该镜像内置Mariadb数据库，基于PHP 7.2、7.3、7.4，Mariadb 10.3和Nginx 1.15构建，初始安装版本为ownCloud X (10.8)。ownCloud官方网站

核心功能和特性

• 通用文件访问：支持通过Web、电脑及移动设备访问文件
• 内置数据库：集成Mariadb数据库，简化部署流程
• 稳定技术栈：基于PHP 7.2/7.3/7.4、Mariadb 10.3和Nginx 1.15构建
• 初始版本：默认安装ownCloud X (10.8)
• 配置灵活性：支持自定义证书及数据存储路径

使用场景和适用范围

适用于需要搭建私有云存储服务的个人用户或小型团队，用于文件同步、共享及远程访问，尤其适合对数据隐私有较高要求的场景。

使用方法和配置说明### 基本部署命令

bash
docker create \
--name=ownCloud \
-p 443:443 \
-v <配置文件路径>:/config \
-v <数据存储路径>:/data \
-e PGID=<组ID> \
-e PUID=<用户ID> \
-e TZ=<时区> \
-e DB_PASS=<数据库密码> \
--privileged \
owncloud

参数说明

参数分为两部分，用冒号分隔，左侧代表主机，右侧代表容器。例如端口映射 -p external:internal，表示将容器内部端口映射到主机外部端口。例如 -p 8080:80 会将容器内的80端口暴露到主机IP的8080端口，通过 http://192.168.x.x:8080 可访问容器内80端口运行的服务。

• -p 443 - 端口映射（容器内端口443）
• -v /config - ownCloud配置文件及数据库存储路径（主机路径需替换为实际路径）
• -v /data - ownCloud数据存储路径（主机路径需替换为实际路径）
• -e PGID - 组ID（详见下方用户/组ID说明）
• -e PUID - 用户ID（详见下方用户/组ID说明）
• -e TZ - 时区信息，例如 Europe/London（欧洲/伦敦）
• -e DB_PASS - ownCloud数据库密码（详见下方数据库密码说明）

该镜像基于移除SSH的phusion基础镜像构建，若需在容器运行时进行shell访问，可执行 docker exec -it ownCloud /bin/bash。

用户/组ID说明

使用数据卷（-v 参数）时，主机与容器可能出现权限问题。通过指定 PUID（用户ID）和 PGID（组ID），确保主机数据卷目录所有者与容器内一致，可避免权限问题。获取当前用户的ID可执行：

bash
$ id <用户名>
  uid=1001(用户名) gid=1001(组名) groups=1001(组名)

应用设置步骤

1. 初始Web界面配置：启动容器后，通过Web界面设置管理员用户名和密码
2. 数据文件夹设置：重要 - 需将数据文件夹路径修改为 /data
3. 数据库配置：重要 - 由于数据库内置在容器中，数据库主机为 localhost，数据库用户和数据库名均为 owncloud
4. 数据库密码：若未设置 DB_PASS 环境变量，数据库密码默认值为 owncloud
5. 自定义证书：重要 - 如需使用自定义证书，需将证书命名为 cert.key（私钥）和 cert.crt（证书），并放置在 config/keys 目录下

额外信息

• 容器运行时Shell访问：docker exec -it ownCloud /bin/bash
• 升级注意事项：通过Web界面升级ownCloud功能不可用，请勿尝试
• 实时日志监控：docker logs -f ownCloud