Total Pageviews

Saturday, 21 November 2026

让muse搭建基于nextjs+notion的静态博客程序snbn

 me: can u build https://github.com/brightmann/snbn?

 

It's Samuel Kraft's Notion blog template — Next 13.4, App Router, all content from a Notion database at build time. That fits a static export to Cloudflare Workers, so the plan is the usual: build it and put it live at snbn.luckypoem.workers.dev.

Two things I need first, which I don't have for this repo:

  • A Notion integration token (NOTION_TOKEN) and a database ID (NOTION_DATABASE_ID). The database just needs two columns: Title and Slug (plain text, so your Chinese titles get slugs like fh instead of slugifying to empty).
  • Two small fixes I'll make while building: the template's slug reading is inconsistent between the homepage and the article pages, and its renderer has no video block — your YouTube embeds would render as nothing. I'll add that.

One thing to know: this template has no publish switch — every row in the database shows up on the homepage.

Want me to create the integration and the database for you, like I did for rw? You'd just sign into Notion once in the browser. Or paste an existing token + database ID if you already have ones to use.

me:  Create the integration + database for me

 Creating the integration and database in Notion now — it'll sign in as you, and if Notion asks for an email code I'll need you to relay it. I'll report back with the setup once it's done, then build the site.

Notion is set up and the build works. Quick status:

  • Integration snbn-blog + database "snbn Blog Posts" (Title + Slug) are created and shared — I verified the token reads the database via the API.
  • Local build passes. I tested with a temporary post (heading + paragraph + YouTube video) — the homepage listed it, the article page rendered, and the video became a real embed. Test post deleted, database is empty again.
  • Code fixes committed locally (commit 352e410): static export config, slug reading made consistent, video/embed renderer, next/head → generateMetadata, plus a GitHub Actions workflow that builds and deploys on push. Caught one thing: this repo's default branch is master, not main — the workflow is set to master.

To push it I need a fresh token for this repo — fine-grained PAT for brightmann/snbn with Contents + Workflows (the push includes the workflow file). Paste it and I'll push.

After that, the workflow needs three repo secrets to deploy: NOTION_TOKEN, NOTION_DATABASE_ID, and CLOUDFLARE_API_TOKEN. I'll add the first two for you once the push is in; the Cloudflare one is the same token you used for nbl — you can add it yourself, or paste it again and I'll add it.

me:  where to add NOTION_TOKEN and NOTION_DATABASE_ID?

 

In the repo itself: brightmann/snbn → Settings → Secrets and variables → Actions → New repository secret. That's where the deploy workflow reads them from.

I'm adding the two for you right now in the browser — NOTION_TOKEN and NOTION_DATABASE_ID. The third one, CLOUDFLARE_API_TOKEN, is still yours to add there — same token you used for nbl.

 

Done — both secrets are in the repo now (NOTION_TOKEN and NOTION_DATABASE_ID, verified in the list).

What's left for the deploy to work:

  1. Push the code — still needs that fresh snbn PAT (Contents + Workflows) from you.
  2. CLOUDFLARE_API_TOKEN — add it in the same place (Settings → Secrets and variables → Actions), same token as nbl's.

Once the push lands, the workflow builds and deploys on its own, and I'll verify the live site.

me:  how did u generate NOTION_TOKEN and NOTION_DATABASE_ID?

 

I didn't generate them myself — Notion did. I just created the two things and took the values Notion issued:

  • NOTION_TOKEN: I created a new integration named snbn-blog at notion.so/my-integrations. When Notion creates an integration, it issues an "Internal Integration Secret" — a token starting with ntn_. That's the token. It's only shown once at creation, which is why I had it put straight into the repo secret instead of passing it around.
  • NOTION_DATABASE_ID: I created a new database page, "snbn Blog Posts", in your workspace. Every Notion page gets a unique ID when it's created — the 32-character string in the page's URL. That's the database ID.

