[Go] HP-Lite 6.0 内网穿透部署教程：Docker一键配置与自建指南

在远程办公、家庭实验室或边缘设备管理场景中，如何安全地从外部访问内网服务，始终是开发者和运维人员面临的核心挑战。传统的路由器端口映射、DDNS动态域名或商业穿透服务，常常伴随着配置复杂、成本高昂或稳定性欠佳等问题。

本文将为你详细解析一款开源的自建内网穿透方案——HP-Lite 6.0。它凭借简洁的架构、双通道传输机制以及对常用协议的深度优化，为上述痛点提供了一个高效且可靠的替代选择。

项目介绍

HP-Lite 6.0 是一款面向个人与小型团队的单机版内网穿透解决方案。它采用数据转发模式实现内外网通信，不依赖中心化云服务，所有流量均经由用户自有的服务器进行中转。

该项目的设计理念是“只要能上网，就能穿透”。即使在网络环境较差或受限的情况下（例如处于校园网或企业防火墙之后），它依然能保持较高的连接成功率和稳定性。目前，HP-Lite 已迭代至第六代，支持多种传输协议与灵活的部署方式，能够满足 Web 服务、数据库、远程桌面等多种应用场景的需求。

图1：HP-Lite 6.0 软件介绍主页

项目功能

1. 协议支持广泛：支持 TCP 和 UDP 协议穿透，覆盖绝大多数网络应用需求。
2. Web协议优化：针对 HTTP/HTTPS、WebSocket/WSS 等常用 Web 协议进行了深度优化，提升了传输效率与兼容性。
3. Web管理后台：提供直观的 Web 管理后台（默认端口 9090），可通过浏览器轻松查看设备状态、配置隧道规则。
4. SSL证书自动化：支持 ACME 自动申请 Let‘s Encrypt 免费 SSL 证书，轻松实现 HTTPS 安全访问。
5. 域名转发：开放 80/443 端口的域名转发功能（需手动开启），便于绑定自定义域名。
6. 简化接入：客户端支持通过“连接码”一键接入，大幅降低了使用门槛。

项目特点

HP-Lite 围绕“便捷部署、精细管理、安全可靠”三大核心目标设计，适用于从个人开发者、家庭用户到中小企业的多种场景。

1、云端集中管控

• 多系统兼容：支持 Android, Windows, Linux, macOS, NAS 及 Docker 等平台，适配 x86, ARM 等主流 CPU 架构。
• 远程统一管理：通过云端下发配置，实现对远程设备的批量管理，无需逐一手动操作本地终端。

2、多设备多租户管理

• 精细化权限：提供超级管理员与子账号分级授权机制，可灵活分配操作权限。
• 操作审计与隔离：各子用户拥有独立的配置空间，数据完全隔离，适用于企业多部门或服务商托管多客户场景。

3、域名与证书自动化

• 自定义域名：支持接入用户自有域名，提升服务的专业性与品牌一致性。
• SSL证书全自动：深度集成 ACME 协议，自动完成 Let’s Encrypt 证书的申请、部署与续期，全程无需人工干预。

4、全协议流量可视化

• 多协议监控：可实时监控 UDP、TCP、HTTP 等各类穿透流量。
• 关键指标分析：提供 PV/UV、传输量等核心数据的实时统计与历史回溯，便于资源评估与故障定位。

5、穿透安全防护

• IP访问控制：支持基于 IP 或 IP 段的黑白名单策略，有效限制非法来源访问。
• 资源阈值管控：可设置单设备的并发连接数及读写流量上限，防止资源滥用与潜在的 DDoS 风险。

6、正反向代理一体

• 反向代理：通过域名绑定与路由规则，将外网请求精准转发至内网指定服务。
• 正向代理：原生支持 HTTP、HTTPS、SOCKS5 协议，满足客户端出站代理需求，无需额外部署其他代理工具。

项目使用

为了帮助大家快速上手，HP-Lite 提供了详细的文档与视频教程，并支持二进制文件和 Docker 两种主流部署方式。对于现代 DevOps 实践而言，Docker 部署无疑是更便捷、更统一的选择。

官方资源

• 详细部署文档：https://hp-lite.hserver.cn
• 部署教学视频：【最好用的内网穿透工具 HP-Lite 搭建教程】
  https://www.bilibili.com/video/BV1E6pwzVEAR/

