maoyuan121 / cells

Future-proof content collaboration platform

Homepage | Dev Guide | GitHub-Repository | Issue-Tracker

Pydio Cells 是组织的下一代文件共享平台。它是 Pydio 项目的完整重写，使用 Go 语言，遵循微服务架构。

Getting Started

这些说明将为您提供项目的副本，并在您的本地机器上运行，用于开发和测试目的。请参阅下面的部署部分，了解如何在实时系统上部署项目。

Prerequisites

以下元素是在您的机器上编译和运行 pydio 所必需的

• Go v1.12 或者更高, with a correctly configured Go toolchain,
• MySQL database 5.6 或更高 (或者 MariaDB)。The new mysql 8 authentication method is supported starting at Cells 1.4.1.

注意：我们已经在 MacOS, Ubuntu, Debian 和 CentOS 上开发和测试了 Pydio Cells。Windows 版本可能仍然有未知的故障，目前还不支持。

Installing

假设你的系统满足上述先决条件，从源代码构建 Pydio Cells 后端是相当直接的：

# Retrieve the code
go get -u github.com/pydio/cells
# From this line on, we assume you are in Pydio Cells' code roots directory
cd $GOPATH/src/github.com/pydio/cells
# Build your binary
make dev

为了让环境运行，你必须：

• 在选定的 DB 服务器中创建数据库
• 运行 Pydio Cells 安装程序，它将指导您完成必要的步骤：更多信息，请参考 official documentation。

./cells install

Note on the third party libraries

我们目前仍然通过 vendor 机制来管理第三方依赖：简单地说，我们为每个依赖获取并维护特定版本的源文件，将它们复制到' vendor/ '子文件夹中。二进制文件是用这些代码构建的。

当你克隆 github.com/pydio/cells 存储库时，你还会有一个所有资源的嵌入式本地副本供您研究。然而，您不应该尝试直接修改已经被 vendor 的代码。

还请注意，在将它们作为依赖项集成之前，我们必须 fork 一些库，最重要的是 dex 和 minio。如果您需要修改这部分代码，请与我们联系。

Running the tests

运行测试，只需简单的运行下面的命令：

go test -v ./...

如果你想添加更多测试或贡献代码，请阅读 CONTRIBUTING.md 文档。

Deployment

目前为Linux、MacOSX和Windows发行版提供了二进制文件。要在实时系统上部署它们，请参见安装指南说明。

Built With

Pydio Cells 使用许多开源的 golang 库。下面列出了最重要的库，请参阅DEPENDENCIES获得其他库及其许可的详尽列表。

• Micro - Micro-service framework
• Minio - Objects server implementing s3 protocol

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us. You can find a comprehensive Developer Guide on our website. Our online docs are open source as well, feel free to improve them by contributing!

We are also looking for help to translate the Cells interface in various languages.
It is really easy to participate: just navigate to our page in the Crowdin translation tool, create an account and get started.

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Authors

See the list of contributors who participated in this project. Pydio Cells is also a continuation of the Pydio project and many contributions were ported from pydio-core to the code that can be found under frontend/front-srv/assets.

License

This project is licensed under the AGPLv3 License - see the LICENSE file for more details.