FreshRSS手动更新指南：从SSH终端安全升级

概述

对于使用cPanel等控制面板安装FreshRSS的用户来说，虽然初始安装非常便捷，但面板往往不提供版本更新功能。本文将详细介绍如何通过SSH终端安全地手动更新FreshRSS实例。

准备工作

在开始更新前，请确保：

1. 已备份数据库和配置文件
2. 拥有SSH访问权限
3. 服务器已安装解压缩工具(unzip)
4. 了解当前安装路径

详细更新步骤

1. 下载最新版本

通过SSH连接到服务器后，建议在临时目录下载最新版本：

cd /tmp
wget https://github.com/FreshRSS/FreshRSS/archive/refs/heads/master.zip

2. 解压文件包

unzip master.zip

3. 停止Web服务(可选)

为避免更新过程中出现数据不一致，可临时停止Web服务：

sudo service apache2 stop  # 对于Apache
# 或
sudo service nginx stop    # 对于Nginx

4. 备份关键文件

cp -r /path/to/freshrss/data /path/to/backup/freshrss_data_backup

5. 执行更新操作

rsync -av --delete /tmp/FreshRSS-master/ /path/to/freshrss/ --exclude='data'

6. 设置权限

chown -R www-data:www-data /path/to/freshrss
chmod -R 775 /path/to/freshrss/data

7. 重启Web服务

sudo service apache2 restart  # 对于Apache
# 或
sudo service nginx restart    # 对于Nginx

更新后验证

1. 访问FreshRSS管理界面
2. 检查系统信息中的版本号
3. 确认所有订阅源更新正常
4. 验证扩展功能是否正常工作

常见问题解决方案

更新后出现白屏

• 检查PHP版本是否符合要求
• 查看Web服务器错误日志
• 确认文件权限设置正确

数据库连接失败

• 检查data/config.php中的数据库配置
• 确认数据库服务正常运行

最佳实践建议

1. 在非高峰期执行更新
2. 先在测试环境验证更新过程
3. 记录每次更新的时间和版本
4. 考虑设置自动备份脚本

通过遵循上述步骤，即使是通过cPanel等便捷方式安装的FreshRSS实例，也能安全可靠地完成手动更新，确保系统始终运行最新版本，获得最佳性能和安全性。