Sumire

面向 ZJU 网络访问的轻量客户端

Sumire 是 zju-portal-core 的轻量 WebUI，提供会话控制、认证、配置管理和运行状态展示。

Features

• REST Token 连接与 Control Protocol v2 检查；
• Session 启停、状态和路由模式切换；
• Windows 与 macOS 系统代理开关；
• 托管模式 TUN 快捷开关和启动权限检查；
• 配置快照、待应用字段高亮与显式应用；
• 图形化认证（密码、短信、TOTP、CAS/OAuth、图形验证码点击和认证方式选择）；
• 流量、服务、逻辑连接和实时事件展示和 core 实时日志查看。

Demo

Quick Start

托管模式（推荐）

从Release下载对应平台和架构的压缩包并解压，压缩包中结构如下：

sumire/
├── sumire(.exe)
└── zju-portal-core(.exe)

MacOS需要先信任应用

xattr -d com.apple.quarantine sumire
xattr -d com.apple.quarantine zju-portal-core

直接运行 WebUI 即可，初次使用会自动生成一份config.yaml：

./sumire

终端会显示监听地址，在浏览器中访问显示的地址即可使用 WebUI

在配置页面修改启动配置，默认配置推荐只修改username和password，点击主页启动即可，初次启动会进入认证流程

Note: 配置含义参照配置中注释，如果你不确定某项配置的含义，最好不要随意修改配置文件

默认使用：

• data/config.yaml：Core 配置；
• data/resume-state.json：Resume State；
• data/control.token：REST Token；
• 127.0.0.1:9090：Core REST 地址。

允许监听非回环地址，例如：

./sumire -listen :9080

Core 完整输出默认只显示在 WebUI 的 Core 日志页面。排查启动问题时，可以使用 ./sumire -core-log-console 将 Core stdout/stderr 同步输出到终端.

外部模式

也可以连接手动启动的 Core。Core 使用默认地址时只需：

./sumire external

连接其他地址时可以直接把地址放在末尾，http:// 可省略：

./sumire external 192.168.1.10:9090

需要让 WebUI 监听所有网络接口时：

./sumire external -listen :9080