分类导航
发现更多优质 AI 工具
BookStack
BookStack 全解指南一、平台介绍1.1 基本定位性质：MIT 开源免费、自托管式 Web 知识库/维基文档系统。对标产品：Confluence、GitBook。技术栈：基于 PHP+Laravel 框架开发，使用 MySQL/MariaDB 存储数据。源码托管：已从 GitHub 迁移至 Codeberg 托管。核心架构：采用三层经典架构逻辑，即 书架 (Shelves) → 书籍 (Books) → 章节 (Chapters) → 页面 (Pages)，完全贴合图书式内容管理。1.2 相关链接官网地址：https://www.bookstackapp.com在线演示站：https://demo.bookstackapp.com注：演示站数据每 30 分钟自动重置，限制删除用户及修改系统配置。定位总结：轻量化私有化部署知识库，适用于企业内网文档、个人知识库、产品手册、团队 Wiki 首选。二、核心主要功能2.1 双编辑器写作WYSIWYG 富文本编辑器：所见即所得，支持标题、表格、代码块、折叠区块、图片插入。Markdown 编辑器：支持实时预览，原生支持 MD 语法，可一键切换编辑模式。亮点：内置 draw.io（diagrams.net）在线绘图，页面内直接画流程图、架构图，无需跳转第三方工具。2.2 内容管理能力全文全域检索：支持全书/全站搜索，可进行标签筛选、时间筛选、创建人筛选及内容类型过滤（页/章/书/书架）。版本历史：每页自动保存修订记录，可回溯历史、对比修改、回滚内容。多格式导出：支持单页/整书导出 PDF、Markdown、Word、纯文本、HTML。图片集中管理：内置图库，支持分类上传、批量选择图片；可开启图片防盗随机 URL 加密。跨书排序/内容移动：页面可在书籍、章节间自由拖拽移动，支持批量排序。2.3 权限与安全（企业级）基于角色 RBAC 权限：提供全局/单本书籍/单页面三级权限，精细化控制「查看/编辑/创建/删除」。多登录认证：支持默认账号密码 + LDAP/OIDC/SAML2 单点登录 + 第三方社交登录。MFA 多因素认证：支持 TOTP（谷歌/微软验证器）+ 静态备用验证码，可按角色强制开启。全局开关：支持整站公开访问开关、全局评论启停、高安全图片上传加密。2.4 基础配套多语言支持：内置中、英、日、德、法、俄、西等十余国语言，用户可自定义界面语种。主题设置：提供深浅双主题，用户可独立设置浅色或暗黑模式。自定义站点：支持自定义网站名称、Logo、注册开关、首页展示内容。三、适用人群3.1 企业与技术团队（主力用户）研发团队：用于管理接口文档、技术架构手册、运维 SOP。行政人事：用于管理制度手册、员工培训文档。产品团队：用于管理需求文档、产品使用手册，可替代高价 Confluence。3.2 个人用户程序员：建立个人知识库、读书笔记、项目笔记。站长/开发者：建站私有化笔记，替代 Notion 付费空间。3.3 小组织/社团/培训机构用途：管理社团规章制度、课程讲义、培训资料归档。优势：低成本搭建内部文档站。局限性（不适合）：不适用于重度实时多人在线协同文档（无在线协同编辑，偏静态知识库）。不适用于超大附件在线预览（附件仅支持下载）。四、免费与付费情况4.1 软件本体永久免费开源：遵循 MIT 协议，源码完全免费。无功能阉割：无用户数上限、无文档数量限制。无官方 SaaS：BookStack 不提供官方云托管订阅服务，仅能自建部署。授权费：下载部署无任何授权费，自建实例永久免费使用全部官方功能。4.2 潜在自费项（按需自选）服务器成本：自建需要 VPS/云服务器，最低 2.5 英镑低配 VPS 即可流畅运行（唯一硬性花费）。商业技术支持：官方无付费客服，如需定制二开、部署代装，需找第三方服务商付费。域名与 SSL 证书：对外公网访问需自行购买域名，证书可免费申请 Let’s Encrypt。4.3 特别区分注意：国内「书栈网 bookstack.cn」是同名独立项目，非本官网 BookStack，收费规则不通用。五、详细使用指南5.1 阶段一：快速部署（3 种方案）新手建议首选 Docker 方案方案 1：Docker Compose 一键部署环境准备：服务器装好 Docker+Docker-Compose。配置 Docker Compose：新建 docker-compose.yml 配置（最简模板如下）。yamlversion: "3.3" services: bookstack: image: linuxserver/bookstack ports: ["6875:80"] environment: - APP_URL=http://你的 IP:6875 - DB_HOST=mysql - DB_USER=root - DB_PASS=自定义数据库密码 - DB_DATABASE=bookstack volumes: ["./bookdata:/config"] depends_on: [mysql] mysql: image: mysql:8.0 environment: MYSQL_ROOT_PASSWORD: 自定义数据库密码 MYSQL_DATABASE: bookstack version: "3.3" services: bookstack: image: linuxserver/bookstack ports: ["6875:80"] environment: - APP_URL=http://你的 IP:6875 - DB_HOST=mysql - DB_USER=root - DB_PASS=自定义数据库密码 - DB_DATABASE=bookstack volumes: ["./bookdata:/config"] depends_on: [mysql] mysql: image: mysql:8.0 environment: MYSQL_ROOT_PASSWORD: 自定义数据库密码 MYSQL_DATABASE: bookstack 启动服务：执行 docker-compose up -d。访问登录：访问 http://服务器 IP:6875，默认管理员账号：admin@example.com，密码：password（首次登录立刻改密）。方案 2：原生 PHP 手动部署环境：安装 PHP 7.4+、MySQL 5.7~8.0、Nginx/Apache。步骤：拉取源码配置 .env 数据库参数，配置站点伪静态。方案 3：先试用演示站地址：https://demo.bookstackapp.com限制：用内置 admin 账号体验全部功能（无法删用户、改系统设置）。5.2 阶段二：日常基础使用步骤建立顶层分类：首页 → Shelves → 新建书架（例：研发文档、行政制度），用于归类多本书籍。创建书籍：进入书架 → New Book（新建书籍，对应一套完整手册，如《Java 开发规范》）。新建章节：打开书籍 → New Chapter（分大目录，如环境搭建、语法规范）。新建页面（正文）：章节内 → New Page，选择富文本或 Markdown 编辑，支持插入图片、draw.io 图表、代码块。权限配置：书籍/页面右上角 → Permissions，新增角色并配置读写权限。导出分享：页面/书籍 → Export，导出 PDF 分享。用户管理：后台 Settings → Users/Roles，新增成员、分配角色权限。六、部署与使用避坑点（高频踩坑汇总）6.1 部署避坑数据库版本问题：原生兼容 MySQL 5.7~8.0，MySQL 5.6 及以下、MariaDB 新版本易出现连接失败。Docker 优先使用官方配套 mysql:8.0 镜像，不要混用高版本数据库。APP_URL 配置：.env 或 docker 环境变量 APP_URL 必须填写 最终访问域名/IP（带 http/https）。配置错误会导致图片打不开、附件链接失效、跳转异常。端口冲突：默认映射 6875:80，若服务器 80 端口被 Nginx 占用，需更换宿主机端口（如 8080:80）。PDF 导出乱码：原生 Dompdf 缺少中文字体，导出 PDF 中文会出现方框乱码。解决：替换 wkhtmltopdf 渲染引擎或手动导入中文字体包。数据备份：定期备份 /config 挂载目录 + MySQL 数据库。容器删除易丢失数据，建议配置定时自动备份。6.2 日常使用避坑图片公开泄露：默认上传图片 URL 可被外网遍历，敏感文档务必开启「Higher Security Image Uploads（高安全图片加密）」（后台设置 → Features & Security），自动给图片路径加随机密钥串防爬取。注册开关管控：公网部署务必关闭「用户开放注册」，否则爬虫批量注册账号。需要成员加入时由管理员手动创建账号。权限层级误区：书架权限≠书籍权限，书籍单独配置权限会覆盖书架继承权限，涉密文档建议单本书独立锁权限。编辑器切换：单页面选定富文本/Markdown 后不要反复切换，格式易错乱，建议长期固定一种编辑格式。系统升级：版本升级前先全量备份数据库。新版会变更数据表结构，直接升级大概率丢字段报错。附件预览限制：不支持 Office 在线预览，Word/Excel/PDF 附件仅支持上传下载，如需预览需额外集成第三方预览服务。6.3 运维避坑内存要求：服务器内存最低 1G，512M 内存易出现 PHP 内存溢出、打开页面超时。MFA 管理：开启 MFA 后务必妥善保存备用验证码，管理员丢失验证码将无法登录后台。七、补充拓展7.1 二次开发可定制：开源可自定义 LOGO、首页、新增插件。社区资源：社区有汉化优化版可供参考。7.2 替代选型建议想要云端免部署：选 Notion 或石墨。想要在线实时协同：选 OnlyOffice 知识库。
PandaWiki
PandaWiki 全维度使用手册一、平台介绍1. 基础概况PandaWiki 是由长亭科技研发、百智云运营的 AI 原生开源知识库系统。开源协议：遵循 AGPL-3.0 开源协议。部署形式：支持 GitHub 开源项目（chaitin/PandaWiki）及私有化部署。核心优势：主打一站式搭建，支持产品文档、技术 Wiki、客服 FAQ、独立博客四类站点。官方文档：https://pandawiki.docs.baizhi.cloud/node/0197160c-782c-74ad-a4b7-857dae148f842. 开源协议核心规则（AGPLv3）用户在使用本系统时需严格遵守以下规则：免费使用：免费使用、修改代码、商用均无软件授权费。源码开源义务：若修改源码并对外部署（无论是公网还是内网服务），修改后的代码必须同步开源。二次分发：若将程序进行二次分发，必须沿用 AGPL-3.0 协议进行开源。3. 产品定位PandaWiki 与传统知识库软件（如 Confluence、Wiki.js）相比，具有显著差异化优势：轻量部署：支持 Docker 一键部署。原生智能：内置 AI 能力，无需额外配置大模型即可启动基础对话。成本优势：无强制年费，支持私有化存储数据，解决传统系统收费昂贵及数据上云不安全痛点。二、核心主要功能（一）AI 智能化模块（产品核心）这是区别于传统 Wiki 的最大亮点，支持接入多种大模型：AI 辅助创作：支持文档续写、润色、生成 API 文档/FAQ/目录，并允许自定义提示词。AI 语义问答：基于站内知识库内容智能答疑，可嵌入 IM 机器人对外提供问答服务。AI 智能检索：采用语义搜索算法而非简单的关键词匹配，实现跨文档精准定位。模型接入支持：支持接入 OpenAI、DeepSeek、通义千问、Kimi 或 Ollama 本地私有化大模型。（二）文档编辑与导出双格式编辑器：支持富文本、Markdown、HTML 混合编辑，具备实时预览功能。多格式导出：支持 Word、PDF、Markdown、HTML 全格式离线导出。版本管控：提供文档全量历史记录、版本回滚、修改留痕及多人协同编辑功能。（三）内容批量导入（低成本迁移）提供 4 种低成本导入旧文档的方式：文件导入：支持单个或多个离线文件（PDF、MD、Word）。网页抓取：支持单页网页 URL 抓取。整站爬取：支持全站 Sitemap 批量爬取。订阅同步：支持 RSS 订阅自动同步内容。（四）第三方集成能力网页挂件：生成嵌入代码，可挂载至官网或产品页，充当在线帮助中心。IM 机器人：对接钉钉、飞书、企业微信，群内@机器人自动查询知识库并回复。单点登录 SSO：支持对接企业内部 OA 或 LDAP 实现统一账号登录。（五）权限管理（企业合规必备）RBAC 细粒度权限：支持管理员、编辑、只读、访客等多级分级。资源隔离：可按知识库、单文档设置访问权限，支持部门文档隔离。合规场景：满足金融、医疗等行业对数据隔离和访问控制的合规要求。三、适用人群与落地场景1. 企业团队（主力用户）研发/技术团队：用于编写 API 手册、开发规范、故障方案及技术 Wiki，替代 Confluence 以降低部署成本。产品团队：用于管理需求文档、版本说明书及产品手册。客服团队：维护产品 FAQ 与故障排查库，对接企微机器人实现自动答疑。运营/行政：用于沉淀 SOP 流程、规章制度及活动方案库。2. 个人/自由职业者程序员：用于整理个人技术笔记或搭建独立博客。学习者：用于课程资料与读书笔记的结构化归档，利用 AI 快速检索知识点。3. 机构与组织培训机构：构建课件知识库。自媒体：结合独立博客与素材库管理。中小政务单位：构建内部公文库或通知发布平台。四、免费与付费详情1. 开源私有化部署版（永久免费，推荐）此版本遵循 AGPL 协议，适合有运维能力的团队或个人。软件成本：100% 免费，无功能阉割，无用户数限制。允许商用：遵循 AGPL 协议即可商用。自费成本：大模型 API 费用：若使用云端大模型（如 GPT、DeepSeek）按量计费；若使用 Ollama 本地模型则无 API 费。服务器成本：需自备服务器/NAS。个人可用闲置电脑或 NAS 实现零成本部署。2. 百智云 SaaS 托管版（按需付费）适合无运维团队或不想自建服务器的企业。免费试用：提供有限的名额，包含知识库数量及存储空间限制。付费套餐：按团队人数、存储空间及 AI 调用量阶梯订阅。选型建议：有运维能力选私有化免费版；零技术团队选 SaaS 付费版。3. 定制服务收费项目：官方提供私有化定制部署、企业专属二开、等保适配（针对金融/医疗行业）。性质：按项目报价，为可选服务，非强制。五、详细使用指南（从部署到落地 5 步）步骤 1：环境准备硬件最低要求：2G 内存服务器、NAS 或闲置电脑。系统兼容性：支持 Linux、Windows、群晖/极空间 NAS 等环境。环境依赖：建议安装 Docker（一键部署必备）；若无 Docker，可使用官方 shell 脚本安装。步骤 2：一键部署（2 种方式）方式 A：Docker 极简部署（推荐）复制以下命令并在服务器终端执行：bashdocker run -d --name pandawiki -p 8080:80 chaitin/pandawiki docker run -d --name pandawiki -p 8080:80 chaitin/pandawiki 访问地址：服务器 IP:8080注意：系统生成初始管理员账号密码后，请立即登录修改。方式 B：官方一键脚本（NAS/Linux通用）复制以下命令执行交互式安装：bashbash -c "$(curl -fsSL https://pandawiki.docs.baizhi.cloud/install.sh)" bash -c "$(curl -fsSL https://pandawiki.docs.baizhi.cloud/install.sh)" 流程：交互式选择安装目录，自动拉取组件，安装完成后记录内网地址和管理员账号。步骤 3：后台初始化配置配置大模型（必填）：路径：后台 → 系统设置 → 模型配置。操作：填入 API 密钥（云端模型）或 Ollama 本地地址（如 http://ollama:11434）。验证：测试连通性并保存。创建知识库：操作：新建分类（如产品库、技术库、FAQ 库）。权限：设置对应成员组的权限。基础参数设置：修改站点名称、域名及前台主题（前台供用户访问，后台供编辑使用）。步骤 4：文档导入与内容创作存量文档处理：使用 URL、Sitemap 或批量文件导入历史资料。新建文档：利用编辑器书写，或使用 AI 一键生成初稿。对 AI 生成内容进行优化和审核。分类管理：按目录树结构对文档进行归档。步骤 5：对外落地使用对内协作：添加团队成员，分配读写权限。对外服务：发布公网域名作为官网帮助中心。生成网页挂件嵌入官网。配置钉钉/飞书机器人，实现群内智能问答。六、实操避坑清单高频踩坑点与解决方案，请务必收藏查阅1. 部署类风险❌ 坑 1：默认 80 端口被占用现象：Nginx 或 Apache 占用 80 端口，导致 PandaWiki 页面无法打开。✅ 方案：部署时修改映射端口，例如 -p 8090:80，并使用新端口访问。❌ 坑 2：服务器内存不足现象：服务器内存小于 2G，启动后频繁崩溃。✅ 方案：扩容内存；个人 NAS 优先使用 4G 以上闲置设备，并关闭多余容器以释放资源。❌ 坑 3：忘记初始管理员密码✅ 方案：进入 Docker 容器，通过环境变量重置 ADMIN_PASSWORD 密码。2. AI 配置风险❌ 坑 1：AI 无响应现象：配置大模型后 AI 无法调用，问答无反应。排查：检查 API 密钥是否正确、接口地址是否写错、模型余额是否耗尽；本地 Ollama 需提前拉取对应模型（如 ollama pull qwen）。❌ 坑 2：回答内容无关✅ 方案：开启“知识库绑定向量检索”，限制 AI 仅基于站内文档作答，关闭全局大模型自由生成模式。3. 内容与迁移风险❌ 坑 1：批量导入乱码现象：大批量 Sitemap 导入导致文档乱码或丢失。✅ 方案：分批导入（单次建议不超过 50 页），导入前备份原文档，并确保站点编码设置为 UTF-8。❌ 坑 2：AI 内容错误现象：过度依赖 AI 自动生成导致内容错误。✅ 规范：AI 生成初稿后必须人工校验、修改后再发布上线。4. 开源合规与商用风险（AGPL 协议红线）❌ 坑 1：商用不开源源码现象：修改源码后私有化对外提供服务（内网/公网），但不公开源码。✅ 方案：必须将修改后的源码托管至 GitHub 或 Gitee 进行开源；仅本地单机自用且不对外提供服务，无需开源。5. 权限与安全风险❌ 坑 1：权限过大导致泄露现象：全团队开放管理员权限，导致敏感技术文档泄露。✅ 方案：实施精细化 RBAC，编辑仅可修改对应知识库，普通成员设为只读，核心资料单独设置白名单。❌ 坑 2：公网部署无防护现象：部署公网未修改默认密码，被恶意入侵。✅ 必做：首次登录即修改为高强度密码；公网部署添加反向代理和防火墙，限制后台 IP 访问。6. 运维风险❌ 坑 1：数据丢失现象：从不备份数据库，容器误删后文档全丢。✅ 方案：每周定时备份容器内 PostgreSQL 数据库，备份文件存放至异地（云盘/NAS）。七、补充资源官方文档：https://pandawiki.docs.baizhi.cloudGitHub 开源地址：https://github.com/chaitin/PandaWiki社区交流：百智云论坛 https://baizhi.cloud/discussion交流群：官方微信交流群
Open WebUI
Open WebUI 全指南一、平台介绍1. 基础数据开源协议：遵循 Apache2.0 开源协议，开源免费。社区规模：GitHub 拥有 140K+ Star，41.9 万社区成员，全球下载量 2.9 亿+。版本迭代：当前为最新 v0.8+ 版本（注：资料提及 2026 年更新），社区活跃，持续迭代。技术架构：前端：Svelte后端：Python系统支持：Windows / macOS / Linux部署方式：Docker / K8s 容器部署 / GPU 硬件加速核心定位：自主可控 AI 操作台。不租用云端 AI，数据全部留存本地。支持离线单机运行或云端服务器部署，统一管理本地、Ollama、OpenAI、Anthropic、OpenRouter 等全兼容 API 模型。官网地址：openwebui.com2. 核心优势隐私安全：数据私有化，不上传云端。全兼容：统一接口对接各类模型。灵活部署：单机或服务器均可运行。二、核心主要功能1. 多模型统一接入（核心功能）单界面统一对接所有主流大模型，支持一键切换与配置：本地模型类：支持 Ollama、LM Studio、vLLM、HuggingFace 本地部署模型。云端 API 类：支持 OpenAI、DeepSeek、Anthropic、Groq、OpenRouter 等所有 OpenAI 兼容接口。配置方式：右上角头像进入管理员面板，直接配置 API 密钥与接口地址。2. 内置 RAG 私有知识库（王牌功能）文档支持：支持 PDF、Word、TXT、Excel 等多种格式上传。向量库对接：支持 Chroma、PGVector、Qdrant 等 9 种向量数据库。功能亮点：聊天时自动检索私有文档。提供引用来源标注。适合搭建企业内部知识库问答系统。3. AI 增强工具集联网搜索：内置 15+ 搜索源（如 DuckDuckGo、Bing），支持自建 SearXNG 免费本地搜索，AI 可实时查询外网信息。多模态能力：支持语音输入输出、图片识图、AI 绘图。内容渲染：支持 Markdown 排版、LaTeX 公式渲染、代码高亮、代码运行沙箱。自定义扩展：支持 Python 自定义函数/工作流、加载社区共享提示词、插件及工具脚本。4. 企业级用户与权限管控权限管理：RBAC 细粒度权限控制，管理员可新建分组。功能限制：可限制用户可用模型、知识库、搜索功能。安全登录：支持 SSO 单点登录、OAuth 第三方登录、聊天审计日志、注册白名单，适合金融/政企等合规行业。5. 社区生态 & 配套内置社区 Hub：免费下载社区分享的提示词、模型配置、自定义工具、角色人设。模型竞技场：支持多模型同台对比回答效果。移动端访问：支持 PWA 移动端访问，手机离线使用。三、适用人群1. 推荐用户个人 AI 爱好者/程序员：本地免费跑开源大模型（如 Llama3、Qwen、Mistral），自建私有 ChatGPT，保护对话隐私。职场/科研人员：上传行业资料构建知识库，AI 辅助论文、文档、资料检索。中小企业/创业团队：私有化部署团队 AI 中台，内部文档问答，避免企业数据外流至第三方 AI 平台。AI 服务商/运维：统一管理多渠道 API 模型（OpenAI+ 本地开源混合部署），管控员工调用权限、统计 Token 消耗。教育/实验室：构建课堂私有化 AI 环境，支持离线教学大模型实训。2. 不适合人群零硬件条件用户：无法自备服务器或电脑的普通用户。不想部署用户：只想开箱即用云端 AI 服务的用户。无模型资源用户：无法下载本地模型资源，完全依赖外部网络的用户。四、免费&付费详情1. 全功能永久免费（99% 用户适用）软件本体：100% 开源免费。功能范围：所有核心功能（聊天、RAG、多模型接入、权限、搜索、自定义插件）无功能阉割、无试用期限、无广告。商用权利：个人/商用完全免费，可二次修改源码。社区资源：社区提示词、工具、配置全部免费下载。2. 唯一隐性成本：模型本身费用本地 Ollama 开源模型：完全免费，仅消耗本机硬件（CPU/GPU）资源。对接云端 API：按平台官方 Token 计费（如 OpenAI、DeepSeek 等），Open WebUI 平台本身不抽成。3. 付费项目说明（企业增值服务）官方无软件订阅费：不存在软件收费订阅。付费内容：仅为企业商业技术支持。服务项目：包括定制部署、安全加固、7×24 运维、合规审计服务、私有化定制开发等（按需采购，个人用户完全不需要）。五、详细使用教程（2 种主流安装方式，新手优先 Docker）1. 环境最低配置内存：≥4GB（推荐 8GB+）磁盘：≥20GBGPU 建议：跑 7B 以上大模型建议 8G+ 独立显存 GPU系统：Windows / macOS / Ubuntu / CentOS前置准备：如需本地跑模型，建议提前安装 Ollama。 安装命令：curl -fsSL https://ollama.com/install.sh | sh2. 方式 1：Docker 一键部署（推荐，全平台通用）bashdocker run -d -p 3000:8080 \ --add-host=host.docker.internal:host-gateway \ -v open-webui:/app/backend/data \ --name open-webui \ --restart always \ ghcr.io/open-webui/open-webui:main docker run -d -p 3000:8080 \ --add-host=host.docker.internal:host-gateway \ -v open-webui:/app/backend/data \ --name open-webui \ --restart always \ ghcr.io/open-webui/open-webui:main 参数详解：3000：访问端口（可自行修改）。open-webui：本地数据持久化挂载目录。main：镜像版本标签。启动后：浏览器访问 http://localhost:3000。首次注册：注册账号后自动成为超级管理员。3. 方式 2：Python pip 原生安装（无 Docker 环境）bash# 1. 安装 Python 3.10~3.11，创建虚拟环境 pip install open-webui # 2. 启动服务 open-webui serve # 访问：http://localhost:8080 # 1. 安装 Python 3.10~3.11，创建虚拟环境 pip install open-webui # 2. 启动服务 open-webui serve # 访问：http://localhost:8080 升级服务：pip install -U open-webui 一键更新版本。4. 初次配置三步对接 Ollama 本地模型路径：右上角头像 → 管理员面板 → 设置 → 模型Ollama 地址：默认填写 http://host.docker.internal:11434操作：提前在 Ollama 运行 ollama pull qwen:7b 下载模型。对接云端 API同页面添加 OpenAI 密钥（API Key）及接口地址。新建知识库（RAG）路径：侧边栏“知识库” → 新建 → 上传文档 → 创建向量库。聊天时：在聊天页选择对应知识库即可实现 RAG 问答。六、部署&使用避坑清单（高频踩坑汇总）1. 网络&连接坑（最高发）Docker 容器连不上宿主机 Ollama原因：容器无法访问宿主机 127.0.0.1。解决：Ollama 启动前配置 OLLAMA_HOST=0.0.0.0 并运行 ollama serve；或 Docker 使用 --network host 宿主机网络模式启动容器。HuggingFace 模型下载失败解决：Docker 启动添加镜像环境变量 -e HF_ENDPOINT=https://hf-mirror.com，走国内 HF 镜像加速下载。远程服务器无法访问 WebUI 页面解决：服务器防火墙放行端口（如 3000/8080）：ufw allow 3000/tcp，云服务器安全组放行对应端口。2. 端口&存储坑端口被占用启动报错 Address already in use解决：修改 docker 参数 -p 自定义端口:8080（如 -p3001:8080）；使用 lsof -i:端口号 查询占用进程并关闭。Docker 数据丢失警示：不要删除挂载目录 open-webui。重装容器时，保留挂载卷（Volume）即可保留聊天记录与知识库。3. 硬件&性能坑低配置电脑卡顿、模型加载失败建议：4G 内存仅推荐 1.5B 小模型；7B 及以上模型必须 8G+ 显存 GPU；无 GPU 仅 CPU 跑模型速度极慢。RAG 文档过大报错限制：单文件不建议超 500MB；超大文档建议拆分上传。优化：关闭「全文直传」，开启分块向量化。4. 配置&使用坑API 调用报错密钥无效排查：核对接口地址/密钥；OpenRouter 等第三方 API 地址不要写错。AI 回答乱码/非中文解决：全局系统提示词添加：你全程使用中文回复用户问题。升级后功能异常建议：升级前备份挂载目录数据；大版本跨代升级建议重建容器。5. 安全避坑公网直接裸奔 8080 端口风险：外网部署直接暴露端口存在安全风险。加固：务必使用 Nginx 反向代理 + HTTPS 证书，设置高强度管理员密码，关闭公开注册，开启注册白名单。Ollama 默认全外网开放风险：内网使用限制 IP 访问，避免公网随意调用本地模型。七、补充小贴士国内模型推荐：优先搭配 Ollama + 通义千问/Qwen/DeepSeek 开源本地模型，实现零 API 费用。免费联网搜索：需部署 SearXNG 对接 Open WebUI，无需购买付费搜索 API。移动端体验：浏览器打开网页添加到桌面，开启 PWA，实现类 APP 使用体验。模型选择建议：入门体验：Qwen-7B / Llama3-8B。企业知识库：建议使用 Qwen-14B 或更大模型以获得更好的中文理解能力。
AnythingLLM
AnythingLLM 全解指南一、平台介绍1.1 核心背景与定位开发团队：美国 Mintplex Labs 开发。开源协议：MIT 开源免费协议，GitHub 星数 61K+，完全开源。核心定位：本地私有 ChatGPT + 全能知识库系统。主要目标：一站式 RAG 智能 AI 应用，主打全本地私有化、任意大模型接入、全文档知识库问答。底层原理：整合「大模型 + 嵌入模型 + 向量库 + AI Agent」，无需代码即可搭建私有知识库。1.2 核心工作原理RAG 技术：检索增强生成（Retrieval-Augmented Generation）。数据存储：所有数据默认本机存储，不上传第三方服务器。处理流程：将 PDF/文档/网页转为向量存入本地向量库 → 提问时检索文档 → 大模型作答。部署形态：支持桌面客户端（Windows/Mac/Linux）、Docker 自托管、官方云托管三种方案。二、核心主要功能2.1 全模型兼容支持本地模型：完美对接 Ollama、LM Studio、LocalAI（支持通义千问、DeepSeek、Llama、Qwen 全系列开源模型）。云端 API：支持 OpenAI、Azure、AWS、Claude、智谱等国内外商用大模型 API。多模态支持：单界面混用文本/图文/音频大模型，支持图片解析、音频转写及文档分析。2.2 全格式文档知识库（RAG 核心）支持格式：PDF、Word、TXT、CSV、Excel、代码项目、Markdown、网页 URL、音视频。入库方式：本地上传文件。网页抓取 URL。Github 项目批量导入。工作区隔离：支持独立多工作区，不同项目/部门建独立知识库，文档、模型、聊天数据完全隔离互不干扰。对话模式：聊天模式：长上下文闲聊 + 文档参考。查询模式：精准检索知识库，精简答案，适合资料查阅。2.3 隐私与部署能力默认全本地化：模型、文档、聊天记录、向量数据全部本机存储，无强制云端上传，无需注册账号即可使用桌面版。向量数据库：默认内置 LanceDB（本地轻量向量库，免费），可外接 Pinecone、Weaviate 等云端向量库。2.4 团队与企业能力多用户租户：自托管/Docker 版支持多人登录，管理员可精细化管控权限（限制查看/上传）。白标定制：企业可替换 LOGO、品牌名称，支持私有化贴牌。开放接口：内置开发者 API，可嵌入自有网站、小程序或业务系统。AI Agent：支持安装社区插件、自定义系统提示词、设置 Slash 快捷指令（如 /optimize、/explain）。2.5 扩展生态社区 Hub：支持一键安装自定义 Agent、系统 Prompt 模板、插件（如联网搜索、代码解析等）。三、适用人群1. 个人用户（免费首选）职场办公：整理合同、报表、读书笔记、行业资料，搭建私人文档 AI。学生/科研：建立论文、文献、课本知识库，进行精准答疑和文献总结。技术爱好者：本地部署开源大模型，打造无隐私泄露的私人 AI。2. 中小企业/团队（Docker 自托管）行政/法务：公司规章制度、合同库智能问答。技术团队：项目代码库、接口文档、运维手册智能检索。销售客服：产品手册、FAQ 知识库，用于内部培训或售前问答。3. 开发者与服务商AI 开发：通过 API 快速集成 RAG 能力到自有产品。外包服务商：利用白标贴牌功能，为客户搭建私有化知识库系统。4. 涉密与隐私敏感行业适用领域：律所、医院、金融、军工等。核心需求：数据禁止外流，必须本地部署 AI。四、免费与付费详情1. Desktop 桌面版（推荐个人使用）资费：永久免费，开源无功能阉割（MIT 协议）。限制：单设备单机使用，不支持多用户协作。成本：本地模型：仅耗电脑硬件，无任何软件费用。云端 API：仅在使用 GPT4/DeepSeek 等付费模型时按 Token 计费，AnythingLLM 本身不抽成。无文档数量、人数限制，无订阅费。2. Docker 自托管版（企业自建）资费：软件本体永久免费开源。成本：需自费云服务器（4 核 8G 起步，国内轻量云约 60~120 元/月），可选付费向量库。优势：无限多用户、白标、全企业功能、无官方订阅费。3. 官方云托管版（官方云）资费：起售价 25 美元/月起（约 180 元人民币），按用户数/资源档位阶梯涨价。内容：包含服务器运维、版本更新、技术售后。适用：不想运维、快速上线 AI 知识库的小微企业。五、详细使用教程（新手最简流程）阶段一：环境准备与安装下载安装：访问官网 https://www.anythingllm.com/desktop 下载对应系统安装包（Windows/Mac/Linux）。注意：一键安装，无需注册账号。配套模型（推荐）：下载并安装 Ollama（https://ollama.com/download）。终端执行：ollama pull qwen2.5:7b（下载通义千问 7B 本地模型）。建议下载嵌入模型：ollama pull nomic-embed-text。阶段二：初始化配置启动软件：打开 AnythingLLM → 进入 Get Started 向导。配置模型：LLM 提供商选择【Ollama】，软件会自动识别已下载的模型。Embedding 模型建议选择中文嵌入模型（避免默认英文模型中文效果差）。创建工作区：点击新建工作区（Workspace），命名（如「合同知识库」）。一个工作区对应一套独立的文档与数据。阶段三：导入与搭建知识库进入工作区：点击【导入数据】。选择导入方式：本地上传：拖入 PDF/DOCX/TXT 等文件。网页抓取：粘贴 URL 自动抓取全文。项目导入：输入 Github 链接导入代码库。处理与索引：勾选文件 → 点击 Move to Workspace。软件自动切片、向量化并存入本地向量库。技巧：可勾选文档置顶（图钉图标），强制开启知识库引用。阶段四：日常使用与进阶提问：在聊天框直接输入（如「总结这份合同的违约责任」），AI 自动调取文档作答。快捷指令：输入 /explain 一键解析内容。输入 /format 一键排版。Docker 多用户部署（进阶）：安装 Docker。拉取镜像：docker pull mintplexlabs/anythingllm。映射端口 3001 并启动。浏览器访问 localhost:3001 即可开启多用户管理。六、避坑指南（高频问题与解决方案）1. 文档问答不准、AI 瞎编❌ 坑点：使用默认内置英文嵌入模型，中文文档向量化效果差。✅ 方案：替换为 nomic-embed-text 或 bge-small-zh 中文嵌入模型（Ollama 一键下载）。❌ 坑点：PDF 为扫描件（图片型），直接上传无法识别文字。✅ 方案：先用 OCR 工具将扫描件转文字版再上传。❌ 坑点：文档过大或过长，切片检索失效。✅ 方案：单文档超过 200 页建议手动拆分，或开启自动分段功能。2. 本地模型下载慢、硬盘爆满❌ 坑点：Ollama 默认在 C 盘存模型，空间不足。✅ 方案：设置系统环境变量 OLLAMA_MODELS 将模型存储路径指向 D/E 盘。❌ 坑点：盲目下载超大模型（32B/70B），低配电脑跑不动。✅ 方案：16G 内存优先选 7B 量化版，24G 以上内存再考虑 14B 或更大模型。3. 硬件性能瓶颈❌ 坑点：仅用 CPU 跑 32B 大模型，卡顿严重。✅ 方案：N 卡（NVIDIA）开启 GPU 加速；若无独显，改用云端 API（按量付费）。4. 部署与版本兼容❌ 坑点：使用了老旧版本安装包，不兼容最新模型。✅ 方案：务必从官网下载最新桌面安装包。❌ 坑点：Docker 部署直接映射 C 盘存储。✅ 方案：自定义映射文件夹路径，避免占用系统盘空间。5. 隐私与付费隐性坑❌ 坑点：误绑定 OpenAI 密钥，导致大量提问产生高额 API 扣费。✅ 方案：新手先用 Ollama 本地免费模型测试，稳定后再接 API。❌ 坑点：误开云端向量库 Pinecone 并开启自动计费。✅ 方案：个人用户默认使用 LanceDB 本地向量库，无需外接付费库。6. 工作区管理混乱❌ 坑点：所有文档丢进一个工作区，文档混杂导致检索错乱。✅ 方案：按项目或分类新建独立工作区（如「财务」、「人事」分开建库）。七、官方 FAQ 关键信息数据安全性：桌面版存储文件全在本机文件夹，不会上传官方服务器。离线支持：本地 Ollama 模型 + 本地文档 + 本地向量库，断网环境下完全可用。商用权限：遵循 MIT 协议，可商用、可二次修改、支持白标贴牌，无版权限制。