Bluecherry .deb 裸机部署实战

Bluecherry 3.1.14 .deb 裸机部署实战：官方引导脚本与手动 APT 源两种安装方案、systemd 服务托管、Web 界面初始化与改密、ffmpeg 合成 RTSP 流接入与持续录像验证、存储布局与持久化说明，含 sudo 缺失/postinst 顺序等真实排障实录。

BluecherryBluecherry视频监控2026/10/28

Bluecherry .deb 裸机部署实战

目标：在 Ubuntu 22.04 服务器上以官方 .deb 包形态从 0 到 1 完成 Bluecherry 3.1.14 NVR 的部署：官方引导脚本/手动 APT 源两种安装方案、systemd 服务托管、Web 管理界面初始化、RTSP 摄像头接入（ffmpeg 合成测试流）、持续录像验证与数据持久化说明，并在排障实录中沉淀安装过程的真实踩坑。已在本机隔离环境中模拟裸机安装实测通过（环境说明见「一、环境信息」，正文所有命令均按裸机服务器视角给出）。

一、环境信息

项目内容
操作系统Ubuntu 22.04.5 LTS (Jammy)（隔离环境模拟裸机，systemd 完整运行）
软件版本Bluecherry 3.1.14（官方包版本号 3:3.1.14，2025-08-31 发布的最新稳定版）
安装形态官方 .deb 包（APT 仓库 http://dl.bluecherrydvr.com）
内核架构amd64
组件bc-server（C++ 录像核心）+ nginx + PHP 7.4 + MySQL 8.0 + rrdtool
实测日期2026-10-28
宿主资源4 核 / 20GB 内存 / NVMe 磁盘（磁盘已用约 41% 时安装）

说明：本篇在隔离环境中模拟裸机安装——这是一台完整运行 systemd 的 Ubuntu 22.04 环境，apt/systemd/日志行为与物理机、云主机一致；与真实裸机的唯一差异是无摄像头硬件，因此「八、RTSP 摄像头接入实测」用 ffmpeg 合成 RTSP 流充当虚拟摄像头（无硬件验证 NVR 的标准做法）。

二、前置条件

  1. 受支持的发行版：Ubuntu 20.04/22.04/24.04、Debian 11/12（官方引导脚本额外支持 Mint 21.1~22.1）；
  2. root 或 sudo 权限：安装脚本与包配置均需 root；
  3. 基础工具：curl/wget/gpg/sudo（最小化系统常见缺失，见排障实录 13.1）；
  4. 网络：能访问 dl.bluecherrydvr.com（官方包源）与 ppa.launchpadcontent.net（Ubuntu 22.04 需 ondrej/php PPA 提供 PHP 7.4）；国外源慢时走代理（本实测直连可用，未降级）；
  5. 资源规划：
    • CPU：移动侦测为软件实现，建议每 4~8 路 720p 预留 1 核起步；
    • 内存：服务端基线很小（本实测安装后四服务合计数百 MB 级），预留 2GB 起步；
    • 磁盘：录像目录是主要消耗，按「码率 × 路数 × 保留天数」估算（640×480@15fps 的 H.264 测试流实测约 1.4 Mbps/路，全天约 14GB/路——真实摄像头按其码率计算）；
  6. 端口规划：7001（HTTPS Web）、7002（RTSP 转发流）为默认端口，需未被占用。
  7. 摄像头硬件前置（生产）：RTSP/ONVIF 网络摄像头的 IP、端口、RTSP 路径、认证账号；本篇用 ffmpeg 合成流替代。

三、版本选型说明

  1. 版本实查：官方 APT 源当前最新稳定版为 3:3.1.14（apt-cache 实查，同源还有上一版 3:3.1.13 可回退）：
apt-cache policy bluecherry

实测回显（安装后采集）：

