Skip to content

v3.0.0

Latest

Choose a tag to compare

@iclannad iclannad released this 05 Nov 02:07
· 3 commits to main since this release

English

Upgrade notes

  • Devices now join with access codes, which needs KVM firmware v1.11.0 or later. Adding a device by running a script in its terminal is no longer supported. Devices added that way keep connecting on port 5912 (deprecated) and can move to access codes without going offline.
  • Allow port 5915/TCP, and upgrade the deployment files together with the image. If you used the one-line installer, run it again from the same directory; it keeps .env and the database.
  • RTTYS_PASS, TURN_USER, TURN_PASS, and RTTYS_TOKEN while legacy token access is on, no longer have defaults.
  • The sample web certificate is no longer shipped; the platform generates one on first start.
  • The web UI is available in English and Chinese only.
  • Ubuntu 18.04/20.04 and Debian 11 are no longer listed as supported: their docker-compose cannot read the deployment files.

Added

  • Add devices with one-time access codes (valid for 24 hours) in a three-step dialog. The device checks the platform with the CA in the code, and the platform checks the device's factory certificate.
  • Devices can leave a platform, and deleting a device revokes its access.
  • The platform gives devices its TURN server.
  • Open devices by path under the platform's domain behind Nginx, with a single-domain certificate (#18).
  • OIDC_PRIMARY_LOGIN shows OIDC first on the login page (#47), and failed OIDC sign-ins say why.
  • Run the one-line installer again to upgrade. It keeps .env, the database and an existing Docker (#46).

Improved

  • Remote SSH is now called KVM Terminal (#45).
  • The platform warns when the deployment files are outdated or a secret is still an example value, and masks secrets in the startup log.
  • Rewritten guides for upgrades, domains and certificates, reverse proxies and internal networks.

Fixed

  • The device proxy only accepts session IDs the platform issued, no longer passes platform cookies to devices, and stops a session meant for one device from reaching another.
  • TURN_PORT is mapped to the port coturn listens on.

中文

升级须知

  • 设备改为用接入码接入,需要 KVM 固件 v1.11.0 或以上。在设备终端运行脚本的接入方式不再支持;用旧脚本接入的设备继续通过 5912 端口(已弃用)连接,迁移到接入码时不会掉线。
  • 需要放行 5915/TCP,并且部署文件要和镜像一起升级。用一键安装脚本安装的,在原来的目录重新运行脚本即可,.env 和数据库会保留。
  • RTTYS_PASS、TURN_USER、TURN_PASS 不再有默认值,开启旧 token 接入时的 RTTYS_TOKEN 也一样。
  • 部署包不再附带示例证书,平台首次启动时会自动生成。
  • 界面只保留中文和英文。
  • 不再把 Ubuntu 18.04/20.04 和 Debian 11 列为支持的系统:它们自带的 docker-compose 读不了部署文件。

新增

  • 在三步引导的弹窗里生成一次性接入码(24 小时有效)来添加设备。设备用接入码里的 CA 校验平台,平台校验
  • 设备可以主动离开平台;删除设备后,它的接入权限立即失效。
  • 平台会把自己的 TURN 服务下发给设备。
  • 在 Nginx 后面可以按路径、在平台域名下打开设备,只需要一张单域名证书(#18)。
  • OIDC_PRIMARY_LOGIN:登录页以 OIDC 为主(#47);OIDC 登录失败时会显示原因。
  • 重新运行一键安装脚本即可升级,会保留 .env、数据库和已装好的 Docker(#46)。

优化

  • Remote SSH 改名为 KVM Terminal(#45)。
  • 部署文件过旧、或密钥还是示例值时,平台会给出提示;启动日志里的密钥会做脱敏。
  • 重写了升级、域名和证书、反向代理、内网部署相关的文档。

修复

  • 设备代理只接受平台签发的会话 ID,不再把平台的 cookie 转发给设备,也不会让一台设备的会话访问到另一台设备。
  • TURN_PORT 现在映射到 coturn 实际监听的端口。