Nextcloud Server ☁

您所有数据的安全之家。

为什么这如此出色？🤩

• 📁 访问您的数据 您可以将文件、联系人、日历等存储在您选择的服务器上。
• 🔄 同步您的数据 您保持文件、联系人、日历等在各设备之间同步。
• 🙌 共享您的数据 …通过让其他人访问您希望他们查看或协作的内容。
• 🚀 可通过数百个应用扩展 …例如 Calendar, Contacts, Mail, Video Chat 以及您可以在我们的 App Store 中发现的所有应用
• 🔒 安全性 通过我们的加密机制、HackerOne 赏金计划 和双因素认证。

您想了解如何使用 Nextcloud 在家庭和机构中访问、共享和保护您的文件、日历、联系人、通信等？了解我们所有的功能。

获取您的 Nextcloud 🚚

• ☑️ 在我们的提供商处 简单注册，通过我们的网站或直接通过应用。
• 🖥 安装 一个服务器 在您的硬件上，或使用我们的即用型 设备
• 📦 购买一台 带有预装 Nextcloud 的出色 设备
• 🏢 寻找一个为您或您的公司托管 Nextcloud 的 服务 提供商

企业？公共部门或教育用户？您可能想看看由 Nextcloud GmbH 提供的 Nextcloud Enterprise。

联系我们 💬

• 📋 论坛
• 🦋 Bluesky
• 👥 Facebook
• 🐘 Mastodon

您也可以获取 Nextcloud 的支持！

加入团队 👪

有许多方式可以做出贡献，开发只是其中之一！了解如何参与，包括作为翻译者、设计师、测试人员、帮助他人，以及更多！😍

开发环境配置 👩‍💻

1. 🚀 Set up your local development environment
2. 🐛 Pick a good first issue
3. 👩‍🔧 Create a branch and make your changes. Remember to sign off your commits using git commit -sm "Your commit message"
4. ⬆ Create a pull request and @mention the people from the issue to review
5. 👍 Fix things that come up during a review
6. 🎉 Wait for it to get merged!

第三方组件作为 git 子模块处理，必须先进行初始化。因此，除了常规的 git checkout 之外，还需要调用 git submodule update --init 或类似命令，详情请参阅 Git 文档。

常规版本中默认包含的若干应用，例如 First run wizard 或 Activity，在 master 中缺失，必须通过将其克隆到 apps 子文件夹中手动安装。

否则，git 检出可以像发布归档一样处理，通过使用 stable* 分支。请注意，它们绝不应在生产系统上使用。

测试你的代码

我们在代码的特定领域使用多个测试框架：

• PHPUnit 用于 PHP 单元测试
• Behat 用于 PHP 集成测试
• Vitest 用于 Javascript / Typescript 单元测试
• Playwright 用于端到端测试

对于使用 Playwright 的端到端测试，您可以参考我们的文档 了解如何调试错误以及如何贡献新的测试用例。

我们使用的工具 🛠

• 👀 BrowserStack 用于跨浏览器测试
• 🌊 WAVE 用于可访问性测试
• 🚨 Lighthouse 用于测试性能、可访问性等

GitHub 上的实用机器人 :robot:

• 在 pull request 中评论 /update-3rdparty 以更新第三方子模块。它将更新到与 PR 目标同名的第三方分支的最新提交。

在 git blame 中忽略代码风格更新

git config blame.ignoreRevsFile .git-blame-ignore-revs

贡献指南 📜

自 2016 年 6 月 16 日起，对本仓库的所有贡献均被视为 在 AGPLv3 或任何后续版本许可下授权。

Nextcloud 不要求 CLA（贡献者许可协议）。 版权归所有个人贡献者所有。 因此，我们建议每位贡献者在他们对代码进行了实质性更改时，将以下行添加到 AUTHORS 文件中：

- <your name> <your email address>

请阅读行为准则。本文档提供了一些指导，以确保 Nextcloud 参与者能够在积极且鼓舞人心的氛围中有效合作，并解释我们如何共同加强和支持彼此。

请查阅向此仓库贡献的指南。

有关如何贡献的更多信息：https://nextcloud.com/contribute/