Star 历史趋势
数据来源: GitHub API · 生成自 Stargazers.cn
README.md

CF + sing-box + 伪装网页的高速 VLESS 节点

一个容器搞定:sing-box(VLESS + WebSocket)藏在一个正经网站后面,前面再套 Cloudflare CDN。

  • 打开域名看到的是一个流浪狗救助站网页(伪装网页),不知道秘密路径的人看不出任何异常;
  • 只有带对路径的 WebSocket 请求才会被转给 sing-box;
  • 流量走 Cloudflare 边缘,客户端还可以填「优选 IP」进一步提速;
  • UUID、路径、端口全部用环境变量配置,不写死在代码里。

⚠️ 开源免费声明:本项目开源免费发布,仅供学习、练习与参考,严禁任何商业使用(包括但不限于收费部署、打包售卖、作为付费服务的一部分、商用引流)。详见 LICENSE。

工作原理

客户端 ──TLS──▶ Cloudflare(橙云代理)──▶ 容器 :3000(Caddy)
                                              ├─ 普通路径 → 伪装站(流浪狗救助主题静态站)
                                              └─ $WS_PATH → 反代到 sing-box (127.0.0.1:10000)
                                                              VLESS + WS 出站直连

环境变量

变量必填默认说明
UUID✅无节点 UUID,自己生成一个(cat /proc/sys/kernel/random/uuid)
WS_PATH/ray秘密路径,务必改成别人猜不到的,如 /a8f3-media-stream
PORT3000容器对外端口(平台要求多少就填多少)

部署方式一:Docker 镜像(平台选「Deploy a Docker image」)

镜像用你自己的——本仓库自带 GitHub Actions 工作流,Fork 后自动打包到你自己的 GHCR,全程不用装 Docker:

  1. 把本仓库 Fork 到你的 GitHub 账号;
  2. 打开你 Fork 的 Actions 页,点一次启用工作流(Fork 的仓库默认禁用 Actions,必须手动开一次);
  3. 选 Build Docker image → Run workflow(或随便推送一次提交),等它跑绿;
  4. 镜像生成在 ghcr.io/<你的用户名>/singbox-cf-node:latest;再到 Packages 里把这个包的可见性改为 Public(部署平台免密拉取需要);
  5. 在部署平台创建应用时填你自己的镜像地址,设置环境变量 UUID、WS_PATH、PORT。

(也可以本地 docker build 后推到任意公共仓库,效果一样。) 3. 记下平台给应用分配的公网地址。

本地自检:

cp .env.example .env   # 填好 UUID
docker compose up -d
curl -I http://127.0.0.1:3000/        # 200,伪装站

部署方式二:上传源码(平台选 Upload / Compose)

把本仓库文件(Dockerfile、Caddyfile、entrypoint.sh、site/、docker-compose.yml)打包上传,平台会按 Dockerfile 构建;同样设置好三个环境变量即可。

Cloudflare 设置(关键)

  1. 域名托管到 Cloudflare,给节点加一条 DNS 记录(如 node.example.com)指向平台给的公网地址,开启橙云代理。
  2. SSL/TLS 模式:
    • 平台只给 HTTP 入口 → 用 Flexible(CF 到源站走 HTTP,先跑通);
    • 平台给源站配了证书 → 用 Full (Strict)(更推荐)。
  3. 确认所选套餐支持 WebSocket(免费版支持,无需额外设置)。

获取节点链接(推荐:取链接页面)

部署成功后,用浏览器打开(后缀就是你的 UUID,它本来就是节点的钥匙,不用再多记一个):

https://<你的地址>/<你的 UUID>

页面会自动拼好完整的节点链接,点 Copy link,再到客户端里选「从剪贴板导入」即可,不用再手工拼参数。不要把这个页面地址发给任何人、不要让它出现在截图和视频里——打开它的人就能拿到完整链接。

手工拼链接(备用):

vless://<UUID>@<你的域名>:443?encryption=none&security=tls&sni=<你的域名>&type=ws&host=<你的域名>&path=<WS_PATH 的 URL 编码>#CF-Singbox

例:WS_PATH 为 /a8f3-media-stream 时 path 填 %2Fa8f3-media-stream。

优选加速:把链接里的地址换成 Cloudflare 优选 IP(域名仍填在 sni/host 里),是这套方案常见的提速手法;稳定性因地区和运营商而异,建议与直连域名各存一条对比实测。

安全与边界

  • UUID 和 WS_PATH 就是全部凭证,泄露等于节点公开;
  • 伪装网页只是「看起来正常」,不提供额外的加密强度;真正的保密来自 TLS + UUID;
  • 请遵守部署平台的服务条款,本项目仅供个人学习与自用;
  • 免费平台的流量/请求额度各不相同,注意控制台的用量提醒。

文件清单

文件作用
Dockerfile单容器镜像:Caddy(前门)+ sing-box(内核)
.github/workflows/打包工作流:Fork 后经 Actions 构建镜像并推到你自己的 GHCR
Caddyfile伪装站 + WS 路径反代规则
entrypoint.sh按环境变量生成 sing-box 配置、取链接页面,并拉起两个进程
sub-template.html取链接页面的模板(运行时按 UUID/路径渲染到秘密后缀下)
site/伪装网页(可换成你自己的静态站)
docker-compose.yml本地/Compose 部署

关于 About

CF + sing-box + decoy-site high-speed VLESS node (single Docker container)

语言 Languages

HTML75.4%
Shell18.7%
Dockerfile6.0%

提交活跃度 Commit Activity

代码提交热力图
过去 52 周的开发活跃度
8
Total Commits
峰值: 8次/周
Less
More

核心贡献者 Contributors