网站Logo

分类导航

发现更多优质 AI 工具

全部 编程代码 创作写作 视频音频 图像视觉 学习辅导 办公效率 设计创意 大模型 提示词 Skills 自动化 知识库 开源&免费 副业
AppFlowy图标

AppFlowy

AppFlowyAppFlowy 是开源免费、数据自主可控的 Notion 平替 AI 协作工作台，主打本地存储、私有化部署、全平台离线使用。其遵循 AGPL-3.0 开源协议，核心优势在于用户 100% 掌控自有数据、无厂商锁定。一、平台基础介绍1. 产品定位开发背景：由全球社区共建（10000+ 社区成员、215 个国家、400+ 开发者）。技术架构：基于 Flutter 前端 + Rust 后端开发。对标对象：对标 Notion 一站式知识库 + 项目 + 任务 + 团队协作工具。核心卖点：隐私优先、全开源、本地 AI、离线可用、高度自定义。2. 支持终端桌面端：支持 Windows / macOS / Linux。移动端：支持 iOS / Android。网页端：支持浏览器访问。部署方式：支持 Docker 自托管部署，多端数据无缝同步。3. 核心产品理念数据主权：所有数据归用户所有，可本地存、可自建服务器部署。AI 隐私：内置 AI 助手，支持本地部署大模型，不用把文档上传第三方云端即可调用 AI 处理内容。二、核心功能明细（一）文档 & 知识库（Wiki）块级富文本编辑器：支持 Markdown 编辑。支持图片、音视频、表格嵌入。支持分页嵌套、多层级页面搭建个人知识库。页面自定义：自定义主题、字体、页面样式。支持深色 / 浅色模式切换，自由排版布局。全格式导出：支持 Markdown、PDF 等主流格式导出文档。（二）数据库 & 项目任务管理多视图数据库：支持 表格、看板、画廊、日历 4 种视图自由切换。自定义字段（文本、日期、单选、附件），拖拽调整任务/数据。项目拆解：支持拆分项目 → 子任务 → 待办清单。自动统计项目进度，批量管理任务库。AI 自动填表：一键 AI 批量填充数据库。海量数据表自动提炼数据洞察、生成工作总结。（三）AppFlowy AI（核心亮点）云端 API 调用：接入 GPT-5、Gemini2.5、Claude3.7 等主流模型。实现文案润色、头脑风暴、内容总结、问答检索。本地离线 AI：支持本机部署 Mistral7B、Llama3 开源大模型。不上传任何文档到外网，私密内容本地 AI 处理，极致隐私。全局页内 AI：选中任意段落，一键扩写、改写、提炼要点、生成行动项。（四）协作与存储团队实时协作：支持多人同页编辑、权限管控、跨设备同步。异地团队云端协作。三种存储方案：本地离线：100% 离线使用，数据存在本机硬盘。官方云：AppFlowy 云端同步（分免费/付费订阅）。自建私有云：Docker 自托管，部署在个人 VPS/公司服务器，完全自主管控。（五）拓展生态海量官方/社区模板：提供项目管理、读书笔记、日程表、简历、产品需求文档等模板。插件自定义：社区插件市场安装日历、自动化、第三方集成插件。三、适用人群✅ 首选人群个人知识爱好者/学生：考研笔记、读书笔记、个人日程、档案管理，重视隐私不想笔记上传大厂云端。自由职业/创作者：文案素材库、选题库、项目排期，本地 AI 私密生成稿件。中小型创业团队/小公司：产品、研发、行政搭建内部知识库、项目看板，低成本替代 Notion 付费订阅。数据敏感行业（法务/科研/涉密）：文档不能外流，需要本地部署、私有化存储，拒绝厂商数据托管。技术爱好者/程序员：开源二开、自建专属协作系统，Docker 私有化部署、二次定制开发。❌ 不适合人群大型集团：上万人大规模协同（企业级权限、复杂审批功能不完善）。重度依赖第三方：重度依赖飞书/钉钉深度集成的用户（目前集成深度不足）。四、免费&付费方案1. 永久免费权益（本地离线版，无任何限制）全功能无阉割：文档、数据库多视图、基础 AI 本地部署、无限页面、无限存储空间。无人数限制：个人/小团队本地文件互通，永远免费，无空间、页面上限。开源代码自由下载、修改、私有化部署。2. 官方云端订阅（需要跨设备云端同步、团队在线协作选付费）免费云版价格：0 元权益：单账号、5GB 云端存储空间、基础云端同步、少量 AI 额度、模板限量。Pro 个人版价格：约 $8/月（年付优惠）权益：无限云空间、全量 AI 调用额度、全部模板、移动端全功能同步、优先客服。Team 团队版价格：$12/人/月权益：团队成员管理、精细化权限、团队共享空间、专属云端同步、团队 AI 套餐、自建域名。3. AI 额外付费说明本地部署开源大模型：如 Llama3/Mistral，完全免费，仅消耗本机硬件资源。调用闭源 API：如需调用 GPT/Claude 等，需自行在对应厂商充值 API Key 填入 AppFlowy，按第三方计费扣费，平台不抽成。五、分步使用指南（新手快速上手）步骤 1：下载安装普通用户：访问官网 appflowy.com→Download，选择对应系统安装包（Windows exe/macOS dmg/Linux AppImage）；移动端应用商店搜 AppFlowy。Mac 极简安装：打开终端执行 brew install --cask appflowy 一键安装。技术用户：使用 Docker 部署 (docker run + 挂载命令)，自建私有服务。步骤 2：初次启动，选择存储模式个人自用：选Local 本地存储，数据存电脑，全程离线免费。多设备同步：注册 AppFlowy 账号，选择官方云存储。企业私有化：选择 Docker 自托管，对接自有服务器。步骤 3：创建工作区&页面新建 Workspace（工作空间）：按场景拆分，如「工作项目」「私人笔记」「考研资料」，一个工作区对应一套独立知识库。新建页面：可创建空白页，或套用模板（项目看板、读书笔记模板一键生成）。步骤 4：数据库搭建&视图切换插入数据库：在页面内插入 Database 数据库块，自定义字段。切换视图：顶部切换表格/看板/日历视图，拖拽卡片调整任务进度。步骤 5：AI 配置二选一云端 AI：设置→AI 设置→填入 OpenAI/Claude API 密钥，直接在线调用。本地 AI：下载 Mistral/Llama 模型文件，软件内选择本地模型路径，离线运行 AI。步骤 6：团队协作团队成员注册账号。主账号邀请加入工作区，分配只读/编辑/管理员权限。开启多人实时协同。六、避坑指南（高频踩坑 + 解决方案）1. 存储坑：选错存储丢数据问题：新手误选官方云，免费云只有 5G，满了无法同步；换设备找不到本地文档。解决：个人优先本地存储，重要文档手动备份文件夹；需要云端同步再开付费 Pro。2. AI 使用坑：云端 API 扣费失控问题：填入 GPT API 后无用量管控，大量 AI 调用超额扣费；国内网络无法直连 OpenAI。解决：私密内容优先本地开源 AI（免费）；云端 API 设置用量限额，国内优先使用 Gemini 国内可用模型。3. 性能坑：海量文档卡顿问题：单个数据库上万条数据、百页嵌套文档后低配电脑加载变慢。解决：大项目拆分多个工作区，拆分数据库，不用单页堆砌全量数据；自托管用户升级服务器配置。4. 功能坑：对标 Notion 但功能仍不完善问题：部分高级功能（自动化工作流、复杂表单、第三方深度集成）缺失，不如 Notion 成熟；移动端部分视图适配一般。解决：刚需复杂自动化搭配外部插件，不要指望原生一步到位；重要项目先用桌面端搭建。5. 自托管坑：新手 Docker 部署失败问题：小白无运维基础，自建服务器部署报错、端口/挂载配置出错。解决：新手先用本地版，有运维基础再尝试 Docker，参考官方部署文档。6. 同步坑：多端同步延迟问题：免费云服务器在海外，国内移动端同步缓慢、偶尔断连。解决：国内用户优先本地 + 手动网盘备份；团队刚需选 Pro 付费云，或自建国内服务器私有化。七、优缺点总结优点✅ 本体永久免费开源：客户端本体永久免费，代码可看。✅ 数据完全自主：数据不上传第三方，自主备份。✅ 本地 AI 不上传隐私：支持本地部署模型，保护文档隐私。✅ 全平台 + 离线可用：支持桌面、移动端，支持断网使用。✅ 高度自定义：无厂商锁定，无强制订阅。缺点❌ 高级协作功能少于 Notion：审批流、复杂权限等不如 Notion 完善。❌ 免费官方云国内同步不稳：国内用户需自建或使用 Pro 版。❌ 自托管有技术门槛：需要一定的运维能力。❌ 闭源 AI 需要自备 API：使用云端 API 时需自行准备密钥。

 AFFiNE图标

AFFiNE

