beck8/subs-check

subs-check Docker 镜像文档

镜像概述和主要用途

subs-check 是一个轻量级工具，用于检查流媒体服务订阅状态是否有效或已过期。该Docker镜像封装了subs-check应用程序，提供了便捷的容器化部署方式，帮助用户快速监控和管理多个流媒体平台的订阅状态。

核心功能和特性

• 多平台支持：支持检查多种主流流媒体服务订阅状态
• 自动验证：自动验证订阅有效性并提供清晰状态报告
• 轻量级设计：资源占用低，部署简单
• 无持久存储需求：无需数据库，配置通过环境变量传递
• 定时检查：支持配置定时检查任务

使用场景和适用范围

• 个人用户管理多个流媒体订阅
• 家庭网络中集中监控所有成员的订阅状态
• 小型企业监控团队共享的流媒体账户
• 作为自动化家庭影院系统的一部分

详细的使用方法和配置说明

环境变量配置

支持的流媒体服务

目前支持以下流媒体服务检查：

• Netflix
• Disney+
• Amazon Prime Video
• Hulu
• HBO Max
• Paramount+
• Apple TV+

Docker部署方案示例

使用docker run部署

bash
docker run -d \
  --name subs-check \
  -e CHECK_INTERVAL=60 \
  -e LOG_LEVEL=INFO \
  -e STREAMING_SERVICES="netflix,disneyplus,primevideo" \
  -e NOTIFICATION_URL="https://your-webhook-url.com" \
  beck8/subs-check:latest

使用docker-compose部署

创建docker-compose.yml文件：

yaml
version: '3.8'

services:
  subs-check:
    image: beck8/subs-check:latest
    container_name: subs-check
    environment:
      - CHECK_INTERVAL=120
      - LOG_LEVEL=INFO
      - STREAMING_SERVICES=netflix,disneyplus,hbo_max
      - NOTIFICATION_URL=https://your-webhook-url.com
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

Kubernetes部署

创建subs-check-deployment.yaml：

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: subs-check
spec:
  replicas: 1
  selector:
    matchLabels:
      app: subs-check
  template:
    metadata:
      labels:
        app: subs-check
    spec:
      containers:
      - name: subs-check
        image: beck8/subs-check:latest
        env:
        - name: CHECK_INTERVAL
          value: "60"
        - name: STREAMING_SERVICES
          value: "netflix,primevideo,hulu"

应用部署：

bash
kubectl apply -f subs-check-deployment.yaml

查看检查结果

查看容器日志获取订阅状态报告：

bash
docker logs subs-check

典型输出示例：

2023-11-15 10:30:00 [INFO] Starting subs-check v1.0.0
2023-11-15 10:30:00 [INFO] Configured services: netflix, disneyplus, primevideo
2023-11-15 10:30:02 [INFO] Netflix: ACTIVE (Expires: 2023-12-10)
2023-11-15 10:30:03 [INFO] Disney+: ACTIVE (Expires: 2023-11-28)
2023-11-15 10:30:04 [INFO] Prime Video: EXPIRED (Expired on: 2023-11-10)
2023-11-15 10:30:04 [INFO] Check completed. Next check in 60 minutes.

故障排除

常见问题解决

1. 服务检查失败

   • 确保流媒体服务名称拼写正确
   • 检查网络连接是否正常
   • 提高日志级别至DEBUG获取详细错误信息

2. 通知未发送

   • 验证NOTIFICATION_URL是否正确
   • 检查目标服务是否接受来自容器的请求

3. 容器无法启动

   • 确保已提供所有必需的环境变量
   • 检查Docker引擎版本是否兼容

维护和更新

更新镜像

bash
docker pull beck8/subs-check:latest
docker restart subs-check

查看状态

bash
docker ps -a --filter "name=subs-check"

停止和删除容器

bash
docker stop subs-check
docker rm subs-check