@lppx/lanshare 1.0.1

package/README.md

@@ -0,0 +1,121 @@
+# LanShare - 局域网文件分享工具
+
+一个简单易用的局域网文件分享工具，支持通过浏览器上传和下载文件。
+
+## 功能特性
+
+- 🚀 交互式命令行界面
+- 🌐 选择网卡和 IP 地址
+- 🔧 自定义端口号
+- 📤 文件上传
+- 📥 文件下载
+- 🎨 简洁的 Web 界面
+- 📝 完整的日志记录
+
+## 安装
+
+```bash
+npm install -g @lppx/lanshare
+```
+
+## 使用方法
+
+### 启动服务器
+
+```bash
+lanshare
+# 或
+lsh
+```
+
+### 交互式配置
+
+启动后会依次提示：
+
+1. 选择网卡
+2. 输入 IP 地址（默认为选中网卡的 IP）
+3. 输入端口号（默认 3000）
+
+### 访问服务
+
+启动成功后，在浏览器中访问显示的地址，例如：
+
+```
+http://192.168.1.100:3000
+```
+
+局域网内的其他设备也可以通过该地址访问。
+
+## 日志功能
+
+应用会自动记录运行日志，方便调试和问题排查。
+
+### 日志位置
+
+日志文件保存在用户主目录下：
+
+```
+~/.lanshare/logs/
+├── lanshare.log    # 所有日志
+└── error.log       # 仅错误日志
+```
+
+### 日志级别
+
+默认日志级别为 `info`，可通过环境变量 `LOG_LEVEL` 调整：
+
+```bash
+# 设置为 debug 级别查看更详细的日志
+LOG_LEVEL=debug lanshare
+
+# 可选级别: error, warn, info, debug
+```
+
+### 日志内容
+
+日志会记录以下信息：
+
+- 服务器启动/停止
+- HTTP 请求（IP、方法、路径）
+- 文件上传（文件名、大小）
+- 文件下载
+- 错误信息和堆栈跟踪
+
+### 日志轮转
+
+- 单个日志文件最大 5MB
+- 最多保留 5 个历史文件
+- 超出限制会自动清理旧日志
+
+## 开发
+
+### 安装依赖
+
+```bash
+npm install
+```
+
+### 构建
+
+```bash
+npm run build
+```
+
+### 本地测试
+
+```bash
+npm link
+lanshare
+```
+
+## 技术栈
+
+- TypeScript
+- Express
+- Commander
+- Prompts
+- Multer
+
+## 许可证
+
+MIT

package/dist/scripts/gitsync.js