AFFiNE全平台使用指南一、平台基础介绍1. 核心定义 AFFiNE 是由万有理论科技（杭州）ToEverything 团队研发的国产开源 All-in-One 全能知识工作空间（KnowledgeOS）。它对标的是 Notion、Miro 及多维表格的三合一产品，目前在 GitHub 项目拥有超 59K Star，并曾登顶 Product Hunt 当日最佳产品。2. 核心设计本地优先（Local-First）：数据默认优先保存在本机，不强制上公有云，主打隐私自主可控。离线全功能：支持离线编辑与全功能使用，适合网络环境不佳场景。开源协议：采用 MIT 协议，可免费查看源码，支持私有化部署。3. 产品定位 一站式完成文档写作、自由白板手绘、多维数据库、项目任务管理、AI 辅助创作，旨在帮助用户告别多软件来回切换，既适合个人用户，也通用于中小团队。4. 客户端覆盖桌面端：Windows / macOS / Linux移动端：Android / iOS获取方式：访问官网 affine.pro 可直接下载安装包。二、五大核心功能详解1. 模块化富文本文档（对标 Notion）全块式编辑：所有内容均由文本、标题、列表、引用、附件、表格、代码块等基础积木组成。标题层级：支持 H1 到 H6 六级标题。高级功能：支持待办清单、书籍读书笔记模板、双向内链 [[页面名]]。知识库搭建：支持跨文档引用段落，适合构建网状知识库（类似 Roam Research），适用于读书笔记、文稿撰写及知识沉淀。2. 无限画布白板（对标 Miro）无边框模式：文档页面可一键切换白板模式（Edgeless），在文档里随手涂鸦。创作内容：支持手绘流程图、思维导图、头脑风暴。协作与模板：支持多人实时同屏手绘协作，内置行程规划、故事板现成模板。适用场景：旅行清单、选题脑暴、方案草图一站式落地。3. 多维数据库与项目管理（对标 Airtable+Trello）四种视图：单数据库支持表格、看板、画廊、列表 4 种视图一键切换。丰富字段：字段类型含文本、数字、单选/多选、日期、人员、公式、附件。任务追踪：看板视图可设置负责人、优先级、截止日期、进度百分比（Done/Doing/Todo）。管理场景：适配项目排期、书籍章节进度管控、旅行投票统计、打包清单管理等。4. AFFiNE Copilot 内置 AI 助手原生集成：无需额外接入第三方，直接调用 AI 能力。写作辅助：续写文稿、总结摘要、改写润色、翻译全文。智能问答：提供旅行攻略、行程规划、资料答疑（如巴黎出行贴士、卢浮宫游览顺序）。内容生成：清单、大纲、读书笔记、方案文案一键生成。5. 团队协作与模板生态实时协作：支持多人在线编辑、评论、页面权限管控、空间资源共享。预制模板：提供康奈尔笔记、行程表、项目计划表、书单、愿景板、购物清单、知识库首页等，开箱即用，无需从零搭建。三、适用人群✅ 高度适配用户个人用户学生：课堂笔记、论文规划、读书打卡。自由职业者/自媒体：选题脑暴、内容台账。上班族：个人待办、知识归档。宝妈：家庭台账、孩子日程管理。中小创业/项目团队产品、市场、研发小组，统一沉淀项目文档、需求看板、营销方案。替代 Notion+ 飞书文档 + 白板等多工具。研发/运维/技术团队自建私有化知识库，本地部署管控项目数据，支持开源二次开发定制。设计师/策划文案 + 草图 + 项目排期在同一画布完成，无需切换 PS/Miro/Excel。❌ 不太适配超大型集团：千人以上，复杂组织架构及精细化分级权限暂时不完善。ERP 联动需求：强依赖企业级 ERP 联动的用户。四、免费与付费资费详情AFFiNE 采用个人永久免费 + 团队分级付费 + 私有化部署模式。个人全功能永久免费（无文档数量上限）。1. 免费版（个人永久使用）功能范围：全部核心功能，包含文档、白板、多维表格、基础 AI、离线编辑、点对点设备同步。存储限制：本地存储：无上限。云端备用空间：免费 100MB 附件空间，单文件上限 5MB。功能限制：无团队多人云端实时协作（仅支持文件互传）。高级 AI 额度受限。无法自定义域名发布网页。2. 付费版本（团队/商用）Pro 专业个人版适用对象：重度个人创作者。核心权益：扩容云端存储空间。全量 AI Copilot 不限次数。网页发布功能。跨设备云端自动同步。Team 团队版适用对象：5 人及以上中小型团队。核心权益：多人实时云端协作。团队空间管理与精细化成员权限。超大附件存储。专属客服支持。Enterprise 企业定制适用对象：中大型企业。核心权益：私有化本地部署。专属运维与定制开发。数据安全合规服务（报价面议）。补充说明：开源版支持自行 Docker 私有化部署，全程零订阅费，数据全由自建服务器托管，适合技术团队省成本。五、新手分步使用教程方式一：客户端使用（90% 普通用户首选）下载安装：访问官网 https://affine.pro。点击顶部 Download，选择对应系统安装包（Windows/Mac/安卓/iOS）。本地使用：安装打开，无需强制注册账号即可本地新建文档。即可免费本地离线使用。创建页面：新建工作空间→新建 Page 页面。写笔记：默认文档模式，输入内容、插入列表/附件。切白板：页面右上角切换 Edgeless 无边框画布，拖拽手绘。建数据库：输入 /database 快速插入数据表，右上角切换看板视图做任务。AI 使用：选中文字或点击侧边 Copilot，输入指令（如写清单、总结文章）。跨设备同步：免费版开启 P2P 点对点同步。付费版登录账号云端一键同步全数据。方式二：私有化部署（技术用户）源码部署：运行命令 git clone https://github.com/toeverything/AFFiNE.git。安装 Node + pnpm 启动。Docker 一键部署：通过 Sealos 或自建服务器部署私有云端。所有数据存于自有服务器。新手起步 3 个实用场景模板读书管理：新建页面→插入数据库（字段：章节、完成进度、日期）。对应书本章节进行打卡记录。旅行规划：新建白板→拆分行程、打包清单、目的地投票。利用 AI 生成出行贴士。项目管控：使用数据库看板→录入任务、负责人、截止日。筛选「进行中/已完成」任务。六、使用避坑指南（高频踩坑点）1. 同步相关坑问题：免费版没有官方云端自动同步，跨设备靠 P2P 点对点，两台设备需同时在线才能同步。解决方案：重要内容手动导出 PDF/Markdown 备份；重度同步需求建议升级 Pro 版，或自建私有云。问题：本地换电脑重装软件，未提前导出数据会丢失本机内容。解决方案：养成定期导出页面备份的习惯。2. 功能 Bug 与操作坑问题：数据库切换看板视图偶发页面空白、数据消失（官方已知 Bug）。解决方案：切换视图前先保存；避免频繁切换表格/看板；更新软件到最新正式版。问题：导出表格视图文件偶发失败，大尺寸白板画布导出卡顿。解决方案：超大画布拆分多页面再导出，分批次导出附件。3. 存储与文件坑问题：免费云端附件仅 100MB，频繁传大图/视频很快占满空间。解决方案：大文件存在本地，附件改用外链链接，不上传云端。4. AI 使用坑问题：免费 AI 每日有调用次数限额，高频生成文案容易额度用尽。解决方案：拆分提问、精简指令；高频使用建议开通 Pro 版解锁无限 AI。5. 团队协作坑问题：免费版多人无法云端实时协作，只能文件互传。解决方案：小团队短期试用优先 Team 版，或选择自建私有化部署以节省成本。七、补充小技巧快捷键操作：输入 / 快速唤起块菜单，一键插入表格/白板/待办。输入 [[ 快速创建页面内链。导入迁移：支持导入 Notion 文档或 Markdown 文档。可一键批量搬家原有笔记。社区资源：访问 AFFiNE 社区可免费下载用户分享的各类成品模板。直接导入使用，提高效率。

 Outline图标

Outline