bluecherry:
  Installed: 3:3.1.14
  Candidate: 3:3.1.14
  Version table:
 *** 3:3.1.14 500
        500 http://dl.bluecherrydvr.com jammy/main amd64 Packages
        100 /var/lib/dpkg/status
     3:3.1.13 500
  1. 为什么选 .deb 裸机形态：官方主推的两种服务端形态是 .deb（APT 仓库）与 Docker Compose 脚本。裸机 .deb 形态的录像核心 bc-server 以 systemd 服务运行、录像直接落本地文件系统，存储与备份路径清晰，适合把 NVR 当作一台"录像服务器"长期运维；Compose 形态适合容器化环境统一编排。本篇以 .deb + systemd 为主线。
  2. 版本纪律：3.1.14 已移除授权系统（官方公告原文 "License system has been removed - this is now a free and open source release"），设备数量不受限，无需许可证操作。

四、方案 A：官方引导脚本安装（推荐）

4.1 方案说明

官方提供一键引导脚本（官网下载页的 "Terminal Quick Install"），按发行版自动执行：安装基础依赖 → 导入官方签名密钥 → 写入 APT 源 →（Ubuntu 22.04 额外启用 ondrej/php PPA 并安装 PHP 7.4 组件）→ 安装 bluecherry 包 → 重启服务。适合全新标准系统一次到位。

4.2 获取并执行脚本

# 下载官方引导脚本（务必加 -L 跟随重定向，见排障实录 13.2）
curl -sL https://install.bluecherrydvr.com/packages -o /root/packages.sh
wc -c /root/packages.sh        # 确认非空，实测 6205 字节

export DEBIAN_FRONTEND=noninteractive
bash /root/packages.sh 2>&1 | tee /root/install.log

实测回显（关键节选，完整日志较长）：

Distro: jammy
Get:3 https://dl.bluecherrydvr.com jammy InRelease [4636 B]
Get:8 https://dl.bluecherrydvr.com jammy/main all Packages [482 B]
Get:9 https://dl.bluecherrydvr.com jammy/main amd64 Packages [13.7 kB]
Get:20 https://ppa.launchpadcontent.net/ondrej/php/ubuntu jammy/main amd64 php8.4-mysql amd64 8.4.27-1+ubuntu22.04.1+deb.sury.org+1 [134 kB]
Get:34 https://ppa.launchpadcontent.net/ondrej/php/ubuntu jammy/main amd64 php7.4-mysql amd64 1:7.4.33-31+ubuntu22.04.1+deb.sury.org+1 [137 kB]
（中略：数十个依赖包解包与配置，mysql-server-8.0、nginx、rrdtool 等随之装入）

4.3 安装结果核验

dpkg -l bluecherry | tail -1

实测回显：

ii  bluecherry     3:3.1.14     amd64        Bluecherry DVR Server

包内落位的关键文件（dpkg -L bluecherry 节选归纳）：

路径用途
/usr/sbin/bc-server录像核心守护进程（systemd 主进程）
/etc/bluecherry.conf服务端配置（数据库连接等，libconfig 格式）
/lib/systemd/system/bluecherry.servicesystemd 服务单元
/usr/share/bluecherry/www/Web 管理界面 PHP 代码（nginx 站点根）
/usr/share/bluecherry/schema_mysql.sql数据库建表脚本（24 张表）
/usr/share/bluecherry/backup_db.sh、bc_db_tool.sh、load_db_creds.sh运维脚本（备份/数据库工具/凭据加载）
/usr/lib/bluecherry/内置 libav 编译产物（libavcodec.so.60 等）与 ffmpeg/ffprobe、onvif_tool
/etc/nginx/sites-enabled/bluecherry.confnginx 站点（HTTPS 7001）

4.4 服务托管与启动

bluecherry.service 单元定义（实测内容）：

[Unit]
Description=Bluecherry DVR Server
After=syslog.target network.target mysql.service

[Service]
Type=simple
User=bluecherry
Group=bluecherry
ExecStart=/usr/sbin/bc-server -s
Restart=on-failure
TimeoutStopSec=30

