一、PanCheck介绍

1.1 PanCheck简介

PanCheck 是一个功能强大的网盘链接有效性检测系统，支持批量检测多种主流网盘平台的分享链接是否有效。

1.3 PanCheck主要特性

• 🔍 多平台支持：支持检测 9 种主流网盘平台的链接
• ⚡ 高性能检测：支持并发检测，可配置检测频率和超时时间
• 📊 数据统计：提供详细的检测统计和数据分析
• 🔄 定时任务：支持创建定时检测任务，自动检测链接有效性
• 💾 数据持久化：使用 MySQL 存储检测记录，Redis 缓存失效链接
• 🎨 现代化界面：基于 React + TypeScript 的现代化管理后台
• 🐳 容器化部署：提供 Docker Compose 一键部署方案

1.3 支持的网盘平台

• 夸克网盘
• UC网盘
• 百度网盘
• 天翼云盘
• 123网盘
• 115网盘
• 阿里云盘
• 迅雷云盘
• 中国移动云盘

二、本次实践规划

2.1 本地环境规划

本次实践为个人测试环境，操作系统版本为 Ubuntu 24.04.2 LTS。

2.2 本次实践介绍

1.本次实践部署环境为个人测试环境，生产环境请谨慎；
2.在Docker环境下部署PanCheck网盘链接检测系统。

三、本地环境检查

3.1 检查Docker服务状态

检查Docker服务是否正常运行，确保Docker正常运行。

root@jeven:~# systemctl status docker
● docker.service - Docker Application Container Engine
     Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; preset: enabled)
     Active: active (running) since Tue 2026-01-06 17:39:44 CST; 6h ago
TriggeredBy: ● docker.socket
       Docs: https://docs.docker.com
   Main PID: 1220391 (dockerd)
      Tasks: 50
     Memory: 111.9M (peak: 706.6M swap: 5.2M swap peak: 5.2M)
        CPU: 4min 33.194s
     CGroup: /system.slice/docker.service

3.2 检查Docker版本

检查Docker版本

root@jeven:~# docker -v
Docker version 28.5.0, build 887030f

3.3 检查docker compose 版本

检查Docker compose版本，确保2.0以上版本。

root@jeven:~# docker compose version
Docker Compose version v2.39.4

四、拉取PanCheck镜像

下载PanCheck镜像，执行以下命令：

docker pull lampon/pancheck:latest
docker pull mysql:8.0
docker pull redis:latest

五、部署PanCheck服务

5.1 创建部署目录

• 创建部署目录

mkdir -p /data/pancheck/{mysql,redis}  && cd /data/pancheck

• 目录授权

chmod -R 777 /data/pancheck

5.2 编辑部署文件

新建及编辑docker-compose.yaml文件，宿主机映射端口可自行设置，注意防止端口冲突。

vim docker-compose.yaml

services:
  pancheck:
    image: lampon/pancheck:latest
    container_name: pancheck
    ports:
      - "5200:8080"
    environment:
      - SERVER_PORT=8080 # 服务端口
      - SERVER_MODE=release # 服务模式
      - SERVER_CORS_ORIGINS=* # 跨域请求允许的源
      - DATABASE_TYPE=mysql # 数据库类型
      - DATABASE_HOST=db # 数据库地址
      - DATABASE_PORT=3306 # 数据库端口
      - DATABASE_USER=root # 数据库用户名
      - DATABASE_PASSWORD=pancheck # 数据库密码
      - DATABASE_DATABASE=pancheck # 数据库名称
      - DATABASE_CHARSET=utf8mb4 # 数据库字符集
      - CHECKER_DEFAULT_CONCURRENCY=5 # 默认并发数
      - CHECKER_TIMEOUT=30 # 超时时间（秒）
      - REDIS_ENABLED=true # 是否启用Redis
      - REDIS_HOST=redis # Redis地址
      - REDIS_PORT=6379 # Redis端口
      - REDIS_USERNAME= # Redis用户名
      - REDIS_PASSWORD= # Redis密码
      - REDIS_INVALID_TTL=168   # 失效链接缓存时间（小时）
      - ADMIN_PASSWORD=admin123 # 后台管理密码
    volumes:
      - ./data:/app/data
    restart: unless-stopped
    depends_on:
      - db
      - redis
    healthcheck:
      test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://localhost:8080/api/v1/health"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 40s
      
  db:
    image: mysql:8.0
    container_name: pancheck-db
    environment:
      - MYSQL_ROOT_PASSWORD=pancheck
      - MYSQL_DATABASE=pancheck
      - MYSQL_CHARACTER_SET_SERVER=utf8mb4
      - MYSQL_COLLATION_SERVER=utf8mb4_unicode_ci
    volumes:
      - ./mysql:/var/lib/mysql
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-p$$MYSQL_ROOT_PASSWORD"]
      interval: 10s
      timeout: 5s
      retries: 5
      
  redis:
    image: redis:latest
    container_name: pancheck-redis
    # ports:
    #   - "6379:6379"
    volumes:
      - ./redis:/data
    restart: unless-stopped
    command: redis-server --appendonly yes
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 10s
      timeout: 3s
      retries: 3

5.3 创建PanCheck容器

执行以下命令，创建PanCheck容器。

docker compose up -d

5.4 查看PanCheck容器状态

检查PanCheck容器运行状态，确保PanCheck容器正常启动。

root@jeven:/data/pancheck# docker compose ps
NAME             IMAGE                    COMMAND                   SERVICE    CREATED          STATUS                    PORTS
pancheck         lampon/pancheck:latest   "./main"                  pancheck   36 seconds ago   Up 21 seconds (healthy)   6080/tcp, 0.0.0.0:5200->8080/tcp, [::]:5200->8080/tcp
pancheck-db      mysql:8.0                "docker-entrypoint.s…"   db         36 seconds ago   Up 36 seconds (healthy)   3306/tcp, 33060/tcp
pancheck-redis   redis:latest             "docker-entrypoint.s…"   redis      36 seconds ago   Up 36 seconds (healthy)   6379/tcp

5.5 检查PanCheck容器日志

检查容器运行日志，确保PanCheck服务正常运行。

docker compose logs

六、访问PanCheck服务

6.1 访问PanCheck首页

浏览器地址： http://<个人的服务器IP>:5200，访问PanCheck初始页。如果无法访问，请确保宿主机的防火墙已关闭或已放行相关端口，对于云服务器还需配置相应的安全组规则。

6.2 检测功能

复制网盘的分享链接，点击“开始检测”即可。

七、总结

通过本次实战，我们成功使用 Docker 快速部署了 PanCheck 网盘链接检测工具，实现了对多平台网盘资源可用性的自动化验证。整个部署流程简洁高效，充分体现了容器化应用在环境隔离与快速交付方面的优势。PanCheck 支持主流网盘平台，能够有效识别有效链接，提升资源共享的可靠性与用户体验。未来可结合定时任务或 API 集成，进一步拓展其在自动化运维或内容管理场景中的应用价值。