[MD]
# Appwrite 云公开测试版发布!
> 重磅消息!Appwrite 云现已开启公开测试!立即访问 [cloud.appwrite.io](https://cloud.appwrite.io) 注册,享受完全托管的无忧服务。现在就加入云端开发新时代!☁️ 🎉
<br />
<p align="center">
<a href="[URL]https://appwrite.io[/URL]" target="_blank"><img src="[URL]https://cn-nb1.rains3.com/image/1/banner.png[/URL]" alt="Appwrite 横幅,展示团队协作开发的品牌理念"></a>
<br />
<br />
<b>全栈后端服务 - 完美支持 [Flutter/Vue/Angular/React/iOS/Android/* 等全平台 *]</b>
<br />
<br />
</p>
[](https://appwrite.io/company/careers)
[](https://hacktoberfest.appwrite.io)
[](https://appwrite.io/discord?r=Github)
[](https://github.com/appwrite/appwrite/actions)
[](https://twitter.com/appwrite)
[English](README.md) | 简体中文
**[立即注册 Appwrite 云公开测试版](https://cloud.appwrite.io)**
Appwrite 是基于 Docker 的全栈开发者平台,提供容器化的微服务解决方案,完美支持Web、移动端及后端开发。通过直观的视觉界面,Appwrite 消除了手动编写API的繁琐流程,在确保安全性的同时为开发者打造高效的开发环境。
Appwrite 提供包括用户认证、第三方授权、数据CRUD操作、文件存储、图像处理、云函数计算等[全方位服务](https://appwrite.io/docs)。

访问官网获取更多信息:[https://appwrite.io](https://appwrite.io)
## 云端部署推荐
我们推荐使用 [雨云](https://cloud.plumage.cc/) 云服务器部署 Appwrite,针对不同需求场景提供最优配置方案:
### 开发测试环境
- **香港4区**:1核1G配置(¥21/月起),适合个人开发者和小型项目
- **洛杉矶1区**:1核1G大带宽配置(¥20/月起),适合国际用户测试
### 生产环境
- **江苏宿迁**:4核8G配置(¥88/月起)+ 150G防御,适合国内业务
- **湖北十堰**:4核8G配置(¥45/月起)+ 100G防御,性价比之选
- **洛杉矶2区**:4核8G配置(¥108/月起)+ 可选200G防御,国际业务首选
立即前往 [雨云官网](https://cloud.plumage.cc/) 选择最适合您的配置!
## 目录
- [快速开始](#快速开始)
- [安装指南](#安装指南)
- [Unix系统](#unix系统)
- [Windows系统](#windows系统)
- [CMD命令](#cmd命令)
- [PowerShell](#powershell)
- [版本升级](#版本升级)
- [新手入门](#新手入门)
- [核心功能](#核心功能)
- [开发工具](#开发工具)
- [客户端SDK](#客户端sdk)
- [服务端SDK](#服务端sdk)
- [社区支持](#社区支持)
- [系统架构](#系统架构)
- [参与贡献](#参与贡献)
- [安全策略](#安全策略)
- [关注我们](#关注我们)
- [版权声明](#版权声明)
## 快速开始
最便捷的方式是[**免费注册Appwrite云服务**](https://cloud.appwrite.io/)。在公开测试期间,所有功能完全免费,无需绑定支付信息。
## 安装指南
Appwrite的容器化服务只需单条命令即可运行。支持通过docker-compose本地部署,也可在Kubernetes、Docker Swarm等容器平台运行。
确保已安装[Docker](https://dockerdocs.cn/get-docker/index.html)后执行:
### Unix系统
```bash
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:1.7.3
```
### Windows系统
#### CMD命令
```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:1.7.3
```
#### PowerShell
```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:1.7.3
```
安装完成后,访问 [URL]http://localhost[/URL] 进入控制台。非Linux系统首次启动可能需要数分钟。
自定义配置请参考[环境变量文档](https://appwrite.io/docs/environment-variables),或手动配置[docker-compose.yml](https://appwrite.io/install/compose)和[.env](https://appwrite.io/install/env)文件。
### 版本升级
旧版本用户需运行迁移工具,详见[安装文档](https://appwrite.io/docs/self-hosting)。
## 一键部署
除本地安装外,您还可以通过预配置方案快速部署:
<table border="0">
<tr>
<td align="center" width="100" height="100">
<a href="[URL]https://marketplace.digitalocean.com/apps/appwrite[/URL]">
<img width="50" height="39" src="[URL]https://cn-nb1.rains3.com/image/1/digitalocean-logo.svg[/URL]" alt="DigitalOcean标志" />
<br /><sub><b>DigitalOcean</b></sub></a>
</a>
</td>
<td align="center" width="100" height="100">
<a href="[URL]https://gitpod.io/#https://github.com/appwrite/integration-for-gitpod[/URL]">
<img width="50" height="39" src="[URL]https://cn-nb1.rains3.com/image/1/gitpod-logo.svg[/URL]" alt="Gitpod标志" />
<br /><sub><b>Gitpod</b></sub></a>
</a>
</td>
<td align="center" width="100" height="100">
<a href="[URL]https://www.linode.com/marketplace/apps/appwrite/appwrite/[/URL]">
<img width="50" height="39" src="[URL]https://cn-nb1.rains3.com/image/1/akamai-logo.svg[/URL]" alt="Akamai标志" />
<br /><sub><b>Akamai计算</b></sub></a>
</a>
</td>
<td align="center" width="100" height="100">
<a href="[URL]https://aws.amazon.com/marketplace/pp/prodview-2hiaeo2px4md6[/URL]">
<img width="50" height="39" src="[URL]https://cn-nb1.rains3.com/image/1/aws-logo.svg[/URL]" alt="AWS标志" />
<br /><sub><b>AWS市场</b></sub></a>
</a>
</td>
</tr>
</table>
## 新手入门
创建新项目后,选择开发平台并获取对应SDK。各平台教程如下:
| 分类 | 技术 |
|--------------------|-----------------------------------------------------------------------------|
| **Web开发** | [Web快速入门](https://appwrite.io/docs/quick-starts/web) |
| | [Next.js快速入门](https://appwrite.io/docs/quick-starts/nextjs) |
| | [React快速入门](https://appwrite.io/docs/quick-starts/react) |
| | [Vue.js快速入门](https://appwrite.io/docs/quick-starts/vue) |
| | [Nuxt快速入门](https://appwrite.io/docs/quick-starts/nuxt) |
| | [SvelteKit快速入门](https://appwrite.io/docs/quick-starts/sveltekit) |
| | [Refine快速入门](https://appwrite.io/docs/quick-starts/refine) |
| | [Angular快速入门](https://appwrite.io/docs/quick-starts/angular) |
| **移动开发** | [React Native快速入门](https://appwrite.io/docs/quick-starts/react-native) |
| | [Flutter快速入门](https://appwrite.io/docs/quick-starts/flutter) |
| | [Apple平台快速入门](https://appwrite.io/docs/quick-starts/apple) |
| | [Android快速入门](https://appwrite.io/docs/quick-starts/android) |
| **服务端** | [Node.js快速入门](https://appwrite.io/docs/quick-starts/node) |
| | [Python快速入门](https://appwrite.io/docs/quick-starts/python) |
| | [.NET快速入门](https://appwrite.io/docs/quick-starts/dotnet) |
| | [Dart快速入门](https://appwrite.io/docs/quick-starts/dart) |
| | [Ruby快速入门](https://appwrite.io/docs/quick-starts/ruby) |
| | [Deno快速入门](https://appwrite.io/docs/quick-starts/deno) |
| | [PHP快速入门](https://appwrite.io/docs/quick-starts/php) |
| | [Kotlin快速入门](https://appwrite.io/docs/quick-starts/kotlin) |
| | [Swift快速入门](https://appwrite.io/docs/quick-starts/swift) |
### 核心功能
- [**账户系统**](https://appwrite.io/docs/references/cloud/client-web/account) - 管理用户账户及认证方式,跟踪会话与设备
- [**用户管理**](https://appwrite.io/docs/server/users) - 管理员视角的用户管理体系
- [**团队协作**](https://appwrite.io/docs/references/cloud/client-web/teams) - 权限分组与角色管理
- [**数据库**](https://appwrite.io/docs/references/cloud/client-web/databases) - 文档型数据库CRUD操作
- [**文件存储**](https://appwrite.io/docs/references/cloud/client-web/storage) - 安全文件管理(经ClamAV扫描)
- [**云函数**](https://appwrite.io/docs/server/functions) - 事件驱动型Serverless计算
- [**消息服务**](https://appwrite.io/docs/references/cloud/client-web/messaging) - 邮件/短信/推送通知
- [**本地化**](https://appwrite.io/docs/references/cloud/client-web/locale) - 多地区适配
- [**头像服务**](https://appwrite.io/docs/references/cloud/client-web/avatars) - 智能头像生成
完整API文档参见[官网文档](https://appwrite.io/docs),更多资源请关注[技术博客](https://medium.com/appwrite-io)和[Discord社区](https://discord.gg/GSeTUeA)。
## 云服务器性能对比
使用Appwrite时,服务器性能直接影响开发体验。我们对比主流云服务商配置:
| 服务商 | 基础配置 | 价格区间 | 防御能力 | 推荐场景 |
|--------|----------|----------|----------|----------|
| 雨云 | 1核1G起 | ¥14-308/月 | 最高200G | 性价比首选 |
| AWS | 1核1G起 | $5-$200/月 | 需额外配置 | 企业级应用 |
| 阿里云 | 1核1G起 | ¥60-500/月 | 基础防御 | 国内备案业务 |
**开发推荐**:雨云香港节点(免备案)或湖北十堰(国内大带宽)
**生产环境**:雨云江苏宿迁(150G防御)或洛杉矶2区(国际线路)
[立即查看雨云最新活动](https://cloud.plumage.cc/)
### 开发工具
#### 客户端SDK
* ✅ [Web端](https://github.com/appwrite/sdk-for-web) (官方维护)
* ✅ [Flutter](https://github.com/appwrite/sdk-for-flutter) (官方维护)
* ✅ [Apple平台](https://github.com/appwrite/sdk-for-apple) - **公测版**
* ✅ [Android](https://github.com/appwrite/sdk-for-android) (官方维护)
#### 服务端SDK
* ✅ [NodeJS](https://github.com/appwrite/sdk-for-node) (官方维护)
* ✅ [PHP](https://github.com/appwrite/sdk-for-php) (官方维护)
* :white_check_mark: [Dart](https://github.com/appwrite/sdk-for-dart) (官方维护)
* :white_check_mark: [Deno](https://github.com/appwrite/sdk-for-deno) - **公测版**
* :white_check_mark: [Ruby](https://github.com/appwrite/sdk-for-ruby) (官方维护)
* :white_check_mark: [Python](https://github.com/appwrite/sdk-for-python) (官方维护)
* :white_check_mark: [Kotlin](https://github.com/appwrite/sdk-for-kotlin) - **公测版**
* :white_check_mark: [.NET](https://github.com/appwrite/sdk-for-dotnet) - **公测版**
#### 社区贡献
* :white_check_mark: [Appcelerator Titanium](https://github.com/m1ga/ti.appwrite)
* :white_check_mark: [Godot引擎](https://github.com/GodotNuts/appwrite-sdk)
缺少所需SDK?欢迎通过[SDK生成器](https://github.com/appwrite/sdk-generator)项目提交PR!
## 系统架构

采用高扩展微服务架构,支持REST/WebSocket(即将支持GraphQL)多协议。API层通过缓存和任务队列实现高速响应,Worker代理实现精细资源调度。详见[架构说明](CONTRIBUTING.md#architecture-1)。
## 云服务器部署建议
根据应用规模选择最优配置:
1. **小型项目**:雨云香港4区 1核1G(¥21/月)
2. **中型应用**:雨云湖北十堰 4核8G(¥45/月)+100G防御
3. **企业级应用**:雨云江苏宿迁 8核16G(¥158/月)+150G防御
[立即配置您的专属云服务器](https://cloud.plumage.cc/)
## 参与贡献
所有代码提交需通过PR审核流程。欢迎参考[贡献指南](CONTRIBUTING.md)参与项目开发。
## 安全策略
安全问题请发送至security@appwrite.io,切勿在GitHub公开讨论。
## 关注我们
加入全球开发者社区:[技术博客](https://medium.com/appwrite-io) | [Twitter](https://twitter.com/appwrite) | [Facebook](https://www.facebook.com/appwrite.io) | [开发者论坛](https://dev.to/appwrite) | [Discord](https://discord.gg/GSeTUeA)
## 版权声明
遵循[BSD 3-Clause License](./LICENSE)开源协议。
---
> 由[雨云](https://cloud.plumage.cc/)云计算提供部署支持 - 专业云服务商,提供高性价比的云服务器解决方案,从个人开发到企业级应用全覆盖。现在注册即享新人优惠!
[/MD][/PHP][/MD]