[Install]
WantedBy=multi-user.target

安装成功后该单元已被 enable（Created symlink /etc/systemd/system/multi-user.target.wants/bluecherry.service → /lib/systemd/system/bluecherry.service）。启动全套服务：

systemctl start mysql php7.4-fpm nginx bluecherry
systemctl is-active mysql php7.4-fpm nginx bluecherry

实测回显：

active
active
active
active

端口监听核验：

ss -ltnp | grep -E "7001|7002|3306"

实测回显（进程名已标注）：

LISTEN 0      511          0.0.0.0:7001       0.0.0.0:*    users:(("nginx",pid=20656,fd=8),...)
LISTEN 0      10                 *:7002             *:*    users:(("MAIN",pid=20710,fd=9))
LISTEN 0      151                *:3306             *:*    users:(("mysqld",pid=20294,fd=23))

五、方案 B：手动配置官方 APT 仓库安装（分步）

5.1 方案说明

与方案 A 等效，但把引导脚本做的事拆开逐条执行。适合需要审计每一步、或内网代理出口只放行白名单域名的场景。以下为 Ubuntu 22.04 (jammy) 的完整手动步骤。

5.2 安装依赖与导入签名密钥

apt-get update
apt-get install -y gpg wget sudo software-properties-common

# 官方签名密钥写入 trusted.gpg.d（与引导脚本行为一致）
wget -q https://dl.bluecherrydvr.com/key/bluecherry.asc -O /etc/apt/trusted.gpg.d/bluecherry.asc

5.3 写入官方源与 PHP 源

官方源文件内容（引导脚本从 https://dl.bluecherrydvr.com/sources.list.d/bluecherry-jammy.list 下载，实测内容为）：

cat > /etc/apt/sources.list.d/bluecherry-jammy.list <<'EOF'
# Please post any problems to http://forums.bluecherrydvr.com or ubuntu@bluecherrydvr.com
deb http://dl.bluecherrydvr.com jammy main # Bluecherry Ubuntu 22.04 LTS packages
EOF

# Ubuntu 22.04 需 ondrej/php 提供 PHP 7.4（官方脚本以 [trusted=yes] 写入）
echo "deb [trusted=yes] https://ppa.launchpadcontent.net/ondrej/php/ubuntu/ jammy main" \
  > /etc/apt/sources.list.d/ondrej-ubuntu-php-jammy.list

5.4 安装 PHP 组件与 bluecherry 包

apt-get update
apt-get install -y php7.4-fpm php7.4-sqlite3 php7.4-curl php7.4-mysql php7.4-gd \
                   php-mail php-mail-mime php-mysql
apt-get install -y bluecherry

bluecherry 包会自动把 mysql-server、nginx、rrdtool 等作为依赖装入。安装完成后回到 4.4 节启动服务即可。

⚠️ 若 dpkg -l bluecherry 状态为 iF（未配置完成），说明包配置阶段数据库/PHP-FPM 未就绪，按排障实录 13.3 处理后重跑 dpkg --configure -a。

5.5 两方案对比与选择建议

维度方案 A：引导脚本方案 B：手动 APT
步骤数1 条命令5 小节
是否需联网是（官方源 + PPA）是（同左，可逐域名放行）
过程可见性黑盒（日志长）每步可审计
适用场景全新标准系统快速交付审计要求 / 代理白名单 / 需改源地址
服务名bluecherry（systemd）同左
结果一致性完全一致（脚本即上述手动步骤的封装）—

建议：标准环境用方案 A；生产变更管控严格的环境用方案 B 留痕。

六、安装后初始化（Web 管理界面）

6.1 首次访问

Web 界面是 HTTPS（nginx listen 7001 ssl），用 HTTP 访问会得到 400：

curl -sI http://127.0.0.1:7001/ | head -3

实测回显：

