plugin-jm-server 0.2.2__tar.gz → 0.2.3__tar.gz

plugin_jm_server-0.2.3/PKG-INFO

@@ -0,0 +1,202 @@
+Metadata-Version: 2.4
+Name: plugin_jm_server
+Version: 0.2.3
+Summary: plugin_jm_server, a plugin for jmcomic that can be used to view comics in a web browser.
+Home-page: https://github.com/hect0x7/plugin-jm-server
+Author: hect0x7
+Author-email: 93357912+hect0x7@users.noreply.github.com
+Keywords: python,jmcomic,18comic,禁漫天堂,NSFW
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: Microsoft :: Windows
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: jmcomic
+Requires-Dist: flask
+Requires-Dist: psutil
+Requires-Dist: cryptography
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+<!-- 顶部标题 & 统计徽章 -->
+<div align="center">
+  <img src="images/logo.png" width="180" alt="plugin-jm-server logo">
+  <h1 style="margin-top: 15px" align="center">plugin-jm-server</h1>
+
+  <p align="center">
+  <strong>“离线版”禁漫天堂，你的纯本地 离线看本神器！</strong>
+  </p>
+
+[![GitHub](https://img.shields.io/badge/-GitHub-181717?logo=github)](https://github.com/hect0x7)
+[![Stars](https://img.shields.io/github/stars/hect0x7/plugin-jm-server?color=orange&label=stars&style=flat)](https://github.com/hect0x7/plugin-jm-server/stargazers)
+[![Forks](https://img.shields.io/github/forks/hect0x7/plugin-jm-server?color=green&label=forks&style=flat)](https://github.com/hect0x7/plugin-jm-server/forks)
+[![PyPI](https://img.shields.io/pypi/v/plugin-jm-server?color=blue&label=version)](https://pypi.org/project/plugin-jm-server/)
+[![PyPI - Downloads](https://img.shields.io/pypi/dm/plugin-jm-server?style=flat&color=hotpink)](https://pepy.tech/projects/plugin-jm-server)
+[![Licence](https://img.shields.io/github/license/hect0x7/plugin-jm-server?color=red)](https://github.com/hect0x7/plugin-jm-server)
+
+</div>
+
+> 该项目会在你的电脑上启动一个**本地文件服务器**。你可以直接在浏览器（手机或电脑）中打开它，它会把本地文件夹里的图片转换成类似“禁漫天堂”的章节观看页面。
+> 
+> **核心优势**：
+> - 支持各种强大的浏览器插件和脚本，例如[双页阅读插件](https://sleazyfork.org/zh-CN/scripts/374903-comicread)。
+> - 一键开启局域网共享，电脑下载，躺在床上用手机看。
+
+![架构与流程图](https://raw.githubusercontent.com/hect0x7/hect0x7/master/images/jmcomic-intro-main.png)
+
+---
+
+## 🌟 功能与界面展示
+
+本项目不仅提供了简单的文件浏览，还专为漫画阅读进行了深度优化：
+
+### 1. 智能资源管理（文件夹浏览页）
+- **路径导航**：输入框自动补全路径，快速定位。
+- **封面预览**：鼠标悬停在文件夹上，自动展示首张图片作为封面。
+- **书签收藏**：将常看目录加入左侧书签，方便下次访问。
+
+![](images/4.png)
+*(电脑端：文件夹与看本二合一模式)* ![](images/8.png)
+*(手机端：文件夹列表)* ![](images/2.png)
+
+### 2. 沉浸式阅读体验（看本模式）
+- **懒加载极速浏览**：哪怕一个章节有几百张高清大图，也能秒开且不卡顿。
+- **多端适配**：无论是在宽屏显示器还是手机触摸屏上，都有最舒适的阅读排版。
+- **快捷交互**：支持键盘翻页、浮动工具栏快速回到顶部等。
+
+*(电脑端：看本模式)* ![](images/5.png)
+*(手机端：看本模式)* ![](images/7.jpeg)
+
+### 3. 局域网消息与隐私保护
+- **消息中心**：电脑和手机在局域网内可互传文本消息，实时弹窗提醒（v0.2.2+ 新功能）。
+- **密码验证**：支持设置访问密码，防止同处局域网的其他室友/家人偷看！
+
+*(局域网消息界面)* ![](images/9.png)
+*(登录密码验证)* ![](images/3.png)
+
+---
+
+## 🚀 小白快速上手指南
+
+如果你不懂编程，请严格按照以下两步操作即可：
+
+### 第一步：环境准备
+本项目基于 Python 开发，因此你的电脑必须先安装 Python。
+- 请前往 [Python 官网](https://www.python.org/downloads/) 下载并安装最新版 Python（安装时请务必勾选 `Add Python to PATH`）。
+
+### 第二步：一键安装与启动
+打开你电脑的**命令行终端**（Windows 下按 `Win+R` 输入 `cmd`，Mac 下打开“终端”APP），复制并执行下面这行命令：
+
+```shell
+pip install plugin_jm_server && jms
+```
+
+> **提示**：这行命令会帮你自动下载安装必要的组件，并以默认配置（分享当前所在目录、端口80）启动服务器。
+
+**启动成功后怎么用？**
+终端里会打印出两行地址，例如：
+- 本机访问：`http://127.0.0.1:80`
+- 局域网访问：`http://192.168.1.100:80`
+
+你只需要在电脑的浏览器里打开第一个地址，或者在连着同一个 WiFi 的手机浏览器里打开第二个地址，就可以开始看漫画了！
+
+> **提示**：如果在终端没看清局域网地址也没关系，当你用电脑打开本机地址后，**网页的主页顶部也会直接显示并智能识别当前的局域网地址**，你可以一键复制发给手机直接访问。
+
+---
+
+## ⚙️ 进阶使用（针对有经验的用户）
+
+安装后系统会注册 `jms` 命令，无需写代码即可通过丰富的参数进行个性化启动：
+
+```shell
+# 共享指定目录 ~/comics，并使用 8080 端口（高位端口无需管理员权限）
+jms ~/comics -p 8080
+
+# 设置登录密码为 123，并启用 HTTPS
+jms ~/comics -P 123 -s
+
+# 仅允许指定 IP 的设备访问
+jms ~/comics --ip-whitelist 192.168.1.10,192.168.1.11
+
+# 加载 jmcomic 配置开启在线下载
+jms ~/comics -o op.yml
+```
+
+**全部参数说明（可通过 `jms -h` 查看）：**
+| 参数 | 说明 | 默认值 |
+| --- | --- | --- |
+| `path` | 要共享的根目录（位置参数） | 当前目录 |
+| `-P, --password` | 登录密码，空表示免密 | 空 |
+| `-H, --host` | 监听地址 | `0.0.0.0` |
+| `-p, --port` | 监听端口 | `80` |
+| `-s, --ssl` | 启用 HTTPS（adhoc 自签名） | 关闭 |
+| `-o, --option` | [jmcomic](https://github.com/hect0x7/JMComic-Crawler-Python) 配置文件路径，开启在线下载 | 无 |
+| `--ip-whitelist` | IP 白名单，逗号分隔 | 不限制 |
+| `--current-path` | 初始当前路径 | 同 `path` |
+| `-e, --env` | 设置环境变量 `KEY=VALUE`，可重复 | 无 |
+| `--debug` | 开启 Flask debug 模式 | 关闭 |
+
+> 注：如果你在 Linux/macOS 上启动报错没有权限，是因为绑定默认的 80 端口需要管理员权限。建议加上 `-p 8080` 参数改用其他端口。
+
+---
+
+## 👨‍💻 开发者专属区域
+
+如果你想在自己的 Python 脚本中集成或二次开发该服务，可以通过代码进行调用。
+
+### 1. HTTP / HTTPS 原生调用
+```python
+from plugin_jm_server import *
+
+# 启动 HTTP 服务
+server = JmServer('D:/', 'password')
+server.run(host='0.0.0.0', port=80)
+
+# 启动 HTTPS 服务 (需要安装 cryptography)
+server.run(host='0.0.0.0', port=443, ssl_context='adhoc')
+```
+
+### 2. 作为 jmcomic 的插件集成
+你可以在 `jmcomic` 的 `op.yml` 配置文件中配置它：
+```yml
+plugins:
+  after_init: 
+    - plugin: jm_server
+      kwargs:
+        password: ''
+```
+对应的启动脚本注意事项：
+```python
+from jmcomic import *
+
+op = create_option('op.yml')
+op.download_album(123)
+
+# 注意：虽然爬虫主线程执行完毕，但 Web 服务器线程仍在运行中。
+# 需要用户手动按 Ctrl+C 退出。
+# Python 3.12+ 特别注意：必须插入下面这行代码，Web 服务器才能继续处理请求！
+op.wait_all_plugins_finish()
+```
+
+---
+
+## 💡 想法起源
+
+- 想法起源：https://github.com/hect0x7/JMComic-Crawler-Python/issues/192
+- UI 与部分基础架构参考：https://github.com/AiCorein/Flask-Files-Server

plugin_jm_server-0.2.3/README.md

@@ -0,0 +1,166 @@
+<!-- 顶部标题 & 统计徽章 -->
+<div align="center">
+  <img src="images/logo.png" width="180" alt="plugin-jm-server logo">
+  <h1 style="margin-top: 15px" align="center">plugin-jm-server</h1>
+
+  <p align="center">
+  <strong>“离线版”禁漫天堂，你的纯本地 离线看本神器！</strong>
+  </p>
+
+[![GitHub](https://img.shields.io/badge/-GitHub-181717?logo=github)](https://github.com/hect0x7)
+[![Stars](https://img.shields.io/github/stars/hect0x7/plugin-jm-server?color=orange&label=stars&style=flat)](https://github.com/hect0x7/plugin-jm-server/stargazers)
+[![Forks](https://img.shields.io/github/forks/hect0x7/plugin-jm-server?color=green&label=forks&style=flat)](https://github.com/hect0x7/plugin-jm-server/forks)
+[![PyPI](https://img.shields.io/pypi/v/plugin-jm-server?color=blue&label=version)](https://pypi.org/project/plugin-jm-server/)
+[![PyPI - Downloads](https://img.shields.io/pypi/dm/plugin-jm-server?style=flat&color=hotpink)](https://pepy.tech/projects/plugin-jm-server)
+[![Licence](https://img.shields.io/github/license/hect0x7/plugin-jm-server?color=red)](https://github.com/hect0x7/plugin-jm-server)
+
+</div>
+
+> 该项目会在你的电脑上启动一个**本地文件服务器**。你可以直接在浏览器（手机或电脑）中打开它，它会把本地文件夹里的图片转换成类似“禁漫天堂”的章节观看页面。
+> 
+> **核心优势**：
+> - 支持各种强大的浏览器插件和脚本，例如[双页阅读插件](https://sleazyfork.org/zh-CN/scripts/374903-comicread)。
+> - 一键开启局域网共享，电脑下载，躺在床上用手机看。
+
+![架构与流程图](https://raw.githubusercontent.com/hect0x7/hect0x7/master/images/jmcomic-intro-main.png)
+
+---
+
+## 🌟 功能与界面展示
+
+本项目不仅提供了简单的文件浏览，还专为漫画阅读进行了深度优化：
+
+### 1. 智能资源管理（文件夹浏览页）
+- **路径导航**：输入框自动补全路径，快速定位。
+- **封面预览**：鼠标悬停在文件夹上，自动展示首张图片作为封面。
+- **书签收藏**：将常看目录加入左侧书签，方便下次访问。
+
+![](images/4.png)
+*(电脑端：文件夹与看本二合一模式)* ![](images/8.png)
+*(手机端：文件夹列表)* ![](images/2.png)
+
+### 2. 沉浸式阅读体验（看本模式）
+- **懒加载极速浏览**：哪怕一个章节有几百张高清大图，也能秒开且不卡顿。
+- **多端适配**：无论是在宽屏显示器还是手机触摸屏上，都有最舒适的阅读排版。
+- **快捷交互**：支持键盘翻页、浮动工具栏快速回到顶部等。
+
+*(电脑端：看本模式)* ![](images/5.png)
+*(手机端：看本模式)* ![](images/7.jpeg)
+
+### 3. 局域网消息与隐私保护
+- **消息中心**：电脑和手机在局域网内可互传文本消息，实时弹窗提醒（v0.2.2+ 新功能）。
+- **密码验证**：支持设置访问密码，防止同处局域网的其他室友/家人偷看！
+
+*(局域网消息界面)* ![](images/9.png)
+*(登录密码验证)* ![](images/3.png)
+
+---
+
+## 🚀 小白快速上手指南
+
+如果你不懂编程，请严格按照以下两步操作即可：
+
+### 第一步：环境准备
+本项目基于 Python 开发，因此你的电脑必须先安装 Python。
+- 请前往 [Python 官网](https://www.python.org/downloads/) 下载并安装最新版 Python（安装时请务必勾选 `Add Python to PATH`）。
+
+### 第二步：一键安装与启动
+打开你电脑的**命令行终端**（Windows 下按 `Win+R` 输入 `cmd`，Mac 下打开“终端”APP），复制并执行下面这行命令：
+
+```shell
+pip install plugin_jm_server && jms
+```
+
+> **提示**：这行命令会帮你自动下载安装必要的组件，并以默认配置（分享当前所在目录、端口80）启动服务器。
+
+**启动成功后怎么用？**
+终端里会打印出两行地址，例如：
+- 本机访问：`http://127.0.0.1:80`
+- 局域网访问：`http://192.168.1.100:80`
+
+你只需要在电脑的浏览器里打开第一个地址，或者在连着同一个 WiFi 的手机浏览器里打开第二个地址，就可以开始看漫画了！
+
+> **提示**：如果在终端没看清局域网地址也没关系，当你用电脑打开本机地址后，**网页的主页顶部也会直接显示并智能识别当前的局域网地址**，你可以一键复制发给手机直接访问。
+
+---
+
+## ⚙️ 进阶使用（针对有经验的用户）
+
+安装后系统会注册 `jms` 命令，无需写代码即可通过丰富的参数进行个性化启动：
+
+```shell
+# 共享指定目录 ~/comics，并使用 8080 端口（高位端口无需管理员权限）
+jms ~/comics -p 8080
+
+# 设置登录密码为 123，并启用 HTTPS
+jms ~/comics -P 123 -s
+
+# 仅允许指定 IP 的设备访问
+jms ~/comics --ip-whitelist 192.168.1.10,192.168.1.11
+
+# 加载 jmcomic 配置开启在线下载
+jms ~/comics -o op.yml
+```
+
+**全部参数说明（可通过 `jms -h` 查看）：**
+| 参数 | 说明 | 默认值 |
+| --- | --- | --- |
+| `path` | 要共享的根目录（位置参数） | 当前目录 |
+| `-P, --password` | 登录密码，空表示免密 | 空 |
+| `-H, --host` | 监听地址 | `0.0.0.0` |
+| `-p, --port` | 监听端口 | `80` |
+| `-s, --ssl` | 启用 HTTPS（adhoc 自签名） | 关闭 |
+| `-o, --option` | [jmcomic](https://github.com/hect0x7/JMComic-Crawler-Python) 配置文件路径，开启在线下载 | 无 |
+| `--ip-whitelist` | IP 白名单，逗号分隔 | 不限制 |
+| `--current-path` | 初始当前路径 | 同 `path` |
+| `-e, --env` | 设置环境变量 `KEY=VALUE`，可重复 | 无 |
+| `--debug` | 开启 Flask debug 模式 | 关闭 |
+
+> 注：如果你在 Linux/macOS 上启动报错没有权限，是因为绑定默认的 80 端口需要管理员权限。建议加上 `-p 8080` 参数改用其他端口。
+
+---
+
+## 👨‍💻 开发者专属区域
+
+如果你想在自己的 Python 脚本中集成或二次开发该服务，可以通过代码进行调用。
+
+### 1. HTTP / HTTPS 原生调用
+```python
+from plugin_jm_server import *
+
+# 启动 HTTP 服务
+server = JmServer('D:/', 'password')
+server.run(host='0.0.0.0', port=80)
+
+# 启动 HTTPS 服务 (需要安装 cryptography)
+server.run(host='0.0.0.0', port=443, ssl_context='adhoc')
+```
+
+### 2. 作为 jmcomic 的插件集成
+你可以在 `jmcomic` 的 `op.yml` 配置文件中配置它：
+```yml
+plugins:
+  after_init: 
+    - plugin: jm_server
+      kwargs:
+        password: ''
+```
+对应的启动脚本注意事项：
+```python
+from jmcomic import *
+
+op = create_option('op.yml')
+op.download_album(123)
+
+# 注意：虽然爬虫主线程执行完毕，但 Web 服务器线程仍在运行中。
+# 需要用户手动按 Ctrl+C 退出。
+# Python 3.12+ 特别注意：必须插入下面这行代码，Web 服务器才能继续处理请求！
+op.wait_all_plugins_finish()
+```
+
+---
+
+## 💡 想法起源
+
+- 想法起源：https://github.com/hect0x7/JMComic-Crawler-Python/issues/192
+- UI 与部分基础架构参考：https://github.com/AiCorein/Flask-Files-Server

{plugin_jm_server-0.2.2 → plugin_jm_server-0.2.3}/setup.py

@@ -47,6 +47,9 @@ setup(
         "Operating System :: Microsoft :: Windows",
     ],
     entry_points={
+        'console_scripts': [
+            'jms = plugin_jm_server.cli:main',
+        ],
     },
     package_data={
         "plugin_jm_server": [

plugin_jm_server-0.2.3/src/plugin_jm_server/__init__.py

@@ -0,0 +1,3 @@
+__version__ = '0.2.3'
+
+from .app import *

plugin_jm_server-0.2.3/src/plugin_jm_server/__main__.py

@@ -0,0 +1,5 @@
+"""支持 `python -m plugin_jm_server ...` 方式启动。"""
+from .cli import main
+
+if __name__ == '__main__':
+    main()

plugin_jm_server-0.2.3/src/plugin_jm_server/cli.py

@@ -0,0 +1,154 @@
+"""
+命令行入口
+
+让用户无需编写 Python 代码即可启动服务器，例如：
+
+    jms ~/comics --password 123 --port 8080
+
+等价于：
+
+    from plugin_jm_server import JmServer
+    JmServer('~/comics', '123').run(host='0.0.0.0', port=8080)
+
+也支持 `python -m plugin_jm_server ...`（见 __main__.py）。
+"""
+import argparse
+
+from . import __version__
+from .app import JmServer
+
+EPILOG = """\
+示例:
+  jms                                # 共享当前目录, 端口 80, 免密登录
+  jms ~/comics -p 8080               # 共享 ~/comics, 端口 8080
+  jms ~/comics -P 123 -s             # 设置密码并启用 HTTPS(自签名)
+  jms ~/comics -o op.yml             # 加载 jmcomic 配置, 开启在线下载
+  jms D:/ --ip-whitelist 192.168.1.10,192.168.1.11
+
+启动后用浏览器访问提示的局域网地址即可(手机与电脑需在同一局域网)。
+"""
+
+
+def build_parser():
+    """构造 argparse 解析器。单独抽出便于测试。"""
+    parser = argparse.ArgumentParser(
+        prog='jms',
+        description='“离线版”禁漫天堂：在本地启动文件服务器，用浏览器以禁漫章节模式查看图片。',
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog=EPILOG,
+    )
+    parser.add_argument('path', nargs='?', default='.',
+                        help='要共享的根目录(默认: 当前目录)')
+    parser.add_argument('-P', '--password', default='',
+                        help='登录密码(默认: 空, 即免密登录)')
+    parser.add_argument('-H', '--host', default='0.0.0.0',
+                        help='监听地址(默认: 0.0.0.0, 局域网可访问)')
+    parser.add_argument('-p', '--port', type=int, default=JmServer.DEFAULT_PORT,
+                        help='监听端口(默认: %(default)s)')
+    parser.add_argument('-s', '--ssl', action='store_true',
+                        help='启用 HTTPS(使用 adhoc 自签名证书, 需安装 cryptography)')
+    parser.add_argument('-o', '--option', metavar='OP_YML',
+                        help='jmcomic 配置文件路径, 提供后开启在线下载功能')
+    parser.add_argument('--ip-whitelist', metavar='IP[,IP...]',
+                        help='IP 白名单, 逗号分隔; 不在名单内的请求返回 404')
+    parser.add_argument('--current-path', metavar='PATH',
+                        help='初始当前路径(默认与共享根目录相同)')
+    parser.add_argument('-e', '--env', action='append', metavar='KEY=VALUE',
+                        help='设置环境变量, 可重复指定')
+    parser.add_argument('--debug', action='store_true',
+                        help='开启 Flask debug 模式')
+    parser.add_argument('-v', '--version', action='version',
+                        version='%(prog)s {}'.format(__version__))
+    return parser
+
+
+def parse_env(env_list):
+    """把 ['A=1', 'B=2'] 解析成 {'A': '1', 'B': '2'}。"""
+    env = {}
+    for item in env_list or []:
+        if '=' not in item:
+            raise ValueError('--env 格式应为 KEY=VALUE, 收到: {!r}'.format(item))
+        k, v = item.split('=', 1)
+        env[k] = v
+    return env
+
+
+def parse_ip_whitelist(raw):
+    """把 '1.1.1.1, 2.2.2.2' 解析成列表; 为空时返回 None(表示不限制)。"""
+    if not raw:
+        return None
+    return [ip.strip() for ip in raw.split(',') if ip.strip()] or None
+
+
+def build_server(args):
+    """根据解析后的 args 构造 JmServer(不启动)。抽出以便单测。"""
+    jm_option = None
+    if args.option:
+        import jmcomic
+        jm_option = jmcomic.create_option(args.option)
+
+    return JmServer(
+        args.path,
+        args.password,
+        jm_option=jm_option,
+        ip_whitelist=parse_ip_whitelist(args.ip_whitelist),
+        current_path=args.current_path,
+        env=parse_env(args.env),
+        # 传入 port, 首页据此拼出局域网访问地址 http://IP:PORT
+        port=args.port,
+    )
+
+
+def build_run_kwargs(args):
+    """把 args 映射为 JmServer.run() / Flask app.run() 的关键字参数。"""
+    kwargs = {'host': args.host, 'port': args.port}
+    if args.ssl:
+        kwargs['ssl_context'] = 'adhoc'
+    if args.debug:
+        kwargs['debug'] = True
+    return kwargs
+
+
+def print_banner(args):
+    from .driver import get_lan_ip
+    scheme = 'https' if args.ssl else 'http'
+    lan_ip = get_lan_ip()
+    print('=' * 48)
+    print('plugin-jm-server v{} 已启动'.format(__version__))
+    print('共享目录 : {}'.format(args.path))
+    print('本机访问 : {}://127.0.0.1:{}'.format(scheme, args.port))
+    if args.host == '0.0.0.0':
+        print('局域网访问: {}://{}:{}'.format(scheme, lan_ip, args.port))
+    if not args.password:
+        print('提示     : 未设置密码, 任何人都能访问, 建议用 -P 设置密码')
+    print('按 Ctrl+C 停止服务')
+    print('=' * 48)
+
+
+def main(argv=None):
+    parser = build_parser()
+    args = parser.parse_args(argv)
+
+    try:
+        server = build_server(args)
+    except Exception as e:  # 配置/参数错误, 以非 0 退出并给出清晰提示
+        parser.error(str(e))
+        return  # parser.error 已 exit, 此行仅为静态分析
+
+    run_kwargs = build_run_kwargs(args)
+    print_banner(args)
+
+    try:
+        server.run(**run_kwargs)
+    except PermissionError:
+        parser.exit(1, '\n端口 {} 需要管理员权限。请改用高位端口, 例如: jms {} -p 8080\n'
+                    .format(args.port, args.path))
+    except OSError as e:
+        parser.exit(1, '\n启动失败(端口 {} 可能已被占用): {}\n请换一个端口, 例如 -p 8080\n'
+                    .format(args.port, e))
+    except KeyboardInterrupt:
+        print('\n已停止。')
+
+
+if __name__ == '__main__':
+    main()

{plugin_jm_server-0.2.2 → plugin_jm_server-0.2.3}/src/plugin_jm_server/driver.py

@@ -55,6 +55,7 @@ def get_lan_ip():
                             '172.26.', '172.27.', '172.28.', '172.29.', '172.30.', '172.31.')
 
         # 1. 优先寻找处于 up 状态且有私有 IP 的物理网卡
+        fallback_ip = None
         for interface, snics in addrs.items():
             # 跳过禁用的网卡
             if interface in stats and not stats[interface].isup:
@@ -64,9 +65,15 @@ def get_lan_ip():
                 # 必须是 IPv4
                 if snic.family == socket.AF_INET:
                     ip = snic.address
-                    # 排除回环地址，且必须符合私有地址段
-                    if not ip.startswith('127.') and any(ip.startswith(prefix) for prefix in private_prefixes):
-                        return ip
+                    if not ip.startswith('127.'):
+                        if fallback_ip is None:
+                            fallback_ip = ip
+                        # 排除回环地址，且必须符合私有地址段
+                        if any(ip.startswith(prefix) for prefix in private_prefixes):
+                            return ip
+
+        if fallback_ip:
+            return fallback_ip
 
         # 2. 如果没找到私有地址，尝试获取主机名的 IP
         host_ip = socket.gethostbyname(socket.gethostname())