Skip to main content
Several live streaming platforms are geo-restricted and cannot be accessed directly from all regions. DouyinLiveRecorder supports routing HTTP requests and stream downloads through an HTTP/HTTPS proxy on a per-platform basis.
A local proxy client such as Clash, v2ray, or sing-box listening on a local port is the most common setup. The default port for Clash is 7890.

​
Proxy settings in config.ini

All proxy settings live in the [录制设置] section of config/config.ini:
config/config.ini
[录制设置]
; Enable proxy use for configured platforms
是否使用代理ip(是/否) = 是

; Proxy server address and port
代理地址 = 127.0.0.1:7890

; Skip the proxy connectivity check on startup
是否跳过代理检测(是/否) = 否

; Platforms that must use the proxy (comma-separated)
使用代理录制的平台(逗号分隔) = tiktok, sooplive, pandalive, winktv, flextv, popkontv, twitch, liveme, showroom, chzzk, shopee, shp, youtu

; Additional platforms to also route through the proxy
额外使用代理录制的平台(逗号分隔) =

​
Field reference

​
是否使用代理ip
default:"是"
Master switch for proxy support. Set to 否 to disable the proxy globally, even for platforms listed in the proxy platform lists.
​
代理地址
default:""
Address and port of the proxy server in host:port format. Examples:
127.0.0.1:7890
192.168.1.100:1080
HTTP and HTTPS proxies are supported. SOCKS5 proxies are not currently supported directly — use a local client that exposes an HTTP proxy endpoint.
​
是否跳过代理检测
default:"否"
By default, DouyinLiveRecorder tests the proxy connection at startup and warns if the proxy is unreachable. Set to 是 to skip this check — useful when running in environments where the proxy starts after the recorder, or when the check produces false negatives.
​
使用代理录制的平台
Comma-separated list of platform identifiers whose requests will be routed through the proxy. Only platforms in this list (or the extra list below) use the proxy — all others connect directly.Identifiers are matched as substrings of the platform key used internally. The defaults cover all known geo-restricted platforms.
​
额外使用代理录制的平台
default:""
A secondary comma-separated list of additional platform identifiers to also route through the proxy. Use this to add platforms without overwriting the default list.

​
Platforms that require a proxy

The following platforms are geo-restricted and require a proxy when recording from outside their supported regions: The default 使用代理录制的平台 list covers these platforms:
PlatformIdentifier string
TikToktiktok
SOOP (AfreecaTV)sooplive
PandaTVpandalive
WinkTVwinktv
TTingLive (FlexTV)flextv
PopkonTVpopkontv
Twitchtwitch
LiveMeliveme
ShowRoomshowroom
CHZZKchzzk
Shopee Liveshopee, shp
YouTubeyoutu
Additional platforms that may require a proxy but are not in the default list:
PlatformIdentifier string
Faceitfaceit
Picartopicarto
To add these platforms, use 额外使用代理录制的平台 to avoid overwriting the default list.

​
Example: adding a platform to the proxy list

To add Faceit to the proxy without modifying the default list:
config/config.ini
额外使用代理录制的平台(逗号分隔) = faceit
To add multiple extra platforms:
config/config.ini
额外使用代理录制的平台(逗号分隔) = faceit, 17live

Build docs developers (and LLMs) love

Get started for freeTalk to us