nursecurtis/musicbrainz-search

Musicbrainz Search Server 镜像说明

镜像概述

本镜像提供运行Musicbrainz从服务器的Docker环境，集成搜索功能与数据复制能力，基于Musicbrainz官方Docker配置构建，需至少50GB可用空间存储数据。

核心功能

1. 部署Musicbrainz从服务器
2. 支持数据复制（需Musicbrainz Replication Token）
3. 构建搜索索引以启用网站/API的搜索功能
4. 通过cron任务实现定期数据复制更新

使用场景

1. 搭建私有Musicbrainz搜索服务
2. 本地开发或测试Musicbrainz相关应用
3. 需离线访问Musicbrainz数据的场景

配置说明

基础配置

1. 修改docker-compose.yml中的数据存储路径，指定下载的数据 dump 存储位置
2. 若已有数据 dump，可直接加载无需重新下载

部署步骤

bash
# 克隆仓库
git clone [仓库地址]
cd [仓库目录]

# 启动服务
sudo docker-compose up -d

# 设置Replication Token（需从Musicbrainz获取）
sudo docker exec musicbrainzdocker_musicbrainz_1 /set-token.sh <你的Replication Token>

数据库操作

• 创建数据库并下载最新数据：

  bash
  sudo docker-compose run --rm musicbrainz /createdb.sh -fetch
  

• 使用已有数据创建数据库：

  bash
  sudo docker-compose run --rm musicbrainz /createdb.sh
  

• 重建数据库：

  bash
  sudo docker-compose run --rm musicbrainz /recreatedb.sh
  

构建搜索索引

bash
sudo docker-compose run --rm indexer /home/search/index.sh

复制管理

• 查看复制日志：

  bash
  sudo docker-compose exec musicbrainz /usr/bin/tail -f slave.log
  

• 修改复制频率：编辑musicbrainz-dockerfile/scripts/crons.conf中的cron任务

schema更新

当Musicbrainz schema更新时，需执行以下步骤：

1. 确保复制到旧schema的最新数据包：

   bash
   sudo docker exec musicbrainzdocker_musicbrainz_1 /replication.sh
   

2. 进入容器切换到新分支：

   bash
   sudo docker exec -ti musicbrainzdocker_musicbrainz_1 bash
   git fetch origin && git checkout NEW_SCHEMA_BRANCH
   ./upgrade.sh
   exit
   

3. 更新DBDefs.pm中的DB_SCHEMA_SEQUENCE，然后重建并重启服务：

   bash
   sudo docker-compose stop musicbrainz
   sudo docker-compose build musicbrainz
   sudo docker-compose up -d --no-deps musicbrainz