back4app-vless README

The project's README from github.com/KJGX66F/back4app-vless. As one markdown file: README.md.

⚠️ 本项目免费公开源码，仅限个人/非商业用途，禁止倒卖、收费部署及任何未经授权的商业使用。

Back4app VLESS + Cloudflare Tunnel

一个适合小白使用的 Back4app + VLESS + WebSocket + Cloudflare Tunnel 部署方案。

支持两种模式：

功能

项目文件

仓库只需要：

.
├── Dockerfile
└── start.sh

方法一：小白版・临时隧道

这是最简单的部署方式。

特点：

无需自己的域名
无需 Cloudflare Token
无需配置 DNS
只需要一个 UUID

Cloudflare 会自动生成：

xxxx.trycloudflare.com

1. Fork 本项目

点击 GitHub：

Fork

保存到自己的 GitHub 账号。

2. 创建 Back4app 应用

进入 Back4app：

New App
→ Containers
→ Import GitHub Repository

选择刚刚 Fork 的仓库。

填写：

Branch:
main

Root Directory:
./

Port:
8080

3. 添加 UUID

打开：

Environment Variables

添加：

Name:
UUID

Value:
你自己的UUID

例如：

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

不会生成 UUID 的 Windows 用户可以打开 PowerShell：

[guid]::NewGuid().ToString()

4. Deploy

点击：

Deploy

等待部署完成。

然后打开：

Logs

看到：

Cloudflare Quick Tunnel 创建成功

下面会自动生成：

vless://xxxxxxxxxxxxxxxx

复制完整的 vless:// 链接导入客户端即可。

方法二：进阶版・固定 Cloudflare Tunnel

如果你有自己的 Cloudflare 域名，推荐使用固定 Tunnel。

优点：

固定域名
容器重启后地址不变
更加适合长期使用

例如：

vless.example.com

1. 创建 Cloudflare Tunnel

进入 Cloudflare：

Networking
→ Tunnels
→ Create a tunnel

创建一个 Tunnel，例如：

back4app-vless

Cloudflare 会给出类似：

cloudflared tunnel run --token eyJhIjoi........

只复制：

eyJhIjoi........

也就是 --token 后面的内容。

2. 设置 Published Application

进入刚才创建的 Tunnel：

Routes
→ Add route
→ Published application

Hostname：

vless.example.com

Service：

HTTP

URL：

localhost:8080

最终必须是：

http://localhost:8080

注意：不要设置成 https://localhost:8080，否则容易出现 502。

保存。

3. Back4app 添加环境变量

除了原来的：

UUID

再添加：

TUNNEL_TOKEN

值：

你的 Cloudflare Tunnel Token

以及：

CF_HOST

值：

vless.example.com

最终：

UUID=你的UUID

TUNNEL_TOKEN=你的Tunnel Token

CF_HOST=vless.example.com

重新 Deploy。

4. 获取固定节点

打开 Back4app：

Logs

看到：

Tunnel Mode : 固定隧道 / Named Tunnel

随后会自动输出：

vless://xxxxxxxxxxxxxxxx

复制即可。

客户端参数

如果需要手动填写：

协议：
VLESS

端口：
443

加密：
none

传输：
WebSocket

WS Path：
/vless

TLS：
开启

临时 Tunnel：

地址：
xxxx.trycloudflare.com

Host：
xxxx.trycloudflare.com

SNI：
xxxx.trycloudflare.com

固定 Tunnel：

地址：
vless.example.com

Host：
vless.example.com

SNI：
vless.example.com

可选环境变量

WS_PATH

默认：

/vless

想修改可以添加：

WS_PATH=/abc

客户端 Path 也必须同步修改。

CF_PROTOCOL

默认：

auto

如果日志经常出现 QUIC、UDP、timeout 等错误，可以尝试：

CF_PROTOCOL=http2

临时隧道和固定隧道怎么选？

模式 临时 Tunnel 固定 Tunnel
自己的域名 不需要 需要
Tunnel Token 不需要 需要
部署难度 ⭐ ⭐⭐⭐
域名固定 ❌ ✅
重启后地址 可能变化 不变
推荐用途 测试/小白 长期使用

程序会自动判断：

只有 UUID
↓
自动使用 Quick Tunnel

如果检测到：

TUNNEL_TOKEN

则自动切换：

Named Tunnel

所以不需要修改代码。

常见问题

1. 部署成功但节点 -1

首先查看：

Back4app
→ Logs

以及：

Metrics

