Dice! WebUI 使用说明

Deleted User

此说明介绍了Dice WebUI的简易使用方法。
Dice! WebUI自20210919更新后的版本可用。
请注意WebUI将在未来版本持续添加新功能，此说明会持续更新。
WebUI在全平台下可用，因此这可以简化Linux，MacOS，Android和iOS上的配置过程。在Windows上，他将会代替之前的GUI。
此外，WebUI经过配置可以远程访问
Dice Cloud 用户，请同时参考Dice Cloud WebUI 使用说明

计划中的功能：

用户管理（信任等级，黑名单）
群管理（授权，免黑等）
拓展管理（安装/卸载牌堆，Lua脚本）

Deleted User

WebUI 基础使用

在登录成功以后，Dice!会向Master(没有Master的情况下，自己) 发送WebUI运行的端口。如图中运行在8080端口。默认情况下，WebUI运行在一个随机的未使用的端口，但你可以通过WebUIPort属性更改。

在本地(运行Dice的同一个设备)浏览器中输入http://127.0.0.1:端口进入WebUI 请一定要输入http://否则某些浏览器会卡死
如果你在远程访问WebUI，请确定已配置好防火墙等，并使用对应的IP地址或域名访问（而不是127.0.0.1）

提示登录时，默认用户名为admin，密码为password，进入WebUI后可在WebUI配置栏更改密码。WebUI默认只允许本地访问，所以如果设备只有你一个人能访问（不是共享的云服务器等）不更改密码也无所谓。

可以在上面执行管理操作，应该都符合直觉。需要注意的是你可以直接点击表格修改其中内容，表格中的修改无需点击保存等，会在编辑完成后自动生效。

Deleted User

WebUI 配置

WebUI有三个配置项，更改配置后重启才会生效
EnableWebUI - 启用WebUI, 0为禁用, 1为启用, 默认为1
WebUIPort - WebUI端口, 0为随机, 其他为固定端口
WebUIAllowInternetAccess - 允许从非本地地址访问WebUI, 0为不允许, 1为允许, 默认为0, 也就是WebUI默认只能从本地访问。如果你使用Docker网络等，你可能需要将此项设置为1才能在Docker宿主机上访问WebUI。

WebUI 环境变量

可以通过环境变量设置WebUI配置。环境变量具有较高优先级。
DICE_WEBUI_PORT 设置端口，0为随机端口
DICE_WEBUI_PORT_USE_VARIABLE 使用另一个环境变量的值作为端口，比DICE_WEBUI_PORT有更高优先级，可用于PaaS等平台
DICE_WEBUI_ALLOW_INTERNET_ACCESS 0为不允许, 1为允许

配置远程访问

WebUI 使用 HTTP Digest验证，密码保存为Digest，理论上比较安全。然而，如果需要暴露到公网，我们仍然推荐使用nginx或apache等配置好TLS然后反向代理到Dice WebUI以确保安全。
当然，允许远程访问前请务必更改密码，不然再安全也没用。