补充说明
本教程介绍 fan-video-ct 从源码编译、发布 GitHub Release 到目标服务器一键安装、卸载的完整流程，适用于个人项目自建发布链路。
项目：fan-video-ct｜本地视频剪切工具（基于 FFmpeg，无账号密码的内网工具） 仓库：https://github.com/meimolihan/fan-video-ct
安装与卸载
安装 / 升级
bash -c "$(curl -sSL https://raw.githubusercontent.com/meimolihan/fan-video-ct/main/scripts/install.sh)"
- 静默安装 / 升级（指定端口与安装目录、视频浏览目录）
bash -c "$(curl -sSL https://raw.githubusercontent.com/meimolihan/fan-video-ct/main/scripts/install.sh)" -p 8788 -d /var/lib/fan-video-ct -s /vol2/1000/downloads/fan-video-ct -y
- 未指定
-b且本地无构建产物时，脚本自动从 GitHub Release 下载对应架构（amd64/arm64）二进制；也可用-b <路径>指定本地构建产物。 - 升级直接重跑安装脚本：自动拉取 latest 覆盖二进制，systemd 自动重启，数据目录保留。
卸载命令
bash scripts/uninstall.sh -y --purge
- 远程一键卸载
bash -c "$(curl -sSL https://raw.githubusercontent.com/meimolihan/fan-video-ct/main/scripts/uninstall.sh)" -y --purge
- 数据目录默认保留；
--purge或交互确认后才会清除（不可恢复）。
数据备份
fan-video-ct 暂未提供专门的备份脚本，数据目录整体拷贝即可：
# 停止服务后备份 /var/lib/fan-video-ct/data（封面、剪切输出、片头片尾预设、日志）
sudo systemctl stop fan-video-ct
sudo cp -a /var/lib/fan-video-ct/data /vol2/1000/file/backup/fan-video-ct-data
sudo systemctl start fan-video-ct
脚本命令
| 命令 | 说明 |
|---|---|
bash scripts/install.sh [-p PORT] [-d INSTALL_DIR] [-s VIDEO_DIR] [-b BIN] [-y] |
安装 / 升级为 systemd 服务 |
bash scripts/uninstall.sh [-y] [--purge] |
卸载 fan-video-ct |
/var/lib/fan-video-ct/fan-video-ct --version |
显示版本信息 |
日常管理命令
| 操作 | 命令 |
|---|---|
| 启动 | systemctl start fan-video-ct |
| 关闭 | systemctl stop fan-video-ct |
| 重启 | systemctl restart fan-video-ct |
| 状态 | systemctl status fan-video-ct |
| 查看实时日志 | journalctl -u fan-video-ct -f |
| 查看最近 30 行日志 | journalctl -u fan-video-ct -n 30 --no-pager |
| 关闭开机自启 | systemctl disable fan-video-ct |
| 端口放行 | firewall-cmd --permanent --add-port=8788/tcp && firewall-cmd --reload（firewalld） |
数据目录说明
- 默认安装目录：
/var/lib/fan-video-ct（二进制fan-video-ct） - 数据目录：
/var/lib/fan-video-ct/data（含covers/、output/剪切输出、presets.json片头片尾预设、fan-video-ct.log） - 安装记录：
/etc/fan-video-ct.conf - 配置加载优先级（低 -> 高）：内置默认值 →
config.yaml（当前目录 /./data//etc/fan-video-ct）→ 环境变量（FCT_前缀） - 常用环境变量：
FCT_APP_PORT、FCT_APP_DATA_DIR、FCT_APP_MEDIA_DIR（文件浏览器根目录）、FCT_APP_OUTPUT_DIR、FCT_APP_WORKER（剪切并发数） - 无账号密码（内网工具），请勿暴露到公网