检查 CPU、RAM 和 Cloudflare Tunnel 是否断线。

临时 trycloudflare.com Tunnel 本身更适合测试，如果长期使用建议切换固定 Tunnel。

2. 固定 Tunnel 出现 502

Cloudflare Tunnel 的 Service 必须设置：

http://localhost:8080

不要设置：

https://localhost:8080

3. 临时节点突然失效

Quick Tunnel 重启后：

xxxx.trycloudflare.com

可能发生变化。

重新进入：

Back4app → Logs

复制最新生成的 VLESS 节点即可。

4. 修改 GitHub 代码后没有更新

如果 Back4app：

Autodeploy = No

需要手动重新：

Deploy

建议开启：

Autodeploy = Yes

以后 GitHub 更新后会自动重新部署。

推荐配置

纯小白

UUID

就够了。

长期使用

UUID
TUNNEL_TOKEN
CF_HOST

推荐固定 Cloudflare Tunnel。

架构

客户端
   ↓
VLESS + WS + TLS
   ↓
Cloudflare
   ↓
Cloudflare Tunnel
   ↓
Back4app
   ↓
Nginx
   ↓
Xray

注意

📄 License / 使用许可

本项目免费公开源码，仅限个人学习、研究、测试及其他非商业用途使用。

✅ 允许

❌ 禁止

未经作者明确书面授权，不得将本项目用于任何商业用途，包括但不限于：

⚠️ 商业授权

如需用于商业项目、收费服务或其他盈利场景，请先取得作者授权。

本项目建议采用：

PolyForm Noncommercial License 1.0.0

即：

免费用于个人及非商业用途，未经授权禁止商业使用。

免责声明

本项目仅用于个人学习、技术研究和网络环境测试。

使用者应自行遵守所在地法律法规以及 Back4app、Cloudflare 等第三方平台的服务条款。

因使用本项目产生的任何直接或间接后果，由使用者自行承担。

back4app-vless (KJGX66F/back4app-vless)

Searching Database…

210 ·GitHub
Back4app-vless
Что это?Этот проект — настройка для развёртывания в один клик, которая запускает прокси VLESS поверх WebSocket через Cloudflare Tunnel, размещаясь бесплатно на облачной платформе Back4app, без VPS и администрирования сервера.
Как это развернуть?Сделайте форк репозитория, создайте новое приложение на Back4app, указывающее на ваш форк, добавьте переменную окружения UUID, затем нажмите Deploy; сгенерированная ссылка на VLESS-узел появится потом в логах приложения.
Нужен ли VPS или собственный домен, чтобы начать?Нет — VPS и SSH-доступ не нужны вообще, а быстрый режим запуска к тому же не требует ни домена, ни токена Cloudflare. Домен и токен туннеля нужны только для продвинутого режима с фиксированным туннелем.
Адрес моего прокси останется тем же после перезапусков?Только в продвинутом режиме. Бесплатный режим Quick Tunnel генерирует адрес trycloudflare.com, который может измениться после перезапуска, так что для долгосрочного использования нужно перейти на фиксированный Named Tunnel со своим доменом Cloudflare.
Что произойдёт, если соединение Cloudflare Tunnel оборвётся?Развёртывание само обнаруживает разорванное соединение Cloudflare Tunnel и переподключается без ручного вмешательства.
Можно ли получить постоянный адрес вместо случайного?Да, если использовать продвинутый режим со своим доменом Cloudflare и токеном Named Tunnel — это даёт фиксированное имя хоста, которое не меняется при перезапуске.
Что делать, если в логах часто мелькают ошибки таймаута QUIC или UDP?Можно задать переменную окружения CFPROTOCOL, чтобы заставить Cloudflare Tunnel использовать альтернативный протокол вместо QUIC.
Пуш изменений в мой форк на GitHub автоматически обновляет живое развёртывание?Не по умолчанию — нужно вручную запустить повторный деплой на Back4app или включить его опцию авто-деплоя, чтобы будущие обновления с GitHub разворачивались автоматически.
What are similar projects?Open-Box, CFNext, personal-edge-proxy, bot-hosting-vless, panda-vpn-pro, usque-custom-pro, edgetunnel, v2ray
Which topics is it in?websockets, vless, gfw, socks5, v2ray, shadowsocks, tunnel, anti-censorship, reverse-proxy, censorship-circumvention, cloudflare, vpn
Creator
KJGX66F
Size
<0.1 MB
Stars
210
Updated
CommitAug 19
Age
2mo
Commits · 90 Days