主页 | GitHub仓库 | 问题跟踪

Pydio Cells Docker镜像文档

镜像概述和主要用途

Pydio Cells 是面向组织的下一代文件共享平台，是Pydio项目的完全重写版本，采用Go语言开发并遵循微服务架构。它提供企业级文件管理、共享和协作功能，支持自托管部署，适合需要安全可控文件共享解决方案的组织。

核心功能和特性

• 基于Go语言和微服务架构，性能高效且可扩展
• 自托管文件共享平台，保障数据安全性
• 支持与MySQL/MariaDB数据库集成
• 可通过Docker容器快速部署，支持持久化数据存储
• 提供Web界面进行配置和管理
• 支持Cells Sync桌面应用，实现文件同步

使用场景和适用范围

• 企业内部文件共享与协作
• 团队项目文件管理
• 需要自托管解决方案的组织
• 对数据安全和隐私有较高要求的环境
• 中小规模团队或企业的文件服务部署

详细使用方法和配置说明

作为独立容器运行

Pydio Cells需要MySQL/MariaDB数据库（需具有特权用户）。

启动测试实例

sh
docker run -d --network=host pydio/cells

在https://localhost:8080输入数据库凭据完成配置即可使用。如果服务器有公网IP且端口无限制（防火墙等），实例也可通过https://<您的服务器IP地址>:8080直接访问。

生产环境配置（持久化数据）

建议使用Docker卷配置持久化数据，并假设服务器已注册域名（FQDN）：

sh
FQDN=<在此处填写您的域名>
docker run -d  -v /home/user/cells_dir:/var/cells -e CELLS_SITE_BIND=:443 -e CELLS_SITE_EXTERNAL=[***] --network=host pydio/cells

参数说明：

• -d: 在后台运行
• -v /home/user/cells_dir:/var/cells: 将本地文件夹挂载为Cells工作目录
• -e CELLS_SITE_BIND=:443: 使用HTTPS标准保留端口（需确保未被Web服务器等占用）
• -e CELLS_SITE_EXTERNAL=[***]: （可选）显式声明域名
• --network=host: 直接使用主机网络，便于连接数据库

使用docker-compose运行

以下是使用docker-compose运行Pydio Cells的基础配置：

yaml
version: '3.7'
services:

  cells:
    image: pydio/cells:latest
    restart: unless-stopped
    ports: ["8080:8080"]
    volumes:
      - cellsdir:/var/cells  # Cells工作目录
      - data:/var/cells/data  # 数据存储

  mysql:
    image: mysql:8
    restart: unless-stopped
    environment:
      MYSQL_ROOT_PASSWORD: P@ssw0rd  # MySQL root密码
      MYSQL_DATABASE: cells  # 数据库名称
      MYSQL_USER: pydio  # Cells数据库用户
      MYSQL_PASSWORD: P@ssw0rd  # Cells数据库用户密码
    command: [mysqld, --character-set-server=utf8mb4, --collation-server=utf8mb4_unicode_ci]
    volumes:
      - mysqldir:/var/lib/mysql  # MySQL数据持久化

volumes:
    data: {}
    cellsdir: {}
    mysqldir: {}

深入使用

命令

运行镜像时的默认命令：

• 若未找到安装，则执行cells configure
• 否则执行cells start

可指定自定义命令，例如：

sh
# 查看版本
docker run pydio/cells cells version

# 进入运行中的容器（容器ID为5fe...）
docker exec 5fe /bin/sh

数据布局

卷中重要文件和数据列表：

• /var/cells: 主工作目录
• /var/cells/pydio.json: 主配置文件
• /var/cells/data: 数据存储
• /var/cells/logs: 日志文件
• /var/cells/certs: 证书管理
• /var/cells/services: 服务信息

环境变量

启动镜像时，start（首次启动为configure）命令的所有标志可通过环境变量设置，使用大写字母并添加CELLS_前缀。以下是常用环境变量：

更多示例

我们在代码库中收集了相关示例配置，可根据需求选择并调整。

Cells Sync

Cells Sync桌面应用可能需要额外端口（例如在反向代理终止TLS的场景）：

1. 首先阅读为Cells Sync设置Cells服务器
2. 确保容器设置CELLS_GRPC_EXTERNAL环境变量
3. 暴露通过CELLS_GRPC_EXTERNAL设置的端口

示例

假设选择33060作为gRPC端口，命令需包含：

• -e CELLS_GRPC_EXTERNAL=33060（设置环境变量）
• -p 33060:33060（暴露端口）

完整命令示例：

sh
docker run -d \
  -e CELLS_SITE_EXTERNAL=192.168.0.172:8080 \
  -e CELLS_SITE_BIND=192.168.0.172:8080 \
  -e CELLS_GRPC_EXTERNAL=33060 \
  -p 33060:33060 \
  -p 8080:8080 \
  pydio/cells

贡献

详情请阅读CONTRIBUTING.md，了解行为准则和提交拉取请求的流程。

版本控制

我们使用SemVer进行版本控制，并定期发布新版本，这些版本也会作为命名版本推送到Docker镜像。标签约定：

• latest: 最新稳定版本，仅在发布新版本时更新
• prepare-[版本号]（如prepare-4.0.2）: 预发布期间的候选版本，可能随时变更
• unstable: 通常每天凌晨2点（GMT）从master分支更新

也可通过版本号引用特定镜像。

作者

详见贡献者列表。Pydio Cells是Pydio项目的延续，许多贡献从pydio-core移植到cells-front代码中。

许可

本项目采用AGPLv3许可 - 详见LICENSE文件。