Profile Sync Daemon (psd) 完整指南

目录

1. 什么是 psd
2. psd 的工作原理
3. psd 的组件
4. 常见问题与故障
5. 问题诊断方法
6. 解决方案
7. 彻底清理方法
8. 预防措施

什么是 psd

Profile Sync Daemon (psd) 是一个用于将浏览器配置文件同步到内存的守护程序，主要目的是：

• 提升浏览器性能：将浏览器配置（书签、历史记录、Cookie 等）从硬盘移到内存中运行
• 保护存储设备：减少对硬盘/SD卡的频繁写入，延长存储设备寿命
• 加快启动速度：内存读取速度远快于硬盘

适用场景

• 树莓派等使用 SD 卡的设备
• 机械硬盘系统
• 需要保护存储设备的嵌入式系统

不适用场景

• 服务器环境（如 Proxmox Backup Server）
• 没有图形界面和浏览器的系统
• 内存紧张的设备

psd 的工作原理

核心机制

硬盘（配置文件） → 内存（运行时） → 定期同步 → 硬盘（持久化）

1. 启动时：将浏览器配置从硬盘复制到内存
2. 运行时：浏览器使用内存中的配置（读写速度更快）
3. 定期同步：通过定时服务将内存中的改动写回硬盘
4. 关机时：最后一次同步，确保数据不丢失

数据流向

浏览器 ←→ 内存（/dev/shm） ←→ 硬盘（~/.mozilla 等）
         ↑                    ↑
         |                    |
    psd 管理             定期同步

psd 的组件

1. 主要服务

2. 相关文件位置

# 服务文件
/usr/lib/systemd/user/psd.service
/usr/lib/systemd/user/psd-resync.service
/usr/lib/systemd/user/psd-resync.timer

# 符号链接
/etc/systemd/user/default.target.wants/psd.service
/etc/systemd/user/default.target.wants/psd-resync.service
/etc/systemd/user/timers.target.wants/psd-resync.timer

# 配置文件
/etc/psd.conf
~/.config/psd/
~/.cache/psd/

# 执行文件
/usr/bin/psd
/usr/bin/profile-sync-daemon

3. 支持同步的浏览器

• Firefox
• Chromium / Chrome
• Opera
• Brave
• Vivaldi

常见问题与故障

问题1：服务启动失败

Failed to start Timed resync
Main process exited, code=exited, status=1/FAILURE

原因：

• 没有安装任何浏览器
• psd 配置错误
• 浏览器配置文件不存在

问题2：日志风暴

# journal 日志快速增长
system.journal 持续写入

原因：

• psd-resync 服务持续失败并记录错误
• 定时器每分钟/每小时触发一次
• 每次失败都写入系统日志

问题3：服务无法禁用

# 即使运行 disable，服务仍显示 enabled
systemctl --user disable psd-resync.service
# 状态仍为 "enabled"

原因：

• 符号链接未完全删除
• systemd 缓存未刷新
• 服务被多个位置引用

问题4：残留服务状态

● psd-resync.service  not-found failed failed
● psd.service         not-found failed failed

原因：

• 服务文件已删除，但 systemd 仍记录失败状态
• 需要手动重置失败状态

问题诊断方法

1. 检查服务状态

# 查看用户服务状态
systemctl --user status psd-resync.service
systemctl --user status psd.service

# 查看所有 psd 相关服务
systemctl --user list-units | grep psd

# 查看失败的服务
systemctl --user --failed

2. 检查配置文件

# 查看 psd 配置
cat /etc/psd.conf

# 查看支持的浏览器
psd list

# 检查是否安装浏览器
which firefox chromium

3. 查看错误日志

# 查看 psd 相关日志
journalctl --user -u psd-resync.service -n 20
journalctl --user -u psd.service -n 20

# 查看系统错误
journalctl -p 3 | grep -i psd

# 查看日志增长速度
journalctl --since "5 minutes ago" | wc -l

4. 查找服务文件位置

# 查找所有 psd 相关文件
find /usr/lib/systemd /etc/systemd -name "*psd*" 2>/dev/null

# 查找符号链接
find /etc/systemd -name "*psd*" -type l 2>/dev/null

5. 检查日志增长

# 监控日志大小变化
watch -n 5 'df -h /var/log'

# 查看 journal 使用情况
journalctl --disk-usage

# 查看详细日志统计
du -sh /var/log/journal/

解决方案

方案1：禁用服务（不需要 psd）

# 停止并禁用服务
systemctl --user stop psd-resync.service
systemctl --user disable psd-resync.service
systemctl --user stop psd-resync.timer
systemctl --user disable psd-resync.timer

# 停止主服务
systemctl --user stop psd.service
systemctl --user disable psd.service

# 重新加载
systemctl --user daemon-reload

方案2：配置 psd（如果需要使用）

# 编辑配置文件
cat > /etc/psd.conf << 'EOF'
# 指定要同步的浏览器（留空表示禁用）
browsers=""

# 同步设置
use_symlink=true
sync_delay=60
EOF

# 重新配置
psd reconfigure

# 重启服务
systemctl --user restart psd.service
systemctl --user enable psd-resync.timer

方案3：完全卸载（推荐用于服务器）

# 卸载软件包
apt-get remove --purge profile-sync-daemon -y

