UnlockTests

解锁测试模块 (Unlock Tests Module)

用于检测多类流媒体、AI、直播、论坛、游戏平台在当前网络出口下的访问和区域解锁状态。

安装

curl https://raw.githubusercontent.com/oneclickvirt/UnlockTests/main/ut_install.sh -sSf | bash

或使用 CDN 入口：

curl https://cdn.spiritlhl.net/https://raw.githubusercontent.com/oneclickvirt/UnlockTests/main/ut_install.sh -sSf | bash

安装脚本当前支持 Linux、macOS(Darwin)、FreeBSD、OpenBSD 的主流架构。更多构建产物可查看 release 输出：

https://github.com/oneclickvirt/UnlockTests/releases/tag/output

使用

交互式选择检测项目：

ut

在当前目录直接运行二进制：

./ut

查看帮助：

ut -h

Usage: ut [options]
  -I string
        bind IP address or network interface; example: -I 192.168.1.100 or -I eth0
  -L string
        language; specify 'en' for English or 'zh' for Chinese (default "zh")
  -b    use progress bar; to disable, use: -b=false (default true)
  -cache
        enable duplicate test result caching; example: -cache
  -conc uint
        max concurrent tests (0=structured default or legacy unlimited); example: -conc 50
  -dns-servers string
        specify DNS servers; example: -dns-servers "1.1.1.1:53"
  -f string
        specify selection option in menu; example: -f 0
  -h    show help information
  -http-proxy string
        specify HTTP proxy; example: -http-proxy "http://username:[email protected]:1080"
  -log
        enable logging
  -m int
        mode: 0 (both), 4 (only), or 6 (only); default is 0, example: -m 4
  -region string
        select menu groups by number or name (0-22; commas, spaces, or ranges; example: -region 11,21)
  -s    show IP address status; to disable, use: -s=false (default true)
  -socks-proxy string
        specify SOCKS5 proxy; example: -socks-proxy "socks5://username:[email protected]:1080"
  -table
        print compact IPv4/IPv6 result tables
  -test string
        run specific providers by name or function, comma-separated; example: -test "Coze,Poe"
  -timeout duration
        structured/table run timeout (for example 2m)
  -v    show version
  -json
        print structured provider results as JSON
  -structured
        print structured provider results as JSON

检测项目选择

启动后会显示菜单。也可以用 -f 直接指定本项目的兼容菜单编号，多个编号用空格分隔并加引号。

编号	检测范围
`0`	跨国平台
`1` - `9`	跨国平台 + 指定地区平台
`10` - `18`	仅指定地区平台
`19`	仅体育平台
`20`	全部平台
`21`	仅 AI 平台
`22`	仅东南亚平台

地区平台包括台湾、香港、日本、韩国、北美、南美、欧洲、非洲、东南亚和大洋洲。

-region 的数字与本项目交互菜单完全一致：11=仅香港平台、21=仅 AI 平台，名称也可使用，例如 ut -region Globe,hongkong。多个项目可用逗号或空格分隔，例如 ut -region 11,21；连续菜单编号可用范围写法，例如 ut -region 11-18。注意 11-21 会包含菜单项 20（全部平台），因此等价于全平台检测；若只需要香港和 AI，请使用 11,21。-region 不能与 -f 或 -test 同时使用。

单独运行指定平台可使用 -test，多个平台使用半角逗号分隔，例如：

ut -test "Coze,Poe"

命令行参数

基本参数

参数	说明	示例
`-m`	连接模式：0=IPv4 和 IPv6，4=仅 IPv4，6=仅 IPv6	`ut -m 4`
`-I`	绑定本机 IP 地址或网络接口	`ut -I 192.168.1.100` 或 `ut -I eth0`
`-v`	显示版本信息并退出	`ut -v`
`-L`	输出语言：`zh` 或 `en`	`ut -L en`
`-f`	指定菜单编号，多个编号用空格分隔	`ut -f "0 10"`
`-region`	按本项目菜单编号或地区名称选择检测范围，多个值用逗号、空格或数值范围分隔	`ut -region 11,21` 或 `ut -region Globe,hongkong`
`-s`	是否显示本机出口 IP 状态	`ut -s=false`
`-b`	是否使用进度条	`ut -b=false`
`-log`	启用日志记录	`ut -log`

代理和 DNS

参数	说明	示例
`-http-proxy`	设置 HTTP 代理	`ut -http-proxy "http://127.0.0.1:8080"`
`-socks-proxy`	设置 SOCKS5 代理	`ut -socks-proxy "socks5://127.0.0.1:1080"`
`-dns-servers`	指定 DNS 服务器	`ut -dns-servers "1.1.1.1:53"`

