py-web-ssh 0.1.1__tar.gz → 0.1.2__tar.gz

{py_web_ssh-0.1.1 → py_web_ssh-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: py-web-ssh
-Version: 0.1.1
+Version: 0.1.2
 Summary: A Python web SSH client with xterm.js, reconnectable sessions, logs, and file transfer.
 License-Expression: MIT
 License-File: LICENSE
@@ -53,10 +53,10 @@ py-web-ssh
 或者：
 
 ```bash
-uvicorn webssh.app:app --host 127.0.0.1 --port 8000
+uvicorn webssh.app:app --host 0.0.0.0 --port 8022
 ```
 
-打开 <http://127.0.0.1:8000>。
+打开 <http://127.0.0.1:8022>。
 
 启用 PIN：
 

{py_web_ssh-0.1.1 → py_web_ssh-0.1.2}/README.md

@@ -1,59 +1,59 @@
-# py-web-ssh
-
-一个基于 Python/FastAPI/Paramiko 的 Web SSH 客户端。前端使用 xterm.js 渲染真实终端控制序列，后端通过 WebSocket 转发 SSH 交互数据，并为每个网页客户端分配随机 UUID，支持同 UUID 断线重连、终端快照恢复、日志查看和文件上传下载。
-
-## 功能
-
-- SSH 交互终端：Paramiko 后端 `invoke_shell`，xterm.js 前端实时交互。
-- 登录方式：密码、浏览器上传私钥、私钥口令、SSH agent、服务端本机 `~/.ssh` 密钥、免口令/none auth。
-- Legacy 兼容：启动时按当前 Paramiko 运行时能力尽量启用旧 KEX/Cipher/MAC/HostKey/Pubkey 算法，并在日志中列出不可用算法。
-- UUID 会话：创建会话后返回 UUID，WebSocket 断开后可用同 UUID 重连。
-- 会话回收：同一个 UUID 如果所有浏览器连接都断开并且 5 分钟内无人重连，服务端会主动断开 SSH 并清理内存缓存。
-- 终端恢复：服务端保存 SSH 输出流，浏览器定期回传 xterm serialize 快照；重连时先恢复快照，再补放快照之后的输出。
-- 日志页面：`/sessions/{uuid}/logs` 展示完整连接、认证、错误和文件传输日志。
-- 文件传输：优先 SFTP；SFTP 不可用时参考 `simple-ssh-copy` 思路，使用远端 `base64` shell 命令 fallback 上传/下载。
-- 可选 PIN 门禁：服务端传入 `--pin` 后，网页启动时必须先输入正确 PIN；验证成功后浏览器会保存加盐哈希 cookie，后端会保护 HTTP API、日志页面、文件接口和 WebSocket。
-
-## 安装
-
-```bash
-python -m venv .venv
-.venv\Scripts\activate
-pip install -e .
-```
-
-## 启动
-
-```bash
-py-web-ssh
-```
-
-或者：
-
-```bash
-uvicorn webssh.app:app --host 127.0.0.1 --port 8000
-```
-
-打开 <http://127.0.0.1:8000>。
-
-启用 PIN：
-
-```bash
-py-web-ssh --pin 123456
-```
-
-前端默认从 jsDelivr 加载 xterm.js、fit addon 和 serialize addon。离线内网部署时，请把这些静态资源 vendoring 到 `webssh/static/` 并替换 `index.html` 里的 CDN 地址。
-
-## API 概览
-
-- `POST /api/sessions` 创建 SSH 会话。
-- `GET /api/sessions/{uuid}` 查看会话状态。
-- `GET /api/sessions/{uuid}/logs` 获取完整日志 JSON。
-- `DELETE /api/sessions/{uuid}` 主动断开 SSH。
-- `WS /ws/sessions/{uuid}` 终端输入、输出、resize、快照和断开控制。
-- `POST /api/sessions/{uuid}/files/upload` 上传文件，multipart 字段：`remote_path`、`file`。
-- `GET /api/sessions/{uuid}/files/download?remote_path=/path/file` 下载远端文件。
-
-## 安全提示
-
-这个项目默认面向可信内网或本机使用。私钥和口令只保存在进程内存中，不写入日志；如果要暴露到公网，请务必加 HTTPS、登录认证、CSRF/来源限制、审计和会话回收策略。
+# py-web-ssh
+
+一个基于 Python/FastAPI/Paramiko 的 Web SSH 客户端。前端使用 xterm.js 渲染真实终端控制序列，后端通过 WebSocket 转发 SSH 交互数据，并为每个网页客户端分配随机 UUID，支持同 UUID 断线重连、终端快照恢复、日志查看和文件上传下载。
+
+## 功能
+
+- SSH 交互终端：Paramiko 后端 `invoke_shell`，xterm.js 前端实时交互。
+- 登录方式：密码、浏览器上传私钥、私钥口令、SSH agent、服务端本机 `~/.ssh` 密钥、免口令/none auth。
+- Legacy 兼容：启动时按当前 Paramiko 运行时能力尽量启用旧 KEX/Cipher/MAC/HostKey/Pubkey 算法，并在日志中列出不可用算法。
+- UUID 会话：创建会话后返回 UUID，WebSocket 断开后可用同 UUID 重连。
+- 会话回收：同一个 UUID 如果所有浏览器连接都断开并且 5 分钟内无人重连，服务端会主动断开 SSH 并清理内存缓存。
+- 终端恢复：服务端保存 SSH 输出流，浏览器定期回传 xterm serialize 快照；重连时先恢复快照，再补放快照之后的输出。
+- 日志页面：`/sessions/{uuid}/logs` 展示完整连接、认证、错误和文件传输日志。
+- 文件传输：优先 SFTP；SFTP 不可用时参考 `simple-ssh-copy` 思路，使用远端 `base64` shell 命令 fallback 上传/下载。
+- 可选 PIN 门禁：服务端传入 `--pin` 后，网页启动时必须先输入正确 PIN；验证成功后浏览器会保存加盐哈希 cookie，后端会保护 HTTP API、日志页面、文件接口和 WebSocket。
+
+## 安装
+
+```bash
+python -m venv .venv
+.venv\Scripts\activate
+pip install -e .
+```
+
+## 启动
+
+```bash
+py-web-ssh
+```
+
+或者：
+
+```bash
+uvicorn webssh.app:app --host 0.0.0.0 --port 8022
+```
+
+打开 <http://127.0.0.1:8022>。
+
+启用 PIN：
+
+```bash
+py-web-ssh --pin 123456
+```
+
+前端默认从 jsDelivr 加载 xterm.js、fit addon 和 serialize addon。离线内网部署时，请把这些静态资源 vendoring 到 `webssh/static/` 并替换 `index.html` 里的 CDN 地址。
+
+## API 概览
+
+- `POST /api/sessions` 创建 SSH 会话。
+- `GET /api/sessions/{uuid}` 查看会话状态。
+- `GET /api/sessions/{uuid}/logs` 获取完整日志 JSON。
+- `DELETE /api/sessions/{uuid}` 主动断开 SSH。
+- `WS /ws/sessions/{uuid}` 终端输入、输出、resize、快照和断开控制。
+- `POST /api/sessions/{uuid}/files/upload` 上传文件，multipart 字段：`remote_path`、`file`。
+- `GET /api/sessions/{uuid}/files/download?remote_path=/path/file` 下载远端文件。
+
+## 安全提示
+
+这个项目默认面向可信内网或本机使用。私钥和口令只保存在进程内存中，不写入日志；如果要暴露到公网，请务必加 HTTPS、登录认证、CSRF/来源限制、审计和会话回收策略。

{py_web_ssh-0.1.1 → py_web_ssh-0.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "py-web-ssh"
-version = "0.1.1"
+version = "0.1.2"
 description = "A Python web SSH client with xterm.js, reconnectable sessions, logs, and file transfer."
 readme = "README.md"
 requires-python = ">=3.10"

{py_web_ssh-0.1.1 → py_web_ssh-0.1.2}/webssh/__init__.py

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "0.1.1"
+__version__ = "0.1.2"

{py_web_ssh-0.1.1 → py_web_ssh-0.1.2}/webssh/app.py

@@ -21,6 +21,8 @@ from .session import SessionManager
 BASE_DIR = Path(__file__).resolve().parent
 STATIC_DIR = BASE_DIR / "static"
 PUBLIC_PATHS = {"/", "/api/auth/status", "/api/auth/login", "/favicon.ico"}
+DEFAULT_HOST = "0.0.0.0"
+DEFAULT_PORT = 8022
 
 app = FastAPI(title="py-web-ssh", version=__version__)
 app.mount("/static", StaticFiles(directory=STATIC_DIR), name="static")
@@ -223,14 +225,18 @@ def _content_length(upload: UploadFile) -> int | None:
     return None
 
 
+def build_arg_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(prog="py-web-ssh")
+    parser.add_argument("--host", default=DEFAULT_HOST, help="Host interface to bind.")
+    parser.add_argument("--port", type=int, default=DEFAULT_PORT, help="Port to listen on.")
+    add_pin_argument(parser)
+    return parser
+
+
 def main() -> None:
     import uvicorn
 
-    parser = argparse.ArgumentParser(prog="py-web-ssh")
-    parser.add_argument("--host", default="127.0.0.1", help="Host interface to bind.")
-    parser.add_argument("--port", type=int, default=8000, help="Port to listen on.")
-    add_pin_argument(parser)
-    args = parser.parse_args()
+    args = build_arg_parser().parse_args()
 
     configure_pin(args.pin)
     uvicorn.run("webssh.app:app", host=args.host, port=args.port, reload=False)