Outline 全指南Outline 是一个开源、高性能团队知识库与在线协作文档平台。它对标 Confluence 和 Notion，主打轻量化 Wiki、Markdown 编辑与实时多人协作。平台分为云端托管版（官网 getoutline.com）与私有化自部署开源版两种使用模式。一、平台介绍1. 基础概况官网地址：https://www.getoutline.com技术栈：基于 Node.js+PostgreSQL+Redis 开发。核心定位：企业/团队统一知识沉淀中心。旨在解决文档分散、权限混乱、反复查资料及跨群重复提问等痛点，适合搭建内部 Wiki、产品手册、研发文档及运营 SOP 知识库。核心优势：毫秒级极速加载，原生 Markdown 编辑体验好。支持实时在线协同编辑，支持精细化权限管控。提供 20+ 种第三方工具集成，支持多语言（含简体中文）。支持自定义域名与白标私有化部署。两种使用形态：SaaS 云端版：直接在官网注册使用，数据由官方托管。Self-host 自部署版：源码开源，部署在企业自有服务器，数据完全自主可控，永久免费且无文档上限。二、主要核心功能1. 文档编辑能力双格式编辑器：支持原生 Markdown 与富文本切换，内置 > 引用、任务列表、有序/无序列表、图片/附件/表格插入、斜线快捷指令（Slash Command）及网页内嵌预览。多人实时协作：支持同文档多人同时在线编辑，光标实时同步，提供评论@成员、话题留言、版本历史留痕及一键回滚功能。AI 问答检索：基于全库毫秒级全文检索，AI 可直接根据文档内容回答问题，无需手动翻页查找；支持按合集、作者或时间筛选。2. 知识库结构管理合集（Collections）分类：支持自定义多级分类架构（如工程、设计、市场、归档等），可新建合集收纳同类文档，支持跨合集移动、收藏星标及草稿箱管理。Webhooks 接口：提供异步事件回调（如新增用户、文档更新触发通知），便于对接自研系统与自动化流程，配套开放 API 支持二次开发。3. 分享与权限管控多层权限：支持团队分组、成员读写/只读权限区分，支持外部访客模式及单文档私有/公开链接分享。外链公开：可生成公开访问链接，无需注册即可查看，适合发布对外产品说明书或帮助文档。品牌定制：支持自定义品牌域名（如 docs.xxx.com）、替换 LOGO 及配色，实现白标私有化。4. 生态集成与附加能力主流工具打通：集成 Slack、Figma、Loom、Zapier 等 20+ 工具，支持 Slack 指令一键搜索知识库及文档更新自动推送。企业级认证：支持 SSO 单点登录与 SAML 企业认证。基础配套：包含暗黑模式、20 国语言支持、文档归档回收站、版本变更日志及企业审计日志。三、适用人群与使用场景1. 研发团队场景：接口文档、前后端开发手册、故障复盘、技术规范知识库。2. 产品与运营团队场景：PRD 需求文档、活动 SOP、产品帮助中心、运营规范沉淀。3. 初创与中小企业场景：全公司制度、入职手册、项目资料统一 Wiki（用于替代笨重的 Confluence）。4. 远程与跨地域团队场景：异地实时协同写方案、统一信息口径，减少聊天重复答疑。5. 设计与内容团队场景：设计规范、文案素材库、稿件存档、品牌规范文档。6. 个人与自由职业者场景：个人知识库、读书笔记、项目资料归档（免费版完全够用）。2. 局限与不适用不建议场景：重度可视化拖拽搭建页面（这是 Notion 的强项）、复杂表单数据库管理。四、收费标准与套餐选择1. 私有化自部署（开源版）费用：永久全功能免费。权限：无文档数量、成员人数、存储空间限制。条件：需自备服务器及云资源成本（服务器 + 对象存储），数据完全本地掌控。2. 官方 SaaS 云端订阅（getoutline.com）试用政策：注册即送 30 天全功能免费试用，试用结束必须升级付费。套餐类型价格成员上限核心权益Starter（小团队）$10/月1~10 人无限文档、版本历史、评论、AI 问答、基础集成Team（中型企业）$79/月11~100 人含 Starter 权益 + SSO、分组权限、审计日志、Webhook 完整 API、优先客服Business（大企业）$199/月101~250 人含 Team 权益 + SAML2.0、Confluence 迁移、高级安全审计、专属售后注意：百人以上规模建议优先考虑自建，以降低成本。五、分步使用指南方式一：云端 SaaS 快速上手（新手首选）注册创建工作区：打开官网，使用邮箱 Sign up，创建团队空间（自定义团队名称及知识库域名前缀）。搭建知识库分类：点击左侧「COLLECTIONS」→+New collection，按部门（如工程、产品、市场）新建合集。新建文档：选中合集→New doc，使用 Markdown 或富文本编写内容，支持粘贴图片、上传附件、插入表格。成员管理：进入设置→Invite people，输入邮箱邀请成员，并设置成员「编辑」或「只读」权限。文档分享：打开文档右上角 Share，生成私密团队链接或公开外链；可集成 Slack 实现文档更新自动推送。AI 检索：使用顶部搜索框输入关键词，开启 AI 问答直接基于文档内容获取答案。方式二：私有化 Docker 自建部署（企业长期用）环境准备：服务器内存≥2G，安装 Docker+Docker Compose，准备域名、SMTP 发件邮箱及 S3/MinIO 对象存储。拉取部署脚本：运行 git clone outline-docker-compose，复制配置文件并修改（域名、时区、账号）。配置环境变量：编辑 .env 文件，配置数据库地址、Redis 地址、密钥、邮箱配置及 S3 存储参数。一键启动：运行 docker compose up -d，浏览器访问自定义域名完成初始化注册管理员账号。后续配置：对接企业 SSO、配置自动备份任务、自定义 LOGO 及域名白标。六、高频避坑清单1. 自建私有化部署必避坑存储坑（图片附件丢失）：Outline 数据分为 PostgreSQL（文档正文）和 S3/本地盘（图片/附件）。只备份数据库会丢失全部素材。规范：需同时备份 pg_dump 数据库 + 打包 uploads 附件目录 + 留存 .env 配置文件。提示：新版本默认推荐 MinIO，需手动创建 S3 存储桶，否则图片上传会报错。实时协作异常：Redis 版本必须≥6.0，容器网络需连通（可 telnet redis 6379 测试），配置错误会导致光标错乱。升级翻车：Outline 迭代快（1~2 个月/次），升级前需在测试环境验证；自定义 CSS 或 LDAP 插件可能不兼容，升级前请备份自定义配置文件。邮箱配置遗漏：SMTP 配置错误会导致无法发送邀请及变更邮件，建议测试优先使用 QQ 或企业邮箱 SMTP，并关闭风控拦截。2. SaaS 云端使用避坑费用陷阱：30 天试用结束若不主动取消支付方式，系统会自动按月扣费。权限泄露：公开分享链接后任何人可查看，重要内部文档禁止生成公开外链，优先使用团队私有分享。中文搜索：云端默认分词对中文检索较弱，自建版需额外配置中文分词插件，否则搜不到中文关键词。3. 日常使用避坑合集规划：初期不规划分类会导致后期文档散乱，上线前应按部门或产品线划分合集，统一存放规范。Webhook 调试：配置异步回调先使用测试地址，避免错误回调频繁触发占用接口额度。七、优缺点总结1. 主要优点速度快：加载速度远优于 Confluence，轻量化无冗余功能。Markdown 友好：原生 Markdown 编辑，对研发人员极度友好。成本可控：开源自建零软件费，数据自主可控，适合长期低成本搭建企业 Wiki。高度定制：集成完善，自定义程度高，白标私有化可做企业内部帮助中心。2. 主要缺点SaaS 成本：云端付费按人数计价，百人以上成本较高，大团队更推荐自建。功能限制：原生无数据库看板、复杂表单功能，不适合低代码业务搭建。运维门槛：自建部署对服务器和运维有一定门槛，无基础的小白建议先用云端试用。

 Wiki.js图标

Wiki.js

