快速开始
配置文件
gallery-dl 的 JSON 配置系统
⚙️ 配置文件
gallery-dl 使用 JSON 格式的配置文件，比命令行参数更灵活。
配置文件位置
%APPDATA%\gallery-dl\config.json
或
%USERPROFILE%\gallery-dl\config.json~/.config/gallery-dl/config.json
或
~/.gallery-dl.conf基础配置模板
{
"extractor": {
"base-directory": "./gallery-dl/",
"archive": "./gallery-dl/archive.sqlite3",
"proxy": null,
"user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:130.0) Gecko/20100101 Firefox/130.0"
},
"downloader": {
"rate": null,
"retries": 4,
"timeout": 30.0,
"part-directory": "/tmp/.gallery-dl/"
},
"output": {
"mode": "auto",
"progress": true,
"log": {
"level": "info",
"format": "{message}"
}
}
}按网站配置
每个网站可以有独立的配置：
{
"extractor": {
"twitter": {
"cookies": {
"auth_token": "YOUR_AUTH_TOKEN"
},
"retweets": false,
"content": true
},
"instagram": {
"cookies": {
"sessionid": "YOUR_SESSION_ID"
},
"stories": true,
"highlights": true
},
"pixiv": {
"username": "YOUR_USERNAME",
"password": "YOUR_PASSWORD"
}
}
}使用指定配置文件
# 使用自定义配置文件
gallery-dl -c /path/to/config.json "URL"
# 忽略配置文件
gallery-dl --config-ignore "URL"归档系统
gallery-dl 内置归档功能，避免重复下载：
{
"extractor": {
"archive": "./gallery-dl/archive.sqlite3"
}
}# 命令行指定归档文件
gallery-dl --download-archive archive.sqlite3 "URL"归档文件使用 SQLite 数据库记录已下载的文件 ID，即使文件被移动或删除也不会重复下载。