Gallery-dl社交媒体：Twitter/X内容下载

2026-02-04 05:12:18作者：何举烈Damon

还在为无法批量保存Twitter/X上的精彩内容而烦恼吗？Gallery-dl作为一款强大的命令行下载工具，能够帮你轻松解决这个问题。本文将详细介绍如何使用Gallery-dl高效下载Twitter/X平台的图片、视频和多媒体内容。

为什么选择Gallery-dl下载Twitter/X内容？

传统下载方式的痛点

手动保存效率低下：需要逐一点击保存，无法批量操作
内容完整性难以保证：容易遗漏回复中的媒体内容
元数据丢失：下载后无法保留发布时间、点赞数等关键信息
认证访问限制：私有账户或受保护内容无法访问

Gallery-dl的核心优势

flowchart TD
    A[Twitter/X内容下载需求] --> B{选择下载方案}
    B --> C[传统手动下载]
    B --> D[Gallery-dl自动化]
    
    C --> E[效率低下<br>易遗漏内容<br>元数据丢失]
    D --> F[批量高效下载<br>完整内容抓取<br>元数据保留]
    
    F --> G[支持多种内容类型]
    G --> H[图片]
    G --> I[视频]
    G --> J[推文卡片]
    G --> K[个人资料媒体]

Gallery-dl安装与配置

快速安装指南

Gallery-dl支持多种安装方式，推荐使用pip进行安装：

# 使用pip安装最新稳定版
python3 -m pip install -U gallery-dl

# 或者直接从GitHub安装开发版
python3 -m pip install -U --force-reinstall --no-deps https://github.com/mikf/gallery-dl/archive/master.tar.gz

配置文件设置

创建配置文件 ~/.config/gallery-dl/config.json：

{
    "extractor": {
        "twitter": {
            "username": "你的Twitter用户名",
            "password": "你的密码",
            "retweets": false,
            "replies": true,
            "videos": true,
            "size": "orig"
        }
    },
    "downloader": {
        "timeout": 30,
        "verify": false
    }
}

Twitter/X内容下载实战

1. 用户时间线下载

下载指定用户的所有推文媒体内容：

# 下载用户@username的所有媒体内容
gallery-dl "https://x.com/username"

# 仅下载媒体时间线（不含转推和回复）
gallery-dl "https://x.com/username/media"

# 下载包含回复的时间线
gallery-dl "https://x.com/username/with_replies"

2. 单条推文下载

下载特定推文中的媒体文件：

# 下载单条推文的所有媒体
gallery-dl "https://x.com/username/status/1234567890123456789"

# 获取推文媒体直链（不实际下载）
gallery-dl -g "https://x.com/username/status/1234567890123456789"

3. 高级搜索下载

使用搜索功能批量下载相关内容：

# 搜索特定关键词的推文媒体
gallery-dl "https://x.com/search?q=关键字"

# 搜索特定用户的媒体内容
gallery-dl "https://x.com/search?q=from:用户名 filter:media"

# 搜索带图片的推文
gallery-dl "https://x.com/search?q=关键词 filter:images"

4. 列表和收藏内容下载

# 下载用户收藏的推文媒体
gallery-dl "https://x.com/username/likes"

# 下载列表中的内容
gallery-dl "https://x.com/i/lists/列表ID"

配置文件选项详解

核心配置参数表

参数	类型	默认值	描述
`username`	string	null	Twitter/X用户名
`password`	string	null	Twitter/X密码
`retweets`	boolean	false	是否下载转推内容
`replies`	boolean	true	是否下载回复内容
`videos`	boolean	true	是否下载视频
`size`	string	"orig"	图片尺寸（orig, large, medium, small）
`text-tweets`	boolean	false	是否下载纯文本推文
`pinned`	boolean	false	是否下载置顶推文

文件命名定制

使用格式字符串自定义下载文件的命名：

{
    "extractor": {
        "twitter": {
            "filename": "{tweet_id}_{num}_{date:%Y%m%d}_{user[name]}.{extension}",
            "directory": ["twitter", "{user[name]}", "{date:%Y-%m}"]
        }
    }
}

可用元数据字段：

tweet_id: 推文ID
user[name]: 用户名
user[nick]: 用户昵称
date: 发布时间
favorite_count: 点赞数
retweet_count: 转推数
extension: 文件扩展名

认证与登录配置

用户名密码认证

{
    "extractor": {
        "twitter": {
            "username": "your_username",
            "password": "your_password"
        }
    }
}

Cookie认证（推荐）

{
    "extractor": {
        "twitter": {
            "cookies": ["firefox"]
        }
    }
}

或者使用cookies.txt文件：

{
    "extractor": {
        "twitter": {
            "cookies": "~/.config/gallery-dl/cookies.txt"
        }
    }
}

高级功能与技巧

1. 批量处理脚本

创建自动化下载脚本：

#!/bin/bash
# twitter_downloader.sh

USERS=("user1" "user2" "user3")
SEARCH_TERMS=("keyword1" "keyword2")

for user in "${USERS[@]}"; do
    echo "下载用户 $user 的内容..."
    gallery-dl "https://x.com/$user" -o "base-directory=./downloads/$user/"
done

for term in "${SEARCH_TERMS[@]}"; do
    echo "搜索关键词: $term"
    gallery-dl "https://x.com/search?q=$term" -o "base-directory=./downloads/search/$term/"
done

2. 定时任务设置

使用crontab设置自动下载：

# 每天凌晨2点下载指定用户的新内容
0 2 * * * /usr/bin/gallery-dl "https://x.com/target_user" -o "base-directory=/path/to/downloads"

# 每周一更新搜索内容
0 3 * * 1 /usr/bin/gallery-dl "https://x.com/search?q=weekly_topic" -o "base-directory=/path/to/weekly"

3. 增量下载管理

利用archive功能避免重复下载：

# 使用SQLite存档记录已下载内容
gallery-dl -o "archive=./twitter_archive.sqlite3" "https://x.com/username"

# 后续运行只会下载新内容
gallery-dl -o "archive=./twitter_archive.sqlite3" "https://x.com/username"

常见问题解决方案

1. 登录失败处理

# 检查cookie配置
gallery-dl --cookies-from-browser firefox "https://x.com/username"

# 使用调试模式查看详细错误
gallery-dl -v "https://x.com/username"

2. 速率限制应对

{
    "extractor": {
        "twitter": {
            "sleep": 2,
            "sleep-request": "1.0-2.0",
            "retries": 5,
            "timeout": 30
        }
    }
}

3. 内容过滤设置

{
    "extractor": {
        "twitter": {
            "blacklist": ["sensitive", "nsfw"],
            "whitelist": ["high_quality", "original"]
        }
    }
}

性能优化建议

下载并发控制

{
    "downloader": {
        "threads": 4,
        "chunk-size": 1048576,
        "part": true
    }
}

网络优化配置

{
    "extractor": {
        "twitter": {
            "proxy": "socks5://127.0.0.1:1080",
            "timeout": 60,
            "retries": 3
        }
    }
}