# RSS 信息流服务 - 部署指南

## 📋 系统要求

- Linux 服务器 (CentOS/OpenCloudOS/Ubuntu/Debian)
- 至少 2GB 内存
- 10GB 可用磁盘空间
- Docker 和 Docker Compose

## 🚀 快速部署

### 方式一：自动安装（推荐）

```bash
# 进入目录
cd /root/.openclaw/workspace/rss-service

# 1. 安装 Docker (需要 root 权限)
sudo ./install-docker.sh

# 2. 重新加载 docker 组
newgrp docker

# 3. 启动服务
./start.sh
```

### 方式二：手动安装 Docker

**OpenCloudOS/CentOS:**
```bash
# 安装 Docker
sudo yum install -y yum-utils
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
sudo systemctl enable --now docker

# 安装 Docker Compose
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

# 添加用户到 docker 组
sudo usermod -aG docker $USER
```

**Ubuntu/Debian:**
```bash
# 安装 Docker
curl -fsSL https://get.docker.com | sh

# 安装 Docker Compose
sudo apt-get install docker-compose-plugin
```

### 方式三：使用 Docker Compose 直接启动

```bash
cd /root/.openclaw/workspace/rss-service
docker-compose up -d
```

## 📱 访问服务

### FreshRSS (主阅读器)
- **地址**: `http://服务器 IP:8080`
- **首次使用**: 需要创建管理员账号
- **功能**: 阅读 RSS、管理订阅、分类整理

### RSSHub (订阅源生成器)
- **地址**: `http://服务器 IP:1200`
- **文档**: `http://服务器 IP:1200`
- **功能**: 将没有 RSS 的网站转换为 RSS 源

## 📥 导入订阅源

1. 访问 FreshRSS 并完成初始化（创建管理员账号）
2. 点击顶部菜单 **设置** ⚙️
3. 选择 **导入/导出** 标签
4. 点击 **选择文件**，上传 `subscriptions.opml`
5. 点击 **导入**
6. 等待刷新完成（约 1-2 分钟）

## 🔧 配置说明

### 修改端口

编辑 `docker-compose.yml`:
```yaml
ports:
  - "8080:80"    # 修改前面的 8080 为你想要的端口
```

### 修改刷新频率

编辑 `docker-compose.yml`:
```yaml
environment:
  - CRON_MIN=*/30  # 每 30 分钟刷新一次
```

### 启用 HTTPS (推荐)

使用 Nginx 反向代理:

```nginx
server {
    listen 443 ssl;
    server_name rss.yourdomain.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}
```

## 📊 服务管理

```bash
# 查看状态
docker-compose ps

# 查看日志
docker-compose logs -f freshrss

# 重启服务
docker-compose restart

# 停止服务
docker-compose down

# 完全重置 (删除数据)
docker-compose down -v
```

## 💾 数据备份

```bash
# 备份数据库
docker-compose exec db mysqldump -u freshrss -pfreshrss_user_password_2026 freshrss > backup-$(date +%Y%m%d).sql

# 备份 FreshRSS 数据
docker-compose exec freshrss tar czf /tmp/freshrss-data.tar.gz /var/www/FreshRSS/data

# 下载备份
docker cp freshrss:/tmp/freshrss-data.tar.gz ./
```

## 📈 订阅源统计

| 分类 | 数量 |
|------|------|
| 技术博客 | 35+ |
| 科技媒体 | 17+ |
| 新闻资讯 | 30+ |
| 财经商业 | 11+ |
| 软件应用 | 8+ |
| 文化阅读 | 28+ |
| 游戏娱乐 | 6+ |
| 热点榜单 | 8+ |
| 微信公众号 | 15+ |
| B 站 | 2+ |
| **总计** | **160+** |

## 🔐 安全建议

1. **修改默认密码**: 初始化时设置强密码
2. **启用 HTTPS**: 使用 Let's Encrypt 免费证书
3. **防火墙配置**: 只开放必要端口
4. **定期备份**: 设置定时备份任务
5. **更新镜像**: 定期 `docker-compose pull && docker-compose up -d`

## ❓ 常见问题

### 服务启动失败
```bash
# 查看日志
docker-compose logs

# 检查端口占用
netstat -tlnp | grep 8080
```

### 订阅源无法刷新
- 检查服务器网络连接
- 部分源可能需要 RSSHub 生成
- 刷新间隔不要太短

### 内存不足
- 减少订阅源数量
- 增加服务器内存
- 调整刷新频率

## 📞 支持

- FreshRSS 文档：https://freshrss.github.io/FreshRSS/
- RSSHub 文档：https://docs.rsshub.app/
- 项目文件：`/root/.openclaw/workspace/rss-service/`