HTTP/1.1 400 Bad Request
Server: nginx/1.18.0 (Ubuntu)

改用 HTTPS（自签名证书，浏览器需信任；curl 加 -k）：

curl -skI https://127.0.0.1:7001/ | head -3
curl -sk -o /dev/null -w "%{http_code} %{redirect_url}\n" https://127.0.0.1:7001/

实测回显：

HTTP/1.1 302 Found
Server: nginx/1.18.0 (Ubuntu)
302 https://127.0.0.1:7001/login

浏览器打开 https://<服务器IP>:7001，自动跳转登录页（页面标题 Bluecherry DVR :: Administration）。

6.2 默认账号与改密

默认管理员：用户名 Admin（注意大写 A），密码 bluecherry。登录后立即修改密码（本专栏统一示例口令 q1w2e3r4）。可用界面右上角个人资料页修改，等效接口实测：

# 登录拿会话
curl -sk -c /tmp/bc.cookie -d "login=Admin&password=bluecherry" https://127.0.0.1:7001/login -o /dev/null
# 修改密码
curl -sk -b /tmp/bc.cookie -d "password_current=bluecherry&password_new=q1w2e3r4" \
     https://127.0.0.1:7001/ajax/profile.php

实测回显：

{"status":6,"msg":["Changes successfully saved"],"data":""}

密码在数据库中以 md5(明文 + salt) 存储（Users 表含独立 salt 字段），改密后用新密码重新登录验证。

6.3 证书说明

默认启用 Ubuntu 自带的 snakeoil 自签名证书（nginx 站点 include snakeoil.conf → /etc/ssl/certs/ssl-cert-snakeoil.pem）。生产环境替换方法：将正式证书放到服务器上，编辑 /etc/nginx/sites-enabled/bluecherry.conf 中两行 ssl_certificate 指向正式证书后 systemctl reload nginx。包内 /usr/share/bluecherry/ssl/ 还提供了 bluecherry 自带的 snakeoil 证书对备用。

七、配置检查（安装视角）

安装阶段只需确认数据库连接配置。/etc/bluecherry.conf 实测全文（19 行，libconfig 格式，参数级详解见本专栏《Bluecherry 配置参数详解》）：

# Bluecherry configuration file

# Used to be sure we don't use configurations not suitable for us
version = "1.0";

bluecherry:
{
  db:
  {
    # 0 = sqlite, 1 = pgsql, 2 = mysql
    type = 2;
    dbname = "bluecherry";
    user = "bluecherry";
    password = "bluecherry";
    host = "localhost";
    userhost = "localhost";
  };
};

要点：包安装时已自动创建 MySQL 库 bluecherry 与同名账号（密码 bluecherry），type = 2 即 MySQL。该文件同时是 bc-server 与 Web 端的数据库凭据来源（运维脚本 load_db_creds.sh 也从这里解析）。参数级详解见本专栏《Bluecherry 配置参数详解》。

数据库初始化核验：

mysql -uroot -p bluecherry -e "show tables;" 2>/dev/null | wc -l
mysql -uroot -p bluecherry -e "select id,username,name from Users;" 2>/dev/null

实测回显：

25
1	Admin	Bluecherry Admin

（25 行 = 24 张表 + 表头；Users 表初始仅一个 Admin 账号。）

八、RTSP 摄像头接入实测（ffmpeg 合成流）

本章解决"没有摄像头如何验证 NVR"：用 ffmpeg 合成一路标准 RTSP 流充当虚拟摄像头（生产环境把本章的"合成流"换成真实摄像头的 rtsp://摄像头IP:554/路径 即可，操作完全一致）。

8.1 搭建 RTSP 流源

需要两件工具：一个 RTSP 服务器（接收推流并供拉流）+ ffmpeg（合成测试画面）。以轻量的 mediamtx 为例（单文件二进制）：

# 安装 ffmpeg（Ubuntu 22.04 官方源）
apt-get install -y ffmpeg
ffmpeg -version | head -1

