localtunnel Windows服务安装：使用NSSM实现开机自启-优快云博客

localtunnel Windows服务安装：使用NSSM实现开机自启

【免费下载链接】localtunnel expose yourself 项目地址: https://gitcode.com/gh_mirrors/lo/localtunnel

为什么需要将localtunnel注册为Windows服务？

你是否还在为以下问题困扰？每次开发测试都需要手动启动localtunnel，忘记启动导致外部回调失败；团队协作时因隧道未运行耽误测试进度；演示过程中因隧道断开导致演示中断。本文将通过12个实操步骤，教你使用NSSM（Non-Sucking Service Manager）将localtunnel注册为Windows服务，实现开机自动启动、异常自动恢复，彻底解放双手。

读完本文你将获得：

零手动干预的localtunnel自动启动方案
服务级别的进程守护与崩溃自动恢复
完整的日志记录与问题排查能力
服务管理与优化的高级技巧

技术准备与环境要求

软件/工具	版本要求	作用	官方下载地址
Node.js	v14.0.0+	运行localtunnel的基础环境	https://nodejs.org/
npm	v6.0.0+	Node.js包管理工具	随Node.js安装
localtunnel	最新版	实现localhost暴露的核心工具	npm install -g localtunnel
NSSM	v2.24+	Windows服务管理工具	https://nssm.cc/download

注意：请确保使用管理员权限打开命令提示符或PowerShell，所有操作需在管理员模式下进行。

安装与配置核心组件

1. 安装Node.js环境

访问Node.js官网下载LTS版本安装包（建议选择v16.x或更高版本），双击安装并勾选"Add to PATH"选项。安装完成后验证：

node -v  # 应输出v14.0.0以上版本号
npm -v   # 应输出6.0.0以上版本号

2. 安装localtunnel

使用npm全局安装localtunnel：

npm install -g localtunnel

验证安装：

lt --version  # 应输出当前安装版本号

3. 下载并配置NSSM

访问NSSM官网下载页面，下载最新稳定版（当前为2.24）
根据系统架构选择32位或64位版本（建议64位）
解压压缩包，将nssm.exe文件复制到C:\Windows\System32目录（或其他已在PATH中的目录）
验证安装：

nssm version  # 应输出NSSM版本信息

创建localtunnel服务

4. 准备服务配置文件

在C:\Program Files\localtunnel目录（需手动创建）下创建start-tunnel.bat批处理文件：

@echo off
set PORT=8080
set SUBDOMAIN=mydevserver
set LOG_DIR=C:\Program Files\localtunnel\logs

:: 创建日志目录（如果不存在）
if not exist "%LOG_DIR%" mkdir "%LOG_DIR%"

:: 启动localtunnel并输出日志
lt --port %PORT% --subdomain %SUBDOMAIN% >> "%LOG_DIR%\tunnel.log" 2>&1

配置说明：

PORT: 本地服务端口，根据实际项目修改
SUBDOMAIN: 自定义子域名（可选，不设置则随机生成）
LOG_DIR: 日志文件保存路径
2>&1: 将错误输出重定向到日志文件

5. 使用NSSM安装服务

打开管理员命令提示符，执行以下命令启动NSSM图形界面：

nssm install LocalTunnelService

在弹出的NSSM配置窗口中进行如下设置：

Application选项卡

Path: C:\Windows\System32\cmd.exe
Startup directory: C:\Program Files\localtunnel
Arguments: /c start-tunnel.bat

Details选项卡

Display name: LocalTunnel Service
Description: Expose localhost to the internet automatically
Startup type: Automatic (Delayed Start)

Log on选项卡

选择Local System account
勾选Allow service to interact with desktop（可选，用于调试）

I/O选项卡

Output (stdout): C:\Program Files\localtunnel\logs\service.log
Error (stderr): C:\Program Files\localtunnel\logs\error.log

File rotation选项卡

勾选Rotate files
Rotate while service is running: 勾选
Restrict rotation: 3600秒 (1小时) 或 1048576字节 (1MB)

点击"Install service"完成服务安装。

6. 命令行快速配置（高级用户）

如果偏好命令行操作，可以直接执行以下命令完成配置：

:: 安装服务
nssm install LocalTunnelService "C:\Windows\System32\cmd.exe"

:: 设置启动参数
nssm set LocalTunnelService AppDirectory "C:\Program Files\localtunnel"
nssm set LocalTunnelService AppParameters "/c start-tunnel.bat"

:: 设置服务描述
nssm set LocalTunnelService DisplayName "LocalTunnel Service"
nssm set LocalTunnelService Description "Expose localhost to the internet automatically"

