跳到主要内容

查看系统日志

1 功能简介​

1Panel 以系统服务方式运行（Core、Agent），运行日志写入安装目录下的 1panel/log。当面板无法访问、任务下发失败或服务异常时，可通过查看系统日志定位原因。本文介绍系统日志的存放位置，以及通过日志文件与面板界面查看日志的方法。

2 前提条件​

  • 已使用具备服务器权限的账号登录 1Panel 所在主机。
  • 已确认 1Panel 的安装目录。默认 install_dir / base_dir 为 /opt，日志位于 /opt/1panel/log；如安装时修改了安装目录，请按实际路径替换本文示例。

3 日志文件目录​

源码中 Core 将日志写入 {install_dir}/1panel/log，Agent 同样使用该日志目录。默认情况下对应关系如下：

表 1 各组件日志目录
组件日志文件名前缀日志目录（默认）
Core1Panel-Core/opt/1panel/log
Agent1Panel/opt/1panel/log
  • Core / Agent： 日志同时写入文件与标准输出；文件按日期滚动，保留份数由配置中的 max_backup 控制（默认 10）。
  • 任务 / SSL 等子目录： 同目录下还可能存在 task、ssl 等子目录，用于存放任务执行、证书申请等相关日志。
面板内查看

也可在 1Panel 控制台 日志审计 → 系统日志 中按级别筛选、查看和下载运行日志，见 日志审计。

4 查看日志文件​

  1. 查看日志目录下的文件列表：
ls -lh /opt/1panel/log
  1. 实时跟踪 Core 日志（文件名含日期后缀，请以目录中实际文件为准），按 Ctrl + C 结束：
tail -f /opt/1panel/log/1Panel-Core*.log
  1. 实时跟踪 Agent 日志：
tail -f /opt/1panel/log/1Panel*.log
及时留存日志

日志会按策略滚动并可能被清理工具清理。排查重要问题时，请先将相关日志复制到其他目录留存。

5 后续操作​