一站式指南：轻松部署Blinko卡片笔记，打造你的灵感管理中心

你是否在寻找一款能够随时捕捉转瞬即逝的灵感，并能通过AI智能管理的笔记工具？Blinko或许就是那个理想的答案。这是一个由AI驱动的卡片式笔记项目，专为追求高效、注重隐私的用户设计。它致力于让用户在最方便的时刻，以最无缝的方式记录下每一个想法，确保宝贵的创意火花不会被遗忘。

Blinko核心特色

  • 🤖 AI增强的智能检索：Blinko集成了先进的RAG（检索增强生成）技术，允许你使用日常的自然语言来查询笔记。无论是模糊的记忆片段还是具体的关键词，AI都能帮你快速定位到相关内容。它兼容OpenAI、Azure OpenAI以及本地的Ollama等多种AI服务提供商。
  • 🔒 数据完全自主可控：所有笔记数据都安全地存储在你自己的服务器环境中，无论是家庭NAS还是云服务器。你对自己创造的所有内容拥有百分之百的所有权和控制权，无需担心隐私泄露。
  • 🚀 极速记录与纯净格式：应用设计追求瞬时响应，确保灵感涌现时能被立刻捕捉。笔记以纯文本形式存储，全面支持Markdown语法，便于快速排版、结构化，并且分享起来毫无障碍。
  • 💡 轻量架构与全平台覆盖：基于现代框架Tauri构建，Blinko具备出色的性能与资源效率。其客户端支持macOS、Windows、Linux及Android等多个主流操作系统，实现跨设备的无缝体验。
  • 🔓 开源与社区共建：作为一个完全开源的项目，Blinko的代码在GitHub上公开透明，鼓励开发者参与贡献，共同推动功能迭代与生态发展。

你可以在项目发布页面下载对应平台的客户端： https://github.com/blinkospace/blinko/releases

访问在线演示体验基础功能（演示账号：blinko，密码：blinko）： https://demo.blinko.space/

部署安装指南

最便捷的部署方式是使用Docker Compose。这里提供两个版本的配置模板供你选择。

Docker Compose（官方推荐模板） 此模板包含完整的健康检查机制，确保服务稳定运行。

services:
  blinko-website:
    image: blinkospace/blinko:latest
    container_name: blinko-website
    environment:
      NODE_ENV: production
      NEXTAUTH_URL: http://localhost:1111
      NEXT_PUBLIC_BASE_URL: http://localhost:1111
      NEXTAUTH_SECRET: my_ultra_secure_nextauth_secret
      DATABASE_URL: postgresql://postgres:mysecretpassword@postgres:5432/postgres
    volumes:
      - ./blinko:/app/.blinko
    depends_on:
      postgres:
        condition: service_healthy
    restart: always
    ports:
      - 1111:1111
    healthcheck:
      test: ["CMD", "wget", "--spider", "http://blinko-website:1111/"]
      interval: 30s
      timeout: 10s
      retries: 5
      start_period: 30s

  postgres:
    image: postgres:14
    container_name: blinko-postgres
    restart: always
    ports:
      - 5432:5432
    environment:
      POSTGRES_DB: postgres
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: mysecretpassword
    volumes:
      - ./db:/var/lib/postgresql/data
    healthcheck:
      test:
        ["CMD", "pg_isready", "-U", "postgres", "-d", "postgres"]
      interval: 5s
      timeout: 10s
      retries: 5

Docker Compose（简化配置版） 如果你希望配置更简洁，可以使用此版本。注意：首次启动后，可能需要重启blinko-website容器以确保其能正确连接到数据库。

services:
  blinko-website:
    image: blinkospace/blinko:latest
    container_name: blinko-website
    ports:
      - 1111:1111
    environment:
      NODE_ENV: production
      NEXTAUTH_URL: http://localhost:1111
      NEXT_PUBLIC_BASE_URL: http://localhost:1111
      NEXTAUTH_SECRET: my_ultra_secure_nextauth_secret
      DATABASE_URL: postgresql://postgres:mysecretpassword@postgres:5432/postgres
    volumes:
      - ./blinko:/app/.blinko
    restart: always

  postgres:
    image: postgres:14
    container_name: blinko-postgres
    environment:
      POSTGRES_DB: postgres
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: mysecretpassword
    volumes:
      - ./db:/var/lib/postgresql/data
    restart: always

