日志与问题反馈

出问题时，日志会告诉你发生了什么。这一页说明去哪里看日志、怎么开启调试模式、反馈问题时该附上什么，以及几项可以自己先做的检查。

查看日志#

在管理后台#

打开「系统设置 → 系统日志」。这里显示服务器的运行记录，内容是英文原文，用于排查问题。密钥与网址签名在写入时已经遮蔽。

• 可以按级别（调试、信息以上、警告以上、只看错误）、模块筛选，也可以用「搜索日志」按文字查找。也能按插件筛选。
• 「实时更新」会让列表持续刷新。最新的在上面，点「加载更早的」查看更早的内容。
• 「导出」会把日志存成纯文本文件，旧的在前，一行一条：时间、级别、模块、消息与详细信息。
• 日志默认保留 7 天，可以在「系统设置 → 设置」里用「日志保留天数」修改。

在 Docker 里#

docker logs --timestamps <服务器容器>
docker compose logs server

这份日志由 Docker 保存并轮替（默认 10 个文件，每个 50 MB）。升级或重建容器之前，请先把它存下来。

调试模式#

调试模式会把每个请求记成一行：方法、路径、状态码和耗时。不记录查询参数和请求头，所以不会记下令牌。可以用它查看播放器实际请求了哪些接口。

1. 在 compose.yaml 的 server 服务里加一行 command: ["-debug"]，然后执行 docker compose up -d。
2. 重现问题。
3. 把那一行删掉，再执行 docker compose up -d。调试模式会让日志增长得很快。

在系统日志里把级别选成「全部（含调试）」就能看到这些行。

获得帮助#

有使用上的问题，可以到 GitHub Discussions 提问，其他用户和我们都能回答。

反馈问题#

遇到故障，请到产品的 GitHub Issues 新建一个问题，并附上：

• 版本号。 显示在侧边栏和「系统设置 → 状态」里，docker logs 的开头也有。
• 环境。 主机或 NAS 型号、CPU 架构（x86 或 ARM）、Docker 版本，以及用的是 Compose 还是 docker run。
• 问题描述。 预期的行为、实际发生的情况、怎么重现，以及涉及哪些播放器（名称与版本）。
• 日志。 问题发生前后的片段，可以从管理后台导出，也可以取自 docker logs。日志里有片名和文件路径。贴出之前，请把不想公开的内容换成代号；凭证虽然已遮蔽，也请自己再看一遍。
• 播放问题。 该视频的容器格式、音视频编码（在条目详情的媒体信息里）、是直接播放还是经过代理，以及播放器的设置。

不要附上备份文件、数据库文件、密钥文件、API 密钥、授权密钥和密码。

自己先检查#

• 扫描不到文件。 确认容器里能看到同样的路径，以及服务器运行的用户有读取权限（见安装页的 user: 设置）。实时监控超过 inotify 上限时会改回定时扫描，这不是故障。
• 播放器连不上。 检查端口和防火墙。从外网访问时，检查反向代理是否转发了 X-Forwarded-Host 和 X-Forwarded-Proto。
• 启动很久。 升级之后数据库可能正在更新。等到 healthy，不要重启。见升级与备份。