pydio/cells

主页 | https://github.com/pydio/cells | https://github.com/pydio/cells/issues

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=https://$FQDN --network=host pydio/cells

参数说明：

• -d: 在后台运行
• -v /home/user/cells_dir:/var/cells: 将本地文件夹挂载为Cells工作目录
• -e CELLS_SITE_BIND=:443: 使用HTTPS标准保留端口（需确保未被Web服务器等占用）
• -e CELLS_SITE_EXTERNAL=https://$FQDN: （可选）显式声明域名
• --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_前缀。以下是常用环境变量：

更多示例

我们在代码库中收集了https://github.com/pydio/cells/tree/main/tools/docker/compose%EF%BC%8C%E5%8F%AF%E6%A0%B9%E6%8D%AE%E9%9C%80%E6%B1%82%E9%80%89%E6%8B%A9%E5%B9%B6%E8%B0%83%E6%95%B4%E3%80%82

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

贡献

详情请阅读https://github.com/pydio/cells/blob/main/CONTRIBUTING.md%EF%BC%8C%E4%BA%86%E8%A7%A3%E8%A1%8C%E4%B8%BA%E5%87%86%E5%88%99%E5%92%8C%E6%8F%90%E4%BA%A4%E6%8B%89%E5%8F%96%E8%AF%B7%E6%B1%82%E7%9A%84%E6%B5%81%E7%A8%8B%E3%80%82

版本控制

我们使用SemVer进行版本控制，并定期https://github.com/pydio/cells/releases%EF%BC%8C%E8%BF%99%E4%BA%9B%E7%89%88%E6%9C%AC%E4%B9%9F%E4%BC%9A%E4%BD%9C%E4%B8%BA%E5%91%BD%E5%90%8D%E7%89%88%E6%9C%AC%E6%8E%A8%E9%80%81%E5%88%B0Docker%E9%95%9C%E5%83%8F%E3%80%82%E6%A0%87%E7%AD%BE%E7%BA%A6%E5%AE%9A%EF%BC%9A

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

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

作者

详见https://github.com/pydio/cells/graphs/contributors%E3%80%82Pydio Cells是Pydio项目的延续，许多贡献从https://github.com/pydio/pydio-core%E7%A7%BB%E6%A4%8D%E5%88%B0https://github.com/pydio/cells-front%E4%BB%A3%E7%A0%81%E4%B8%AD%E3%80%82

许可

本项目采用AGPLv3许可 - 详见https://github.com/pydio/cells/blob/master/LICENSE%E6%96%87%E4%BB%B6%E3%80%82