配置文件
重要
请详细的阅读本章节,它将会帮助你快速上手 F2
配置文件与操作。
主配置文件
F2
配置文件由三部分组成,应用低频配置文件(app.yaml)
,F2配置文件(conf.yaml)
,应用默认配置文件(defaults.yaml)
。
什么是yaml?
用类似大纲的缩进方式呈现数据序列化的格式文件,what is yaml?。
应用低频配置文件(app.yaml):用来保存所有应用不常变动的配置,例如的cookie
、文件名模板
、下载路径
、连接超时时间
、超时重试次数
等。
F2配置文件(conf.yaml):用来保存F2
的配置,例如不同应用的计算参数
和代理
。
应用默认配置文件(defaults.yaml):用来保存各个app的初始化默认配置模板,。
douyin:
cookie:
naming: '{create}_{desc}'
path: Download
timeout: 10
max_retries: 5
lyric: yes
max_connections: 5
max_counts: 0
max_tasks: 10
page_counts: 20
tiktok:
cookie:
max_connections: 5
max_counts: 0
max_retries: 5
max_tasks: 5
naming: '{create}_{desc}'
page_counts: 5
path: Download
timeout: 10
twitter:
path: Download
folderize: yes
mode: one
naming: '{create}_{desc}'
cookie:
interval: all
timeout: 10
max_retries: 5
max_connections: 5
max_counts: 0
max_tasks: 5
page_counts: 20
weibo:
path: Download
folderize: yes
mode: post
naming: '{create}_{desc}'
cookie:
interval: all
timeout: 10
max_retries: 5
max_connections: 5
max_counts: 0
max_tasks: 5
page_counts: 20
f2:
version: "0.0.1.6"
show_update: true
douyin:
encryption: ab
BaseRequestModel:
version:
code: "190500"
name: "19.5.0"
browser:
language: zh-CN
platform: Win32
name: Edge
version: "122.0.0.0"
engine:
name: Blink
version: "122.0.0.0"
os:
name: Windows
version: "10"
BaseLiveModel:
language: zh-CN
browser:
language: zh-CN
platform: Win32
name: Edge
version: "119.0.0.0"
headers:
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36 Edg/126.0.0.0
Referer: https://www.douyin.com/
proxies:
http://:
https://:
msToken:
url: https://mssdk.bytedance.com/web/report
magic: 538969122
version: 1
dataType: 8
strData: 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
ttwid:
url: https://ttwid.bytedance.com/ttwid/union/register/
data: '{"region":"cn","aid":1768,"needFid":false,"service":"www.ixigua.com","migrate_info":{"ticket":"","source":"node"},"cbUrlProtocol":"https","union":true}'
webid:
url: https://mcs.zijieapi.com/webid?aid=6383&sdk_version=5.1.18_zip&device_platform=web
body:
app_id: 6383
referer: https://www.douyin.com/
url: https://www.douyin.com/
user_agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36 Edg/126.0.0.0
user_unique_id: ""
tiktok:
BaseRequestModel:
browser:
language: zh-CN
name: Mozilla
platform: Win32
version: 5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36
device:
id: "7377772863376426514"
platform: web_pc
os: windows
region: SG
priority_region: ""
webcast_language: zh-Hans
tz_name: Asia/Hong_Kong
headers:
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36
Referer: https://www.tiktok.com/
proxies:
http://:
https://:
msToken:
url: https://mssdk-sg.tiktok.com/web/common?msToken=QnC7zMMh1cpaDTxHDHnabNOrqaWv49JwA1IAq3AIFvrdaqQi8Rs_YlXSya1vN-4b6C1MgpWpS2cL1oakaUEDe3pUDMLpCbdSc3b3V98Fux0AuwXn_9Ns3FyMTnFRmSOOOVeGg6bVXMSGoMG6dq3k
url2: https://mssdk-sg.tiktok.com/web/report?msToken=QnC7zMMh1cpaDTxHDHnabNOrqaWv49JwA1IAq3AIFvrdaqQi8Rs_YlXSya1vN-4b6C1MgpWpS2cL1oakaUEDe3pUDMLpCbdSc3b3V98Fux0AuwXn_9Ns3FyMTnFRmSOOOVeGg6bVXMSGoMG6dq3k
magic: 538969122
version: 1
dataType: 8
strData: 3g+ZrAO5JQgfqCRzb689RAbiueodAexjAjn2plyPVBdOArbRM66UOTnZPoVTDDw8GZ8TL/CO13bWedlvWSA8kCODHA6mjO1Af5hgak+1NHbb8EvfuahWFDL8x8hruWn4t6qb79DhOy64REx1nsO6ub4SX4cKdgs+ZXTjUItB2WKddXo7CKikuywT8SJ0TcwZ+z/9hSsawqJXawopS5H8bOF0o3qPn+CwkoWkXBUu4iwkI5UzL9/k18Gwq1BxAiCbyl2kCHJaox7md1H+KfQ0lU9fBhfVBuXa3jNkT5GfyASaBNeJXdhHwuPfEGI6a+4FOaO0MEGzOWDzhu6joo89ooEPo1XV+UJE2KLC5tStxSBibUvn+wZSfGmcpPfYl0jB0H2vLqyaveYraOx8WRE/G/Y9DkbBLJvz7E8sDZ/v1fCUVs1JDDewE/yn2aqOHr3NxUjOnylKl5WWSCPeSR4ZTXRR1ZJhvpGKP7XYc3tkOjBSQ70cXnl53dAQ6aouUVMcztSlkXh4goI46tgJDjTiJJILHBr03dM/1KwVzqoEEO8f7JBhfQo4OR6Y48PXomshJmZhDiEmtkqLndpZY2I/B8q0EShuPlDCFRW7iob6kFahyqDfpOmK15kzCX2n7eu7zqDGgpJuHEtULF9803lR5QBt104ET49RbnDJ+ipbz1bFvS2FJQ2rfktNlwjqdBT8UzfFPHyZk6z4cSxYIfPRj1lB8fDwTwv3PUSRxUZSwkuGoZbc6j/6hxwZaY0xxIEbb9DlOmQZY4qyiqSziZ8HGWsQ9uD95dO4lX6GlZaeh7mKsjLSKSdUt13YeGAciqjTvSPyO/pZ5xc3+i+5hY4A290/JiTmIyFBOrRrlmIhPEQe9OEJn0DPXYgliYUO1nljEi6q/4HMFdXFmlw6nC8/kL9EeinisX7g6PbdHuRcKONXZpXxBevL8xD5Z8SvFKH/uQmYHrJlybiKHjDIMq7vc59NBw2VDQBmRqa8NTh2XLwIryjoBIHuNSBngSZwJE==
ttwid:
url: https://www.tiktok.com/ttwid/check/
data: '{"aid":1988,"service":"www.tiktok.com","union":false,"unionHost":"","needFid":false,"fid":"","migrate_priority":0}'
cookie: ttwid=1%7C3uOVjidbOFBmdS6Aci5oeBb8Ta-HWpeyp2dvhl2Ib2E%7C1716637053%7C462867ee452aecd60a854225b854ff4498e9b99c13d4826a3e2a4e58a4c55134;
odin_tt:
url: https://www.tiktok.com/passport/web/account/info/?WebIdLastTime=1716637053&aid=1459&app_language=zh-Hans&app_name=tiktok_web&browser_language=zh-CN&browser_name=Mozilla&browser_online=true&browser_platform=Win32&browser_version=5.0%20%28Windows%20NT%2010.0%3B%20Win64%3B%20x64%29%20AppleWebKit%2F537.36%20%28KHTML%2C%20like%20Gecko%29%20Chrome%2F124.0.0.0%20Safari%2F537.36&channel=tiktok_web&cookie_enabled=true&device_id=7372899909097571857&device_platform=web_pc&focus_state=true&from_page=fyp&history_len=2&is_fullscreen=false&is_page_visible=true&odinId=7372898697492972561&os=windows&priority_region=&referer=®ion=SG&screen_height=1080&screen_width=1920&tz_name=Asia%2FHong_Kong&webcast_language=zh-Hans
twitter:
headers:
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36 Edg/126.0.0.0
Referer: https://twitter.com/
Authorization: Bearer AAAAAAAAAAAAAAAAAAAAANRILgAAAAAAnNwIzUejRCOuH5E6I8xnZz4puTs%3D1Zv7ttfk8LF81IUq16cHjhLTvJu4FA33AGWWjCpTnA
X-Csrf-Token: ""
proxies:
http://:
https://:
weibo:
headers:
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/121.0.0.0 Safari/537.36 Edg/121.0.0.0
Referer: https://weibo.com/
proxies:
http://:
https://:
visitor:
url: https://passport.weibo.com/visitor/genvisitor2
cb: visitor_gray_callback
tid:
from: weibo
douyin:
url:
music:
lyric:
cover:
desc:
path:
folderize:
mode:
naming:
cookie:
interval:
timeout:
max_retries:
max_connections:
max_counts:
max_tasks:
page_counts:
languages:
tiktok:
url:
music:
cover:
desc:
path:
folderize:
mode:
naming:
cookie:
keyword:
interval:
timeout:
max_connections:
max_counts:
max_retries:
max_tasks:
page_counts:
languages:
weibo:
url:
path:
folderize:
mode:
naming:
cookie:
keyword:
interval:
timeout:
max_retries:
max_connections:
max_counts:
max_tasks:
page_counts:
languages:
x:
url:
path:
folderize:
mode:
naming:
cookie:
interval:
timeout:
max_retries:
max_connections:
max_counts:
max_tasks:
page_counts:
languages:
高低频参数分离意味着当创建的自定义配置文件比较多的情况下无需修改每一个自定义配置文件中的cookie
,只需要修改应用低频配置文件(app.yaml) 中的cookie
即可。
将高频修改的参数主页链接
、下载模式
等,设置在你的自定义配置中,即可灵活调用下载不同用户的不同类型作品。
如何初始化配置文件?请查阅初始化配置文件。
如何配置cookie?请查阅配置cookie。
F2 支持多用户个性化配置文件,请按照自定义配置文件来进行配置。
如果你已经知悉如何使用配置文件,那么可以跳过该章查看进阶用法。
初始化配置文件
查看目前支持的应用列表
$ f2 -h
F2
安装完成后,第一步就是运行应用的初始化配置文件命令:
$ f2 apps --init-config my_apps.yaml
$ f2 apps --init-config my_apps.yaml
$ f2 apps --init-config my_apps.yaml
my_apps.yaml
就是该应用的自定义配置文件。
迎接你的将是几个简单的问题:
完整的应用名和简写名都支持吗?
是的,完整的应用名和简名都支持。例如:douyin
与dy
、tiktok
与tk
。
$ f2 dy --init-config dy.yaml
与
$ f2 douyin --init-config dy.yaml
配置文件支持相对路径吗?
配置文件路径支持绝对
与相对
路径。初始化配置文件是强制覆盖,不会自动备份
。
找不到主配置文件?
请查阅配置文件的位置。
自定义配置文件
由于 F2
的配置文件采用高低频参数分离式设计,这意味着你可以为相同的应用
设置不同的配置文件
。你可以只设置一个参数在自定义配置文件中,也可以设置你需要高频修改的参数。
多用户灵活配置
举个例子,我关注了3个用户。其中有A的主页作品、B的喜欢页作品、C的直播。那么我可以为每个用户配置一个专属的配置文件。
在 F2
中,先把应用低频配置文件(app.yaml) 中cookie
与其他你需要设置的参数配置好。再在其他目录下建立A、B、C用户的专属配置文件,只需配置上低频中没有设置的参数。如下面2个高频参数
所示,为不同用户所需的下载模式。
douyin:
# 浩子
url: https://www.douyin.com/user/MS4wLjABAAAAu8qwDm1-muGuMhZZ-tVzyPVWlUxIbQRNJN_9k83OhWU?vid=7263127189829307659
# 主页作品
mode: post
douyin:
# 小布丁
url: https://www.douyin.com/user/MS4wLjABAAAA35iXl5qqCbLKY99pUvxkXzvpSXi8jgUbJ0zR4EuTpcHcS8PHaEb6G9yB6iKR0dNl?vid=7240082457372937511
# 喜欢作品
mode: like
douyin:
# 醒子8ke
url: https://live.douyin.com/775841227732
# 直播模式
mode: live
说明
只是举例,实际上用户B的喜欢页没有开放,用户C也不一定直播,一切根据你的喜好来设置,do ever what you want。
随后你便可以开启终端,并直接输入自定义配置文件路径即可一键下载,剩下的低频参数会自动合并,无需担心。
$ f2 dy -c X:\A.yaml
$ f2 dy -c X:\B.yaml
$ f2 dy -c X:\C.yaml
是不是非常方便且容易管理🤭,你可以随时添加喜欢的用户配置文件并设置你所需的下载模式。
配置优先级
CLI
参数优先级最高,自定义配置文件
优先级次之,应用低频配置文件(app.yaml)
优先级最低。CLI
>自定义配置文件
>应用低频配置文件(app.yaml)
。- 高频参数会覆盖低频参数,未设置的参数不会被覆盖。
- 要想了解更多的
CLI
参数,请查阅CLI 参考。
配置cookie
通过简单的配置,用户与开发者就可以立马上手 F2
。只需通过 --update-config
命令就可以保存cookie
到主配置文件或者使用--auto-cookie
命令自动从浏览器获取。
$ f2 dy -k "从浏览器中复制的cookie" -c app.yaml --update-config
$ f2 dy -c app.yaml --auto-cookie edge
当然不想出错就手动复制浏览器中的cookie
,然后使用--update-config
命令保存到主配置文件中。手动复制的操作百度一下就可以了。
重要
- 更新配置文件的同时将会在同目录里备份原配置文件,备份文件名为
*.yaml.bak
,方便回滚。 - 如果
--auto-cookie
不指定-c
参数,将直接保存至低频配置文件(app.yaml) 中。 cookie
也可以保存到自定义的配置文件中。随你的使用习惯,小白请严格按照文档的说明来操作。--update-config
命令与--auto-cookie
命令会覆盖主配置文件中的cookie
,请谨慎使用。--update-config
命令需要指定-c
参数,否则会报错。
配置文件的位置
你可以在x:\xxxxxxx\Python\Lib\site-packages\f2\conf\
文件夹中找到它们。
提示
如果找不到配置文件夹路径可以在终端输入
$ pip show f2
$ pip3 show f2
$ pip3 show f2
然后查看Location,并在该目录下找到配置文件。
下一步是什么?
- 更多 CLI 命令的详细信息,请查阅 CLI 参考。