环境搭建¶
本文介绍在 Ubuntu 服务器上搭建 my_wiki 所需的运行环境。
Python 虚拟环境¶
RAG 后端建议使用独立 venv,避免污染系统 Python。
关键依赖¶
在 venv 内安装:
说明:mkdocs-material 自带 mkdocs;
openai库用于以 OpenAI 兼容方式调用国内大模型(通义/DeepSeek/智谱均可)。
文档构建¶
运行 RAG 服务¶
其中 main:app 是 FastAPI 应用入口。
校验清单¶
- 目录
~/docs/my_wiki/docs/存在且有 md 文档 -
mkdocs build能成功生成site/ - FastAPI 服务能在 8001 端口启动
- 反向代理能访问到服务