强曰为道
与天地相似,故不违。知周乎万物,而道济天下,故不过。旁行而不流,乐天知命,故不忧.
文档目录

Buku 书签管理完全指南

Buku 书签管理完全指南

一套面向开发者、系统管理员和效率爱好者的 Buku 命令行书签管理工具综合教程。

为什么选择 Buku?

Buku(发音 /buːkuː/)是一款强大的命令行书签管理器,使用 Python 编写,底层以 SQLite 作为存储引擎。它不依赖任何外部服务或云同步,所有书签数据完全存储在本地,支持加密保护,同时提供丰富的搜索、标签和导入导出功能。

┌────────────────────────────────────────────────────────────────┐
│                    Buku 核心特性一览                             │
├────────────────────────────────────────────────────────────────┤
│  📑 书签管理    添加/编辑/删除/打开/排序                          │
│  🔍 强大搜索    正则表达式/标签搜索/多条件组合/模糊匹配            │
│  🏷️ 标签系统    自动标签/层级标签/批量标签操作                     │
│  🔒 加密存储    AES-256 数据库加密/密码保护                       │
│  📦 导入导出    HTML/JSON/Markdown/XBEL/Org/浏览器原生格式        │
│  🌐 Web 服务    内置 HTTP API/远程访问/Token 认证                 │
│  🧩 生态集成    Firefox/Chrome 扩展/Vim 插件/Emacs 包/Docker     │
│  🐍 脚本友好    管道操作/JSON 输出/Shell 脚本自动化               │
└────────────────────────────────────────────────────────────────┘

Buku 与其他书签工具对比

特性BukuPinboardRaindrop.ioLinkdingShiori
部署方式本地 CLI云服务云服务自托管 Web自托管 Web
数据存储SQLite(本地)云端云端SQLiteSQLite
离线使用部分
加密保护✅ AES-256
命令行操作✅ 完整
API 接口✅ HTTP API✅ API✅ API✅ API✅ API
全文搜索✅ 标题+URL+标签
标签系统✅ 多标签
浏览器扩展
免费开源✅ MIT❌ 付费部分免费✅ MIT✅ MIT
依赖Python 3GoGo

适用场景

场景说明
终端重度用户全程在命令行中完成书签管理,无需切换浏览器
隐私敏感用户数据存储在本地,支持 AES-256 加密,不依赖第三方云服务
开发者丰富的 API 和脚本接口,便于自动化集成
系统管理员可通过 SSH 远程管理书签,支持 Docker 部署
知识工作者强大的搜索和标签系统,构建个人知识库
多设备同步通过 Syncthing/rsync/Git 等工具自由同步数据库文件

教程目录

第一部分:基础入门

章节标题核心内容
第 01 章Buku 概述功能特性、与其他工具对比、适用场景、设计理念
第 02 章安装与配置pip 安装、包管理器安装、依赖配置、浏览器扩展
第 03 章基本操作添加/搜索/打开/删除/更新书签、基本工作流

第二部分:核心功能

章节标题核心内容
第 04 章搜索详解正则表达式、标签搜索、排除搜索、模糊搜索、组合搜索
第 05 章标签管理自动标签、层级标签、标签搜索、批量操作
第 06 章导入导出HTML/JSON/Markdown 格式、浏览器迁移、同步方案

第三部分:高级特性

章节标题核心内容
第 07 章加密与安全AES-256 加密、密码管理、安全存储策略
第 08 章Web 服务器内置 HTTP 服务器、API 接口、远程访问、认证配置
第 09 章HTTP APIRESTful API、编程访问、脚本集成、自动化工作流

第四部分:生态集成

章节标题核心内容
第 10 章集成与插件浏览器扩展、Vim 插件、Emacs 包、脚本集成
第 11 章Docker 部署容器化部署、数据持久化、Compose 配置、备份方案

第五部分:最佳实践

章节标题核心内容
第 12 章最佳实践工作流设计、标签策略、备份方案、同步策略

适用读者

  • 终端用户:习惯在命令行中工作,希望高效管理书签的开发者和系统管理员
  • 隐私优先用户:不信任云服务,希望数据完全掌控在自己手中
  • 自动化爱好者:希望通过脚本和 API 实现书签管理自动化
  • 知识工作者:需要构建个人书签知识库,支持高效的检索和分类
  • Docker 用户:希望在自托管环境中部署书签管理服务

环境说明

本教程中所有示例基于以下环境:

项目版本/说明
Buku4.9+
Python3.8+
操作系统Linux(示例基于 Debian/Ubuntu/Arch,其他发行版类似)
Shellbash 5.x
SQLite3.x(随 Python 内置)

快速开始

# 安装 Buku
pip3 install buku

# 添加第一条书签
buku -a https://github.com/jarun/buku "Buku - 命令行书签管理器" ,bookmark,cli,python

# 搜索书签
buku -s bookmark

# 列出所有书签
buku -p

# 启动 Web 服务
buku --sr 8080

速查:常用链接


提示:建议按照章节顺序阅读。如果已有命令行基础,可直接跳转到感兴趣的专题章节。每章末尾均有"扩展阅读"链接,可深入探索相关话题。