Wiki.js 完整使用手册一、平台介绍Wiki.js 是基于 Node.js 开发、开源免费的现代化知识库/Wiki 系统，采用AGPL-v3 开源协议。官网地址为 https://js.wiki/，是目前全球主流自建文档知识库工具。GitHub 粉丝超 28400+，累计下载超 1 亿次。1. 基础架构开发架构：后端基于 Node.js，前端采用现代化 UI 设计。部署环境：支持 Windows Server、macOS、Linux、K8s 及 Docker 多环境部署。硬件兼容性：兼容树莓派小主机到云服务器全规格硬件。2. 数据库兼容系统支持五种主流数据库，用户可按需选型：PostgreSQLMySQL/MariaDBSQL ServerSQLiteMicrosoft Access3. 产品定位旨在替代传统 MediaWiki 或 Confluence，适用于：企业知识库项目文档个人笔记产品手册轻量化私有化部署二、核心主要功能1. 多类型文档编辑器（内容创作）Wiki.js 提供多种编辑器以适应不同场景：Markdown 编辑器适用场景：开发技术文档特点：实时预览、快捷键支持、代码高亮，是主流开发者的首选。可视化富文本（WYSIWYG）适用场景：非技术人员文案写作特点：零代码操作，类 Word 拖拽编辑体验。原生 HTML 编辑器适用场景：导入外部网页或存量 HTML 文档特点：直接编写 HTML，适配现有网页内容。WikiText（待上线）适用场景：MediaWiki 系统迁移特点：快速从维基系统迁移存量内容。API/表格编辑器（待上线）适用场景：接口文档、数据表编写特点：类似 Excel 的表格编辑、REST/GraphQL 接口编写。附加内容能力：代码块语法高亮及行号显示。UML、流程图、时序图绘图功能。TeX 数学公式渲染支持。音视频嵌入（支持 Youtube、asciinema 等）。版本全追踪：页面修改留痕、版本对比、回滚历史版本、删除页面恢复、单页导出及基于旧版本新建页面。2. 多渠道登录认证（权限管控）系统提供完善的登录认证体系：本地账号：支持内置注册、找回密码功能。第三方社交登录：支持 GitHub、微软、谷歌、Facebook、Discord、Slack 等 OAuth 登录。企业级登录：支持 LDAP、SAML、CAS、Azure AD、Okta、Auth0、通用 OIDC/OAuth2。安全加固：所有登录方式均支持 2FA 双因素认证。3. 精细化权限&分组管理用户分组：支持批量分组管控权限，避免单用户逐个配置。细粒度权限：控制页面编辑、附件上传、后台管理、页面访问等分级权限。页面规则：通过路径前缀、后缀或正则表达式批量配置页面访问权限。站点模式：支持全站公开、全私密、部分页面公开混合三种模式。4. 多方式内容存储&备份Git 同步（核心）：文档自动同步/备份至 GitHub、GitLab、Bitbucket、Azure DevOps，依托 Git 进行版本兜底。企业云盘：支持 AWS S3、Azure Blob、谷歌云存储。个人云盘（待上线）：支持 OneDrive、Dropbox、谷歌网盘。本地存储：支持本机磁盘、局域网共享盘、SSH 远程服务器备份。5. 全文检索系统内置数据库检索：开箱即用，适合小型站点。外接搜索引擎：支持 Elasticsearch、Algolia 云搜、Azure 搜索、Solr、Manticore 等（适合中大型知识库）。6. 国际化与页面多语言系统界面：支持全球 40+ 语言，包括阿拉伯语等 RTL 从右向左排版语种。文档多语种：单页面支持做多语言版本，一键切换同文档不同语种内容。7. 自定义美化主题模式：提供深浅两套主题（深色/浅色模式）。自定义样式：后台可直接注入自定义 CSS、JS，自定义页面样式。开发支持：支持开发自定义主题（功能后续完善）、自定义导航样式。8. 资源资产管理内置素材库：文件夹分类管理图片/附件。引用追踪：查看素材被哪些页面引用。编辑器功能：自带图片裁剪、调色编辑器（即将上线）。三、适用人群&使用场景1. 企业团队（最主流）研发团队：编写接口文档、技术规范、运维手册、项目迭代文档。行政/人事：管理公司制度、员工手册、规章制度、培训资料。产品团队：撰写产品需求文档、版本说明、运营 SOP。价值：替代付费 Confluence，低成本搭建内部知识库。2. 开发者/个人用户程序员自建：个人知识库、学习笔记、踩坑文档。开源项目：用于开源项目官方文档站（大量开源项目使用 Wiki.js 做官网文档）。极客玩家：树莓派本地自建私人知识库。3. 社团/培训机构管理机构课件库、社团规章、课程资料、学员手册。服务于小众社群公开知识库。4. 自媒体/内容创作者搭建独立百科站点。创建专栏知识库。四、免费&付费详情1. 开源授权规则（核心）Wiki.js 主体永久免费开源，遵循 AGPL-v3 开源协议：个人/非商用/内部自用：100% 完全免费。无功能阉割、无用户数限制、无页面上限。全部官方内置功能（权限、搜索、Git 备份、多登录、编辑器）免费开放。商用二次修改分发：遵循 AGPLv3 协议。修改源码并对外提供服务时，需要开源修改后的代码。官方无强制付费：无软件订阅费、无授权费。2. 付费仅两种可选（非强制）云托管服务：官方合作云厂商（DigitalOcean 等）提供一键托管部署，费用为云服务器租赁费，非 Wiki.js 软件费用。商业技术支持：如需官方定制开发、7×24 运维服务、企业专属技术顾问，联系开发团队付费购买技术服务（可选，不用可不花钱）。注意：模块、插件、主题全部官方原生免费，无付费功能锁。五、快速使用（安装+上手步骤）方式 1：Docker 一键部署（推荐新手，5 分钟启动）确保服务器预装 Docker 和 Docker Compose。拉取 Wiki.js 镜像 + 配套数据库（SQLite 最简单，无需额外安装数据库）。bashdocker run -d -p 8080:3000 --name=wiki -e "DB_TYPE=sqlite" requarks/wiki:2 docker run -d -p 8080:3000 --name=wiki -e "DB_TYPE=sqlite" requarks/wiki:2 浏览器访问 服务器 IP:8080，按初始化向导设置管理员账号、站点名称，完成安装。方式 2：一键云主机（DigitalOcean marketplace）在 DigitalOcean 云市场一键创建实例，系统自动装好 Wiki.js，开箱即用，仅付云服务器租金。方式 3：原生手动部署（Linux/macOS）安装 Node.js 环境 + 对应数据库。下载 Wiki.js 源码，配置数据库连接配置文件。启动服务，浏览器初始化配置。基础上手使用流程管理员初始化：登录后台→【设置 - 本地化】切换中文界面。配置登录：【模块 - 认证】开启本地/第三方登录（如 GitHub 快捷登录）。创建分组与权限：【用户&分组】新建用户组，配置页面读写权限。新建文档：首页创建页面，选择 Markdown/富文本编辑器编写内容。配置备份：【模块 - 存储】开启 Git 自动备份至 Github 仓库。开启搜索：小型站点用内置搜索，海量文档对接 Elasticsearch。六、部署&日常使用避坑指南（一）部署避坑数据库选型踩坑10 人以内小团队：优先 SQLite，零配置。50 人以上团队禁止 SQLite，并发访问会卡死，改用 PostgreSQL（官方推荐）或 MySQL。MySQL 需开启 InnoDB 引擎，避免 MyISAM 出现版本存储异常。端口&防火墙默认端口 3000，服务器防火墙/安全组需放行对应端口。反向代理 Nginx 后注意配置 websocket，否则后台实时预览失效。Docker 升级坑Docker 部署不要直接删除容器升级。升级前需备份数据库 + Git 同步全量文档，新版本镜像数据库结构可能变动。（二）功能配置避坑Git 自动备份配置使用 Git 存储时，仓库权限需配置成读写权限。只读仓库无法自动提交文档，会导致备份失败。定期核对仓库提交记录。权限配置误区不要直接给普通用户管理员权限，优先分组配置。页面正则规则慎用全匹配 /*，容易误锁全站。第三方登录OAuth/GitHub 登录需在对应平台创建应用。填写正确回调域名，域名错误无法跳转登录。（三）日常运维避坑素材存储大量图片附件不要全存在本地磁盘。开启 S3/Git 附件存储，防止服务器磁盘爆满丢失素材。版本丢失重要知识库务必开启 Git 双备份（本地 + 云端 Git 仓库），避免服务器硬盘损坏文档全丢。搜索引擎文档超万页后停用内置数据库检索，改用 Elasticsearch，否则搜索卡顿超时。升级系统大版本升级前（如 v2.x→v3）先全量备份数据库。官方大版本偶尔存在配置不兼容问题。（四）协议合规避坑企业仅内部部署自用、不对外分发修改后的程序，不受 AGPLv3 开源约束。若修改源码并对外提供 SaaS 服务，必须开源修改代码，避免版权纠纷。七、补充拓展1. 中文支持系统内置简体中文。后台 Locales 一键切换，无需额外汉化包。2. 插件生态原生 50+ 集成模块（登录/存储/搜索/编辑器）。全部免费开关，按需启用。

 MrDoc图标

MrDoc

MrDoc 觅思文档指南一、平台介绍MrDoc 觅思文档（又称觅道文档） 是一款国产开源的私有化部署知识库与在线文档系统。该系统基于 Python + Django + LayUI 技术栈开发，是 Gitee 2020 年度 GVP 开源项目。1. 核心定位数据自主可控：支持本地、内网或公网私有化部署，无平台云端托管。安全隔离：所有文档、素材存储于用户自己的服务器或设备，有效规避 SaaS 平台关停风险及数据泄露隐患。版本迭代：提供开源免费版与商业专业版两大版本，Web 端每月持续更新。部署灵活：支持 Windows/Linux/macOS/NAS/宝塔面板/Docker 等环境，支持内网离线隔离网部署。2. 技术架构开发语言：Python (Django)前端框架：LayUI协议标准：开源项目遵循 GPLv3 协议（需视商用情况开源修改代码）二、核心主要功能1. 文档创作（三大编辑器）Markdown 编辑器：支持思维导图、流程图、ECharts 图表、LaTeX 科学公式、序列图、音视频嵌入、代码高亮及特殊符号（上下标/删除线/表格）；内置 Vitor/iceEditor 富文本双编辑器可选。富文本编辑：类 Word 可视化排版，无需代码门槛，适合非技术人员。在线 Office（OnlyOffice）：支持在线编辑 Word/Excel/PPT 文件，提供在线预览、修改及保存功能。在线表格：类 Excel 结构化数据管理，适用于台账、清单记录。2. 文集 & 文档管理书籍式树形结构：支持无限层级“文集（书本）+ 子文档（章节）”，支持拖拽排序、上下级绑定。版本控制：支持文档历史版本回溯、回收站恢复、文档复制/移动/转让。辅助功能：支持文档标签、别名设置、目录自动生成、快捷链接及批量管理。导出功能：支持文集整站导出 PDF/电子书，单文档导出多格式。3. 精细化权限管控（核心优势）多级权限：支持浏览/只读/编辑/协作/私密等分级权限设置。灵活控制：支持游客只读、指定成员协作、文档禁止复制、页面水印、全站关闭注册/强制登录。分享机制：可单独设置单篇文档对外分享链接（支持设置访问密码与时效）。4. 全终端多端同步Web 端：主流浏览器网页访问。客户端：支持 Windows/macOS/Linux 桌面客户端。移动端：支持安卓 APP。插件生态：Chrome/Firefox 浏览器插件（网页剪藏、一键保存）；Obsidian 插件（双向同步本地笔记与在线文档）。5. 素材 & 存储管理统一素材库：图片/附件集中管理，自定义附件白名单及单文件上传大小限制。存储方案：开源版：仅本地服务器存储文件。专业版：支持对接阿里云/腾讯 OSS 对象存储。预览能力：支持 PDF/Office/主流文本附件在线预览。6. 第三方集成能力单点登录 (SSO)：支持企业微信、钉钉、LDAP、OIDC 等第三方登录，企业组织架构一键导入。AI 能力：接入 Dify 大模型框架，内置 RAG 私有知识库；支持文档喂给 AI 进行私有知识库问答、AI 辅助写作、文档总结、语义检索及内容润色/翻译（私有化大模型，不上传原文至第三方）。消息推送：支持 WebHook 消息推送，文档变更可推送至钉钉/企业微信。7. 数据导入迁移批量导入：支持 Joplin、印象笔记、Obsidian 文档批量导入。开放接口：开放 API 与 Token 接口，支持自研系统对接 MrDoc 进行文档读写。三、适用人群 & 使用场景1. 个人用户场景：程序员笔记、自学知识库、读书笔记、个人项目文档、私密随笔。价值：替代本地 Word/零散记事本，实现云端私有化存储笔记。2. 研发/技术团队场景：开发手册、接口文档、运维手册、故障台账、技术沉淀知识库。价值：内网部署杜绝代码/方案外泄。3. 产品/中小企业场景：产品帮助手册、内部制度文档、员工培训教程、客服知识库、对外官网帮助中心。价值：结构化发布，公网部署可开放访客查阅。4. 培训机构/自媒体场景：在线课程文档、教程知识库、付费专栏文档。价值：书籍化结构化发布教程，方便学员查阅。5. 政企涉密单位场景：内网隔离网私有化部署，涉密资料本地留存。价值：满足数据合规要求，不经过公有云。四、免费 & 付费版本详情✅ 开源版（永久免费，GPLv3 开源协议）适用对象：个人用户、5 人以内小型团队。授权方式：免费永久使用，无期限、无用户数限制；源码开放可自行二次修改。标配功能：Markdown/富文本/在线表格、基础权限、Web 端、本地文件存储、基础附件管理。功能限制：无全平台客户端（桌面/APP/插件）。无 OSS 云存储支持。无官方技术支持。AI/Dify 集成受限。无企业级单点登录增强功能。无批量用户导入、无高级水印/防爬配置。💳 专业版（商业付费，永久授权）适用对象：中大型企业、全终端使用需求、需要 AI/OSS/企业集成的团队。授权方式：付费买断制，永久使用权，无年费、无用户上限（具体报价咨询客服）。解锁功能：全平台支持（桌面端 +APP+ 浏览器插件+Obsidian 插件）。OSS 对象存储支持。完整 Dify+ 私有 RAG AI 能力。全量第三方认证（钉钉/企微/LDAP/OIDC 全功能）。高级权限、批量用户导入、专属技术售后、版本优先更新。付费代部署服务（适合 0 基础用户，远程协助 Docker/宝塔一键部署）。重要提示：无官方 SaaS 云端版，所有版本必须自行部署在自己服务器/电脑/NAS，官方不提供云端托管服务。五、详细使用教程方式 1：Docker 一键部署（新手首选，推荐）适用环境：Linux/Windows/Docker 环境。安装环境：确保服务器已安装 Docker。拉取镜像：bashdocker pull zmister/mrdoc:latest docker pull zmister/mrdoc:latest 启动容器（映射端口 10086，可自定义）：bashdocker run -d --name mrdoc -p 10086:10086 -v /opt/mrdoc-data:/app/MrDoc zmister/mrdoc:latest docker run -d --name mrdoc -p 10086:10086 -v /opt/mrdoc-data:/app/MrDoc zmister/mrdoc:latest 创建管理员账号：bashdocker exec -it mrdoc python manage.py createsuperuser docker exec -it mrdoc python manage.py createsuperuser 访问系统：浏览器输入 http://服务器 IP:10086，使用管理员账号登录。方式 2：源码手动部署（开发者自定义修改）适用对象：有开发基础，需深度定制系统。克隆源码：bashgit clone https://gitee.com/qizhenghai/MrDoc.git git clone https://gitee.com/qizhenghai/MrDoc.git 安装依赖：bashpip install -r requirements.txt pip install -r requirements.txt 初始化数据库：bashpython manage.py makemigrations && python manage.py migrate python manage.py makemigrations && python manage.py migrate 创建管理员：bashpython manage.py createsuperuser python manage.py createsuperuser 启动服务：bashpython manage.py runserver 0.0.0.0:10086 python manage.py runserver 0.0.0.0:10086 基础入门使用步骤后台配置：管理员登录后台→站点设置，配置站点名称、附件大小/格式白名单；设置是否开启注册；用户管理创建成员账号、设置分组权限。创建文集：首页→新建文集（如「产品手册」「技术文档」），设置文集权限（私密/全员可读/指定协作）。新建文档：进入文集→新建文档，选择 Markdown/富文本/表格/Office，插入图表、附件、图片，保存发布。分享文档：文档右上角点击分享，生成链接 + 访问密码，发给外部人员。多端同步：下载官网对应客户端，登录同账号自动同步全部知识库。六、部署&使用避坑清单一、部署避坑端口占用：默认端口 10086 易被占用，启动 Docker 时务必修改映射端口（如 -p 8080:10086）。云服务器安全组需放行对应端口，否则外网无法访问。数据备份：Docker 部署必须挂载数据卷（-v 本地路径:/app/MrDoc），若未挂载，容器删除后数据全丢。需定期备份挂载目录文件与数据库 SQL。数据库选型：小型部署默认 SQLite 够用；超过 20 人团队建议配置 MySQL。开源版可自行修改配置切换，切勿后期临时迁移数据库。NAS 部署：极空间/群晖 NAS 用 Docker 部署时，优先使用官方镜像，避免使用第三方修改镜像导致兼容性 BUG。二、功能使用避坑开源版存储：开源版文件全存服务器本地磁盘，大量附件会占满硬盘。如需使用 OSS 云存储必须升级专业版，不要自行魔改源码对接 OSS（可能违反 GPL 协议）。OnlyOffice 配置：OnlyOffice 需单独部署服务，新手不要自行配置，极易出现跨域、预览失败。建议优先使用专业版官方配置或付费代部署。AI 接入限制：Dify+ 私有 RAG 需要额外部署 Dify 服务，开源版 AI 功能阉割。若需完整私有知识库问答，建议直接升级专业版，避免浪费时间配置无效功能。权限误区：文集权限优先级＞单文档权限。若文集设为私密，单文档单独开放分享链接不生效。需先放开文集浏览权限再设置文档分享。浏览器插件：剪藏插件仅支持 Chromium 内核浏览器（Chrome/Edge），Firefox 部分功能缺失。复杂格式剪藏易乱码，建议复制正文到编辑器。版本升级：Docker 容器升级优先拉取新镜像并保留数据卷，不要直接在容器内升级代码，极易环境崩坏；源码部署升级前务必备份数据库。三、合规避坑GPLv3 协议：开源版遵循 GPLv3 协议。若二次修改源码并对外商用分发，必须开源修改后的代码；仅企业内部自用修改源码无需开源。七、官方资源入口官方网站：https://www.mrdoc.pro官方使用手册：https://doc.mrdoc.pro/p/user-guide/部署文档：https://doc.mrdoc.pro/p/deploy/

 Answer图标

