关于 Agent DVR: 故障排除

访问日志

Agent DVR使得通过格式化的实时日志轻松了解应用内部运行情况变得容易。您可以在本地服务器的/logs.html找到这些日志。对于默认设置，那就是http://localhost:8090/logs.html。非常适合实时洞察！

从版本3.5.6.0开始，Agent DVR还会将五条最新的原始日志以.json格式存储在您的媒体文件夹中。在Windows上，通常位于C:\Program Files\Agent\Media。这些详细的日志非常适合调试和理解Agent的内部工作原理。

在macOS上，Agent DVR服务还会将其控制台输出写入~/Library/Logs/agentdvr.log和~/Library/Logs/agentdvr.error.log - 如果服务启动失败，请检查这些文件。

Agent DVR本地不能工作的一个常见问题是VPN程序干扰。如果本地版本的Agent DVR出现问题，请尝试禁用VPN，看是否能解决问题。NordVPN中的"Stay Invisible on LAN"设置已知也会导致问题。

需要远程访问日志？没问题！您可以从网页门户的服务器菜单直接下载这些原始日志。如果您有疑问或需要帮助，我们的社区讨论板就在近在咫尺。加入对话并获得您需要的支持！

安装问题

在 Windows 安装程序中遇到 Agent DVR 问题？如果安装失败，或 Agent DVR 无法启动，或者你需要 Windows 服务模式中不提供的其他功能（如某些 GPU 驱动程序和桌面监控），这里有一个使用命令提示符的解决方法：

  • 首先，如果 Agent DVR 服务正在运行，请停止它。转到"开始"，输入"services.msc"，然后按 Enter。在列表中找到"Agent"，右键点击它并选择"停止"。若要防止它自动启动，右键点击"Agent"，转到"属性"，将启动类型设置为"已禁用"，然后应用更改。
  • 然后，打开控制台窗口。点击"开始"，输入"cmd"，右键点击"命令提示符"，然后选择"以管理员身份运行"。
  • 接下来，导航到 Agent DVR 目录，通常为"cd C:\Program Files\Agent"。
  • 最后，通过输入"Agent.exe"并按 Enter，以控制台应用程序的形式运行 Agent DVR。

Agent DVR 会告知你任何启动问题以及它正在使用的本地端口。你可以随时按 Enter 退出 Agent DVR。在控制台中运行 Agent DVR 可实现更多 GPU 设备使用和桌面录制功能。

在 Windows 上遇到"类型初始化程序'Emgu.CV.Cuda.CudaInvoke'引发了异常"这样的错误？你可能需要为操作系统安装 Windows 媒体功能包。

如果防病毒应用或防火墙阻止了 Agent DVR 访问本地端口，请考虑将 Agent.exe 添加到允许列表或在防火墙中打开必要的端口。

使用 Windows N 版本？你将需要 Windows N 的媒体功能包。

在 macOS、Linux 或 Raspberry Pi 上，缺少库可能会导致启动失败（如缺少"libcvextern.so"）。使用"ldd"或"objdump -r --dylibs-used"等命令来识别和安装缺失的依赖项。如果你遇到此类问题，请与我们联系，以便我们可以更新文档并更好地帮助你！

视频故障

遇到视频卡顿问题？让我们改善一下！Agent DVR 默认使用 UDP 以实现快速、实时的视频传输，但切换到 TCP 可能会解决任何损坏问题，代价是会有轻微的缓冲延迟。以下是您可以尝试的其他一些提示和技巧：

要修改这些设置，请编辑摄像头，选择"常规"标签，然后点击视频源旁边的"..."按钮，在该控件上选择 FFmpeg 或"高级"选项（位于右上角菜单中）。这些选项仅适用于文件和网络（IP）视频源。
  • 在 FFmpeg 设置中勾选"优先使用 TCP"以获得更稳定的连接。
  • 在 FFmpeg 设置中取消勾选"低延迟"。这可能会改善稳定性，代价是视频源中会有轻微的延迟。
  • 向 FFmpeg 设置添加选项。对于高分辨率流，您可能需要调整一些缓冲区大小。例如，这些选项可能会有帮助：

    reorder_queue_size=500
    
 buffer_size=4096000

    提示：Agent DVR 会记录摄像头已连接时应用的 ffmpeg 设置。您可以在选项面板中覆盖这些设置。以下是一组选项示例：

    probesize=10485760
analyzeduration=5000000
max_delay=10000000
overrun_nonfatal=1
tcp_nodelay=1
reorder_queue_size=16
fifo_size=278876
buffer_size=2100000
rw_timeout=8000000
timeout=8000000
stimeout=8000000
user_agent=Mozilla/5.0

  • 如果 GPU 解码效果不理想，请尝试在"高级"标签上使用 CPU 解码。有时 CPU 实际上会比 GPU 给您更好的性能，因为在系统和 GPU 之间传输内存可能会比仅在原地解码花费更长的时间。
  • 如果"高级"标签上有解码器可用，请考虑使用 VLC 作为解码器。这应该是最后的选择，因为它的效率不是很高，并且 VLC 库中存在一些错误。

Reolink 摄像头特别容易遇到损坏的 RTSP 流问题。一个有用的建议是在摄像头的设置中将编码器切换为使用 H264 而不是 H265（如果可用）。此外，Reolink 摄像头可能会提供使用 RTMP:// 协议而非 RTSP:// 的备用视频端点。使用 Agent DVR 中的"添加摄像头"向导来探索这些 RTMP:// 替代方案，以获得可能更好的结果。

视频卡顿？如果您在直播或录制回放中注意到卡顿，特别是在某些 Reolink 摄像头上，以下是解决方案：编辑摄像头设置，转到 FFmpeg 标签，然后在底部的选项中添加 reorder_queue_size=500。

重置本地登录

忘记了本地 Agent DVR 登录？别担心，重置它轻而易举，会将其恢复到无需登录的状态：

  • 首先，让我们停止 Agent DVR：
    • Windows：进入"开始"，键入"services.msc"，在列表中查找 Agent DVR，右键单击，选择"停止"。
    • Linux：打开终端并运行 
      sudo systemctl stop AgentDVR.service
    • macOS：打开终端并运行 
      launchctl bootout gui/$(id -u) ~/Library/LaunchAgents/com.ispy.agent.dvr.plist
      在较旧的安装中，服务作为系统守护进程运行 - 如果该文件不存在，运行 
      sudo launchctl bootout system /Library/LaunchDaemons/com.ispy.agent.dvr.plist
      注意：不要仅仅退出 Agent 进程 - 服务会自动重新启动它。
  • 接下来，运行重置脚本。在 Windows 上，文件是 agent-reset-local-login.bat。在 Linux/macOS 上，使用 agent-reset-local-login.sh。别忘了用以下命令使其可执行： 
    chmod +x agent-reset-local-login.sh
  • 最后，重启 Agent DVR：
    • Windows：打开"services.msc"，查找 Agent，右键单击，选择"开始"。
    • Linux：在终端中运行 
      sudo systemctl start AgentDVR.service
    • macOS：使用终端运行 
      launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.ispy.agent.dvr.plist
      （或在较旧的系统服务安装中： 
      sudo launchctl bootstrap system /Library/LaunchDaemons/com.ispy.agent.dvr.plist
      ）

完成了！您的 Agent DVR 本地登录已重置，您可以无需登录就访问它。简单又安全！