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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: py-web-ssh
-Version: 0.1.1
+Version: 0.1.3
 Summary: A Python web SSH client with xterm.js, reconnectable sessions, logs, and file transfer.
 License-Expression: MIT
 License-File: LICENSE
@@ -35,6 +35,8 @@ Description-Content-Type: text/markdown
 - 日志页面：`/sessions/{uuid}/logs` 展示完整连接、认证、错误和文件传输日志。
 - 文件传输：优先 SFTP；SFTP 不可用时参考 `simple-ssh-copy` 思路，使用远端 `base64` shell 命令 fallback 上传/下载。
 - 可选 PIN 门禁：服务端传入 `--pin` 后，网页启动时必须先输入正确 PIN；验证成功后浏览器会保存加盐哈希 cookie，后端会保护 HTTP API、日志页面、文件接口和 WebSocket。
+- 浏览器客户端 session：首次访问时服务端会分配独立的浏览器 session UUID，并写入 HttpOnly cookie；它与 SSH 会话 UUID 分离。
+- 左侧控制面板：连接、会话、文件三个栏目改为互斥折叠面板，一次最多展开一个，也可以全部折叠。
 
 ## 安装
 
@@ -53,10 +55,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.3}/README.md

@@ -1,59 +1,61 @@
-# 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 上传/下载。
+# 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/来源限制、审计和会话回收策略。
+- 浏览器客户端 session：首次访问时服务端会分配独立的浏览器 session UUID，并写入 HttpOnly cookie；它与 SSH 会话 UUID 分离。
+- 左侧控制面板：连接、会话、文件三个栏目改为互斥折叠面板，一次最多展开一个，也可以全部折叠。
+
+## 安装
+
+```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.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "py-web-ssh"
-version = "0.1.1"
+version = "0.1.3"
 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.3}/webssh/__init__.py

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

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

@@ -13,6 +13,7 @@ from fastapi.staticfiles import StaticFiles
 from . import __version__
 from . import auth
 from .auth import add_pin_argument, configure_pin
+from .client_session import ensure_client_session_cookie
 from .files import download_file, filename_for_download, upload_file
 from .models import ConnectRequest, CreateSessionResponse, FileTransferResponse
 from .session import SessionManager
@@ -21,6 +22,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")
@@ -30,9 +33,18 @@ sessions = SessionManager()
 @app.middleware("http")
 async def require_pin_cookie(request: Request, call_next):
     path = request.url.path
-    if path.startswith("/static/") or path in PUBLIC_PATHS or auth.pin_auth.is_request_authorized(request):
-        return await call_next(request)
-    return JSONResponse({"detail": "PIN authentication required."}, status_code=401)
+    if not (
+        path.startswith("/static/")
+        or path in PUBLIC_PATHS
+        or auth.pin_auth.is_request_authorized(request)
+    ):
+        response = JSONResponse({"detail": "PIN authentication required."}, status_code=401)
+        ensure_client_session_cookie(request, response)
+        return response
+
+    response = await call_next(request)
+    ensure_client_session_cookie(request, response)
+    return response
 
 
 @app.get("/", response_class=HTMLResponse)
@@ -223,14 +235,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)

py_web_ssh-0.1.3/webssh/client_session.py

@@ -0,0 +1,64 @@
+from __future__ import annotations
+
+import secrets
+import threading
+import uuid
+from dataclasses import dataclass, field
+from datetime import datetime, timezone
+
+from fastapi import Request
+from fastapi.responses import Response
+
+
+COOKIE_NAME = "py_web_ssh_client_session"
+
+
+@dataclass
+class ClientSession:
+    session_id: str
+    created_at: datetime = field(default_factory=lambda: datetime.now(timezone.utc))
+    updated_at: datetime = field(default_factory=lambda: datetime.now(timezone.utc))
+
+
+class ClientSessionStore:
+    def __init__(self) -> None:
+        self._lock = threading.RLock()
+        self._sessions: dict[str, ClientSession] = {}
+
+    def get_or_create(self, session_id: str | None) -> tuple[ClientSession, bool]:
+        with self._lock:
+            if session_id and session_id in self._sessions:
+                session = self._sessions[session_id]
+                session.updated_at = datetime.now(timezone.utc)
+                return session, False
+
+            session = ClientSession(session_id=str(uuid.uuid4()))
+            self._sessions[session.session_id] = session
+            return session, True
+
+    def get(self, session_id: str) -> ClientSession | None:
+        with self._lock:
+            return self._sessions.get(session_id)
+
+    def count(self) -> int:
+        with self._lock:
+            return len(self._sessions)
+
+
+client_sessions = ClientSessionStore()
+
+
+def ensure_client_session_cookie(request: Request, response: Response) -> ClientSession:
+    session, created = client_sessions.get_or_create(request.cookies.get(COOKIE_NAME))
+    request.state.client_session_id = session.session_id
+    if created:
+        response.set_cookie(
+            COOKIE_NAME,
+            session.session_id,
+            httponly=True,
+            samesite="lax",
+            secure=False,
+            path="/",
+            max_age=30 * 24 * 60 * 60,
+        )
+    return session

{py_web_ssh-0.1.1 → py_web_ssh-0.1.3}/webssh/static/app.js

@@ -8,6 +8,7 @@ const pinGate = document.querySelector("#pin-gate");
 const pinForm = document.querySelector("#pin-form");
 const pinInput = document.querySelector("#pin-input");
 const pinError = document.querySelector("#pin-error");
+const panelToggles = document.querySelectorAll(".panel-toggle");
 
 const term = new Terminal({
   cursorBlink: true,
@@ -56,6 +57,7 @@ if (activeSessionId) {
 }
 
 checkPinGate();
+bindControlPanels();
 
 window.addEventListener("resize", () => {
   fitAddon.fit();
@@ -185,6 +187,42 @@ document.querySelectorAll(".tab").forEach((button) => {
   });
 });
 
+function bindControlPanels() {
+  panelToggles.forEach((button) => {
+    button.addEventListener("click", () => {
+      const panelId = button.getAttribute("aria-controls");
+      const isOpen = button.getAttribute("aria-expanded") === "true";
+      closeControlPanels();
+      if (!isOpen) {
+        openControlPanel(panelId);
+      }
+    });
+  });
+
+  document.querySelectorAll("[data-open-panel]").forEach((button) => {
+    button.addEventListener("click", () => {
+      openControlPanel(button.dataset.openPanel);
+    });
+  });
+}
+
+function openControlPanel(panelId) {
+  closeControlPanels();
+  const panel = document.querySelector(`#${panelId}`);
+  const toggle = document.querySelector(`[aria-controls="${panelId}"]`);
+  if (!panel || !toggle) return;
+  panel.hidden = false;
+  toggle.setAttribute("aria-expanded", "true");
+}
+
+function closeControlPanels() {
+  panelToggles.forEach((button) => {
+    button.setAttribute("aria-expanded", "false");
+    const panel = document.querySelector(`#${button.getAttribute("aria-controls")}`);
+    if (panel) panel.hidden = true;
+  });
+}
+
 function connectWebSocket(sessionId) {
   if (ws) {
     sendSnapshot();

{py_web_ssh-0.1.1 → py_web_ssh-0.1.3}/webssh/static/index.html

@@ -26,9 +26,16 @@
           <p>Web SSH client</p>
         </header>
 
-        <section class="panel">
-          <h2>连接</h2>
-          <form id="connect-form" class="stack">
+        <section class="panel collapsible-panel">
+          <button class="panel-toggle" type="button" aria-expanded="false" aria-controls="connect-panel">
+            连接
+          </button>
+          <form id="connect-panel" class="stack panel-body" hidden>
+            <div class="section-tabs" aria-label="连接栏目">
+              <button class="section-tab active" type="button">连接</button>
+              <button class="section-tab" type="button" data-open-panel="session-panel">会话</button>
+              <button class="section-tab" type="button" data-open-panel="files-panel">文件</button>
+            </div>
             <label>
               目标服务器
               <input id="host" name="host" required autocomplete="off" placeholder="192.168.1.10" />
@@ -65,9 +72,16 @@
           </form>
         </section>
 
-        <section class="panel">
-          <h2>会话</h2>
-          <div class="stack">
+        <section class="panel collapsible-panel">
+          <button class="panel-toggle" type="button" aria-expanded="false" aria-controls="session-panel">
+            会话
+          </button>
+          <div id="session-panel" class="stack panel-body" hidden>
+            <div class="section-tabs" aria-label="会话栏目">
+              <button class="section-tab" type="button" data-open-panel="connect-panel">连接</button>
+              <button class="section-tab active" type="button">会话</button>
+              <button class="section-tab" type="button" data-open-panel="files-panel">文件</button>
+            </div>
             <label>
               UUID
               <input id="session-id" autocomplete="off" spellcheck="false" />
@@ -80,26 +94,35 @@
           </div>
         </section>
 
-        <section class="panel">
-          <h2>文件</h2>
-          <form id="upload-form" class="stack">
-            <label>
-              上传到远端路径
-              <input id="upload-path" placeholder="/tmp/file.txt" />
-            </label>
-            <label>
-              本地文件
-              <input id="upload-file" type="file" />
-            </label>
-            <button type="submit">上传</button>
-          </form>
-          <form id="download-form" class="stack compact">
-            <label>
-              下载远端路径
-              <input id="download-path" placeholder="/tmp/file.txt" />
-            </label>
-            <button type="submit">下载</button>
-          </form>
+        <section class="panel collapsible-panel">
+          <button class="panel-toggle" type="button" aria-expanded="false" aria-controls="files-panel">
+            文件
+          </button>
+          <div id="files-panel" class="panel-body" hidden>
+            <div class="section-tabs" aria-label="文件栏目">
+              <button class="section-tab" type="button" data-open-panel="connect-panel">连接</button>
+              <button class="section-tab" type="button" data-open-panel="session-panel">会话</button>
+              <button class="section-tab active" type="button">文件</button>
+            </div>
+            <form id="upload-form" class="stack">
+              <label>
+                上传到远端路径
+                <input id="upload-path" placeholder="/tmp/file.txt" />
+              </label>
+              <label>
+                本地文件
+                <input id="upload-file" type="file" />
+              </label>
+              <button type="submit">上传</button>
+            </form>
+            <form id="download-form" class="stack compact">
+              <label>
+                下载远端路径
+                <input id="download-path" placeholder="/tmp/file.txt" />
+              </label>
+              <button type="submit">下载</button>
+            </form>
+          </div>
         </section>
       </aside>
 

{py_web_ssh-0.1.1 → py_web_ssh-0.1.3}/webssh/static/styles.css

@@ -136,7 +136,51 @@ label {
 
 .panel {
   display: grid;
-  gap: 12px;
+  gap: 8px;
+}
+
+.panel-toggle {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  width: 100%;
+  min-height: 38px;
+  font-weight: 700;
+}
+
+.panel-toggle::after {
+  content: "+";
+  color: var(--muted);
+}
+
+.panel-toggle[aria-expanded="true"]::after {
+  content: "-";
+}
+
+.panel-body {
+  display: grid;
+  gap: 10px;
+}
+
+.panel-body[hidden] {
+  display: none;
+}
+
+.section-tabs {
+  display: grid;
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+  gap: 6px;
+}
+
+.section-tab {
+  min-height: 30px;
+  padding: 0 6px;
+  font-size: 12px;
+}
+
+.section-tab.active {
+  border-color: var(--accent);
+  color: var(--accent);
 }
 
 .panel h2 {