1. 项目概述与核心价值如果你和我一样每天要手动打开十几个网站和App去点签到、领积分、做任务那感觉就像在打一份没有薪水的零工枯燥又容易忘。Sitoi的DailyCheckin项目就是来解决这个痛点的。它是一个用Python编写的自动化签到脚本集合核心目标就一个帮你把那些日复一日的重复性签到任务全部交给程序自动完成。这个项目覆盖了从B站、百度贴吧、阿里云盘到爱奇艺、什么值得买等主流平台的签到甚至还包括了像“i茅台”申购这样的特色任务。它不是一个简单的“一键脚本”而是一个高度可配置、支持多平台部署、具备完善通知机制的自动化系统。你可以把它看作是你的“数字生活助理”每天在后台默默为你收集那些容易被忽略的“数字羊毛”比如云盘空间、会员天数、积分、硬币等等。对于技术爱好者来说它提供了Docker、青龙面板、群晖NAS乃至本地Python运行等多种部署方式可玩性很高。对于普通用户通过简单的配置也能快速上手解放双手。接下来我会结合自己超过半年的实际使用和部署经验从设计思路到避坑指南为你完整拆解这个项目让你不仅能部署成功更能理解其运作原理真正把它变成你得心应手的工具。2. 项目整体设计与架构解析2.1 核心设计哲学配置与执行分离DailyCheckin在设计上遵循了一个非常清晰的哲学配置与执行分离。这是它能够支持如此多平台且易于维护的关键。整个项目可以看作由三大部分构成配置中心 (config.json)这是项目的大脑。所有需要签到的平台账号信息如Cookie、Token、任务开关、通知参数都集中在这里。你不需要去修改代码只需要维护这个配置文件。这种设计的好处是当项目更新、添加新签到模块时你的个人配置不会被覆盖升级变得非常安全。执行引擎 (核心Python脚本)这是项目的心脏。它负责读取配置文件根据配置按顺序调用各个签到平台对应的模块Module。每个平台模块都是一个独立的Python文件里面封装了该平台签到的具体逻辑比如如何模拟登录、如何解析页面、如何提交签到请求等。引擎本身不关心具体业务只负责调度和异常处理。通知模块 (Notifier)这是项目的神经末梢。当所有签到任务执行完毕后无论成功或失败执行引擎会将结果汇总并通过你配置的通知渠道如钉钉、微信、Telegram等发送给你。这样你无需主动查看日志就能对签到情况了如指掌。这种架构使得项目极具扩展性。开发者可以相对独立地开发新平台的签到模块用户也可以灵活地选择启用或禁用某些平台互不干扰。2.2 多平台部署支持的背后逻辑项目之所以支持Docker、青龙面板、群晖、本地运行等多种方式本质上是因为它提供了一个纯净的Python执行环境。我们来分析一下这几种方式的适用场景和底层原理Docker部署这是目前最推荐、最通用的方式。Docker容器提供了一个与宿主机系统隔离的、包含项目所有依赖的标准化运行环境。这意味着无论你的服务器是Ubuntu、CentOS还是群晖DSM只要它能运行Docker你就能以完全相同的方式启动DailyCheckin。它解决了“在我机器上能跑在你机器上就报错”的经典难题。项目提供的docker-compose.yml文件更是简化了容器创建、配置映射和定时任务设置的过程。青龙面板部署青龙面板本身就是一个基于Docker的、专门用于管理定时脚本的平台。将DailyCheckin部署到青龙相当于把它托管给了一个更专业的“任务调度器”。好处是你可以利用青龙面板友好的Web界面来查看日志、修改环境变量、管理依赖并且可以和其他脚本如京东、淘宝等羊毛脚本统一管理。本质上它在青龙容器内部又创建了一个Python环境来运行我们的签到脚本。群晖部署对于拥有群晖NAS的用户这通常意味着通过Docker套件来部署。其本质就是上述Docker部署在群晖图形化界面下的操作实现。群晖的Docker套件提供了便捷的镜像拉取、容器创建和配置管理降低了命令行操作的门槛。本地Python部署这种方式最直接适合喜欢刨根问底或进行二次开发的用户。你需要在本地安装Python3.6环境然后通过pip安装项目依赖最后直接运行python3 main.py。这种方式调试起来最方便但需要自己解决环境依赖和定时执行如用crontab的问题。选择建议如果你是新手或追求省心稳定首选Docker部署。如果你已经是青龙面板的用户希望集中管理所有脚本那么集成到青龙面板是更优选择。本地部署更适合开发调试。3. 核心配置详解与实操要点配置文件config.json是项目的灵魂也是新手最容易出错的地方。下面我将分模块进行深度解析。3.1 账户配置以B站和阿里云盘为例账户配置都在config.json的USER_CONFIG部分。每个平台可能需要不同的认证信息最常见的是Cookie。1. B站 (BILIBILI) 配置解析BILIBILI: { ENABLE: true, USERNAME: 你的B站登录手机号/邮箱, PASSWORD: 你的B站密码, BILI_COOKIE: { SESSDATA: 你的SESSDATA值, bili_jct: 你的bili_jct值, DedeUserID: 你的DedeUserID值 }, SCKEY: , MULTI_ACCOUNTS: [] }为什么需要Cookie现代网站普遍采用Cookie来维持用户的登录状态。直接使用账号密码模拟登录不仅复杂要处理验证码、加密而且容易被风控。使用已登录状态的Cookie是更稳定、更安全的方式。如何获取Cookie在Chrome浏览器中登录B站网页版。按F12打开开发者工具切换到Application(应用) 标签页。在左侧Storage-Cookies-https://www.bilibili.com下找到SESSDATA、bili_jct、DedeUserID这三个键将其对应的Value值复制出来填入配置即可。MULTI_ACCOUNTS这是一个高级功能用于支持多账号。你可以在此数组中填入多个Cookie对象脚本会遍历执行所有账号的签到。格式如下MULTI_ACCOUNTS: [ {SESSDATA: 账号1的SESSDATA, bili_jct: ..., DedeUserID: ...}, {SESSDATA: 账号2的SESSDATA, bili_jct: ..., DedeUserID: ...} ]2. 阿里云盘 (ALIYUNDRIVE) 配置解析ALIYUNDRIVE: { ENABLE: true, refreshToken: 你的refresh_token }为什么是refreshToken而不是Cookie阿里云盘使用了基于OAuth 2.0的令牌认证机制。refresh_token是一种可以用于获取新的访问令牌(access_token)的长期凭证比短期的access_token更适合自动化场景。如何获取refresh_token登录阿里云盘网页版。按F12进入Application-Local Storage-https://www.aliyundrive.com。在存储的数据中查找token相关的项。一个更可靠的方法是在Network(网络) 标签页中刷新页面找到任意一个接口请求在其Request Headers(请求头) 中寻找Authorization: Bearer ...这串Bearer后面的就是refresh_token很长的一串。或者网上有开源的阿里云盘令牌获取页面可以更直观地获取。重要注意事项Cookie/Token安全这些信息等同于你的账号密码务必妥善保管不要泄露给他人或上传到公开的代码仓库。定期更新Cookie和Token都有有效期。B站Cookie可能几周后失效阿里云盘的refresh_token相对长效但也可能因安全策略变更而失效。如果签到突然失败首先应检查并更新这些凭证。先手动验证在填入配置前可以尝试用获取到的Cookie在浏览器的无痕模式下访问对应网站看是否处于登录状态以验证Cookie有效性。3.2 通知配置让结果主动找你签到结果通知至关重要。项目支持十多种通知方式这里以最常用的Server酱 Turbo版微信通知和钉钉群机器人为例。1. Server酱 Turbo版配置NOTIFICATION: { ENABLE: true, SCKEY: 你的SendKey, TYPE: sct }原理Server酱是一个消息推送服务。你注册后会获得一个唯一的SendKey。脚本执行后会将签到结果通过HTTP请求发送到Server酱的服务器Server酱再转发消息到你的微信。操作步骤访问sct.ftqq.com用GitHub登录并注册。在“钥匙”页面你会看到SendKey复制它。在config.json中将NOTIFICATION下的SCKEY值替换为你的SendKey并确保TYPE是sct(Turbo版)。用微信扫描网站提供的二维码绑定微信接收通道。优点配置简单微信接收方便。2. 钉钉群机器人配置NOTIFICATION: { ENABLE: true, DINGTALK: { ACCESS_TOKEN: 你的access_token, SECRET: 你的签名密钥加签时才有 } }原理在钉钉群内添加一个自定义机器人钉钉会提供一个Webhook地址其中包含access_token。脚本将消息以特定格式POST到这个地址机器人就会在群里发送消息。操作步骤在钉钉群内点击“群设置” - “智能群助手” - “添加机器人” - “自定义”。设置机器人名字安全设置选择“加签”或“自定义关键词”。强烈建议使用“加签”更安全。创建完成后会得到Webhook地址格式如https://oapi.dingtalk.com/robot/send?access_tokenXXXXXX。其中的XXXXXX就是ACCESS_TOKEN。如果选择了“加签”还会得到一个SECRET值也需要填入配置。优点适合团队共享状态消息格式更丰富支持Markdown。通知配置心得多通知备份你可以在配置中同时启用多个通知渠道如同时配置SCKEY和DINGTALK脚本会向所有启用的渠道发送消息防止某个服务不稳定导致收不到通知。消息模板项目内置的消息模板已经比较清晰会汇总成功和失败的任务。如果你有编程能力甚至可以修改通知模块的代码定制更符合自己阅读习惯的消息格式。4. 实战部署以Docker方式为例理论讲完我们进入实战。Docker部署是兼容性最好的方式下面我将一步步带你完成。4.1 环境准备与配置文件创建首先确保你的服务器或电脑已经安装了Docker和Docker Compose。可以通过docker --version和docker-compose --version命令检查。然后我们需要准备配置文件。不建议直接修改项目内的config.json而是通过“卷映射”的方式在宿主机上维护自己的配置文件。创建项目目录mkdir -p ~/dailycheckin/config cd ~/dailycheckin获取默认配置文件 你可以从项目的GitHub仓库 (https://github.com/Sitoi/dailycheckin) 下载最新的config.json文件放到~/dailycheckin/config/目录下。 更简单的方法是先运行一次容器让它生成默认配置然后复制出来修改docker run --rm -it sitoi/dailycheckin:latest /dev/null 21 || true # 这条命令会因缺少配置而报错退出但会在容器内生成默认配置。我们需要将其复制出来。 # 首先找到刚才临时容器的ID或名称 docker ps -a | grep dailycheckin # 假设容器ID是 abc123将其配置文件复制到宿主机 docker cp abc123:/dailycheckin/config.json ~/dailycheckin/config/config.json # 删除临时容器 docker rm abc123现在你可以在~/dailycheckin/config/config.json中尽情修改你的账户和通知配置了。4.2 使用Docker Compose一键部署Docker Compose通过一个YAML文件定义和管理多容器应用对于DailyCheckin这种单一服务它能简化运行和定时任务的配置。在~/dailycheckin/目录下创建docker-compose.yml文件version: 3 services: dailycheckin: image: sitoi/dailycheckin:latest container_name: dailycheckin restart: unless-stopped volumes: - ./config/config.json:/dailycheckin/config.json:ro # 映射配置文件只读 - ./logs:/dailycheckin/logs # 映射日志目录方便查看 environment: - TZAsia/Shanghai # 设置容器时区非常重要 command: [python, main.py] # 容器启动时执行的命令关键参数解析restart: unless-stopped确保容器在异常退出或宿主机重启后能自动重启保证服务高可用。volumes这是核心配置。- ./config/config.json:/dailycheckin/config.json:ro将宿主机刚修改好的配置文件映射到容器内的对应路径。:ro表示只读防止容器意外修改你的配置。- ./logs:/dailycheckin/logs将容器内的日志目录映射出来这样你可以在宿主机上直接查看~/dailycheckin/logs/下的日志文件。TZAsia/Shanghai必须设置否则容器内的时间可能是UTC导致定时任务在错误的时间执行。现在使用以下命令启动容器cd ~/dailycheckin docker-compose up -d-d参数表示后台运行。使用docker-compose logs -f可以实时查看日志检查是否有报错。4.3 配置定时任务Cron Job容器启动后默认只会执行一次签到。我们需要配置定时任务让它每天自动执行。有两种主流方法方法一使用宿主机的Crontab推荐这种方法更直观利用宿主机系统的cron服务来调度Docker容器的执行。编辑宿主机的crontabcrontab -e在末尾添加一行例如设定每天上午9点15分执行15 9 * * * cd /home/yourusername/dailycheckin /usr/local/bin/docker-compose run --rm dailycheckin /dev/null 2115 9 * * *cron表达式表示每天9点15分。cd ...切换到你的项目目录。docker-compose run --rm运行一个一次性容器执行命令执行完毕后自动清理容器 (--rm)。这比重启常驻容器更干净。 /dev/null 21将输出重定向到空设备避免cron发送邮件。如果你需要记录日志可以改为 /home/yourusername/dailycheckin/cron.log 21。方法二在容器内部使用Cron修改docker-compose.yml在容器内安装并运行cron服务。这种方式更“容器化”但配置稍复杂且查看日志不如方法一方便。定时任务设置心得避开高峰将签到时间设置在凌晨或清晨如3点-7点避免网络拥堵也减少对目标服务器的人为压力是良好的“薅羊毛”礼仪。随机延迟如果你有多个类似脚本可以在cron命令里加一个随机睡眠sleep $(($RANDOM \% 300))让执行时间有些随机性进一步降低模式化风险。测试命令在配置cron前先在命令行手动执行一遍docker-compose run --rm dailycheckin确保一切正常。5. 高级技巧与故障排查实录即使按照教程一步步来在实际运行中也可能遇到各种问题。下面是我在长期使用中积累的一些经验和常见问题的解决方法。5.1 多账号管理与环境变量配置对于需要管理多个平台、多个账号的复杂场景将所有配置硬编码在config.json里会显得臃肿且不安全尤其是考虑将配置纳入Git版本管理时。更优雅的方式是使用环境变量。DailyCheckin支持通过环境变量覆盖config.json中的配置。例如对于B站的多账号你可以在docker-compose.yml中这样配置environment: - TZAsia/Shanghai - BILIBILI_MULTI_ACCOUNTS[{SESSDATA: 账号1Cookie}, {SESSDATA: 账号2Cookie}] - ALIYUNDRIVE_REFRESHTOKEN你的refresh_token环境变量的命名规则通常是平台名_配置项且全部大写。你可以查阅项目的.env.example文件或源码来确认支持的变量名。更安全的做法将敏感信息存放在单独的.env文件中并在docker-compose.yml中引用创建~/dailycheckin/.env文件BILIBILI_MULTI_ACCOUNTS[{SESSDATA: xxx}, {SESSDATA: yyy}] ALIYUNDRIVE_REFRESHTOKENzzz修改docker-compose.ymlenv_file: - .env # 引入环境变量文件 environment: - TZAsia/Shanghai记得将.env文件加入.gitignore避免泄露。5.2 常见错误排查指南当签到失败时不要慌张按以下步骤排查问题现象可能原因排查步骤与解决方案所有任务都失败日志显示网络错误1. 容器无法连接外网。2. 宿主机网络问题。3. DNS解析失败。1. 进入容器docker exec -it dailycheckin sh执行ping www.baidu.com测试网络。2. 检查宿主机的防火墙或安全组设置是否放行了容器流量。3. 在docker-compose.yml中为容器配置宿主机的DNSdns: 114.114.114.114。某个特定平台签到失败如B站1. Cookie/Token已过期。2. 平台更新了签到接口或反爬策略。3. 账号被风控短时间内请求过多。1.首要检查按3.1节方法重新获取并更新Cookie/Token。2. 查看项目GitHub的Issues页面看是否有其他人报告相同问题或脚本有更新。3. 暂时关闭该平台签到 (ENABLE: false)24小时后再试。可以考虑在cron中为该平台单独设置更随机的执行时间。通知收不到1. 通知配置错误KEY/TOKEN填错。2. 通知服务商问题如Server酱服务波动。3. 脚本执行出错未进入通知发送流程。1. 仔细核对SCKEY、ACCESS_TOKEN等配置确保没有多余空格。2. 手动测试通知渠道。例如对于钉钉机器人可以用curl命令模拟发送一条消息看是否成功。3. 查看详细日志docker-compose logs dailycheckin关注执行末尾是否有“开始发送通知”和“通知发送成功”的日志。如果没有说明前面执行就出错了。定时任务不执行1. 宿主机时间/时区不对。2. Crontab语法错误或命令路径问题。3. Docker Compose命令需要sudo权限但cron默认环境无。1. 执行date命令确认宿主机时间。确保容器内时区TZ设置正确。2. 在cron的那一行命令先在命令行手动执行看能否成功。3. 如果docker命令需要sudo有几种方案① 将用户加入docker组sudo usermod -aG docker $USER② 在cron中使用sudo并配置NOPASSWD③ 改用root用户的crontab。推荐方案①。日志显示“未找到配置文件”配置文件映射路径错误或权限不足。1. 检查docker-compose.yml中volumes映射的宿主机路径是否正确。2. 检查宿主机上的config.json文件是否存在且Docker进程有权限读取通常用户自己的文件没问题。3. 可以进入容器内部查看docker exec dailycheckin cat /dailycheckin/config.json。5.3 维护与更新策略一个健康的自动化系统需要定期维护。更新Docker镜像项目作者会定期更新镜像修复bug或添加新平台。你可以使用以下命令更新cd ~/dailycheckin docker-compose pull # 拉取最新镜像 docker-compose down # 停止并删除旧容器 docker-compose up -d # 用新镜像启动新容器由于配置文件是通过卷映射挂载的所以更新容器不会影响你的个人配置。关注项目动态在GitHub上Star项目并偶尔查看一下Release页面或Issues页面。这能帮你及时了解某个平台签到失效是否已被修复或者是否有重要的更新通知。定期检查日志不需要每天看但可以每周或每半个月扫一眼日志文件 (~/dailycheckin/logs/)看看有没有持续失败的任务及时处理。备份配置文件你的config.json和.env文件是核心资产。建议将其备份到安全的私有位置如密码管理器、私有Git仓库。经过以上步骤你应该已经拥有了一个稳定、自动化的每日签到系统。它就像一台设置好的数字收割机在后台静静工作而你只需要偶尔检查一下粮仓通知消息是否满溢。技术的乐趣就在于用自动化解决重复劳动把时间留给更有价值的事情。如果在部署过程中遇到上面没覆盖到的问题最好的去处就是项目的GitHub Issues页面那里通常有来自社区的热心解答。