基于华为openEuler系统部署Blinko开源个人笔记工具

前言
一、相关服务介绍
- [1.1 openEuler系统介绍](#1.1 openEuler系统介绍)
- [1.2 Blinko介绍](#1.2 Blinko介绍)
二、本次实践介绍
- [2.1 本次实践介绍](#2.1 本次实践介绍)
- [2.2 本次环境规划](#2.2 本次环境规划)
三、本地环境检查
- [3.1 检查系统版本](#3.1 检查系统版本)
- [3.2 检查内核版本](#3.2 检查内核版本)
- [3.3 检查本地IP](#3.3 检查本地IP)
- [3.4 检查Docker环境](#3.4 检查Docker环境)
四、部署Blinko系统
- [4.1 下载Blinko镜像](#4.1 下载Blinko镜像)
- [4.2 创建Blinko容器](#4.2 创建Blinko容器)
- [4.3 检查Blinko容器状态](#4.3 检查Blinko容器状态)
- [4.4 检查Blinko容器日志](#4.4 检查Blinko容器日志)
五、访问Blinko服务
六、Blinko基本使用
- [6.1 注册账号](#6.1 注册账号)
- [6.2 设置中文](#6.2 设置中文)
- [6.3 笔记功能](#6.3 笔记功能)
七、总结

前言

在数字化时代，高效管理个人知识与灵感变得愈发重要。Blinko 作为一款开源、AI 增强的轻量级笔记工具，为用户提供了私有化部署的灵活选择。结合华为自研的 openEuler 操作系统，不仅体现了对国产根技术生态的支持，也确保了数据安全与系统稳定性。本文将详细介绍如何在 openEuler 环境下部署并使用 Blinko，助力用户构建自主可控的个人知识管理系统。

一、相关服务介绍

1.1 openEuler系统介绍

简介

openEuler是华为发起并主导的一个开源操作系统项目，它基于Linux内核开发，致力于为企业级应用提供安全、稳定、可靠的操作环境。自2019年正式开源以来，openEuler迅速吸引了全球众多开发者和技术爱好者的关注，并逐渐形成了一个活跃的开源社区。该系统不仅支持多种处理器架构（如x86、ARM等），而且通过持续的技术创新，在性能优化、安全性增强以及容器化支持等方面展现了显著的优势。

主要特点

开源性：openEuler遵循开源协议，允许任何个人或组织自由获取、使用、修改及分发系统代码，这极大地促进了技术创新与共享。

高性能与稳定性：通过对Linux内核进行深度优化，openEuler能够提供出色的运行效率和稳定性，满足企业级应用场景的需求。

安全性：提供了包括安全启动、数据加密在内的多重安全保障措施，确保用户数据的安全性。

容器化支持：兼容Docker和Kubernetes等容器技术，便于开发者构建、部署和管理容器化应用。

丰富的生态系统：拥有庞大的开发者社区和丰富的软件库，为用户提供广泛的软件支持和服务。

1.2 Blinko介绍

Blinko 简介

Blinko 是一款开源的灵感捕捉工具，帮助用户即时记录、整理并高效管理个人知识，结合 AI 技术确保创意不被遗漏。

主要特点

🤖 AI 增强笔记检索：基于 RAG 技术，支持用自然语言快速搜索个人笔记。

🔒 数据所有权：所有数据本地自托管，用户完全掌控自己的信息与隐私。

🚀 高效快速：支持即时记录、纯文本存储和 Markdown 格式化，便于快速编辑与分享。

💡 轻量级架构与高性能：基于 Next.js 构建，兼顾简洁性与强大处理能力。

🔓 开放协作：代码开源托管于 GitHub，欢迎社区参与贡献与改进。

🎉 完全免费：无任何隐藏费用或功能限制，所有功能免费使用。

二、本次实践介绍

2.1 本次实践介绍

1.本次实践环境为个人测试环境，生产环境请谨慎；

2.本次实践主要是在openEuler系统下部署Blinko开源个人笔记工具。

2.2 本次环境规划

本次环境规划如下所示：

服务器	HostName	IP地址	操作系统	内核版本	部署项目	备注
VM虚拟机	openEuler001	192.168.3.83	openEuler 24.03 (LTS)	6.6.0-28.0.0.34.oe2403.x86_64	Blinko	------

三、本地环境检查

3.1 检查系统版本

检查当前系统版本，当前系统版本为openEuler 24.03 (LTS)。

bash 复制代码

[root@openEuler001 ~]# cat /etc/os-release
NAME="openEuler"
VERSION="24.03 (LTS)"
ID="openEuler"
VERSION_ID="24.03"
PRETTY_NAME="openEuler 24.03 (LTS)"
ANSI_COLOR="0;31"

3.2 检查内核版本

检查当前内核版本，如下所示：

bash 复制代码

[root@openEuler001 ~]# uname -r
6.6.0-28.0.0.34.oe2403.x86_64

3.3 检查本地IP

查看本地IP地址，本次实践本地IP设置为192.168.3.83/24。

bash 复制代码

[root@openEuler001 ~]# ifconfig ens18
ens18: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>  mtu 1500
        inet 192.168.3.83  netmask 255.255.255.0  broadcast 192.168.3.255
        inet6 fe80::be24:11ff:fefc:b486  prefixlen 64  scopeid 0x20<link>
        ether bc:24:11:fc:b4:86  txqueuelen 1000  (Ethernet)
        RX packets 4667340  bytes 3045501405 (2.8 GiB)
        RX errors 0  dropped 11  overruns 0  frame 0
        TX packets 1768427  bytes 749098567 (714.3 MiB)
        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0

[root@openEuler001 ~]#

3.4 检查Docker环境

本次实践需要提前部署好Docker环境，检查Docker版本如下所示：

bash 复制代码

[root@openEuler-server ~]# docker -v
Docker version 26.1.3, build b72abbb

四、部署Blinko系统

4.1 下载Blinko镜像

拉取Blinko镜像，如下所示：

bash 复制代码

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

4.2 创建Blinko容器

为了方便管理项目部署文件和挂载容器目录，这里我们创建/data/blinko目录。

bash 复制代码

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

新建及编辑docker-compose.yaml文件，内容如下所示。可自行修改宿主机映射端口，注意防止宿主机端口冲突。

bash 复制代码

vim docker-compose.yaml

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:
      - 3900: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

执行以下命令，使用docker compose命令快速部署Blinko。

bash 复制代码

docker compose up -d

4.3 检查Blinko容器状态

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

bash 复制代码

[root@openEuler001 blinko]# docker compose ps
NAME              IMAGE                      COMMAND                  SERVICE          CREATED         STATUS                                 PORTS
blinko-postgres   postgres:14                "docker-entrypoint.s..."   postgres         2 minutes ago   Up 2 minutes (healthy)                 0.0.0.0:5435->5432/tcp, :::5435->5432/tcp
blinko-website    blinkospace/blinko:0.5.4   "docker-entrypoint.s..."   blinko-website   2 minutes ago   Up About a minute (health: starting)   0.0.0.0:3900->1111/tcp, :::3900->1111/tcp

4.4 检查Blinko容器日志

检查Blinko容器日志，确保Blinko服务正常启动。

bash 复制代码

docker compose logs

五、访问Blinko服务

访问地址：http://【服务器IP地址】:3900，将其中IP替换为自己服务器IP地址。如果无法访问到Blinko页面，检查防火墙是否关闭或者放行相关端口，云服务器则还需设置安全组规则。

六、Blinko基本使用

6.1 注册账号

在Blinko登录界面，我们自行注册账号即可。

使用刚才注册的账号密码登录，即可进入到Blinko首页。

6.2 设置中文

系统设置------语言------简体中文，即可设置Blinko语言为中文。

6.3 笔记功能

编辑笔记内容完成后，点击发布即可。

七、总结

通过本次实践，我们成功在华为 openEuler 系统上完成了 Blinko 的容器化部署与基础配置。整个过程验证了 Blinko 在国产操作系统上的良好兼容性与易用性，充分发挥了其轻量、安全、免费的优势。借助 openEuler 的稳定内核与 Blinko 的 AI 增强功能，用户可构建一个完全自主、高效且隐私可控的笔记平台。未来，随着开源社区与国产基础软件生态的持续融合，此类组合将为个人与企业知识管理提供更坚实的技术底座。