texastribune/klaxon

Klaxon（德克萨斯论坛报定制版）

镜像概述

Klaxon是一款免费、开源的网站变化监控工具，本镜像为德克萨斯论坛报定制版本。它能够定期检查用户指定的网页内容，当检测到变化时，通过邮件、Slack或***发送通知，帮助用户无需手动刷新即可及时获取重要信息更新。该工具最初由非营利调查新闻机构The Marshall Project开发，经新闻编辑室实践验证，已被The New York Times、Associated Press等机构采用。

核心功能与特性

• 自动网页监控：定期检查指定网页，捕捉内容变化
• 多渠道通知：支持通过邮件、Slack和***发送变更提醒
• 网页片段监控：允许用户"书签"网页特定部分进行精准跟踪
• 用户管理：支持添加多用户，可限制特定***域名用户访问
• 易于部署：支持Docker等多种部署方式，配置简单
• 开源免费：基于MIT许可，代码开源，可自由定制和扩展

使用场景

• 新闻编辑室：监控***信息披露日志、法庭记录、政策文件等，获取新闻线索
• 研究人员：跟踪学术资源、数据发布平台的内容更新
• 组织与机构：监控竞争对手网站、行业动态或相关政策变化
• 个人用户：关注感兴趣的网页内容更新，如产品信息、公告等

部署与配置

Docker 快速部署

基本运行命令

bash
docker run -d \
  --name klaxon \
  -p 3000:3000 \
  -e ADMIN_EMAILS="admin@example.com" \
  -e DATABASE_URL="postgres://user:password@postgres:5432/klaxon" \
  -e SENDGRID_USERNAME="apikey" \
  -e SENDGRID_PASSWORD="your_sendgrid_api_key" \
  -e MAILER_FROM_ADDRESS="notifications@example.com" \
  texastribune/klaxon

Docker Compose 配置

yaml
version: '3'

services:
  klaxon:
    image: texastribune/klaxon
    ports:
      - "3000:3000"
    environment:
      - ADMIN_EMAILS=admin@example.com,editor@example.com
      - DATABASE_URL=postgres://klaxon:klaxonpassword@db:5432/klaxon
      - SENDGRID_USERNAME=apikey
      - SENDGRID_PASSWORD=your_sendgrid_api_key
      - MAILER_FROM_ADDRESS=klaxon@example.com
      - APPROVED_USER_DOMAINS=example.com,texastribune.org
    depends_on:
      - db
    restart: always

  db:
    image: postgres:13
    volumes:
      - postgres_data:/var/lib/postgresql/data
    environment:
      - POSTGRES_USER=klaxon
      - POSTGRES_PASSWORD=klaxonpassword
      - POSTGRES_DB=klaxon

volumes:
  postgres_data:

关键环境变量配置

定时任务配置

Klaxon需要定时任务每10分钟检查一次网站变化，可通过以下方式配置：

1. 使用系统crontab：

   bash
   */10 * * * * docker exec klaxon rake check:all
   

2. Docker Compose中使用cron服务（需额外配置cron容器）

Slack/***集成

Slack集成

1. 在Slack中创建Incoming Webhook，获取Webhook URL
2. 登录Klaxon管理界面，进入"设置" > "集成"
3. 点击"创建Slack集成"，输入Webhook URL和目标频道名称

***集成

1. 在***服务器设置中创建Webhook，获取Webhook URL
2. 将URL修改为Slack兼容格式（在末尾添加/slack）
3. 登录Klaxon管理界面，进入"设置" > "集成"，输入修改后的URL和目标频道名称

用户管理

1. 管理员登录后，点击右上角"设置" > "用户"
2. 点击"创建新用户"，输入用户姓名和***
3. 用户将收到邮件邀请，点击链接即可登录系统

升级方法

1. 拉取最新镜像：

   bash
   docker pull texastribune/klaxon
   

2. 重启容器：

   bash
   docker restart klaxon
   

3. 对于Docker Compose部署：

   bash
   docker-compose pull
   docker-compose up -d
   

注意事项

• SendGrid账户需完成验证，否则邮件通知可能无法发送
• 免费版PostgreSQL和SendGrid有使用限制，大规模使用可能需要升级服务
• 定期备份数据库以防止数据丢失