# 删除配置文件
rm -rf /etc/psd.conf
rm -rf ~/.config/psd
rm -rf ~/.cache/psd

彻底清理方法

步骤1：停止所有服务

systemctl --user stop psd-resync.service psd-resync.timer psd.service 2>/dev/null
systemctl --user disable psd-resync.service psd-resync.timer psd.service 2>/dev/null

步骤2：删除服务文件

# 删除主服务文件
rm -f /usr/lib/systemd/user/psd.service
rm -f /usr/lib/systemd/user/psd-resync.service
rm -f /usr/lib/systemd/user/psd-resync.timer

# 删除符号链接
rm -f /etc/systemd/user/default.target.wants/psd.service
rm -f /etc/systemd/user/default.target.wants/psd-resync.service
rm -f /etc/systemd/user/timers.target.wants/psd-resync.timer

步骤3：重置失败状态

# 重置失败的服务
systemctl --user reset-failed psd-resync.service 2>/dev/null
systemctl --user reset-failed psd.service 2>/dev/null

# 重新加载 systemd
systemctl --user daemon-reload
systemctl daemon-reload

步骤4：卸载软件包

# 完全卸载
apt-get remove --purge profile-sync-daemon -y

# 清理依赖
apt autoremove -y

步骤5：清理日志

# 清理 journal 日志
journalctl --rotate
journalctl --vacuum-size=20M
journalctl --vacuum-time=1d

# 可选：清理旧的日志记录
rm -rf /var/log/journal/*/system@*.journal

步骤6：验证清理结果

# 检查服务残留
systemctl --user list-units --all | grep psd || echo "✓ 无 psd 服务"

# 检查软件包
dpkg -l | grep profile-sync-daemon || echo "✓ 已卸载"

# 检查文件残留
find /usr/lib/systemd /etc/systemd ~ -name "*psd*" 2>/dev/null || echo "✓ 无文件残留"

# 检查日志状态
df -h /var/log
journalctl --disk-usage

预防措施

1. 避免在服务器上安装 psd

# 安装前确认是否需要
apt install --dry-run profile-sync-daemon

# 如果误安装，立即清理
apt-get remove --purge profile-sync-daemon -y

2. 监控日志增长

# 创建监控脚本
cat > /usr/local/bin/check_logs.sh << 'EOF'
#!/bin/bash
# 每天检查日志大小
LOG_SIZE=$(df -h /var/log | awk 'NR==2 {print $5}' | sed 's/%//')
if [ "$LOG_SIZE" -gt 80 ]; then
    echo "警告: /var/log 使用率 ${LOG_SIZE}%"
    journalctl --vacuum-size=50M
fi
EOF

chmod +x /usr/local/bin/check_logs.sh

# 添加到 crontab
echo "0 2 * * * /usr/local/bin/check_logs.sh" | crontab -

3. 配置 journald 限制

cat > /etc/systemd/journald.conf.d/99-limits.conf << 'EOF'
[Journal]
SystemMaxUse=50M
SystemMaxFileSize=10M
RuntimeMaxUse=30M
MaxRetentionSec=7day
EOF

systemctl restart systemd-journald

4. 定期清理日志

# 添加到 crontab
echo "0 3 * * 0 journalctl --vacuum-size=50M" | crontab -

完整清理脚本

#!/bin/bash
# 完整清理 psd 和日志的脚本

echo "=== 开始清理 psd ==="

# 1. 停止服务
echo "1. 停止服务..."
systemctl --user stop psd* 2>/dev/null
systemctl --user disable psd* 2>/dev/null

# 2. 删除文件
echo "2. 删除服务文件..."
rm -f /usr/lib/systemd/user/psd*
rm -f /etc/systemd/user/default.target.wants/psd*
rm -f /etc/systemd/user/timers.target.wants/psd*

# 3. 卸载软件包
echo "3. 卸载软件包..."
apt-get remove --purge profile-sync-daemon -y

# 4. 清理配置
echo "4. 清理配置文件..."
rm -rf /etc/psd.conf ~/.config/psd ~/.cache/psd

# 5. 重置 systemd
echo "5. 重置 systemd..."
systemctl --user reset-failed psd* 2>/dev/null
systemctl --user daemon-reload
systemctl daemon-reload

# 6. 清理日志
echo "6. 清理日志..."
journalctl --rotate
journalctl --vacuum-size=20M

# 7. 验证
echo -e "\n=== 清理完成 ==="
echo "服务状态:"
systemctl --user list-units --all | grep psd || echo "  ✓ 无残留服务"
echo ""
echo "日志状态:"
df -h /var/log
journalctl --disk-usage

总结

关键要点

1. psd 是桌面工具，不适合服务器环境
2. 服务失败会导致日志风暴，快速填满内存日志
3. 彻底清理需要删除服务文件 + 卸载软件包 + 重置 systemd
4. 配置 journald 限制可以防止日志无限增长

最佳实践

• ✅ 服务器环境不要安装 psd
• ✅ 配置 journald 大小限制（50-100M）
• ✅ 定期监控 /var/log 使用率
• ✅ 设置日志自动清理定时任务
• ❌ 不要在无浏览器的系统上运行 psd

故障排查速查表

本文档基于 Proxmox Backup Server 环境中的实际问题解决经验整理