cube-diary 是基于 nodejs 开发的全栈项目，致力于为个人打造轻量级的 web note 服务。基于 react / fastify / sqlite / typescript 开发。

查看桌面端截图

查看移动端截图

• 🚫 无广告、无收费、完全开源，自己的数据自己掌握
• 🚀 极其简单的部署，仅需一行命令
• 🪶 超轻量运行消耗（60MB 内存占用）
• 🧩 自定义 JSON 导入导出
• 📝 支持 MarkDown 语法，支持实时预览、自动保存、颜色标记
• 🔗 支持笔记内图片、文件上传
• 📱 桌面端 / 移动端全站响应式设计
• 🎯 支持关键字搜索
• 🤖 AI Ready，支持 Agent Skill

cube-diary 提供了 Agent Skill，允许 AI 助手（如 GitHub Copilot、Claude 等）通过自然语言直接操作日记。

首先安装 Skill 和工具：

npx skills add HoPGoldy/cube-diary --skils cube-diary

npm add -g openapi-agent-cli

然后告诉 Agent：

请帮我配置一下日记 skill

最后根据 Agent 的回复输入你的日记本地址和访问令牌（在应用「设置 → 访问令牌」中获取），就可以开始使用了！例如：

帮我记一下今天心情不错，天气也很好。

帮我把这个目录下的图片加到日记里。

本项目以及其简单的快速启动为目标，从零部署仅需一条命令：

docker run -d \
  --restart=always \
  -p 9736:3499 \
  -v cube-diary-storage:/app/packages/backend/storage \
  -e BACKEND_LOGIN_PASSWORD=V1StGXR8 \
  hopgoldy/cube-diary:3.3.0

启动命令说明：

• BACKEND_LOGIN_PASSWORD：用于指定登录密码，必填项，建议设置一个强密码。
• FRONTEND_BASE_URL：指定应用部署到的二级路径，例如想要部署到 https://your-domain/my-app/，那么该参数就需要配置为 /my-app/。
• BACKEND_JWT_SECRET 参数用于指定应用的 jwt 密钥，不配置的话，每次重启应用都会生成一个新的密钥。

1、安装依赖：

pnpm install

2、初始化后端开发数据库：

pnpm init:dev

启动后端服务：

pnpm start:backend

启动前端服务：

pnpm start:frontend

然后访问前端服务的地址即可。

如果需要自定义本地环境变量配置的话，可以进入对应的项目仓库，例如 packages/frontend 或者 packages/backend，将 .env 文件复制一份 .env.local，并填写其中参数。

.env.local 的配置会覆盖默认的 .env。

镜像构建：

# 在根目录下构建即可
docker build -t cube-diary:local .

容器启动：

docker run -p 3001:3499 cube-diary:local

所有数据均默认保存在应用目录下的 packages/backend/storage 文件夹里，所以直接将其打包然后复制到其他地方即可。

本项目源码基于 GPL v3 许可开源，点此 查看更多信息。