跳转至

环境搭建

本文介绍在 Ubuntu 服务器上搭建 my_wiki 所需的运行环境。

Python 虚拟环境

RAG 后端建议使用独立 venv,避免污染系统 Python。

python3 -m venv ~/mywiki-venv
source ~/mywiki-venv/bin/activate

关键依赖

在 venv 内安装:

pip install fastapi uvicorn openai
pip install "mkdocs-material"

说明:mkdocs-material 自带 mkdocs;openai 库用于以 OpenAI 兼容方式调用国内大模型(通义/DeepSeek/智谱均可)。

文档构建

cd ~/docs/my_wiki
mkdocs build -d site     # 产出静态文件到 site/
mkdocs serve             # 本地预览(可选)

运行 RAG 服务

cd ~/apps/wiki-backend
uvicorn main:app --host 0.0.0.0 --port 8001

其中 main:app 是 FastAPI 应用入口。

校验清单

  • 目录 ~/docs/my_wiki/docs/ 存在且有 md 文档
  • mkdocs build 能成功生成 site/
  • FastAPI 服务能在 8001 端口启动
  • 反向代理能访问到服务