nicksherron/bashhub-server

bashhub-server

镜像概述和主要用途

bashhub-server是bashhub-client的私有云替代方案，作为开源服务器，允许用户集中管理和查询shell历史记录，无需将命令发送至第三方服务（如bashhub.com），同时提供正则搜索等增强功能，保护数据隐私且易于部署。

核心功能和特性

• 无缝替代：作为bashhub.com服务器的直接替代品，可与现有bashhub-client和bh命令无缝集成，无需修改客户端配置
• 隐私保护：所有shell历史数据存储在私有服务器，避免发送至第三方，保障数据安全
• 正则搜索：支持通过正则表达式查询shell命令，提升搜索灵活性和精准度
• 便捷连接：只需配置服务器地址/端口，即可快速连接任何客户端
• 高效可靠：使用Go语言开发，性能高效且持续维护

使用场景和适用范围

• 个人用户希望私有管理多设备（如本地计算机、远程服务器）的shell历史记录
• 开发者需要跨系统查询和复用历史命令，提高工作效率
• 对数据隐私有严格要求，不愿将命令历史发送至第三方服务的环境

使用方法和配置说明

安装

Docker

bash
$ docker pull nicksherron/bashhub-server

运行

Docker容器运行

bash
$ docker run -d -p 8080:8080 --name bashhub-server nicksherron/bashhub-server

启动后服务器默认监听http://0.0.0.0:8080

客户端配置

1. 设置环境变量BH_URL指向bashhub-server地址，添加到shell配置文件（如.bashrc或.zshrc）：

bash
# 对于bash用户
echo "export BH_URL=http://localhost:8080" >> ~/.bashrc

# 对于zsh用户
echo "export BH_URL=http://localhost:8080" >> ~/.zshrc

2. 重启shell并重新运行bashhub setup：

bash
$ $SHELL && bashhub setup

数据库配置

默认使用SQLite数据库，支持PostgreSQL作为替代后端。

SQLite

默认数据库路径因操作系统而异：

自定义SQLite数据库路径：

bash
$ docker run -d -p 8080:8080 -v /path/to/local/db:/data \
  --name bashhub-server nicksherron/bashhub-server --db /data/custom.db

PostgreSQL

通过--db参数指定PostgreSQL连接URI：

bash
$ docker run -d -p 8080:8080 --name bashhub-server \
  nicksherron/bashhub-server --db "postgres://user:password@localhost:5432?sslmode=disable"

正则搜索使用

bashhub-server支持通过bashhub-client的bh命令进行正则搜索。

基础搜索（无正则）

bash
$ bh bash
bashhub setup
docker pull nicksherron/bashhub-server
bashhub-server version
bashhub-server --help

正则搜索示例

• 搜索以bash开头的命令：

bash
$ bh '^bash'
bashhub setup
bashhub-server version
bashhub-server --help

• 搜索长度为6个字母的命令：

bash
$ bh "^[a-zA-Z]{6}$"
whoami
ggpush
goland
ggpull

配置参数说明

查看完整帮助：

bash
$ docker run --rm nicksherron/bashhub-server --help