一、Blinko介绍

1.1 Blinko简介

Blinko是一款专为快速捕捉并整理短暂灵感而设计的开源项目。它允许用户在灵感闪现的瞬间即时记录想法，确保每一个创意火花都不会丢失。通过集成先进的人工智能技术，Blinko 提供了强大的功能来帮助用户更高效地管理个人知识库。

1.2 主要特点

• 🤖AI 增强笔记检索：利用先进的RAG（检索增强生成）技术，用户可以通过自然语言查询快速搜索并访问自己的笔记，轻松找到所需信息。
• 🔒数据所有权：Blinko 强调用户的隐私权，所有笔记和数据均存储在用户自托管的环境中，确保用户对信息拥有完全控制权。
• 🚀高效快速：可以即时捕获想法，并以纯文本格式存储，支持Markdown快速格式化和无缝分享。
• 💡轻量级架构与重负荷处理能力：基于Next.js构建，Blinko 拥有简洁的轻量级架构，同时提供强大的性能，既不会牺牲速度也不会影响效率。
• 🔓开放协作：作为一个开源项目，Blinko 鼓励社区贡献，所有的代码都是透明的，并且可以在GitHub上获取，促进了合作精神和持续改进的文化。
• 🎉完全免费：Blinko 是免费提供的，没有隐藏费用或付费墙后的高级功能。

1.3 主要使用场景

• 创意工作者：作家、艺术家、设计师等创意领域的专业人士可以使用Blinko 来捕捉一闪即逝的灵感，随时记录下那些可能成为下一个大作的点子。
• 学生和教师：学习过程中产生的问题、课程中的重要知识点或者教学过程中的心得都可以迅速记录下来，方便复习和回顾。
• 团队协作：项目团队成员可以利用Blinko 记录会议要点、任务分配或是突发的想法，促进团队内部的信息共享和沟通。
• 个人成长与发展：个人可以记录日常学习的新知识、生活感悟或是职业规划，通过持续的自我反思促进个人成长。

二、本次实践规划

2.1 本地环境规划

本次实践为个人测试环境，操作系统版本为|Ubuntu 22.04.1。

2.2 本次实践介绍

1.本次实践部署环境为个人测试环境，生产环境请谨慎；
2.在Docker环境下部署Blinko开源个人笔记工具。

三、本地环境检查

3.1 检查Docker服务状态

检查Docker服务是否正常运行，确保Docker正常运行。

root@jeven01:~# systemctl status docker
● docker.service - Docker Application Container Engine
     Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled)
     Active: active (running) since Mon 2024-09-09 10:43:35 CST; 3 weeks 5 days ago
       Docs: https://docs.docker.com
   Main PID: 695 (dockerd)
      Tasks: 135 (limit: 9387)
     Memory: 4.0G
        CPU: 46min 46.854s
     CGroup: /system.slice/docker.service
             ├─  695 /usr/bin/dockerd
             ├─  846 containerd --config /var/run/docker/containerd/containerd.toml

3.2 检查Docker版本

检查Docker版本

root@jeven01:~# docker -v
Docker version 27.1.1, build 6312585

3.3 检查docker compose 版本

检查Docker compose版本，确保2.0以上版本。

root@jeven01:~# docker compose version
Docker Compose version v2.19.1

四、下载Blinko镜像

执行以下命令，拉取以下Blinko相关镜像。

docker pull blinkospace/blinko:0.5.4
docker pull  postgres:14

五、部署Blinko应用

5.1 创建部署目录

• 创建部署目录

mkdir -p /data/blinko && cd /data/blinko

5.2 编辑部署文件

在`部署目录下，创建docker-compose.yaml文件，其中宿主机映射端口等可以自定义配置。

vim docker-compose.yaml

networks:
  blinko-network:
    driver: bridge

services:
  blinko-website:
    image: blinkospace/blinko:0.5.4
    container_name: blinko-website
    environment:
      NODE_ENV: production
      # NEXTAUTH_URL: http://localhost:1111
      # NEXT_PUBLIC_BASE_URL: http://localhost:1111
      NEXTAUTH_SECRET: blinko
      DATABASE_URL: postgresql://postgres:blinko@postgres:5432/postgres
    depends_on:
      postgres:
        condition: service_healthy
    # Make sure you have enough permissions.
    # volumes:
      # - ~/your-name/.blinko:/app/.blinko
    restart: always
    logging:
      options:
        max-size: "10m"
        max-file: "3"
    ports:
      - 2600:1111
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:1111/"]
      interval: 30s
      timeout: 10s
      retries: 5
      start_period: 30s
    networks:
      - blinko-network

  postgres:
    image: postgres:14
    container_name: blinko-postgres
    restart: always
    ports:
      - 5435:5432
    environment:
      POSTGRES_DB: postgres
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: blinko
      TZ: Asia/Shanghai
    healthcheck:
      test:
        ["CMD", "pg_isready", "-U", "postgres", "-d", "postgres"]
      interval: 5s
      timeout: 10s
      retries: 5
    networks:
      - blinko-network


     

5.3 创建Blinko容器

执行以下命令，创建Blinko容器。

root@jeven01:/data/blinko# docker compose up -d
[+] Running 3/3
 ✔ Network blinko_blinko-network  Created                                                                           0.1s
 ✔ Container blinko-postgres      Healthy                                                                           5.8s
 ✔ Container blinko-website       Started                                                                           6.1s

5.4 查看Blinko容器状态

检查Blinko容器状态状态，确保Blinko容器正常启动。

root@jeven01:/data/blinko# docker compose ps
NAME                IMAGE                      COMMAND                  SERVICE             CREATED             STATUS                  PORTS
blinko-postgres     postgres:14                "docker-entrypoint.s…"   postgres            6 minutes ago       Up 6 minutes (healthy)     0.0.0.0:5435->5432/tcp, :::5435->5432/tcp
blinko-website      blinkospace/blinko:0.5.4   "docker-entrypoint.s…"   blinko-website      6 minutes ago       Up 6 minutes (unhealthy)   0.0.0.0:2600->1111/tcp, :::2600->1111/tcp

5.5 检查Blinko容器日志

检查Blinko容器日志，确保Blinko服务正常运行。

docker compose logs

六、访问Blinko服务

6.1 访问Blinko初始页

访问地址：http://192.168.3.88:2600，将IP替换为自己服务器IP地址。如果无法访问到以下页面，则检查宿主机的防火墙是否关闭或者放行相关端口，云服务器则还需要设置安全组规则。

6.2 注册账号

点击"Sign up" ，开始注册账号，进入账号注册页面。

自定义注册账号即可，填写账号密码信息。

注册账号完毕后，重新回到登录页，登录即可。

七、Blinko的基本使用

7.1 设置中文语言

Blinko应用支持中文，我们在左侧菜单栏，选择Settings --> Language -->简体中文。

7.2 新建笔记

点击笔记模块，编辑笔记内容后，点击保存即可。

7.3 发布闪念

如果有一些比较重要的灵感和想法，可以使用闪念功能，编辑后，直接发布保存即可。

7.4 资源管理

在闪念中上传的图片等文件资源，会在资源模块中集中显示。

八、总结

在Docker中部署Blinko的过程简单直接，极大地提升了初始设置的速度和效率。使用Docker-compose文件，可以轻松配置所需的全部服务，使得整个系统更加稳定可靠。Blinko的容器化部署还带来了额外的安全优势，确保了应用程序与主机系统的隔离。通过Docker，更新Blinko或调整其配置也变得更加简便快捷。