实测回显：

ffmpeg version 4.4.2-0ubuntu0.22.04.1 Copyright (c) 2000-2021 the FFmpeg developers

mediamtx 最小配置 /etc/mediamtx/mediamtx.yml：

paths:
  cam1:

启动流源并推流：

# 启动 RTSP 服务器（8554 端口）
mediamtx /etc/mediamtx/mediamtx.yml > /var/log/mediamtx.log 2>&1 &

# ffmpeg 合成测试画面推流（640x480@15fps H.264 + 440Hz 音频）
nohup ffmpeg -re -f lavfi -i "testsrc=size=640x480:rate=15" \
  -f lavfi -i "sine=frequency=440:sample_rate=44100" \
  -c:v libx264 -preset ultrafast -tune zerolatency -g 30 -pix_fmt yuv420p \
  -c:a aac -b:a 64k -f rtsp -rtsp_transport tcp rtsp://127.0.0.1:8554/cam1 \
  > /var/log/ffmpeg-cam1.log 2>&1 &

拉流自检：

ffprobe -v error -show_entries stream=codec_name,width,height,avg_frame_rate \
        -of csv=p=0 rtsp://127.0.0.1:8554/cam1

实测回显：

h264,640,480,15/1
aac,0/0

8.2 在 Bluecherry 中添加摄像头

Web 界面路径：管理后台 → Devices → Add IP camera，填写：Manufacturer/Model 选 Generic，Name LabCam，IP 127.0.0.1，Port 8554，RTSP path /cam1，Protocol IP-RTSP，勾选 TCP 传输。等效接口调用（已登录会话）：

curl -sk -b /tmp/bc.cookie \
  -d "protocol=IP-RTSP&camName=LabCam&ipAddr=127.0.0.1&port=8554&rtsp=/cam1&user=&pass=&prefertcp=1&models=Generic&onvif_port=80&hls_window_size=5" \
  https://127.0.0.1:7001/ajax/addip.php

实测回显：

{"status":6,"msg":["IP camera has been successfully added"],"data":""}

数据库侧核验（Devices 表，device 列为 主机|端口|路径 复合格式）：

mysql -uroot -p bluecherry -e "select id,device_name,protocol,device,disabled from Devices\G" 2>/dev/null

实测回显：

               id: 1
      device_name: LabCam
         protocol: IP-RTSP
           device: 127.0.0.1|8554|/cam1
         disabled: 0

8.3 确认拉流与开始录像

bc-server 每 5 秒轮询设备表，自动接入新摄像头（无需重启）：

journalctl -u bluecherry --no-pager --since "2 min ago" | grep LabCam | head -8

实测回显：

I(1/LabCam): Setting up device
I(1/LabCam): Stream started: h264, 1/90000(s) 1/90000(c); aac
I(1/LabCam): Device 1: Starting schedule transition to 'continuous'
I(1/LabCam): Device 1: Successfully completed schedule transition to 'continuous'
W(1/LabCam): Likely timestamping error. Ignoring.
I(1/LabCam): Audio stream configured: aac, 44100 Hz, 1 channels

日志读法：Stream started 说明拉流成功（h264 视频 + aac 音频）；新设备默认计划即 continuous（7×24 持续录像）；timestamping error 是合成流时间戳的常见警告，可忽略（真实摄像头偶尔也会输出该警告，不影响录像）。

8.4 直播流验证（7002 转发流）

bc-server 在 7002 端口把摄像头流重分发，URL 为 rtsp://<用户>:<密码>@<主机>:7002/live/<设备ID>（需 Web 账号认证，直连会 401）：

timeout 8 ffprobe -v error -show_entries stream=codec_name,width,height \
          -of csv=p=0 rtsp://Admin:q1w2e3r4@127.0.0.1:7002/live/1

实测回显：

h264,640,480
aac

九、录像验证与存储布局

9.1 录像文件落盘

