baealex/ocean-brain

Ocean Brain 镜像文档

镜像概述和主要用途

Ocean Brain 是一款类 Notion 风格的笔记应用 Docker 镜像，封装了完整的笔记管理系统运行环境。该镜像旨在提供轻量化、易部署的知识管理工具，适用于个人或团队进行笔记创建、内容编辑、知识结构化整理及协作管理场景。

核心功能和特性

• 直观的界面设计：采用类 Notion 的层级化页面结构，支持灵活的内容布局与拖拽操作
• 富媒体编辑能力：支持文本格式化、代码块、表格、列表及图片、文件嵌入等多种内容形式
• 数据持久化存储：通过容器数据卷挂载实现笔记数据本地保存，确保数据安全不丢失
• 跨平台部署：基于 Docker 容器化封装，可在 Linux、Windows、macOS 等系统中快速部署运行

使用场景和适用范围

• 个人知识管理：用于整理学习笔记、读书笔记、日程规划等个人信息
• 团队协作文档：支持多人协作编辑，适用于团队会议纪要、项目文档共享场景
• 内容创作工具：作为写作平台，支持草稿保存、版本回溯及内容导出功能
• 小型知识库构建：帮助个人或小团队搭建结构化的知识体系，便于信息检索与复用

部署与使用指南

基础 Docker 部署

通过以下命令快速启动 Ocean Brain 容器：

bash
docker run -d \
  --name ocean-brain \
  -p 8080:80 \
  -v /path/to/local/data:/app/data \
  oceanbrain:latest

参数说明：

• -d：后台运行容器
• --name ocean-brain：指定容器名称为 ocean-brain
• -p 8080:80：将容器内 80 端口映射至主机 8080 端口（可根据需求修改主机端口）
• -v /path/to/local/data:/app/data：将主机目录 /path/to/local/data 挂载至容器内 /app/data 目录，用于持久化存储笔记数据

容器访问与初始化

1. 容器启动后，通过浏览器访问 http://localhost:8080 进入应用界面
2. 首次使用需完成初始配置：创建管理员账户、设置基础信息及隐私权限
3. 完成配置后即可开始创建笔记页面，通过左侧导航栏进行页面组织与管理

进阶配置（可选）

如需自定义应用配置，可通过环境变量调整（具体参数请参考官方文档）：

bash
docker run -d \
  --name ocean-brain \
  -p 8080:80 \
  -v /path/to/local/data:/app/data \
  -e TZ="Asia/Shanghai" \
  -e LOG_LEVEL="info" \
  oceanbrain:latest

常用环境变量：

• TZ：设置容器时区（默认 UTC）
• LOG_LEVEL：日志输出级别（可选值：debug/info/warn/error，默认 info）

注：更多高级配置参数（如数据库连接、用户认证等）请查阅 Ocean Brain 官方文档获取详细说明。