uVersion
简体中文
下载 →

Wiki

安装 uVersion Server

选择你的方式:Ubuntu / Debian(.deb 软件包)、Windows(PowerShell)或 Docker。

uVersion 服务器可在 Ubuntu/Debian、Windows 或 Docker 上通过一条命令完成安装。 安装程序会询问几个问题,配置好 PostgreSQL、数据库、系统服务和 HTTPS 证书, 然后显示你的管理员密码。大约需要十分钟。

术语

这些页面中反复出现六个词。如果其中有你不熟悉的,这一节就足够了:不假定你了解其他 任何内容。

  • 数据文件夹:服务器写入一切属于你的内容的文件夹,即受版本控制的 文件内容、它的证书以及它的身份标识。 你在安装时选择它。需要备份的就是这个文件夹。
  • PostgreSQL 集群:一个数据库实例,拥有自己的文件夹和自己的端口。 同一台机器可以承载多个而彼此互不可见。uVersion 会根据你的回答,使用系统的集群或它自己的集群。
  • 系统服务:在后台运行、并在机器启动时自行重启的程序。 在 Windows 上称为“Windows 服务”,在 Linux 上称为“systemd 单元”。
  • TLS 指纹:一串 64 个字符,用于标识服务器的证书。你在每台工作站上 确认一次,就像首次通过 SSH 连接一台机器那样。
  • 激活码:通过电子邮件收到的 UV-XXXX-XXXX-XXXX 代码。 安装程序用它换取你的完整许可证。它只能使用一次
  • 清除(purge):软件包的完全卸载,连同其配置应答一并删除。 在 Debian 上,apt remove 移除程序,apt purge 还会移除其设置。

前置条件

  • 一台机器(VPS、迷你 PC、办公室服务器等),运行 Ubuntu 24.04+、 Debian 13+,或 Windows 10、11、Server 2019+。其他发行版由 Docker 容器覆盖。
  • 对该机器的管理员权限:Linux 上为 root(实际通过 sudo),或 Windows 上以 PowerShell“以管理员身份运行”。 没有它,安装程序将拒绝启动。
  • 你的 uVersion 激活码(格式 UV-XXXX-XXXX-XXXX), 在许可证签发时通过电子邮件收到,或可从 你的账户页面获取。 此代码为一次性使用:一经兑换,便无法再用于另一台机器。
  • 指向 licence.uversion.io出站互联网访问(HTTPS), 仅在兑换代码期间需要。在没有互联网访问的网络上,请参见 Ubuntu 页面的 “非交互式与离线安装”一节:安装程序也接受完整的许可证密钥,你可在另一台工作站上从 账户页面获取。
  • PostgreSQL。在 Ubuntu 和 Debian 上,它会作为软件包的依赖自动到位, 你无需操作。在 Windows 上,安装程序通过 winget 安装它,而 Windows Server 2019 和 2022 没有 winget:在这两个版本上,请在运行脚本前手动安装 PostgreSQL 16。
  • 磁盘空间。服务器本身和数据库占用很小:占主导的是分块存储(你的 文件内容,含所有修订版),因此请按你的 Unreal 项目大小及其历史来估算。如果你也把数据库放在 数据文件夹上,安装程序还会在那里额外写入一个 1 GB 的压舱(占位)文件,磁盘写满时可将其删除。
  • 入站开放的 TCP 端口 8443,你的工作站正是由此连接。 Windows 安装程序会自行创建防火墙规则。Debian 软件包不会打开任何端口: 请自行开放,例如 sudo ufw allow 8443/tcp

选择你的方式

HTTPS 与证书

服务器仅在端口 8443 上讲 HTTPS。无需配置,也不需要任何域名: 首次启动时,服务器会自行生成其证书(称为自签名证书),并在安装结束时显示其 SHA-256 指纹。每台工作站在首次连接时确认这一指纹一次, 此后拒绝任何不同的指纹。

可见的结果:打开 https://<服务器IP>:8443 的浏览器会显示 安全警告,因为该证书未由任何公共机构签名。这是预期之中的。请核对 所显示的指纹确为安装时记下的那一个,然后继续。

浏览器在首次连接服务器时显示的安全警告,以及可用于继续的按钮。

工作站一侧流程的详细说明: TLS 指纹。 如果你的服务器拥有域名并且你已经拥有证书,可以改为放入你自己的证书:参见随服务器提供的 运维手册(docs/operations.md)第 2 节。

接下来

安装完成后,会在一个框中显示 admin 用户名、一个临时密码以及服务器地址。 请记下它们。随后你可从网络上任意一台工作站,用浏览器或桌面客户端, 连接到地址 https://<服务器IP>:8443,其中 <服务器IP> 是你刚刚安装的那台机器的地址。

  • 首次登录 :使用初始密码登录,并进行修改
  • TLS 指纹 :自签名证书,在客户端确认一次
  • 故障排查 :“服务无法启动”“激活码被拒绝”等