Settings zh - FrankoonG/hy2scale GitHub Wiki

🌐 English | 中文 | 한국어

设置

设置页面集中管理与网状网络、用户、规则和证书无关的所有节点配置。顶部分为三个标签页:系统Web升级

设置 — 系统标签页

系统

字段 说明
DNS 服务器 推送给 VPN 客户端(L2TP / IKEv2 / WireGuard)的 DNS 服务器,以逗号分隔。默认 8.8.8.8, 1.1.1.1

节点名称、出口节点标记和 Hysteria 2 用户认证开关位于 节点 页面的 编辑自身 对话框;允许用户认证 开关同时出现在 代理 → Hysteria 2 标签页。

修改密码

DNS 字段下方是 修改密码 卡片,用于更换管理员用户名 和/或 密码。密码在客户端使用 SHA-256 哈希后再传输。

警告 — 没有密码找回功能。如果忘记密码,必须手动编辑 /data/config.yaml(停止容器,将 web_password 替换为 echo -n 'newpassword' | sha256sum 的值,再启动容器)。

Web

字段 说明
会话超时 空闲 Web 会话的超时时长(小时)。默认 12 h。
HTTPS TLS 页面选择一张证书将 Web UI 切换为 HTTPS。切换后 HTTP 请求会被重定向到 HTTPS。

升级

设置 — 升级标签页

四个分区:

升级二进制

上传预编译的 hy2scale-<platform>-<arch>.tar.gz 发布构件。压缩包中的二进制必须与当前平台 / 架构匹配(显示在卡片顶部)。上传后节点会换入新二进制并调用 os.Exit(0),由 docker --restart unless-stopped 重启至新版本。

同一张卡片上还提供 Check for Updates 按钮:它会轮询 GitHub releases/latest 端点,与当前运行的版本对比,要么显示「up to date」,要么内联弹出 Update Now 按钮以下载并应用对应的 tarball。进度通过 SSE 广播,多个并发的管理员会话可同步追踪同一任务。

HY2 SCALE 所有模态框均通过 Cancel、点击遮罩或 Esc 关闭。右上角没有 关闭按钮 — 每个模态都有底部的 Cancel / Close / Save,多放一个角落控件只会重复。

许可证

字段
许可证 GPL-3.0-or-later
源代码 链接到仓库(GPL §6 分发源代码要求)

构建镜像捆绑了 strongSwan(GPLv2+)、iptables(GPLv2+)和 xl2tpd(GPLv2+);因此分发 Docker 镜像时总体会上移到 GPL-3。

原生组件

可展开列出镜像中实际捆绑的原生依赖,及其版本和各自的许可证。

Go 依赖

可折叠列出编译进二进制的 Go 模块,来自 debug.ReadBuildInfo() — 包含所有直接和间接依赖。

备份与恢复

位于同一页面的升级卡片下方:

  • 下载备份/data/config.yaml、TLS 证书和节点身份的完整归档。
  • 从文件恢复 — 替换当前配置并重启面板。用于迁移到新主机或灾难恢复。

运行模式

侧边栏版本旁的小徽章显示节点启动时自动检测到的模式:

模式 条件 可用功能
Normal Host 网络 + iptables 正常 全部功能,含路由规则
Bridge Bridge 网络 + NET_ADMIN + iptables 正常 L2TP / IKEv2 / WireGuard,不含 Rules
Compat NET_ADMIN 正常 + iptables 不可用 L2TP / IKEv2 通过 TUN 捕获 + xfrm bridge
Limited NET_ADMIN 网状中继、SOCKS5、HTTP、Shadowsocks、WireGuard

运行模式在启动时检测,不通过不同 Docker 参数重启容器就无法更改。

国际化

提供三种语言:English中文 (zh)한국어 (ko)。通过每个页面右上角的语言下拉框切换。所有字符串都由 JSON 驱动,扩展新语言非常简单。

自动重载

部署新版本时,每个已登录的浏览器标签页都会轮询 /api/build-id(每 60 s 一次,窗口聚焦时也触发)。如果服务端返回的构建哈希与标签页缓存的不一致,标签页会硬刷新以加载新的 JS 包 — 避免出现旧 UI 对新服务端的情况。

调试模式

在容器环境变量中设置 DEBUG=true 可启用详细日志:iptables 检测、权限检查、兼容模式下的逐包流向追踪、strongSwan 调试输出,以及启动时的 banner。

docker run -d --name hy2scale \
  -e DEBUG=true \
  --network host --cap-add NET_ADMIN \
  -v hy2scale-data:/data \
  frankoong/hy2scale:latest

仅在排查问题时启用 DEBUG — 输出量很大。

配置文件

所有状态持久化到 /data/config.yaml,通过原子写入(临时文件 + 重命名)避免损坏。通常不应手动编辑 — 请使用 Web UI 或 REST API — 但在需要恢复时始终可以直接编辑作为应急手段。

⚠️ **GitHub.com Fallback** ⚠️