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=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:password@127.0.0.1:1080"
  -log
        enable logging
  -m int
        mode: 0 (both), 4 (only), or 6 (only); default is 0, example: -m 4
  -s    show IP address status; to disable, use: -s=false (default true)
  -socks-proxy string
        specify SOCKS5 proxy; example: -socks-proxy "socks5://username:password@127.0.0.1:1080"
  -v    show version

检测项目选择

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

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

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

命令行参数

基本参数

参数	说明	示例
-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"
-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

环境变量

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

变量	说明
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 签名密钥。
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。

示例

# 交互式选择检测项目
ut

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

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

# 仅检测 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/UnlockTests@v0.0.36-20260602072908

结构化接口适合在 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