defunctzombie/localtunnel-server

localtunnel-server镜像说明

镜像概述

localtunnel-server是localtunnel的服务器组件，用于将本地主机服务暴露到公网，帮助开发者快速测试和分享本地应用，无需复杂的DNS配置或公网部署即可让他人访问你的本地项目更改。默认客户端连接到localtunnel.me服务器，你也可自主搭建私有服务器。

核心功能

1. 为客户端分配子域名，实现本地服务公网访问
2. 支持自定义域名配置（如子域名下部署服务器）
3. 提供REST API：创建隧道（POST /api/tunnels）、查看服务器状态（GET /api/status）
4. 支持Docker快速部署，易于运维

使用场景

• 开发者测试本地Web应用，无需部署公网即可让团队成员或用户访问
• 分享本地运行的项目演示给外部人员
• 调试需要公网触发的本地服务（如Webhook接收、第三方API回调）

配置说明

非Docker搭建步骤

shell
# 克隆仓库
git clone git://github.com/defunctzombie/localtunnel-server.git
cd localtunnel-server
# 安装依赖
npm install
# 启动服务器（端口1234）
bin/server --port 1234

注意：若服务器部署在子域名下，需添加--domain参数指定域名（如my-localtunnel.example.com）。

客户端使用自定义服务器

通过localtunnel客户端（lt）指定你的服务器地址：

shell
lt --host http://sub.example.tld:1234 --port 9000

将获得类似heavy-puma-9.sub.example.tld:1234的访问URL；若服务器通过反向代理监听80端口，可省略端口部分。

Docker部署示例

shell
docker run -d \
    --restart always \
    --name localtunnel \
    --net host \
    defunctzombie/localtunnel-server:latest --port 3000

说明：建议搭配反向代理（如localtunnel-nginx）处理HTTP(S)请求并转发到3000端口；若无需SSL支持，可将--port改为80。 ===END===