本文为您提供MaxKB开源企业级知识库问答系统的云服务器部署完全指南。内容涵盖GitHub 15k+ Stars项目介绍...
MaxKB 是一款备受瞩目的开源企业级知识库问答系统，由知名的 1Panel 团队倾力开发。该项目在 GitHub 上已斩获 15k+ Stars，采用宽松的 GPL-3.0 开源协议，社区活跃度极高。作为一款现代化的 AI 知识库工具，MaxKB 支持多种文档格式导入，包括 PDF、Word、Markdown 以及网页链接等。其核心优势在于内置了智能分段、向量化和语义检索功能，能够精准理解用户意图。此外，MaxKB 支持多模型接入，兼容 OpenAI、通义千问、DeepSeek 以及各类本地模型，并提供可视化知识库管理、丰富的 API 接口和便捷的嵌入组件。无论是构建企业内部知识库、智能客服系统，还是个人文档助手，MaxKB 都能完美胜任。
自建 MaxKB 能够带来数据隐私可控、高度定制化以及长期成本优势。以下人群和场景最适合部署 MaxKB：
MaxKB 的核心组件包括 Django 后端、Vue 前端、PostgreSQL 数据库以及向量数据库。由于涉及向量化和语义检索，内存和存储 IO 对性能影响较大。以下是详细的配置建议：
| 配置级别 | CPU | 内存 | 存储建议 | 适用场景 |
|---|---|---|---|---|
| 最低配置 | 2核 | 2G | 40G+ 云盘 | 小型知识库，个人学习测试，低并发访问 |
| 推荐配置 | 2核 | 4G | 50G+ 云盘 | 中型知识库，团队日常使用，支持一定并发 |
| 生产配置 | 4核 | 8G | 100G+ SSD | 大型知识库，企业级高并发，复杂文档解析 |
对于追求极致便捷的用户，可以关注阿里云计算巢或腾讯云 HAI（高性能应用服务）等官方镜像市场。如果当前云厂商的应用镜像库中尚未上架 MaxKB 的专属一键镜像，我们强烈推荐您使用 1Panel 应用商店进行一键安装，或者直接采用下文提供的 Docker 通用部署路径。Docker 部署不仅环境隔离干净，而且后续升级和维护都非常方便，是目前最稳妥、最灵活的部署方式。
无论您选择哪家云厂商，只要服务器安装了 Docker，即可通过以下标准步骤完成 MaxKB 的部署：
docker run -d --name maxkb -p 8080:8080 1panel/maxkbhttp://服务器IP:8080 即可进入 MaxKB 管理后台。admin，默认密码 maxkb 进行登录。Q1：启动后访问 8080 端口无响应怎么办？
A：请检查云服务器的安全组/防火墙规则，确保已放行 8080 端口的 TCP 入站流量。同时可使用 docker logs maxkb 查看容器日志，确认服务是否完全启动。
Q2：2核2G 服务器运行卡顿或报错 OOM 怎么办？
A：2核2G 为最低配置，在导入大型 PDF 或进行复杂向量化时可能会占用大量内存。建议为服务器配置 Swap 虚拟内存，或尽量在低峰期进行文档导入。若业务需求增加，请及时升级至 2核4G 推荐配置。
Q3：如何保证数据不丢失？
生产环境下，建议不要直接使用上述简单的 docker run 命令，而是编写 docker-compose.yml 文件，将 PostgreSQL 数据目录和 MaxKB 配置文件挂载到宿主机目录，以便定期备份。
对于个人开发者或初创团队，首选“轻量应用服务器”。轻量服务器通常自带较高的峰值带宽（如 200M），非常适合 MaxKB 这种需要传输文档和流式输出 AI 回答的应用场景，且价格远低于传统 ECS。例如阿里云 38元/年的轻量服务器，性价比极高。如果是企业正式生产环境，建议选择 ECS 经济型 e 实例或 u1 实例，并搭配 SSD 云盘，以保障数据库和向量检索的 IO 性能。购买时，务必利用“新用户”身份享受首购特惠，并关注“续费同价”的活动，避免后续成本大幅上涨。
想要获取上述优惠价格，请直接访问云厂商官方活动页面。以下是为您整理的最新活动直达链接：
阿里云 2026 年 9 月云服务器特惠活动入口：https://www.aliyun.com/minisite/goods?userCode=tzlh4rrj
腾讯云 2026 年采购季云服务器特惠活动入口：https://cloud.tencent.com/act/cps/redirect?redirect=1003&cps_key=U4Wwh5F3y1uS8pJz
请遵守模型服务商条款与当地法律法规。