TrendRadar 部署指南：雨云Docker 与GitHub Pages 完整部署教程

目 录

1. 部署前准备

2. 部署方式概览

3. 方式一：GitHub Pages 免费部署

4. 方式二：雨云 Docker 部署 (推荐)

5. 成本与性能分析

6. 常见问题与解决方案

部署前准备

1. 系统要求

最低配置：1CPU、1GB 内存、10GB 存储；推荐配置：2CPU、2GB 内存、50GB 存储。
支持操作系统：Linux（Ubuntu 18.04+、CentOS 7+、Debian 9+）、macOS（10.14+）、Windows（10+、Server 2019+）。

2. 软件依赖

需安装 Python 3.8+、Docker 20.10+（容器化部署可选）、Git 2.20+。推荐用uv工具管理 Python 依赖，简化环境配置。

3. 获取源码

通过 Git 克隆项目代码：

git clone https://github.com/sansan0/TrendRadar.git
cd TrendRadar

部署方式概览

TrendRadar 提供多种部署方案，本指南重点介绍两种主流方式：

• GitHub Pages 部署：无需服务器，适合快速体验；

• 雨云 Docker 部署：独立服务器环境，性能与扩展性更佳，适合长期稳定运行。

方式一：GitHub Pages 免费部署

1. 部署原理

GitHub Pages 是 GitHub 提供的静态网站托管服务，支持从仓库直接部署静态文件。TrendRadar 通过 GitHub Actions 自动构建发布，实现 30 秒快速部署。

2. 部署步骤

1. Fork 项目：访问TrendRadar 仓库，点击右上角“Fork”复制到个人 GitHub 账户。

2. 配置 Secrets：进入 Fork 后的仓库 → Settings→Secrets and variables→Actions，添加以下密钥（名称严格匹配，区分大小写）：

   • WEWORK_WEBHOOK_URL：企业微信机器人 Webhook 地址

   • FEISHU_WEBHOOK_URL：飞书机器人 Webhook 地址

   • DINGTALK_WEBHOOK_URL：钉钉机器人 Webhook 地址

   • TELEGRAM_BOT_TOKEN：Telegram 机器人 Token

   • TELEGRAM_CHAT_ID：Telegram 聊天 ID

   • EMAIL_FROM/EMAIL_PASSWORD/EMAIL_TO：邮件发送配置

   • BARK_URL：Bark 推送服务地址

3. 修改配置文件：编辑config/config.yaml和config/frequency_words.txt，设置监控关键词与推送模式。

4. 启用 Actions：进入仓库Actions标签页，点击提示条启用工作流。

5. 手动测试：选择“Hot News Crawler”工作流 → Run workflow触发运行，1-3 分钟内验证推送是否成功。

3. 优势与限制

• 优势：零成本、自动化部署、与 GitHub 仓库集成（代码更新自动重构）；

• 限制：仅支持静态内容，无法运行后端代码；仓库大小建议≤1GB；每月免费带宽 100GB，每小时构建次数 10 次；国内基本无法访问。

方式二：雨云Docker 部署(推荐)

1. 雨云平台优势

• 高性价比：价格亲民，提供免费试用与优惠方案；

• 稳定高速：采用 AMD EPYC 处理器 + 企业级 NVMe SSD；

• 灵活计费：按需 / 包年计费，多配置可选；

• 便捷易用：自研控制面板，支持一键部署；

• 7×24 小时客服：专业技术支持。

2. 雨云注册

新用户注册用优惠码techaser（或专属链接注册）绑定微信获额外 5 折优惠；签到积分可兑换优惠券 / 续费，积分商城可以兑换我的专属 8 折优惠

3. 服务器选型

4. Docker部署步骤

1. 连接服务器：通过 SSH 客户端（如 FinalShell）连接雨云服务器（IP 与密码在控制台查看）。

安装 Docker（雨云预装镜像可省略）：

apt-get update
sudo apt-get install -y docker.io
sudo systemctl start docker
sudo systemctl enable docker

1. 拉取镜像：

   bash

   docker pull wantcat/trendradar:latest

2. 准备配置文件：

   bash

   mkdir -p config output
   wget https://raw.githubusercontent.com/sansan0/TrendRadar/main/config/config.yaml -O config/config.yaml
   wget https://raw.githubusercontent.com/sansan0/TrendRadar/main/config/frequency_words.txt -O config/frequency_words.txt

3. 编辑配置：修改config/config.yaml和config/frequency_words.txt，设置监控关键词与推送渠道。

4. 运行容器：

   bash

   docker run -d --name trendradar \
     -v ./config:/app/config:ro \
     -v ./output:/app/output \
     -e FEISHU_WEBHOOK_URL="你的飞书webhook" \
     -e DINGTALK_WEBHOOK_URL="你的钉钉webhook" \
     -e WEWORK_WEBHOOK_URL="你的企业微信webhook" \
     -e TELEGRAM_BOT_TOKEN="你的telegram_bot_token" \
     -e TELEGRAM_CHAT_ID="你的telegram_chat_id" \
     -e EMAIL_FROM="你的发件邮箱" \
     -e EMAIL_PASSWORD="你的邮箱密码/授权码" \
     -e EMAIL_TO="收件人邮箱" \
     -e CRON_SCHEDULE="*/30 * * * *" \
     -e RUN_MODE="cron" \
     -e IMMEDIATE_RUN="true" \
     wantcat/trendradar:latest

1. 验证运行：查看容器日志确认正常：

   bash

   docker logs -f trendradar

管理工具：

#检查状态
docker exec -it trendradar python manage.py status
#手动运行
docker exec -it trendradar python manage.py run

成本与性能分析

1. 成本对比

2. 性能对比

3. 优缺点对比

常见问题与解决方案

1. 部署失败

• 问题：GitHub Actions 提示权限 / 配置错误。

• 解决方案：检查仓库Settings→Actions→General，确保勾选“Read and write permissions”；确认 Secret 名称无拼写错误 / 多余空格。

2. 推送失败

• 问题：未收到推送消息。

• 解决方案：

  1. 用curl测试 Webhook 可达性；

  2. 检查推送渠道配置（如企业微信机器人是否开启“自定义关键词”，且内容包含关键词）。

3. 容器异常退出

• 问题：Docker 容器启动后退出。

• 解决方案：

• 验证 YAML 配置语法：

  docker run -it --rm -v ./config:/app/config:ro wantcat/trendradar python -c "import yaml; yaml.safe_load(open('/app/config/config.yaml'))"

  1. 检查挂载目录路径与配置文件是否存在。

总结

• GitHub Pages：适合零成本、快速体验的用户；

• 雨云 Docker：适合追求高性能、长期稳定运行的用户。
  雨云新人优惠与灵活计费可降低成本，TrendRadar 助力实现智能热点监控和推送。