Docker+RssHub+cpolar：打造跨设备无缝同步的RSS订阅中心

1. 为什么需要跨设备RSS订阅中心每天早上通勤路上刷手机看新闻到办公室用电脑继续阅读晚上回家再用平板浏览剩余内容——这可能是很多人的日常。但每次切换设备都要重新加载、同步阅读进度实在让人抓狂。更别提那些收藏在不同设备里的优质订阅源想找的时候总是不在眼前。RSSReally Simple Syndication技术诞生20多年来一直是信息获取的高效方式。它能将分散在各处的内容聚合到一个阅读器中避免我们在不同平台间来回切换。但传统RSS方案存在两个痛点一是订阅源需要自行维护更新二是多设备同步依赖第三方云服务存在隐私风险。我三年前开始自建RSS服务时就遇到过这些困扰。直到发现DockerRssHubcpolar这个黄金组合才真正实现了一次订阅全端同步的理想工作流。现在我的阅读进度、收藏夹、订阅列表在所有设备上都能实时同步就像有个永不掉线的私人图书管理员。2. 环境准备与Docker部署2.1 选择合适的硬件平台这套系统对硬件要求极低我测试过的设备包括闲置的树莓派4B2GB内存老款联想笔记本i5-6200U阿里云最便宜的轻量应用服务器建议选择x86架构设备以获得更好的兼容性。如果使用ARM设备如树莓派需要注意镜像是否提供ARM版本。2.2 Docker安装与配置在Ubuntu 22.04上安装Docker只需三条命令sudo apt update sudo apt install docker.io sudo systemctl enable --now docker国内用户建议配置镜像加速器。新建/etc/docker/daemon.json文件{ registry-mirrors: [ https://docker.mirrors.ustc.edu.cn, https://registry.docker-cn.com ] }然后重启服务sudo systemctl restart docker验证安装成功docker --version # 输出Docker version 24.0.5, build 24.0.5-0ubuntu1~22.04.13. RssHub容器化部署实战3.1 拉取与运行容器官方镜像提供了完整运行环境docker pull diygod/rsshub docker run -d --name rsshub \ -p 1200:1200 \ -e CACHE_TYPEredis \ -e REDIS_URLredis://redis:6379/ \ diygod/rsshub这里我添加了Redis缓存配置能显著提升响应速度。如果需要持久化数据可以挂载volumedocker volume create rsshub-data docker run -d ... -v rsshub-data:/data diygod/rsshub3.2 常见问题排查第一次部署时我遇到容器启动失败的情况通过查看日志找到了原因docker logs rsshub常见错误及解决方案端口冲突修改-p参数为其他端口如1300:1200内存不足添加--memory 512m限制内存使用网络问题检查防火墙设置sudo ufw allow 12003.3 订阅源配置技巧RssHub支持数千种订阅源比如微博用户动态/weibo/user/123456789B站UP主视频/bilibili/user/video/2267573GitHub仓库更新/github/release/DIYgod/RSSHub我习惯用YAML文件管理订阅列表示例subscriptions.ymlcategories: - name: 技术资讯 feeds: - title: 阮一峰博客 url: http://localhost:1200/ruanyifeng/blog - title: V2EX热门 url: http://localhost:1200/v2ex/topics/latest4. cpolar内网穿透详解4.1 安装与基础配置cpolar的安装比frpc等工具更简单curl -L https://www.cpolar.com/static/downloads/install-release-cpolar.sh | sudo bash sudo systemctl enable cpolar sudo systemctl start cpolar登录管理界面http://[你的IP]:9200后第一个要创建的是SSH隧道这对后续维护很重要隧道名称ssh-tunnel协议tcp本地地址22端口类型随机临时TCP端口4.2 RSSHub隧道配置创建HTTP隧道时需要注意几个关键参数本地地址必须与RssHub容器的暴露端口一致前文的1200域名类型免费账户可以使用*.cpolar.cn子域名地区选择距离最近的服务器如China VIP我的隧道配置示例名称rsshub-prod 协议http 本地地址192.168.1.100:1200 域名类型二级子域名 子域名myrss 地区Hong Kong4.3 安全加固措施公网暴露服务需要考虑安全性在cpolar管理界面开启访问认证配置RssHub的访问密码docker run -e PASSPHRASE你的密码 diygod/rsshub定期检查访问日志docker exec rsshub tail -f /var/log/rsshub.log5. 多设备同步方案5.1 桌面端配置推荐使用以下阅读器Windows/MacFluent Reader开源LinuxNewsflash以Fluent Reader为例添加订阅源时点击Add Feed输入https://myrss.cpolar.cn/weibo/user/123456789在Advanced中设置同步间隔30分钟保留文章30天开启Sync across devices5.2 移动端优化iOS用户推荐使用NetNewsWireAndroid可以用Feeder。我发现的几个实用技巧在路由器设置DDNS将域名指向cpolar隧道配置OPML文件一键导入所有订阅开启移动端的离线缓存功能5.3 浏览器扩展方案对于临时阅读场景可以安装RSSHub Radar浏览器扩展。当浏览支持的网站时扩展图标会显示可用订阅源。我在Chrome上的配置设置默认RSS阅读器为本地服务自定义API地址为https://myrss.cpolar.cn开启自动发现订阅源6. 高级功能与优化6.1 性能调优当订阅源超过50个时需要优化系统性能增加Redis缓存过期时间docker run -e CACHE_EXPIRE3600 diygod/rsshub使用Docker资源限制docker update --cpus 1 --memory 1g rsshub设置Nginx反向代理缓存proxy_cache_path /var/cache/nginx levels1:2 keys_zonerss_cache:10m inactive60m;6.2 自动化维护通过crontab设置定期任务每天凌晨3点重启容器0 3 * * * docker restart rsshub每周备份订阅配置0 4 * * 0 docker cp rsshub:/app/config.yml /backups/rsshub-$(date %Y%m%d).yml6.3 监控与告警使用Prometheus监控服务状态启用RssHub的metrics端点docker run -e METRICS1 diygod/rsshub配置Grafana仪表盘监控请求成功率响应时间百分位热门订阅源访问量7. 常见问题解决方案7.1 订阅源失效处理当某个订阅源突然不可用时首先检查原始网站是否改版尝试更新RssHub到最新版本docker pull diygod/rsshub docker restart rsshub在GitHub提交issue时提供复现步骤错误日志网页源码示例7.2 连接速度优化海外服务器访问慢的解决方案在cpolar中切换线路使用Cloudflare CDN加速本地部署中间件缓存docker run -d --name rss-proxy -p 8080:80 \ -e BACKEND_URLhttp://rsshub:1200 \ nginx7.3 数据迁移方法更换服务器时的完整迁移步骤导出订阅列表docker exec rsshub cat /app/config.yml backup.yml备份Redis数据如果使用docker exec redis redis-cli SAVE在新服务器重复部署流程恢复数据docker cp backup.yml rsshub:/app/config.yml这套系统已经稳定运行在我的家庭服务器上超过两年期间经历过三次大版本升级和两次服务器迁移。最让我惊喜的是即使是在4G网络环境下通过优化后的cpolar隧道移动端访问速度依然令人满意。现在我的阅读效率至少提升了三倍再也不会错过重要更新真正实现了信息自由。