执行控制

参数	说明	示例
`-conc`	限制最大并发检测数量，`0` 表示不额外限制	`ut -conc 50`
`-cache`	启用同名检测结果缓存。同一进程内重复执行时可复用结果；组合或全平台检测默认会在发起请求前按名称去重	`ut -cache`
`-timeout`	JSON、structured 或 table 模式的总超时时间	`ut -table -timeout 2m`
`-json` / `-structured`	输出稳定的结构化 JSON 结果（包含 IPv4/IPv6、状态、区域和错误字段）	`ut -json -f 0`
`-table`	输出紧凑的 IPv4/IPv6 六列表格，并保留区域、限制、封禁、超时和限流状态	`ut -table -region 0,11`

环境变量

以下变量用于覆盖源码内置的历史默认参数；未设置时仍沿用默认值以保持旧版行为。部分默认值属于临时授权或签名参数，服务方变更或过期后可通过环境变量替换。

变量	说明
`UNLOCKTESTS_KPLUS_SSO_TOKEN`	覆盖 K+ 检测所需的 SSO token；未设置时沿用内置默认值。
`UNLOCKTESTS_TV360_AUTHORIZATION`	覆盖 TV360 检测所需的 Bearer token；可填写完整 `Bearer ...` 或仅填写 token。
`UNLOCKTESTS_VIDEOMARKET_AUTHORIZATION`	覆盖 VideoMarket 检测所需的 Bearer token；可填写完整 `Bearer ...` 或仅填写 token。
`UNLOCKTESTS_NLZIET_AUTHORIZATION`	覆盖 NLZIET 认证检测所需的 Bearer token；认证检测失败时仍会回退到 CDN 地区检测。
`UNLOCKTESTS_KPLUS_PROVISION_DATA`	覆盖 K+ 检测所需的 provisionData。
`UNLOCKTESTS_NAVERTV_KEY`	覆盖 Naver TV 请求签名密钥。
`UNLOCKTESTS_LEMINO_SERVICE_TOKEN`	覆盖 Lemino 服务 token。
`UNLOCKTESTS_SKYGO_NZ_AUTH_URL`	覆盖 SkyGo NZ fallback 授权 URL。
`UNLOCKTESTS_NEONTV_AUTHORIZATION`	覆盖 Neon TV 检测所需的 Bearer token；可填写完整 `Bearer ...` 或仅填写 token。
`UNLOCKTESTS_CHANNEL5_AUTH`	覆盖 Channel 5 live media auth 参数。
`UNLOCKTESTS_MGMPLUS_API_KEY`	覆盖 MGM+ 会话 API key。
`UNLOCKTESTS_ESPN_SUBJECT_TOKEN`	覆盖 ESPN+ token exchange 的 subject token。
`UNLOCKTESTS_ESPN_AUTHORIZATION`	覆盖 ESPN+ API authorization；可填写完整 `Bearer ...` 或仅填写 token。
`UNLOCKTESTS_LITV_SIGNATURE_KEY`	覆盖 LiTV 旧签名检测 fallback 的签名密钥；默认优先使用新版 RPC 检测。
`UNLOCKTESTS_HBOMAX_VPN_CHECK_ST`	覆盖 HBO Max VPN 二次校验 token。
`UNLOCKTESTS_AETV_VIDEO_META_TOKEN`	覆盖 A&E TV video meta token。
`UNLOCKTESTS_DISNEY_AUTHORIZATION`	覆盖 Disney+ 设备和 token exchange authorization；可填写完整 `Bearer ...` 或仅填写 token。
`UNLOCKTESTS_STARPLUS_AUTHORIZATION`	覆盖 Star+ CDN Relay 二次检测 authorization。
`UNLOCKTESTS_JOYN_API_KEY`	覆盖 Joyn entitlement token API key。
`UNLOCKTESTS_SETANTA_API_KEY`	覆盖 Setanta Sports consent API key。
`UNLOCKTESTS_SDGGGE_TOKEN`	覆盖 SD Gundam G 检测所需 `x-token`。
`UNLOCKTESTS_CATCHPLAY_AUTHORIZATION`	覆盖 CatchPlay+ geo API authorization。
`UNLOCKTESTS_DEEPSEEK_IP`	覆盖 DeepSeek 直连探测端点；可填写 IP、主机名或完整 URL，默认使用 `116.205.40.114`。

示例

# 交互式选择检测项目
ut