关键环境变量说明

  • NODE_ENV: 指定应用运行环境（例如 production）。
  • NEXTAUTH_URL: 应用的身份验证基础URL，用于生成回调链接。
  • NEXT_PUBLIC_BASE_URL: 应用的公开访问基础URL。
  • NEXTAUTH_SECRET: 用于加密会话的密钥，务必替换为高强度的随机字符串。
  • DATABASE_URL: PostgreSQL数据库的连接字符串。
  • POSTGRES_DB/POSTGRES_USER/POSTGRES_PASSWORD: 分别定义初始数据库名称、管理员用户名和密码。

快速上手与核心功能概览

  1. 访问与注册 在浏览器中输入 http://你的服务器IP:1111 即可访问Blinko的登录界面。 Image 初次使用，点击底部的“注册”链接。 Image 填写用户名、邮箱和密码完成注册。 Image 返回登录页，使用刚创建的账号登录（注册入口将隐藏）。 Image

  2. 主界面与核心模块 成功登录后，你将看到一个设计简洁美观的主界面。 Image

    • 闪念：快速记录当下想法的入口，没有任何负担。 Image
    • 笔记：更正式、可分类管理的笔记区域。可以通过底部切换不同分类。 Image
    • 待办：创建任务清单，规划工作与生活。支持自定义时间。 Image Image
    • 统计：以数字和图表形式直观展示你的笔记、待办完成情况等数据。 Image
    • 资源：集中管理所有上传的图片和文件。 Image
    • 归档：将暂时不用但需要保留的笔记移入此处，保持主列表清爽。 Image
    • 标签：为笔记添加标签，实现更精细的分类与快速筛选。 Image
    • 回收站：误删的笔记可以在这里找回（注意：直接删除的资源文件可能无法恢复）。 Image

  3. 扩展与设置

    • 插件系统：支持安装社区插件以扩展功能，当前生态正在成长中。 Image
    • 个性化设置：提供丰富的自定义选项，包括外观、编辑器偏好等。 Image
    • 多用户支持：完美支持团队或多个家庭成员共同使用。 Image
    • AI集成：在设置中配置OpenAI、Azure OpenAI或Ollama等API，即可解锁智能标签生成、内容总结等AI功能。 Image Image
    • 存储设置：默认情况下，上传的文件存储在容器内的/app/.blinko/files目录（通过卷映射到本地./blinko/files），而所有的文本、元数据则保存在PostgreSQL数据库中。 Image

确保数据持久化

对于自托管的笔记应用，数据安全是重中之重。请务必确认你的Docker卷映射配置正确，以保证数据在容器重启后不会丢失。

  1. 文件与图片：它们会保存在你本地目录的./blinko/files路径下（对应容器内路径）。 Image

  2. 数据库数据：所有笔记、用户信息等结构化数据均存储在PostgreSQL中。你可以通过以下命令进入数据库容器进行查看：

    # 进入postgres容器终端
docker exec -it blinko-postgres bash
# 切换用户并连接数据库
su postgres
psql
# 查看数据库列表，连接数据库，查看表
\list
\c postgres
\dt

    Image 例如，查询notes表中的所有记录：

    SELECT * FROM notes;

    Image

总结与评价

Blinko在众多自托管笔记应用中脱颖而出，其多平台客户端的支持与流畅的使用体验令人印象深刻，整体完成度很高，是一款值得推荐的优秀工具。

相较于我之前使用的Memos，Blinko在功能上更为全面，尤其是其强大的AI集成与美观的统计图表。目前我个人已计划将主力笔记场景迁移至Blinko。当然，任何工具都有优化空间：对于个人轻量级用户而言，依赖PostgreSQL显得有些“重量级”；此外，如果未来能增加一个社区或好友间的动态分享板块，其社交属性和趣味性会更强。

总而言之，如果你正在寻找一款能快速捕捉灵感、完全掌控数据、且具备AI辅助能力的笔记系统，Blinko是一个非常值得尝试的选择。它尤其适合记录日常的灵光一现和碎片化思考。

综合推荐指数：⭐⭐⭐⭐⭐（灵感捕捉利器，高效记录伙伴） 使用体验：⭐⭐⭐⭐⭐（界面优雅，功能完善） 部署难度：⭐⭐⭐（需要基本的Docker和数据库知识）