常见问题

装完接口仍像没装

安装向导写完库之后，需要重启常驻进程才会重新读取安装状态与 .env。手动部署执行 php start.php restart；Docker 执行 docker compose restart webman。只刷新浏览器不够。

队列里的操作日志不落库

php start.php start（或 start -d）会一并拉起 HTTP、定时任务、队列和 WebSocket。如果只起了别的 HTTP 服务、没有走这套启动命令，队列消费不会跑，操作日志等异步写入就不会落库。

上传大于 1MB 被拦

前面的 nginx（或宝塔反向代理）默认上传限制往往偏小。按仓库 docker/nginx/default.conf 设置 client_max_body_size 50m，改完重载 nginx。