Skip to content

justlagom/koyebne

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

56 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation


🚀 Koyeb - ENC+Vioion-Xhttp-ARGO 代理节点

一个部署在 Koyeb Serverless Platform 上的 ENC+Vioion-Xhttp-ARGO 代理节点项目,旨在提供一个稳定、快速的代理服务。

该项目利用 Koyeb 的持续运行能力,并通过部署在 Cloudflare Workers 的 worker.js 文件实现远程登录保活,确保服务的持久可用性。


✨ 主要特性

  • 多协议支持: 集成了 ENCVioionXhttpARGO 代理协议。
  • 平台稳定: 部署在 Koyeb 平台,享受其高性能和全球边缘网络。
  • 远程保活: 通过 Cloudflare Worker 定时访问,解决 Koyeb 因长期未登录而暂停或回收项目的问题。

⚙️ 部署指南 (Koyeb)

步骤 1: 准备环境变量

koyebne/app/xy/config.json-可选择手搓其他xray配置

节点参考模板:

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

在部署到 Koyeb 之前,您需要设置核心的代理配置参数uuidpath,也可手搓更改xray配置文件。

变量名 描述 示例值
CLOUDFLARED_TOKEN 必备 设置cf tunel时获取token(镜像默认localhost:8001)
UUID 自定义uuid-必需 5936acb6-e65e-4631-bedf-ce723a1a375d
PROXY_PATH 自定义path-必需 /5936acb6
DOMAIN 容器本地域名(首次部署后可见)-必需 xxx.koyeb.app

步骤 2: 一键部署

点击下方的 Koyeb 部署按钮,系统将自动跳转到 Koyeb 部署页面:

Koyeb Serverless Platform

  1. Sources: 填写docker镜像地址 ghcr.io/xxx/xxx(建议fork后创建自己的docker镜像)。

  2. Environment variables and files: 填入您准备好的 ENC_CONFIG 值。(UUID首次,PROXY_PATH首次,CLOUDFLARED_TOKEN首次,DOMAIN/此变量需要初次部署后可见)

  3. Instance: 选择CPU Eco免费配置DE&US。

  4. Ports: 需要开启一个7860默认暴露端口(开启Public HTTPS access

  5. 点击 "Deploy" 完成首次部署。

  6. 部署完成后,记下 Koyeb 分配给您的服务 URL,例如 https://koyebne-xxxxx.koyeb.app,这个 URL 将用于后续项目保活配置。 选择setting>添加最后一个变量DOMAIN(必须,未设置则项目约1h后会自动休眠)


💡 Worker 账号保活机制 (Cloudflare)

为了确保 Koyeb 部署的服务不会因长时间(14天未登录)不活跃而被暂停项目,提供了 worker.js 文件,可部署到 Cloudflare Workers 实现定时访问保活。

步骤 1: 获取 koyeb账号登录token

TOKEN获取方式:koyeb主页左下角,点击个人账户头像,——>用户设置——>个人访问令牌——>创建——>记下token

步骤 2: 部署 Cloudflare Worker

  1. 创建一个新的 Cloudflare Worker。
  2. 将本项目中的 worker.js 文件内容复制并粘贴到您的 Worker 代码中。

步骤 3: 配置 Worker 环境变量

在 Cloudflare Worker 的设置中,您需要配置以下环境变量:

变量名 描述 示例值
TARGET_URL 您在 Koyeb 部署的服务 URL。 https://koyebne-xxxxx.koyeb.app
AUTH_TOKEN 用于 Worker 身份验证的密钥。自行获取koyeb账户所提供的token your-token

步骤 4: 配置 Worker 定时任务 (Cron Trigger)

在 Cloudflare Worker 的设置中,配置 Cron Trigger (定时任务),例如每隔 5 分钟 触发一次。

  • Cron 表达式示例 (每天一次登录账户保活): 0 0 * * *

🔄 保活流程

  1. Cloudflare Worker 定时被 Cron Trigger 触发。
  2. Worker 向 Koyeb 服务的 TARGET_URL 发送一个带有 X-Worker-Token 请求头的请求。
  3. Koyeb 服务接收到请求,验证 X-Worker-Token 是否与 WORKER_TOKEN 匹配。
  4. 验证通过,服务保持活跃。

⚠️ 注意事项

  • 资源限制: Koyeb 的免费层级有资源使用限制。请合理使用,避免因超限而被暂停。
  • 安全: 请务必使用复杂且不易猜测的 PathUUID,以增强您的代理节点的安全性。

🛠️ 本地开发与测试

如果您需要本地测试,请确保您已安装 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

📄 License

该项目基于 MIT License 发布。


希望这份 README 能够清晰地展示您的项目!

About

这是一个可部署在koyeb平台上的(ENC+Vision-Xhttp-ARGO)代理节点的镜像;保活项目(_worker.js)部署至cf worker平台,通过 API token方式登录,实现账号保活

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors