跳到主要内容

高级主题

超出默认配置：面向生产与贡献场景，对 OPL 数据空间做扩展、排障与运维。

OPL 数据空间对个人使用来说开箱即用，但真实部署通常还需要更多东西：生产数据库、横向扩展、结构化日志、可观测性，以及越来越常见的多租户运营方式。本节覆盖的是从“它在我笔记本上跑起来了”到“它服务整个组织”之间的那段路。

为什么需要 Advanced Topics​

扩展到单容器之外​

默认的 SQLite 与单 worker 适合小规模使用。一旦进入团队或生产环境，你通常会需要：

  • 切换到 PostgreSQL
  • 加入 Redis 共享状态
  • 在负载均衡后运行多个副本
  • 使用外部向量数据库

更有把握地排障​

一旦规模上来，第一句通常都是：“日志里写了什么？”
你需要能：

  • 调整日志级别
  • 输出结构化 JSON 日志
  • 接入 OpenTelemetry 做全链路追踪

参与项目开发​

如果你打算为 OPL 数据空间提 PR，这一节也会带你建立本地开发环境、理解开发流程，并跑起前后端热更新。

本节包含内容​

🚀 Scaling OPL 数据空间从 SQLite 迁移到 PostgreSQL，接入 Redis，运行多副本，配置外部向量数据库、共享存储与观测体系
🪵 Logging OPL 数据空间配置日志级别、调试输出，以及为生产日志平台启用 JSON 结构化日志
🛠️ Developing OPL 数据空间克隆仓库、分别运行前后端、在其他设备上测试，以及提交 pull request
🔒 Hardening OPL 数据空间为生产环境加固认证、密钥、CORS、安全头、审计与网络访问边界