# Komari Agent 老版本 Windows 安装部署流程

**URL:** <https://www.sunai.net/t/topic/1382>\
**Category:** IT\
**Tags:** komari\
**Created:** [2026 年4 月 27 日 08:10 UTC](https://www.sunai.net/t/topic/1382 "2026-04-27T08:10:40Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

作者： ![wood](https://www.sunai.net/user_avatar/www.sunai.net/wood/32/1032_2.png) [@wood](https://www.sunai.net/u/wood)\
发布日期： [2026 年4 月 27 日 08:10 UTC](https://www.sunai.net/t/topic/1382/1 "2026-04-27T08:10:40Z")

</div>

适用于 Windows 7 / Windows 8 / Windows Server 2008 R2 / 2012 等不支持新版 agent 的系统。

* * *

## 准备工作

以 **管理员权限** 打开 PowerShell 或 CMD，下面的命令都需要管理员权限。

* * *

## 第一步：下载文件

```powershell
New-Item -Path "C:\Program Files\Komari" -ItemType Directory -Force
Invoke-WebRequest -Uri "https://github.com/xykt/komari-agent-win7_win8_legacy/releases/download/1.1.40/komari-agent_amd64_legacy.exe" -OutFile "C:\Program Files\Komari\komari-agent.exe" -UseBasicParsing
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/xykt/komari-agent-win7_win8_legacy/refs/heads/main/tools/nssm.exe" -OutFile "C:\Windows\System32\nssm.exe" -UseBasicParsing

```

如果 `Invoke-WebRequest` 因为 TLS 版本问题失败（老系统常见），先执行：

```powershell
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

```

* * *

## 第二步：注册为 Windows 服务

把 `<面板地址>` 和 `<TOKEN>` 替换成你自己的：

```cmd
nssm install komari-agent "C:\Program Files\Komari\komari-agent.exe"
nssm set komari-agent AppParameters "-e <面板地址> -t <TOKEN> --disable-auto-update"
nssm set komari-agent AppDirectory "C:\Program Files\Komari"
nssm set komari-agent Start SERVICE_AUTO_START
nssm set komari-agent AppStdout "C:\Program Files\Komari\stdout.log"
nssm set komari-agent AppStderr "C:\Program Files\Komari\stderr.log"
nssm set komari-agent AppExit Default Restart
nssm set komari-agent AppRestartDelay 5000

```

参数说明：

- `-e` 面板地址，例如 `https://svr-agent.czl.net`
- `-t` token，从面板生成
- `--disable-auto-update` 禁用自动更新（老系统建议加，避免被新版替换后跑不起来）

* * *

## 第三步：检查并修复 binPath（重要）

某些 NSSM 版本注册服务时会漏掉服务名参数，必须先验证：

```cmd
sc.exe qc komari-agent

```

看 `BINARY_PATH_NAME` 那一行：

- ✅ 正常：`"C:\Windows\System32\nssm.exe" komari-agent`
- ❌ 异常：`C:\Windows\System32\nssm.exe`（缺少服务名）

**如果是异常情况，手动修复** ：

CMD 下：

```cmd
sc.exe config komari-agent binPath= "\"C:\Windows\System32\nssm.exe\" komari-agent"

```

PowerShell 下：

```powershell
sc.exe config komari-agent binPath= '"C:\Windows\System32\nssm.exe" komari-agent'

```

* * *

## 第四步：启动服务

```cmd
nssm start komari-agent

```

验证状态：

```cmd
sc.exe query komari-agent

```

`STATE` 显示 `RUNNING` 就成功了。

查看日志：

```cmd
type "C:\Program Files\Komari\stdout.log"
type "C:\Program Files\Komari\stderr.log"

```

* * *

## 常用运维命令

```cmd
:: 启动 / 停止 / 重启
nssm start komari-agent
nssm stop komari-agent
nssm restart komari-agent

:: 修改参数（比如换 token）
nssm stop komari-agent
nssm set komari-agent AppParameters "-e <新面板地址> -t <新TOKEN> --disable-auto-update"
nssm start komari-agent

:: 图形化编辑配置
nssm edit komari-agent

:: 查看当前配置
nssm get komari-agent Application
nssm get komari-agent AppParameters
nssm get komari-agent AppDirectory

```

* * *

## 卸载

```cmd
nssm stop komari-agent
nssm remove komari-agent confirm

:: 清理文件
rmdir /s /q "C:\Program Files\Komari"

:: 可选：移除 nssm
del C:\Windows\System32\nssm.exe

```

* * *

## 排错速查

| 现象 | 原因 | 解决 |
| --- | --- | --- |
| `nssm start` 报"系统找不到指定的文件" | binPath 缺少服务名参数 | 见第三步 |
| 服务启动后立即停止 | 参数错误或网络不通 | 看 `stderr.log` |
| 下载报 SSL/TLS 错误 | 老系统默认 TLS 1.0 | `[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12` |
| 服务启动一直 pending | 之前服务残留冲突 | `nssm remove` + `sc delete` 后重启系统再装 |