部署与运行总览

本板块记录乐橙智康当前可核对的运行拓扑、本地启动、线上发布、环境变量、App 打包和常见故障排查。运行文档只保留完成交接和定位问题所需的事实，不登记密码、连接串、接口密钥或完整生产日志。

运行边界

边界	当前事实	核对入口
生产入口	Nginx 对外监听 80/443，静态官网与后端接口由同一个活动站点配置承载。	/etc/nginx/sites-enabled/fitdoc
后端服务	活动后端为 fitdoc-core.service，通过 127.0.0.1:8001 提供 FastAPI 服务。	systemctl show fitdoc-core
历史服务	fitdoc-rag.service 与旧 fitdoc.service 不承载当前生产流量。	运维手册、ECS systemd 状态
数据库	后端通过环境变量连接 RDS PostgreSQL core_base，RAG 主知识表为 knowledge_chunks。	.env 变量名、数据库 reference
文档站	VitePress 源码位于 docs_site/，生产发布路径为 /doc-center/。当前生产 Nginx 的 /docs 仍代理 FastAPI 文档面。	docs_site/.vitepress/config.ts、Nginx 配置
App 端	Flutter 通过 --dart-define 或默认配置确定 API 与视频资源基地址。	lib/config/environment_config.dart

内容地图

文档	阅读职责
本地运行	启动文档站、后端服务和 Flutter App，区分本地端口与生产端口。
部署拓扑	查看 ECS、Nginx、systemd、静态资源、FastAPI、RDS 与外部 AI 服务的关系。
线上部署流程	按检查、备份、发布、重启、验证的顺序执行生产更新。
环境变量说明	查询变量名、用途、默认行为和脱敏边界。
安装包打包流程	构建 Android APK，确认版本号、环境注入和签名边界。
常见问题与排查	定位后端、Nginx、数据库、RAG/LLM、CORS、静态资源和打包问题。

生产主链

flowchart LR
  User["外部访问\nApp / Browser"]
  Nginx["公网入口\nNginx :80/:443"]
  Static["静态站点\n官网 / 文档中心"]
  Backend["后端服务\nfitdoc-core :8001"]
  Data["运行依赖\nRDS / AI providers"]

  User --> Nginx
  Nginx --> Static
  Nginx --> Backend
  Backend --> Data

这张图只表达当前生产流量边界。接口细节、数据库表关系和 RAG 检索链路分别在 API、数据库和 AI/RAG 板块展开。

关键口径

• 本地后端开发端口使用 8000；生产后端 upstream 使用 127.0.0.1:8001。
• 当前生产公网不直接暴露 8001，后端请求通过 Nginx 转发。
• /uploads/ 由 Nginx 映射到后端上传目录，/static/videos/ 由 Nginx 映射到视频静态目录。
• 当前生产 /docs 命中 FastAPI 文档相关代理规则；VitePress 文档站发布在 /doc-center/，作为官网静态资源的一部分。
• 生产环境变量只在服务器环境文件中维护；文档仅记录变量名和语义。

来源锚点

• docs/新服务器运维手册.md
• docs_site/.vitepress/config.ts
• apps/backend_service/app/core/config.py
• apps/backend_service/.env.example
• apps/flutter_app/lib/config/environment_config.dart