# 直接检测跨国平台
ut -f 0

# 检测跨国平台和台湾平台
ut -f "0 10"

# 使用菜单编号，非交互式检测香港和 AI 平台
ut -region 11,21

# 使用地区名称，仅检测东南亚平台
ut -region SoutheastAsia

# 输出紧凑的 IPv4/IPv6 表格
ut -table -region 11,21

# 输出机器可读的 JSON（与 -table 二选一）
ut -json -region 11,21 -timeout 2m

# 仅检测 IPv4
ut -m 4 -f 0

# 仅检测 IPv6
ut -m 6 -f 0

# 使用 HTTP 代理并限制并发
ut -http-proxy "http://127.0.0.1:8080" -conc 20 -f 20

# 使用 SOCKS5 代理、指定 DNS，并关闭进度条
ut -socks-proxy "socks5://127.0.0.1:1080" -dns-servers "1.1.1.1:53" -b=false -f 0

# 绑定网卡
ut -I eth0 -f 0

输出说明

常见结果状态：

状态	含义
`YES`	可访问或可解锁
`NO`	不可解锁
`Restricted`	仅部分内容可用
`Banned`	当前出口被服务方封禁或限制
`TIMEOUT`	单个平台检测超时
`Failed (Network Error)`	网络连接错误
`N/A (DNS Resolve Failed)`	DNS 解析失败
`N/A (No IPv6 Support)`	当前 IPv6 检测中，目标域名无 IPv6 支持
`CDN Relay Available`	检测到 CDN Relay 可用
`Unknown`	响应不符合已知判断逻辑

部分支持区域判断的项目会显示 Region，部分项目会根据 DNS 检测结果标注 Native、Via DNS 或 In Proxy。

卸载

rm -f /usr/bin/ut
rm -f ./ut

在 Go 中使用

go get github.com/oneclickvirt/[email protected]

结构化接口适合在 goecs 等项目中直接调用，支持 context.Context、菜单编号选择、IPv4/IPv6 独立检测和并发上限：

package main

import (
	"context"
	"fmt"
	"time"

	"github.com/oneclickvirt/UnlockTests/executor"
)

func main() {
	ctx, cancel := context.WithTimeout(context.Background(), 2*time.Minute)
	defer cancel()

	results, err := executor.RunStructured(ctx, executor.RunOptions{
		Selection:   "0 10",
		IPVersion:   "ipv6",
		Concurrency: 20,
		UseCache:    true,
	})
	if err != nil {
		fmt.Println("partial result:", err)
	}
	for _, result := range results {
		fmt.Printf("%s %s %s %s\n", result.Name, result.Status, result.Region, result.Info)
	}
}

也可以用 executor.ListPlatforms("0") 先获取指定菜单编号会执行的平台名列表。结构化结果包含 Name、Status、Region、Info、UnlockType 和 Error 字段；旧的 executor.RunTests 字符串输出接口保持兼容。

开发与测试

默认单元测试不访问真实流媒体站点：

go test ./...

各地区目录中的真实解锁探测测试使用 live build tag 隔离，运行时会访问外部服务：

go test -tags live ./...

Thanks

https://github.com/nkeonkeo/MediaUnlockTest

https://github.com/HsukqiLee/MediaUnlockTest

https://github.com/lmc999/RegionRestrictionCheck

https://github.com/betaxab/RegionRestrictionCheck/tree/refactor-1

Name		Name	Last commit message	Last commit date
.github		.github
africa		africa
asia		asia
au		au
ca		ca
ch		ch
cmd		cmd
de		de
es		es
eu		eu
executor		executor
fr		fr
hk		hk
id		id
in		in
it		it
jp		jp
kr		kr
model		model
nl		nl
nz		nz
ru		ru
sg		sg
th		th
transnation		transnation
tw		tw
uk		uk
us		us
utils		utils
vn		vn
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
go.mod		go.mod
go.sum		go.sum
ut_install.sh		ut_install.sh

Navigation Menu

Repository navigation

About

Repository files navigation

UnlockTests

安装

使用

检测项目选择

命令行参数

基本参数

代理和 DNS

执行控制

环境变量

示例

输出说明

卸载

在 Go 中使用

开发与测试

Thanks

About

Releases

Used by

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

UnlockTests

安装

使用

检测项目选择

命令行参数

基本参数

代理和 DNS

执行控制

环境变量

示例

输出说明

卸载

在 Go 中使用

开发与测试

Thanks

About

Topics

Resources

Stars

Watchers

Forks

Releases

Used by

Contributors

Languages