PanCheck 容器化部署：自建网盘链接检测服务全流程

一、PanCheck介绍
- [1.1 PanCheck简介](#1.1 PanCheck简介)
- [1.3 PanCheck主要特性](#1.3 PanCheck主要特性)
- [1.3 支持的网盘平台](#1.3 支持的网盘平台)
二、本次实践规划
- [2.1 本地环境规划](#2.1 本地环境规划)
- [2.2 本次实践介绍](#2.2 本次实践介绍)
三、本地环境检查
- [3.1 检查Docker服务状态](#3.1 检查Docker服务状态)
- [3.2 检查Docker版本](#3.2 检查Docker版本)
- [3.3 检查docker compose 版本](#3.3 检查docker compose 版本)
四、拉取PanCheck镜像
五、部署PanCheck服务
- [5.1 创建部署目录](#5.1 创建部署目录)
- [5.2 编辑部署文件](#5.2 编辑部署文件)
- [5.3 创建PanCheck容器](#5.3 创建PanCheck容器)
- [5.4 查看PanCheck容器状态](#5.4 查看PanCheck容器状态)
- [5.5 检查PanCheck容器日志](#5.5 检查PanCheck容器日志)
六、访问PanCheck服务
- [6.1 访问PanCheck首页](#6.1 访问PanCheck首页)
- [6.2 检测功能](#6.2 检测功能)
七、总结

一、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。

hostname	IP地址	操作系统版本	Docker版本	部署项目	备注
jeven	192.168.3.88	Ubuntu 24.04.2 LTS	28.5.0	PanCheck	------

2.2 本次实践介绍

1.本次实践部署环境为个人测试环境，生产环境请谨慎；

2.在Docker环境下部署PanCheck网盘链接检测系统。

三、本地环境检查

3.1 检查Docker服务状态

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

bash 复制代码

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版本

bash 复制代码

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

3.3 检查docker compose 版本

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

bash 复制代码

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

四、拉取PanCheck镜像

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

bash 复制代码

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

五、部署PanCheck服务

5.1 创建部署目录

bash 复制代码

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

bash 复制代码

chmod -R 777 /data/pancheck

5.2 编辑部署文件

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

bash 复制代码

vim docker-compose.yaml

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容器。

bash 复制代码

docker compose up -d

5.4 查看PanCheck容器状态

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

bash 复制代码

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服务正常运行。

bash 复制代码

docker compose logs

六、访问PanCheck服务

6.1 访问PanCheck首页

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

6.2 检测功能

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

七、总结

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