故障排查

首先查看哪里

# systemd 状态
sudo systemctl status pier

# 日志（最近 100 行）
sudo journalctl -u pier -n 100 --no-pager

# 实时跟踪
sudo journalctl -u pier -f

常见症状

“Port 80 already in use”

另一个服务（Apache、nginx 或另一个 Traefik）正在主机上占用 80 端口。请停止或迁移它。Pier 期望由 Traefik 独占 80 和 443 端口。

Let’s Encrypt 无法签发证书

• 在 Pier 中添加域名之前，该域名的 A 记录必须解析到本服务器。
• 80 端口必须对公网开放——ACME HTTP-01 质询需要它。
• 检查 Traefik 日志：docker logs pier-traefik。

容器启动后立即退出

• 打开该服务的 Logs 标签页。大多数镜像问题都会显示在容器的标准输出中。
• 确认已设置环境变量。缺少必需的环境变量是最常见的原因。
• 对于数据库，检查数据卷的磁盘空间：df -h。

仪表盘显示 502

• Pier 的 systemd 单元很可能没有运行。sudo systemctl restart pier。
• 如果 Pier 正在运行但仍返回 502，请检查 journalctl -u pier -n 200 中是否有 panic。

内存占用过高

单个 Pier 进程的常驻内存应保持在 50 MB 以下。如果你看到数百 MB，那是某个受管容器在占用。打开仪表盘上的 Memory 弹窗——它会按容器细分内存占用。

报告 Bug

请在 Pier 仓库提交问题，并附上：

• Pier 版本（Settings → Updates）。
• 操作系统 + Docker 版本。
• journalctl -u pier 的 100 行日志。
• 复现步骤。