docker logs -f 是查看 frankenphp 容器实时日志最直接可靠的方式，因其默认将所有 php 错误、http 请求及 sapi 信息输出到 stdout/stderr，而非写入 /var/log/ 文件；需确认容器名并避免误查容器内日志文件。
docker logs -f 查看 FrankenPHP 容器实时日志
直接用 docker logs -f 是最常用也最可靠的方式，前提是容器启动时没禁用 stdout/stderr 输出（FrankenPHP 默认就是输出到标准流的）。
常见错误是误以为要进容器里查 /var/log/ 下的文件——FrankenPHP 在 Docker 里默认不写磁盘日志，所有 PHP 错误、HTTP 请求、SAPI 启动信息都走标准输出。
- 先确认容器名或 ID：
docker ps --filter ancestor=frankenphp --format "{{.Names}} {{.Status}}" - 执行实时跟踪：
docker logs -f frankenphp-app（把frankenphp-app换成你的容器名） - 加
--tail 50可只看最近 50 行再持续追加：docker logs -f --tail 50 frankenphp-app
为什么 tail -f /var/log/xxx 不起作用
因为官方 FrankenPHP 镜像（如 frankenphp/frankenphp）压根不往文件写日志。它复用 Swoole 的日志机制，默认全部导向 stderr；PHP 的 error_log()、trigger_error()、未捕获异常，以及 HTTP 请求摘要（如 GET /api/user 200 12ms），全在 stdout/stderr 流里。
如果你看到容器里有 /var/log/php-fpm.log 或类似路径，那大概率是你自己挂载了卷或改写了入口脚本——这不是默认行为。
- 检查是否意外挂载了日志目录：
docker inspect frankenphp-app | jq '.[0].Mounts' - 确认日志驱动：
docker inspect frankenphp-app | jq '.[0].HostConfig.LogConfig.Type'（默认是"json-file"，所以docker logs才能读到）
如何让日志包含更详细的请求上下文
FrankenPHP 默认的访问日志较简略（只有方法、路径、状态码、耗时）。要加 IP、User-Agent、响应头等，得靠自定义 frankenphp.yaml 配置 + PHP 层拦截。
在 Linux 上通过 Docker 运行 OpenClaw，并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...
关键点：不能依赖 Apache/Nginx 的 LogFormat，FrankenPHP 的日志格式由 Go 层控制，但只开放了有限字段。更灵活的做法是在 PHP 中用 frankenphp_request_id() 关联请求，并手动记录到 error_log()。
- 启用请求 ID 日志：
error_log("[" . frankenphp_request_id() . "] " . $_SERVER['HTTP_USER_AGENT']); - 确保
log_errors = On且error_log = stderr（Docker 镜像默认已设好） - 避免用
file_put_contents("/tmp/debug.log", ...)—— 容器重启后丢失，且绕过 Docker 日志系统
日志乱码或时间戳缺失怎么办
典型表现是中文变问号、时间显示为 Unix 时间戳（如 1717023492）、或每行开头缺 `[INFO]` 这类标记。这通常不是 FrankenPHP 本身的问题，而是日志采集链路中的编码或格式化环节被跳过。
Docker 的 json-file 日志驱动会自动加时间戳（UTC）和容器元数据，但原始日志内容本身不带前缀。如果你看到纯裸文本，说明你看到的就是 FrankenPHP 直接输出的内容。
- 检查终端是否支持 UTF-8：
echo $LANG应为en_US.UTF-8或类似 - 不要用
docker logs --timestamps试图“修复”时间——它只是给每行加 Docker 接收时间，不是请求处理时间 - 若需结构化日志（JSON 格式），得在 PHP 中用
error_log(json_encode([...], JSON_UNESCAPED_UNICODE))主动输出
FrankenPHP 的日志机制非常轻量，但也因此容易误判“没日志”。核心就一条：信 docker logs，别信容器内文件路径，也别指望开箱即用的 Nginx 式 access_log 配置。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