@@ -0,0 +1,100 @@
+#!/usr/bin/env ts-node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const child_process_1 = require("child_process");
+const fs_1 = require("fs");
+const path_1 = require("path");
+// #region 颜色定义
+const colors = {
+    red: '\x1b[0;31m',
+    green: '\x1b[0;32m',
+    yellow: '\x1b[1;33m',
+    reset: '\x1b[0m',
+};
+// #endregion
+// #region 辅助函数
+function printSuccess(message) {
+    console.log(`${colors.green}✓ ${message}${colors.reset}`);
+}
+function printError(message) {
+    console.error(`${colors.red}✗ ${message}${colors.reset}`);
+}
+function printWarning(message) {
+    console.log(`${colors.yellow}⚠ ${message}${colors.reset}`);
+}
+// #endregion
+// #region Git 操作
+function execGit(command) {
+    try {
+        return (0, child_process_1.execSync)(`git ${command}`, {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe']
+        }).trim();
+    }
+    catch (error) {
+        throw new Error(error.stderr || error.message);
+    }
+}
+async function syncRepo() {
+    const dir = process.cwd();
+    console.log('开始同步仓库...');
+    // 检查是否在 git 仓库中
+    if (!(0, fs_1.existsSync)((0, path_1.join)(dir, '.git'))) {
+        printError('当前目录不是 git 仓库');
+        process.exit(1);
+    }
+    // 执行 git pull
+    console.log('正在拉取远程更改...');
+    try {
+        execGit('pull');
+        printSuccess('成功拉取远程更改');
+    }
+    catch (error) {
+        printError('拉取失败，可能存在冲突');
+        printWarning('请手动解决冲突后再运行此脚本');
+        console.error(error.message);
+        process.exit(1);
+    }
+    // 检查是否有更改需要提交
+    const status = execGit('status --porcelain');
+    if (!status) {
+        printWarning('没有需要提交的更改');
+        process.exit(0);
+    }
+    // 添加所有更改
+    console.log('正在添加所有更改...');
+    execGit('add -A');
+    printSuccess('已添加所有更改');
+    // 生成 commit message（当前日期和时间）
+    const now = new Date();
+    const commitMsg = now.toLocaleString('zh-CN', {
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+        second: '2-digit',
+        hour12: false,
+    }).replace(/\//g, '-');
+    console.log('正在提交更改...');
+    execGit(`commit -m "${commitMsg}"`);
+    printSuccess(`提交成功: ${commitMsg}`);
+    // 推送到远程仓库
+    console.log('正在推送到远程仓库...');
+    try {
+        execGit('push');
+        printSuccess('成功推送到远程仓库');
+    }
+    catch (error) {
+        printError('推送失败');
+        console.error(error.message);
+        process.exit(1);
+    }
+    printSuccess('仓库同步完成！');
+}
+// #endregion
+// 执行主函数
+syncRepo().catch((error) => {
+    printError(`发生错误: ${error.message}`);
+    process.exit(1);
+});

package/dist/src/app.js

@@ -0,0 +1,46 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createServer = createServer;
+const express_1 = __importDefault(require("express"));
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const http_1 = require("http");
+const upload_1 = require("./routers/upload");
+const files_1 = require("./routers/files");
+const logger_1 = __importDefault(require("./utils/logger"));
+const socket_1 = require("./socket");
+function createServer(config) {
+    const app = (0, express_1.default)();
+    const httpServer = (0, http_1.createServer)(app);
+    const { io, connectedDevices } = (0, socket_1.setupSocketIO)(httpServer); // 初始化 Socket.IO
+    const uploadDir = config.uploadDir || path_1.default.join(os_1.default.homedir(), 'lanshare-uploads');
+    // #region 确保上传目录存在
+    if (!fs_1.default.existsSync(uploadDir)) {
+        fs_1.default.mkdirSync(uploadDir, { recursive: true });
+        logger_1.default.info(`创建上传目录: ${uploadDir}`);
+    }
+    // #endregion
+    // #region 中间件
+    app.use(express_1.default.json());
+    app.use(express_1.default.urlencoded({ extended: true }));
+    app.use(express_1.default.static(path_1.default.join(__dirname, '../../public')));
+    // 请求日志中间件
+    app.use((req, _res, next) => {
+        logger_1.default.info(`${req.method} ${req.path} - ${req.ip}`);
+        next();
+    });
+    // #endregion
+    // #region 路由
+    app.use((0, upload_1.createUploadRouter)(uploadDir));
+    app.use((0, files_1.createFilesRouter)(uploadDir));
+    // 获取已连接设备列表
+    app.get('/api/devices', (_req, res) => {
+        res.json(Array.from(connectedDevices.values()));
+    });
+    // #endregion
+    return { app, httpServer, io, uploadDir, connectedDevices };
+}

package/dist/src/cli/cli.js

@@ -0,0 +1,131 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleStartCommand = handleStartCommand;
+const prompts_1 = __importDefault(require("prompts"));
+const index_1 = require("../index");
+const logger_1 = __importStar(require("../utils/logger"));
+const network_1 = require("./network");
+/**
+ * 处理 start 命令
+ */
+async function handleStartCommand() {
+    try {
+        logger_1.default.info('启动 lanshare 服务');
+        const networkInterfaces = (0, network_1.getNetworkInterfaces)();
+        if (networkInterfaces.length === 0) {
+            logger_1.default.error('未找到可用的网络接口');
+            process.exit(1);
+        }
+        // #region 选择网卡
+        const interfaceChoices = networkInterfaces.map(iface => ({
+            title: `${iface.name} (${iface.address})`,
+            value: iface
+        }));
+        const interfaceResponse = await (0, prompts_1.default)({
+            type: 'select',
+            name: 'interface',
+            message: '请选择网卡',
+            choices: interfaceChoices,
+            initial: 0
+        });
+        if (!interfaceResponse.interface) {
+            logger_1.default.info('用户取消操作');
+            process.exit(0);
+        }
+        const selectedInterface = interfaceResponse.interface;
+        // #endregion
+        // #region 输入 IP 地址
+        const ipResponse = await (0, prompts_1.default)({
+            type: 'text',
+            name: 'ip',
+            message: '请输入 IP 地址',
+            initial: selectedInterface.address,
+            validate: (value) => {
+                const ipRegex = /^(\d{1,3}\.){3}\d{1,3}$/;
+                if (!ipRegex.test(value)) {
+                    return 'IP 地址格式不正确';
+                }
+                const parts = value.split('.');
+                if (parts.some((part) => parseInt(part) > 255)) {
+                    return 'IP 地址范围不正确';
+                }
+                return true;
+            }
+        });
+        if (!ipResponse.ip) {
+            logger_1.default.info('用户取消操作');
+            process.exit(0);
+        }
+        // #endregion
+        // #region 输入端口号
+        const portResponse = await (0, prompts_1.default)({
+            type: 'text',
+            name: 'port',
+            message: '请输入端口号',
+            initial: '3001',
+            validate: (value) => {
+                if (!value || value.trim() === '') {
+                    return '端口号不能为空';
+                }
+                const port = Number(value);
+                if (isNaN(port) || port < 1 || port > 65535) {
+                    return '端口号必须在 1-65535 之间';
+                }
+                return true;
+            }
+        });
+        if (!portResponse.port) {
+            logger_1.default.info('用户取消操作');
+            process.exit(0);
+        }
+        // #endregion
+        const port = Number(portResponse.port);
+        logger_1.default.info(`配置完成 - IP: ${ipResponse.ip}, Port: ${port}`);
+        // 启动服务器
+        logger_1.default.info(`日志目录: ${logger_1.logDir}`);
+        await (0, index_1.startServer)({
+            ip: ipResponse.ip,
+            port: port
+        });
+    }
+    catch (error) {
+        logger_1.default.error('启动失败', error);
+        process.exit(1);
+    }
+}

package/dist/src/cli/index.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createProgram = createProgram;
+const commander_1 = require("commander");
+const cli_1 = require("./cli");
+/**
+ * 创建并配置命令行程序
+ */
+function createProgram() {
+    const program = new commander_1.Command();
+    program
+        .name('lanshare')
+        .description('局域网文件分享工具')
+        .version('1.0.0');
+    program
+        .command('start')
+        .description('启动文件分享服务器')
+        .action(cli_1.handleStartCommand);
+    return program;
+}
+async function main() {
+    const program = createProgram();
+    // 默认执行 start 命令
+    if (process.argv.length === 2) {
+        process.argv.push('start');
+    }
+    program.parse();
+}
+main();

package/dist/src/cli/network.js

@@ -0,0 +1,29 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getNetworkInterfaces = getNetworkInterfaces;
+const os_1 = __importDefault(require("os"));
+/**
+ * 获取所有可用的 IPv4 网络接口
+ */
+function getNetworkInterfaces() {
+    const interfaces = os_1.default.networkInterfaces();
+    const result = [];
+    for (const [name, addresses] of Object.entries(interfaces)) {
+        if (!addresses)
+            continue;
+        for (const addr of addresses) {
+            if (addr.family === 'IPv4' && !addr.internal) {
+                result.push({
+                    name,
+                    address: addr.address,
+                    family: addr.family,
+                    internal: addr.internal
+                });
+            }
+        }
+    }
+    return result;
+}

package/dist/src/cli.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// 此文件已废弃，请使用 src/cli/index.ts
+__exportStar(require("./cli/index"), exports);

package/dist/src/index.js

@@ -0,0 +1,26 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startServer = startServer;
+const app_1 = require("./app");
+const logger_1 = __importDefault(require("./utils/logger"));
+function startServer(config) {
+    const { httpServer, uploadDir } = (0, app_1.createServer)(config);
+    return new Promise((resolve, reject) => {
+        try {
+            httpServer.listen(config.port, config.ip, () => {
+                logger_1.default.info(`服务器启动成功✅ - http://${config.ip}:${config.port}`);
+                logger_1.default.info(`上传目录: ${uploadDir}`);
+                logger_1.default.info('Socket.IO 已启用，等待设备连接...');
+                logger_1.default.info('按 Ctrl+C 停止服务器');
+                resolve();
+            });
+        }
+        catch (error) {
+            logger_1.default.error('服务器启动失败', error);
+            reject(error);
+        }
+    });
+}

package/dist/src/routers/files.js

@@ -0,0 +1,142 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createFilesRouter = createFilesRouter;
+const express_1 = require("express");
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const logger_1 = __importDefault(require("../utils/logger"));
+// 存储文件下载次数
+const downloadCounts = {};
+// 存储已连接设备
+const connectedDevices = new Map();
+function createFilesRouter(uploadDir) {
+    const router = (0, express_1.Router)();
+    // #region 获取文件列表
+    router.get('/files', (_req, res) => {
+        fs_1.default.readdir(uploadDir, (err, files) => {
+            if (err) {
+                logger_1.default.error('读取文件列表失败', err);
+                return res.status(500).json({ error: '读取文件列表失败' });
+            }
+            const fileDetails = files.map(filename => {
+                const filepath = path_1.default.join(uploadDir, filename);
+                const stats = fs_1.default.statSync(filepath);
+                return {
+                    name: filename,
+                    size: stats.size,
+                    downloads: downloadCounts[filename] || 0,
+                    sharedBy: os_1.default.hostname(),
+                    ip: getLocalIP(),
+                    createdAt: stats.birthtime
+                };
+            });
+            logger_1.default.debug(`获取文件列表: ${files.length} 个文件`);
+            res.json(fileDetails);
+        });
+    });
+    // #endregion
+    // #region 下载文件
+    router.get('/download/:filename', (_req, res) => {
+        const filename = _req.params.filename;
+        const filepath = path_1.default.join(uploadDir, filename);
+        if (!fs_1.default.existsSync(filepath)) {
+            logger_1.default.warn(`下载失败: 文件不存在 - ${filename}`);
+            return res.status(404).json({ error: '文件不存在' });
+        }
+        // 记录下载次数
+        downloadCounts[filename] = (downloadCounts[filename] || 0) + 1;
+        // 记录设备信息
+        const clientIP = _req.ip || _req.socket.remoteAddress || 'unknown';
+        const userAgent = _req.get('user-agent') || 'Unknown Device';
+        const deviceName = parseDeviceName(userAgent);
+        connectedDevices.set(clientIP, {
+            name: deviceName,
+            ip: clientIP,
+            lastSeen: Date.now()
+        });
+        logger_1.default.info(`文件下载: ${filename} - ${clientIP}`);
+        res.download(filepath);
+    });
+    // #endregion
+    // #region 删除文件
+    router.delete('/delete/:filename', (_req, res) => {
+        const filename = _req.params.filename;
+        const filepath = path_1.default.join(uploadDir, filename);
+        if (!fs_1.default.existsSync(filepath)) {
+            logger_1.default.warn(`删除失败: 文件不存在 - ${filename}`);
+            return res.status(404).json({ error: '文件不存在' });
+        }
+        fs_1.default.unlink(filepath, (err) => {
+            if (err) {
+                logger_1.default.error(`删除文件失败: ${filename}`, err);
+                return res.status(500).json({ error: '删除文件失败' });
+            }
+            // 清除下载计数
+            delete downloadCounts[filename];
+            logger_1.default.info(`文件删除成功: ${filename}`);
+            res.json({ message: '文件删除成功' });
+        });
+    });
+    // #endregion
+    // #region 获取已连接设备
+    router.get('/devices', (_req, res) => {
+        // 清理超过5分钟未活动的设备
+        const now = Date.now();
+        const timeout = 5 * 60 * 1000; // 5分钟
+        for (const [ip, device] of connectedDevices.entries()) {
+            if (now - device.lastSeen > timeout) {
+                connectedDevices.delete(ip);
+            }
+        }
+        const devices = Array.from(connectedDevices.values());
+        res.json(devices);
+    });
+    // #endregion
+    // #region 获取服务器信息
+    router.get('/info', (_req, res) => {
+        res.json({
+            ip: getLocalIP(),
+            hostname: os_1.default.hostname(),
+            platform: os_1.default.platform()
+        });
+    });
+    // #endregion
+    return router;
+}
+// #region 辅助函数
+function getLocalIP() {
+    const interfaces = os_1.default.networkInterfaces();
+    for (const name of Object.keys(interfaces)) {
+        const iface = interfaces[name];
+        if (!iface)
+            continue;
+        for (const addr of iface) {
+            if (addr.family === 'IPv4' && !addr.internal) {
+                return addr.address;
+            }
+        }
+    }
+    return '127.0.0.1';
+}
+function parseDeviceName(userAgent) {
+    if (userAgent.includes('Android')) {
+        const match = userAgent.match(/Android.*?;\s*([^)]+)/);
+        return match ? match[1].trim() : 'Android Device';
+    }
+    if (userAgent.includes('iPhone'))
+        return 'iPhone';
+    if (userAgent.includes('iPad'))
+        return 'iPad';
+    if (userAgent.includes('Mac'))
+        return 'MacBook Pro';
+    if (userAgent.includes('Windows'))
+        return 'Windows PC';
+    if (userAgent.includes('Linux'))
+        return 'Linux PC';
+    return 'Unknown Device';
+}
+// #endregion