open-xdownload

open-Xdownload是一款本地优先的X/Twitter媒体下载器，内置Web UI和后台任务队列。支持四种任务类型——单篇帖子、用户、列表和关注账号——并提供批量任务、定时计划、增量归档、失败重试以及用于API限速轮换的Cookie池。 核心功能： - 单帖解析与下载：粘贴x.com或twitter.com链接，解析文字、作者和媒体列表，然后下载每张图片、视频或GIF的最佳可用版本。 - 用户媒体归档：通过用户名、@句柄或用户ID归档用户时间线的媒体。 - 列表归档：输入X列表ID以获取成员并归档其媒体。 - 关注账号归档：获取目标关注的账号并归档其媒体。 - 批量任务：一次性输入最多200个目标（用户、列表、关注账号），自动去重。 - 定时计划：将目标保存为可配置间隔（5-43200分钟）的定期归档计划。 - 增量归档：在重复运行时从上次成功位置继续；跳过已下载的媒体。 - 故障处理：部分故障会明确标记；失败帖子进入重试队列，可手动重试或在任务完成时自动重试。 - Cookie池：主Cookie加多个备用组，用于批量归档期间的限速轮换。 - 媒体库：按图片、视频或GIF类别浏览已下载媒体；搜索文件名、媒体URL和帖子ID；懒加载预览支持键盘导航。 - 轻量预览：图片懒加载；视频默认仅加载海报缩略图，仅在放大预览中挂载播放器。 - 本地目录存储：下载目录可通过UI或CLI配置，支持可浏览、可创建的路径。 部署选项： - Docker Compose（推荐）：端口127.0.0.1:8787，数据量和下载量的卷，可配置的PUID/PGID。 - Docker run：相同环境变量，手动调用。 - 二进制文件：从Releases下载；默认监听127.0.0.1:8787，支持可配置的addr、data-dir、web-dir和download-dir参数。 该服务没有内置身份验证，默认绑定到localhost。LAN访问需要将地址显式设置为0.0.0.0:8787并将其放在经过身份验证的反向代理后面。 数据存储在使用SQLite数据库（open-xdownload.db）和本地下载目录中。敏感字段（Cookie）在UI中被屏蔽。备份应同时包含数据库和下载目录。 许可证：MIT。