DouyinLiveRecorder配置文件全解析：打造个性化录制方案

DouyinLiveRecorder配置文件全解析：打造个性化录制方案

【免费下载链接】DouyinLiveRecorder 项目地址: https://gitcode.com/gh_mirrors/do/DouyinLiveRecorder

一、配置系统架构概览

DouyinLiveRecorder采用双配置文件架构，通过功能分离设计实现精细化控制。config.ini作为核心配置中枢，管理录制行为、推送策略和账号认证；URL_config.ini专注于直播源地址管理。这种分离架构既保证了核心配置的稳定性，又为直播平台适配提供了灵活扩展能力。

二、核心配置文件详解（config.ini）

2.1 [录制设置]：控制录制行为的核心参数

参数名称	取值范围	默认值	关键作用	高级配置建议
language(zh_cn/en)	zh_cn/en	zh_cn	界面与日志语言	国际用户建议设为en
直播保存路径	绝对路径	./recordings	存储根目录	建议设置独立分区避免空间不足
保存文件夹是否以作者区分	是/否	是	按主播ID组织文件	多主播监控必选
视频保存格式	ts/mkv/flv/mp4/mp3/m4a	ts	容器格式选择	长期存储建议mp4，实时备份选ts
原画|超清|高清|标清|流畅	清晰度等级	原画	码率控制	带宽有限时选高清，存储有限选标清
是否使用网络加速	是/否	是	网络访问策略	海外平台必须启用
同一时间访问网络的线程数	1-10	3	并发控制	高性能服务器可设5-7
视频分段时间(秒)	300-3600	1800	切片长度	重要直播建议300秒便于恢复
录制完成后自动转为mp4格式	是/否	是	格式转换	需要编辑时建议开启

关键配置示例：

[录制设置]
language(zh_cn/en) = zh_cn
直播保存路径(不填则默认) = /data/live_recordings
保存文件夹是否以作者区分 = 是
视频保存格式ts|mkv|flv|mp4|mp3音频|m4a音频 = ts
原画|超清|高清|标清|流畅 = 超清
同一时间访问网络的线程数 = 5
视频分段时间(秒) = 600
录制完成后自动转为mp4格式 = 是
mp4格式重新编码为h264 = 是

注意事项：

• 分段录制开启时，建议同时启用"录制完成后自动转为mp4格式"确保文件完整性
• 原画设置需至少20Mbps稳定带宽，否则建议选择超清
• 线程数超过5可能触发平台反爬机制，需配合网络加速轮换使用

2.2 [推送配置]：实时通知与事件触发系统

此模块控制直播状态变更时的通知机制，支持多渠道同时推送：

核心推送参数配置：

[推送配置]
直播状态推送渠道 = 钉钉,微信,bark
钉钉推送接口链接 = https://oapi.dingtalk.com/robot/send?access_token=XXX
微信推送接口链接 = https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=XXX
bark推送接口链接 = https://api.day.app/XXX/
直播推送检测频率(秒) = 1800
开播推送开启(是/否) = 是
关播推送开启(是/否)= 否

高级推送策略：

• 重要主播设置多渠道推送，普通主播单一渠道
• 开播推送设为立即触发，关播推送延迟30秒避免误报
• 存储空间不足预警建议使用最高优先级推送（bark推送中断级别设为timeSensitive）

2.3 [Cookie]：平台认证的核心凭证

Cookie配置是录制功能的关键授权机制，不同平台有不同的获取方式：

[Cookie]
抖音cookie = ttwid=1%7CB1qls3GdnZhUov9o2NxOMxxYS2ff6OSvEWbv0ytbES4%7C1680522049%7C280d802d6d478e3e78d0c807f7c487e7ffec0ae4e5fdd6a0fe74c3c6af149511; ...
快手cookie = 
海外平台_cookie = 
虎牙cookie = 

Cookie获取与维护指南：

1. 抖音Cookie获取：

   • 访问https://live.douyin.com
   • F12打开开发者工具→Application→Storage→Cookies
   • 复制ttwid、odin_tt、__ac_signature等关键参数

2. 有效期管理：

   • 普通用户Cookie有效期约7-15天
   • 登录状态下定期重启程序可自动刷新Cookie
   • 企业号Cookie有效期可达90天，建议优先使用

⚠️ 安全警告：Cookie包含账号认证信息，请勿分享配置文件或截图展示完整Cookie内容

2.4 [Authorization]与[账号密码]：高级认证机制

针对需要强认证的平台，提供token和账号密码两种备选方案：

[Authorization]
popkontv_token = eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

[账号密码]
sooplive账号 = user@example.com
sooplive密码 = encrypted_password
twitcasting账号类型 = normal

安全最佳实践：

• 避免明文存储密码，可配合环境变量使用
• 重要账号启用双因素认证
• 定期轮换token（建议30天一次）

