SilverBullet安装指南：3种部署方式快速上手自托管生产力工具-优快云博客

SilverBullet安装指南：3种部署方式快速上手自托管生产力工具

你是否正在寻找一款本地优先、支持自托管的个人知识管理与生产力工具？SilverBullet（思维工作坊）通过轻量化的Markdown界面和强大的插件系统，让你轻松构建个性化工作流。本文将详细介绍三种部署方式，帮助你快速启动SilverBullet服务。

部署方式对比

部署方式	难度	适用场景	维护成本
二进制安装	简单	本地开发/个人使用	低
Docker容器	中等	服务器部署/团队共享	中
源码编译	复杂	开发定制/二次开发	高

1. 二进制快速启动

环境准备

支持系统：Windows 64位、macOS（Intel/Apple Silicon）、Linux（x86_64/arm64）
官方文档：website/Install/Binary.md

安装步骤

# 1. 创建工作目录
mkdir silverbullet-space && cd silverbullet-space

# 2. 下载对应平台二进制文件
# 从 https://gitcode.com/GitHub_Trending/si/silverbullet/releases 获取最新版本

# 3. 运行服务
./silverbullet .

macOS安全设置

首次运行可能遇到"无法打开"提示，需在系统设置 > 隐私与安全中允许应用运行。

2. Docker容器化部署

环境要求

Docker引擎 20.10+ 或 OrbStack（macOS推荐）
官方文档：website/Install/Docker.md

基础启动命令

# 创建数据目录
mkdir -p ./space

# 前台运行（测试用）
docker run -it -p 3000:3000 -v ./space:/space ghcr.io/silverbulletmd/silverbullet

生产环境配置

创建compose.yml文件实现自动更新：

services:
  silverbullet:
    image: ghcr.io/silverbulletmd/silverbullet
    restart: unless-stopped
    environment:
      - SB_USER=admin:your_secure_password
    volumes:
      - ./space:/space
    ports:
      - 3000:3000
  
  # 自动更新容器
  watchtower:
    image: containrrr/watchtower
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock

启动服务：

docker-compose up -d

3. 源码编译安装

编译依赖

Deno 1.35+
Go 1.20+
Node.js 18+

编译步骤

# 1. 克隆仓库
git clone https://gitcode.com/GitHub_Trending/si/silverbullet.git
cd silverbullet

# 2. 安装依赖
deno cache --reload build_client.ts

# 3. 构建客户端
deno run -A build_client.ts

# 4. 编译服务端
go build -o silverbullet ./silverbullet.go

# 5. 启动服务
./silverbullet ./website

开发文档

构建脚本：build_client.ts
服务端源码：server/server.go

服务配置与访问

基础配置项

通过环境变量自定义服务：

# 设置访问端口
SB_PORT=8080 ./silverbullet .

# 启用认证
SB_USER=user:pass ./silverbullet .

客户端访问

本地部署：http://localhost:3000
服务器部署：配置反向代理（推荐Caddy/Nginx）并启用HTTPS
PWA支持：访问后可"安装"到桌面，支持离线使用

升级与维护

二进制升级

./silverbullet upgrade  # 稳定版
# 或
./silverbullet upgrade-edge  # 开发版

Docker升级

docker pull ghcr.io/silverbulletmd/silverbullet
docker-compose up -d

常见问题解决

端口占用

修改映射端口：

docker run -p 8080:3000 -v ./space:/space ghcr.io/silverbulletmd/silverbullet

数据备份

定期备份空间目录：

tar -czf silverbullet-backup.tar.gz ./space

下一步探索

空间配置：website/CONFIG.md
插件开发：website/Plugs/Development.md
高级功能：[website/Space Lua.md](https://gitcode.com/GitHub_Trending/si/silverbullet/blob/e91bec71c0d9088f924c37697bbb729f1339aa22/website/Space Lua.md?utm_source=gitcode_repo_files)

提示：首次使用建议运行内置教程命令 :help 查看交互式指南

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考