appwrite/README-CN.md

适用于[Flutter/Vue/Angular/React/iOS/Android/* 等等平台 *]的完整后端服务

English | 简体中文

Appwrite是一个基于Docker的端到端开发者平台，其容器化的微服务库可应用于网页端，移动端，以及后端。Appwrite 通过视觉化界面极简了从零编写 API 的繁琐过程，在保证软件安全的前提下为开发者创造了一个高效的开发环境。

Appwrite 可以提供给开发者用户验证，外部授权，用户数据读写检索，文件储存，图像处理，云函数计算，等多种服务.

更多信息请到 Appwrite 官网查看： https://appwrite.io

内容：

• 安装
  • Unix
  • Windows
    • CMD
    • PowerShell
  • 从旧版本升级
• 入门
  • 软件服务
  • 开发套件
    • 客户端
    • 服务器
    • 开发者社区
• 软件架构
• 贡献代码
• 安全
• 订阅我们
• 版权说明

安装

Appwrite 的容器化服务器只需要一行指令就可以运行。您可以使用 docker-compose 在本地主机上运行 Appwrite，也可以在任何其他容器化工具（如 Kubernetes、Docker Swarm 或 Rancher）上运行 Appwrite。

开始运行 Appwrite 服务器的最简单方法是运行我们的 docker-compose 文件。在运行安装命令之前，请确保您的机器上安装了 Docker：

Unix

docker run -it --rm \
    --volume /var/run/docker.sock:/var/run/docker.sock \
    --volume "$(pwd)"/appwrite:/usr/src/code/appwrite:rw \
    --entrypoint="install" \
    appwrite/appwrite:0.15.0

Windows

CMD

docker run -it --rm ^
    --volume //var/run/docker.sock:/var/run/docker.sock ^
    --volume "%cd%"/appwrite:/usr/src/code/appwrite:rw ^
    --entrypoint="install" ^
    appwrite/appwrite:0.15.0

PowerShell

docker run -it --rm ,
    --volume /var/run/docker.sock:/var/run/docker.sock ,
    --volume ${pwd}/appwrite:/usr/src/code/appwrite:rw ,
    --entrypoint="install" ,
    appwrite/appwrite:0.15.0

运行后，可以在浏览器上访问 http://localhost 找到 Appwrite 控制台。在非 Linux 的本机主机上完成安装后，服务器可能需要几分钟才能启动。

需要自定义容器构架，请查看我们的 Docker 环境变量 文档。您还可以参考我们的 docker-compose.yml 文件手动设置环境。

从旧版本升级

如果您从旧版本升级 Appwrite 服务器，则应在设置完成后使用 Appwrite 迁移工具。有关这方面的更多信息，请查看 安装文档。

入门

开始使用 Appwrite 只需要在控制台创建一个新项目，选择开发平台，然后抓取我们的开发套件。您可以从以下的教程中找到你喜欢的平台开始使用 Appwrite。

• 开始使用 Web
• 开始使用 Flutter
• 开始使用 Apple
• 开始使用 Android
• 开始使用 Server
• 开始使用 CLI

软件服务

• 帐户 -管理当前用户的帐户和登录方式。跟踪和管理用户 Session，登录设备，登录方法和查看相关记录。
• 用户 - 在以管理员模式登录时管理和列出所有用户。
• 团队 - 管理用户分组。邀请成员，管理团队中的用户权限和用户角色。
• 数据库 - 管理数据库文档和文档集。用检索界面来对文档和文档集进行读取，创建，更新，和删除。
• 贮存 - 管理文件的阅读、创建、删除和预览。设置文件的预览来满足程序的个性化需求。所有文件都由 ClamAV 扫描并安全存储和加密。
• 云函数 - 在安全，隔离的环境中运行自定义代码。这些代码可以被事件，CRON，或者手动操作触发。
• 语言适配 - 根据用户所在的的国家和地区做出合适的语言适配。
• 头像 -管理用户头像、国家旗帜、浏览器图标、信用卡符号，和生成二维码。 如需完整的 API 界面文档，请访问 https://appwrite.io/docs。如需更多教程、新闻和公告，请订阅我们的 博客 和 加入我们的Discord 社区。

开发套件

以下是当前支持的平台和语言列表。如果您想帮助我们为您选择的平台添加支持，您可以访问我们的 SDK 生成器 项目并查看我们的 贡献指南。

客户端

• ✅   Web (由 Appwrite 团队维护)
• ✅   Flutter (由 Appwrite 团队维护)
• ✅   Apple - 公测 (由 Appwrite 团队维护)
• ✅   Android (由 Appwrite 团队维护)

服务器

• ✅   NodeJS (由 Appwrite 团队维护)
• ✅   PHP (由 Appwr实验 团队维护)
• ✅   Dart - (由 Appwrite 团队维护)
• ✅   Deno - 公测 (由 Appwrite 团队维护)
• ✅   Ruby (由 Appwrite 团队维护)
• ✅   Python (由 Appwrite 团队维护)
• ✅   Kotlin - 公测 (由 Appwrite 团队维护)
• ✅   Apple - 公测 (由 Appwrite 团队维护)
• ✅   .NET - 公测 (由 Appwrite 团队维护)

开发者社区

• ✅   Appcelerator Titanium (维护者 Michael Gangolf)
• ✅   Godot Engine (维护者 fenix-hub @GodotNuts)

找不到需要的的 SDK？ - 欢迎通过发起PR来帮助我们完善Appwrite的软件生态环境 SDK 生成器!

软件架构

Appwrite 使用高拓展性的微服务架构。此外，Appwrite 支持多种 API（REST、WebSocket 和 即将推出的 GraphQL），来迎合您的个性化开发习惯。

Appwrite API 界面层利用后台缓存和任务委派来提供极速的响应时间。后台的 Worker 代理还允许您使用消息队列来处理负载，并精确控制硬件合理分配和成本。您可以在 贡献指南 中了解有关我们架构的更多信息。

贡献代码

所有代码贡献 - 包括来自具有直接提交更改权限的贡献者 - 都必须提交PR请求并在合并分支之前得到核心开发人员的批准。这是为了确保正确审查所有代码。

我们欢迎所有人提交PR！如果您愿意提供帮助，可以在 贡献指南 中了解有关如何为项目做出贡献的更多信息。

安全

为了保护您的隐私，请避免在GitHub 上发布安全问题。发送问题至 security@appwrite.io，我们将为您做更细致的解答。

订阅我们

加入我们在世界各地不断发展的社区！请参阅我们的官方 博客。在 Twitter、Facebook 页面、Facebook 群组、开发者社区 等平台订阅我们或加入我们的 Discord 社区 以获得更多帮助，想法和讨论。

版权说明

版权详情，访问 BSD 3-Clause License。