功能简介
仓库提供 Docker Compose 与 Kubernetes/Helm 自托管资产，可部署 API、Realtime、Workers、数据库、缓存、存储和计算依赖。它证明存在打包与部署入口，不证明任意目标环境已经完成生产升级、容量、备份恢复、灾备或制品门禁验证。
当前支持范围
- 自托管部署（PARTIAL）：提供 Docker Compose 与 Kubernetes/Helm 自托管资产；生产升级、容量、备份恢复和制品门禁必须由目标环境另行验证。
适用场景
- 在自有网络运行 AppBase。
- 按组织要求控制数据驻留和基础设施。
- 为开发、测试或受控生产环境部署所需组件。
前置条件
- 完成目标环境容量、网络、存储与安全设计。
- 准备数据库、Redis、对象存储、Builder/Executor 等依赖。
- 制定升级、备份、恢复、监控与回滚演练。
Console 操作路径
Self-hosting 主要由部署资产和运维流程完成，不是 Project Console 的单一步骤。Console 只能反映已部署服务是否可访问，不能替代容器、集群、存储和网络验证。
SDK 示例
SDK · TypeScript
import { Client } from 'appbase-node-sdk';
const client = new Client()
.setEndpoint('https://<SELF_HOSTED_APPBASE>/v1')
.setProject('<PROJECT_ID>')
.setKey('<API_KEY>');REST 示例
REST · Bash
curl 'https://<SELF_HOSTED_APPBASE>/v1/health/version'常见错误
| 现象 | 处理建议 |
|---|---|
| 服务启动但业务 503 | 检查依赖健康、Worker、队列、存储、Runtime 和服务发现。 |
| 升级后 Schema/任务异常 | 按经过验证的备份、迁移和回滚流程处理，不执行未审计内部命令。 |
| Realtime/Sites 不可达 | 检查 WebSocket/Proxy/DNS/TLS 与组件部署。 |
| 容量不足 | 使用监控证据扩容目标组件；不要宣称平台自动节点扩缩容。 |
当前限制
- 本轮没有核验目标环境生产升级、容量、备份恢复或灾备。
- 不公开内部 Pool、Migration、Storage Conversion、Credential 或 Runbook。
- 不宣称服务节点自动扩缩容。
Appwrite 兼容说明
Self-hosting 作为分类保持兼容；AppBase 部署资产和组件边界由仓库独立核验。
AppBase 增强说明
AppBase 在自托管形态增加 Organization、AI 数据面等组件选择，但每个依赖都需单独上线验收。
发布状态和验证 Commit
origin/main 条件支持。验证 Commit：0363062a1c7ea08741975bb5ba0c3361663c9353；使用前必须同时满足本页“当前限制”。
权威来源文件列表
origin-main:DEPLOY-k8s.mdorigin-main:deploy/appwrite-helm/Chart.yamlorigin-main:deploy/appwrite-helm/values.yamlorigin-main:docker-compose.yml
Appwrite taxonomy 仅作信息架构参考：https://appwrite.io/docs/advanced/self-hosting。上游页面不是 AppBase 实现证据。