Answer

Apache Answer 使用指南一、平台介绍Apache Answer 是 Apache 软件基金会顶级开源项目（TLP），由思否（SegmentFault）团队于 2022 年开源并孵化转正。该项目对标 Stack Overflow，是一款轻量化的私有化问答系统。开源协议：采用 Apache 2.0 开源协议，遵循 Apache 2.0 条款。技术架构：Go 后端 + React 前端开发。核心定位：将零散的聊天记录或文档知识沉淀为结构化、可检索的问答系统，有效替代微信群、飞书群等碎片化答疑场景。部署模式：支持全私有化部署，确保数据自主可控。官方站点：官网 answer.apache.org/zh-CN 提供中文文档、演示环境、源码入口及社区反馈渠道。二、主要功能1. 基础问答核心（用户侧）提问与回答：支持 Markdown 实时预览，可编辑富文本（公式/表格/图片）。系统会自动联想历史问题，避免重复提问。邀请作答：支持站内 @用户，并可定向邀请特定领域的专家进行回答。投票机制：提供点赞与踩功能，提问者可将优质答案标记为最佳答案并置顶。标签订阅：用户可关注技术标签（如 go、mysql），新发布的问答会通过消息推送及时通知。高级检索：支持按标签、作者、点赞数、发布时间等维度筛选内容，同时具备全文检索功能。2. 社区与内容管理（管理员侧）多角色权限：提供超级管理员、版主、普通用户三级权限体系，可自定义版块访问及发帖权限，支持批量导入用户。标签分类体系：支持自定义一级或多级标签，帮助实现内容归类，适配技术分区或产品售后分类。内容协作修订：支持全员协同编辑问答，系统全量留存修订历史，管理员可回溯每一次修改记录。内容审核：支持自定义关键词过滤及人工审核机制，拦截垃圾问答。3. 用户激励体系声望与徽章：回答被采纳、获赞或优质投稿可增加声望，解锁发帖、编辑及管理特权。自动徽章：完成指定任务（如首答、标签达人）可自动发放徽章，提升社区活跃度。4. 插件扩展与基础配套插件扩展：提供官方插件市场及自定义插件，支持第三方登录（微信/GitHub/OAuth）、对象存储（阿里云 OSS/S3）、Elasticsearch 全文检索、数据统计看板、暗黑模式等。多语言支持：内置 40+ 语言，原生适配简体中文。通知系统：提供站内信及邮件通知（回答、评论、点赞、关注更新等）。数据库兼容：支持 SQLite（轻量单机）、MySQL、PostgreSQL 三选一部署。移动端适配：页面自动适配移动端访问。三、适用人群与使用场景1. 适用人群与场景互联网/研发团队：构建技术知识库，内部问题答疑（如 Go/Python 开发排坑、运维故障汇总），替代群聊查问题。产品&客服团队：打造产品帮助中心，沉淀用户售后 FAQ，记录用户高频问题。开源/行业社区：作为开发者社区或垂直领域论坛（编程、硬件、设计）。高校/培训机构：搭建课程答疑平台或师生问答知识库。中小企业行政：建立内部制度、人事问题问答库。2. 不适用场景纯闲聊论坛（主打帖子灌水）。超大体量 UGC 综合门户（此类场景建议推荐 Discuz）。四、免费与付费情况✅ 开源版（主流）状态：永久 100% 免费。源码：完全开源（Github：apache/incubator-answer）。功能：无功能阉割，无用户上限，无站点广告。协议：遵循 Apache 2.0 协议，可商用、可二次修改、可私有化部署，数据全归部署方所有。官方说明：官方无任何收费版，不存在官方云托管付费服务。⚠️ 付费场景（非官方）第三方代部署/云托管：部分云服务商或外包公司提供一键托管运维（服务器 + 运维 + 升级），按需求收费。定制开发：如需定制专属插件或功能改造，需找第三方开发人员付费定制。总结：自己部署等于零成本；找人代运维则按需付费。五、详细使用步骤1. 部署方案选择方式 1：Docker 一键部署（新手首选）前提：服务器提前安装 Docker（Windows/Linux/macOS 均可）。步骤：终端执行一键拉取镜像命令：bashdocker run -d -p 9080:80 -v answer-data:/data --name answer apache/answer:latest docker run -d -p 9080:80 -v answer-data:/data --name answer apache/answer:latest 浏览器访问 http://服务器 IP:9080，进入安装向导。安装配置：选择语言：简体中文。选择数据库：小型团队选 SQLite（无需额外安装数据库）；中大型团队选 MySQL 或 PostgreSQL。创建超级管理员账号（用于后台登录）。安装完成自动跳转至前台首页。方式 2：Docker Compose 部署（生产环境推荐）优势：生产环境推荐，带独立数据库管理。命令：bashcurl -fsSL https://raw.githubusercontent.com/apache/answer/main/docker-compose.yaml | docker compose -p answer -f - up curl -fsSL https://raw.githubusercontent.com/apache/answer/main/docker-compose.yaml | docker compose -p answer -f - up 访问：安装初始化访问 localhost:9080 完成。方式 3：二进制包部署（无 Docker 环境）步骤：下载官网对应系统（Windows/Linux）的二进制程序。初始化配置：INSTALL_PORT=80 ./answer init -C ./answer-data/，访问 http://IP:80/install 进行配置。启动服务：./answer run -C ./answer-data/。2. 后台初始化配置（管理员）登录后台：访问 http://IP:端口/admin。站点设置：填写网站名称、域名、邮箱 SMTP（用于开启邮件通知）。标签管理：新建业务标签（如 Go 语法、产品使用、运维故障）。用户配置：开启或关闭注册、设置注册白名单（企业内网建议使用白名单或关闭公开注册）。插件中心：按需安装第三方登录、图片存储插件。3. 普通用户使用流程注册：注册账号后浏览标签或搜索问题。提问：点击【提问】按钮，填写标题、正文及关联标签。互动：浏览问题可回答、评论、点赞，关注标签接收动态。六、避坑指南1. 部署相关注意事项端口占用：默认 80/9080 端口若被占用，需在启动命令中修改映射端口（如 -p 8088:80）。容器日志排查：若页面打不开，查看容器日志 docker logs answer 排查报错。数据卷挂载：Docker 部署必须带 -v answer-data:/data 挂载数据卷，否则重启容器后数据会丢失。镜像拉取：国内用户若拉取失败，需替换 Docker 国内镜像源后再次执行。子目录部署：不建议使用 域名/answer 子目录安装，优先使用根域名部署。若必须使用子目录，需配置反向代理。2. 数据库选型建议小型团队：10 人以内优先使用 SQLite，省去数据库运维成本。中大型团队：50 人以上或业务量大时再切换至 MySQL 或 PostgreSQL。迁移风险：切换数据库需全量备份数据再迁移，直接换库大概率会导致报错（50X）。密码规范：数据库密码尽量避免含特殊符号（如 #、&、@），以防连库失败。3. 文件与图片上传File Cannot be empty 报错：检查后台图片文件大小上限配置。检查服务器磁盘是否已满导致无法写入。安装对象存储插件替代本地存储，避免磁盘溢出。图片访问问题：若使用本地存储，反向代理需放行静态资源路径；建议优先安装 OSS 插件。4. 邮件通知配置收不到邮件：确认 SMTP 服务商是否开通第三方客户端权限（如 QQ 邮箱需使用授权码）。确保后台配置的站点域名与实际访问域名一致，否则邮件会被拦截或进入垃圾箱。5. 版本与插件管理版本安全：0.4.x 早期版本存在安全漏洞，务必使用 1.4+ 最新稳定版，并定期升级镜像。插件兼容：插件版本需与 Answer 主版本匹配，从官方插件市场下载对应版本，勿随意安装非标插件。升级备份：版本更新前务必用数据库备份命令导出 SQL，防止升级损坏数据。6. 企业内网使用建议注册安全：企业内部使用务必关闭公开注册，改用管理员批量导入用户或企业 OAuth 登录，防止外网人员乱注册。域名一致性：后台站点域名配置必须与访问域名保持一致，否则会出现登录或跳转异常。七、官方资源入口中文官网：https://answer.apache.org/zh-CNGithub 源码：https://github.com/apache/incubator-answer

 Logseq图标

