在 Windows 上安装

Windows 10、11 或 Windows Server 2019+（x64）。使用一行 PowerShell 命令安装。

安装

1. 以管理员身份打开 PowerShell

右键单击 PowerShell 图标 → 以管理员身份运行。 否则脚本会拒绝启动，并会告诉你。

2. 粘贴安装命令

只有一行，原样粘贴到你刚打开的窗口中：

iwr https://uversion.io/downloads/server/install.ps1 -UseBasicParsing | iex

随后脚本会在你眼前依次执行：

• 请求输入激活码，这是唯一会问的问题：见下一步
• 下载二进制文件并校验压缩包
• 如果缺少 PostgreSQL，则通过 winget 安装（约 2 分钟）
• 创建数据库、角色和 Windows 服务，并打开防火墙 （8443，另加作为回退的 8080）
• 注册程序和功能条目
• 启动服务，生成自签名 TLS 证书，然后显示管理员密码以及证书的 SHA-256 指纹

全部操作都在你的 PowerShell 窗口中进行，你可以看到每一步。这相当于 Linux 上 sudo apt install 的 Windows 版本。

3. 输入激活码

这是唯一会问的问题：其他所有选择都通过下文所述的参数完成。 该字段接受三种形式：短代码 UV-XXXX-XXXX-XXXX、指向包含你完整许可证密钥的文件的路径， 或直接粘贴该密钥。仅在第一种形式下，脚本才会联系 licence.uversion.io 用代码换取密钥。

4. 记下结尾的摘要

安装以一个方框结束：admin 用户名、临时密码、 服务器地址和证书指纹。请记下它们。

如果窗口关闭得太快，只要密码尚未更改，它仍然保留在磁盘上：

Get-Content "C:\ProgramData\uVersion\initial-admin-password"

该文件会在你更改密码后立即消失： 因此“Cannot find path”错误意味着更改已经发生。

之后你可以继续 首次登录。

Windows Server 2019 和 2022：先装 PostgreSQL

非交互式变体（CI、脚本化部署）

& ([scriptblock]::Create((iwr https://uversion.io/downloads/server/install.ps1 -UseBasicParsing).Content)) `
    -LicenceKey "UV-XXXX-XXXX-XXXX" -DataDir "D:\uVersion" -DbOnDataDir

可接受的九个参数：

文件的存放位置

一切默认都存放在数据文件夹 C:\ProgramData\uVersion 中： 配置（config.toml）、你受版本控制的文件的内容 （data\chunks）、TLS 证书及其指纹 （data\tls），以及初始管理员密码。

在手动修改 config.toml 之后，请重启服务以使其生效：

Restart-Service uVersionServer

验证安装

四项独立检查。如果你选择了其他数据文件夹，请把 C:\ProgramData\uVersion 替换为它。

1. 服务正在运行

Get-Service uVersionServer

预期：Status: Running。

2. 服务器在 8443 上以 HTTPS 监听

Get-NetTCPConnection -LocalPort 8443 -State Listen

应出现一行。服务在运行却什么都没有，通常意味着配置中禁用了 TLS：此时服务器切换为纯 HTTP，8443 不再监听。

3. 再次显示证书指纹

Get-Content "C:\ProgramData\uVersion\data\tls\fingerprint"

这就是每台工作站在首次连接时确认的指纹。

4. 重新读取生效的配置

Get-Content "C:\ProgramData\uVersion\config.toml"

如果服务拒绝启动，查看原因最直接的办法是在前台 启动该二进制文件：启动错误会直接显示在你的窗口里。这其实也是安装脚本在发现失败时 自己建议的命令。

$env:CONFIG_PATH = 'C:\ProgramData\uVersion\config'
& 'C:\Program Files\uVersion\uversion-server.exe'

随后用 Ctrl+C 停止，再执行 Start-Service uVersionServer。如果服务连产生错误 那一步都启动不到，Windows 事件查看器 （eventvwr.msc）会把它记录在系统日志中，来源为 Service Control Manager。不要在那里查找名为 uVersion 的 应用程序日志：服务器只写入其标准输出，并不注册 Windows 事件源，因此像 Get-EventLog -Source uVersionServer 这样的命令永远不会返回任何东西。

卸载

有两种等效方式。两者都运行同一个脚本（uninstall.ps1），它会处理服务、 防火墙、计算机环境变量、数据文件夹、二进制文件、程序和功能条目以及 PostgreSQL 数据库。

方法 1：通过程序和功能

1. Win+R → appwiz.cpl → 回车
2. 在列表中找到 uVersion Server
3. 右键单击 → 卸载
4. 会打开一个管理员 PowerShell 窗口并可见地运行脚本

方法 2：通过以管理员身份运行 PowerShell

iwr https://uversion.io/downloads/server/uninstall.ps1 -UseBasicParsing | iex

脚本在开始时会显示你的两个路径，最后显示一个验证块：对于服务、安装文件夹、 数据文件夹和程序和功能条目，你应看到绿色的 "OK absent"。

$body = (iwr "https://uversion.io/downloads/server/uninstall.ps1" -UseBasicParsing).Content
if ($body -is [byte[]]) { $body = [Text.Encoding]::UTF8.GetString($body) }
& ([scriptblock]::Create($body)) -InstallDir "D:\uVersion\bin" -DataDir "D:\uVersion"

也卸载 PostgreSQL 吗？

默认情况下 uninstall.ps1 不会触及 PostgreSQL：可能还有其他应用在 使用它。如需一并删除：

$body = (iwr "https://uversion.io/downloads/server/uninstall.ps1" -UseBasicParsing).Content
if ($body -is [byte[]]) { $body = [Text.Encoding]::UTF8.GetString($body) }
& ([scriptblock]::Create($body)) -RemovePostgreSQL

需要进行 [byte[]] 检查：根据所提供的 Content-Type， Invoke-WebRequest -UseBasicParsing 可能以字节数组或字符串形式返回响应正文。 上述模式在两种情况下都有效。