服务端部署

1、二进制方式
下载 HP-Lite 6.0 的二进制文件，直接运行即可启动服务端。配置文件 app.yml 需放置在与二进制文件相同的目录下，否则将使用内置默认配置。

建议：部署前请确保关闭本地防火墙，并在云服务器的安全组中同时放行 TCP 和 UDP 协议的对应端口（尤其是后文配置中将用到的 9091 端口）。

2、Docker 方式（推荐）
在主机上提前创建配置文件路径，例如 /data/app.yml。运行容器时，将配置文件和数据目录挂载到容器内即可。

# 使用阿里云镜像源
sudo docker run --name hp-lite-server --net=host --restart=always -d \
  -v /data/app.yml:/hp-lite-server/app.yml \
  -v /data/data:/hp-lite-server/data \
  registry.cn-shenzhen.aliyuncs.com/heixiaoma/hp-lite-server:latest

# 使用 Docker Hub 官方镜像源
sudo docker run --name hp-lite-server --net=host --restart=always -d \
  -v /data/app.yml:/hp-lite-server/app.yml \
  -v /data/data:/hp-lite-server/data \
  heixiaoma/hp-lite-server:latest

3、app.yml 配置示例
这是一个基础的配置文件示例，你可以根据实际情况进行调整。

admin:
  username: 'admin' # Web 管理后台账号
  password: '123456' # Web 管理后台密码
  port: 9090 # 管理后台监听端口（HTTP）

cmd:
  port: 16666 # 控制指令端口（客户端连接此 TCP 端口）

tunnel:
  ip: '127.0.0.1' # 填写服务器公网 IP 或已解析的域名
  port: 9091 # 隧道数据端口（需同时开放 TCP + UDP）
  open-domain: true # 是否启用 80/443 域名转发（若被 Nginx/宝塔占用请设为 false）

acme:
  email: '232323@qq.com' # 用于申请 Let's Encrypt 证书的邮箱（可随意填写）
  http-port: '5634' # ACME HTTP 验证端口（无需对外暴露，由 80 端口内部转发）

客户端运行方式

1、Docker 启动（推荐）
只需提供由服务端生成的连接码，即可一键启动客户端，非常简便。

# 阿里云源
sudo docker run --name hp-lite --restart=always -d -e c=你的连接码 \
  registry.cn-shenzhen.aliyuncs.com/heixiaoma/hp-lite:latest

# Docker Hub 源
sudo docker run --name hp-lite --restart=always -d -e c=你的连接码 \
  heixiaoma/hp-lite:latest

2、Linux / Windows 原生运行
对于 Linux 系统，首先赋予二进制文件执行权限：

chmod +x ./hp-lite-amd64

启动方式一（指定服务地址与设备 ID）：

./hp-lite-amd64 -server=your-domain.com:16666 -deviceId=32位唯一设备ID

启动方式二（使用连接码，更简便）：

./hp-lite-amd64 -c=你的连接码

提示：连接码可在 HP-Lite Web 管理后台（http://服务器IP:9090）中生成，它包含了服务地址、认证等全部必要信息，适合快速配对。

通过以上步骤，你可以在几分钟内完成 HP-Lite 服务端与客户端的部署，即刻实现内网服务的安全外网访问。

项目效果

部署并登录后，你将看到清晰直观的 Web 管理界面，可以方便地进行各项配置与监控。

图2：HP-Lite Web 管理后台登录与主界面

图3：设备详情与实时性能监控面板

图4：详细的穿透配置管理列表，支持IP、速率等策略设置

图5：自定义域名绑定与自动化SSL证书管理界面

图6：所有隧道配置的总览面板，状态一目了然

项目源码

• Gitee：https://gitee.com/HServer/hp-lite

总结

HP-Lite 6.0 以“简单、稳定、高效”为核心设计理念，成功将复杂的内网穿透需求转化为一次配置、长期可用的轻量级服务。其双通道传输、对常用 网络协议 的深度优化以及全自动的证书管理功能，都体现了对用户体验和实际场景的深入考量。

无论是个人开发者用于搭建临时的测试环境，还是小型团队需要安全地远程访问内部系统，HP-Lite 都是一个值得尝试的优秀开源工具。如果你对自建网络服务感兴趣，欢迎在 云栈社区 交流更多实践心得。