Przejdź do treści
Biblioteka skilli
Inne · Automatyzacja

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.

Licencja
MIT
Ostatnia zmiana repozytorium
02.11.2026

Ocena i bezpieczeństwo

95/ 100Klasa: dobry
Format20 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
5
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
6
Przestarzałość

Brak sygnałów. Repozytorium zmienione 02.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

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

部署 vless / ws / tls 节点搞个免费节点生成 shadowrocket 二维码扫码导入节点 ping timeout 排障临时邮箱注册 + 部署
Oryginalny opis (EN)

用临时邮箱在免费托管平台(netrun.io 等)上部署一个真的能用的 VLESS+WS+TLS 节点,产出 vless:// 链接与 Shadowrocket 二维码,并用真客户端(Xray)验证穿透 HTTPS,最后给出真机导入与排障指引。当用户说要"部署 vless / ws / tls 节点""搞个免费节点""生成 shadowrocket 二维码""扫码导入""节点 ping timeout 排障""临时邮箱注册 + 部署"时使用。

Jak działa

  1. 0. 先记住三条硬约束
  2. 1. 建立临时收件箱(1 分钟)
  3. 2. 准备服务端
  4. 3. 选平台 + 先看 AUP
  5. 4. 部署(浏览器自动化,以 netrun.io 为例)
  6. 5. 三级验证(第三级才算数)
  7. 6. 出链接与二维码
  8. 7. 交付给用户时写清三件事
  9. 8. 失败矩阵(照着查)
  10. 9. 加固与迁移(可选)
Sekcje z nagłówków SKILL.md, w oryginale · 173 linii, 805 słów
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.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.