---
id: "zh/architecture"
title: "系统架构"
language: "zh"
description: "介绍前端、客户端、后端、数据库、对象存储、备份和服务拆分架构。"
canonical_url: "https://www.babel.cc/public/babelwiki/zh/architecture.html"
markdown_url: "https://www.babel.cc/public/babelwiki/ai/zh/architecture.md"
alternates: {"en": "https://www.babel.cc/public/babelwiki/ai/en/architecture.md", "zh": "https://www.babel.cc/public/babelwiki/ai/zh/architecture.md"}
reading_note: "文档记录不等于当前部署能力；以实际版本、授权模块与配置为准。保留原文的可选、限制及待确认说明，勿补猜接口。 / Documentation is not a guarantee for every deployment. Preserve optional-module requirements, limitations and unresolved API contracts."
---

# 系统架构

巴别鸟将企业文件管理、内容协作与数据存储分为不同服务层。部署时应分别规划业务服务、数据库、文件存储、搜索及预览转码，并按已启用的功能增加 AI、OCR 和第三方集成服务。

![应用服务与分布式存储架构](https://www.babel.cc/public/babelwiki/assets/images/object-storage-cluster.jpg)
*白皮书中的集群架构示意。实际节点数量与冗余方式应以实施方案为准。*

## 服务分层

| 层级 | 职责 | 部署关注点 |
| --- | --- | --- |
| 用户入口 | Web、桌面及移动客户端，提供文件浏览、协作、同步和映射盘入口 | 各终端功能与操作系统支持范围以对应版本为准 |
| 应用服务 | 账号、组织、权限、文件操作、分享、项目及审批等业务 | 按并发、业务量及可用性要求拆分或增加节点 |
| 数据库 | 保存业务记录、组织权限及文件元信息 | 需要数据库服务；标准部署与高可用部署的主备要求不同 |
| 文件存储 | 保存文件内容与版本数据 | 可按方案使用对象存储、共享存储或挂载盘，规划容量与备份 |
| 搜索与转码 | 建立检索索引，生成文档、图片等预览内容 | 文件数量、格式及并发影响资源需求；特殊格式需对应模块 |
| 异步处理 | 上传后处理、任务队列与自动化任务 | 关注排队、失败重试、运行日志和积压监控 |
| AI 与 OCR | 文本识别、向量索引、知识检索及模型调用 | 按启用模块选本地算力或经授权的外部模型 API |

## 客户端与服务端协作

客户端负责本地交互、传输、同步与映射盘等功能，服务端负责权限判断、业务处理和云端数据保存。离线缓存或本地保存不等于文件已成功上传，应通过传输状态和云端版本确认结果。

白皮书记录了 Web、桌面与移动端的技术栈及服务化拆分方式，属于文档编写时的实现说明，不代表所有版本都采用相同组件或依赖版本。技术选型、国产化兼容与组件授权应在实施时核对。

## 数据库和文件存储不能互相替代

数据库保存业务与权限等结构化数据；对象存储保存文件内容。阿里云、华为云等“云平台部署”仍然需要数据库，可按实施支持范围使用独立数据库服务器或合适的托管数据库。不能只准备云服务器与对象存储而遗漏数据库。

缓存与监控按规模和方案选配，不能把高可用/K8S 示例中的所有组件都当成基础单机部署的强制项。数据库兼容范围、主从方案及部署规格见[配置建议](https://www.babel.cc/public/babelwiki/zh/configuration-advisor.html)。

## 高可用、备份与安全

多节点、主备切换和冗余存储用于降低单点故障影响；独立备份用于在误删、损坏或攻击后恢复。两者需要配合，并验证数据库、文件、配置与证书的恢复一致性。历史运行记录不等于永久零故障承诺。

访问入口应使用 HTTPS，账号和文件权限贯穿搜索、预览、下载及第三方调用。对外模型调用、分享和集成需明确数据范围与企业安全策略。

## 相关方案

[高可用部署](https://www.babel.cc/public/babelwiki/zh/deployment-high-availability.html) · [对象存储](https://www.babel.cc/public/babelwiki/zh/deployment-object-storage.html) · [数据摆渡](https://www.babel.cc/public/babelwiki/zh/deployment-data-ferry.html) · [开发 API](https://www.babel.cc/public/babelwiki/zh/developer-api-overview.html) · [AI 部署](https://www.babel.cc/public/babelwiki/zh/ai-deployment-customization.html)