BililiveRecorder Docker版Cookie更新机制解析与正确操作指南

背景与问题现象

在使用BililiveRecorder Docker版本时，用户经常遇到修改配置文件中的Cookie后重启容器不生效的情况。典型表现为：

1. 用户手动编辑配置文件更新Cookie值
2. 重启Docker容器后，程序仍使用旧Cookie
3. 将修改后的配置文件下载到Windows版本测试却可以正常工作

技术原理分析

Docker版特殊行为机制

BililiveRecorder在Docker环境中有特殊的配置保存机制：

1. 退出时自动保存：当容器停止时，程序会自动将当前内存中的配置写回配置文件
2. 启动时加载：容器启动时会读取配置文件到内存

这就形成了一个关键时序问题：

• 如果先修改文件再重启容器，重启过程中程序会将内存中的旧配置覆盖回文件
• 导致实际运行时仍使用旧Cookie值

与Windows版的差异

Windows版本由于是直接运行的可执行文件：

• 没有自动保存配置的强制机制
• 配置文件修改后立即生效
• 这种差异导致了用户测试时的困惑

正确操作流程

推荐操作步骤

1. 停止容器运行

   docker stop [容器名/ID]
   

2. 修改配置文件

   • 通过volume映射找到配置文件
   • 确保修改的是正确的配置文件（通常为config.json）

3. 启动容器

   docker start [容器名/ID]
   

验证方法

1. 检查日志输出

   docker logs [容器名/ID]
   

   观察是否显示加载了新Cookie

2. 测试录制功能

   • 尝试录制需要Cookie的内容
   • 验证是否能正常获取原画质

进阶建议

1. 配置版本控制

   • 建议对配置文件进行版本备份
   • 修改前复制config.json为config.json.bak

2. 环境变量替代方案

   • 对于Docker部署，考虑使用环境变量注入Cookie
   • 避免直接修改配置文件

3. 定时检查机制

   • 设置定期检查Cookie有效性的任务
   • 可通过脚本自动化更新流程

总结

BililiveRecorder Docker版本由于特殊的配置保存机制，需要特别注意修改配置文件的时序问题。正确的做法是遵循"先停止→后修改→再启动"的操作流程，确保配置变更能够正确生效。理解这一机制后，可以更高效地管理直播录制任务的认证信息更新。