/nodejs-proxy

@3kmfi6hp/nodejs-proxy 是一个 Node.js 包,使用命令 nodejs-proxy 简单实现 vless

Primary LanguageJavaScriptOtherNOASSERTION

@3kmfi6hp/nodejs-proxy

@3kmfi6hp/nodejs-proxy 是一个基于 Node.js 的 vless 实现包。它在各种 Node.js 环境中都能运行,包括但不限于:Windows、Linux、MacOS、Android、iOS、树莓派等。同时,它也适用于各种 PaaS 平台,如:replit、heroku 等。

GitHub license npm

特性

  • 在 PaaS 平台上更难被检测和封锁
  • 使用简单,支持自定义端口和 UUID
  • 支持通过 Dockerfile 部署
  • 可在 fly.io、replit、codesandbox 等平台上部署。 部署方法
  • 可以在 plesk 服务器上部署 使用 https://heliohost.org/

安装

您可以通过 npm 全局安装 @3kmfi6hp/nodejs-proxy:

npm install -g @3kmfi6hp/nodejs-proxy

如果您不想全局安装,也可以在项目目录下执行以下命令进行安装:

npm install @3kmfi6hp/nodejs-proxy

使用

在安装完成后,您可以通过以下命令启动代理服务:

nodejs-proxy

自定义端口和 UUID

@3kmfi6hp/nodejs-proxy 提供 --port--uuid 选项,用于自定义代理服务的端口和 UUID。默认端口 7860,默认 UUID "d342d11e-d424-4583-b36e-524ab1f0afa4"

nodejs-proxy -p 7860 -u d342d11e-d424-4583-b36e-524ab1f0afa4
# 或者您可以使用以下命令
nodejs-proxy --port 7860 --uuid d342d11e-d424-4583-b36e-524ab1f0afa4

查看帮助

您可以通过 --help 选项查看 NodeJS-Proxy 的使用帮助:

nodejs-proxy --help
Options:
      --version  Show version number                                   [boolean]
  -p, --port     Specify the port number                         [default: 7860]
  -u, --uuid     Specify the uuid
                               [default: "d342d11e-d424-4583-b36e-524ab1f0afa4"]
      --help     Show help                                             [boolean]

使用 npx

如果您没有全局安装 @3kmfi6hp/nodejs-proxy,可以使用 npx 来运行 @3kmfi6hp/nodejs-proxy:

npx nodejs-proxy

同样,您也可以使用 --port--uuid 选项来自定义端口和 UUID:

npx nodejs-proxy -p 7860 -u d342d11e-d424-4583-b36e-524ab1f0afa4
# 或者您可以使用以下命令
npx nodejs-proxy --port 7860 --uuid d342d11e-d424-4583-b36e-524ab1f0afa4

您也可以使用 npx @3kmfi6hp/nodejs-proxy 来替代 npx nodejs-proxy

npx @3kmfi6hp/nodejs-proxy -p 7860 -u d342d11e-d424-4583-b36e-524ab1f0afa4
npx @3kmfi6hp/nodejs-proxy -p 7860
npx @3kmfi6hp/nodejs-proxy -u d342d11e-d424-4583-b36e-524ab1f0afa4
npx @3kmfi6hp/nodejs-proxy

查看帮助:

npx nodejs-proxy --help
Options:
      --version  Show version number                                   [boolean]
  -p, --port     Specify the port number                         [default: 7860]
  -u, --uuid     Specify the uuid
                               [default: "d342d11e-d424-4583-b36e-524ab1f0afa4"]
      --help     Show help                                             [boolean]

Usage in Node.js

index.js

// 引入 createVLESSServer 函数
const { createVLESSServer } = require("@3kmfi6hp/nodejs-proxy");
// 定义端口和 UUID
const port = 3001;
const uuid = "d342d11e-d424-4583-b36e-524ab1f0afa4";

// 调用函数启动 VLESS 服务器
createVLESSServer(port, uuid);

package.json

{
  "name": "nodejs-proxy-example",
  "version": "1.0.0",
  "description": "An example of @3kmfi6hp/nodejs-proxy",
  "main": "index.js",
  "scripts": {
    "start": "node index.js"
  },
  "author": "3Kmfi6HP",
  "license": "MIT",
  "dependencies": {
    "@3kmfi6hp/nodejs-proxy": "latest"
  }
}
npm install
npm start # 或者您可以使用 node index.js

环境变量

环境变量 描述 默认值
PORT 代理服务的端口号 7860
UUID 代理服务的 UUID d342d11e-d424-4583-b36e-524ab1f0afa4

Dockerfile 使用

