zefhemel/silverbullet

Silver Bullet

Silver Bullet (SB) 是一个可扩展的开源个人知识平台。其核心是一个简洁的基于 Markdown 的写作/笔记应用，将您的“页面”（笔记）存储为纯文本 Markdown 文件，存放在称为“空间”的文件夹中。页面可使用[[链接到其他页面]]语法进行交叉链接，使其成为个人知识管理的简单工具。通过各种扩展（称为“插件”），它可进一步扩展为知识平台，支持以个性化方式注释、组合和查询积累的知识。

核心功能和特性

• Markdown 原生支持：以纯文本 Markdown 格式存储笔记，确保数据开放性和可移植性
• 页面交叉链接：通过[[页面名称]]语法实现笔记间关联，构建知识网络
• 插件扩展系统：通过插件扩展功能，支持知识注释、组合与查询等高级能力
• 轻量部署：可通过 Docker 快速部署，适合个人本地或服务器环境使用

使用场景

• 个人知识管理（PKM）
• 笔记记录与整理
• 知识库构建与查询
• 个人学习与思考沉淀

使用 Docker 安装 Silver Bullet

Docker Hub 提供官方镜像 https://hub.docker.com/r/zefhemel/silverbullet%EF%BC%8C%E9%83%A8%E7%BD%B2%E6%AD%A5%E9%AA%A4%E5%A6%82%E4%B8%8B%EF%BC%9A

1. 创建数据卷

首先创建用于存储 Markdown 文件（空间）的数据卷：

shell
docker volume create myspace

2. 启动容器

运行容器，映射端口并挂载数据卷：

shell
docker run -p 3000:3000 -v myspace:/space -d --name silverbullet zefhemel/silverbullet

• -p 3000:3000：映射容器 3000 端口到主机，通过 http://localhost:3000 访问
• -v myspace:/space：将数据卷挂载到容器内的 /space 目录（存储笔记文件）
• -d：后台运行容器
• --name silverbullet：指定容器名称

3. 添加认证（可选）

通过命令行参数添加用户认证，例如：

shell
docker run -p 3000:3000 -v myspace:/space -d --name silverbullet zefhemel/silverbullet --user 用户名:密码

4. 使用 docker-compose（可选）

从源码检出后，通过 docker-compose 启动：

shell
PORT=3000 docker-compose up

5. 构建自定义镜像

如需构建自己的镜像，运行：

shell
./scripts/build_docker.sh

6. 升级方法

拉取最新镜像并重启容器：

shell
docker pull zefhemel/silverbullet
docker restart silverbullet