三、URL配置文件（URL_config.ini）

虽然当前版本URL_config.ini为空，但该文件设计用于管理：

• 平台API端点的区域分流
• CDN加速节点选择
• 备用域名配置
• 自定义API路由规则

建议初始配置：

[国内平台]
douyin_api = https://webcast.amemv.com
kuaishou_api = https://live.kuaishou.com

[海外平台]
tiktok_api = https://webcast.tiktok.com
twitch_api = https://api.twitch.tv/helix

[区域路由]
asia = douyin_api, kuaishou_api
north_america = tiktok_api, twitch_api

四、场景化配置方案

4.1 多主播监控场景（媒体工作室适用）

[录制设置]
保存文件夹是否以作者区分 = 是
保存文件夹是否以时间区分 = 是
同一时间访问网络的线程数 = 5
循环时间(秒) = 180
视频分段时间(秒) = 300

[推送配置]
直播状态推送渠道 = 钉钉,企业微信
开播推送开启(是/否) = 是
关播推送开启(是/否)= 是

4.2 低带宽环境配置（家庭网络适用）

[录制设置]
原画|超清|高清|标清|流畅 = 高清
同一时间访问网络的线程数 = 1
是否使用网络加速(是/否) = 否
视频保存格式ts|mkv|flv|mp4|mp3音频|m4a音频 = flv
录制空间剩余阈值(gb) = 5.0

4.3 长期归档方案（档案馆/教育机构适用）

[录制设置]
保存文件夹是否以作者区分 = 是
保存文件夹是否以时间区分 = 是
保存文件夹是否以标题区分 = 是
保存文件名是否包含标题 = 是
视频保存格式ts|mkv|flv|mp4|mp3音频|m4a音频 = mp4
mp4格式重新编码为h264 = 是
生成时间字幕文件 = 是
录制完成后执行自定义脚本 = 是
自定义脚本执行命令 = /usr/local/bin/archive_script.sh

五、配置优化与故障排除

5.1 性能优化参数组合

针对不同硬件配置的优化建议：

硬件场景	线程数	分段时间	缓存策略	格式选择
低配服务器	1-2	600秒	禁用	flv
标准PC	3-4	1800秒	启用	ts
高性能工作站	5-7	300秒	启用	mkv

5.2 常见配置错误排查流程

六、高级功能：自定义脚本与集成

通过"录制完成后执行自定义脚本"功能实现工作流自动化：

[录制设置]
是否录制完成后执行自定义脚本 = 是
自定义脚本执行命令 = /opt/scripts/post_process.sh {file_path} {author_id} {title}

示例脚本（post_process.sh）：

#!/bin/bash
# 参数1: 文件路径，参数2:作者ID，参数3:标题

# 1. 备份到NAS
rsync -av "$1" nas_server:/archive/live/"$2"/

# 2. 添加元数据
exiftool -Author="$2" -Title="$3" "$1"

# 3. 发送完成通知
curl -X POST -d "file=$1&status=completed" https://monitoring.example.com/api

七、配置迁移与版本控制

建议采用以下策略管理配置变更：

1. 创建配置模板文件（config.template.ini）存储默认值
2. 使用版本控制工具跟踪变更（git）
3. 敏感信息使用环境变量注入
4. 定期备份配置文件（可配合crontab自动执行）

配置文件备份脚本示例：

#!/bin/bash
BACKUP_DIR="/backup/configs"
TIMESTAMP=$(date +%Y%m%d_%H%M%S)
mkdir -p $BACKUP_DIR
cp /data/web/disk1/git_repo/gh_mirrors/do/DouyinLiveRecorder/config/*.ini $BACKUP_DIR/config_$TIMESTAMP.ini
# 保留最近30天备份
find $BACKUP_DIR -name "config_*.ini" -mtime +30 -delete

八、总结与最佳实践

有效配置DouyinLiveRecorder需要平衡以下因素：

• 存储需求与性能
• 网络带宽与稳定性
• 内容价值与保留策略
• 自动化与人工干预平衡

建议的配置管理流程：

1. 初始配置采用默认值，验证基础功能
2. 根据实际使用场景调整核心参数
3. 启用必要的推送通知
4. 逐步添加高级功能（如脚本集成、元数据生成）
5. 定期审查配置有效性（建议每月一次）

通过本文档介绍的配置方案，您可以构建从简单录制到企业级直播归档的完整解决方案，满足不同场景下的个性化需求。

---

配置文件版本：v2.4.0
最后更新日期：2025-09-10
适配程序版本：DouyinLiveRecorder v3.2+

提示：所有配置变更需重启程序生效。建议修改前备份原始配置文件。如遇配置问题，可提交issue至项目仓库获取支持。

【免费下载链接】DouyinLiveRecorder 项目地址: https://gitcode.com/gh_mirrors/do/DouyinLiveRecorder