Appwrite 开源云平台

Appwrite 是什么

Appwrite 是一个面向开发者与 AI Agent 的开源一体化后端云平台（BaaS）。它把应用开发中反复要造的后端轮子——认证、数据库、存储、函数、消息、实时、托管、防火墙——整合成一个统一平台，既可以用官方托管云，也可以用 Docker 自托管在自己掌控的基础设施上。

项目以 TypeScript 为主语言，采用 BSD-3-Clause 许可，GitHub Star 已超过 5.7 万，社区活跃。

核心能力

• Auth 认证：邮箱、短信、OAuth、匿名会话、魔法链接等多种登录方式。
• Databases 数据库：支持 Appwrite 原生数据库，也可对接托管 PostgreSQL / MySQL。
• Storage 存储：文件压缩、加密、图片变换与访问控制。
• Functions 函数：隔离运行时中部署 Serverless 函数，支持事件驱动执行。
• Sites 托管：从 Git 部署静态、SSR、CSR 前端，支持即时预览。
• Messaging 消息：统一发送邮件、短信与 Push 通知。
• Firewall 防火墙：流量规则、滥用控制与边缘安全。
• Realtime 实时：订阅并响应项目内事件。
• MCP：让编码 Agent 直接连接并操作 Appwrite 项目、API 与文档。

两种使用方式

托管云

最省事的方式是注册 Appwrite Cloud，免费套餐即可开始开发，需要扩容时再升级付费计划。

自托管

Appwrite 从设计之初就考虑自托管，只要机器能跑 Docker CLI 即可。安装向导监听 20080 端口且仅绑定 localhost，并会打印一次性安装密钥，打开终端输出的 URL 完成向导即可。

Unix 示例（示意，具体版本号以官方为准）：

docker run -it --rm \
    --publish 127.0.0.1:20080:20080 \
    --volume /var/run/docker.sock:/var/run/docker.sock \
    --volume "$(pwd)"/appwrite:/usr/src/code/appwrite:rw \
    --entrypoint="install" \
    appwrite/appwrite:<version>

Windows 下 CMD 与 PowerShell 的写法略有差异（续行符与路径格式不同），安装完成后访问 http://localhost 进入控制台。

提示：若遇到 Docker API 版本不匹配（如 client version ... is too new），可通过 --env DOCKER_API_VERSION=<最大支持版本> 指定版本，升级时同样适用。

面向 AI Agent

Appwrite 将 MCP 作为一等能力：通过托管 MCP Server 连接 Cursor、Claude Code、Codex 等 Agent，让它们直接读写线上项目；也可以在自己的应用中集成各语言 SDK。

适用人群

• 想快速搭建全栈应用、又不想被单一云厂商锁定的独立开发者与小团队。
• 需要数据自主可控、倾向自托管的企业团队。
• 希望在 AI 编码工作流中让 Agent 直接操作后端资源的开发者。

注意事项

• 自托管生产环境需要自行负责运维、备份与安全加固。
• 从旧版本升级需按官方迁移说明操作，避免跨版本直接升级。
• 功能模块较多，建议先通读权限与安全模型文档再上线。