部署概述

本文将指导读者完成RssHub的容器化部署，并通过内网穿透工具实现公网访问，构建一个可7×24小时在线的RSS订阅源服务。RssHub作为开源RSS生成器，支持上千个网站的订阅源生成，结合内网穿透技术后，可突破局域网限制，满足全球范围内的订阅需求。

部署场景

1. 自媒体运营：实时追踪热点新闻、社交媒体动态，通过RSS自动推送更新
2. 技术监控：将GitHub仓库更新、技术博客新文章自动同步到阅读器
3. 学习管理：订阅慕课平台课程更新、学术论坛精华帖，提升信息获取效率
4. 企业应用：抓取内部Wiki更新、NAS文件变更，构建私有化知识管理系统

架构与组件

部署方案采用分层架构设计：

1. 应用层：RssHub容器实例，负责订阅源生成与内容抓取
2. 网络层：内网穿透服务，建立本地端口与公网地址的映射关系
3. 存储层：可选配置外部数据库，支持大规模订阅源管理
4. 监控层：日志收集与健康检查机制，保障服务可用性

前置准备

环境要求

• 服务器配置：2核4G内存（基础版），建议使用具备公网IP的云服务器
• 操作系统：Linux（推荐CentOS 8+/Ubuntu 20.04+）
• 依赖组件：Docker引擎（版本≥20.10）、curl工具

资源规划

资源类型	基础配置	扩展建议
CPU	2核	4核+（高并发场景）
内存	4GB	8GB+（支持千级订阅源）
存储	20GB	100GB+（含日志持久化）
带宽	5Mbps	20Mbps+（全球访问场景）

部署流程

1. Docker环境初始化

# 安装Docker依赖包
sudo yum install -y yum-utils device-mapper-persistent-data lvm2
# 添加官方仓库并安装Docker
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
sudo yum install -y docker-ce docker-ce-cli containerd.io
# 启动Docker服务并设置开机自启
sudo systemctl enable --now docker

2. RssHub容器部署

# 拉取官方镜像（推荐使用轻量版）
docker pull diygod/rsshub:latest
# 创建持久化存储目录
mkdir -p /data/rsshub/{cache,log}
chmod -R 755 /data/rsshub
# 启动容器实例
docker run -d \
  --name rsshub \
  -p 1200:1200 \
  -v /data/rsshub/cache:/app/cache \
  -v /data/rsshub/log:/app/log \
  -e CACHE_EXPIRE=3600 \
  -e PUPPETEER_WS_ENDPOINT=none \
  --restart unless-stopped \
  diygod/rsshub

3. 内网穿透配置

# 下载穿透工具客户端（以通用CLI工具为例）
wget https://example.com/client-linux-amd64.tar.gz
tar -zxvf client-linux-amd64.tar.gz
cd client-linux-amd64
# 配置隧道参数（示例配置）
./client config add \
  --protocol tcp \
  --local_addr 1200 \
  --remote_port 8080 \
  --region ap-southeast-1 \
  --token YOUR_AUTH_TOKEN
# 启动隧道服务
./client start --all

4. 访问验证

1. 本地测试：访问 http://localhost:1200/bilibili/user/357121856 验证B站订阅源
2. 公网测试：通过穿透工具分配的公网地址访问，如 https://xxxx.region.example.com/weibo/hot
3. 健康检查：执行 curl -I http://localhost:1200/health 应返回200状态码

配置说明

关键环境变量

变量名	默认值	作用说明
CACHE_EXPIRE	3600	缓存有效期（秒）
PUPPETEER_WS_ENDPOINT	none	浏览器自动化控制端点
TIMEOUT	30000	请求超时时间（ms）
MAX_RETRY	3	失败重试次数

性能优化参数

# 在容器启动时添加以下参数
-e UV_THREADPOOL_SIZE=16 \
-e NODE_OPTIONS="--max-old-space-size=4096" \

示例场景配置

监控GitHub仓库更新

docker run -d \
  --name github-monitor \
  -e ROUTES="/github/repos/owner/repo" \
  -e WEBHOOK_URL="https://your-webhook-endpoint" \
  --network container:rsshub \
  diygod/rsshub

企业Wiki订阅配置

1. 在RssHub容器内安装自定义插件：

   docker exec -it rsshub bash
   cd /app/lib/routes
   git clone https://github.com/your-repo/wiki-plugins.git

2. 重启容器后访问：
   http://公网地址/wiki/internal/changelog

上线验证标准

1. 功能验证：至少3个不同类型订阅源（如微博、GitHub、知乎）正常生成
2. 性能验证：QPS≥50时响应时间<500ms
3. 稳定性验证：72小时连续运行无内存泄漏
4. 安全验证：仅允许指定IP访问管理接口

常见问题排查

连接失败处理

1. 本地服务未启动：

   • 检查容器状态：docker ps -a | grep rsshub
   • 查看日志：docker logs -f rsshub

2. 穿透隧道异常：

   • 验证本地端口监听：netstat -tulnp | grep 1200
   • 检查隧道状态：./client status

3. 订阅源抓取失败：

   • 检查目标网站反爬策略
   • 调整USER_AGENT环境变量
   • 增加请求间隔时间

性能瓶颈优化

1. 内存不足：

   • 增加容器内存限制：-m 8g
   • 优化缓存策略：缩短CACHE_EXPIRE

2. CPU占用高：

   • 限制并发请求数：-e MAX_CONCURRENT=50
   • 启用负载均衡：部署多个RssHub实例

运维与优化

监控体系构建

1. 基础监控：

   • CPU/内存使用率（Prometheus+Grafana）
   • 请求成功率（ELK日志分析）

2. 业务监控：

   • 订阅源更新延迟（自定义脚本监控）
   • 失败请求重试率（应用日志分析）

安全加固方案

1. 访问控制：

   • 配置Nginx反向代理限制IP
   • 启用Basic Auth认证

2. 数据安全：

   • 定期备份缓存数据
   • 敏感信息加密存储

扩展性设计

1. 水平扩展：

   • 使用Docker Swarm部署多实例
   • 配置负载均衡器分发请求

2. 垂直扩展：

   • 升级服务器配置
   • 优化数据库查询性能

总结

通过容器化部署RssHub并结合内网穿透技术，我们成功构建了一个可全球访问的RSS订阅源服务。该方案具有以下优势：

1. 快速部署：30分钟内完成从环境准备到服务上线
2. 弹性扩展：支持从单机到集群的平滑升级
3. 安全可控：通过多层防护保障数据安全
4. 成本优化：按需分配资源，避免闲置浪费

建议定期进行健康检查（每周）和性能调优（每月），并根据业务增长情况提前规划资源扩容。对于企业级部署，可考虑增加高可用架构设计和自动化运维工具链。