:: 设置启动类型
nssm set LocalTunnelService Start SERVICE_AUTO_START_DELAYED

:: 配置日志
nssm set LocalTunnelService AppStdout "C:\Program Files\localtunnel\logs\service.log"
nssm set LocalTunnelService AppStderr "C:\Program Files\localtunnel\logs\error.log"

:: 配置日志轮转
nssm set LocalTunnelService AppRotateFiles 1
nssm set LocalTunnelService AppRotateOnline 1
nssm set LocalTunnelService AppRotateSeconds 3600
nssm set LocalTunnelService AppRotateBytes 1048576

服务管理与验证

7. 启动服务

通过服务管理界面启动或使用命令：

nssm start LocalTunnelService

8. 验证服务状态

:: 检查服务状态
nssm status LocalTunnelService

:: 查看服务日志
type "C:\Program Files\localtunnel\logs\tunnel.log"

成功启动后，日志中应包含类似以下内容：

your url is: https://mydevserver.localtunnel.me

9. 服务控制命令速查表

功能	命令
启动服务	`nssm start LocalTunnelService`
停止服务	`nssm stop LocalTunnelService`
重启服务	`nssm restart LocalTunnelService`
查看状态	`nssm status LocalTunnelService`
修改配置	`nssm edit LocalTunnelService`
删除服务	`nssm remove LocalTunnelService confirm`
查看日志	`type "C:\Program Files\localtunnel\logs\tunnel.log"`

高级配置与优化

10. 自定义隧道参数

修改start-tunnel.bat文件可以配置更多localtunnel参数：

:: 高级配置示例
lt --port 8080 \
   --subdomain mydevserver \
   --local-host 192.168.1.100 \
   --local-https \
   --local-cert C:\certs\local.crt \
   --local-key C:\certs\local.key >> "%LOG_DIR%\tunnel.log" 2>&1

参数说明：

--local-host: 当本地服务绑定到非localhost地址时使用
--local-https: 本地服务使用HTTPS时启用
--local-cert/--local-key: HTTPS证书和密钥路径

11. 服务故障恢复配置

NSSM提供了强大的故障恢复能力，通过以下命令配置：

:: 设置服务退出时自动重启
nssm set LocalTunnelService AppExit Default Restart

:: 设置重启延迟（毫秒）
nssm set LocalTunnelService AppRestartDelay 3000

:: 设置重启限流阈值（毫秒）
nssm set LocalTunnelService AppThrottle 5000

12. 服务优先级与资源控制

为确保隧道服务稳定运行，可以调整进程优先级和CPU亲和性：

:: 设置进程优先级为高
nssm set LocalTunnelService AppPriority HIGH_PRIORITY_CLASS

:: 限制CPU使用（仅使用CPU 0和1）
nssm set LocalTunnelService AppAffinity 0,1

常见问题解决方案

Q1: 服务启动后立即停止

排查步骤：

检查日志文件：C:\Program Files\localtunnel\logs\error.log
手动运行批处理文件测试：C:\Program Files\localtunnel\start-tunnel.bat
确认本地服务是否已启动并监听指定端口

常见原因：

本地服务未启动或端口被占用
批处理文件路径或命令错误
权限不足（确保使用管理员权限）

Q2: 服务运行但无法访问隧道URL

排查步骤：

检查localtunnel日志确认URL已成功分配
使用netstat -ano | findstr :8080确认本地端口监听状态
临时关闭防火墙测试是否为防火墙阻止

Q3: 日志文件过大

解决方案：

调整日志轮转配置：

nssm set LocalTunnelService AppRotateBytes 5242880  :: 5MB
nssm set LocalTunnelService AppRotateSeconds 86400  :: 24小时

创建日志清理计划任务，定期删除旧日志

总结与最佳实践

通过本文介绍的方法，我们实现了localtunnel的服务化部署，主要优势包括：

开机自动启动，无需人工干预
异常自动恢复，提高服务可用性
完整日志记录，便于问题排查
资源控制与优先级管理

最佳实践建议：

使用"Automatic (Delayed Start)"启动类型，避免与系统启动过程冲突
定期检查日志文件大小，合理配置轮转策略
对关键项目配置服务依赖（如数据库服务）
定期更新localtunnel和NSSM到最新版本

下期预告

下一篇文章我们将介绍《localtunnel私有服务器搭建与企业级部署方案》，教你如何搭建自己的localtunnel服务器，解决公共服务器不稳定问题，敬请关注！

如果本文对你有帮助，请点赞、收藏、关注三连支持！如有任何问题或建议，欢迎在评论区留言讨论。

【免费下载链接】localtunnel expose yourself 项目地址: https://gitcode.com/gh_mirrors/lo/localtunnel

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考