Skip to content

常见问题解答,欢迎补充

遇到问题请先反思是否完全按照文档操作,并尝试自行解决,如果无法解决,欢迎提问。

更换授权域名/证书后仍然提示授权失败

您可尝试手动刷新证书:

对于 Docker 部署用户,请在程序安装目录下执行:

bash
docker compose exec php-fpm php think clearLicense

对于手动部署用户,请在程序安装目录下执行:

bash
php think clearLicense

人机验证设置错误导致无法登陆

对于 Docker 部署用户,请在程序安装目录下执行:

bash
docker compose exec php-fpm php think disableCaptcha

对于手动部署用户,请在程序安装目录下执行:

bash
php think disableCaptcha

反向代理分享页

location ^~ / 配置块中添加如下配置:

nginx
proxy_ssl_server_name on;

这样可以确保主站域名的 SNI 能被正确传递,避免部分 HTTPS 代理场景下资源加载异常。

此外,还需要在反向代理配置文件末尾添加如下配置,用于静态资源代理:

nginx
location /static/ {
	proxy_pass https://<请填写您的主站域名>;
	proxy_set_header Host <请填写您的主站域名>;
	proxy_ssl_server_name on;
}

请将其中的主站域名替换为您实际使用的主站域名,无需保留尖括号。

使用更改密保功能后提示密保问题错误

请先在账号编辑页查看并尝试使用历史密保

若任务已执行更改,但新密保或生日未同步到网站,可在程序安装目录执行:

bash
docker compose logs --tail 100 backend | grep 账号

在输出中按对应邮箱查找执行时记录的生日与密保问答。

页面加载失败

任务日志出现「页面加载失败」,说明后端没能打开苹果相关页面。先按是否使用代理分流排查:

查看后端日志时,可先筛出相关关键字:

bash
docker compose logs --tail 100 backend | grep -E "IP:|无法获取当前IP|页面加载失败|风控|限流|封禁"

使用了代理:先看获取 IP

任务开始时,后端会通过当前代理查询出口 IP。日志中:

  • 出现 无法获取当前IPIP: Unknown:代理未接通。可在后端所在机器上测试基本通联性:
bash
curl -vvv --proxy "http://用户名:密码@IP:端口" https://ip.sb

若无法返回出口 IP,说明代理地址、账号或网络不通,请先修好代理再执行任务。自行搭建可参考 安装 HTTP 代理

  • 出现 IP: x.x.x.x 但仍加载失败:代理已通,但该出口 IP 可能被苹果限流或封禁。请更换代理,或按 IP 限流与风控 增加冷却后再试。

未使用代理:看是否提示风控

未走代理时,请求直接从后端服务器 IP 发出。请在任务日志或后端日志中确认是否出现:

  • 检测到苹果风控
  • 操作被苹果拒绝,疑似被风控
  • 可能是服务器IP被封禁
  • 请求被限流

若有上述提示,说明当前服务器 IP 已被苹果限制。建议更换原生 / 动态 IP,并保证单个 IP 完成一次任务后至少冷却 10 分钟。选购参考 服务器/代理商家统计表

若没有风控提示,请确认服务器能访问苹果站点(如 https://iforgot.apple.com),并排查防火墙、出站限制等网络问题。