Logseq

Logseq 全维度使用指南一、平台介绍Logseq 是一款基于 AGPL3.0 开源协议、强调本地优先、隐私导向的双链大纲型个人知识管理（PKM）软件。官网地址：https://www.logseq.com/1.1 核心定位主打 块（Block）大纲 + 双向链接 + 本地纯文本存储，是 Roam Research 的开源替代品。数据归属：全部笔记以 Markdown/Org-mode 格式保存在本机文件夹，无强制云端，数据 100% 归用户所有。应用场景：搭建个人第二大脑、文献管理、任务系统、读书笔记库。1.2 运行环境全平台覆盖，适配多种操作系统：桌面端：Windows / macOS / Linux移动端：iOS / AndroidMac 芯片适配：区分 Intel 芯片 Mac 与 2020.11 后 Apple M 系列硅芯片 Mac 专属安装包。1.3 底层优势开源透明：代码托管在 GitHub，无暗箱收集用户数据。离线可用：断网状态下可完全正常编辑，不依赖厂商服务器。文件通用：笔记是标准 MD 文档，可用 Typora、Obsidian 等任意编辑器打开，支持随时迁移。二、核心主要功能2.1 基础大纲笔记（软件基石）所有内容以 独立 Block（文本块） 存在。支持无限缩进嵌套、拖拽排序、单块剪切/复制/跨页面引用。适合场景：头脑风暴、论文提纲、课程笔记分层整理。新手建议：优先掌握缩进分级写法。2.2 双向链接与知识图谱（灵魂功能）页面链接：使用 [[页面名称]] 一键创建正向链接，系统自动生成反向引用，右侧面板可查看所有被引用/引用来源。块引用：使用 ((块 ID)) 精准引用单段文字，实现片段级跨笔记关联。图谱视图：可视化所有笔记连接关系，快速发现知识盲区与隐藏关联。2.3 全链路任务管理（GTD 原生支持）任意文本块输入 / 快速添加任务标记，支持：NOW：当日紧急事项、仅在当日日志展示。TODO：待办事项。DOING：进行中事项。LATER：延后事项。高级功能：支持重复任务、截止日期、优先级标注。搭配 Query 查询 自动汇总全库同类任务，自动生成动态任务清单/数据表格。2.4 PDF 批注（学生/科研刚需）内置 PDF 阅读器，支持文献高亮、批注。批注内容一键生成 Logseq 笔记并建立双链关联原文献。实现 文献 - 笔记 - 知识库闭环，无需切换阅读器与笔记软件。2.5 附加实用功能每日自动日志：打开软件默认显示当日日志页，系统自动按日期新建页面，碎片化记录自动沉淀到时间线。闪卡 (Flashcards)：选中内容一键生成记忆卡片，支持艾宾浩斯循环复习（背诵考点、专业名词）。白板 Whiteboard (BETA)：无限画布，拖拽知识库已有笔记自由排布，适合思维导图或项目梳理。幻灯片：大纲一键转为演示文稿，适合小型汇报快速出稿。插件&自定义：提供 150+ 社区插件、30+ 自定义主题，支持 CSS 修改界面、拓展思维导图/日历/代码高亮等。三、适用人群3.1 学生群体（最适配）对象：本科生、硕博研究生。场景：课程笔记分层整理、论文大纲撰写、外文文献批注、考点闪卡背诵、考前知识点串联。3.2 职场知识工作者对象：产品、运营、研发、咨询人员。场景：会议纪要归档（如案例记录）、项目任务拆解、行业资料知识库、周报素材汇总。3.3 创作者&终身学习者对象：写书/自媒体作者、读书爱好者。场景：书稿大纲、素材收集；搭建个人藏书笔记库，实践卡片盒笔记法（Zettelkasten）。3.4 隐私敏感用户对象：反感云端笔记、担心平台跑路丢失数据、需要本地永久留存资料的用户（如律师、研究员、涉密资料整理）。注意：不适合只需要简单随手记、零学习意愿、追求开箱即用极简记事本的用户（学习曲线中等）。四、免费与付费详情4.1 个人版（核心功能）状态：永久全功能免费。权益：无功能阉割：双链、PDF 批注、闪卡、白板、查询、全部原生功能永久免费。无存储上限：本地文件占硬盘空间，笔记数量无官方限制。开源自用：可自行修改源码、本地部署，个人使用完全免费，无广告、无强制会员弹窗。4.2 付费项目（增值服务）Logseq Sync（Beta 付费同步服务）：官方跨设备加密云同步，支持桌面 + 手机多端实时同步 MD 文件，按月/年订阅。评价：非刚需，不想付费可用 OneDrive/百度网盘/WebDAV/Git 自行本地文件夹同步。企业商用授权：团队协作、企业定制部署收费，个人用户完全用不到。总结：99% 个人用户终身零花费即可完整使用全功能，付费仅为懒于手动同步的用户提供云同步便利。五、分步上手使用指南（新手三步法）5.1 第一步：下载安装 + 创建知识库官网下载：访问 https://logseq.com/downloads，根据系统选择对应安装包（Intel/M1 芯片 Mac、Windows、安卓/iOS）。新建知识库：打开软件 → 点击 Add a graph → 在电脑本地新建一个空白文件夹（如 D:\Logseq 知识库）。选中文件夹：选中该文件夹即创建完成，所有笔记均存储在此处。关键提示：一个文件夹 = 一个知识库，可创建多个独立知识库（如将学习库/工作库分开）。5.2 第二步：新手入门三习惯日常碎碎念：打开默认当日日志页，随手记录会议记录（如 Meeting with Jessica）、读书随笔等。结构化笔记：使用 Tab 键缩进拆分大纲，适配论文提纲、读书笔记分层（Beginner 技巧：分段 + 缩进）。知识关联：书名、人名、项目统一用 [[书籍名]]，自动建立知识链接。5.3 第三步：进阶快捷键与常用操作全局搜索：Cmd+K (Mac) 或 Ctrl+K (Windows)，可搜索页面/块，中级必备。Query 查询：编写 {{query}} 语句，自动生成任务或读书笔记汇总表格。导入 PDF：拖拽 PDF 进页面，直接开启批注。插件安装：进入设置 → Plugins，一键安装社区插件拓展功能。落地示例：会议记录中输入 Met with [[Jessica Albert]]，后续在 [[Intertwingled]] 书本页面可自动反向看到这条会议引用，一键跳转关联笔记。六、避坑指南（新手高频踩坑 + 解决方案）6.1 存储结构坑❌ 错误：知识库文件夹放桌面、系统 C 盘、经常移动文件夹。✅ 正确：固定在 D 盘或非系统盘专属目录，不随意剪切文件夹。💡 备份方案：每周复制知识库文件夹到移动硬盘或网盘，MD 文件复制即全量备份。6.2 性能坑❌ 错误：一个知识库塞几万条笔记、大量内嵌高清 PDF。✅ 正确：按用途拆分知识库（如考研库、工作库分开）；PDF 原件单独存硬盘，Logseq 仅存批注；单库笔记建议控制在 8000 条以内，优化流畅度。6.3 同步坑❌ 错误：同时在电脑、手机打开同一个知识库文件夹，两端同时编辑。✅ 正确：免费方案：单设备编辑，修改完成后再网盘同步文件夹。付费方案：需要多端同步再开 Logseq Sync，不要混用多种同步工具。6.4 功能坑❌ 错误：刚上手一次性装几十款插件、大量自定义 CSS，导致软件启动崩溃。✅ 正确：新手只装刚需插件（如日历、闪卡），熟悉基础功能后再逐步加装；默认主题先用 1 个月，熟练再换自定义主题。6.5 语法坑❌ 错误：[[名称]] 符号用全角括号、Query 引号写错。✅ 正确：所有链接符号用英文半角符号，复制现成查询模板修改关键词，避免手写语法出错。6.6 迁移坑❌ 错误：换电脑复制 Logseq 安装程序文件夹。✅ 正确：只复制自己创建的知识库文件夹，新电脑重装软件后选中文件夹即可恢复全部笔记（MD 文件独立于软件）。

 思源笔记图标

