louislam/its-mytabs

吉他/贝斯谱查看与播放镜像

镜像概述

本镜像提供一个基于Web的自托管吉他/贝斯谱查看器和播放器，功能类似于Songsterr。它允许用户上传、管理、查看和播放吉他或贝斯谱面，支持本地部署，所有数据存储在用户自己的服务器上，无需依赖第三方服务，保障数据隐私和离线可用性。

核心功能与特性

• 多格式支持：兼容主流吉他谱格式，如GP5、GPX、GP、PTB等
• 实时播放：支持谱面同步播放，可调整速度（50%-200%）、音量和乐器音轨
• 自托管部署：数据本地存储，无需云服务，保障隐私和数据安全
• Web界面：直观友好的用户界面，支持跨设备访问（电脑、平板、手机）
• 谱面管理：支持创建歌单、分类管理和搜索功能
• 离线访问：部署后可在无网络环境下使用已加载的谱面

使用场景与适用范围

• 个人音乐练习：查看和播放谱面，辅助吉他/贝斯学习
• 乐队排练：共享谱面资源，同步播放便于合奏练习
• 音乐教学：教师展示谱面并实时演示，学生可跟随练习
• 离线演出准备：存储常用谱面，无网络环境下随时查看

使用方法与配置说明

基本部署（Docker Run）

使用以下命令快速启动容器：

bash
docker run -d \
  --name guitar-tab-player \
  -p 8080:80 \
  -v ./tab-data:/app/data \
  --restart unless-stopped \
  [镜像名称]

参数说明：

• -p 8080:80：将容器内80端口映射到主机8080端口
• -v ./tab-data:/app/data：挂载本地目录./tab-data到容器内数据目录，用于持久化存储谱面文件
• --restart unless-stopped：容器退出时自动重启（除非手动停止）

Docker Compose 配置

创建docker-compose.yml文件：

yaml
version: '3'
services:
  guitar-tab-player:
    image: [镜像名称]
    container_name: guitar-tab-player
    ports:
      - "8080:80"
    volumes:
      - ./tab-data:/app/data
    restart: unless-stopped
    environment:
      - TZ=Asia/Shanghai  # 设置时区
      - MAX_UPLOAD_SIZE=50M  # 设置最大上传文件大小（默认20M）

启动服务：

bash
docker-compose up -d

访问与使用

部署完成后，通过浏览器访问 http://localhost:8080 进入应用界面：

1. 点击"上传"按钮添加谱面文件
2. 在"我的谱库"中选择谱面进行查看和播放
3. 使用播放控制栏调整速度、音量和音轨

环境变量配置

启用认证示例：

bash
docker run -d \
  --name guitar-tab-player \
  -p 8080:80 \
  -v ./tab-data:/app/data \
  -e AUTH_ENABLED=true \
  -e AUTH_USER=myuser \
  -e AUTH_PASSWORD=mypassword \
  --restart unless-stopped \
  [镜像名称]