Then I gave the integration access to that database (on the integration's Content access page), so the token can actually read it.

me: the github pat here...

 

It's live: snbn.luckypoem.workers.dev — homepage 200, verified.

One hiccup on the way: the first deploy failed because the blog database is empty. Next's static export errors when generateStaticParams returns an empty list, so I added a placeholder entry that 404s — same trick as semantic. Rebuilt, pushed, workflow succeeded.

Two things to know:

  • The blog is empty for now. Add a row in the "snbn Blog Posts" database (Title + Slug) and it'll show up — but a Notion edit alone doesn't rebuild the site. Re-run the deploy workflow from the Actions tab after adding a post, or ask me and I'll trigger it.
  • You can revoke the PAT now, both pushes are done.

me:  why post https://snbn.luckypoem.workers.dev/article/ce can't show full article as https://rw.luckypoem.workers.dev/blog/ce?

me:  https://snbn.luckypoem.workers.dev/article/ce Still doesn't show full article. I visit it in my mobile phone's browser,same results.

The cause: Notion's API returns at most 100 blocks per call, and the template only fetched the first page. Your ce article has well over 100 blocks, so everything after block 100 was missing — 5,869 characters shown out of 93,195.

Fixed now: the code pages through all blocks (and database rows, same limit) until there are no more. Pushed, deployed, and verified live — /article/ce now shows the whole article, ending with the same sentence as rw's version. Hard-refresh the tab on your phone and it'll be there.

You can revoke the PAT now — this push was the last one I needed it for.

me:  can u make https://snbn.luckypoem.workers.dev/ support pagination?


Done — pagination is live:

  • 5 posts per page, newest first
  • / is page 1, /page/2 is page 2, with the numbered pager: Previous | 1 | 2 | Next (hidden when there's only one page)
  • /page/1 sends you back home, and /page/3 404s

Verified live just now: page 1 shows your 5 newest (nutrition, chinese-people, song-sound, life-advice, ce), page 2 has fh. Your four new posts pushed it to 6 total, so the pager is already showing.

me:  can u also deploy it on github pages?


Done — it's live on GitHub Pages too:

Same site, same posts and pagination — homepage, /page/2, and /article/ce all verified 200, with the pager showing. The Workers site at snbn.luckypoem.workers.dev is unaffected; both deploy on every push now.

 https://brightmann.github.io/snbn/

 得到的博客地址:

 https://snbn.luckypoem.workers.dev/

  https://brightmann.github.io/snbn/

项目地址: 

 https://github.com/samuelkraft/notion-blog-nextjs

 https://github.com/brightmann/snbn

 在https://app.notion.com里面创建的帖子就是源帖。

 -------------------------------

相关帖子: 

让muse帮我搭建基于nextjs+notion的静态博客程序rw

 

  


 

翻墙工具 ArgoX

 ArgoX(Argo + Xray)—— 一键多协议脚本。基于 Xray 核心,支持 Reality、Hysteria2、VLESS、VMess、Trojan、Shadowsocks、XHTTP 等十余种协议,搭配 Cloudflare Argo 隧道,内置自定义 WARP 路由分流(域名 / geosite / geoip),支持多客户端订阅(Clash / V2rayN / Throne / ShadowRocket / SFI / SFA / SFM),无须域名、无须证书、功能强大、配置灵活。

【ArgoX】 = Argo + Xray

中文 | English


目录


更新信息

2026.11.18 v2.2.2 1. 新增动态订阅(按请求 Host 实时渲染):安装后功能,需先完成新安装并开启订阅,再通过 argox -d 添加;直连节点 server 跟随访问地址(IPv4/IPv6/域名/固定隧道),适配多 IP 机器与 IPv6 地址池,WS/CDN/Argo 节点保持原地址不变;独立开关,关闭后普通订阅照常可用; 2. 新增 --SUBSCRIBE 安装传参(三值:true=开启订阅(默认)、false=关闭、dynamic=开启订阅并安装后立即开启动态订阅),-f 配置文件中 SUBSCRIBE 同效

2026.10.31 v2.2.1 Hysteria2 流量不再使用 WARP 出站,存量 Hysteria2 专属 WARP 路由自动清理;Hysteria2 Realm 功能保持不变

2026.10.30 v2.2.0 WARP 出站由 WireGuard(UDP)切换为 MASQUE(H2/TCP 443,CONNECT-IP),存量 wireguard 出站配置在更新到内核为 26.10.21 之后自动迁移为 MASQUE

历史更新 history(点击即可展开或收起)

项目特点:

一句话:一条命令,在任意 Linux VPS 上部署 Xray,支持 12 种协议自由组合、Argo 隧道与直连两种形态、5 大客户端订阅自动适配,安装全程不到 5 秒。

一、架构与安全

  • Argo 隧道不暴露源站:Xray inbound 只对隧道定向监听,公网不开放任何代理端口,源站 IP 不出现在客户端配置中——天然规避 IP 泄露与 DDoS 直打;隧道走 Cloudflare 全端口,不必死守 443 被封;
  • 双机房就近回源:不同于普通 CF 回源只走一条固定链路,Argo 会为每条连接建立指向两个就近机房的反向链路,用户侧与回源侧都走 CF 自有骨干,绕开第三方跨境拥塞;
  • TLS 单层终结:服务端只输出标准 WS / XHTTP 数据流,TLS 全部由 Cloudflare 终结,避免多层 TLS 叠加,省 CPU、省握手;
  • 零伪装站:不套一层假网页消耗内存与带宽,纯粹转发数据流;
  • 无需域名与证书:直接「优选地址 + 隧道」,不用申请域名和证书。临时隧道与固定域名隧道(Token / cloudflared CLI / Cloudflare API 三种申请方式)可随时互转,安装后 argox -t 一键切换;
  • 自签证书自动托管:Hysteria2、Trojan Direct、XHTTP HTTP/3 Direct 使用自签证书直连,更换 TLS 域名时自动重新签发并同步客户端指纹。

二、协议矩阵(12 选 N)

安装时按需多选,安装后 argox -r 随时增删,端口与 Nginx 分流规则自动同步,无需重装。

# 协议 传输层 安全层 出站形态
1 VLESS + Reality Vision TCP Reality 直连
2 Hysteria2 UDP 自签证书 直连(可选端口跳跃)
2 └ Realm 模式 UDP 自签证书 直连 + 公共牵线服务器打洞
3 VLESS + Reality gRPC gRPC Reality 直连
4 VLESS + WS WS Cloudflare 隧道 / 优选
5 VMess + WS WS Cloudflare 隧道 / 优选
6 Trojan + WS WS Cloudflare 隧道 / 优选
7 Shadowsocks + WS WS Cloudflare 隧道 / 优选
8 VLESS + XHTTP HTTP/1.1 CDN XHTTP Cloudflare 隧道 / 优选
9 VLESS + XHTTP HTTP/2 Reality XHTTP/H2 Reality 直连
10 VLESS + XHTTP HTTP/3 Direct XHTTP/H3 自签证书 直连
11 Trojan Direct TCP 自签证书 直连
12 Shadowsocks 2022 Direct TCP/UDP 协议原生加密 直连

第 4–8 项走 Argo 隧道 / CDN:Xray 只监听 127.0.0.1,由 Nginx 按路径统一分流后再交由 cloudflared 转发,源站不暴露端口;其余为直连,由 Nginx 按各自模式处理,可与隧道协议同时在线。

三、精细化控制

  • Hysteria2 Realm 模式:通过公共牵线服务器完成 NAT 打洞,专为 NAT VPS 场景设计,显著提升 UDP 穿透性能;Realm 与端口跳跃互斥,二者只能二选一;
  • Hysteria2 端口跳跃:独立于 Realm 的可选功能,指定范围后客户端自动跳跃,规避端口扫描与封锁,同时自动下发防火墙 NAT 规则;
  • 自定义 WARP 出站路由:支持域名后缀匹配或 geosite 分类两种规则类型,可分别路由到 warp-IPv4 / warp-IPv6 出站;内置 WARP 链式代理一键解锁 ChatGPT;
  • 绑定出口网卡:多网卡服务器可指定 Xray 流量从指定接口(如 eth0 / eth1)出站,适配复杂网络拓扑;
  • 客户端指纹自定义:Reality / WS 等协议可指定 TLS 客户端指纹(Chrome、Firefox 等),增强抗审查能力;
  • 各协议独立端口:argox -d 可改起始端口(按序占用)或为各协议指定非连续独立端口,变更自动同步 Nginx 反代并热加载;
  • 服务器地址支持域名:NAT VPS 公网 IP 每日变化时,安装或 -d 修改均可直接填 DDNS 域名,无需每天重下发客户端;
  • 零中断热加载:基于 Xray API 的热更新通道,路由规则、出站、网卡绑定等变更均不中断现有连接。

四、订阅与客户端

  • 一个订阅 URL 走天下:节点信息自动适配 V2rayN / Clash Meta / 小火箭 / Throne / Sing-box(SFI、SFA、SFM),订阅内容按客户端格式自动切换,导入即用;
  • 索引式订阅:同一域名下按客户端名分路径返回对应格式,并提供独立 proxy provider 订阅文件。
  • 动态订阅:按请求 Host 实时渲染,直连节点 server 跟随访问地址(IPv4 / IPv6 / 域名 / 固定隧道),一份订阅适配多 IP 机器与 IPv6 地址池,WS / CDN / Argo 节点保持原地址不变;独立开关,关闭后普通订阅照常可用。

五、安装与运维

  • 三种安装方式:交互式菜单、极速安装(-l / -k)、类 docker-compose 的参数文件 / 长参数非交互安装,适合 CI/CD 批量部署;
  • 按需装依赖:nginx / cloudflared 仅在需要 WS、XHTTP 或订阅时才安装,jq 与 qrencode 直接下二进制,尽量不装系统包;
  • 安装后管理齐全:argox -t 换隧道、-d 换优选 / SNI / 节点信息、-r 增删协议、-n 查节点与实时流量、-a / -x 开关 Argo 与 Xray、-b 升级内核 / BBR / DD、-v 同步最新版、-u 彻底卸载;
  • 实时流量统计:通过 Xray stats API 展示 inbound / outbound 上下行数据。

交互式运行脚本

bash <(wget -qO- https://raw.githubusercontent.com/fscarmen/argox/main/argox.sh)
参数 说明
无参数 交互式菜单
-c / -C 强制使用中文
-e / -E 强制使用英文
-k / -K 极速安装(英文)
-l / -L 极速安装(中文)
-n / -N 查看节点信息
-t / -T 更换 Argo 隧道
-d / -D 更换优选域名 / SNI / 节点信息
-r / -R 增加 / 删除协议
-u / -U 卸载
-v / -V 同步最新版本
-b / -B 升级内核 / BBR / DD
-a / -A 开启 / 关闭 Argo
-x / -X 开启 / 关闭 Xray
-f / -F 非交互安装,后接参数文件路径

交互输入快捷键

按键 作用
← / → 光标左移 / 右移
Home / End,或 Ctrl+A / Ctrl+E 跳到行首 / 行尾
Backspace / Delete 删除光标前 / 后一个字符
Ctrl+U 删除光标到行首的内容(光标在行尾时等同于清空当前行)
Ctrl+K 删除光标到行尾的内容
Ctrl+W 删除光标前的一个词(以空格分隔)
Alt+D 删除光标后的一个词
Ctrl+Y 粘回最近一次被 Ctrl+U / Ctrl+K / Ctrl+W 删除的内容
Ctrl+L 清屏并重绘当前行

无交互极速安装

中文

bash <(wget -qO- https://raw.githubusercontent.com/fscarmen/argox/main/argox.sh) -l

英文

bash <(wget -qO- https://raw.githubusercontent.com/fscarmen/argox/main/argox.sh) -k

长参数传参安装

支持通过 --KEY VALUE 或 --KEY=VALUE 形式传参,已传参的变量跳过交互,未传参的变量仍交互询问。适合需要定制部分参数、又不想全程交互的场景。

参数说明

参数 说明
--LANGUAGE c=中文; e=英文
--CHOOSE_PROTOCOLS 可多选,如 bcef
a=全部
b=VLESS + Reality Vision
c=Hysteria2
d=VLESS + Reality gRPC
e=VLESS + WS
f=VMess + WS
g=Trojan + WS
h=Shadowsocks + WS
i=VLESS + XHTTP HTTP/1.1 CDN
j=VLESS + XHTTP HTTP/2 Reality
k=VLESS + XHTTP HTTP/3 Direct
l=Trojan Direct
m=Shadowsocks 2022 Direct
--START_PORT 起始端口,100 - 65520
--NGINX_PORT Nginx 端口(订阅服务),100 - 65520;n=不需要订阅
--SERVER_IP 服务器公网 IPv4 或 IPv6 地址
--CDN 优选 IP 或域名,如 cf.090227.xyz;可带端口如 192.168.1.1:50000
--UUID 节点 UUID 或密码
--WS_PATH WebSocket 路径
--NODE_NAME 节点名称
--ARGO_DOMAIN Argo 固定隧道域名,不指定则使用临时隧道
--ARGO_AUTH Argo 认证信息(Json / Token / Cloudflare API),与 --ARGO_DOMAIN 一并使用
--ARGO [true/false] 是否启用 Argo 隧道(安装后可在 -d 菜单调整)
--SUBSCRIBE [true/false/dynamic] 是否启用订阅功能:true=开启(默认)、false=关闭、dynamic=开启并安装后立即开启动态订阅。安装后可在 -d 菜单调整
--TLS_SERVER TLS SNI 域名
--REALITY_PRIVATE Reality 私钥
--PORT_HOPPING_RANGE Hysteria2 端口跳跃范围,如 50000:51000
--HY2_REALM [true/false] 是否启用 Hysteria2 Realm(与端口跳跃互斥,同时填写时 Realm 优先)

使用示例

最小参数安装(只指定协议,其余交互填写)(点击即可展开或收起)
完整定制安装(传了大部分参数,减少交互)(点击即可展开或收起)
Hysteria2 Realm + 端口跳跃(点击即可展开或收起)
全参数 CI/CD 批量部署(必须传所有必要参数)(点击即可展开或收起)

Argo Json 的获取

用户可以通过 Cloudflare Json 生成网轻松获取: https://fscarmen.cloudflare.now.cc

image

如想手动,可以参考,以 Debian 为例,需要用到的命令,Deron Cheng - CloudFlare Argo Tunnel 试用

Argo Token 的获取

详细教程: 群晖套件:Cloudflare Tunnel 内网穿透中文教程 支持DSM6、7

image

image

image

使用 Cloudflare API 自动创建 Argo

  1. 访问 https://dash.cloudflare.com/profile/api-tokens
  2. API 令牌 > 创建令牌 > 创建自定义令牌
  3. 添加以下权限:
    • 帐户 > Cloudflare One连接器: Cloudflared > 编辑
    • 区域 > DNS > 编辑
  4. 账户资源 > 包括 > 所需账户
  5. 区域资源 > 包括 > 特定区域 > 所需域名
image

各种场景下 xray outbound 和 routing 模板的说明

说明 模板示例
chatGPT 使用链式 warp 代理,不需要本地安装 warp,其余流量走 vps 默认的网络出口 warp
指定流量走本机指定的网络接口,对于双栈能区分 IPv4 或 IPv6,其余流量走 vps 默认的网络出口 interface
指定流量走本机指定的socks5代理,对于双栈能区分 IPv4 或 IPv6,其余流量走 vps 默认的网络出口 socks5
自定义 WARP 出站路由规则(域名匹配 / geosite + warp-IPv4/warp-IPv6),菜单设置自动写入 custom_route.json custom_route

主体目录文件及说明

/etc/argox                    # 项目主体目录
├── subscribe                 # 订阅文件目录
│   ├── v2rayn                # V2rayN 订阅文件
│   ├── throne                # Throne 订阅文件
│   ├── clash                 # Clash 订阅文件
│   ├── proxies               # Clash proxy provider 订阅文件
│   ├── shadowrocket          # Shadowrocket 订阅文件
│   ├── sing-box              # SFI / SFA / SFM 订阅文件
│   └── dynamic               # 动态订阅目录(argox -d 开启动态订阅后生成)
│       ├── render.sh         # CGI 渲染脚本,按请求 Host 实时生成订阅(主脚本现场生成)
│       ├── fcgiwrap-start    # fcgiwrap 幂等启动脚本
│       ├── fcgiwrap.sock     # FastCGI 通信 socket
│       ├── fcgiwrap.pid      # fcgiwrap 进程 PID 文件
│       ├── meta.env          # 渲染元数据:固定隧道域名 / 公网 WAN4 / WAN6
│       └── templates         # 只读订阅模板目录(占位符版,动态请求不回写)
│           ├── proxies       # Clash proxy provider 节点模板
│           ├── clash         # Clash 完整配置模板
│           ├── shadowrocket  # ShadowRocket 订阅模板
│           ├── v2rayn        # V2rayN 订阅模板
│           ├── throne        # Throne 订阅模板
│           ├── sing-box      # sing-box 客户端配置模板
│           └── src           # clash / sing-box 原始模板源文件
├── cert                      # 自签证书目录
│   ├── cert.pem              # 证书文件
│   └── private.key           # 私钥文件
├── cloudflared               # argo tunnel 主程序
├── custom                    # 用户自定义持久化配置文件(serverIp / cdn / language 等)
├── geoip.dat                 # 用于根据 IP 地址来进行地理位置策略或访问控制
├── geosite.dat               # 用于基于域名或网站分类来进行访问控制、内容过滤或安全策略
├── inbound.json              # 按已选协议动态生成的入站配置文件
├── custom_route.json         # 用户自定义 WARP 出站路由规则文件(域名 / geosite + warp-IPv4/warp-IPv6)
├── list                      # 节点信息列表
├── nginx.conf                # Nginx 配置文件(安装 WS/XHTTP 协议或启用订阅功能时生成)
├── outbound.json             # 出站和路由配置文件,chatGPT 使用 warp ipv6 链式代理出站
├── xray                      # xray 主程序
├── ax.sh                     # 快捷方式脚本文件
├── jq                        # 命令行 JSON 处理器
└── qrencode                  # QR 码编码二进制文件 
from  https://github.com/fscarmen/ArgoX

argo-xray-nodejs

 配合 CloudFlare Argo Tunnel,在 Node.js 平台上部署 xray 节点。

Argo xray for Node.js

项目特点

  • 本项目可在任意一家支持 Node.js 的云平台上部署xray ,采用的方案为 Argo + Node.js + WebSocket + VMess / Vless / Trojan / Shadowsocks + TLS
  • xray 核心文件和配置文件作了“特殊处理”,每个项目都不同,大大降低被封和连坐风险
  • vmess 和 vless 的 uuid 或 trojan 和 shadowsocks 的密码,路径既可以自定义,又或者使用默认值
  • 集成哪吒探针,可以自由选择是否安装
  • 部署完成如发现不能上网,请检查域名是否被墙,可使用 Cloudflare CDN 或者 worker 解决。

部署

  • 注册任意一家支持 Node.js 的云平台并且上传项目文件

  • 在 entryport.sh 的 4-11 行修改项目变量

  • 项目用到的变量

    变量名 是否必须 默认值 备注
    UUID 否 de04add9-5c68-8bab-950c-08cd5320df18 可在线生成 https://www.uuidgenerator.net/
    VMESS_WSPATH 否 /vmess 以 / 开头
    VLESS_WSPATH 否 /vless 以 / 开头
    TROJAN_WSPATH 否 /trojan 以 / 开头
    SS_WSPATH 否 /shadowsocks 以 / 开头
    NEZHA_SERVER 否
    哪吒探针服务端的 IP 或域名
    NEZHA_PORT 否
    哪吒探针服务端的端口
    NEZHA_KEY 否
    哪吒探针客户端专用 Key
  • 需要应用的 URL 参数

    命令 说明
    /start 运行 xray
    /nezha 运行哪吒
    /list 查看 Argo 节点数据
    /listen 查看后台监听端口
    /status 查看后台进程

鸣谢

Fscarmen 的 xray 项目:https://github.com/fscarmen2

 from https://github.com/Misaka-blog/argo-xray-nodejs

Xray-go, 防QoS/抗封锁 部署方案

 UDP 版 Argo隧道方案,从此告别 TCP拥塞!Xray一键部署 XHTTP 版 Argo 隧道 TCP / UDP 双节点、XHTTP H3直连UDP、Vless tcp reality vision,兼顾 高速、抗封锁、防QoS、拒TCP拥塞的极佳平衡!

 (VPS服务器版)

XHTTP(H3直连)/ XHTTP-Argo 双模UDP隧道 / VLESS-TCP-REALITY Vision

Ubuntu Debian CentOS Alpine License


🚀 核心特性

  • ⚡ XHTTP H3 直连:上下行流量分离,使用 HTTP/3 标准UDP传输,实现极低延迟与高并发吞吐。速度对标TUIC协议,但不易被运营商QoS。
  • ☁️ Argo 双模UDP隧道:隧道protocol选择quic,客户端设置H3,让Argo隧道全段跑UDP!服务器 IP 隐藏、Cloudflare CDN 加速及零端口暴露。
  • 🔒 VLESS-TCP-REALITY Vision:(最新封443端口提醒,建议备选或放弃!)“曾经” 是经典的抗封锁协议,完美伪装 TLS 流量,Vision流控,免疫主动探测。
  • ✅ IPv6支持:已添加 Cloudflare 备选安全代理下载,完美支持IPv6机型。

📦 说明

协议组合 核心优势 适用场景
XHTTP + H3 (QUIC) ✅HTTP/3 标准 UDP 传输,不易被QoS 主力高速直连协议
XHTTP + Argo 双模UDP隧道 ✅Argo隧道变身UDP协议!隐藏真实 IP,内网穿透,支持优选域名/ip IP 被墙或极限封锁网络环境
VLESS + TCP + REALITY Vision ✅无域名要求 晚高峰易受TCP拥塞影响,建议备选

💻 系统支持

系统平台 版本要求 状态 / 备注
Ubuntu 20.04+ ✅ 支持
Debian 11+ ✅ 支持
CentOS 7 / 8 / 9 Stream ✅ 支持(自动适配防火墙)
Alpine 3.16+ ✅ 支持(基于 musl 静态编译运行)

极简Ubuntu一键更新:

apt update && apt install -y curl bash

Alpine一键更新:

apk update && apk add curl bash

⚙️ 快速安装

使用 SSH 登录服务器,以 root 权限运行以下指令 (如需设置变量,建议先复制到记事本中再修改):

bash <(curl -Ls https://raw.githubusercontent.com/eishare/Xray-go/main/xray-go.sh) reality"n" h3"y" argo protocol"http2" port"8001" domain"" token""

💡 末尾""双引号中 变量填写说明:


reality"n" = 放弃部署 reality 协议

h3"y" = 部署 XHTTP H3 直连协议+随机端口; h3"12345" = XHTTP H3 部署在12345端口; h3"n" = 放弃部署 XHTTP H3 协议

argo protocol"http2" = 默认部署http2隧道+4条连接;可改成quic,默认1条连接 (http2 还是 quic ?建议在实测后,择优选择)

port"8001" = 8001 与Cloudflare Tunnel 服务URL末尾端口一致

domain"" = Cloudflare Tunnel 路由设置的完整主机名

token "" = 固定隧道 Token

 一键卸载

部署方案未达预期?请使用以下指令卸载:

bash <(curl -Ls https://raw.githubusercontent.com/eishare/Xray-go/main/uninstall.sh)
from  https://github.com/eishare/Xray-go

翻墙工具CFPilot

 Cloudflare Workers 代理微内核 · 真连接优选面板 · 一键部署(VLESS/Trojan/XHTTP + 优选订阅 + 本地真连接优选器 + 中文部署向导)

CFPilot

Cloudflare 代理微内核 · 真连接优选面板 · 盲中继与云监测台 · 异地组网(+mesh) AGPL-3.0 License · 控制面+数据面完全自研(无第三方内核依赖)

· 把「代理内核 + 优选订阅 + 本地真连接优选 + 盲中继 / 云监测台 + 异地组网(+mesh)」整合成一套方案;

· 采用双项目拆分部署:控制面(Web 管理面板)跑 Pages,数据面(流量转发)可选 Pages(默认) 或 Workers;

· 静态脱敏 + 内核独立热更新通道(kernel-latest),转发内核始终保持正式版升级形态;

· 解决优选 IP 困扰:本地真连接优选避免导入后延迟 -1;反代入口池内置双通自愈机制与动态保活清单,开箱即用。

目录

部署

⚠️ 部署前必读

全自动化:填 Token → 自动部署 → 自动优选换 IP → 自动更新内核 → 日常维护 。

  1. 全自动化使用需获取 Cloudflare Api Token 至少三个权限(数据面选 Workers 时是六个,见下文权限表)。
  2. 控制面 + 数据面必须分开(控制面固定 Pages;数据面可选 Pages 或 Workers)。 选 Workers 时必须配一个自有域名,*.workers.dev 直连不可访问。
  3. 不要与其它项目共用 KV 。
  4. 免 Api Token 部署请选择手动部署流程。
① 远程部署(npx,无需安装)





② CLI 安装部署(npm 全局安装)






③ 桌面版(Go 图形界面,推荐)
















CFPilot Go 版凭据页:自动检测账号并自动选中唯一的 CFPilot 实例









































































④ 手动部署(Cloudflare 控制台)




























































盲中继 / 云监测台与异地组网(+mesh)

CFPilot 在原有代理部署与优选能力之外,提供盲中继 / 云监测台部署能力,以及 +mesh 异地组网模块,用于把分散在不同网络(家宽 / 办公室 / 云主机 / 手机)的设备安全连入同一张虚拟局域网。

模块简介

  • 盲中继(Cloudflare Workers + Durable Objects):基于零知识房间转发端到端加密数据包(Noise IKpsk2 + ChaCha20-Poly1305),中继节点本身不持有私钥、无法解密业务流量,用于在双端对称 NAT 无法直连时自动降级兜底;
  • 云监测台(Cloudflare Workers + D1):免费托管的只读设备状态面板,展示各组网节点的在线状态、心跳时间与延迟概览;
  • 异地组网(+mesh):
    • 优先 UDP P2P 直连(STUN 探测 + 协同打洞),不通时自动平滑降级到 盲中继(WSS) 或自建 服务器中继,网络恢复后自动回切直连;
    • 支持 邀请链接一键入网:一端生成邀请链接,其余设备粘贴即可自动填入网络名、PSK、盲中继与监测台参数;
    • 桌面端界面提供实时网络拓扑与状态视图,支持「组网入口」WSS 优选;
    • Android +mesh 版为独立组网客户端(基于 VpnService),打开即可粘贴邀请链接一键入网。

快速开始

  1. 部署盲中继与云监测台(普通版 / +mesh 版均支持):
    • 打开 CFPilot 桌面版「部署 → 盲中继 / 云监测台」页签(或运行 cfpilot edge deploy);
    • 选择已托管在 Cloudflare 账号下的域名与子域、设置监测台密码,点击一键部署;
    • 部署完成后点击「填入组网配置」自动带入中继域名与监测台信息。
  2. 启动第一个组网节点(需安装 +mesh 版):
    • Windows 运行 cfpilot-<版本>+mesh-windows-amd64-setup.exe 安装(安装器会自动注册提权组网服务并下载校验 wintun.dll);
    • Linux 安装对应架构的 .deb 包(sudo dpkg -i cfpilot-<版本>+mesh-linux-<arch>.deb);
    • 在「组网」页填写网络名称、预共享密钥(PSK)、虚拟 IP(同网络所有设备使用同一网段不同地址,如 10.99.0.1/24)及盲中继域名,点击启动。
  3. 加入其它设备:
    • 在已配置好的节点上复制「邀请链接」;
    • 在另一台电脑(+mesh 桌面版)或手机(cfpilot-<版本>+mesh-android.apk)粘贴邀请链接,修改本机虚拟 IP(如 10.99.0.2/24)后点击启动,即可互通并自动发现对端。

如需在自有 VPS 部署专用 UDP 服务器中继,可在「组网 → 高级选项」中一键生成部署命令并回填输出参数。


优选 IP

部署完成后,建议跑一次本地真连接优选,把「看起来快但实际不可用」的 IP 剔掉。

# 已安装 CLI
cfpilot scan

# 或直接用 npx
npx -y cfpilot@latest scan

交互式引导会:识别实例 → 自动填域名与 WS 路径 → 扫描 → 询问是否回填面板。

通用流程

  1. 关掉所有代理工具(含 TUN 模式与系统代理)
  2. 选择实例(或手动填数据面域名 + WS 路径)
  3. 设置采样数与是否跳过测速后开始优选(建议默认)
  4. 扫描完成后选 y 自动回填,或选 N 复制结果手动粘贴
  5. 回填后面板「节点来源 → 手动优选 IP」即可看到列表
  • 桌面版根据图形界面提示说明操作,易用性更强。

导入订阅

面板首页给出三种订阅地址,按 User-Agent 自动识别格式:

客户端 拿到的格式
Clash Verge / Clash / mihomo YAML
sing-box JSON
v2rayN / Shadowrocket / NekoBox Base64 分享链接

也可显式指定:?target=clash / ?target=singbox / ?target=base64。

节点的关键约定:server = 优选出的 IP,sni / Host = 你的域名(固定),端口 = 443。


使用须知

API Token 权限

在 Cloudflare 控制台 → API Tokens 创建自定义 Token,按下面三项勾选(分类都是 Account,权限级别都是 **Read/**Edit):

权限项(控制台显示名) 级别 分类 用途
Account Settings Read
读取账号列表(GET /accounts)
Workers KV Storage Edit Developer Platform 建 KV、读写部署清单与 CONFIG
Pages Edit Developer Platform 建/删 Pages 项目、上传内核、绑 KV、配环境变量、绑自定义域名
Account API Tokens Read Account & Billing 可选,仅用于显示 Token 有效期
Account Analytics Read Analytics & Logs 可选,仅用于「用量/额度」面板(查 Workers 与 KV 的已用量)

数据面用 Workers 模式时,再加一项:

权限项(控制台显示名) 级别 分类 用途
Workers Admin Developer Platform 上传 / 更新数据面 Worker 脚本

✅ 不需要 Workers Routes,也不需要 DNS —— 工具不碰自定义域名: Workers 模式只把数据面部署到 *.workers.dev,自定义域名请你在控制台自行绑定, 然后到面板「设置 → 数据面域名」填一次(CONFIG.subDomain 优先级高于 DATA_HOST)。

⚠️ Workers 模式 + 自定义域名时,workers.dev 的生产链接与预览链接会被工具关掉, 节点只走自定义域名(*.workers.dev 在多数网络下直连不可访问)。 部署时若填的域名与数据面已绑定的域名不一致、或是控制面 / 账号里别的 Worker 的域名, 工具会直接拒绝部署并说明原因 —— 避免把错域名写进 DATA_HOST 导致节点不可用。

📋 点开看「照着勾」的图解(哪些必勾 / 哪些不用勾 / 操作步骤)Cloudflare API Token 权限勾选指引

数据面出站能力边界

目标类型 能否打通
普通站点(baidu / qq / amazon 等) ✅ 直连
Cloudflare 网段目标 ✅ 内置第三方反代入口(面板可自配)
Google / YouTube / GitHub 等 443 ✅ 内置假活检测会自动切反代;若不通建议配 SOCKS5/HTTP 代理落地

订阅接入

节点形态在面板「入站配置」里选,默认下发 VLESS + WebSocket 与 VLESS + XHTTP 两种形态。

形态 支持
VLESS + WS 全部客户端
Trojan + WS 全部客户端
VLESS + XHTTP(packet-up) Xray 内核、新版 mihomo(1.19+);实测稳定

mihomo / Clash.Meta 自 1.19+ 已支持 XHTTP 节点;老版本会忽略该节点,不影响 WS 节点。 sing-box 暂不支持,订阅里不下发。

ECH(Encrypted Client Hello)

ECH 把 TLS ClientHello 里的真实 SNI 加密,隐藏你访问的是哪个域名。 这是客户端侧的能力 —— 内核只负责把参数写进订阅,由支持 ECH 的客户端 (mihomo / Clash Verge、sing-box 1.13+、v2rayN)实际执行;客户端不支持时参数被忽略,不影响连接。

默认关闭,在面板「出站与抗封锁」页勾选「启用 ECH 加密」后保存即可。 没有自定义域名时客户端连的是 *.pages.dev,ECH 的实际收益有限。


常见问题

Q:优选结果全是 -1? 按顺序查:① 是否绑了自定义域名;② 客户端 sni 与 Host 是否都指向你的域名; ③ 优选时 --host 是否和实际部署一致;④ 端口是否是 443 等 TLS 端口; ⑤ 跑优选时是否关了代理工具。

Q:配了 SOCKS5 代理但不生效? 检查这几项:① 代理地址是否可公网访问(127.0.0.1 / 192.168.x 这类地址数据面连不到); ② 代理是否支持 TLS 1.3(HTTPS 代理需要);③ 代理服务器是否有 IPv4 公网地址 (数据面的出站只支持 IPv4)。

Q:Linux 版双击没反应 / 没有托盘图标? 浏览器下载的文件默认没有执行位,先 chmod +x,再从终端启动(双击常被文件管理器当成文本打开)。 没有图标说明当前桌面缺 StatusNotifierItem 宿主(GNOME 默认如此),改用 --no-tray 前台运行即可, 服务与界面一致,只是少了托盘菜单;纯命令行 / SSH 环境也用它。

Q:面板打不开 / 404? 面板路径是部署时随机生成的,向导终端里打印过。忘了可以用 npx wrangler kv key get --binding KV PANEL_PATH 查回。

Q:XHTTP 节点连不上? 需要 Xray 内核或新版 mihomo(1.19+,network: xhttp);sing-box 请改用 WS 节点。 老版本 mihomo 会直接忽略 XHTTP 节点(不是报错),不影响其它节点。 默认下发的 XHTTP 节点使用 packet-up 模式并关闭 gRPC 伪装头;若个别网络环境下仍受限,可切回 WS 节点使用。

Q:免费额度 CPU 超限? 内核内置 Free CPU 预算保护,可在面板调低 DLS / MAX_LATENCY 阈值,或减少远程 CSV 行数。

Q:想看「为什么这个目标连不上」? 自研数据面提供完整诊断端点,需要带上完整 UUID(面板「节点配置」里可见):

curl \
  -H "x-cfpilot-token: <完整 UUID>" \
  https://<数据面域名>/__diag

返回最近 20 条完整出站诊断(失败类型 / 原始错误 / 候选 / 修复建议)—— WebSocket close frame 装不下这些(且超长会被边缘静默丢弃),所以单独开了个口子。

⚠️ 只认完整 UUID:早期允许 UUID 前 8 位,但那是 32 bit 搜空间, 可被在线枚举(诊断里有你访问过的目标域名)。失败尝试也有限速(每 isolate 每分钟 10 次)。

Q:/__edge_probe 会不会被别人刷流量? 该端点必须保持免鉴权(它是优选的核心:WS 101 校验 + 流式测速),所以内置两道闸: 单次最多 8 MiB,以及每个 isolate 每 10 分钟约 6 GiB 的总预算,超出返回 429。 正常一轮优选(约 50 条候选 × 8 连接 × 5 MiB)大约 2 GiB,跑不满。 如果你担心被滥用,可在 Cloudflare 控制台给该路径加一条 Rate Limiting 规则。


技术实现

▸ 展开:内核与优选器的技术方法总览(三张表:边缘内核 / 优选器 / 工程与发布)



































































































仓库结构

CFPilot/
├── CFPilot-control.zip    # 控制面 Pages 包
├── CFPilot-dataplane.zip  # 数据面 Pages 包
├── data/relay-ips.txt     # 动态保活反代入口清单
└── packages/
    ├── worker-core/       # 边缘内核 + 中文面板
    ├── cli/               # cfpilot —— 部署 + 优选 CLI
    ├── cli-mesh/          # cfpilot-mesh —— 含组网能力的 CLI
    ├── ui/                # 界面源码(单一来源,桌面版与安卓版共用)
    ├── desktop/           # Go 桌面版 / 容器版 / +mesh 组网服务
    ├── android/           # Android 完整管理面板 App
    ├── android-mesh/      # Android 独立 +mesh 组网客户端
    └── edge-relay/        # 盲中继 + 云监测台 Worker 源码

界面源码独立在 packages/ui,构建时内嵌进桌面版与 Android 管理版,保证多端界面一致。


配置项与环境变量

优先级:KV(CONFIG) > 环境变量 > 内置默认值。

常用环境变量

变量 说明
UUID VLESS UUID
WS_PATH WebSocket 路径(值要带前导斜杠;PATH 是 Pages 保留名,别用)
TROJAN_PASSWORD Trojan 密码
ENABLE_TROJAN / ENABLE_XHTTP 入站开关
DATA_HOST 数据面域名(拆分部署时控制面用它生成订阅)
PANEL_PATH / PANEL_PASSWORD 面板路径与初始密码(不是 ADMIN_PASSWORD)
PROXYIP ProxyIP 池(按直连落地语义解析)
SOCKS5 / HTTP_PROXY 落地代理(仅自研数据面)。https:// 前缀表示代理本身走 TLS,可用 #sni=域名 指定握手名
NAT64 NAT64 前缀,如 64:ff9b::
RELAY_POOL / USE_BUILTIN_RELAY 自定义反代入口池 / 内置表开关
RESOLVE_PREFERRED 出站前自动 DoH 解析优选 IP(默认开)
SUB_VARIANTS 下发的节点形态,逗号分隔,默认 vless-ws,vless-xhttp
OFFICIAL_IP_COUNT / PREFERRED_DOMAIN_COUNT 内置来源数量(默认 20 / 10)
DLS / MAX_LATENCY 订阅池的最低速度 / 最高延迟阈值

常用 KV 键

键 内容
CONFIG 用户配置 JSON(含 uuid / wsPath / trojanPassword)
CFP_DEPLOY_MANIFEST 部署清单,判断 KV 归属的唯一依据
LOCAL_PREFERRED_IPS 本地优选结果
SCANNER_TOKEN 扫描回填令牌

scanner 常用参数

参数 默认 说明
--host 必填 你的域名(作为 SNI / Host)
--path /vless 目标项目的 WS 路径
--sample 6556 候选采样数
--top 15 返回条数
--countries — 机房国家筛选,如 HK,JP,SG;也接受分组 ASIA / US 与机房码 HKG(自动归一到国家)
--token — 回填令牌(不填则只输出不回填)
--no-verify — 只做 101 握手,跳过响应体校验(对接非 CFPilot 项目时用)
--speed-mode auto probe(走目标探针端点,最忠实)/ url(公开测速地址,任何项目可用)/ auto
--cidr / --ip-file — 自定义网段 / 本地 IP 列表
cfpilot test --ip <IP> — 测单个 IP:按 TCP → TLS → WS 101 逐阶段给结论(前一阶段失败即停);可加 --speed(测下行)、--uuid / --trojan-password(真实隧道校验)、--json(脚本处理)、--path(非默认探针路径)

完整参数见 npx -y cfpilot@latest scan --help 与 npx -y cfpilot@latest test --help。


配置备份与迁移

面板「出站与高级 → 配置备份与迁移」可以导出/导入配置。

导出是脱敏的:不含 UUID、Trojan 口令、入站路径、自定义域名,以及带口令的落地代理; 导出时会明确列出哪些字段没带、为什么。导入前会显示逐项差异,确认后才写入。

换账号、迁移项目、备份都靠它。


客户端兼容性

客户端 / 内核 VLESS-WS Trojan-WS VLESS-XHTTP ECH
Xray-core 支持 支持 支持(需较新版本) 支持(需较新版本)
sing-box 支持 支持 不支持 支持(1.12+)
mihomo / Clash.Meta 支持 支持 支持(1.19+) 支持(ech-opts)
v2rayN / v2rayNG / Shadowrocket 支持 支持 跟随内核 跟随内核

mihomo 自 1.19+ 原生支持 XHTTP(network: xhttp + xhttp-opts),实测可稳定连接。 sing-box 暂无该传输类型,订阅生成时不向其下发 XHTTP 节点;老版本 mihomo 会忽略该节点, 不影响其它节点。详见 客户端兼容性矩阵。

免责声明

本项目仅作学习交流使用,用于查找资料、学习网络知识,不鼓励、不支持任何违法行为。

  • 项目中涉及的所有方法与技术均来自互联网公开资料,仅供交流学习;

  • 使用者需自行遵守所在地法律法规与 Cloudflare 服务条款(尤其是 Free 套餐的流量与 CPU 限制),并对自身使用行为负全部责任;

  • 任何人因使用本项目产生的任何后果(包括但不限于账号封禁、服务中断、法律责任),本项目及作者概不负责。

     from https://github.com/xmwengxing/CFPilot

    ---------------------------------------------------------------------------------------------

    本教程自动搭建,免去手动部署的烦恼,去除复制代码或上传配置文件,去除配置相关密钥,去除手动创建workesKV空间,无需域名.