fan-video

命令

fan-video 本地视频媒体服务器（个人影视库）部署运维

补充说明

本教程介绍 fan-video 从源码编译、发布 GitHub Release 到目标服务器一键安装、卸载、备份、恢复的完整流程，适用于个人项目自建发布链路。

项目：fan-video｜本地视频媒体服务器仓库：https://github.com/meimolihan/fan-video

安装与卸载

安装 / 升级

bash -c "$(curl -sSL https://raw.githubusercontent.com/meimolihan/fan-video/main/scripts/install.sh)"

bash -c "$(curl -sSL https://raw.githubusercontent.com/meimolihan/fan-video/main/scripts/install.sh)" -p 9060 -d /var/lib/fan-video

未指定 -b 且本地无构建产物时，脚本自动从 GitHub Release 下载对应架构（amd64/arm64）二进制；也可用 -b <路径> 指定本地构建产物。

卸载命令

bash scripts/uninstall.sh -y --purge

远程一键卸载

bash -c "$(curl -sSL https://raw.githubusercontent.com/meimolihan/fan-video/main/scripts/uninstall.sh)" -y --purge

备份与恢复

备份数据脚本

bash <(curl -sL https://raw.githubusercontent.com/meimolihan/fan-video/main/scripts/fan-video_backup.sh) "/vol2/1000/file/backup/fan-video-backup" 6

将备份脚本添加到系统定时任务

# 1.下载脚本到 /usr/local/bin/fan-video_backup
curl -fsSL https://raw.githubusercontent.com/meimolihan/fan-video/main/scripts/fan-video_backup.sh -o /usr/local/bin/fan-video_backup

# 2.增加执行权限
chmod +x /usr/local/bin/fan-video_backup

# 3.测试运行一次（目录/保留份数：/vol2/1000/file/backup/fan-video-backup 保留6份）
fan-video_backup /vol2/1000/file/backup/fan-video-backup 6

# 4.追加 crontab(root)：每日凌晨2点30分执行，防重复追加
(crontab -l 2>/dev/null | grep -Fq '/usr/local/bin/fan-video_backup /vol2/1000/file/backup/fan-video-backup 6') || (crontab -l 2>/dev/null; echo '30 2 * * * /usr/local/bin/fan-video_backup /vol2/1000/file/backup/fan-video-backup 6 >> /var/log/fan-video_backup.log 2>&1') | crontab -

# 5.验证定时任务是否写入成功
crontab -l

恢复数据脚本

恢复 /vol2/1000/file/backup/fan-video-backup 目录最新的备份

bash <(curl -sL https://raw.githubusercontent.com/meimolihan/fan-video/main/scripts/fan-video_recover.sh) /vol2/1000/file/backup/fan-video-backup

脚本命令

命令	说明
`bash scripts/install.sh [-p PORT] [-d DATA_DIR] [-b BIN] [-y]`	安装 / 升级为 systemd 服务
`bash scripts/uninstall.sh [-y] [--purge\|--keep-data] [-q]`	卸载 fan-video
`bash scripts/fan-video_backup.sh [目录] [保留份数]`	备份数据目录为 tar.gz（参数顺序可互换）
`bash scripts/fan-video_recover.sh [目录]`	从备份目录恢复最新备份
`/usr/local/bin/fan-video -version`	显示版本信息

日常管理命令

操作	命令
启动	`systemctl start fan-video`
关闭	`systemctl stop fan-video`
重启	`systemctl restart fan-video`
状态	`systemctl status fan-video`
查看实时日志	`journalctl -u fan-video -f`
查看最近 30 行日志	`journalctl -u fan-video -n 30 --no-pager`
关闭开机自启	`systemctl disable fan-video`
端口放行	`firewall-cmd --permanent --add-port=9060/tcp && firewall-cmd --reload`（firewalld）

数据目录说明

默认数据目录：/var/lib/fan-video（含 data/nowen.db、cache/、web-dist/ 等）
安装记录：/etc/fan-video.conf
数据库 / 缓存均可通过环境变量覆盖：NOWEN_APP_DATA_DIR、NOWEN_DATABASE_DB_PATH、NOWEN_CACHE_CACHE_DIR
首次登录：账号 admin，默认密码见启动日志（登录后建议立即修改；登录页会展示默认密码，改密后自动清除）