@qingchencloud/qy-server 1.0.2

package/README.md

@@ -0,0 +1,110 @@
+# @qingchencloud/qy-server
+
+晴云私有代理服务端 - 一个轻量级、高性能的私有代理服务器。
+
+## 功能特性
+
+- ✅ TLS 1.3 加密 - 流量伪装成 HTTPS
+- ✅ TCP/UDP 代理 - 全协议支持
+- ✅ 端口转发 - 本地端口映射到远程
+- ✅ 内网穿透 - 将内网服务暴露到公网
+- ✅ 流量统计 - 实时监控
+- ✅ 多密钥支持 - 灵活的访问控制
+
+## 快速安装
+
+```bash
+# 全局安装
+npm install -g @qingchencloud/qy-server
+
+# 或使用 npx 直接运行
+npx @qingchencloud/qy-server
+```
+
+## 使用方法
+
+### 命令行
+
+```bash
+# 显示帮助
+qy-server --help
+
+# 使用配置文件启动
+qy-server -c config.yaml
+
+# 生成密钥哈希
+qy-server -genkey "my-secret-key"
+```
+
+### 编程方式
+
+```javascript
+const qyServer = require('@qingchencloud/qy-server');
+
+// 生成配置文件
+const { configPath, key } = qyServer.generateConfig('./config.yaml', {
+    listen: ':443',
+    cert: '/path/to/cert.pem',
+    keyFile: '/path/to/key.pem'
+});
+console.log('访问密钥:', key);
+
+// 启动服务器
+const server = qyServer.start({ config: configPath });
+
+// 获取版本
+console.log(qyServer.version());
+
+// 生成密钥哈希
+const hash = qyServer.generateKeyHash('my-secret-key');
+```
+
+## 配置文件示例
+
+```yaml
+server:
+  listen: ":443"
+  cert: "/etc/ssl/cert.pem"
+  key: "/etc/ssl/key.pem"
+
+auth:
+  keys:
+    - "your-secret-key"
+
+features:
+  proxy: true
+  port_forward: true
+  nat_penetration: true
+
+limits:
+  max_connections: 1000
+  bandwidth_limit: 0
+  idle_timeout: 300
+```
+
+## 客户端配置
+
+在 ClashDIY 中添加节点：
+
+```yaml
+proxies:
+  - name: "我的私有节点"
+    type: qyproto
+    server: your-server.com
+    port: 443
+    password: "your-secret-key"
+```
+
+## 系统要求
+
+- Node.js >= 14
+- 支持平台：Windows (x64), Linux (x64/arm64), macOS (x64/arm64)
+
+## 许可证
+
+MIT
+
+## 相关链接
+
+- [GitHub](https://github.com/1186258278/QingYun)
+- [问题反馈](https://github.com/1186258278/QingYun/issues)

package/lib/index.js

@@ -0,0 +1,184 @@
+#!/usr/bin/env node
+/**
+ * QY-Server NPM 包入口
+ * 提供编程方式启动和命令行调用
+ */
+
+const { spawn, execSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+// 获取二进制文件路径
+function getBinaryPath() {
+    const ext = process.platform === 'win32' ? '.exe' : '';
+    const binaryPath = path.join(__dirname, '..', 'bin', `qy-server${ext}`);
+    
+    if (!fs.existsSync(binaryPath)) {
+        throw new Error(
+            '二进制文件不存在，请运行: npm run postinstall\n' +
+            '或手动下载二进制文件到: ' + binaryPath
+        );
+    }
+    
+    return binaryPath;
+}
+
+/**
+ * 启动 QY-Server
+ * @param {Object} options 选项
+ * @param {string} options.config 配置文件路径
+ * @param {boolean} options.daemon 是否后台运行
+ * @returns {ChildProcess} 子进程
+ */
+function start(options = {}) {
+    const binaryPath = getBinaryPath();
+    const args = [];
+    
+    if (options.config) {
+        args.push('-c', options.config);
+    }
+    
+    const child = spawn(binaryPath, args, {
+        stdio: options.daemon ? 'ignore' : 'inherit',
+        detached: options.daemon || false
+    });
+    
+    if (options.daemon) {
+        child.unref();
+    }
+    
+    return child;
+}
+
+/**
+ * 获取版本信息
+ * @returns {string} 版本号
+ */
+function version() {
+    const binaryPath = getBinaryPath();
+    try {
+        const output = execSync(`"${binaryPath}" -v`, { encoding: 'utf8' });
+        return output.trim();
+    } catch (error) {
+        return require('../package.json').version;
+    }
+}
+
+/**
+ * 生成密钥哈希
+ * @param {string} key 原始密钥
+ * @returns {string} SHA256 哈希
+ */
+function generateKeyHash(key) {
+    const binaryPath = getBinaryPath();
+    try {
+        const output = execSync(`"${binaryPath}" -genkey "${key}"`, { encoding: 'utf8' });
+        const match = output.match(/SHA256 哈希: ([a-f0-9]+)/);
+        return match ? match[1] : null;
+    } catch (error) {
+        // 如果二进制调用失败，使用 Node.js 计算
+        const crypto = require('crypto');
+        return crypto.createHash('sha256').update(key).digest('hex');
+    }
+}
+
+/**
+ * 生成配置文件
+ * @param {string} outputPath 输出路径
+ * @param {Object} options 配置选项
+ */
+function generateConfig(outputPath, options = {}) {
+    const key = options.key || require('crypto').randomBytes(16).toString('hex');
+    
+    const config = `# QY-Server 配置文件
+# 生成时间: ${new Date().toISOString()}
+
+server:
+  listen: "${options.listen || ':443'}"
+  cert: "${options.cert || ''}"
+  key: "${options.keyFile || ''}"
+  fallback: "${options.fallback || 'https://www.baidu.com'}"
+
+auth:
+  keys:
+    - "${key}"
+
+features:
+  proxy: ${options.proxy !== false}
+  port_forward: ${options.portForward !== false}
+  nat_penetration: ${options.natPenetration !== false}
+
+limits:
+  max_connections: ${options.maxConnections || 1000}
+  bandwidth_limit: ${options.bandwidthLimit || 0}
+  idle_timeout: ${options.idleTimeout || 300}
+
+logging:
+  level: "${options.logLevel || 'info'}"
+  file: "${options.logFile || ''}"
+`;
+    
+    fs.writeFileSync(outputPath, config, { mode: 0o600 });
+    
+    return { configPath: outputPath, key };
+}
+
+// 导出 API
+module.exports = {
+    start,
+    version,
+    generateKeyHash,
+    generateConfig,
+    getBinaryPath
+};
+
+// 如果直接运行，执行 CLI
+if (require.main === module) {
+    const args = process.argv.slice(2);
+    
+    if (args.includes('--version') || args.includes('-v')) {
+        console.log(version());
+        process.exit(0);
+    }
+    
+    if (args.includes('--help') || args.includes('-h')) {
+        console.log(`
+QY-Server 晴云私有代理服务端
+
+用法:
+  qy-server [选项]
+  npx @qingchencloud/qy-server [选项]
+
+选项:
+  -c <path>     配置文件路径 (默认: config.yaml)
+  -v            显示版本信息
+  -genkey <key> 生成密钥的 SHA256 哈希
+  -h, --help    显示帮助信息
+
+示例:
+  qy-server -c /etc/qy-server/config.yaml
+  qy-server -genkey "my-secret-key"
+
+更多信息: https://github.com/1186258278/QingYun
+`);
+        process.exit(0);
+    }
+    
+    // 传递给二进制执行
+    try {
+        const binaryPath = getBinaryPath();
+        const child = spawn(binaryPath, args, { stdio: 'inherit' });
+        
+        child.on('exit', (code) => {
+            process.exit(code || 0);
+        });
+        
+        child.on('error', (error) => {
+            console.error('启动失败:', error.message);
+            process.exit(1);
+        });
+    } catch (error) {
+        console.error(error.message);
+        process.exit(1);
+    }
+}

package/lib/install.js

@@ -0,0 +1,193 @@
+#!/usr/bin/env node
+/**
+ * QY-Server 安装脚本
+ * 在 npm install 后自动下载对应平台的二进制文件
+ */
+
+const https = require('https');
+const http = require('http');
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+const zlib = require('zlib');
+
+// 配置
+const PACKAGE_NAME = '@qingchencloud/qy-server';
+const VERSION = require('../package.json').version;
+const GITHUB_REPO = '1186258278/QingYun';
+
+// 获取平台信息
+function getPlatformInfo() {
+    const platform = process.platform;
+    const arch = process.arch;
+
+    const platformMap = {
+        'darwin': 'darwin',
+        'linux': 'linux',
+        'win32': 'windows'
+    };
+
+    const archMap = {
+        'x64': 'amd64',
+        'arm64': 'arm64'
+    };
+
+    const os = platformMap[platform];
+    const cpu = archMap[arch];
+
+    if (!os || !cpu) {
+        throw new Error(`不支持的平台: ${platform}-${arch}`);
+    }
+
+    const ext = platform === 'win32' ? '.exe' : '';
+    const binaryName = `qy-server-${os}-${cpu}${ext}`;
+
+    return { os, cpu, ext, binaryName, platform, arch };
+}
+
+// 下载文件
+function downloadFile(url, destPath) {
+    return new Promise((resolve, reject) => {
+        console.log(`下载: ${url}`);
+
+        const file = fs.createWriteStream(destPath);
+        const protocol = url.startsWith('https') ? https : http;
+
+        const request = protocol.get(url, (response) => {
+            // 处理重定向
+            if (response.statusCode === 301 || response.statusCode === 302) {
+                file.close();
+                fs.unlinkSync(destPath);
+                return downloadFile(response.headers.location, destPath)
+                    .then(resolve)
+                    .catch(reject);
+            }
+
+            if (response.statusCode !== 200) {
+                file.close();
+                fs.unlinkSync(destPath);
+                reject(new Error(`下载失败: HTTP ${response.statusCode}`));
+                return;
+            }
+
+            const total = parseInt(response.headers['content-length'], 10);
+            let downloaded = 0;
+
+            response.on('data', (chunk) => {
+                downloaded += chunk.length;
+                if (total) {
+                    const percent = ((downloaded / total) * 100).toFixed(1);
+                    process.stdout.write(`\r下载进度: ${percent}%`);
+                }
+            });
+
+            response.pipe(file);
+
+            file.on('finish', () => {
+                file.close();
+                console.log('\n下载完成');
+                resolve();
+            });
+        });
+
+        request.on('error', (err) => {
+            file.close();
+            fs.unlinkSync(destPath);
+            reject(err);
+        });
+    });
+}
+
+// 获取下载 URL
+function getDownloadUrl(binaryName) {
+    // 优先使用 GitHub Releases
+    const githubUrl = `https://github.com/${GITHUB_REPO}/releases/download/v${VERSION}/${binaryName}`;
+    
+    // 备用：使用 npm registry 存储（需要额外配置）
+    // const npmUrl = `https://registry.npmmirror.com/${PACKAGE_NAME}/-/${binaryName}`;
+    
+    return githubUrl;
+}
+
+// 检查本地编译的二进制文件
+function checkLocalBinary(info) {
+    const localPaths = [
+        path.join(__dirname, '..', '..', 'dist', info.binaryName),
+        path.join(__dirname, '..', '..', info.binaryName),
+        path.join(__dirname, '..', '..', `qy-server${info.ext}`)
+    ];
+
+    for (const localPath of localPaths) {
+        if (fs.existsSync(localPath)) {
+            console.log(`使用本地二进制文件: ${localPath}`);
+            return localPath;
+        }
+    }
+    return null;
+}
+
+// 主安装函数
+async function install() {
+    console.log('========================================');
+    console.log('  QY-Server 安装程序');
+    console.log('========================================\n');
+
+    try {
+        const info = getPlatformInfo();
+        console.log(`平台: ${info.platform} (${info.arch})`);
+        console.log(`二进制文件: ${info.binaryName}\n`);
+
+        const binDir = path.join(__dirname, '..', 'bin');
+        const binaryPath = path.join(binDir, `qy-server${info.ext}`);
+
+        // 确保 bin 目录存在
+        if (!fs.existsSync(binDir)) {
+            fs.mkdirSync(binDir, { recursive: true });
+        }
+
+        // 检查是否已安装
+        if (fs.existsSync(binaryPath)) {
+            console.log('二进制文件已存在，跳过下载');
+            return;
+        }
+
+        // 检查本地编译的文件
+        const localBinary = checkLocalBinary(info);
+        if (localBinary) {
+            fs.copyFileSync(localBinary, binaryPath);
+            fs.chmodSync(binaryPath, 0o755);
+            console.log('安装完成（使用本地文件）');
+            return;
+        }
+
+        // 下载二进制文件
+        const downloadUrl = getDownloadUrl(info.binaryName);
+        
+        try {
+            await downloadFile(downloadUrl, binaryPath);
+            fs.chmodSync(binaryPath, 0o755);
+            console.log('\n安装完成！');
+        } catch (downloadError) {
+            console.error(`\n下载失败: ${downloadError.message}`);
+            console.log('\n请手动下载或编译二进制文件:');
+            console.log(`  1. 从 GitHub Releases 下载: https://github.com/${GITHUB_REPO}/releases`);
+            console.log('  2. 或克隆仓库后运行: go build -o qy-server ./cmd/qy-server');
+            console.log(`  3. 将二进制文件复制到: ${binaryPath}`);
+            
+            // 创建一个占位脚本
+            const placeholder = info.platform === 'win32' 
+                ? '@echo 请先下载 qy-server 二进制文件\n@exit /b 1'
+                : '#!/bin/sh\necho "请先下载 qy-server 二进制文件"\nexit 1';
+            
+            fs.writeFileSync(binaryPath, placeholder);
+            fs.chmodSync(binaryPath, 0o755);
+        }
+
+    } catch (error) {
+        console.error('安装失败:', error.message);
+        process.exit(1);
+    }
+}
+
+// 运行安装
+install().catch(console.error);

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@qingchencloud/qy-server",
+  "version": "1.0.2",
+  "description": "晴云私有代理服务端 - 支持 TLS 加密、端口转发、内网穿透",
+  "keywords": [
+    "proxy",
+    "vpn",
+    "tunnel",
+    "nat",
+    "port-forward",
+    "tls",
+    "private-proxy"
+  ],
+  "homepage": "https://github.com/1186258278/QingYun",
+  "bugs": {
+    "url": "https://github.com/1186258278/QingYun/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/1186258278/QingYun.git"
+  },
+  "license": "MIT",
+  "author": "qingchencloud",
+  "main": "lib/index.js",
+  "bin": {
+    "qy-server": "bin/qy-server"
+  },
+  "scripts": {
+    "postinstall": "node lib/install.js",
+    "test": "node lib/index.js --version"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=14"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}