思源笔记

思源笔记一、平台介绍思源笔记是一款国产开源、本地优先（Local-first）的个人知识管理系统。它主打数据私有化、隐私安全、块式编辑、双链知识库，秉持「无离线不笔记」的理念，由国内 B3log 团队开发，核心代码采用 Apache2.0 协议开源。核心底层逻辑：本地优先数据所有权归用户 笔记默认保存在本地文件夹。即便软件停运或服务商倒闭，本地文件仍可正常打开使用，不会丢失数据。AES-GCM 端到端加密 开启云同步时全程加密，官方与云服务商均无法解密用户明文数据。全平台覆盖 支持 Windows、macOS、Linux、Android、iOS、鸿蒙系统。支持 Docker 私有服务器部署及浏览器网页端打开。二、主要功能明细（一）核心编辑：块式编辑器（软件标志性功能）所有内容（文字、图片、表格、代码、公式）均为独立内容块，像乐高积木一样自由拖拽排版：Markdown 所见即所得 输入#、**加粗**等即时预览富文本，无需切换源码/预览模式；斜杠/唤起快捷菜单，一键插入 20+ 种块（标题、列表、思维导图、流程图等）。丰富内置块 支持公式块（LaTeX）、Mermaid/Graphviz 流程图、PlantUML/UML、五线谱、图表、代码块、多维数据库（对标 Notion Database）、任务清单、引用块、嵌入块。块级双链 使用[[文档名]]快速双向链接与块引用跳转；支持悬浮预览内容；构建网状知识图谱。超大文档优化 采用动态加载技术，百万字单文档编辑流畅，无卡顿。双结构管理 左侧支持文档树（树形文件夹），右侧支持全局关系图（网状知识）。（二）知识管理进阶功能SQL 查询视图 支持用 SQL 语句筛选、汇总知识库内容，自动生成动态汇总页面（如日记汇总、错题本）。闪卡间隔复习 基于 FSRS 算法制作记忆卡片，适用于考研、考证背诵及单词记忆，自动规划复习周期。模板系统 提供周报、日记、读书笔记等模板一键复用；搭配日期变量自动生成当日文档。全量搜索 毫秒级全文检索，支持标签#分类、自定义属性筛选内容。网页剪藏 +PDF 标注双链 浏览器插件一键保存网页；PDF 划线标注自动生成反向链接。AI 辅助写作 内置 AI 调用接口，支持一键扩写、润色、总结笔记内容。（三）个性化与扩展插件&主题集市 提供海量社区插件（番茄钟、目录、文档转思维导图等）；支持自定义暗色/亮色主题；支持 CSS/JS 代码片段 DIY 界面样式。多窗口分屏 支持同屏多文档对照编辑，支持悬浮弹窗查阅资料。多格式导出 支持导出 Markdown、PDF、Word、HTML 等；支持批量导出整库 Markdown 以便迁移。（四）同步与备份本地免费离线 断网情况下全功能可用。两种付费同步方案 官方云端同步、S3/WebDAV 第三方对象存储同步。三、适用人群✅ 最适合人群学生党（考研/公考/留学） 利用闪卡背诵、建立错题数据库、整理课程知识库、绘制思维导图整理教材。职场白领 利用周报模板、构建项目知识库、归档会议纪要、整理资料剪藏。创作者/自媒体 长篇书稿写作、素材库管理、公众号文案排版导出。隐私敏感用户 律师、研究员、涉密资料存储者，重视数据不被平台管控。自建 NAS/极客 拥有 Docker 部署能力的用户，可私有化服务，对接 S3 自建网盘全自主管控数据。⚠️ 不太适合人群重度移动端随手速记用户 手机端插件缺失、大块文档加载相对较慢，主力使用体验弱于桌面端。多人实时协作需求团队 主打个人知识库，原生无在线多人协同功能（非实时协作平台）。四、免费与付费价格明细核心原则：所有本地核心功能永久免费（无功能阉割，可商用），包含块编辑、双链、Markdown、SQL、闪卡、插件、全端本地打开、导出。仅云端同步类增值服务收费。1. 永久免费版价格：0 元权益：全本地功能、全插件/主题、离线使用、本地备份。限制：无官方云空间、无官方同步、无收集箱/图床。2. 年度订阅会员价格：148 元/年（学生教育优惠 96 元/年）权益：官方 8GB 云端存储空间 + 全端一键同步。收集箱（微信/网页快捷收集）、官方资源图床、定时微信提醒。自带 S3/WebDAV 同步权限。3. 终身功能包价格：72 元一次性买断权益：永久解锁 S3+WebDAV 第三方同步（支持阿里云 OSS、七牛、R2 等，需用户自行购买云存储）。说明：不含官方 8G 云盘与收集箱。补充说明：订阅或功能包过期后，本地所有笔记永久保留可用，仅云端同步、会员专属功能（如收集箱、云盘）会停用。五、新手分步使用指南步骤 1：下载安装 + 初始化工作空间（重中之重）下载软件 访问官网 https://b3log.org/siyuan/download.html，下载 Windows、macOS、Linux 或手机应用商店对应安装包。新建工作空间 首次打开软件，务必新建工作空间文件夹（即笔记数据存放目录）。✅ 推荐：D 盘或 E 盘新建独立文件夹（如D:\SiYuan 知识库）。❌ 禁止：C 盘系统目录、iCloud/OneDrive/坚果云同步文件夹、软件安装目录（极易导致丢数据）。备份密钥 进入软件后，点击设置→关于→初始化数据仓库密钥，复制密钥并备份。这是同步必备项，丢失密钥无法解密云端数据。步骤 2：基础操作入门新建笔记 左侧「文档树」右键→新建笔记本（分类：考研/工作/随笔）；使用Ctrl+N新建文档。快捷编辑 输入/唤起快捷插入菜单，快速插入标题、表格、脑图；使用#标签给文档打标签分类；使用[[文档名]]生成双向链接。使用右侧面板 右侧面板包括大纲（Alt+2 快速调出）、标签、全局图谱、收集箱（会员可用）。日常备份 定期手动复制工作空间/data 文件夹做本地备份（最稳妥）。步骤 3：进阶玩法日记自动化 新建日记模板，搭配日期变量，一键生成每日笔记；用 SQL 汇总当月日记。配置 S3 同步（72 元终身用户） 设置→云端→S3，填入阿里云、七牛等 AccessKey 及存储桶信息，实现全端增量同步。安装浏览器剪藏 安装思源官方浏览器插件，一键收藏网页至知识库。六、全场景避坑指南（高频踩坑汇总）1. 数据存储&同步大坑（最高危）❌ 不要直接同步整个工作空间 严禁使用百度云、坚果云、OneDrive 直接同步整个工作空间文件夹。软件运行时同步会损坏.sy源文件，导致笔记乱码丢失。正确做法：仅可手动单独同步data文件夹，同步前必须关闭思源软件。❌ 密钥管理 密钥丢失=云端数据报废。初始化密钥后务必复制存记事本，多设备同步必须导入同一密钥。密钥遗失只能重置密钥、本地备份恢复，云端加密数据无法找回。❌ 坚果云兼容性 官方明确不兼容坚果云 WebDAV，建议选 InfiniCLOUD、自建 WebDAV 或 S3 对象存储。✅ 免费用户迁移 免费用户多设备迁移：复制完整data文件夹到新设备工作空间即可。2. 文件&编辑坑超大文档优化 单篇文档内容超 10 万字建议拆分，避免移动端加载卡顿；附件图片过多应及时清理无效资源。导入 Markdown 预处理 导入前请清理文档多余空行，思源无批量删空行功能，导入后无法一键清理。示例文档 不要在默认「用户指南」笔记本写内容，官方示例文档重启会自动重置清空。3. 移动端&插件坑手机端插件限制 iOS/Android 阉割了插件系统，复杂知识库优先桌面端编辑，手机仅做查阅、简短记录。插件兼容性 更换软件版本后少数老旧插件可能失效，更换主题时优先下载官方集市高评分插件。4. 付费避坑按需购买 只需要自建云同步→买72 元终身 S3 包；需要官方一键云同步 + 收集箱→开 148 元年会员，无需重复购买。续费焦虑 会员到期本地数据完全保留，不用担心笔记锁定或强制续费。5. 系统设置坑时间同步 多设备同步时务必统一系统时间（误差＜1 分钟），时间不一致会导致同步失败或数据错乱。S3 设置 S3 同步建议关闭 CDN 加速以避免连接异常。七、补充优势兜底即便官方停止运营：本地笔记照常打开：本地文件无需任何额外软件即可读取。数据完全迁移：全量导出标准 Markdown 即可迁移至任意笔记软件。底层可解析：底层解析代码全开源，可自行开发工具解析数据，确保数据永久可控。

 Docusaurus图标