FROM node:latest
ENV PORT=7860
ENV UUID=d342d11e-d424-4583-b36e-524ab1f0afa4
# EXPOSE 7860
RUN npm i -g @3kmfi6hp/nodejs-proxy
CMD ["nodejs-proxy"]

在 fly.io 上部署:

# fly.toml file generated for nodejs-proxy

# App name (optional) needs to be changed if you have multiple apps
app = "nodejs-proxy"
primary_region = "sin" # Replace with the region closest to you, e.g. ord
kill_signal = "SIGINT"
kill_timeout = "5s"

# Docker image to use
image = "flyio/node"

# HTTP port
[env]
PORT = "7860"

# UUID
[env]
UUID = "d342d11e-d424-4583-b36e-524ab1f0afa4"

# Command to start the app
[cmd]
# Start the proxy
start = "nodejs-proxy"

[[services]]
  protocol = "tcp"
  internal_port = 7860
  processes = ["app"]

  [[services.ports]]
    port = 7860
    handlers = ["http"]
    force_https = true

  [[services.ports]]
    port = 443
    handlers = ["tls", "http"]
  [services.concurrency]
    type = "connections"
    hard_limit = 25
    soft_limit = 20

  [[services.tcp_checks]]
    interval = "15s"
    timeout = "2s"
    grace_period = "1s"
    restart_limit = 0

连接方法

例如使用 http:vless://d342d11e-d424-4583-b36e-524ab1f0afa4@127.0.0.1:8787?encryption=none&security=none&fp=randomized&type=ws&path=%2F#defaultvless 地址的参数可解析如下:

  • d342d11e-d424-4583-b36e-524ab1f0afa4:这是一个 UUID(Universally Unique Identifier),在本场景中,通常作为用户标识使用。
  • 127.0.0.1:8787: 这是一个 IP 地址和端口号,这里指定了 vless 连接到的服务器地址(127.0.0.1 就是本地的环回地址,也就是说服务器就在本机)和端口号 (8787)。
  • encryption=none:这意味着不使用任何加密方法。
  • security=none:这表示不启用任何额外的安全特性。
  • fp=randomized:这可能是指流量的伪装或混淆方法,fp 可能是 fingerprint(指纹)的缩写,random 表示采取随机化处理。
  • type=ws:指定了传输协议类型,这里使用的是 WebSocket 协议 (ws)。
  • path=%2F:URL 的路径,这里的 %2F 实际是 URL 编码,对应的字符为 /,所以路径为 /
  • #default:这是你的 vless 配置的别名,用于方便辨识。

例如使用 https:vless://d342d11e-d424-4583-b36e-524ab1f0afa4@link-to-your-replit-project.repl.co:443?encryption=none&security=tls&fp=random&type=ws&path=%2Fws#link-to-your-replit-project.repl.covless 地址的参数可解析如下:

  • d342d11e-d424-4583-b36e-524ab1f0afa4:这是一个 UUID(Universally Unique Identifier),在本场景中,通常作为用户标识使用。
  • link-to-your-replit-project.repl.co:443: 这是一个 IP 地址和端口号,这里指定了 vless 连接到的服务器地址(link-to-your-replit-project.repl.co 就是连接地址域名,也就是说服务器就在那里)和端口号 (443)。
  • encryption=none:这意味着不使用任何加密方法。
  • security=tls:这表示启用 tls 安全特性。
  • fp=random:这可能是指流量的伪装或混淆方法,fp 可能是 fingerprint(指纹)的缩写,random 表示采取随机化处理。
  • type=ws:指定了传输协议类型,这里使用的是 WebSocket 协议 (ws)。
  • path=%2Fws:URL 的路径,这里的 %2F 实际是 URL 编码,对应的字符为 /,所以路径为 /ws
  • #link-to-your-replit-project.repl.co:这是你的 vless 配置的别名,用于方便辨识。

请参考具体的 vless 文档以获取更加详细的信息。部分参数可能依赖于具体的 vless 客户端和服务器的实现,可能需要根据实际情况进行调整。

相关项目

这些项目旨在为不同平台提供简单易用的 Node.js 代理。它们允许用户轻松地在其首选平台上部署和使用代理服务器,并提供了一种安全、私密地访问互联网的便捷方式。每个项目都针对特定的平台进行了定制,并提供了与平台特性和功能的无缝集成

免责声明

本项目仅供学习和研究使用,严禁用于任何违反当地法律法规的行为。使用本项目所造成的任何后果,由使用者自行承担,本项目作者不承担任何法律责任。

使用本项目即表示您已经阅读并同意上述免责声明。

This readme was written by GitHub Copilot.