专为云服务器打造的 轻量级、无污染、无特权 Cloudflare WARP 流媒体解锁网关。
基于 Alpine 3.21 + WGCF + wireguard-go + GOST + unlock.sh 构建,采用 全用户态 WireGuard 网络栈,彻底解耦宿主机 Linux 内核与模块,在完全 非特权(privileged: false) 环境下实现 Netflix、Disney+、ChatGPT 等服务的原生高质量 IP 解锁与本地安全 SOCKS5 代理。
wireguard-go):完全不依赖宿主机 wireguard.ko 内核模块,无需挂载 /lib/modules,无论在 KVM、LXC、OpenVZ 或各大云厂商精简内核 VPS 上皆可 100% 稳定运行。./scripts/warp-unlock.sh(本地修改即时热生效,无需重构镜像);127.0.0.1:40000,外网无法扫描或探测,杜绝被黑客白嫖或充当跳板。[宿主机 (Host)]
Xray / Sing-box / 本地应用 ──► 127.0.0.1:40000 (SOCKS5 入口)
│
▼ (本地回环端口映射)
[warp-unlock 容器内部 (用户态非特权沙箱)]
├── GOST SOCKS5 服务 (:40000)
├── wireguard-go (TUN 用户态网卡)
└── unlock.sh (crond 每5分钟自动巡检刷IP)
│
▼ (WireGuard 隧道加密)
[Cloudflare WARP Anycast 骨干网]
├── Netflix 满血解锁 (Region: SG/US/JP...)
├── Disney+ 绿色通过
└── ChatGPT 正常访问
[容器启动 (执行 setup-unlock.sh)]
│
▼
[第一级: 宿主机挂载优先]
是否挂载了 /scripts/warp-unlock.sh ?
├── [是] ──► 优先载入宿主机脚本 (修改即时生效,免重构镜像)
└── [否] ──► 进入第二级在线拉取
│
▼
[第二级: 在线动态获取]
尝试向 GitLab / GitHub 官方源发起拉取
├── [成功] ──► 载入最新官方版本
└── [失败] ──► 网络受限或离线,触发第三级保底降级
│
▼
[第三级: 镜像保底降级]
自动回退至镜像内置的离线保底脚本 (/app/warp-unlock.fallback.sh)
└── 保证纯离线/断网环境下 100% 成功启动
│
▼
[系统初始化与守护]
生成 /data/warp_unlock.sh 并启动 BusyBox crond 每5分钟定时刷 IP
└── 网关就绪:自动守护流媒体解锁与 SOCKS5 代理
创建 docker-compose.yml:
services:
warp-unlock:
container_name: warp-unlock
image: hausthy/warp-unlock:latest
restart: unless-stopped
init: true
# 用户态 wireguard-go 依赖 /dev/net/tun 虚拟网卡设备
devices:
- /dev/net/tun:/dev/net/tun
# 仅允许网络命名空间管理,完全无特权
cap_add:
- NET_ADMIN
security_opt:
- no-new-privileges:true
# 仅绑定宿主机本地回环,保障网络安全
ports:
- "127.0.0.1:40000:40000/tcp"
environment:
TZ: Asia/Shanghai
WARP_REGION: "sg" # 与机器物理归属地一致,例如 sg, us, jp, hk
UNLOCK_STREAMS: "ndc" # 检测项:n(Netflix)、d(Disney+)、c(ChatGPT)
WARP_FAMILY: "4" # 优选检测 IPv4
WARP_AUTO_SETUP: "1" # 首次连通后自动开启每 5 分钟定时刷 IP
sysctls:
net.ipv6.conf.all.disable_ipv6: "0"
net.ipv6.conf.default.disable_ipv6: "0"
volumes:
- ./config:/etc/wireguard
- ./data:/data
- ./data/cron:/var/spool/cron/crontabs
- ./logs:/logs
- ./scripts:/scripts:ro # 可选:挂载宿主机本地自定义脚本
networks:
- docker-default
networks:
docker-default:
name: docker-default
external: true # 若未提前创建外部网络,可将 external 改为 driver: bridge
启动容器:
docker compose up -d
docker run 一键启动docker run -d \
--name warp-unlock \
--restart unless-stopped \
--device /dev/net/tun:/dev/net/tun \
--cap-add NET_ADMIN \
--security-opt no-new-privileges:true \
-p 127.0.0.1:40000:40000 \
-e TZ=Asia/Shanghai \
-e WARP_REGION=sg \
-e UNLOCK_STREAMS=ndc \
-v $(pwd)/config:/etc/wireguard \
-v $(pwd)/data:/data \
hausthy/warp-unlock:latest
| 变量名 | 默认值 | 说明 |
|---|---|---|
TZ | Asia/Shanghai | 容器时区 |
WARP_REGION | sg | 目标检测地区(建议与云服务器物理机房所在国家一致,如 sg, jp, us) |
UNLOCK_STREAMS | ndc | 检测项目:n (Netflix)、d (Disney+)、c (ChatGPT) |
WARP_FAMILY | 4 | 探测与测试地址族(4 为 IPv4,6 为 IPv6) |
WARP_AUTO_SETUP | 1 | 是否自动开启 5 分钟定时检测刷 IP 守护任务 |
在宿主机终端测试 SOCKS5 代理连通性:
# 查询经过 WARP 后的出口 IPv4
curl --proxy socks5h://127.0.0.1:40000 -4 https://api-ipv4.ip.sb/ip
# 查询经过 WARP 后的出口 IPv6
curl --proxy socks5h://127.0.0.1:40000 https://api-ipv6.ip.sb/ip
# 实时查看流媒体解锁日志
tail -f data/result.log
# 容器一键状态全面诊断
docker compose exec warp-unlock /app/check-status.sh
在远程服务器端分流规则中,将流媒体流量路由至本容器的 127.0.0.1:40000:
config.json){
"outbounds": [
{
"type": "direct",
"tag": "direct"
},
{
"type": "socks",
"tag": "warp-unlock",
"server": "127.0.0.1",
"server_port": 40000
}
],
"route": {
"rules": [
{
"geosite": ["netflix", "disney", "openai"],
"outbound": "warp-unlock"
}
]
}
}
Content type
Image
Digest
sha256:12d2fb38e…
Size
19.3 MB
Last updated
13 days ago
docker pull hausthy/warp-unlock