Settings zh - FrankoonG/hy2scale GitHub Wiki
设置页面集中管理与网状网络、用户、规则和证书无关的所有节点配置。顶部分为三个标签页:系统、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 会话的超时时长(小时)。默认 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 模块,来自 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 — 但在需要恢复时始终可以直接编辑作为应急手段。