跳转到内容

系统架构

NoteNow 采用「单后端托管前端静态资源」的部署形态:

组件 职责
FastAPI 后端 鉴权、笔记/笔记本 CRUD、对话、视频转写与分析任务
前端静态资源 由后端 / 与 SPA 回退路由托管
SQLite 默认业务库(DATABASE_URL)
Nginx / OpenResty TLS 终结;/note/ → 127.0.0.1:8000
ffmpeg / yt-dlp 视频处理与外链导入
浏览器
└─ https://notenow.cn
├─ / → 静态站点 (/var/www/notenow)
├─ /note/* → NoteNow API (127.0.0.1:8000)
└─ /agent/* → Agent 服务 (127.0.0.1:8019)

客户端调用 API 时,基址应使用:

https://notenow.cn/note
模块 路径前缀 说明
Auth /api/auth/* 注册、登录、资料、头像、改密
Notebooks /api/notebooks* 笔记本列表/创建/更新/删除/移动
Notes /api/notes* 笔记 CRUD、保存、导出、重生成大纲
AI /api/ai/* 对话、划词动作、转写配置
Video /api/video/* 上传/URL 任务、转写、分析
Payment /api/payment/* 会员、套餐、订单与配额
Cloud Drive /api/cloud-drive-resolver/* 网盘链接解析

建议纳入备份:

  • backend/data/*.db — 业务数据
  • backend/uploads/ — 上传文件
  • backend/.env — 密钥与运行配置(勿提交仓库)