【Docker项目实战】使用Docker部署Blinko开源个人笔记工具

一、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。

hostnameIP地址操作系统版本Docker版本镜像版本
jeven01192.168.3.88Ubuntu 22.04.1 LTS27.1.1latest

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
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.

3.2 检查Docker版本

检查Docker版本

root@jeven01:~# docker -v
Docker version 27.1.1, build 6312585
  • 1.
  • 2.

3.3 检查docker compose 版本

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

root@jeven01:~# docker compose version
Docker Compose version v2.19.1
  • 1.
  • 2.
  • 3.

四、下载Blinko镜像

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

docker pull blinkospace/blinko:0.5.4
docker pull  postgres:14
  • 1.
  • 2.
  • 3.

【Docker项目实战】使用Docker部署Blinko开源个人笔记工具_Docker

五、部署Blinko应用

5.1 创建部署目录

  • 创建部署目录
mkdir -p /data/blinko && cd /data/blinko
  • 1.

5.2 编辑部署文件

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

vim docker-compose.yaml
  • 1.
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
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
  • 25.
  • 26.
  • 27.
  • 28.
  • 29.
  • 30.
  • 31.
  • 32.
  • 33.
  • 34.
  • 35.
  • 36.
  • 37.
  • 38.
  • 39.
  • 40.
  • 41.
  • 42.
  • 43.
  • 44.
  • 45.
  • 46.
  • 47.
  • 48.
  • 49.
  • 50.
  • 51.
  • 52.
  • 53.
  • 54.
  • 55.
  • 56.
  • 57.
  • 58.

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
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.

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
  • 1.
  • 2.
  • 3.
  • 4.

5.5 检查Blinko容器日志

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

docker compose logs
  • 1.

【Docker项目实战】使用Docker部署Blinko开源个人笔记工具_docker_02

六、访问Blinko服务

6.1 访问Blinko初始页

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

【Docker项目实战】使用Docker部署Blinko开源个人笔记工具_插入图片_03

6.2 注册账号

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

【Docker项目实战】使用Docker部署Blinko开源个人笔记工具_Docker_04

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

【Docker项目实战】使用Docker部署Blinko开源个人笔记工具_插入图片_05

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

【Docker项目实战】使用Docker部署Blinko开源个人笔记工具_插入图片_06

七、Blinko的基本使用

7.1 设置中文语言

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

【Docker项目实战】使用Docker部署Blinko开源个人笔记工具_docker_07

7.2 新建笔记

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

【Docker项目实战】使用Docker部署Blinko开源个人笔记工具_Docker_08

7.3 发布闪念

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

【Docker项目实战】使用Docker部署Blinko开源个人笔记工具_Docker_09

7.4 资源管理

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

【Docker项目实战】使用Docker部署Blinko开源个人笔记工具_插入图片_10

八、总结

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