gallery-dl 订阅星(Subscribestar)下载问题分析与解决方案

问题背景

在使用 gallery-dl 下载 Subscribestar 平台内容时，用户遇到了下载失败的问题，系统提示"Preview image detected"警告。经过分析，这主要涉及 cookie 认证和文件名配置两方面的问题。

核心问题分析

1. Cookie 认证机制

Subscribestar 平台需要有效的 _personalization_id cookie 才能访问付费内容。用户最初尝试通过以下方式配置：

• 使用 cookies.txt 文件
• 直接配置用户名和密码
• 同时使用两种认证方式

经过测试发现，仅使用 cookies.txt 文件时，如果缺少关键 cookie，系统会提示警告。而使用用户名密码登录后，gallery-dl 会自动更新 cookies.txt 文件（需启用 cookies-update 选项）。

2. 文件名配置问题

用户配置的文件名格式为 {filename}_{id[:180]}.{extension}，其中 id[:180] 的写法存在问题。当 id 是数字时，[:180] 切片操作会返回 None，导致所有下载文件都命名为 post_uploads_None.jpg，造成文件覆盖。

解决方案

认证配置建议

推荐使用以下任一认证方式：

1. Cookie 认证：

"subscribestar": {
    "cookies": "/path/to/cookies.txt",
    "cookies-update": true
}

2. 用户名密码认证：

"subscribestar": {
    "username": "your_username",
    "password": "your_password"
}

3. 混合认证（推荐）：

"subscribestar": {
    "username": "your_username",
    "password": "your_password",
    "cookies": "/path/to/cookies.txt",
    "cookies-update": true
}

文件名配置修正

修正后的文件名配置应为：

"filename": "{filename}_{id}.{extension}"

或

"filename": "{filename}_{id!s:[:180]}.{extension}"

技术要点

1. Cookie 更新机制：启用 cookies-update 后，gallery-dl 会将成功登录获取的 cookie 自动写入指定文件，便于后续使用。

2. 字符串格式化：在 Jinja2 模板中，对数字类型直接使用切片操作会返回 None，需要先转换为字符串（使用 !s）。

3. 调试方法：使用 --verbose 参数可以获取详细日志，帮助诊断认证和下载问题。

最佳实践建议

1. 首次使用时建议同时配置用户名密码和 cookie 文件路径，并启用 cookies-update。

2. 定期检查 cookie 文件是否有效，必要时重新登录更新。

3. 对于文件名配置，建议保持简单明了，避免复杂的字符串操作。

4. 更新到最新版本的 gallery-dl 以获取最佳的 Subscribestar 支持。

通过以上配置调整，用户可以稳定地下载 Subscribestar 平台的付费内容，避免预览图片警告和文件覆盖问题。