Docusaurus

Docusaurus 全指南官网： https://docusaurus.io/zh-CN/定义： Meta（原 Facebook）开源、基于 React 的静态文档站点生成器，主打内容建站、快速搭建文档/博客官网。一、平台介绍Docusaurus 是 Meta 开源、MIT 开源协议的现代化静态站点生成工具。2017 年首发，当前主流为 V3 版本。核心设计： 文档即代码，只用 Markdown/MDX 写内容，自动生成 SPA（单页应用）静态网站。底层技术： 基于 React + Webpack，构建后输出纯静态 HTML/CSS/JS，可部署至任意静态服务器。设计初衷： 解决开源项目重复搭建文档站、重复造轮子的问题。Redux、React Native、Testing Library、IOTA、Temporal 等知名项目官方文档均使用本框架。定位： 不止用于技术文档，还能制作产品官网、知识库、个人博客、教程站点。二、主要核心功能1. MDX 文档引擎（核心）内容支持： 原生支持 Markdown 和 MDX。MDX 可在文档内嵌入 React 组件、交互式代码块。渲染体验： 普通 md 文档直接渲染网页，无需手写 HTML。扩展语法： 内置文档提示块、代码高亮、Mermaid 流程图、目录锚点（右侧 TOC）等。2. 文档版本化功能： 一键生成多版本文档，适配软件迭代。操作： 执行 docusaurus docs:version 2.0，用户可在顶部下拉菜单切换 V1/V2/V3 历史文档，文档发版与产品版本一一对应。3. 多语言国际化（i18n）功能： 开箱即用本地化，支持 Crowdin/Git 批量翻译。实现： 文档按语种存放，网站一键切换中英文或多语言，支持独立部署不同语言站点。4. 内置全文搜索（Algolia）搜索： 原生集成 Algolia DocSearch，开源项目免费申请搜索索引，实现全站内容秒搜。私有化： 私有项目可付费升级 Algolia 商业版。5. 博客 + 官网一体化博客模块： classic 模板自带博客功能，/blog 目录写 md 自动生成博文列表。独立页面： src/pages 可自定义独立页面，快速制作产品首页、关于页。6. 主题与暗黑模式外观： 默认主题自带亮色/暗黑一键切换，支持自定义 CSS。深度定制： 通过 Swizzle 机制修改 React 组件，深度定制页面布局、导航、侧边栏。7. 插件扩展生态插件架构： 评论、统计、图片优化、API 文档生成、RSS 订阅等均可通过第三方插件接入。数据复用： 支持复用已有插件数据。8. 自动化部署产物： 构建产物为 build 纯静态文件夹。部署： 支持一键部署至 GitHub Pages、Vercel、Netlify 或 Nginx 服务器。三、适用人群开源项目开发者： 开源库、组件、框架维护者，快速搭建开源官方文档（如 Redux、React 生态通用选型）。企业产品/研发团队： 产品帮助文档、API 手册、内部知识库、运维手册。个人博主/技术作者： 技术博客、读书笔记、个人知识库站点。内容运营/培训机构： 在线教程、课程文档、产品官网。⚠️ 不适合人群： 需要纯在线协作编辑文档的用户（如石墨/飞书文档模式）。Docusaurus 采用源码 +Markdown 离线编写、静态部署模式。四、免费与付费详情✅ Docusaurus 框架本体：永久 100% 免费协议： MIT 开源协议，无任何软件授权费。限制： 无项目数量限制，无商用收费。个人/企业/商业项目可随便商用、二次修改源码。自带功能： 基础主题、文档/博客/版本/多语言/搜索（开源版）全功能免费。搜索： 开源项目可申请 Algolia DocSearch 免费索引；私有商业站点 Algolia 按需付费升级。⚠️ 潜在自费项（非框架收费）服务器与域名：免费部署： GitHub Pages（公开仓库）、Vercel 免费套餐、Netlify 免费套餐。付费： 自有云服务器、独立域名、Vercel/Netlify 企业套餐（针对大流量站点）。定制开发： 深度定制页面、自研插件需前端人力成本。第三方增值服务： Algolia 商业搜索、付费主题、评论服务（Giscus 免费，Disqus 付费）。五、完整使用步骤（快速上手，5 分钟建站）前置环境安装 Node.js ≥ 16.14（建议官网下载 LTS 版本）。1. 初始化新项目（终端执行）bash# 经典模板（含文档 + 博客，推荐） npx create-docusaurus@latest my-doc-site classic # TS 版本项目（可选） npx create-docusaurus@latest my-doc-site classic --typescript # 经典模板（含文档 + 博客，推荐） npx create-docusaurus@latest my-doc-site classic # TS 版本项目（可选） npx create-docusaurus@latest my-doc-site classic --typescript 注：my-doc-site 为项目文件夹名，可自定义。2. 本地预览调试bashcd my-doc-site npm start # 启动本地服务，访问 http://localhost:3000，修改 md 实时刷新 cd my-doc-site npm start # 启动本地服务，访问 http://localhost:3000，修改 md 实时刷新 3. 核心目录结构（写文档只需关注 2 个文件夹）├── docs/ # 存放所有技术文档（新建 xxx.md 自动生成页面） ├── blog/ # 博客文章目录，md 文件自动生成博文 ├── src/ │ ├── css/ │ │ └── custom.css # 全局自定义样式 │ └── pages/ # 自定义独立页面 ├── docusaurus.config.js # 网站全局配置（标题、导航、logo、域名） ├── sidebars.js # 侧边栏目录配置 ├── static/ # 图片、图标等静态资源 ├── docs/ # 存放所有技术文档（新建 xxx.md 自动生成页面） ├── blog/ # 博客文章目录，md 文件自动生成博文 ├── src/ │ ├── css/ │ │ └── custom.css # 全局自定义样式 │ └── pages/ # 自定义独立页面 ├── docusaurus.config.js # 网站全局配置（标题、导航、logo、域名） ├── sidebars.js # 侧边栏目录配置 ├── static/ # 图片、图标等静态资源 新增文档： 在 docs 新建 安装指南.md，重启服务自动生成页面。修改导航： 在 docusaurus.config.js → themeConfig.navbar 配置菜单。4. 打包静态文件bashnpm run build # 生成 build 文件夹（最终上线文件） npm run build # 生成 build 文件夹（最终上线文件） 5. 部署上线（3 种主流方案）GitHub Pages（免费）： 配置 config 后执行 npm run deploy 一键推送部署。Vercel/Netlify（免费）： 绑定 GitHub 仓库，提交代码自动打包部署。自建 Nginx 服务器： 将 build 内所有文件上传至网站根目录，配置 Nginx 静态站点。6. 进阶配置开启版本： npm run docs:version 1.0.0 生成 V1 文档。多语言： 使用官方 i18n 命令提取翻译模板，翻译后切换语言。搜索： 前往 Algolia 官网申请 DocSearch，将 key 填入 config。六、高频避坑指南（新手必看）1. 环境相关坑Node 版本过低： 必须 ≥ 16.14，Node 14 及以下会出现依赖报错、启动失败。建议用 nvm/fnm 切换 Node 版本。依赖错乱： 遇到依赖报错，先执行 rm -rf node_modules package-lock.json && npm install 重装依赖。2. MDX 语法坑（V3 采用 MDX3）大括号报错： {} 在文档中被识别为 JS 表达式。写 {key:value} 代码示例时，改用反引号代码块，或转义 {。旧版本不兼容： 从 V2 升级 V3 时，用 npx docusaurus-mdx-checker 一键检查所有文档语法错误。3. 侧边栏&链接报错侧边栏 undefined： 文件夹缺少 _category_.json 分类配置文件，或文件名、路径拼写和 sidebars 配置不一致。链接失效警告： 构建提示 brokenLinks 时，config 中 onBrokenLinks 临时改为 warn，修正文档内失效链接后改回 error 校验。4. 部署&访问坑本地访问限制： 默认只能 localhost 访问。需要局域网 IP 访问执行 npm start -- --host 0.0.0.0。部署后页面空白： 检查 config 的 baseUrl，子域名部署需配置对应路径（如 baseUrl:"/doc/"）。国内访问问题： 国内 Vercel 域名可能被墙，建议绑定自有备案域名，或改用 Cloudflare/国内静态托管。5. 定制开发坑不要修改 node_modules： 自定义组件用 swizzle 命令弹出源码修改，升级版本不会覆盖自定义代码。暗黑模式样式： 自定义 CSS 写在 src/css/custom.css，避免覆盖框架原生变量。6. 搜索相关坑审核周期： Algolia 免费索引审核周期 1~3 天，上线前先关闭搜索，审核通过再填入配置。私有站点： 私有站点无法免费申请 Algolia，建议改用本地 lunr 离线搜索插件。七、补充：同类选型对比GitBook： 以 SaaS 付费为主，支持在线编辑；Docusaurus 为源码本地编写、全免费。VitePress： 基于 Vue 技术栈；Docusaurus 基于 React，自定义组件更灵活，版本/国际化功能更强。MkDocs： 基于 Python 栈，定制能力较弱；Docusaurus 前端生态丰富、插件更多。

 BookStack图标

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

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

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 或更大模型以获得更好的中文理解能力。