持续录像数分钟后核验：

find /var/lib/bluecherry/recordings -type f | head -4

实测回显：

/var/lib/bluecherry/recordings/2026/10/28/000001/09-19-43.mp4
/var/lib/bluecherry/recordings/2026/10/28/000001/09-19-43.jpg

存储布局规则：<存储根>/<年>/<月>/<日>/<6位设备ID>/<HH-MM-SS>.mp4，同名 .jpg 为该录像段起始帧缩略图。默认单文件 900 秒（G_MAX_RECORD_TIME）轮转新文件。

9.2 事件与媒体索引

录像在数据库中同步登记（EventsCam 事件表 + Media 媒体索引表）：

mysql -uroot -p bluecherry -e "select id,device_id,type_id,from_unixtime(time) as t,media_id from EventsCam\G select id,device_id,filepath,from_unixtime(start) as start from Media\G" 2>/dev/null

实测回显：

      id: 1
device_id: 1
  type_id: continuous
        t: 2026-10-28 09:19:43
 media_id: 1
      id: 1
device_id: 1
  filepath: /var/lib/bluecherry/recordings/2026/10/28/000001/09-19-43.mp4
     start: 2026-10-28 09:19:43

9.3 存储水位自检

bc-server 每 5 分钟自检存储水位（阈值来自 Storage 表，默认 95%/90%）：

I(): Storage path /var/lib/bluecherry/recordings below threshold: 41.3% <= 95.0%

十、数据持久化说明

数据路径说明
录像文件/var/lib/bluecherry/recordings/最大头，按日期分层
元数据库/var/lib/mysql/bluecherry/实测约 3.1MB 起步（随事件数增长）
服务端配置/etc/bluecherry.conf数据库连接等
nginx 站点/etc/nginx/sites-enabled/bluecherry.confWeb 入口与证书
服务日志/var/log/bluecherry.logbc-server 日志（syslog 格式）
rrd 监控数据/var/lib/bluecherry/monitor.rrd系统监控图表数据

备份组合拳：MySQL 逻辑备份（元数据）+ 录像目录归档，两者必须同时间点配对备份才有完整恢复力（详见本专栏《Bluecherry 常用命令与运维实战（核心篇）》）。

十一、常见运维命令

systemctl status bluecherry            # 服务状态
systemctl restart bluecherry           # 重启录像核心（Web/nginx 不受影响需单独管理）
journalctl -u bluecherry -f            # 跟踪 bc-server 日志
tail -f /var/log/bluecherry.log        # 同上（文件视图）
ss -ltnp | grep -E "7001|7002"         # 端口核验
mysql -uroot -p bluecherry -e "select * from Storage"   # 存储路径与水位阈值

十二、等价安装形态说明（官方 Docker Compose 路径）

官方为容器化环境提供 Compose 引导脚本（curl -s https://install.bluecherrydvr.com/docker | sudo bash，配套 MariaDB 与持久化录像卷，源码仓库 bluecherrydvr/bluecherry-docker）。与本章 .deb 形态的取舍：

维度.deb 裸机（本篇）Docker Compose
运行主体systemd 原生服务容器编排栈
录像存储本地目录直写挂载卷
升级apt 升级换镜像标签
适合环境专用录像服务器（推荐）已全面容器化的事实标准

两者数据库/录像格式一致，互迁成本主要在存储路径映射。

十三、常见问题（FAQ，含排障实录）

Q1：引导脚本报 sudo: command not found，EXIT=127？ 实录：在最小化系统（无 sudo 的精简镜像）上执行官方脚本，脚本第 37 行 wget ... | sudo tee /etc/apt/trusted.gpg.d/bluecherry.asc 失败退出。修复：先装 sudo 再重跑脚本。

apt-get install -y sudo
bash /root/packages.sh

（标准 Ubuntu Server 自带 sudo，通常不会遇到；云厂商最小镜像与裁剪系统会遇到。）

