2026.8.23
ubuntu24.04（ip:192.168.50.144，用户名：xym）以docker compose方式安装飞鼠组网。
以下用SSH软件FinalShell及CMD进行操作。
一、开启日志
1、确认飞鼠容器名称
sudo docker ps
2、查看飞鼠容器 p2p-feishu 的文件挂载映射关系
2.1以管理员权限，查看 p2p-feishu 容器的详细信息，从中筛选出挂载（Mounts）相关的配置，
并展示该字段及其后面 25 行内容
sudo docker inspect p2p-feishu | grep -A 25 "Mounts"
在 Mounts（挂载）信息中，飞鼠容器（p2p-feishu）日志文件目录映射关系：
宿主机真实路径（Source）：/root/p2p-feishu/logs
容器内部路径（Destination）：/app/data/logs
读写权限：rw（可读可写）
2.2日志文件目录映射的意义
当在容器内开启日志（log_enable: true）后，容器内 /app/data/logs 目录下生成的
p2pCore.log、api.log、saasLog.log 等文件，会实时同步并直接存储在宿主机的 /root/p2p-
feishu/logs 目录中，直接在宿主机(ubuntu24.04)即可查看、打包和管理这些日志文件。
3、查看配置文件
sudo ls -l /root/p2p-feishu/conf/
4、查看日志文件状态并开启日志
4.1在配置文件内查看日志状态
sudo nano /root/p2p-feishu/conf/config.yaml
默认日志是关闭状态：log_enable: false
4.2开启日志
在nano界面，将 log_enable:false ，修改为log_enable:true ，按 Ctrl + O 保存（确认文件名
后按回车），再按 Ctrl + X 退出。
4.3验证修改是否成功
sudo cat /root/p2p-feishu/conf/config.yaml | grep log_enable
确保输出结果为 log_enable: true。
4.4重启 Docker 容器
sudo docker restart p2p-feishu
⚠️确保已完成开启日志并重启容器，否则不能生成磁盘日志文件。
5、进入日志目录并查看文件大小：
sudo ls -l /root/p2p-feishu/logs
可以看到api.log、 p2pCore.log 和 saasLog.log 这3个日志文件
二、获取故障日志
飞鼠组网有两套日志来源（磁盘日志文件、docker logs），信息不完全等价，排查故障两份都要
收集。
1、 获取磁盘日志文件（/root/p2p-feishu/logs/）
- 需要配置
log_enable: true才会生成 - 优势：保存部分调试日志，这部分内容不会输出到 docker 控制台
#1 停止飞鼠容器
sudo docker stop p2p-feishu
#2 全部清空日志（整行复制）
sudo truncate -s 0 /root/p2p-feishu/logs/api.log /root/p2p-feishu/logs/p2pCore.log
/root/p2p-feishu/logs/saasLog.log
-注：当前只清空 3 个日志，后续会生成docker_stdout.log，复现故障前旧日志导出文件需要
一并清空，防止混入历史旧日志。
完整清空命令：
sudo truncate -s 0 /root/p2p-feishu/logs/api.log /root/p2p-feishu/logs/p2pCore.log /root/p2p-feishu/logs/saasLog.log /root/p2p-feishu/logs/docker_stdout.log
#3 校验全部为0
sudo ls -l /root/p2p-feishu/logs
-注：容器运行时程序持续写盘，如果不停止容器直接执行 truncate，文件清空瞬间就会被程序重
新写入数据
#4 启动容器
sudo docker start p2p-feishu
#5复现故障
操作复现故障。
#6查看故障日志
sudo ls -l /root/p2p-feishu/logs
2、获取 docker logs（控制台 stdout 日志）
- 无需开启
log_enable，docker 层面捕获输出 - 优势：可以拿到程序启动、异常崩溃 panic 堆栈；程序崩溃时磁盘文件经常丢失崩溃信息
#1、导出最后 200 行容器控制台日志保存到文件，输出重定向写入磁盘文件 /root/p2p-feishu/logs/docker_stdout.log
sudo sh -c 'docker logs -n 200 p2p-feishu > /root/p2p-feishu/logs/docker_stdout.log'
【 根据情况可以导出 docker 控制台完整日志到磁盘：
sudo sh -c 'docker logs p2p-feishu > /root/p2p-feishu/logs/docker_stdout.log'】
#2、校验日志文件生成
sudo ls -l /root/p2p-feishu/logs
三、在宿主机（ubuntu24.04）打包全部日志（磁盘日志 + 导出的控制台日志）
-打包后日志文件路径：/home/xym/feishu_logs_full.tar.gz
1、执行打包命令（注意：命令最后有一个句点 . ）：
sudo tar -czf /home/xym/feishu_logs_full.tar.gz -C /root/p2p-feishu/logs .
- 注：sudo 打包生成的压缩包属主为 root，Ubuntu 本机普通 xym 用户只能读取、解压，不能直
- 接删除 / 修改该文件；下载到 Windows 本地后可随意操作，不影响 sftp 下载。
2、确认 /home/xym 目录下feishu_logs_full.tar.gz 文件
ls -l /home/xym
四、将压缩包传输到 Windows 系统
-
本例用 Windows 命令提示符（CMD），通过 SFTP 协议登录到 IP 为 192.168.50.144 ，用户名
为xym的 Ubuntu 机器，把 feishu_logs_full.tar.gz 下载到本机 C:\Users\xym 目录，然后退出。
-前置条件：Ubuntu 已安装 openssh‑server，未安装执行：sudo apt install openssh‑server，否则 sftp 连接失败。
sftp xym@192.168.50.144:/home/xym/feishu_logs_full.tar.gz .
输入 Ubuntu 主机密码，文件会下载到 Windows 路径：C:\Users\xym\，在文件资源管理器中找到
文件，发微信到飞鼠客服。
五、关闭日志
#1使用管理员权限编辑并保存
sudo nano /root/p2p-feishu/conf/config.yaml
将 log_enable:true ，修改为log_enable:false ，按 Ctrl + O 保存（确认文件名后按回
车），再按 Ctrl + X 退出。
#2验证修改是否成功
sudo cat /root/p2p-feishu/conf/config.yaml | grep log_enable
确保输出结果为 log_enable:false。
-注：设置 log_enable:false只会停止生成新磁盘日志，原有旧日志文件不会自动删除，需要手动
删除或清空旧日志。
#3重启 Docker 容器
sudo docker restart p2p-feishu
END