一个部署在 Koyeb Serverless Platform 上的 ENC+Vioion-Xhttp-ARGO 代理节点项目,旨在提供一个稳定、快速的代理服务。
该项目利用 Koyeb 的持续运行能力,并通过部署在 Cloudflare Workers 的 worker.js 文件实现远程登录保活,确保服务的持久可用性。
- 多协议支持: 集成了 ENC、Vioion、Xhttp 和 ARGO 代理协议。
- 平台稳定: 部署在 Koyeb 平台,享受其高性能和全球边缘网络。
- 远程保活: 通过 Cloudflare Worker 定时访问,解决 Koyeb 因长期未登录而暂停或回收项目的问题。
vless://%E8%87%AA%E5%AE%9A%E4%B9%89UUID@优选ip:443?encryption=mlkem768x25519plus.native.0rtt.fRLKjkBNx1N6ceiqcqilb46WNj4yvl4SgXklAFkvNhE&flow=xtls-rprx-vision&security=tls&sni=%E5%9B%BA%E5%AE%9A%E9%9A%A7%E9%81%93&fp=chrome&alpn=h2&insecure=0&allowInsecure=0&type=xhttp&path=%E8%87%AA%E5%AE%9A%E4%B9%89%E8%B7%AF%E5%BE%84&mode=auto#ENC%2BVision-Xhttp-ARGO
| 变量名 | 描述 | 示例值 |
|---|---|---|
CLOUDFLARED_TOKEN |
必备 | 设置cf tunel时获取token(镜像默认localhost:8001) |
UUID |
自定义uuid-必需 | 5936acb6-e65e-4631-bedf-ce723a1a375d |
PROXY_PATH |
自定义path-必需 | /5936acb6 |
DOMAIN |
容器本地域名(首次部署后可见)-必需 | xxx.koyeb.app |
-
Sources: 填写docker镜像地址
ghcr.io/xxx/xxx(建议fork后创建自己的docker镜像)。 -
Environment variables and files: 填入您准备好的
ENC_CONFIG值。(UUID首次,PROXY_PATH首次,CLOUDFLARED_TOKEN首次,DOMAIN/此变量需要初次部署后可见) -
Instance: 选择CPU Eco免费配置DE&US。
-
Ports: 需要开启一个7860默认暴露端口(开启Public HTTPS access)
-
点击 "Deploy" 完成首次部署。
-
部署完成后,记下 Koyeb 分配给您的服务 URL,例如
https://koyebne-xxxxx.koyeb.app,这个 URL 将用于后续项目保活配置。 选择setting>添加最后一个变量DOMAIN(必须,未设置则项目约1h后会自动休眠)
为了确保 Koyeb 部署的服务不会因长时间(14天未登录)不活跃而被暂停项目,提供了 worker.js 文件,可部署到 Cloudflare Workers 实现定时访问保活。
TOKEN获取方式:koyeb主页左下角,点击个人账户头像,——>用户设置——>个人访问令牌——>创建——>记下token
- 创建一个新的 Cloudflare Worker。
- 将本项目中的
worker.js文件内容复制并粘贴到您的 Worker 代码中。
在 Cloudflare Worker 的设置中,您需要配置以下环境变量:
| 变量名 | 描述 | 示例值 |
|---|---|---|
TARGET_URL |
您在 Koyeb 部署的服务 URL。 | https://koyebne-xxxxx.koyeb.app |
AUTH_TOKEN |
用于 Worker 身份验证的密钥。自行获取koyeb账户所提供的token | your-token |
在 Cloudflare Worker 的设置中,配置 Cron Trigger (定时任务),例如每隔 5 分钟 触发一次。
- Cron 表达式示例 (每天一次登录账户保活):
0 0 * * *
- Cloudflare Worker 定时被 Cron Trigger 触发。
- Worker 向 Koyeb 服务的
TARGET_URL发送一个带有X-Worker-Token请求头的请求。 - Koyeb 服务接收到请求,验证
X-Worker-Token是否与WORKER_TOKEN匹配。 - 验证通过,服务保持活跃。
- 资源限制: Koyeb 的免费层级有资源使用限制。请合理使用,避免因超限而被暂停。
- 安全: 请务必使用复杂且不易猜测的 Path 和 UUID,以增强您的代理节点的安全性。
如果您需要本地测试,请确保您已安装 Docker 环境:
# 克隆项目
git clone https://github.com/justlagom/koyebne.git
cd koyebne
# (可选) 在本地创建一个 .env 文件来设置您的 ENC_CONFIG
# 构建 Docker 镜像
docker build -t koyebne:latest .
# 运行容器 (替换为您的配置)
docker run -d -p 8080:8080 \
-e ENC_CONFIG='{"uuid": "your-uuid", "path": "/testpath", "port": 8080}' \
koyebne:latest该项目基于 MIT License 发布。
希望这份 README 能够清晰地展示您的项目!