README

Appwrite
    面向智能体与开发者的开源云。Appwrite 是面向 MCP 与智能体的平台，用于构建和扩展应用。为你的智能体提供 Auth、数据库、存储、云函数、消息、实时和托管，全部集中在一处。
    
    






English | 简体中文

Appwrite 是面向 MCP 与智能体的开源平台，用于构建和扩展应用。MCP 已包含在内，编程智能体可以直接操作线上的 Appwrite 项目。Appwrite 提供托管云服务，也可以在你自己控制的基础设施上自托管。

它既面向开发者，也面向你工作流中的 AI 智能体。通过托管 MCP 服务器连接 Cursor、Claude Code、Codex 等智能体，或将 SDK 集成到应用中。模块化产品从最初的原型到生产规模都保持统一。

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

内容：

- 产品
- 安装与配置
- 自托管
  - Unix
  - Windows
    - CMD
    - PowerShell
  - Docker API 版本不匹配
  - 从旧版本升级
- 一键配置
- 入门
  - 智能体
  - 开发套件
    - 客户端
    - 服务器
- 软件架构
- 贡献代码
- 安全
- 订阅我们
- 版权说明


 产品

- Appwrite Auth - 通过邮箱、短信、OAuth、匿名会话和 Magic URL 安全地验证用户。

- Appwrite Databases - 使用 Appwrite 数据库或托管的 PostgreSQL 和 MySQL 进行建模、查询和扩展，以匹配你的用例和团队需求。

- Appwrite Storage - 存储文件，支持压缩、加密、图像转换和访问控制。

- Appwrite Functions - 部署无服务器函数，使用安全隔离的运行时和事件驱动执行。

- Appwrite Sites - 从 Git 部署静态、SSR 和 CSR 前端，支持即时预览，并由 Appwrite 作为后端。

- Appwrite Messaging - 通过统一的消息服务发送邮件、短信和推送通知。

- Appwrite Firewall - 通过流量规则、滥用防护和边缘安全保护每个项目中的应用。

- Appwrite Realtime - 订阅并响应项目中正在发生的事件。

- Appwrite MCP - 将智能体连接到你的 Appwrite 项目、API 和文档。Cloud 已包含 MCP，无需本地安装。


 安装与配置

开始使用 Appwrite 最简单的方式是注册 Appwrite Cloud。Cloud 提供免费套餐，你可以立即开始构建，需要扩展时再升级到付费套餐。

 自托管

Appwrite 从一开始就为自托管而设计。你可以在任何能运行 Docker CLI 的操作系统上安装并运行 Appwrite。从终端运行一条命令即可启动服务器。

运行安装命令之前，请确保机器上已安装 Docker。安装向导监听 20080 端口，且仅发布到本机。终端会打印一次性安装密钥 — 请打开打印出的 URL（或发送 x-appwrite-installer-secret）完成安装。远程主机请通过 SSH 隧道访问 127.0.0.1:20080，不要把该端口发布到所有网卡。

 Unix

bash
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:2.7.1


 Windows

 CMD

cmd
docker run -it --rm ^
    --publish 127.0.0.1:20080:20080 ^
    --volume //var/run/docker.sock:/var/run/docker.sock ^
    --volume "%cd%"/appwrite:/usr/src/code/appwrite:rw ^
    --entrypoint="install" ^
    appwrite/appwrite:2.7.1


 PowerShell

powershell
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:2.7.1


安装程序运行后，打开终端打印出的 URL（其中包含一次性密钥）完成安装向导。安装完成后，访问 http://localhost 即可从浏览器进入 Appwrite 控制台。请注意，在非 Linux 本机主机上，安装完成后服务器可能需要几分钟才能启动。

 Docker API 版本不匹配

如果安装或升级失败，并出现类似 client version 1.52 is too new. Maximum supported API version is 1.42 的错误，说明 Appwrite 镜像内的 Docker CLI 比宿主机 Docker Engine 更新。请传入 DOCKER_API_VERSION，设为错误信息中的最高 API 版本（或升级宿主机上的 Docker）：

bash
docker run -it --rm \
    --env DOCKER_API_VERSION=1.42 \
    --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:2.7.1


升级时，请为 --entrypoint="upgrade" 使用相同的 --env DOCKER_API_VERSION=... 参数。

需要自定义生产或高级安装，请查看我们的 Docker 环境变量 文档。你也可以使用公开的 docker-compose.yml 和 .env 文件手动设置环境。

 从旧版本升级

如果您从旧版本升级 A

Top issues

Discussions

Latest release

Appwrite 2.7.1 is a security release that moves the Open Runtimes executor to 1.3.1. It ships with the same 1.2.138 self-hosted Console as 2.7.0, has no schema changes, and upgrading from 2.7.0 only replaces the images.

 Security

- Update the Open Runtimes executor from 1.1.2 to 1.3.1 (open-runtimes/executor269, 15310). Executor 1.1.2 followed symlinks that a function or site plants in its execution log files, build logs, build output or build cache, and it used the runtime's log id without checking it. A function could read files from the executor container, including its environment with _