free-vless-node
/free-vless-node
Wdraża na darmowej platformie hostingowej węzeł VLESS z WebSocket i TLS, a potem sprawdza jego działanie prawdziwym klientem.
- Autor
- xiarizhibin ↗
- Repozytorium
- free-vless-node-skill ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 02.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 5
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 6
Brak sygnałów. Repozytorium zmienione 02.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Wdraża na darmowej platformie hostingowej węzeł VLESS z WebSocket i TLS, a potem sprawdza jego działanie prawdziwym klientem.
Wyzwalacze z opisu
Oryginalny opis (EN)
用临时邮箱在免费托管平台(netrun.io 等)上部署一个真的能用的 VLESS+WS+TLS 节点,产出 vless:// 链接与 Shadowrocket 二维码,并用真客户端(Xray)验证穿透 HTTPS,最后给出真机导入与排障指引。当用户说要"部署 vless / ws / tls 节点""搞个免费节点""生成 shadowrocket 二维码""扫码导入""节点 ping timeout 排障""临时邮箱注册 + 部署"时使用。
Jak działa
- 0. 先记住三条硬约束
- 1. 建立临时收件箱(1 分钟)
- 2. 准备服务端
- 3. 选平台 + 先看 AUP
- 4. 部署(浏览器自动化,以 netrun.io 为例)
- 5. 三级验证(第三级才算数)
- 6. 出链接与二维码
- 7. 交付给用户时写清三件事
- 8. 失败矩阵(照着查)
- 9. 加固与迁移(可选)
Podgląd SKILL.md
---
name: free-vless-node
description: 用临时邮箱在免费托管平台(netrun.io 等)上部署一个真的能用的 VLESS+WS+TLS 节点,产出 vless:// 链接与 Shadowrocket 二维码,并用真客户端(Xray)验证穿透 HTTPS,最后给出真机导入与排障指引。当用户说要"部署 vless / ws / tls 节点""搞个免费节点""生成 shadowrocket 二维码""扫码导入""节点 ping timeout 排障""临时邮箱注册 + 部署"时使用。
license: MIT
---
# 免费 VLESS+WS+TLS 节点:部署到交付
一个可以完整跑通的流程:**临时邮箱 → 部署平台注册 → 上传服务端 → 三级验证 → 出链接和二维码 → 真机导入**。每条命令、每个字段、每个坑都来自实战,不是示意。
## 0. 先记住三条硬约束
1. **绝不能用"拿到 HTTP 200 就算成功"来自证。** 明文 HTTP 测试对缺响应头的坏节点照样返 200 —— 这是本流程里最容易踩的假阳性。判定必须走第 5 节的三级验证,其中**第三级是唯一算数的**。
2. **客户端失败率最高的原因,不在客户端。** 90% 的 "ping timeout" 是服务端响应头方向错、path/SNI/Host 三处不一致、或实例休眠未唤醒。
3. **托管平台的内容审查比你想的积极。** 代理关键字(vless / vmess / xray / trojan / shadowsocks)出现在代码里会被拦。服务端模板已做中性命名,改动时别把关键字写回去。
## 1. 建立临时收件箱(1 分钟)
```bash
node scripts/mailtm.mjs new # 打印 address / id / token,写入 .mailtm.json
node scripts/mailtm.mjs wait --timeout 300 # 阻塞等信,命中即打印 subject + 正文(含验证码/链接)
```
- 走 mail.tm 公开 API,无需注册第三方账号,`GET /domains` → `POST /accounts` → `POST /token`。
- 验证码通常 6 位数字,10 分钟内有效;如果平台是"点链接激活",`wait` 会把正文里的 URL 抓出来。
- 收不到信时先确认 `spam`:调 `GET /messages` 看有没有字段 `seen=false` 的新信,再重发验证码。
## 2. 准备服务端
用 `scripts/relay-server.js`(已修好的 VLESS-over-WS 实现),只需三处:
| 项 | 做法 |
|---|---|
| 端口 | 读 `process.env.PORT`,监听 `0.0.0.0`(托管平台只给动态端口) |
| 认证 key | `process.env.RELAY_KEY`,32 位 hex(UUID 去横线);不设则用模板默认值 |
| 依赖 | 只要 `ws`,`package.json` 里 `"start": "node server.js"` |
打包:
```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File scripts/make-zip.ps1 -Dir ./project -Out ./relay.zip
bash scripts/make-zip.sh ./project relay.zip # macOS/Linux
```
默认执行策略会拦未签名脚本,加 `-ExecutionPolicy Bypass` 即可;zip 根目录必须是 `server.js` + `package.json`,不要多包一层文件夹。
**模板里已经踩过的两个坑,不要改回去:**
1. **响应头必须回给客户端,不是回给上游。** 握手成功后要把 `[version, 0]` 通过 WebSocket 发给客户端;写进上游 TCP 会得到 `unexpected response version`(客户端读到的是上游数据,例如 TLS 告警首字节 `0x15`)。
2. **"握手包只解析一次"的标志位必须真的置位。** 漏了它,同一条连接会二次解析并再开一条上游,症状是响应头发两遍 + 请求体发两遍(上游返回 `400 Bad Request`,TLS 直接握手失败)。
3. 客户端早数据(early data,握手包后面的负载)要 `upstream.write()` 出去;别和响应头混在一起。
## 3. 选平台 + 先看 AUP
| 平台 | 免费额度 | 注册 | TLS/WS | 备注 |
|---|---|---|---|---|
| netrun.io | 1 项目,空闲休眠 | 邮箱验证码,无卡 | 边缘终止,自带证书 | **AUP 明确禁止代理/VPN**,靠中性命名通过代码扫描;更新可能被拦 |
| Cloudflare Workers | 免费额度充足 | 需 CF 账号 | `*.workers.dev` 自带 TLS | 免服务器,需改写为 Worker 版脚本 |
| Render / Koyeb / Railway | 免费档或试用 | 部分要卡 | 自带证书 | 免费档会休眠,AUP 同样禁代理 |
| 自己的 VPS | — | — | 需自签/ACME | 最稳,无 AUP 风险 |
选平台时先做一次 **AUP 探测**:搜索 `<平台名> terms proxy vpn`,看到 "proxies/VPN/tunneling are prohibited" 就直接按"需要中性命名 + 随时可能被下架"来规划,不要等发布被拒才发现。
## 4. 部署(浏览器自动化,以 netrun.io 为例)
```
https://netrun.io/en → Get started → auth.netrun.io/login
输入临时邮箱 → 继续 → 6 位验证码(scripts/mailtm.mjs wait 取)
→ /projects → 上传代码 → 项目名(= 子域名前缀,需唯一)
→ 来源选「上传」→ 传 zip → 下一步 → 构建 → 拿到 https://<项目名>.de1.netrun.io
```
浏览器自动化的几个坑(真实踩过):
- **伪 radio 点不动**:平台用 `<button role="radio">` 而不是 `input[type=radio]`,`querySelectorAll('input[type=radio]')` 返回空。用 JS 点:`document.querySelectorAll('.dw-source-tab')[1].click()`。
- **上传要直接操作 input**:先 `document.querySelectorAll('input[type=file]')` 找隐藏 input,再把文件塞给它(`ego_upload` / Playwright `setInputFiles`),别去点"选择文件"按钮。
- **步骤是串行的**:名字 → 下一步 → 来源 → 下一步 → 发布。第一步没过,第二步按钮是灰的;逐个点、每步截图确认。
- **界面可能是俄语**:按钮文案 `Обновить код`(更新代码)/ `Обновить и опубликовать`(更新并发布)/ `Засыпает без посещений`(无访问休眠)。别按英文文案找元素。
- **发布被拒的报错要读**:`прокси и VPN-серверы ... запрещены` = 代码扫描命中代理特征 → 改中性命名后重发。
## 5. 三级验证(第三级才算数)
```bash
# 级别 1:响应头 + 真 TLS 握手(能立刻定位 90% 的问题)
node scripts/verify-tls.mjs wss://HOST/ www.cloudflare.com 443
# 期望: relay header: 0000 (OK)
# TLS handshake OK: TLSv1.3 / TLS_AES_256_GCM_SHA384
# HTTP through TLS: ip=<出口IP>
# RESULT: TLS-through-relay OK
# 级别 2:明文抓取(辅助,只能看字节流,不能当通过标准)
node scripts/verify-fetch.mjs wss://HOST/ ip.sb 80 /
# 级别 3:真客户端(唯一算数的证据)
# 下载 Xray-core,用 scripts/xray-client.json 模板改 address/port/key,
# 起本地 http inbound,然后:
curl -s -x http://127.0.0.1:10809 --max-time 40 https://www.cloudflare.com/cdn-cgi/trace
# 期望 ip=<节点出口IP>,且 https://www.gstatic.com/generate_204 返回 204
# —— gstatic 204 就是 iOS 客户端内建 ping 的目标类型,能过就代表客户端 ping 必过
```
**判读表**
| 现象 | 结论 |
|---|---|
| `relay header: 4854 (HT)` | 服务端没发响应头,发的是上游数据 → 模板第 1 个坑 |
| `relay header` 出现两次 | 握手包被解析两次 → 模板第 2 个坑(`ready` 标志没置位) |
| header OK 但 TLS `wrong version number` | 上游被写入了重复/污染字节,同上 |
| 全通但客户端仍 timeout | 客户端字段错(path/SNI/Host),或实例休眠未唤醒,见第 8 节 |
## 6. 出链接与二维码
```bash
node scripts/gen-link.mjs \
--uuid <32位hex或带横线UUID> \
--host HOST.de1.netrun.io \
--name My-Node \
--out ./out
# 产出 out/link.txt, out/sub-b64.txt, out/qr.png
# 内部会先请求二维码服务生成 PNG,再用 jsQR 解码回来和 link.txt 逐字节比对
```
链接参数(**这五个字段必须自洽,错一个就连不上**):
```
vless://<UUID>@<HOST>:443?encryption=none&security=tls&sni=<HOST>&type=ws&host=<HOST>&path=%2F&fp=chrome&alpn=http%2F1.1#<NAME>
```
| 字段 | 必须等于 |
|---|---|
| `security` | `tls`(即使 TLS 由边缘终止,客户端也必须开 tls) |
| `sni` | 服务端证书域名(= 部署域名) |
| `host` | WebSocket 的 Host 头(= 部署域名) |
| `path` | 服务端接受的路径,`/` 写作 `%2F` |
| `alpn` | `http/1.1`(边缘多为 HTTP/1.1 反代) |
## 7. 交付给用户时写清三件事
1. **软件**:iOS → Shadowrocket(扫码/粘贴链接);Android → v2rayNG;Windows → v2rayN(扫码屏幕);macOS → V2Box / sing-box。
2. **判定标准**:长按节点测延迟出数字 = 四层全通;再开 `https://www.cloudflare.com/cdn-cgi/trace` 看 `ip=` 是否等于节点出口 IP(这是唯一不会被缓存骗过的证据)。
3. **第一次会慢**:免费档空闲休眠,先浏览器打开部署域名唤醒,等 5–20 秒再测。要常驻就得付费档或换不自休眠的平台。
## 8. 失败矩阵(照着查)
| 症状 | 优先怀疑 | 处理 |
|---|---|---|
| ping timeout / 延迟测试超时 | 服务端响应头(第 2 节坑 1/2) | 跑 `verify-tls.mjs`,看 header 是不是 `0000` |
| 首次连不上,之后正常 | 实例休眠 | 先 HTTP 打开域名唤醒 |
| 延迟有数字但网页打不开 | 客户端路由/规则 | 开全局或绕过局域网 |
| 能连一个目标,连不上某站 | 节点出口被目标站拦(机房 IP) | 换目标站验证出口;换区域或加 CDN |
| 更新后被平台下架/拒发 | AUP 代理条款 | 中性命名重发;或迁 Cloudflare Workers / VPS |
| 全部正常但只有某客户端不行 | 客户端不认 `fp`/`alpn` | 去掉 `fp`,`alpn` 只留 `http/1.1` |
服务端带 `GET /_status` 诊断端点:返回最近连接事件,`ok:true` + `target` 表示握手成功并连上目标;`why:"bad-key"` 是 UUID 不一致;`why:"link:..."` 是出站被拒;一条事件都没有说明请求没到服务端(本地网络/运营商拦)。**这是远程排障最快的抓手**,交付时把 URL 一起给用户。
## 9. 加固与迁移(可选)
- 换 key:平台环境变量 `RELAY_KEY=<新hex>` → 重启 → 客户端同步改。
- 换路径:`path` 改成随机串(前后端保持一致),减少被动扫描命中。
- 迁移:`scripts/relay-server.js` 是纯 Node + `ws`,可直接搬 VPS / Docker / Cloudflare Worker(Worker 版需换成 fetch + WebSocketPair 写法)。
- 自托管时加 TLS 就在前面挂 Caddy/Nginx 反代 `/` 到 127.0.0.1:PORT,证书用 ACME,客户端 `sni` 填证书域名。
## 文件清单
```
SKILL.md 本流程
scripts/relay-server.js VLESS-over-WS 服务端(含两处修复 + /_status)
scripts/verify-tls.mjs 级别1:响应头 + 真 TLS 穿透
scripts/verify-fetch.mjs 级别2:明文抓取探针
scripts/gen-link.mjs 链接 + Base64 订阅 + 二维码 + 回读校验
scripts/mailtm.mjs 临时邮箱:new / wait / list
scripts/make-zip.ps1 打包(Windows)
scripts/make-zip.sh 打包(*nix)
scripts/xray-client.json 真客户端模板(级别3)
references/clients.md 客户端字段对照与导入方式
references/platforms.md 平台 AUP 与部署差异
```
Pliki w paczce (5)
- .gitignore 1 KB
- LICENSE 1 KB
- README.md 3 KB
- SKILL.md 11 KB
- package.json 1 KB
Wersje
W bazie nie ma innych skilli o nazwie free-vless-node.
Migawka bazy z 13.11.2026 · wersja paczki 829a78df07a1 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 1 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 98vortexa-free-node
Uruchamia darmowy węzeł Xray w chmurze Vortexa i przygotowuje jego subskrypcję oraz kod QR, bez karty płatniczej i numeru telefonu.