Q2：curl 下载引导脚本得到 0 字节文件？ 实录：curl -s https://install.bluecherrydvr.com/packages -o /root/packages.sh 下载结果 wc -c 为 0，脚本执行 EXIT=0 静默无输出——该域名 301/302 重定向后才是正文，未加 -L 只拿到重定向响应体（空）。修复：curl -sL 重新下载并用 wc -c 确认字节数（实测 6205）。这是"安装脚本静默失败"类问题的典型第一排查点。

Q3：包安装后状态 iF，postinst 报数据库错误？ 实录：dpkg -l bluecherry 显示 iF，dpkg --configure -a 报 installed bluecherry package post-installation script subprocess returned error exit status 1。日志显示 postinst 写入 /root/.my.cnf（root/pass）后连不上 MySQL——mysql-server 依赖已装但服务未启动（精简/隔离系统上启动顺序偶尔与桌面/标准服务器不同）。修复：

systemctl start mysql
dpkg --configure -a

Q4：重配置时报 alternative path /run/php/php*.*-fpm.sock doesn't exist？ 实录：postinst 用 update-alternatives 归一化 PHP-FPM socket，但 php7.4-fpm 未运行导致 /run/php/ 下无 socket 文件，报 exit status 2。修复：

systemctl start php7.4-fpm
dpkg --configure -a

Q5：HTTP 访问 7001 返回 400？ 正常现象：站点只监听 HTTPS（listen 7001 ssl）。用 https:// 访问即可。

Q6：登录用户名 admin 报错？ 默认账号是 Admin（首字母大写）、密码 bluecherry。数据库 Users 表实查 username='Admin'。登录后立即改密。

Q7：国内网络拉取官方源/PPA 慢？ 实测当日 dl.bluecherrydvr.com 与 ppa.launchpadcontent.net 直连可用。若你的网络环境慢：apt 走代理（/etc/apt/apt.conf.d/proxy.conf 配 Acquire::http::Proxy）或用国内镜像加速 Ubuntu 官方源部分，Bluecherry 专属源无国内镜像、只能代理或手动下载 .deb。

Q8：bc-server 日志里大量 Likely timestamping error. Ignoring.？ 合成流（ffmpeg testsrc）或个别摄像头时间戳不规范的常见警告，bc-server 自动忽略，不影响录像与回放；真实摄像头若频繁出现建议检查其 NTP 与编码参数。

十四、卸载与清理

# 停服务并卸载包（保留数据）
systemctl stop bluecherry nginx
apt-get purge -y bluecherry
apt-get autoremove -y

# 彻底清理数据（可选，不可逆）
rm -rf /var/lib/bluecherry            # 录像与 rrd 数据
mysql -uroot -p -e "drop database bluecherry; drop user 'bluecherry'@'localhost';"
rm -f /etc/bluecherry.conf /etc/nginx/sites-enabled/bluecherry.conf \
      /etc/apt/sources.list.d/bluecherry-jammy.list \
      /etc/apt/sources.list.d/ondrej-ubuntu-php-jammy.list \
      /etc/apt/trusted.gpg.d/bluecherry.asc
apt-get update

包内还提供了 remove_all_data.sh（重置数据库数据）等清理脚本，运维篇有详细用法。

十五、参考链接

  1. 官网下载页（引导脚本入口）：https://www.bluecherrydvr.com
  2. 官方安装引导脚本（本篇方案 A）：https://install.bluecherrydvr.com/packages
  3. 服务端源码仓库（安装说明/构建）：https://github.com/bluecherrydvr/bluecherry-apps
  4. 服务端 3.1.14 发布公告：https://forums.bluecherrydvr.com/t/server-release-3-1-14/1050
  5. 官方论坛安装板块：https://forums.bluecherrydvr.com
  6. 站内后续阅读：《Bluecherry 配置参数详解》、《Bluecherry 常用命令与运维实战（核心篇）》