Sing-box Converter

Это модуль Node.js (ESM) для преобразования прокси-ссылок и файлов конфигурации в формат JSON Sing-box и обратно. Он основан на логике из Nekobox.

Поддерживаемые протоколы

Модуль поддерживает парсинг и генерацию ссылок для следующих протоколов:

• VMess
• VLESS
• Trojan
• Shadowsocks (ss)
• Socks (socks, socks4, socks4a, socks5)
• HTTP/HTTPS
• Hysteria / Hysteria2 (hy2)
• TUIC
• WireGuard (wg)
• SSH

Поддерживаемые форматы ввода

Функция convertToOutbounds может автоматически определять и обрабатывать следующие форматы ввода:

• Отдельные прокси-ссылки: Например, vless://...
• Ссылки, разделенные пробелами или новыми строками: Текстовый блок, содержащий несколько ссылок.
• Список ссылок в кодировке Base64: Одна строка Base64, которая декодируется в список ссылок.
• Конфигурация Clash (YAML): Полный или частичный файл конфигурации в формате YAML, содержащий раздел proxies.
• Конфигурация WireGuard (.conf): Стандартный формат файла конфигурации [Interface] и [Peer].

Установка

npm install singbox-converter

Использование

Импорт модуля

Поскольку это пакет ESM, используйте синтаксис import:

import {
    convertToOutbounds,
    convertOutboundsToLinks,
    convertOutboundToLink
} from 'singbox-converter';

Быстрый старт

Пример 1: Преобразование ссылки VLESS в объект outbound Sing-box

import { convertToOutbounds } from 'singbox-converter';

const proxyLink = "vless://uuid@example.com:443?encryption=none&security=reality&sni=example.com&fp=chrome&pbk=publicKey&sid=shortId&type=ws&path=/path&host=example.com#My-VLESS-Config";

async function run() {
    const outbounds = await convertToOutbounds(proxyLink);
    console.log(JSON.stringify(outbounds, null, 2));
}

run();

Пример 2: Преобразование объекта outbound Sing-box обратно в ссылку

import { convertOutboundToLink } from 'singbox-converter';

const singboxOutbound = {
  "tag": "My-VLESS-Config",
  "server": "example.com",
  "server_port": 443,
  "uuid": "uuid",
  "type": "vless",
  "tls": {
    "enabled": true,
    "insecure": false,
    "server_name": "example.com",
    "reality": {
      "enabled": true,
      "public_key": "publicKey",
      "short_id": "shortId"
    },
    "utls": {
      "enabled": true,
      "fingerprint": "chrome"
    }
  },
  "transport": {
    "type": "ws",
    "path": "/path",
    "headers": {
      "Host": "example.com"
    }
  }
};

const link = convertOutboundToLink(singboxOutbound);
console.log(link); // vless://uuid@example.com:443?type=ws&security=reality&sni=example.com&fp=chrome&pbk=publicKey&sid=shortId&path=%2Fpath&host=example.com#My-VLESS-Config

API

convertToOutbounds(input, [options])

Асинхронная функция, которая преобразует один или несколько прокси-серверов (из ссылок или файла конфигурации) в массив объектов outbound для конфигурации Sing-box.

Параметры:

• input: string Может быть одним из следующих:

  • Одна ссылка в виде строки.
  • Строка, содержащая несколько ссылок, разделенных пробелами или новыми строками.
  • Строка, содержащая список ссылок в кодировке Base64.
  • Строка, содержащая полную конфигурацию в формате Clash (YAML) или WireGuard (.conf).

• options (необязательный): object Объект с опциями преобразования:

  • outputPath: string - Если указано, результат будет сохранен в файл по этому пути, и функция вернет undefined.
  • pretty: boolean - (по умолчанию true) Форматировать ли выходной JSON с отступами.
  • globalAllowInsecure: boolean - (по умолчанию false) Применить insecure: true ко всем конфигурациям TLS, где это применимо.

Возвращает: Promise<Object[] | undefined>

Возвращает промис, который разрешается в массив объектов outbound Sing-box. Если была использована опция outputPath, промис разрешится в undefined.

convertOutboundToLink(outbound)

Синхронная функция, которая преобразует один объект outbound из конфигурации Sing-box обратно в соответствующий формат прокси-ссылки.

Параметры:

• outbound: object Один действительный объект outbound из JSON-конфигурации Sing-box.

Возвращает: string

Соответствующая прокси-ссылка в виде строки. В случае ошибки преобразования вернет ссылку в формате error://conversion-failed?message=....

convertOutboundsToLinks(outbounds)

Синхронная функция, которая преобразует массив объектов outbound Sing-box в массив ссылок.

Параметры:

• outbounds: object[] Массив объектов outbound.

Возвращает: string[]

Массив прокси-ссылок.

Автор

Разработано OpexDev