install-media-deps.sh 5.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121
  1. #!/usr/bin/env bash
  2. # ============================================================================
  3. # 媒体解析依赖安装(仅 Linux):ffmpeg + 中文字体 + Vosk 离线模型。
  4. #
  5. # OCR 不需要本脚本:PP-OCRv4 模型(det/cls/rec)随 rapidocr4j jar 分发,
  6. # OpenCV 原生库也在 openpnp:opencv jar 内,首次使用自动释放到 data/native/。
  7. # 本脚本只解决「音视频转写」的两项外部依赖。
  8. #
  9. # 用法:
  10. # sudo bash deploy/install-media-deps.sh # 小模型(42MB,识别快)
  11. # sudo bash deploy/install-media-deps.sh --model large # 大模型(1.3GB,更准)
  12. # sudo bash deploy/install-media-deps.sh --prefix /opt/zsjz-ai
  13. #
  14. # 幂等:已装包会跳过,模型目录已存在则不再下载。
  15. # 许可证:ffmpeg 用发行版仓库版本(Debian/Ubuntu 为 LGPL 构建);
  16. # 若要换静态包,商用请选 LGPL 变体(BtbN FFmpeg-Builds 的 lgpl 产物)。
  17. # ============================================================================
  18. set -euo pipefail
  19. PREFIX="${ZSJZ_PREFIX:-/opt/zsjz-ai}"
  20. MODEL_SIZE="small"
  21. MODEL_BASE="https://alphacephei.com/vosk/models"
  22. while [[ $# -gt 0 ]]; do
  23. case "$1" in
  24. --model) MODEL_SIZE="${2:-small}"; shift 2 ;;
  25. --prefix) PREFIX="${2:-/opt/zsjz-ai}"; shift 2 ;;
  26. -h|--help) sed -n '2,20p' "$0"; exit 0 ;;
  27. *) echo "未知参数: $1" >&2; exit 2 ;;
  28. esac
  29. done
  30. case "$MODEL_SIZE" in
  31. small) MODEL_ZIP="vosk-model-small-cn-0.22.zip" ;;
  32. large) MODEL_ZIP="vosk-model-cn-0.22.zip" ;;
  33. *) echo "--model 只支持 small / large" >&2; exit 2 ;;
  34. esac
  35. MODEL_DIR="$PREFIX/vosk-model"
  36. log() { printf '\033[1;34m[media-deps]\033[0m %s\n' "$*"; }
  37. warn() { printf '\033[1;33m[media-deps]\033[0m %s\n' "$*" >&2; }
  38. [[ "$(id -u)" -eq 0 ]] || { warn "需要 root(sudo)安装系统包"; exit 1; }
  39. # ---------------------------------------------------------------------------
  40. # 1. glibc 版本:OpenCV 原生库(PP-OCR 依赖)要求 ≥ 2.27
  41. # ---------------------------------------------------------------------------
  42. GLIBC_VER="$(ldd --version 2>/dev/null | head -1 | grep -oE '[0-9]+\.[0-9]+' | head -1 || true)"
  43. if [[ -n "$GLIBC_VER" ]]; then
  44. if printf '%s\n2.27\n' "$GLIBC_VER" | sort -V -C; then
  45. log "glibc $GLIBC_VER OK(PP-OCR 的 OpenCV 原生库要求 ≥ 2.27)"
  46. else
  47. warn "glibc $GLIBC_VER 低于 2.27:图片/扫描件 OCR 无法运行(音视频转写不受影响)"
  48. fi
  49. else
  50. warn "无法检测 glibc 版本,跳过检查(若 OCR 报 UnsatisfiedLinkError,多半是这里)"
  51. fi
  52. # ---------------------------------------------------------------------------
  53. # 2. 安装 ffmpeg 与中文字体
  54. # ---------------------------------------------------------------------------
  55. if command -v ffmpeg >/dev/null 2>&1; then
  56. log "ffmpeg 已安装: $(command -v ffmpeg)"
  57. else
  58. if command -v apt-get >/dev/null 2>&1; then
  59. log "apt-get 安装 ffmpeg + fonts-noto-cjk + unzip"
  60. export DEBIAN_FRONTEND=noninteractive
  61. apt-get update -y
  62. apt-get install -y ffmpeg fonts-noto-cjk unzip curl ca-certificates
  63. elif command -v dnf >/dev/null 2>&1; then
  64. log "dnf 安装 ffmpeg(需要 EPEL/RPM Fusion)+ 中文字体"
  65. dnf install -y ffmpeg google-noto-sans-cjk-fonts unzip curl || {
  66. warn "ffmpeg 安装失败:RHEL 系需要先启用 EPEL 与 RPM Fusion,或改用静态包"
  67. warn " 静态包(商用选 LGPL):https://github.com/BtbN/FFmpeg-Builds/releases"
  68. warn " 解压后把 ffmpeg 放到 $PREFIX/tools/ffmpeg/ffmpeg 并 chmod +x"
  69. }
  70. elif command -v yum >/dev/null 2>&1; then
  71. log "yum 安装(老发行版)"
  72. yum install -y ffmpeg google-noto-sans-cjk-fonts unzip curl || {
  73. warn "ffmpeg 安装失败:请手工安装或改用静态包"
  74. }
  75. else
  76. warn "未识别的包管理器:请手工安装 ffmpeg 与中文字体"
  77. fi
  78. fi
  79. # ---------------------------------------------------------------------------
  80. # 3. Vosk 中文模型(离线,一次下载)
  81. # ---------------------------------------------------------------------------
  82. if [[ -f "$MODEL_DIR/am/final.mdl" ]]; then
  83. log "Vosk 模型已存在: $MODEL_DIR"
  84. else
  85. mkdir -p "$PREFIX"
  86. tmp="$(mktemp -d)"
  87. trap 'rm -rf "$tmp"' EXIT
  88. log "下载 $MODEL_ZIP($( [[ "$MODEL_SIZE" == large ]] && echo '约 1.3GB' || echo '约 42MB' ))"
  89. curl -fL --retry 3 -o "$tmp/model.zip" "$MODEL_BASE/$MODEL_ZIP"
  90. unzip -q "$tmp/model.zip" -d "$tmp"
  91. rm -rf "$MODEL_DIR"
  92. mv "$tmp/${MODEL_ZIP%.zip}" "$MODEL_DIR"
  93. log "模型已解压到 $MODEL_DIR"
  94. fi
  95. # ---------------------------------------------------------------------------
  96. # 4. 验证
  97. # ---------------------------------------------------------------------------
  98. log "验证:"
  99. command -v ffmpeg >/dev/null 2>&1 && ffmpeg -version | head -1 || warn "ffmpeg 不可用"
  100. [[ -d "$MODEL_DIR/am" && -d "$MODEL_DIR/conf" ]] && echo " Vosk 模型结构 OK: $MODEL_DIR" \
  101. || warn "Vosk 模型结构不完整(应含 am/ 与 conf/): $MODEL_DIR"
  102. cat <<EOF
  103. 完成。把下面两项写进部署环境(deploy/env.sh 已有同名变量):
  104. ZSJZ_ASR_FFMPEG_PATH="$(command -v ffmpeg || echo /usr/bin/ffmpeg)"
  105. ZSJZ_ASR_MODEL_PATH="$MODEL_DIR"
  106. 未安装/不想启用音视频转写时,设 ZSJZ_ASR_ENABLED="false",
  107. 音视频上传会直接拒绝,其他文件类型不受影响。
  108. EOF