UnlockTests

解锁测试模块 (Unlock Tests Module)

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

安装

安装脚本需要 curl 和 wget。脚本会根据当前系统和架构下载 release 中的 ut 二进制文件，并安装到 /usr/bin/ut。

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

示例

# 交互式选择检测项目
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	当前出口被服务方封禁或限制
Failed (Network Error)	网络连接错误
N/A (DNS Resolve Failed)	DNS 解析失败
N/A (No IPv6 Support)	当前 IPv6 检测中，目标域名无 IPv6 支持
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

Thanks

https://github.com/nkeonkeo/MediaUnlockTest

https://github.com/HsukqiLee/MediaUnlockTest

https://github.com/lmc999/RegionRestrictionCheck

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