Sign inSign up

qq918652593/easy-stun

By qq918652593

•Updated 9 months ago

Image
0

1.0K

qq918652593/easy-stun repository overview

⁠Easy-Stun: 智能 NAT 穿透工具 + Cloudflare 深度集成

**软件作者：bigv ** **支持架构：x86_64（推荐），暂不支持 ARM 设备 ** **电报交流群：https://t.me/+7jcTMePlNVwwZjg1⁠ #反馈使用问题，交流更新日志 ** 教程视频：【完整教程】Easy-Stun 安装配置指南 - Bilibili⁠

⁠简介

Easy-Stun 是一款智能 NAT 穿透工具，旨在让您的内网服务（如 Jellyfin、Nextcloud、qBittorrent）通过固定的 HTTPS 域名（如 https://your-service.com）在公网安全访问，完全摆脱 http://ip:port 这种难记且不安全的传统访问方式。 核心功能亮点：

  • 智能 NAT 穿透：利用 STUN 协议自动探测公网 IP 和映射端口，支持端口复用和自动重连。
  • Cloudflare 深度集成：自动管理 DNS 解析记录（A 记录），并利用 Cloudflare 的规则实现隐形端口转发。
  • 全自动 HTTPS：无需手动申请证书，借助 Cloudflare 实现全程加密访问，安全且免维护。
  • 可视化管理：提供完整的 Web UI 界面，直观管理多个内网服务、监控状态及查看日志。
  • 极简部署：专为 Docker 环境优化，支持多架构，几秒钟即可启动。

⁠Docker 一键安装指令

Host 模式示例（强烈推荐）： Easy-Stun 需要进行 NAT 探测，使用 Host 模式能直接使用宿主机网络栈，穿透成功率最高。 自定义端口（Host模式）：
如需修改默认端口（例如改为 8888），请在命令末尾添加完整启动参数：

docker run -d \

  --name easy-stun \

  --network host \

  --restart unless-stopped \

  -v /mnt/user/appdata/easystun:/app/data \

  qq918652593/easy-stun:latest \

  -web -web-addr :8888

**桥接模式示例（Bridge）：** *如果无法使用 Host 模式，也可以使用 Bridge 模式，但可能需要在路由器进行相应的端口映射配置。* 
docker run -d \

  --name easy-stun \

  -p 18080:18080 \

  --restart unless-stopped \

  -v /mnt/user/appdata/easystun:/app/data \

  qq918652593/easy-stun:latest


**环境变量说明：**
Easy-Stun 主要通过 Web UI 进行配置，基础运行无需复杂的环境变量。

**目录挂载说明：**
- `/app/data`：核心数据目录，存放配置文件 (`config.json`)、证书文件和日志。**务必挂载**，以确保持久化存储。

---

⁠Docker Compose 部署示例


**Host 模式（推荐）：** 
version: '3.8'



services:

  easy-stun:

    image: qq918652593/easy-stun:latest

    container_name: easy-stun

    network_mode: host  # 推荐使用 Host 模式以获得最佳穿透效果

    volumes:

      - /mnt/user/appdata/easystun:/app/data  # 数据持久化目录

    # 修改默认端口（可选）： Host 模式下需通过 command 覆盖完整启动参数
    # command: -web -web-addr :8888
    restart: unless-stopped

**Bridge 模式：** 
version: '3.8'



services:

  easy-stun:

    image: qq918652593/easy-stun:latest

    container_name: easy-stun

    ports:

      - "18080:18080"  # Web 管理端口

    volumes:

      - /mnt/user/appdata/easystun:/app/data  # 数据持久化目录

    restart: unless-stopped

- 启动命令：在 `docker-compose.yml` 文件所在目录执行 `docker-compose up -d` 即可


---

## 主要特性

- **Cloudflare 自动化**：自动更新 DNS A 记录，自动配置页面转发规则。
- **零配置 SSL**：深度集成 acme.sh，自动为您的内网服务申请和更新 HTTPS 证书。
- **多隧道管理**：一个实例即可管理 Jellyfin、qBittorrent、Nextcloud 等多个服务的穿透。
- **实时监控**：Web 界面通过 SSE 技术实时推送隧道状态和日志，所见即所得。
- **多平台适配**：完美运行在 Unraid、Windows、Linux (x86) 等平台上。

---

## 使用说明

1. 启动容器后，访问 `http://服务器IP:18080` 进入 Web UI（默认端口为 18080）。
2. **配置 Cloudflare**：在设置页面输入您的 Cloudflare API Token 和域名。
3. **创建隧道**： - 点击“添加隧道”。 - 输入内网服务地址（如 `192.168.1.100:8096`）。 - 设置想要访问的子域名（如 `jellyfin`）。 - 勾选启用 HTTPS。
4. **一键启动**：点击启动按钮，Easy-Stun 将自动完成 NAT 穿透、DNS 更新和 HTTPS 证书申请。
5. **尽情访问**：稍等片刻，即可通过 `https://jellyfin.yourdomain.com` 安全访问您的内网服务！

---

快来体验 Easy-Stun，让内网穿透变得如此简单优雅！

Tag summary

Content type

Image

Digest

sha256:d2bdf55c1…

Size

11.3 MB

Last updated

9 months ago

docker pull qq918652593/easy-stun